chenxin
144415247e
- 神识 Go：store 双实现（PG 自动建表+60s 就绪重试 / 内存回退）承载 usage_logs·byok_keys·quota_balances；BYOK 密钥库（AES-GCM 加密、API 脱敏、撤回即失效、主密钥未配置 fail-closed）；配额三段式（预扣 max_tokens 钳位 1M→结算实际 token→全败幂等退款，HJ-2004）；计量归属（IR user_id→usage_logs，/me/usage 用户维度聚合+配额总览，/admin/usage/sample 对账抽样）；Anthropic/Gemini 出站适配器（SSE 解析、system 提升、用量映射）；stub 端点补名修复计量空 endpoint - IR 契约：user_id/byok_key_id 双端同步（Go types.go + Py types.py） - 灵台：runs.owner_id（迁移 005，server_default 兼容存量）经 kernel 全链透传为 IR user_id；shenshi_client 扩展用户面方法（X-Hunjing-User-Id 代理，Echo 桩带内存实现）；/me/byok-keys 登记·列表·撤回与 /me/usage 端点（4 用例） - 前端神识阁（/models 重建）：偏好（生成参数表单）/自带密钥（登记加密保存、脱敏列表、撤回二次确认）/用量（聚合表+配额进度条）三区；me API 库+mock+5 用例；侧栏恢复入口 - 配置与部署：.env.example 增 SHENSHI_DATABASE_URL/SHENSHI_BYOK_MASTER_KEY/SHENSHI_USER_BUDGET_TOKENS；compose 神识容器接自有库（init-shenshi.sql 预建 hunjing_shenshi，与灵台不共库共表） - 证据：Go 34 用例（BYOK 独占/配额拒绝/结算退款/归属聚合）、后端 532、前端 210、BFF 4 全绿；跨进程 E2E 四场景（灵台 HttpShenshiClient→真 Go 神识：登记脱敏/BYOK 独占不可达整体失败/用量归属聚合/撤回即失效）通过；rewrite-plan M4 标记完成、能力矩阵神识行升已验证
57 lines
6.6 KiB
Markdown
57 lines
6.6 KiB
Markdown
# 魂镜能力矩阵
|
||
|
||
> 状态：rewrite/1.0 重写期基线
|
||
> 作用：记录"当前已经验证到哪里"，不重复产品目标或契约取值。没有证据链接的能力不得标为完成。重写的范围与节奏见[重写执行计划](rewrite-plan.md)。
|
||
|
||
## 1. 状态值
|
||
|
||
| 状态 | 判定 |
|
||
| --- | --- |
|
||
| 未评估 | 尚未完成代码、契约与运行证据盘点 |
|
||
| 未实现 | 目标已确认，但没有可运行闭环 |
|
||
| 局部实现 | 只有部分服务、API、页面或测试，尚非用户闭环 |
|
||
| 已验证 | 在指定部署档位与范围内通过契约、端到端和失败路径验证 |
|
||
| 待复核 | 证据过期、依赖变化或出现回归，不能继续沿用原结论 |
|
||
|
||
"已验证"必须同时写明部署档位、范围、版本和证据日期。
|
||
|
||
## 2. 当前架构基线（rewrite/1.0 目标态对照）
|
||
|
||
| 能力 | 里程碑 | 当前状态 | 说明与缺口 |
|
||
| --- | --- | --- | --- |
|
||
| 灵台 Kernel 与插件运行时 | M0 | 局部实现 | M0 骨架已验证（本地开发档，2026-08-21）：`backend/tests/test_kernel.py` 5 用例（事件序列/命台串行/否决/不变量/SSE），Kernel 经 DbEventStore 事件溯源；投影仍为占位，九枢插件与禁域裁决待 M2+/M5 |
|
||
| 镜生闭环（灵胚/启镜/魂籍/命台） | M1 | 局部实现 | M1 后端闭环已验证（本地开发档，2026-08-21）：`backend/tests/test_jingsheng.py` 7 用例——启镜前零人物行/零 activated 事件、并发启镜原子闸门单赢家（409 HJ-1103）、命台租约冲突被拒且 `seat.contested` 留痕、过期接管 epoch 递增、魂籍摘要+签名双校验（篡改与移植冒充均 422）、死亡冷静期撤销/落定（数据保留）；随缘候选生成与角色卡导入对接随 M2，前端人物页随 M2+ |
|
||
| 镜树对话（问节/候答/采用/归真/引文/移栽） | M2 | 局部实现 | M2a+M2b 后端完成（2026-08-21）：`test_mirror_tree.py` 8 用例钉死 PRD 场景 1/2/3/5/6/7/8；`test_import_and_assembly.py` 3 用例覆盖 ST V1/V2 卡→灵胚→启镜物化世谱、{{char}}/{{user}} 符文展开、火候（GenerationPreferences）进入 IR；旧 chat 模块/表/页面已删除（迁移 003，845 passed 仅余 7 个预存失败）；前端镜树页随 M2c |
|
||
| 三级记忆（微痕/明忆/重忆/实录/心痕） | M3 | 局部实现 | 后端闭环已验证（2026-08-22）：`test_xirang.py` 7 用例覆盖六条验收——归真触发提取、白名单（persona/instruction/episodic）自动生效、重忆 pending 确认、deny/删除墓碑全链路停用、正影版本链、双通道 RRF 召回注入；M3b 补齐：世谱激活注入投影（关键词+常驻+预算+符文展开）、前端 `/memories` 治理页（五分区/确认/正影/删除/实录溯源）；pgvector 语义通道随标准档 |
|
||
| 神识 Go 网关 | M4 | 已验证 | M4 收口（2026-08-27，本地开发档 + compose PG 档设计）：M4a 基础上补齐——ai_provider 删除手术完成（灵台 Provider SDK import 归零，rg 审计）；Anthropic/Gemini 适配器（SSE 解析 + system 提升 + 用量映射，httptest 往返用例）；BYOK（AES-GCM 加密落库、API 脱敏、独占路由不回落、撤回即失效、主密钥未配置 fail-closed）；配额三段式（预扣 max_tokens 钳位 1M → 结算实际 token → 全败幂等退款，HJ-2004）；usage 归属计量（IR user_id → usage_logs，/me/usage 按 用户×模型×端点 聚合，/admin/usage/sample 对账抽样）；神识自有库（PG 双实现 + 内存回退，启动 60s 就绪重试）；灵台 /me/byok-keys|/me/usage 代理 + 神识阁前端三区（偏好/BYOK/用量）。Go 34 用例全绿（含 BYOK 独占/配额拒绝/结算退款/归属聚合六场景）；跨进程 E2E 四场景（登记脱敏/独占失败/归属聚合/撤回）经灵台 HttpShenshiClient→真 Go 神识通过；后端 532、前端 210 passed。PG 生产档联调随标准档部署复核 |
|
||
| 百工与司命（授契/行契/请命/禁域/行动账） | M5 | 局部实现 | 乾坤沙箱（HMAC/进程隔离）已有工程与测试；能力注册与四维裁决待重写 |
|
||
| 缘契/人格演进/河图世界 | M6 | 未实现 | 旧 personality/drive/evolution/world 待退役 |
|
||
| 形仪与语音（真形/Live2D/TTS/ASR/通感） | M7 | 局部实现 | 天目 OCR、元炁本地推理可用；形仪域未建 |
|
||
| 天工阁/叩心/辰正 | M8 | 未实现 | 旧 agent/knocking/time_sense 待退役重实现 |
|
||
| 照壁 BFF | M0 | 局部实现 | M0 骨架已验证（2026-08-21）：头透传/SSE 直通/错误映射 4 用例；登录→占位 Run→SSE 三服务（照壁/灵台/神识）E2E 冒烟通过；响应裁剪与聚合待 M2+ |
|
||
| 镜匣桌面壳 | M9 | 未实现 | Tauri 最小壳待建 |
|
||
| 基础设施复用（auth/RBAC/审计/事件/幂等/SSE） | M0 | 局部实现 | auth/事件存储/SSE 已被 Kernel 复用；M2b 删除旧 chat/knocking/情绪/纪念日模型（迁移 003），time_sense 纯计算核保留待 M8 辰正重接；重组入 `infra/` 待后续里程碑 |
|
||
| 乾坤沙箱 | M5 | 局部实现 | 隔离执行/HMAC/超时取消已有；设备安全与双裁决待扩 |
|
||
| 博闻 MCP 搜索 | M5 | 局部实现 | 多引擎/密钥池/熔断/缓存可用；待登记入百工 |
|
||
| 天目 / 元炁 | M4/M7 | 局部实现 | 服务可用；元炁待接入神识 Endpoint，天目待接通感 |
|
||
| 镜树前端 / 记忆治理 / 百工页 | M2+ | 局部实现 | 镜树页与灵胚页已上线（M2c，2026-08-21）：路径阅读流/候答切换/采用归真/局部树图/SSE 芽体/导入卡；type-check + vitest 210 passed；记忆治理页随 M3、百工页随 M5 |
|
||
| 导入（角色卡 V2/V3 → 灵胚） | M2 | 局部实现 | M2b 已验证（2026-08-21）：POST /characters/import-card 产出可审阅灵胚（identity_baseline.import_card 暂存 character_book），启镜时物化世谱书+条目（dict/list 双形态兼容）；导出方向保持人物→ST V3 快照 |
|
||
|
||
## 3. 能力行模板
|
||
|
||
新增能力行至少包含：
|
||
|
||
| 字段 | 内容 |
|
||
| --- | --- |
|
||
| 能力与里程碑 | 用户可验证的纵向闭环及所属里程碑 |
|
||
| 目标契约 | 产品、领域、架构、协议和机器 Schema 链接 |
|
||
| 服务归属 | 生产者、消费者和权威状态所有者 |
|
||
| 当前状态 | 使用第 1 节状态值 |
|
||
| 适用范围 | 本地开发、轻量单机、标准服务器 |
|
||
| 证据 | 自动测试、契约测试、端到端、故障注入或人工验收 |
|
||
| 安全与数据 | 权限、删除、审计与禁域落点 |
|
||
| 已知限制 | 降级、规模与未覆盖风险 |
|
||
| 责任与复核 | 责任角色、版本、最近验证时间 |
|
||
|
||
能力状态由证据反推，不由文档篇幅、代码数量或主观确认决定。
|