网页负责账号和 Token，项目的创建与更新推荐使用野生 CLI，命令名是 ys。你仍然可以在命令行里手动调 API，也可以让你的 AI 工具帮你调。
先读：什么算一个真实的项目
下面这些标准对野生Club 所有活动通用。不同活动可能有各自的硬性要求（去看对应活动的手册），但「真实」的底线是一样的。
一个东西只躺在你电脑里、只有你能打开时，它其实还不算真的存在。 提交的过程，就是把它变成别人能看见、能看懂、能复现的东西——这件事我们叫 Ship，它说到底就三件：
- 说清它是什么 —— 你为什么做、它能干什么、大致怎么拼起来的，配上图。
- 整理到别人能看懂、能复现 —— 不是一堆文件加两句话的 README。
- 公开、在线 —— 让别人能真的打开它。
什么样的项目值得做？先问自己一句「我为什么要做这个」。最好的作品都来自一个真的想做它的人——有来由、有故事、具体到一看就懂要解决什么，像个能用的东西，而不是空泛的「AI 助手」或裸奔的 demo。原创、具体、像个真东西，比贪大求全更重要。
README 和日志的最低标准
- README 是别人认识你项目的第一眼。好的标准是：别人不用打开任何一个代码文件，就能看懂这是什么、怎么用、你为什么做。配上主图和能说明问题的截图。
- 开发日志是我们确认「这是你一步步做出来的」的依据。一篇好日志讲清的是为什么，不只是做了什么；每个关键步骤都截图，包括中间的烂摊子；老老实实写下你踩的坑和怎么修的。一篇没有任何错误的日志，是说明书，不是日志。别让 AI 替你写日志——它不知道你的故事。
提交红线
用 AI 完全没问题，这正是野生Club 鼓励的。关键是说清楚哪些是 AI 帮你的、哪些是你自己改的。但下面这些一旦发现，可能让项目被永久拒绝，甚至影响你参加其他活动：
- 整个项目几乎是 AI 一句话生成的，你自己讲不清它怎么跑；
- 几乎 1:1 照搬一篇教程或别人的项目，当成自己的作品；
- 把别人的作品、日志冒充成你自己的；
- 故意灌水、伪造开发过程。
01. 注册账号
打开 yesheng.club/register，填邮箱、密码和网名，勾选监护人知情同意。除邮箱外，不需要填真名、学校或住址——用网名就好。
注册成功后会跳转到账号中心。
02. 生成 API Token
在 账号中心 的「API Token」区域，给 Token 起个名字（比如"Cursor"或"我的脚本"），点击「生成新 Token」。
Token 格式是 ysk_ 开头的一串字符。明文只出现这一次，立刻复制保存，离开页面就看不到了。
Token 可以随时重新生成或手动吊销。为了安全，每次重新生成新 Token 都会自动吊销之前的所有旧 Token，即同一时间名下仅能启用一个有效的 Token。
03. 安装 CLI
正式版发布后：
npm install -g yeshengcli
内测期可使用项目提供的本地构建方式。CLI 文档见 野生 CLI 使用指南。
登录：
ys login --key ysk_xxxxxxxx
04. 初始化项目
ys init --program ml2026 --slug my-cat-feeder --name 猫喂食器
这会在当前目录生成 yesheng.config.yaml、README.md、images/、logs/。刚创建的云端项目默认不公开；第一次带开发日志的有效 ys push 后会按 yaml 中的 visibility 发布。
如果 yesheng.config.yaml 里是 visibility: public，第一篇日志成功同步后，项目就会进入公开项目列表。其他同学可以通过网页或 ys project list / ys project show --logs 看到你的项目、README 和公开日志。它不一定会出现在首页精选，但已经是公开可见的进行中项目。
当你认为这个版本已经完成，把 yesheng.config.yaml 里的 project_status 从 in_progress 改成 completed 后再运行 ys push。如果还没有 README 或开发日志，提交会失败并提示缺少哪些材料。
05. 写 README 和日志
编辑 README.md，图片放进 images/ 并用相对路径引用：
新建一条日志：
ys log new --title 初始化项目
编辑生成的 logs/0001_xxx.md。日志同步成功后会被 CLI 自动标记为 synced: true，之后不会再次上传。
06. 同步
ys push
ys push 会自动上传 README 和日志里引用的本地图片。单张图片最大 5MB；允许 png / jpg / jpeg / webp / gif。
高级方式：直接调 API
创建项目
program_id 是你要参加的活动 ID，比如微光黑客松是 ml2026。slug 是项目的唯一标识，只能用小写字母、数字和连字符。
curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects \
-H "Authorization: Bearer ysk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"program_id": "ml2026",
"slug": "my-cat-feeder",
"name": "猫喂食器",
"tagline": "AI 帮我记得喂猫"
}'
返回：{"ok":true,"data":{"project":{"slug":"my-cat-feeder",...}}}
上传 README
README 支持 Markdown，图片可以一起作为附件上传（相对路径引用 ）。README 是你项目的公开说明，会在项目详情页渲染出来。
[!IMPORTANT] 由于 API 接收的是 README 纯文本，在使用 curl 时请使用
<符号（即readme=<README.md）而非@，这会让 curl 把文件里的文本内容作为普通字段发送，而非作为附件文件发送。
# 只传 Markdown 文本
curl -X PUT https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-cat-feeder/readme \
-H "Authorization: Bearer ysk_xxxxxxxx" \
-F "readme=<README.md"
# 连图片一起传
curl -X PUT https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-cat-feeder/readme \
-H "Authorization: Bearer ysk_xxxxxxxx" \
-F "readme=<README.md" \
-F "photo.jpg=@photo.jpg"
记开发日志
每次折腾出什么、卡在哪、怎么解决的，提交一条日志。日志是公开的，会在项目详情页的「更新记录」里按时间倒序显示。可以附图。
curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-cat-feeder/logs \
-H "Authorization: Bearer ysk_xxxxxxxx" \
-F "title=传感器终于跑起来了" \
-F "text=困在异步死锁上两小时，用 Promise.race 加自定义超时器解决了。" \
-F "screenshot.jpg=@screenshot.jpg"
申请 review 之前至少要有一条日志。
申请 Review
觉得项目的基础功能闭环了，可以申请 Review。AI 会基于你的 README 和所有日志出具点评和建议，并告诉管理员是否推荐展示。
申请前需要：已上传 README，且有至少一条日志。
curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-cat-feeder/review/request \
-H "Authorization: Bearer ysk_xxxxxxxx"
让 AI 工具帮你调 API
你不一定要自己手敲 curl。把你的 Token 和上面的接口文档贴给 Cursor、Claude Code 或任何 AI 助手，让它来写代码调接口。这正是野生Club 想鼓励的——用你的工作台，不是表单。