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 new file mode 100644 index 0000000..a1efdaf --- /dev/null +++ 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 → 读本文件 → 读当前环节编号 → 继续。