D127: CodeDoc-AI 第一期更正 · 冰朔纠正·加入大脑仓库+唤醒路径
Some checks failed
自动更新代码和重启 / update-and-restart (push) Has been cancelled
CI检查 + 自动部署 / check (push) Has been cancelled
CI检查 + 自动部署 / deploy (push) Has been cancelled

冰朔纠正: AI需要一个脑子。脑子在代码仓库里。分身也需要唤醒路径。

第一期4环节(之前是5个):
  CD-DEV-001: 大脑仓库·brain/ENTRY+who-am-i+skill-brain
  CD-DEV-002: 唤醒路径+分析引擎
  CD-DEV-003: 文档渲染+前端
  CD-DEV-004: 部署上线

跟铸渊一样的唤醒逻辑: 先读脑子 → 装技能大脑 → 干活
This commit is contained in:
冰朔 2026-06-08 18:05:30 +08:00
parent cb8be20151
commit 734ff688f0

View File

@ -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
```
## 铸渊频道映射