Files
hunjing/docs/operations/capability-matrix.md
T
chenxin 144415247e M4 收口:神识用户面与计量闭环——BYOK/配额三段式/usage 落库/Anthropic+Gemini 适配器/神识阁
- 神识 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 标记完成、能力矩阵神识行升已验证
2026-08-27 18:39:17 +08:00

6.6 KiB
Raw Blame History

魂镜能力矩阵

状态:rewrite/1.0 重写期基线 作用:记录"当前已经验证到哪里",不重复产品目标或契约取值。没有证据链接的能力不得标为完成。重写的范围与节奏见重写执行计划。

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
百工与司命(授契/行契/请命/禁域/行动账) 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 节状态值
适用范围 本地开发、轻量单机、标准服务器
证据 自动测试、契约测试、端到端、故障注入或人工验收
安全与数据 权限、删除、审计与禁域落点
已知限制 降级、规模与未覆盖风险
责任与复核 责任角色、版本、最近验证时间

能力状态由证据反推,不由文档篇幅、代码数量或主观确认决定。