heicode-win/docs

Heicode 文档入口

本目录是 Heicode 仓库的文档主索引。整体内容按受众分两条阅读路径，再共享一组通用骨架。

共用骨架（建议都先读）

文档	用途
vision-heicode-full-stack-agentic-dev.md	产品愿景与协作范式（方向性，非排期）
glossary.md	术语表：Heicode / Manager / 客户端 / 子 agent / SK 等
architecture.md	架构图与关键数据流（mermaid）
sk-lifecycle.md	SK（Skill 资产）单点真相：来源、快照、刷新、写权边界

路径 A · 内部研发 / 新成员上手

适合刚加入团队、负责 cc-haha（客户端）或 heicode（Manager）开发的同学。

1. onboarding/README.md：阅读顺序
2. onboarding/local-dev.md：本地联调步骤与排错
3. onboarding/env-variables.md：环境变量手册
4. 回到共用骨架：architecture.md → glossary.md
5. 计划与现状：milestones/README.md、milestones/STATUS.md

路径 B · Agnet / 平台集成方

适合实现 Agnet 平台侧、与 Heicode 对接编排或事件流的工程师。

1. glossary.md → architecture.md
2. integration/README.md：集成方阅读地图
3. sk-lifecycle.md：SK 边界（Heicode 端写、Agnet 只读快照）
4. integration/agnet-platform-api-design.md：详细 API 设计
5. integration/heicode-oauth-flow.md：HeiCode 客户端 ↔ Manager 浏览器登录流程
6. 落地节奏：milestones/README.md（M3–M5）+ milestones/STATUS.md

关于版本与更新

• 本目录下的文档以 设计意图与契约语义 为准；实现细节以仓库代码为准。
• 任一文档与代码出现冲突时，请在 PR 里同步更新文档与 milestones/STATUS.md。
• 受众边界：docs/ 内不做产品营销文案，营销内容归 website/。