dsh-superpower-vision
DSH(DeepSeek-harness)Desktop 插件:超能力全景可视化面板。
把四类运行时状态画进 DSH 设置页:
| 页签 | 内容 |
|---|
| 技能库 | 宿主注册表技能(provider/source/rank/可调用性)+ 磁盘 skills 漂移对照 |
| 插件注册表 | desired.json 指针、generation 目录、profile patch 行 |
| 记忆复用库 | kb-mcp(AnyThingKB)知识库列表(本机实测四库) |
| 进化记忆 | spool 待写/总数、自动归档开关、「立即归档」按钮 |
| Agent Toolkit | profile patch 里的 MCP server 行与健康状态、新 toolkit 接入说明 |
另有两个入口:插件管理页卡片(五数字总览)+ shell.overlay 速览浮窗。
数据层:三个预留适配接口
对应需求「预留前置准备记忆复用库数据库读取接口、结束的进化记忆接口、适配以后的 agent toolkit」:
lib/adapters/
├── registry.js # 槽位注册表:prep-memory-read / evolution-memory / agent-toolkit
├── types.js # ReadAdapter / WriteAdapter / ToolkitAdapter 契约(JSDoc)
├── null.js # Null 默认:未接入时降级,绝不抛异常
├── stdio-jsonrpc.js # 换行分隔 JSON-RPC 2.0 stdio 客户端(initialize 握手/超时/自毁)
├── prep-memory.js # 记忆读取:StdioMcp(kb-mcp 实测打通)+ Http 预留位
├── evolution.js # 进化写入:spool + Mcp(auto_ingest_text,PENDING 契约)+ session 钩子
└── toolkit.js # Toolkit:MCP 行 → 描述符;invoke/tools 为预留位
接入新 toolkit:在 profile patch 增加一行 @deepseek-ai/dsh-mcp-client(自动出现在 Toolkit 页);如需更丰富行为,往 lib/adapters/ 丢一个 adapter 文件并向 registry 注册,重装插件。
安装 / 验证 / 回滚
node scripts/install-local.mjs # generation 通道安装(需先重启 DSH Desktop 生效)
node scripts/verify.mjs # 静态验证(manifest/patch/locale/测试/generation)
node scripts/verify.mjs --live # 附真实浏览器走查清单
node scripts/evolve-memory.mjs # 进化记忆补写(spool → kb-mcp)
node scripts/uninstall-local.mjs # 回滚(从 desired.json 摘除 + 重投影)
改完代码必须 bump package.json 的 version 再安装(generation id 含 content hash,同名同版会被拒绝,--force 除外)。
开发
node --test --test-force-exit tests/*.test.mjs # 45 项测试(含真机 kb-mcp 端到端)
测试里 --test-force-exit 是必需的:kb-mcp stdio 子进程句柄会挂住测试进程事件循环(宿主侧由 ctx.effect 生命周期关闭,测试侧强制退)。
真机验证状态(2026-10-30)
- generation
dsh-superpower-vision+0.1.0+5b4986a86823 已装入 desktop profile web 并被 desired 指向
- 依赖闭包校验通过(host 单件经 bundled DSH entry 解析)
- 真机 kb-mcp stdio 读取通过(四库列表);auto_ingest 落库通过
- 待 operator 执行:重启 DSH Desktop → 设置导航「超能力全景」→ 六页签(含「破甲人格」)/卡片/浮窗走查 → console 零 error
许可
MIT