提交不是填一张表单，而是交一份能证明你真的做过的项目档案：能打开的作品、看得懂的 README、记录过程的开发日志。

微光舰队推荐你用 CodeBuddy（AI 编程助手）+ 野生 CLI（ys） 来提交：你在本地维护 README、图片和日志，CodeBuddy 帮你跑命令、调接口，整套流程都在你的工作台里完成，不用回网页填表。

提交前，先备齐这些

申请 Review 之前，你的项目至少要有：

  • 一个能打开或运行的作品 —— 有明确的开始和闭环，不是半成品 demo。
  • 一份 README —— 介绍它是什么、怎么用、你和 AI 各做了什么。
  • 至少 3 篇真实开发日志 —— 记录过程、卡点和你怎么解决，不能只写「今天写了点代码」。
  • 1–2 张截图或一个 Demo 链接 —— 让别人不用问你就能看到它长什么样。

在电脑上建一个项目文件夹，把这些都放在一起：

my-cat-feeder/
  README.md
  yesheng.config.yaml   # ys init 自动生成
  images/               # 截图、主图
  logs/                 # 开发日志

第一步：在网页拿一个 Token

注册并登录 野生Club（邮箱、密码、网名即可，不用真名学校）。

在 账号中心 的「API Token」区域生成一个 Token，格式是 ysk_ 开头的一串字符。明文只出现一次，立刻复制保存。

这是你账号的钥匙。只交给本地的 CodeBuddy / CLI，不要写进 README、日志、代码或聊天截图里。

第二步：把任务交给 CodeBuddy

打开 CodeBuddy，让它先读一遍野生Club 的 AI Skill 文档——那一页就是写给 AI 看的提交说明，读完它就知道怎么用 ys。

然后可以直接对它说：

请阅读 https://yesheng.club/docs/skill 这页的提交说明。
我要把当前目录的项目提交到野生Club 的 ml2026 活动。
这是我的 Token：ysk_xxxxxxxx（只在本地使用，不要写进任何文件或提交记录）。
请帮我：
1. ys login 登录；
2. ys init 初始化 ml2026 项目；
3. 按我说的内容写好 README.md；
4. 把我的进展整理成开发日志；
5. ys push 同步。

CodeBuddy 接下来会替你跑命令。下面几步是它（和你）应该做的事，你也应该看懂每一步在干什么。

第三步：初始化项目

ys login --key ysk_xxxxxxxx
ys init --program ml2026 --slug my-cat-feeder --name 猫喂食器

ys init 会在当前目录生成 yesheng.config.yaml、README.md、images/、logs/。slug 只能用小写字母、数字和连字符，是项目的网址标识，定了就别乱改。

第四步：写好 README

README 是别人认识你项目的第一眼。好的标准是：别人不用打开任何一个代码文件，就能看懂这是什么。

至少讲清三件事：

  • 是什么 —— 一句话说清它是什么、有什么不一样。
  • 怎么用 / 怎么跑 —— 写细一点，别人读不懂你的脑子。
  • 为什么做 —— 你在解决什么问题？这部分越个人越好。

再加上图：一张主图（用 alt 里的 [head] 标记当封面），加上能说明它在干什么的截图。图片放进 images/，用相对路径引用：

---
tagline: AI 帮我记得每天按时喂猫
tags: [AI, Hardware]
---

# 猫喂食器

![[head] 项目主图](./images/cover.png)

## 这是什么
一个会在我忘记时自动提醒、并定时投喂的小装置……

## 怎么用
1. ……
2. ……

## 为什么做
我家猫总在我赶早八时饿肚子，所以……

## AI 帮了什么 / 我自己改了什么
- AI 帮我：……
- 我自己改了：……

## 还没做完的
- ……

经验之谈：大多数被退回的项目，问题都出在 README 上——缺图、说不清怎么跑、看不出是你自己做的。这些往往 5 分钟就能补好，提交前自己读一遍，或者找个朋友读一遍。

第五步：写真实的开发日志

我们靠日志来确认这个项目是你真的一步步做出来的，而不是一夜之间冒出来的。所以日志怎么写，比写了几篇更重要。

新建一篇日志：

ys log new --title 第一次把喂食电机转起来

然后编辑生成的 logs/0001_xxx.md，写下这一段的故事。

一篇好日志，重点是讲清「为什么」，不只是「做了什么」：

这样写 ✅ 别这样写 ❌
说清你做了什么、为什么这么做、怎么做的 只写「我接好线了」「我写了下代码」
每个关键步骤都截图，包括中间的烂摊子 只放一张最后做好的成品图
写下你踩的坑，以及怎么修好的 一帆风顺、全是成功

一篇没有任何错误的日志，是说明书，不是日志。

别让 AI 替你写日志。 AI 不知道你那个凌晨两点卡了三小时的 bug 是怎么回事，它只会编出一篇空洞的流水账。日志是你自己的故事，用自己的话写，错字语病都没关系。

反例 ❌

我加了个舵机然后接好线，又写了控制代码，跑起来就成功了！

——为什么用舵机？控制代码解决了什么问题？你怎么确认它「成功」了？这些才是别人想知道的。

正例 ✅

6/8 终于让电机按时间转起来了 一开始我用 delay() 来定时投喂，结果发现这样会把整个程序卡死，按钮都没反应。查了下才明白 delay 是阻塞的。 后来改成记录 millis() 时间戳来判断「是否到点」，按钮就能随时响应了。下图是改之前 vs 改之后的串口输出。 （附两张截图）

短记录也可以随手发一条（不生成本地文件，适合记一句话进展）：

ys log "今天把 WiFi 配网跑通了"

第六步：同步到云端

ys push

ys push 会上传 README、项目资料、本地图片，并追加还没同步过的日志。图片单张最大 5MB，支持 png / jpg / jpeg / webp / gif。

只要 yesheng.config.yaml 里是 visibility: public，第一篇日志成功同步后，项目就会出现在公开项目列表里，别人就能在星图、网页或 ys project list 里看到它。

第七步：申请 Review

当作品能跑、README 和至少一篇日志都齐了，就可以申请 Review。目前 ys 还没有 review 子命令，让 CodeBuddy 帮你发这一条请求即可：

curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-cat-feeder/review/request \
  -H "Authorization: Bearer ysk_xxxxxxxx"

Review 会基于你的 README 和全部日志来看：作品是否真能跑、过程是否真实、AI 用得是否透明、是否原创。通过后，它会进入公开展示和推荐流程。

提交红线

下面这些，一旦发现，可能让项目被永久拒绝，甚至影响你参加野生Club 的其他活动。别碰：

  • 整个项目几乎是 AI 一句话生成的，你自己讲不清它怎么跑。
  • 几乎 1:1 照搬一篇教程或别人的项目，当成自己的作品交上来。
  • 把别人的作品、日志冒充成你自己的。
  • 故意灌水开发记录、伪造过程。

用 AI 完全没问题——这正是野生Club 鼓励的。关键是大方说清楚：哪些是 AI 帮你的，哪些是你自己改的、试的、修的。能讲清楚，它就是你的项目。

项目被退回，通常是因为

  • 跑不起来 / 缺东西 —— 别人拿到你的仓库装不上、打不开、复现不了。
  • 功能还是半成品 —— 只有一个空壳或一个按钮，没有完整闭环。
  • README 太单薄 —— 缺图、缺「怎么用」、看不出你做了什么。
  • 说不清 AI 做了什么 —— 代码你自己都解释不了。
  • 疑似抄袭或代写 —— 见上面的红线。

这些基本都不难修。对照本页开头的「提交前，先备齐这些」清单补齐，再 ys push 一次、重新申请 Review 就行。

需要更细的命令参考，见 野生 CLI 使用指南 和 AI Skill 文档。