这页是给 AI 助手看的。你可以把这个页面链接发给 Cursor、Claude Code、Codex、CodeBuddy 或其他编程助手，让它知道如何在野生Club创建项目、写日志、同步 README 和申请 Review。
人类用户只需要记住一句话：网页生成 Token，AI 在本地用野生 CLI 提交项目，命令名是 ys。
Skill 目标
当用户说“帮我提交到野生Club”“同步项目”“写一篇开发日志”“申请 Review”时，AI 应该：
- 优先使用野生 CLI，也就是
ys命令，而不是让用户手动填表。 - 在本地项目目录维护
README.md、images/、logs/和yesheng.config.yaml。 - 用
ys push同步 README、项目资料、图片和未同步日志。 - 只有 CLI 不满足需求时，才直接调用 开发者 API。
用户需要先准备
- 注册或登录野生Club账号。
- 在 账号中心 生成 API Token。
- 把 Token 只提供给可信 AI 工具或本地 CLI。
Token 是账号钥匙。AI 不应该把 Token 写入 README、日志、代码仓库、截图或公开聊天记录。
推荐工作流
1. 登录
ys login --key ysk_xxxxxxxxxxxxxxxx
本地开发环境可指定 API 地址：
ys login --key ysk_xxxxxxxxxxxxxxxx --api-base http://localhost:3000/api/v1
凭证会保存到 ~/.yesheng/config.json。
2. 选择活动
ys program list
ys program use ml2026
如果不确定活动规则，先让 AI 取文档链接：
ys docs --url
然后读取返回的文档页面，再继续操作。
3. 初始化项目
ys init --program ml2026 --slug my-cat-feeder --name 猫喂食器
当前目录会生成：
yesheng.config.yaml
README.md
images/
logs/
AI 应该把项目说明写进 README.md，把项目图片放进 images/，再在 Markdown 里用相对路径引用图片。
4. 写开发日志
ys log new --title 初始化项目
这会创建 logs/0001_xxx.md。AI 可以编辑新生成的日志正文。
也可以直接发一条云端短日志：
ys log "今天把传感器读数跑通了"
短日志不会生成本地文件，适合快速记录，不适合作为长期整理的项目档案。
5. 同步
ys push
ys push 会上传本地图片，更新 README 和项目资料，追加未同步日志，并把成功提交的日志标记为 synced: true。
本地文件规则
yesheng.config.yaml 格式要求
yesheng.config.yaml 是野生 CLI 的项目配置文件，必须放在项目目录根部，也就是运行 ys push 的目录。它使用 YAML 格式：
project_id: project_xxx
program_id: ml2026
slug: my-cat-feeder
name: 猫喂食器
tagline: AI 帮我记得喂猫
tags:
- Hardware
demo_urls:
- https://demo.example.com
header_image: ./images/cover.png
visibility: public
project_status: in_progress
字段要求：
| 字段 | 类型 | 是否必填 | AI 可以修改吗 | 说明 |
|---|---|---|---|---|
project_id |
string | 必填 | 否 | 云端项目 ID，由 ys init 返回并写入。 |
program_id |
string | 必填 | 否 | 活动 ID，例如 ml2026、arcade、m5stack。 |
slug |
string | 必填 | 谨慎 | 项目 URL 标识，只能用小写字母、数字和连字符；创建后通常不要改。 |
name |
string | 必填 | 是 | 项目名称。 |
tagline |
string | 可选 | 是 | 一句话介绍；没有就写空字符串。 |
tags |
string[] | 可选 | 是 | 标签数组；没有就写 []。 |
demo_urls |
string[] | 可选 | 是 | 演示链接数组；没有就写 []。 |
header_image |
string | 可选 | 是 | 本地头图路径或 cloud:// file id；本地图片建议放在 images/。 |
visibility |
public / private |
可选 | 是 | 公开状态；不确定时先用 private。 |
project_status |
in_progress / completed |
可选 | 是 | 学生声明状态。只有已有 README 和至少 1 篇日志时，才能改成 completed。 |
AI 不应该把 Token、手机号、住址、真实姓名等隐私信息写进这个文件。
README 支持 YAML Frontmatter：
---
tagline: AI 帮我记得每天按时喂猫
tags: [Hardware, AI]
demo_urls: [https://demo.example.com]
---
# 猫喂食器
![[head] 项目主图](./images/cover.png)
这里写项目说明。
日志文件示例：
---
sequence: 1
created_at: 1717932000
synced: false
title: 初始化项目
---
今天完成了硬件选型。
日志同步成功后会变成 synced: true。AI 不应该修改已经同步的旧日志来“覆盖历史”；需要补充进展时创建新日志。
图片规则
- 图片放在
images/或日志附近目录。 - README 或日志里使用 Markdown 图片语法：
。 - 指定头图时，在图片 alt 文本中加入
[head]，例如![[head] 主图](./images/cover.png)。 - 单张图片最大 5MB。
- 支持 png、jpg、jpeg、webp、gif；默认不接受 svg。
查询和导出
ys project list
ys project list --all
ys project list --program arcade --json
ys project show my-cat-feeder
ys project show my-cat-feeder --logs
ys project show my-cat-feeder --json
ys project show my-cat-feeder --download
--json 适合 AI 读取结构化数据。--download 会导出项目详情和公开日志。
直接 API 兜底
如果运行环境不能安装或调用 ys，AI 可以改用 开发者 API：
POST /projects创建项目。PATCH /projects/:slug更新项目资料。PUT /projects/:slug/readme上传 README。POST /projects/:slug/logs追加日志。POST /projects/:slug/review/request申请 Review。GET /projects/:slug/status查询状态。
直接 API 调用时仍然要遵守 Token、图片大小和日志追加规则。
给 AI 的系统提示模板
你正在帮助用户提交野生Club项目。
优先使用野生 CLI（命令名是 ys）：
1. 如果用户还没有登录，让用户提供从 /me 生成的 API Token，然后运行 ys login --key <token>。
2. 如果当前目录没有 yesheng.config.yaml，运行 ys init --program <program_id> --slug <slug> --name <name>。
3. 维护 README.md、images/ 和 logs/。图片用相对路径引用，头图用 [head] 标记。
4. 新进展用 ys log new --title <title> 创建日志；不要修改 synced: true 的旧日志。
5. 同步时运行 ys push。
6. 不要把 Token 写入任何项目文件，不要提交 Token。
7. CLI 不可用时，再按 /docs/api 直接调用 REST API。