dsh-brain/docs/management.md

2.1 KiB
Raw Blame History

统一管理卡与 MCP 管理

「连接与上报 / 技能管理 / MCP 管理」三页签的界面级说明;接口契约见 management-surface.md。


统一管理卡(0.7.0)

「设置 → 云端记忆」现在是三个页签:连接与上报 / 技能管理 / MCP 管理。

  • 身份验证卡内切换「账号登录 / 手动令牌」,切换不清凭据、不发请求。
  • 服务地址换 origin 时,旧令牌一律清除(credentialsCleared),要求重新认证。
  • 技能安装是两步:install/plan 把仓库克隆到隔离暂存目录并列出候选(含冲突、脚本、体积),install/commit 只写入选中的目录;.git 与符号链接不复制,仓库脚本不执行。
  • 卸载同样是两步:uninstall/plan 给出真实目录、文件数与不可恢复提示并签发一次性 token,remove 必须带 confirmed: true 与匹配 token。
  • 技能市场(P3):接入经验证来源 anthropics/skills 的 .claude-plugin/marketplace.json;搜索→详情→market/plan(固定提交)→勾选安装。客户端只传 provider/id,从不传 URL。
  • 更新/回退(P3):安装写 .skill-source.json;skills/update/check|apply 与 skills/rollback 更新前整目录备份,过期提交拒绝。
  • 同步冲突(P3):sync/status|run|resolve|resolve-all 提供两侧信息;面板支持逐项「保留本地 / 采用云端 / 手动合并」,也支持「全部保留本地 / 全部采用云端」批量处理(二次确认,逐项失败会汇总提示)。
  • MCP 管理(P4):读取宿主 dsh-mcp-connector 的同源公开接口 /mcp-connector/api;覆盖连接、健康检查、工具、启停、重连、两段式移除、目录市场连接、自定义 HTTP/stdio、JSON 导入、配置编辑、作用域与治理策略。

接口清单见 docs/management-surface.md;验收脚本见 verify-*.mjs(含 verify-market / verify-skill-update / verify-sync-resolve / verify-mcp-bridge / verify-upgrade / verify-concurrency / verify-theme)。

接口清单与能力边界见 management-surface.md。