0 Fork 0

Files

T

chenxin 42513d13c6 📝 docs: 建立魂镜完整 1.0 设计文档体系

- 产品层：产品宪章与永久禁域、产品定义、完整 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

2026-09-09 21:07:14 +08:00

3.9 KiB

Raw Blame History

Hunjing 文档

文档状态：完整 1.0 目标设计。仓库尚无对应实现，所有 TODO 完成并通过发布门前不得表述为正式 1.0。

阅读顺序

文档分类

目录	职责	不承载
`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。

3.9 KiB Raw Blame History Unescape Escape

Hunjing 文档

阅读顺序

文档分类

事实优先级

1.0 维护规则

3.9 KiB

Raw Blame History