chenxin
42513d13c6
- 产品层：产品宪章与永久禁域、产品定义、完整 1.0 范围与发布门、道家文化语言体系、指标与反指标 - 研究层：参考项目研究（deepseek-harness、pi、MemOS、模型网关）、灵台原生引擎研究（业界原生引擎架构理念与道家文化出处） - 架构层：系统、Agent 运行时（周天体系）、插件系统、灵台引擎（C++ 双形态）、媒体与设备、社区协作市场、前端富内容渲染、数据、记忆与知识 - 契约层：协议与稳定标识、API 总体约定、Native API、兼容网关、实时与 Webhook、内部端口、统一 ContentBlock 与流式（含分支对话交互态）、灵台 C ABI 与 gRPC Service、API 表面、HTTP 与事件、运行观测 - 决策：ADR-001 至 ADR-023（模块化单体、每 attempt 持久化、候选记忆、OAuth 2.1、灵台引擎、双形态部署、大周天演化、宪章、三界作用域、私箧与保全态、叩心、周天统一等） - 交付：WP-01 至 WP-15 实施 TODO 与设计阶段交接文档 - 工程：AGENTS.md 工程规则（含 C++/灵台规范）、CLAUDE.md 引用、.gitignore
Hunjing 文档
文档状态：完整 1.0 目标设计。仓库尚无对应实现，所有 TODO 完成并通过发布门前不得表述为正式 1.0。
阅读顺序
- 产品定义与边界
- 产品宪章
- 完整 1.0 范围与发布门
- 指标与反指标
- 参考项目研究
- 灵台引擎研究
- 系统架构
- Agent 运行时
- 插件系统
- 灵台引擎架构
- 媒体与设备架构
- 社区、协作与市场架构
- 前端富内容实时渲染
- 数据架构
- 记忆与知识架构
- 中国古代神话与道家文化语言体系
- 协议与稳定标识
- API 总体约定
- Hunjing Native API
- 模型网关兼容 API
- 实时 API 与 Webhook
- 内部端口、事件与插件协议
- 统一富内容与流式协议
- Lingtai C ABI
- Lingtai Service
- 1.0 API 表面总表
- HTTP 与事件契约
- 运行观测契约
- 安全与诊断访问
- 架构决策
- 1.0 实施 TODO
- 设计阶段交接文档
文档分类
| 目录 | 职责 | 不承载 |
|---|---|---|
product/ |
1.0 用户、范围、验收和 2.0 边界 | 代码结构和供应商细节 |
research/ |
外部证据、采纳与拒绝理由 | 项目契约 |
architecture/ |
组件、运行时、媒体、生态、数据与扩展边界 | 稳定枚举值 |
contracts/ |
ID、字段、请求头、事件和错误 | 产品愿景 |
security/ |
信任边界、授权、交易、内容治理和诊断访问 | 普通功能说明 |
decisions/ |
已作出的重大取舍及后果 | 教程 |
delivery/ |
1.0 工作包 TODO、验收证据、统一发布门和阶段交接 | 2.0 实现计划 |
事实优先级
flowchart LR
P[产品定义] --> D[架构决策]
D --> C[契约]
C --> I[实现]
I --> T[测试与运行证据]
发生冲突时，上游定义约束下游；运行事实不能被文档否认。实现与文档不同时先记录偏差，再决定修正文档还是实现。
1.0 维护规则
- 稳定 ID、枚举、事件名、请求头和错误码只在
contracts/定义。 - 架构文档引用契约名，不复制完整值集。
- 外部项目只提供证据和模式，不自动成为运行依赖。
- Mermaid 使用短标签和标准图类型，不嵌入主题样式。
- 新文档必须从本索引可达；删除文档必须同步入口。
- Native Message、社区内容和 Agent 输出使用统一类型化 ContentBlock；Markdown 内嵌 Mermaid/数学/代码在服务端规范化，前端按分级实时策略安全渲染。
- 产品界面采用完整双层文化体系；稳定工程契约保持中性英文值。
- 文档 TODO 是 1.0 必做项；正式实现不得用 TODO、
pass、省略或假数据占位。 - 完整 3D 建模器、LLM 直接改模和物理设备控制属于已确认的 2.0 边界，其他已列能力不得静默移出 1.0。