- 产品层:产品宪章与永久禁域、产品定义、完整 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
18 KiB
中国古代神话与道家文化语言体系
1. 定位
Hunjing 的中文品牌名为魂镜。文化语言用于产品世界观、导航、页面标题、用户动作和可见状态,让平台形成统一的东方叙事;工程契约继续使用中性英文标识,保证跨语言、OpenAPI、数据库、日志和第三方 SDK 的稳定性。
统一展示格式:
文化名 · 直白解释
例如:
镜树 · 分支对话
息壤 · 角色记忆
请命 · 等待你的确认
规则:
- 首次出现必须同时给出直白解释;不能要求用户先理解典故。
- 风险、金额、权限、删除、支付和法律后果必须优先使用直白语言,文化名只能辅助。
- API、数据库、事件、错误码和权限 scope 只使用稳定工程值。
- UI 文案由本地化目录把稳定
label_key映射为文化名和解释,后端不把文化名当枚举。 - 文化名不得掩盖失败、越权、收费、撤销、永久删除或现实后果。
文化名承接:引擎诸枢(灵台、太一、小周天、洛书、河图、烛照)与镜域、缘契、问心、铭契、世谱、玄络、三界(真界/境界/幻境)、私箧、叩心、归藏、随缘等承接 Hunjing 旧版(main 分支)已确立的命名;旧版中与当前 1.0 架构不再对应的概念(命台、执镜者、司席)不再沿用,避免为已变化的结构保留误导性名称。从旧版迁移概念时,先核对当前架构与产品范围仍有真实对应物,再登记映射;语义已被现有文化名覆盖的(如天宰与司命台、魂册与魂籍)不重复引入。
2. 世界观骨架
魂镜不是把每个服务包装成神仙官职,而是用“镜”表达映照、分支与自省,用“天工”表达能力与创造,用“契”表达明确授权,用“司”表达治理责任。
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 |
| 真界 | 现实与正式共同经历界域 | canonical_scope: reality |
| 境界 | 版本化维护的世界正史界域 | canonical_scope: world |
| 幻境 | 不影响现实与正史的临时试演界域 | canonical_scope: simulation |
| 入境 / 出境 | 显式切换对话界域 | realm_switch |
| 私箧 | 用户独立持钥的加密私密区 | private_vault |
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 节)、旧版"烛照"(烛照=校验判定)、《文心雕龙·神思》"陶钧文思"(陶钧=内容转造)。结构与业界原生引擎体系"单一稳定入口 + 分层递进多维校验"的理念同构。文化命名跟随自身职责、经典出处与项目血脉,不跟随外部体系的神数与版本数字。研究与出处见灵台引擎研究。
| 文化名 | 直白解释 | 稳定工程概念 |
|---|---|---|
| 灵台(太一) | 引擎中枢:单一入口、版本、句柄、状态校验与事件序 | hj_core |
| 小周天 | 流式引擎:增量、节流与事件序 | hj_stream |
| 洛书 | 计划引擎:预算与上下文装配 | hj_plan |
| 河图 | 检索引擎:离线索引与重排 | hj_recall |
| 陶钧 | 内容引擎:Markdown 规范化 | hj_transform |
| 烛照 | 策略引擎:校验、验签与决断 | hj_policy |
规则:
- 六神名用于引擎文档、诊断界面与品牌叙事;ABI 符号、模块名和错误码只用
hj_*中性英文值,遵循 ADR-014与 ADR-016、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 示例:
nav.home.label → 镜庭
nav.home.description → 个人首页
nav.conversation.label → 镜树
nav.conversation.description → 分支对话
run.status.running.label → 运转
run.status.running.plain → 运行中
后端返回:
{"status": "running"}
前端按 locale 渲染文化名和解释。API 不返回 status: "运转",数据库也不保存文化名。导出格式可附本地化 label,但必须保留稳定工程值。
12. 命名治理
新增文化名必须回答:
- 对应哪个唯一工程概念?
- 直白解释是什么?
- 是否会掩盖权限、金额、删除或现实后果?
- 是否与现有文化名重叠?
- 屏幕阅读器和非中文用户如何理解?
修改文化名只改本地化/品牌层,不迁移 API、数据库或事件。稳定工程概念变化必须走契约和 ADR。