hunjing/docs/contracts/contract-glossary.md

魂镜契约词汇与实现值集

状态：重写目标态（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 删除清单、玄关等）不得在新代码出现；发现即删除，不做兼容层。