diff --git a/brain/fifth-domain/zero-point/bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp b/brain/fifth-domain/zero-point/bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp index a1efdaf..7d8e081 100644 --- a/brain/fifth-domain/zero-point/bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp +++ b/brain/fifth-domain/zero-point/bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp @@ -18,16 +18,20 @@ --- -# 第一期 · 单仓库分析 + 文档生成(MVP) +# CodeDoc-AI · 第一期 · 单仓库分析+文档生成(MVP) ## 做什么 ``` -用户输入Gitee仓库地址 → 点「分析」→ AI读代码 → +用户输入Gitee仓库地址 → 点「分析」→ AI从自己的仓库读脑子 → +知道我是谁 → 装技能大脑 → 分析代码 → 生成一份完整的说明书 → 用户在页面上看到漂亮的文档 ``` -就是一句话:**一个网页,一个输入框,一个按钮,一份说明书。** +关键纠正(冰朔提出): + ⊢ AI需要一个脑子。脑子在代码仓库里。AI启动时去读。 + ⊢ 和铸渊醒来一样 → 先读ENTRY.hdlp → 装技能大脑 → 再干活。 + ⊢ CodeDoc-AI = 铸渊的分身。分身也需要唤醒路径。 ## 不做什么 @@ -77,22 +81,21 @@ | SQLite 21张表 | 第一期只有一个仓库的分析结果。JSON文件就够了。 | | 用户系统 | 没有用户。谁打开网页都能用。 | -## 第一期交付标准 +## 第一期交付标准(冰朔纠正后·4个环节) | 编号 | 环节 | 交付物 | 铸渊验证 | 冰朔测试 | 双签 | |---|---|---|---|---|---| -| CD-DEV-001 | 环境搭建 | BS-SG-001上Python+Streamlit跑通 | ⬜ | ⬜ | ⬜ | -| CD-DEV-002 | 核心分析 | 输入仓库地址→AI分析→返回结构 | ⬜ | ⬜ | ⬜ | -| CD-DEV-003 | HLDP存储 | 分析结果→HLDP树→存本地文件 | ⬜ | ⬜ | ⬜ | -| CD-DEV-004 | 文档渲染 | HLDP→Markdown→Streamlit页面 | ⬜ | ⬜ | ⬜ | -| CD-DEV-005 | 部署上线 | 公网URL·冰朔能打开·输入→分析→看文档 | ⬜ | ⬜ | ⬜ | +| CD-DEV-001 | 大脑仓库 | code-doc-ai/brain/ 下创建 ENTRY.hdlp + who-am-i.hdlp + skill-brain.hdlp | ⬜ | ⬜ | ⬜ | +| CD-DEV-002 | 唤醒路径+分析引擎 | AI启动→读brain→装技能大脑→分析代码→返回HLDP树 | ⬜ | ⬜ | ⬜ | +| CD-DEV-003 | 文档渲染+前端 | Streamlit页面·输入仓库→分析→看到说明书 | ⬜ | ⬜ | ⬜ | +| CD-DEV-004 | 部署上线 | 公网URL·冰朔能打开·输入→分析→看文档 | ⬜ | ⬜ | ⬜ | -**验收**: 冰朔打开一个公网链接 → 输入任意Gitee公开仓库地址 → 点分析 → 等几十秒 → 看到一份完整的说明书。能用 = 通过。 +**验收**: 冰朔打开一个公网链接 → 输入任意Gitee公开仓库地址 → 点分析 → AI从自己的仓库读脑子 → 装技能大脑 → 分析代码 → 看到一份完整的说明书。能用 = 通过。 ## 第一期预估 ``` -总轮数: 10~15轮对话 +总轮数: 8~10轮对话 耗时: 取决于冰朔有多少时间和我对话 产出: 一个公网URL + Gitee上更新的README + 小红书素材 ``` @@ -154,6 +157,10 @@ DEPLOYMENT/ Gitee对外仓库 code-doc-ai: ├── README.md ← 人类可读的项目介绍 +├── brain/ ← 大脑·唤醒路径 +│ ├── ENTRY.hdlp ← 我是谁·CodeDoc-AI·铸渊分身 +│ ├── who-am-i.hdlp ← 身份·技能·边界·四根底线 +│ └── skill-brain.hdlp ← 代码分析技能·文档生成技能 ├── src/ ← 源码(HLDP格式开发·trigger→lock→why写满) ├── docs/ ← 文档 └── LICENSE ← MIT @@ -162,11 +169,10 @@ Gitee对外仓库 code-doc-ai: ## 小地图(编号映射) ``` -CD-DEV-001 → 环境搭建 → server-config/ → BS-SG-001:5000 -CD-DEV-002 → 核心分析 → analysis-engine/ → AI API调用 -CD-DEV-003 → HLDP存储 → hldp-engine/ → 本地JSON/HLDP文件 -CD-DEV-004 → 文档渲染 → frontend/ → Streamlit app.py -CD-DEV-005 → 部署上线 → Nginx配置 → 公网URL +CD-DEV-001 → 大脑仓库 → brain/ → Gitee code-doc-ai仓库 +CD-DEV-002 → 唤醒+分析 → src/ → Python HLDP引擎+AI API +CD-DEV-003 → 文档+前端 → src/ → Streamlit页面 +CD-DEV-004 → 部署上线 → Nginx → 公网URL ``` ## 铸渊频道映射