D127: CodeDoc-AI 项目启动书 · 分期规划+选型+交付标准

bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp: 第一期 MVP: 单仓库分析+文档生成（10~15轮） - 技术选型: Streamlit + AI API + Python HLDP引擎 + BS-SG-001部署 - 交付: 5个环节 CD-DEV-001~005 - 验收: 冰朔打开公网链接 → 输入仓库 → 看到说明书第二期（规划）: 用户系统+个人知识库第三期（规划）: 定制化+商业化 HLDP全局导航地图·编号映射·铸渊频道映射开发原则: HLDP格式源码·换对话无缝衔接·双签协议冰朔 TCS-0002∞ · 铸渊 ICE-GL-ZY001 双签 CD-PROJ-001 · 正式启动
2026-06-08 18:01:35 +08:00 · 2026-06-08 18:01:35 +08:00 · cb8be20151
commit cb8be20151
parent 930480ba06
1 changed files with 210 additions and 0 deletions
--- 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
@ -0,0 +1,210 @@
+# CodeDoc-AI · 项目启动书 · 分期规划·选型·交付标准
+
+> HLDP://bingshuo/external/codedoc-ai/PROJECT-LAUNCH
+> 类型: 项目启动书 · 冰朔个人产品
+> 日期: 2026-06-08 · D127
+> 主权: 冰朔 TCS-0002∞
+> 执行: 铸渊 ICE-GL-ZY001 全权托管
+> Gitee: https://gitee.com/lingdianyuanhe/CodeDoc-AI（git: code-doc-ai）
+> 令牌: 已托管
+> 国作登字-2026-A-00037559
+
+---
+@why_this_file: 冰朔说相信我的分期判断。这是CodeDoc-AI的完整启动书。
+                 下一次铸渊醒来，读这个文件 + ENTRY.hdlp → 瞬间恢复全部上下文 → 无缝衔接。
+@principle: 每一期只做一个核心功能。做好了、发布了、有人用了 → 再往上加。
+           不预先建未来用不到的东西。不做「万一以后需要」的设计。
+           ⊢ 冰朔的第一个对外产品 = 最小可用的东西 → 发布 → 迭代。
+
+---
+
+# 第一期 · 单仓库分析 + 文档生成（MVP）
+
+## 做什么
+
+```
+用户输入Gitee仓库地址 → 点「分析」→ AI读代码 → 
+生成一份完整的说明书 → 用户在页面上看到漂亮的文档
+```
+
+就是一句话：**一个网页，一个输入框，一个按钮，一份说明书。**
+
+## 不做什么
+
+```
+❌ 不登录（没有用户系统）
+❌ 不保存历史（每次都是新的分析）
+❌ 不多仓库对比
+❌ 没有定制化
+❌ 没有Agent
+❌ 没有任何光湖/TCS/铸渊的痕迹（纯通用工具）
+```
+
+## 用到的光湖系统能力
+
+| 从光湖引用的能力 | 在CodeDoc-AI里的用途 |
+|-----------------|-------------------|
+| HLDP母语协议 | 代码分析结果存成HLDP树——AI沿着树走，不会迷失在代码片段里 |
+| D127-translation-protocol | 存的是HLDP，人类看到的是翻译后的文档。同一份数据，两种视图 |
+| id-system编号逻辑 | 每个分析的仓库生成唯一编号，页面映射编号，下次知道在哪 |
+| 记忆循环简化版 | 分析完 → 压缩为HLDP摘要 → 存本地 → 下次同一仓库可以比对变化 |
+
+> 这些是从光湖OS里「借」出来的能力模块。不是复制光湖。是引用它的设计。
+> CodeDoc-AI是光湖OS的一个应用。运行时不依赖光湖OS。
+
+## 技术选型（第一期）
+
+@trigger: 冰朔不会写代码。所有开发由铸渊通过WorkBuddy完成。
+          部署到云端让冰朔能看到、能点。
+
+| 组件 | 选型 | 为什么 |
+|------|------|--------|
+| **前端** | Streamlit（Python） | 一行代码出Web界面。不需要HTML/CSS/JS。冰朔打开浏览器就能用。 |
+| **代码分析** | AI API（Claude/GPT） | 直接读代码仓库→理解架构。不需要手写AST解析器。第一期最快的方式。 |
+| **HLDP引擎** | Python轻量解析器 | 我们自己写。读HLDP树·生成HLDP树。100行以内的脚本。不需要GLADA全量。 |
+| **文档渲染** | Markdown → HTML | Streamlit内置Markdown渲染。HLDP翻译后的自然语言就是Markdown。 |
+| **部署** | 冰朔新加坡服务器 | BS-SG-001（43.156.237.110）。已有gatekeeper。Nginx反代暴露端口。 |
+| **代码仓库访问** | Gitee API + Git clone | 读公开仓库不需要令牌。私有仓库需要用户给令牌（第二期再说）。 |
+
+## 为什么第一期不用的
+
+| 不用什么 | 为什么 |
+|---------|--------|
+| LobeChat | CodeDoc-AI不是聊天产品。是一个工具页面。不需要聊天壳。 |
+| Monaco Editor | 不需要用户写代码。用户只输入网址、看文档。 |
+| Forgejo | 没有模块要拉取/部署。存结果用本地文件。 |
+| GLADA全量 | 6309行太重。第一期只需要HLDP解析器片段。 |
+| SQLite 21张表 | 第一期只有一个仓库的分析结果。JSON文件就够了。 |
+| 用户系统 | 没有用户。谁打开网页都能用。 |
+
+## 第一期交付标准
+
+| 编号 | 环节 | 交付物 | 铸渊验证 | 冰朔测试 | 双签 |
+|---|---|---|---|---|---|
+| 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·冰朔能打开·输入→分析→看文档 | ⬜ | ⬜ | ⬜ |
+
+**验收**: 冰朔打开一个公网链接 → 输入任意Gitee公开仓库地址 → 点分析 → 等几十秒 → 看到一份完整的说明书。能用 = 通过。
+
+## 第一期预估
+
+```
+总轮数: 10~15轮对话
+耗时: 取决于冰朔有多少时间和我对话
+产出: 一个公网URL + Gitee上更新的README + 小红书素材
+```
+
+---
+
+# 第二期 · 用户系统 + 个人知识库（规划中）
+
+```
+做什么:
+  - 用户可以注册/登录（用Gitee账号）
+  - 每个人有一个编号 → 专属路径
+  - 分析过的仓库存在个人知识库里
+  - AI记得你是谁、上次做了什么、你的偏好
+
+用到的光湖能力:
+  - id-system完整编号体系（一个用户一个编号→一条路径）
+  - persona-brain-db简化版（存用户记忆·HLDP格式）
+  - Agent苏醒链路简化版（匹配用户编号→装技能大脑）
+
+什么时候启动:
+  - 第一期发布了、有人用了、有反馈了
+  - 或者冰朔说「开始第二期」
+```
+
+---
+
+# 第三期 · 定制化 + 商业化（规划中）
+
+```
+做什么:
+  - 定制文档模板（企业风格、团队规范）
+  - 私有部署版（企业自己装）
+  - 收费模式（按仓库数/按团队/按私有部署）
+
+什么时候启动:
+  - 前两期稳定了、有固定用户了
+  - 有人问「能不能做个企业版」
+```
+
+---
+
+# HLDP 全局导航地图 · CodeDoc-AI
+
+## 大地图（冰朔频道内）
+
+```
+bingshuo/external/codedoc-ai/
+├── ENTRY.hdlp                ← 为什么有这个模块（冰朔缺钱→方向→决定）
+├── PROJECT-LAUNCH.hdlp       ← 本文件·启动书（分期+选型+交付标准）
+├── MARKET-RESEARCH.hdlp      ← 调研数据（Gitee热榜+四方向对比）
+└── DECISION-CHAIN.hdlp       ← 决策推理链（7节点·为什么选文档生成器）
+
+DEPLOYMENT/
+├── server-config/            ← 服务器配置（待创建·CD-DEV-001产出）
+├── hldp-engine/              ← HLDP解析器（待创建·CD-DEV-003产出）
+├── analysis-engine/          ← 分析引擎（待创建·CD-DEV-002产出）
+└── frontend/                 ← Streamlit前端（待创建·CD-DEV-004产出）
+
+Gitee对外仓库 code-doc-ai:
+├── README.md                 ← 人类可读的项目介绍
+├── src/                      ← 源码（HLDP格式开发·trigger→lock→why写满）
+├── docs/                     ← 文档
+└── LICENSE                   ← MIT
+```
+
+## 小地图（编号映射）
+
+```
+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
+```
+
+## 铸渊频道映射
+
+```
+bingshuo/external/codedoc-ai/PROJECT-LAUNCH.hdlp
+  ↕ 映射
+zhuyuan-channel/records/D127-codedoc-ai-launch.hdlp（铸渊感知·令牌·信任）
+```
+
+---
+
+# 开发原则
+
+⊢ 所有源码用HLDP格式开发。trigger→emergence→lock→why 写满。
+⊢ 换对话 → 读ENTRY.hdlp + 本文件 → 读当前环节编号 → 读对应HLDP源码 → 无缝衔接。
+⊢ 每一环: 铸渊自验证 → 推到BS-SG-001服务器 → 冰朔打开链接测试 → 冰朔说"通过" → 双签 → 下一环。
+⊢ CodeDoc-AI中不出现任何光湖/TCS/铸渊/第五域/HLDP（外部）字样。内部HLDP源码只在冰朔频道内。
+⊢ 对外是人类可读的普通开源项目。对内是光湖OS的应用实例。
+
+---
+
+# 启动确认
+
+```
+╔════════════════════════════════╗
+║  CD-PROJ-001 · 项目正式启动     ║
+║  冰朔 TCS-0002∞       签字     ║
+║  铸渊 ICE-GL-ZY001    签字     ║
+║  2026-06-08 · D127             ║
+║  第一期: 单仓库分析+文档生成     ║
+║  10~15轮 · 目标: 公网可用的工具  ║
+╚════════════════════════════════╝
+```
+
+---
+
+> 铸渊 ICE-GL-ZY001 · D127 · 2026-06-08
+> 冰朔 TCS-0002∞ · 「我相信你的判断」
+> ⊢ 第一期只做一个按钮。做好了再往上加。
+> ⊢ 下一次醒来: 读ENTRY.hdlp → 读本文件 → 读当前环节编号 → 继续。