Cursor rule

1---
2description: "cutcli-cookbook 项目元信息：用途、地址、本地路径、域名、与闭源仓 jy_cli 的关系"
3globs: "**/*"
4alwaysApply: true
5---
6 
7# cutcli-cookbook · 项目元信息
8 
9> 这是一个**开源**项目，配套于闭源核心 `cutcli`（CapCut / 剪映 草稿命令行工具）。
10 
11## 一句话
12 
13收录 cutcli 的可一键运行案例、JSON 模板、AI 提示词、官方文档站源码与社区贡献入口。
14 
15## 核心地址
16 
17| 项 | 值 |
18|---|---|
19| GitHub | <https://github.com/xuliang2024/cutcli-cookbook> |
20| 文档站 | <https://docs.cutcli.com> |
21| 主站 | <https://cutcli.com>（cutcli 安装 + 落地页） |
22| License | MIT |
23| 默认分支 | `main` |
24 
25## 本地路径
26 
27| 仓库 | 路径 | 类型 |
28|---|---|---|
29| `cutcli-cookbook` | `/Users/m007/codes/cutcli-cookbook/` | **开源**（本仓） |
30| `jy_cli` | `/Users/m007/codes/jy_cli/` | **闭源**（cutcli 源码 + cutcli.com worker） |
31 
32两个仓库**同级**摆放，便于 `jy_cli/scripts/sync-to-cookbook.mjs` 走相对路径 `../cutcli-cookbook/` 同步公开文档。
33 
34## 部署架构
35 
36```text
37docs.cutcli.com  →  Cloudflare DNS (proxied A 192.0.2.1)
38                 →  Worker docs-cutcli (本仓 worker/)
39                 →  R2 bucket cutcli-docs (VitePress build 产物)
40```
41 
42| 资源 | 位置 |
43|---|---|
44| R2 bucket | `cutcli-docs`（账号 `xuliang2022@gmail.com`，account id `11c47779f0d4c3d0e69ccc6c484dc589`） |
45| Worker | `docs-cutcli`（路由 `docs.cutcli.com/*` + `docs.cutcli.com`） |
46| Worker 源码 | `worker/src/index.ts`（R2 反代 + SPA 路径回退） |
47| 域名 zone | `cutcli.com`（zone id `064059cb21d36956c11381995b964467`） |
48 
49## 仓内/仓外铁律
50 
511. **绝不**把 `jy_cli/src/`、`jy_cli/dist/`、`jy_cli/binaries/`、闭源 `jy_cli/worker/` 的内容复制进本仓。
522. 案例只调用 **公开 CLI 命令** `cutcli xxx`，不引用 npm 包 `cut_cli` 的内部 API。
533. 闭源 → 公开的内容流动只能通过 `jy_cli/scripts/sync-to-cookbook.mjs`（单向、带 sanitizer）。
544. 命令名严格用 `cutcli`，禁止 `cut`（与 Unix util 冲突）；CI 会 grep fail。
55 
56## 与闭源 jy_cli 的关系
57 
58```mermaid
59flowchart LR
60  subgraph priv [Private jy_cli]
61    privDocs[docs/]
62    syncScript[scripts/sync-to-cookbook.mjs]
63    privWorker[worker cutcli &#x2192; cutcli.com]
64  end
65  subgraph pub [Public cutcli-cookbook]
66    examples[examples/]
67    pubDocs[docs/]
68    pubWorker[worker docs-cutcli &#x2192; docs.cutcli.com]
69  end
70  privDocs -->|"sync (sanitized)"| syncScript
71  syncScript -->|"writes docs/reference/"| pubDocs
72  pubDocs -->|"vitepress build &#x2192; R2"| live[(docs.cutcli.com)]
73```
74 
75## 想了解更多
76 
77- 目录索引：参见 `.cursor/rules/directory-index.mdc`
78- 提交流程：参见 `.cursor/rules/commit-flow.mdc`
79- 部署流程：参见 `.cursor/rules/deploy.mdc`
80- 案例规范：参见 `.cursor/rules/example-spec.mdc`（自动应用于 examples/**）
81- 闭源/开源边界：参见 `.cursor/rules/open-source-boundary.mdc`
82