Files
hunjing/docs/product/cultural-language.md
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

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. 命名治理

新增文化名必须回答:

  1. 对应哪个唯一工程概念?
  2. 直白解释是什么?
  3. 是否会掩盖权限、金额、删除或现实后果?
  4. 是否与现有文化名重叠?
  5. 屏幕阅读器和非中文用户如何理解?

修改文化名只改本地化/品牌层,不迁移 API、数据库或事件。稳定工程概念变化必须走契约和 ADR。