369 lines
16 KiB
Markdown
369 lines
16 KiB
Markdown
# 魂镜契约词汇与实现值集
|
||
|
||
> 状态：重写目标态（rewrite/1.0 基线）
|
||
> 定位：API、Schema、事件与存储使用的稳定英文标识、ID 前缀、枚举取值、事件名与错误码的单一事实源。下游文档引用而不复制。未登记的标识不得据中文直译擅自补齐。
|
||
|
||
## 1. 命名风格
|
||
|
||
- 文化名用于文档、注释与对外叙事；工程层（代码目录、crate、容器名）保留英文技术标识。
|
||
- 稳定工程标识使用英文小写蛇形（`mirror_tree`、`canonical_scope`）；枚举值用英文；事件名 ` <聚合>.<过去式动词>`（`tree.canonized`）。
|
||
- 新增文化命名、ID 前缀、枚举、事件与错误码必须先在本文件登记。
|
||
|
||
## 2. 服务与基础设施文化命名
|
||
|
||
### 2.1 应用主体
|
||
|
||
| 文化名 | 工程对象 | 说明 |
|
||
| --- | --- | --- |
|
||
| 灵台 | Backend Core（Python FastAPI） | 六域业务与插件化认知运行时宿体 |
|
||
| 琉璃镜 | Frontend（Next.js） | 前端应用与设计语言总称 |
|
||
| 照壁 | BFF（Fastify） | 入门第一重：鉴权透传、流代理、响应裁剪 |
|
||
| 神识 | Model Gateway（Go） | 模型网关：协议、路由、流式、BYOK、计量 |
|
||
| 博闻 | MCP Web Search（Go） | 联网搜索 MCP 服务（多引擎、密钥池、缓存、熔断） |
|
||
| 元炁 | Local Inference Engine | 本地 LLM / Embedding / Rerank 推理，作为神识本地 Endpoint |
|
||
| 天目 | Local OCR Engine | 本地 OCR 感知 |
|
||
| 乾坤 | Sandbox Engine（Rust） | 百工隔离执行后端；HMAC 短期凭证 |
|
||
| 镜匣 | Desktop Shell（Tauri v2） | 最小桌面壳：承载琉璃镜、本地能力桥、乾坤通道 |
|
||
| 一炁 | Unified Event Stream | 统一事件流（run_events），事件贯通全局 |
|
||
| 辰正 | Time Sense | 时态感知（认识时长、离线、重逢、纪念日）；横切能力，重写期后段交付 |
|
||
| 叩心枢 | Proactive Contact | 主动对话守护：叩心候选的静默、频率、渠道与预算控制 |
|
||
| 玄关 | ~~MCP Gateway~~ | **已退役**：MCP 服务登记并入灵台百工，不保留独立网关 |
|
||
|
||
### 2.2 九枢（灵台插件层）
|
||
|
||
| 文化名 | 稳定标识（pivot 枚举值） | 职责 |
|
||
| --- | --- | --- |
|
||
| 灵核 | `linghe` | 人格调节（道体锚点 + 调节层） |
|
||
| 太一 | `taiyi` | 目标维护与冲突检测 |
|
||
| 司命 | `siming` | 安全裁决（能力/数据/后果/情境四维） |
|
||
| 烛照 | `zhuzhao` | 观察与反思（心痕候选、正影建议） |
|
||
| 河图 | `hetu` | 世界认知（实体、世谱激活） |
|
||
| 洛书 | `luoshu` | 计划生成与跟踪 |
|
||
| 息壤 | `xirang` | 记忆（写入候选、检索、注入） |
|
||
| 百工 | `baigong` | 能力注册（工具/MCP/Skill/感官） |
|
||
| 天工阁 | `tiangongge` | 功能 Agent 编排（受托任务） |
|
||
|
||
`pivot_health`：`healthy` / `degraded` / `down`。
|
||
|
||
### 2.3 存储后端与运维
|
||
|
||
| 文化名 | 工程对象 | 说明 |
|
||
| --- | --- | --- |
|
||
| 金匮 | PostgreSQL（本地开发 SQLite） | 关系事实库 |
|
||
| 灵犀 | 向量层（pgvector；Milvus 按需） | 语义检索 |
|
||
| 玄络 | 图库投影（Neo4j / NebulaGraph，按需） | 关系图谱投影，非事实源 |
|
||
| 灵泉 | Redis | 缓存 / 会话 / 队列 / 命台租约 |
|
||
| 玉函 | 对象存储（本地 / MinIO / S3） | 媒体与大文件 |
|
||
| 天门 | Nginx | 反向代理统一入口 |
|
||
| 司命台 | Admin Console | 治理控制台（琉璃镜 admin 区） |
|
||
|
||
### 2.4 用户创作与编排层（ST 兼容）
|
||
|
||
| 文化名 | 工程对象 | 说明 |
|
||
| --- | --- | --- |
|
||
| 魂册 | Character Card | ST V2/V3 角色卡仅作导入导出交换格式 |
|
||
| 世谱 | Lorebook / World Info | 关键词 + 实体双触发；与河图对偶 |
|
||
| 符文引擎 | Macros | `{{char}}` / `{{user}}` 等占位符展开 |
|
||
| 眉批 | Author's Note | 按 depth + role 注入 |
|
||
| 言灵编排 | Prompt Manager | 提示词实体化编排（identifier/position/depth/order） |
|
||
| 本相 | User Personas | 用户自身之相，可按范围授权跨人物 |
|
||
| 火候 | Generation Presets | 采样参数包 |
|
||
| 科仪 | Instruct Templates | 模型消息格式模板 |
|
||
| 刻符 | Regex Scripts | 百工 skill 子类 |
|
||
| 锦囊 | Quick Replies | 快捷回复 |
|
||
| 咒令 | Slash Commands | 命令式入口 |
|
||
| 雅集 | Group Gathering | 多人物同席（1.0 后续） |
|
||
|
||
## 3. 产品与身份稳定标识
|
||
|
||
| 中文概念 | 稳定英文标识 |
|
||
| --- | --- |
|
||
| 人物 | `character` |
|
||
| 灵胚 | `embryo_draft` |
|
||
| 魂籍 | `portable_identity_record` |
|
||
| 命台 | `authoritative_runtime_seat` |
|
||
| 执镜者 | `custodian` |
|
||
| 执镜关系 | `custodianship` |
|
||
| 镜域 | `personal_domain` |
|
||
| 道体 | `identity_baseline` |
|
||
| 镜树 | `mirror_tree` |
|
||
| 问节 / 候答 / 续思 | `question_node` / `answer_candidate` / `continuation` |
|
||
| 芽体 / 残答 | `budding` / `sealed_residual` |
|
||
| 主脉 / 推演枝 | `canonical_trunk` / `exploration_branch` |
|
||
| 归真作用域 | `canonical_scope` |
|
||
| 归真 / 采用 / 移栽 | `canonize` / `adopt` / `transplant` |
|
||
| 引文锚 | `citation_anchor` |
|
||
| 正影 | `correction` |
|
||
| 铸魂 / 分灵 | `identity_reforging` / `identity_branching` |
|
||
| 微痕 / 明忆 / 重忆 | `trace_memory` / `explicit_memory` / `sensitive_memory` |
|
||
| 实录 / 心痕 | `factual_record` / `relational_impression` |
|
||
| 本相 / 缘识 | `declared_self` / `relational_understanding` |
|
||
| 缘契 / 问心 / 铭契 | `relationship_covenant` / `self_disclosure` / `confirm_covenant` |
|
||
| 真界 / 境界 / 幻境 | `reality` / `persistent_world` / `simulation` |
|
||
| 守一 / 应感 / 临照 / 叩心 | `quiet_persistence` / `event_awakening` / `foreground_presence` / `proactive_contact` |
|
||
| 司命 / 授契 / 行契 / 请命 / 禁域 | `safety_governor` / `grant_capability` / `standing_mandate` / `request_approval` / `non_overridable_boundary` |
|
||
| 神识 / 百工 / 天工阁 | `model_gateway` / `capability_registry` / `task_agent_workspace` |
|
||
| 形仪 / 器谱 / 魂册 | `embodied_form` / `device_registry` / `character_card` |
|
||
|
||
## 4. ID 前缀表
|
||
|
||
带业务前缀的 ULID。前缀一旦登记不得变更。
|
||
|
||
| 对象 | 前缀 | 状态 |
|
||
| --- | --- | --- |
|
||
| user 用户 | `user_` | 已用（复用） |
|
||
| character 人物 | `character_` | 已用（重建） |
|
||
| embryo_draft 灵胚 | `embryo_` | 新增 |
|
||
| custodianship 执镜关系 | `cust_` | 新增 |
|
||
| runtime_seat 命台 | `seat_` | 新增 |
|
||
| identity_record 魂籍 | `identity_` | 新增 |
|
||
| mirror_tree 镜树 | `tree_` | 新增 |
|
||
| tree_node 节点 | `node_` | 新增 |
|
||
| citation 引文锚 | `cite_` | 新增 |
|
||
| canonization 归真 | `canon_` | 新增 |
|
||
| transplant 移栽 | `transplant_` | 新增 |
|
||
| memory 记忆 | `memory_` | 新增 |
|
||
| factual_record 实录 | `frecord_` | 新增 |
|
||
| covenant 缘契 | `covenant_` | 新增 |
|
||
| persistent_world 境界 | `world_` | 新增 |
|
||
| world_entity / world_relation | `wentity_` / `wrelation_` | 新增 |
|
||
| form_anchor / form / voice_profile | `anchor_` / `form_` / `voice_` | 新增 |
|
||
| device / device_grant 器谱 | `device_` / `dgrant_` | 新增 |
|
||
| run 运行 | `run_` | 已用（重建） |
|
||
| event 事件 | `event_` | 已用（复用） |
|
||
| trace 调用链 | `trace_` | 已用（复用） |
|
||
| tool / tool_call | `tool_` / `tool_call_` | 新增 |
|
||
| skill | `skill_` | 新增 |
|
||
| mcp_server | `mcp_` | 已用（复用） |
|
||
| mandate 授契/行契 | `mandate_` | 新增 |
|
||
| confirmation 确认 | `confirm_` | 已用（改造） |
|
||
| audit_event 审计 | `audit_` | 新增 |
|
||
| idempotency 幂等键 | `idempotency_` | 已用（复用） |
|
||
| import_job / import_item | `import_` / `import_item_` | 已用（改造） |
|
||
| lorebook / lorebook_entry | `lorebook_` / `lorebook_entry_` | 已用（改造） |
|
||
| user_persona 本相 | `user_persona_` | 新增 |
|
||
| generation_preset 火候 | `gen_preset_` | 新增 |
|
||
| instruct_template 科仪 | `instruct_tpl_` | 新增 |
|
||
| quick_reply 锦囊 | `quick_reply_` | 新增 |
|
||
| media_object 媒体 | `media_` | 新增 |
|
||
| provider / endpoint / model_slot / route（神识） | `provider_` / `endpoint_` / `slot_` / `route_` | 新增 |
|
||
| byok_key | `byok_` | 新增 |
|
||
|
||
**已删除前缀**（旧模型，不得再使用）：`personality_`、`personality_proposal_`、`mood_`、`timeline_`、`tl_event_`、`knowledge_doc_`、`chunk_`、`emb_ref_`、`idle_window_`、`suspend_`、`goal_`、`agent_`、`cycle_`、`plan_`、`anniv_`、`situ_`、`skillfile_`、`session_`、`message_`、`subgoal_`、`uncertainty_`、`curiosity_`、`evolution_`、`profile_candidate_`。
|
||
|
||
## 5. JSON 字段后缀规则
|
||
|
||
| 后缀 | 用途 |
|
||
| --- | --- |
|
||
| `_json` | 数据库列（`metadata_json`、`dimensions_json`） |
|
||
| 无后缀 | API / DTO / SSE（`metadata`、`dimensions`） |
|
||
|
||
对外 API 不得暴露 `_json` 后缀字段。
|
||
|
||
## 6. 通用枚举
|
||
|
||
### 6.1 `sensitivity` 敏感等级
|
||
|
||
`none` / `low` / `medium`（默认摘要展示）/ `high`（不展示原文、不自动写入长期状态）
|
||
|
||
### 6.2 `visibility` 事件可见性
|
||
|
||
`public`（可推送前端）/ `internal` / `audit`
|
||
|
||
### 6.3 `privacy_level` 隐私等级
|
||
|
||
`normal` / `private`（人物私域）/ `vault`（私箧，用户独立持钥）
|
||
|
||
### 6.4 `risk_level` 风险等级
|
||
|
||
`minimal` / `low` / `medium` / `high` / `critical`
|
||
|
||
### 6.5 `autonomy_level` 自主性等级（司命）
|
||
|
||
| 值 | 说明 |
|
||
| --- | --- |
|
||
| `introspect` | 自省：不产生外部后果的内部整理 |
|
||
| `regulated` | 循律：在明确规则与既有授权内执行 |
|
||
| `approval_required` | 请命：执行前须用户当次确认 |
|
||
| `forbidden` | 禁域：任何情况下不得执行 |
|
||
|
||
### 6.6 `consent_status` 授权状态
|
||
|
||
`pending` / `granted` / `denied` / `expired` / `revoked`
|
||
|
||
### 6.7 `source_reliability` 来源可信（观察与证据）
|
||
|
||
`verified` / `declared` / `inferred` / `unverified`
|
||
|
||
## 7. 人物与生命周期
|
||
|
||
### 7.1 `character.status`
|
||
|
||
`active`（临照可用）/ `preserved`（保全态：欠费或封镜期间，只读保全）/ `dormant`（静修）/ `death_pending`（死亡冷静期）/ `deceased`（已死亡，只读档案）
|
||
|
||
### 7.2 `embryo_draft.status`
|
||
|
||
`drafting` / `previewing`（照心试演）/ `confirming`（启镜确认）/ `activated`（已启镜，转正式人物）/ `abandoned`
|
||
|
||
### 7.3 `character.source`
|
||
|
||
`original` / `adopted` / `imported` / `serendipity`（随缘）
|
||
|
||
## 8. 运行时
|
||
|
||
### 8.1 `run.status`
|
||
|
||
`queued`（命台排队）/ `running` / `interrupted` / `failed` / `completed` / `cancelled`
|
||
|
||
### 8.2 `run.kind`
|
||
|
||
`foreground`（前台意识流）/ `background_task`（天工阁受托任务）/ `awakening`（应感）
|
||
|
||
### 8.3 事件类型 `event.type`（一炁）
|
||
|
||
命名规范：`<聚合>.<过去式>`。核心集合：
|
||
|
||
- 运行：`run.started` / `run.queued` / `run.interrupted` / `run.finished` / `run.cancelled`
|
||
- 回合：`turn.started` / `turn.finished`
|
||
- 上下文：`context.projected`（投影快照引用）
|
||
- 模型：`llm.requested` / `llm.delta` / `llm.completed` / `llm.failed`
|
||
- 工具：`tool.pre_execute` / `tool.executed` / `tool.rejected` / `tool.result_observed`
|
||
- 接纳：`result.pre_accept` / `result.accepted`
|
||
- 镜树：`tree.created` / `tree.node_created` / `tree.node_solidified` / `tree.node_sealed`（残答封存）/ `tree.adopted` / `tree.canonized` / `tree.transplanted`
|
||
- 记忆：`memory.candidate_created` / `memory.confirmed` / `memory.denied` / `memory.superseded` / `memory.deleted`
|
||
- 人物：`character.activated`（启镜）/ `character.reforged`（铸魂）/ `character.branch_off`（分灵）/ `character.death_requested` / `character.deceased`
|
||
- 缘契：`covenant.proposed` / `covenant.disclosed`（问心）/ `covenant.confirmed`（铭契）/ `covenant.changed` / `covenant.withdrawn`
|
||
- 司命：`safety.ruled`（裁决记录）/ `safety.confirm_requested` / `safety.confirm_resolved`
|
||
- 能力：`capability.granted` / `capability.revoked`
|
||
- 界域：`realm.entered` / `realm.left`
|
||
|
||
### 8.4 `confirmation.status`
|
||
|
||
`pending` / `approved` / `rejected` / `expired`（超时视为拒绝执行）
|
||
|
||
## 9. 镜树
|
||
|
||
### 9.1 `node.type`
|
||
|
||
`question`（问节）/ `answer`（候答）/ `continuation`（续思/续生延展）
|
||
|
||
### 9.2 `node.status`
|
||
|
||
`budding`（芽体，流式中）/ `sealed_residual`（残答，中断封存）/ `solidified`（已固化）
|
||
|
||
### 9.3 `tree.status`
|
||
|
||
`active` / `archived`
|
||
|
||
### 9.4 `canonical_scope`（归真作用域，同 `realm` 值族）
|
||
|
||
| 值 | 说明 |
|
||
| --- | --- |
|
||
| `reality` | 真界正式共同经历 |
|
||
| `persistent_world` | 指定境界正史（须携带 `world_id`） |
|
||
| `simulation` | 幻境试演记录（只确认"发生过这次试演"） |
|
||
|
||
### 9.5 `citation.target_type`
|
||
|
||
`text_range` / `image_region` / `pdf_region` / `attachment` / `av_segment`
|
||
|
||
## 10. 记忆
|
||
|
||
### 10.1 `memory.tier`
|
||
|
||
`trace`（微痕）/ `explicit`（明忆）/ `sensitive`（重忆）
|
||
|
||
### 10.2 `memory.type`
|
||
|
||
| 值 | 说明 |
|
||
| --- | --- |
|
||
| `persona` | 用户或人物稳定属性 |
|
||
| `episodic` | 客观事件（绝不含主观感受） |
|
||
| `instruction` | 对人物的长期规则 |
|
||
| `relationship_view` | 心痕：人物对经历/关系的主观理解，非事实 |
|
||
| `fact_candidate` | 用户手动入忆的启发/观点/假设（须显式标注，不伪装实录） |
|
||
|
||
### 10.3 `memory.status`
|
||
|
||
`candidate` / `pending`（待用户确认，重忆必经）/ `active` / `superseded`（正影旧版）/ `tombstoned`（删除墓碑）
|
||
|
||
### 10.4 `memory.source`
|
||
|
||
`user_explicit`（用户明说，冲突时优先）/ `self_inferred`（人物推断）
|
||
|
||
### 10.5 `trigger.kind`
|
||
|
||
`keyword` / `secondary_logic` / `disclosure`（单一触发条件）/ `vector`
|
||
|
||
## 11. 缘契
|
||
|
||
### 11.1 `covenant.status`
|
||
|
||
`proposed` / `active` / `changed` / `withdrawn`
|
||
|
||
维度键（`dimensions_json` 内）：`closeness` / `trust` / `romantic` / `authority` / `boundary` 等，值为区间描述而非裸数值；多维并存，不以单一好感度表达。
|
||
|
||
## 12. 三界
|
||
|
||
`realm`：`reality` / `persistent_world` / `simulation`（与 `canonical_scope` 同值族，`realm` 描述节点当前界域，`canonical_scope` 描述归真落点）。
|
||
|
||
## 13. 形仪与器谱
|
||
|
||
### 13.1 `form.type` / `form.status`
|
||
|
||
`primary`（主仪）/ `alternate`（化仪）；`candidate`（候选未定相）/ `confirmed`（已定相）
|
||
|
||
### 13.2 `voice.source`
|
||
|
||
`preset`（合成预设）/ `original`（原创设计）/ `licensed_clone`（授权克隆，按身份/用途/期限/传播范围治理，可撤回）
|
||
|
||
### 13.3 `device.trust_status`
|
||
|
||
`paired` / `verified` / `revoked`
|
||
|
||
## 14. 神识
|
||
|
||
### 14.1 `model_slot` 能力槽位
|
||
|
||
`chat` / `vision` / `asr` / `tts` / `image` / `embedding` / `rerank` / `safety`
|
||
|
||
### 14.2 `endpoint.type`
|
||
|
||
`openai_compatible` / `anthropic` / `gemini` / `local`（元炁）
|
||
|
||
### 14.3 `route.strategy`
|
||
|
||
`priority`（优先级故障切换）/ `weighted`（加权随机）/ `sticky`（会话粘性优先）
|
||
|
||
## 15. 错误码
|
||
|
||
格式：`HJ-<服务段><序号>`，服务段：灵台 `1`、神识 `2`、照壁 `3`、乾坤 `4`、通用 `9`。
|
||
|
||
| 码 | 含义 |
|
||
| --- | --- |
|
||
| `HJ-1001` | 未认证 |
|
||
| `HJ-1003` | 权限不足（含跨人物/跨域越权） |
|
||
| `HJ-1101` | 命台忙（前台排队中，返回队列位置） |
|
||
| `HJ-1102` | 归真冲突（并发归真互相冲突路径，须明确处理） |
|
||
| `HJ-1103` | 节点状态不允许该操作（如芽体归真） |
|
||
| `HJ-1201` | 重忆未确认即写入被拒绝 |
|
||
| `HJ-1202` | 删除后内容不可再使用 |
|
||
| `HJ-1301` | 禁域裁决拒绝（不可申诉绕过） |
|
||
| `HJ-1302` | 请命超时未确认，未执行 |
|
||
| `HJ-2001` | 无可用模型端点（全部候选失败） |
|
||
| `HJ-2002` | 模型请求 Schema 版本不受支持 |
|
||
| `HJ-2003` | BYOK 密钥无效或超范围 |
|
||
| `HJ-2004` | 配额不足 |
|
||
| `HJ-3001` | BFF 上游不可达 |
|
||
| `HJ-3002` | SSE 代理超时 |
|
||
| `HJ-4001` | 沙箱凭证验签失败 |
|
||
| `HJ-4002` | 执行超时被终止 |
|
||
| `HJ-9001` | 请求幂等冲突 |
|
||
| `HJ-9002` | 参数校验失败 |
|
||
|
||
## 16. 契约治理
|
||
|
||
- 机器可读 OpenAPI 3.1 与 JSON Schema 由灵台代码生成，是本词典结构契约的代码化表达；两者不一致时以修复代码对齐词典为准，不得反向改词典迁就实现。
|
||
- 跨服务事件 Schema 与协议测试向量按能力矩阵逐步归位于 `docs/contracts/`。
|
||
- 已退役标识（§4 删除清单、玄关等）不得在新代码出现；发现即删除，不做兼容层。
|