The product docs now describe the client as the main experience, Manager as the auxiliary control surface, and Agnet as a continuous execution loop that can call SK tools before returning delivery and deployment results. Constraint: Product documentation only; no runtime behavior changes. Rejected: Present the web console as the primary task workspace | that conflicts with the intended client-first experience and hides the Agnet execution loop. Confidence: high Scope-risk: narrow Directive: Future product docs should keep Agnet sub-steps, SK tool calls, and delivery deployment return paths explicit whenever the user journey is described. Tested: git diff --check; terminology grep across docs/product-package. Not-tested: High-fidelity visual rendering. Co-authored-by: OmX <omx@oh-my-codex.dev>
Heicode Docs
当前 docs/ 只保留主线文档:
| 文档 | 用途 |
|---|---|
heicode.md |
Heicode 当前产品定位、系统边界和架构共识 |
product-requirements.md |
面向产品、设计、开发协作的 Heicode 产品文档与 MVP 验收标准 |
product-package/ |
Heicode 产品资料包,包含首页设计、产品说明、用户指南、PPT 文案、演示脚本等 |
plan.md |
按当前共识拆出的实施计划 |
heicode-runtime-auth-newapi-secret-design.md |
用户输入、登录用户复用、CodeGW 扣费映射、密钥保管器短期凭证注入边界 |
integration/Heicode-登录接口对接文档.md |
已上线登录接口对接文档 |
integration/agnet-platform-request-contract.md |
Manager 请求 Agnet 平台时携带的部署、日志、监控、事件与审计接口参数 |
integration/agnet-manager-interface-matrix.md |
Manager 与 Agnet 平台双向请求接口、参数和回调示例明细表 |
deployment/azure-production-deploy-guardrails.md |
Azure VM / PostgreSQL / Redis / Agnet / CodeGW 生产部署前的安全守卫、环境变量注入和验证计划 |
旧 Agnet API 草案、旧里程碑、旧架构说明和旧上手材料不再作为实施依据。后续文档和实现以 heicode.md 与 plan.md 为准;生产部署操作以安全守卫文档约束,且不得覆盖产品/架构主线。
代码中的过渡期命名、旧接口注释或旧 UI 文案只作为现状参考;若与 heicode.md / plan.md 冲突,应先更新实现或另行补充当前主线文档,不得恢复旧 Agnet/M1-M5 草案作为依据。