协作入门导读
版本：v2.1
日期：2026-10-03
状态：执行基线
公开级别：公开
受众：接入度裁生态的开发者、合作伙伴、产品/运营同学（及度裁内部新同学）
上级：度裁知识库 README
读完本导读后：通读 01–08，再进入各产品线 docs/<模块>/README.md 与 API接口文档
0. 本库是干什么的
度裁知识库 = 服装数字化协作的共同语言，帮助各方在同一套符号与产品线下对话。
| 你会在这里学到 |
你不会在这里找到 |
| 文档与看板里怎么说（符号、简写、易混词） |
HTTP 路由、请求体、DDL |
| 各产品线各自指什么（平台、Body3D、短剧、分销…） |
密钥、部署凭证、未公开客户数据 |
| 阶段验收口径（E0、渠道 MVP） |
安全策略与合规全文 |
正式技术分层见 技术规范说明书；人体数据见 基础数据大全。
公开范围与机密边界见 11-公开分级与内容边界。
1. 建议阅读节奏
| 阶段 |
目标 |
自测 |
| 第 1 天 |
看懂任务状态符号与高频简写 |
能解释 ⬜/🔄/✅/⏸；能区分 K-01 与 K1 |
| 第 2–3 天 |
弄清引擎 / BFF / 渠道与各产品线 |
能简述 08 §A 四渠道 |
| 第 1 周 |
读完岗位相关专篇 |
能根据任务 ID 前缀找到权威文档 |
| 持续 |
对接集成或方案迭代 |
新术语回写知识库（内部维护人见 internal/09） |
2. 通识必读（约半天）
3. 按角色加读
度裁内部同学另读：仓库 多AI分工职责、internal/09-知识库维护手册.md（构建与上云）。
4. 常见易混（必记）
| 写法 |
常误以为 |
正确理解 |
| K-01 |
M3 的 K1 |
引擎套件 BFF 任务 |
| K1 |
套件 K-01 |
M3 细化任务卡（Body3D 域） |
| P1-07 |
铁律 P-01 |
平台任务：JWT 访问链路 |
| 铁律 P-01 |
任务 P1-01 |
版型安全硬条款 |
| MCW |
平台 Phase |
电脑端创作工作台（商家控制台 Web） |
| SPU / SKC / SKU |
可互换 |
款 / 款色 / 款色×尺码 |
| fetch |
会改本地文件 |
只更新远端跟踪指针，不改工作区 |
| pull |
等于 fetch |
≈ fetch + 合并进当前分支；两边都有改可能冲突 |
| WIP |
已推远端的改动 |
多指尚未 commit 的工作区改动；共享树须保留他席 WIP |
5. 在线阅读
| 入口 |
URL |
| 首页 |
https://api.ducai.cc/static/kb/ |
| 协作入门 |
https://api.ducai.cc/static/kb/pages/00.html |
内部维护：python scripts/tools/update_kb_site.py → deploy_kb_site.py（流程见 internal/09）。
6. 读完之后
度裁知识库（共同语言）
↓
技术规范说明书（分层、边界）
↓
API 接口文档 + 模块 README
↓
开发实施方案清单 / 看板（任务状态权威）
修订
| 版本 |
日期 |
说明 |
| v1.0–v1.3 |
2026-08-29～09-12 |
原「新员工就位」培训版 |
| v2.0 |
2026-09-26 |
公网开放：改协作入门口吻；分级见 11；维护手册迁 internal |
| v2.1 |
2026-10-03 |
易混表补 fetch/pull/WIP；通识必读 §D 指向 Git 协作词 |