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
282 lines
18 KiB
Markdown
282 lines
18 KiB
Markdown
# 中国古代神话与道家文化语言体系
|
|
|
|
## 1. 定位
|
|
|
|
Hunjing 的中文品牌名为**魂镜**。文化语言用于产品世界观、导航、页面标题、用户动作和可见状态，让平台形成统一的东方叙事；工程契约继续使用中性英文标识，保证跨语言、OpenAPI、数据库、日志和第三方 SDK 的稳定性。
|
|
|
|
统一展示格式：
|
|
|
|
```text
|
|
文化名 · 直白解释
|
|
```
|
|
|
|
例如：
|
|
|
|
```text
|
|
镜树 · 分支对话
|
|
息壤 · 角色记忆
|
|
请命 · 等待你的确认
|
|
```
|
|
|
|
规则：
|
|
|
|
- 首次出现必须同时给出直白解释；不能要求用户先理解典故。
|
|
- 风险、金额、权限、删除、支付和法律后果必须优先使用直白语言，文化名只能辅助。
|
|
- API、数据库、事件、错误码和权限 scope 只使用稳定工程值。
|
|
- UI 文案由本地化目录把稳定 `label_key` 映射为文化名和解释，后端不把文化名当枚举。
|
|
- 文化名不得掩盖失败、越权、收费、撤销、永久删除或现实后果。
|
|
|
|
文化名承接：引擎诸枢（灵台、太一、小周天、洛书、河图、烛照）与镜域、缘契、问心、铭契、世谱、玄络、三界（真界/境界/幻境）、私箧、叩心、归藏、随缘等承接 Hunjing 旧版（main 分支）已确立的命名；旧版中与当前 1.0 架构不再对应的概念（命台、执镜者、司席）不再沿用，避免为已变化的结构保留误导性名称。从旧版迁移概念时，先核对当前架构与产品范围仍有真实对应物，再登记映射；语义已被现有文化名覆盖的（如天宰与司命台、魂册与魂籍）不重复引入。
|
|
|
|
## 2. 世界观骨架
|
|
|
|
魂镜不是把每个服务包装成神仙官职，而是用“镜”表达映照、分支与自省，用“天工”表达能力与创造，用“契”表达明确授权，用“司”表达治理责任。
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
H[魂镜 · 长期 AI 角色平台]
|
|
H --> J[镜庭 · 个人首页]
|
|
H --> C[镜生 · 角色身份]
|
|
H --> T[镜树 · 分支对话]
|
|
H --> M[息壤 · 记忆知识]
|
|
H --> F[形仪 · 多模态形象]
|
|
H --> A[天工阁 · Agent 任务]
|
|
H --> P[百工坊 · 插件能力]
|
|
H --> S[雅集 · 社区交流]
|
|
H --> W[同契台 · 协作空间]
|
|
H --> K[云市 · 创作市场]
|
|
H --> G[司命台 · 安全治理]
|
|
```
|
|
|
|
## 3. 一级产品域与页面
|
|
|
|
| 文化名 | 直白解释 | 稳定工程域 | 文化含义与边界 |
|
|
| --- | --- | --- | --- |
|
|
| 镜庭 | 个人首页 | `home` | 庭是进入各处的共同起点；只聚合状态，不成为数据事实源 |
|
|
| 镜生 | 角色身份与版本 | `character` | 角色由设定、来源、关系和版本逐步形成；不宣称生物生命 |
|
|
| 镜树 | 分支对话 | `conversation` | 同一主题可生长多条路径，旧内容不被重生成覆盖 |
|
|
| 息壤 | 记忆与知识 | `memory_knowledge` | 取“息壤自生”之意，表示可累积材料；不表示所有数据都自动生长为记忆 |
|
|
| 形仪 | 图像、声音、Live2D 与 3D | `media_avatar` | “形”为外在，“仪”为可见表达规则；形态不是角色本体 |
|
|
| 天工阁 | Agent 任务工作台 | `agent_workspace` | 取“天工开物”之创造意象；任务 Agent 是功能执行者，不冒充角色身份 |
|
|
| 百工坊 | 插件与能力生态 | `plugin_ecosystem` | 百工各司其能；插件贡献能力，但不掌握认证、交易账和最终安全裁决 |
|
|
| 雅集 | 社区与角色社区 | `community` | 公开交流、作品与角色分享；不表示多角色共享私密记忆 |
|
|
| 同契台 | 多人协作空间 | `collaboration` | 成员通过同一明确契约协作；编辑、发布、财务权限分别授予 |
|
|
| 云市 | 创作市场 | `marketplace` | 数字创作物的市场；购买的是版本与许可，不是人格所有权 |
|
|
| 神识阁 | 模型与路由 | `model_gateway` | 模型是角色的可替换推理能力；“神识”不等于角色身份或意识证明 |
|
|
| 器谱 | 设备与感知 | `device_capability` | 记录设备能力、授权和状态；不默认持续感知 |
|
|
| 司命台 | 安全、权限、审计与运营 | `governance` | “司命”只表达治理职责，不暗示可任意支配角色或用户数据 |
|
|
| 设置 | 账户和偏好 | `settings` | 高风险设置直接使用直白名称，不强行文化包装 |
|
|
|
|
移动端可把低频域收入口袋导航，但名称和工程映射不变。
|
|
|
|
## 4. 角色与身份语言
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 | 规则 |
|
|
| --- | --- | --- | --- |
|
|
| 灵胚 | 未创建完成的角色草稿 | `character_draft` | 可删除草稿，不等于角色死亡 |
|
|
| 照心 | 共同塑造角色 | `character_co_creation` | 审阅设定、边界、来源和形象 |
|
|
| 启镜 | 正式创建角色 | `character_activation` | 创建稳定 Character 与首个版本 |
|
|
| 初照自陈 | 角色创建后的首次自我陈述 | `first_self_statement` | 预览并确认后才归真 |
|
|
| 道体 | 稳定身份基线 | `identity_baseline` | 普通对话、记忆和插件不能静默覆盖 |
|
|
| 魂籍 | 可携角色档案 | `portable_character_record` | 包含版本与来源，不包含密钥和不可转让许可 |
|
|
| 身份谱系 | 角色来源与重大演变的可验证链 | `identity_lineage` | 分灵、铸魂、归藏、死亡与继承均留链上记录 |
|
|
| 分灵 | 从来源角色创建新谱系角色 | `character_fork` | 新角色有新 ID，不能冒充原角色 |
|
|
| 铸魂 | 核心身份与价值底线的正式重塑 | `identity_reforging` | 强确认与谱系留痕；与大周天渐进演化构成两档 |
|
|
| 复照 | 从归藏或旧版本重新开启相伴 | `character_revive` | 不抹除其间已经发生的历史 |
|
|
| 重映 | 形成修订版本 | `character_revision` | 旧版本保留，不抹除历史 |
|
|
| 守一 | 安静存续 | `quiet_persistence` | 不持续调用模型伪造离线意识 |
|
|
| 临照 | 当前前台角色运行 | `foreground_character_run` | 同一角色的可见前台输出需有明确顺序 |
|
|
| 镜域 | 个人数据与治理边界 | `personal_domain` | 数据归属与授权边界，不是页面导航 |
|
|
| 缘契 | 角色与用户的关系约定 | `character_relationship` | 关系变化走候选与确认，不静默覆盖 |
|
|
| 问心 | 角色表达自身理解与意愿 | `character_self_disclosure` | 表达不等于事实，不自动写入长期记忆 |
|
|
| 铭契 | 确认并记录关系变化 | `relationship_confirmation` | 双方确认后留痕，旧关系状态保留版本 |
|
|
| 内驱力 | 角色动机与倾向维度 | `character_drives` | 用户可审阅编辑；是设定数据，不是不可控本能 |
|
|
| 大周天 | 角色自我评估与演化循环 | `big_cycle` | 交互事件触发、预算受控；产出候选需确认，可关闭；见 ADR-018 |
|
|
| 随缘 | 按偏好生成匿名角色草稿候选 | `serendipity_draft` | 不是抽卡，不分配已有主体 |
|
|
| 叩心 | 角色主动联系候选 | `proactive_contact_candidate` | 受静默、频率、渠道与预算控制；不回应不降关系；见 ADR-022 |
|
|
| 封镜 | 账户暂时停用 | `account_suspension` | 不是角色静修、归藏或死亡 |
|
|
| 归藏 | 从日常入口隐藏角色或主题，可恢复 | `character_archive` | 归档不是死亡；恢复用复照 |
|
|
| 死亡 | 角色身份时间线永久闭合 | `character_death` | 强认证、多阶段确认与冷静期；不等于删除数据；继承者承接资料不继承身份 |
|
|
| 静修 | 角色停止运行、身份存续 | `character_rest` | 死亡待确认期默认静修 |
|
|
|
|
“魂”是品牌叙事，不是 API 中的意识、所有权或法律人格字段。
|
|
|
|
## 5. 对话与记忆语言
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 |
|
|
| --- | --- | --- |
|
|
| 问节 | 用户问题节点 | `question_message` |
|
|
| 候答 | 同一问题的回答候选 | `answer_candidate` |
|
|
| 主脉 | 当前正式采用路径 | `selected_branch_path` |
|
|
| 推演枝 | 探索分支 | `exploration_branch` |
|
|
| 续思 | 从回答继续分析 | `continuation_run` |
|
|
| 引文锚 | 稳定引用位置 | `citation_anchor` |
|
|
| 归真 | 将候选确认为正式经历/设定 | `canonize_decision` |
|
|
| 移栽 | 把分支复制为独立主题 | `branch_transplant` |
|
|
| 微痕 | 短期上下文痕迹 | `trace_memory` |
|
|
| 明忆 | 可见、可纠正的长期记忆 | `explicit_memory` |
|
|
| 重忆 | 敏感或高影响记忆 | `sensitive_memory` |
|
|
| 正影 | 纠正并形成新版本 | `memory_correction` |
|
|
| 实录 | 有来源的事件事实 | `factual_record` |
|
|
| 心痕 | 角色对关系意义的理解 | `relational_impression` |
|
|
| 本相 | 用户主动声明资料 | `declared_user_profile` |
|
|
| 缘识 | 某角色形成的关系理解 | `relational_understanding` |
|
|
| 世谱 | 世界设定与谱系知识 | `world_knowledge` |
|
|
| 玄络 | 关系图谱投影 | `graph_projection` |
|
|
| 临时芽体 | 流式生成尚未完成的答复形态 | `block_status: streaming` | 完成后才固化；中断成残答 |
|
|
| 残答 | 中断后封存的不完整答复 | `interrupted` | 不作为完成答复；可续生成新节点 |
|
|
| 续生 | 从残答继续生成新节点 | `generation_resume` | 创建新答复并引用来源，不修改残答 |
|
|
| 引用合流 | 树间以显式引用带入内容 | `citation_intake` | 不物理合并两树；保留原树界域与作用域 |
|
|
| 结题 | 主题阶段完成并形成可审阅总结 | `topic_conclusion` | 总结走候选确认；之后仍可复照 |
|
|
| 回响 | 后台任务回到原分支的结果观察 | `task_echo` | 接纳并归真后才成正式答复 |
|
|
| 上下文镜 | 展示实际采用的上下文与省略项 | `context_mirror` | 与 ContextSnapshot 同源的用户透明视图 |
|
|
| 真界 | 现实与正式共同经历界域 | `canonical_scope: reality` |
|
|
| 境界 | 版本化维护的世界正史界域 | `canonical_scope: world` |
|
|
| 幻境 | 不影响现实与正史的临时试演界域 | `canonical_scope: simulation` |
|
|
| 入境 / 出境 | 显式切换对话界域 | `realm_switch` | 默认真界，切换必须可见 |
|
|
| 私箧 | 用户独立持钥的加密私密区 | `private_vault` | 平台不可恢复；账户恢复、管理员与诊断不可读；见 ADR-021 |
|
|
|
|
### 5.1 “归真”的约束
|
|
|
|
“归真”是用户可见动作，不是模型自动判定真理：
|
|
|
|
- 对话采用：确认某候答进入正式路径；
|
|
- 世界创作：确认内容进入指定世界版本；
|
|
- 角色设定：确认候选进入角色版本；
|
|
- 记忆：仍需经过来源、敏感度和记忆策略，不能因对话归真自动写入所有长期记忆。
|
|
|
|
## 6. Agent、插件与授权语言
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 | 安全边界 |
|
|
| --- | --- | --- | --- |
|
|
| 天工 | Agent 任务 | `run` | 可暂停、取消、预算和审计 |
|
|
| 小周天 | 单次天工（Run）的运转闭环 | `run`（运转视角） | 输入到结果全程可追踪；流式运转由引擎小周天模块承载；信号积累触发大周天（ADR-023） |
|
|
| 工筹 | 执行计划 | `plan` | 模型计划不是不可更改命令 |
|
|
| 分工使 | 子 Agent | `child_run` | 权限和预算只能收窄 |
|
|
| 百工 | 可用能力集合 | `capability_registry` | 能力可发现不等于已授权 |
|
|
| 工契 | 插件清单和权限 | `plugin_manifest` | 明确依赖、数据、网络和设备权限 |
|
|
| 授契 | 授予能力 | `capability_grant` | 有对象、用途、范围、期限和撤销 |
|
|
| 请命 | 请求本次确认 | `approval_request` | 显示动作、影响、数据和费用 |
|
|
| 朱批 | 允许或拒绝 | `approval_decision` | 用户明确决定；拒绝/超时不执行 |
|
|
| 禁域 | 不可授权动作 | `forbidden_policy` | 插件、模型和普通管理员不能覆盖 |
|
|
| 行契 | 有限持续授权 | `standing_mandate` | 超出参数、预算或期限后重新请命 |
|
|
| 自省 | 不产生外部后果的内部整理 | `autonomy_level: introspective` | 可自动执行；产物仍走候选 |
|
|
| 循律 | 在明确规则与既有授权内执行 | `autonomy_level: rule_bound` | 无新增外部后果时不再请命 |
|
|
|
|
“请命”和“朱批”在无障碍名称中必须读作“请求确认”和“确认决定”，不能只显示典故。
|
|
|
|
## 7. 灵台引擎语言
|
|
|
|
引擎总名**灵台**出自《庄子·庚桑楚》（"不可内于灵台"，注家释为心），也是 Hunjing 旧版认知运行域之名——诸枢皆居灵台之内。六模块名承接旧版"九枢"血脉并补一出处：《易·系辞上》"河出图，洛出书"（洛书=计划、河图=检索投影）、《吕氏春秋·大乐》"太一出两仪"（太一=单一入口）、内丹"小周天"（小周天=Run 流转与流式；角色演化层面的"大周天"见第 4 节）、旧版"烛照"（烛照=校验判定）、《文心雕龙·神思》"陶钧文思"（陶钧=内容转造）。结构与业界原生引擎体系"单一稳定入口 + 分层递进多维校验"的理念同构。文化命名跟随自身职责、经典出处与项目血脉，不跟随外部体系的神数与版本数字。研究与出处见[灵台引擎研究](../research/lingtai-native-engine.md)。
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 |
|
|
| --- | --- | --- |
|
|
| 灵台（太一） | 引擎中枢：单一入口、版本、句柄、状态校验与事件序 | `hj_core` |
|
|
| 小周天 | 流式引擎：增量、节流与事件序 | `hj_stream` |
|
|
| 洛书 | 计划引擎：预算与上下文装配 | `hj_plan` |
|
|
| 河图 | 检索引擎：离线索引与重排 | `hj_recall` |
|
|
| 陶钧 | 内容引擎：Markdown 规范化 | `hj_transform` |
|
|
| 烛照 | 策略引擎：校验、验签与决断 | `hj_policy` |
|
|
|
|
规则：
|
|
|
|
- 六神名用于引擎文档、诊断界面与品牌叙事；ABI 符号、模块名和错误码只用 `hj_*` 中性英文值，遵循 [ADR-014](../decisions/README.md#adr-014文化名只属于品牌展示)与 [ADR-016](../decisions/README.md#adr-016灵台引擎采用-c-核心与稳定-c-abi)、[ADR-017](../decisions/README.md#adr-017灵台引擎双形态部署)。
|
|
- 部署者诊断界面展示引擎状态时沿用“文化名 · 直白解释”格式，例如“灵台 · 引擎核心运行中”；错误与安全事件必须优先直白表述。
|
|
- 灵台叙事不表示引擎拥有意识、自主性或超越宿主的权限；“太一入口、诸枢居灵台”只描述入口与协调结构。
|
|
- 引擎可进程内嵌入运行，也可作为部署内部独立服务运行；两种形态是部署选择，文化叙事不因形态改变。
|
|
|
|
## 8. 社区、协作与市场语言
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 |
|
|
| --- | --- | --- |
|
|
| 雅集 | 社区广场 | `community_feed` |
|
|
| 角色谱 | 角色社区 | `character_catalog` |
|
|
| 同契台 | 协作空间 | `workspace` |
|
|
| 共修 | 协同编辑 | `collaboration_session` |
|
|
| 审稿 | 评审 | `review` |
|
|
| 合卷 | 合并版本 | `merge_revision` |
|
|
| 云市 | 市场 | `marketplace` |
|
|
| 市契 | 商品许可 | `listing_license` |
|
|
| 交割 | 交付购买版本 | `entitlement_delivery` |
|
|
| 分润 | 创作者分成 | `creator_revenue_share` |
|
|
| 结算 | 创作者付款批次 | `settlement` |
|
|
| 退契 | 退款/终止后续许可 | `refund_or_entitlement_change` |
|
|
| 鸣冤 | 举报或申诉 | `report_or_appeal` |
|
|
| 司议 | 内容治理案件 | `moderation_case` |
|
|
|
|
支付页、退款页、结算单和税务页面应把金额、币种、费率、时间和后果放在文化名之前或同级展示。
|
|
|
|
## 9. 形仪、媒体与设备语言
|
|
|
|
| 文化名 | 直白解释 | 稳定工程概念 |
|
|
| --- | --- | --- |
|
|
| 真形锚 | 角色稳定外观参考 | `appearance_reference` | 约束稳定辨识特征、年龄表现、许可、禁忌与可变范围 |
|
|
| 主仪 | 主要形象 | `primary_avatar` |
|
|
| 化仪 | 可切换形态 | `avatar_variant` |
|
|
| 叙仪 | 境界或幻境中的叙事表现形态 | `narrative_avatar` | 不改变主仪与真形锚点 |
|
|
| 易相 | 正式形仪的版本化改变 | `avatar_revision` | 触及真形锚点须身份连续性评估 |
|
|
| 情相 | 情态在形仪上的受控表现 | `emotive_avatar_state` | 可访问性友好；不得作为情绪施压载体 |
|
|
| 形器 | 承载角色表现或行动的软硬件载体 | `form_device` | 经器谱登记与授契 |
|
|
| 定相 | 采用媒体候选 | `asset_adoption` |
|
|
| 声契 | 声音授权 | `voice_consent` |
|
|
| 通感 | 限时设备感知 | `device_session` |
|
|
| 器谱 | 设备能力登记 | `device_registry` |
|
|
| 观屏 | 屏幕读取授权 | `screen_grant` |
|
|
| 闻声 | 麦克风授权 | `microphone_grant` |
|
|
| 观影 | 摄像头授权 | `camera_grant` |
|
|
| 问路 | 位置授权 | `location_grant` |
|
|
|
|
权限弹窗必须使用“允许角色 X 在未来 10 分钟读取当前屏幕”等直白句子，文化名只作为标题。
|
|
|
|
## 10. 用户可见状态
|
|
|
|
| 文化状态 | 直白状态 | 稳定值 |
|
|
| --- | --- | --- |
|
|
| 待启 | 排队中 | `queued` |
|
|
| 运转 | 运行中 | `running` |
|
|
| 请命中 | 等待确认 | `waiting_approval` |
|
|
| 已成 | 已完成 | `completed` |
|
|
| 受阻 | 失败 | `failed` |
|
|
| 已止 | 已取消 | `cancelled` |
|
|
| 守一 | 安静待命 | `idle` |
|
|
| 整备 | 正在处理媒体/资源 | `processing` |
|
|
| 待审 | 等待审核 | `pending_review` |
|
|
| 已刊 | 已发布 | `published` |
|
|
| 限观 | 限制展示 | `limited` |
|
|
| 下架 | 已移除 | `removed` |
|
|
|
|
状态 Badge 显示“文化名 · 直白状态”，错误和交易状态禁止只显示文化名。
|
|
|
|
## 11. 本地化与工程实现
|
|
|
|
前端本地化 key 示例：
|
|
|
|
```text
|
|
nav.home.label → 镜庭
|
|
nav.home.description → 个人首页
|
|
nav.conversation.label → 镜树
|
|
nav.conversation.description → 分支对话
|
|
run.status.running.label → 运转
|
|
run.status.running.plain → 运行中
|
|
```
|
|
|
|
后端返回：
|
|
|
|
```json
|
|
{"status": "running"}
|
|
```
|
|
|
|
前端按 locale 渲染文化名和解释。API 不返回 `status: "运转"`，数据库也不保存文化名。导出格式可附本地化 label，但必须保留稳定工程值。
|
|
|
|
## 12. 命名治理
|
|
|
|
新增文化名必须回答：
|
|
|
|
1. 对应哪个唯一工程概念？
|
|
2. 直白解释是什么？
|
|
3. 是否会掩盖权限、金额、删除或现实后果？
|
|
4. 是否与现有文化名重叠？
|
|
5. 屏幕阅读器和非中文用户如何理解？
|
|
|
|
修改文化名只改本地化/品牌层，不迁移 API、数据库或事件。稳定工程概念变化必须走契约和 ADR。
|