Cursor rule

1---
2description: "cutcli-cookbook 仓库目录索引 — 谁放在哪、改谁会影响什么"
3globs: "**/*"
4alwaysApply: true
5---
6 
7# 仓库目录索引
8 
9> 改动文件前先在这里查"它属于哪个层"，避免越权或漏改。
10 
11## 顶层一览
12 
13```text
14cutcli-cookbook/
15├── README.md / README.zh.md         # 仓库门面（英文为主 / 中文）
16├── LICENSE                          # MIT
17├── CONTRIBUTING.md / CONTRIBUTING.zh.md
18├── CODE_OF_CONDUCT.md               # 已是英文
19├── CHANGELOG.md / CHANGELOG.zh.md
20├── package.json                     # 根 package（VitePress + 工具脚本依赖）
21├── package-lock.json
22├── .gitignore
23│
24├── docs/                            # VitePress 文档站源（部署到 docs.cutcli.com）
25│   ├── *.md / guide/ / cookbook/    # 英文（root locale）
26│   └── zh/                          # 中文 locale 镜像（/zh/）
27├── examples/                        # 一键运行的 cutcli 案例（核心资产；每个 case 双语 README）
28├── templates/                       # 可复用 JSON 片段
29├── prompts/                         # AI 工具提示词（双语）
30├── showcase/                        # 月刊精选 + 上线发布资料
31├── scripts/                         # 仓库工具脚本（lint / 校验 / R2 上传）
32├── worker/                          # docs.cutcli.com 的 Cloudflare Worker
33├── .github/                         # Issue/PR/CI/发布指南（模板双语，GOOD_FIRST_ISSUES 双语）
34└── .cursor/                         # Cursor IDE 规则与 MCP 配置（中文）
35```
36 
37## docs/ — 文档站
38 
39```text
40docs/
41├── .vitepress/
42│   └── config.mts             # 站点配置（locales={root:en, zh:/zh/}, cleanUrls=false）
43├── index.md                   # 英文首页 (hero + features)
44├── public/                    # 静态资源（被复制到 dist 根目录）
45│   ├── 404.html               # 英文 404 页（worker miss 时返回）
46│   ├── favicon.svg / logo.svg / hero.svg
47│   └── gallery.json           # build:gallery 自动生成
48├── guide/                     # 英文入门指南（5 篇）
49├── cookbook/                  # 英文场景教程（5 篇）
50├── reference/                 # 英文命令参考（11 篇；cli/api/concepts 由同步脚本覆盖）
51├── prompts/index.md           # 英文 Prompts 库
52└── zh/                        # 中文 locale 镜像（与 root 同结构）
53    ├── index.md
54    ├── guide/ / cookbook/ / reference/ / prompts/
55```
56 
57> 改 `docs/reference/cli|api|concepts.md` 与 `docs/zh/reference/cli|api|concepts.md` ⚠ **不要直接编辑** — 它们由 `jy_cli/scripts/sync-to-cookbook.mjs` 覆盖。改源头 `jy_cli/docs/cli.md` 等再跑同步。
58>
59> 当前过渡期：闭源同步脚本只输出中文，所以 `docs/reference/{cli,api,concepts}.md` 与 `docs/zh/reference/...` 都是中文；待 `jy_cli/scripts/sync-to-cookbook.mjs` 升级后，root 写英文、`zh/` 写中文。
60 
61## examples/ — 案例
62 
63```text
64examples/
65├── README.md / README.zh.md     # 案例总览（双语）
66├── 01-hello-caption/            # P0：一行字幕
67├── 02-image-slideshow-bgm/      # P0：3 图轮播 + BGM
68├── 03-tiktok-keyword-highlight/ # P0：关键词高亮
69├── 04-easy-by-audio/            # P0：cutcli draft easy
70├── 05-keyframe-zoom-in/         # P0：关键帧
71├── 10-product-promo-30s/        # 进阶：30s 产品宣传片
72├── 20-knowledge-science-card/   # 进阶：60s 知识科普
73├── 30-vlog-day-in-life/         # 进阶：30s Vlog
74└── 99-community/                # 社区贡献区
75    ├── README.md / README.zh.md
76    └── .example-template/       # 模板（供 scripts/new-example.mjs 复用）
77```
78 
79每个 case 必有：`README.md`（英文）、`README.zh.md`（中文）、`run.sh` (chmod +x)、`meta.json`、`data/*.json`、`preview.gif`。详见 `.cursor/rules/example-spec.mdc`。
80 
81## scripts/
82 
83```text
84scripts/
85├── _lib/
86│   ├── walk.mjs               # 通用文件遍历
87│   └── example-schema.mjs     # 案例 schema + 中英 H2 章节集合 + URL 白名单
88├── validate-example.mjs       # 案例校验，同时认 README.md 英文 + README.zh.md 中文章节 (npm run lint:cases)
89├── new-example.mjs            # 案例脚手架，同时生成中英两份 README 骨架 (npm run new:example)
90├── build-gallery.mjs          # 生成 docs/public/gallery.json
91├── check-command-name.mjs     # grep 公开仓 cut vs cutcli (npm run lint:cmds)
92├── check-links.mjs            # 校验 markdown 内部链接 (npm run lint:links)
93├── check-i18n-pairs.mjs       # 校验中英文件成对存在 (npm run lint:i18n)
94├── lint.mjs                   # 聚合 lint runner (npm run lint)
95├── upload-r2.mjs              # 增量上传 dist 到 R2 (npm run r2:upload)
96└── r2-gc.mjs                  # 清 R2 孤儿对象 (npm run r2:gc，每周一次)
97```
98 
99## worker/
100 
101```text
102worker/
103├── package.json               # wrangler + workers-types
104├── wrangler.toml              # name=docs-cutcli, R2 binding=DOCS, routes=docs.cutcli.com
105├── tsconfig.json
106├── README.md
107└── src/
108    └── index.ts               # ~100 行：R2 反代 + 5 步路径回退 + 缓存策略
109```
110 
111## templates/
112 
113```text
114templates/
115├── README.md / README.zh.md
116├── captions/
117│   ├── cinematic-title.json
118│   ├── tiktok-bouncy.json
119│   └── news-ticker.json
120├── animations/
121│   ├── smooth-zoom-in.json
122│   └── glitch-cut.json
123└── filters/
124    └── (待充实)
125```
126 
127## prompts/
128 
129```text
130prompts/
131├── README.md / README.zh.md
132├── system/
133│   ├── cutcli-expert.md       # 英文（LLM 默认）
134│   └── cutcli-expert.zh.md    # 中文备份
135├── cursor/
136│   ├── make-promo-video.md
137│   └── make-promo-video.zh.md
138└── claude/
139    ├── auto-storyboard.md
140    └── auto-storyboard.zh.md
141```
142 
143## showcase/
144 
145```text
146showcase/
147├── README.md / README.zh.md   # 投稿规则 + 评选标准（双语）
148├── _gallery.json              # 月刊机器可读列表
149├── 2026-04.md / 2026-04.zh.md # 第 1 期月刊（双语）
150└── launch.md                  # W4 上线发布 checklist + 渠道文案 + demo 脚本（中文，维护者用）
151```
152 
153## .github/
154 
155```text
156.github/
157├── FUNDING.yml
158├── GOOD_FIRST_ISSUES.md / GOOD_FIRST_ISSUES.zh.md  # 双语
159├── RELEASE_GUIDE.md           # 中文，维护者用
160├── PULL_REQUEST_TEMPLATE.md   # 单文件双语
161├── ISSUE_TEMPLATE/
162│   └── bug_report / case_request / showcase / config — 4 个 yml，name/description/label 字段双语
163└── workflows/
164    ├── ci.yml                       # PR + push 都跑：lint (含 lint:i18n) + build + worker typecheck
165    ├── deploy-docs.yml              # main 改动 docs/ 或 worker/ 时：build + R2 增量 + worker deploy + smoke
166    └── scheduled-cases-test.yml     # 每天 02:00 UTC+8 跑全部案例校验，失败开 issue
167```
168 
169## .cursor/rules/ — 本目录
170 
171参见 `.cursor/rules/README.md`。
172