前言¶
DeepSeek Harness (DSH) 采用插件化架构，核心配置（MCP 服务器、技能、规则等）通常通过文件或命令行管理。对于需要频繁调整配置或管理会话的用户，这种方式不够直观。DSH Web 插件「基础能力面板」提供了一套可视化的设置界面，允许在浏览器中直接管理 MCP 服务器、技能、规则与归档会话。
该插件由开发者 yxsj245 维护，采用模块化 feature 注册表设计，后续的可视化功能只需新增 feature 目录即可接入，无需改动面板骨架。
核心功能¶
MCP 服务器¶
面板按作用域（用户 profile / 预设 preset）分组展示所有 MCP 服务器。配置信息经过脱敏处理（环境变量、请求头、密码参数、URL 密码均打码），仅展示运行时状态（已连接、工具数量、启用/禁用状态）。支持逐台开关，写入配置文件后 profile 热重载，预设配置在新会话中生效。
技能¶
技能按作用域分组展示（项目级、自定义、用户级、内置、运行时），支持搜索与过滤。可编辑技能的描述、触发条件、元数据及调用权限，保存后通过 filesystem watcher 热刷新生效。同名技能按注册表优先级显示生效版本（项目级 > 自定义 > 用户级 > 内置）。
规则¶
展示全局规则（~/.dsh/AGENTS.md）与项目级规则（项目根至当前目录链上的 AGENTS.md / CLAUDE.md / .local）。支持新建与整文件编辑，保存后对后续新会话生效。
归档会话¶
列出所有已归档会话，显示标题、工作目录、创建时间、日志大小及事件条数。状态标记包括运行中、已装载、文件缺失。支持从归档集合恢复会话，以及删除会话（提供单行、批量选中与全选功能，均需二次确认）。删除时，只有 Agent 状态为 running 的会话不可删除，确认条会提示“已装载但空闲”的风险。
安装与启用¶
通过官方插件通道安装：
dsh plugin --profile web add dsh-basics-panel@<version>
安装完成后，在 DSH 的 Web 设置中即可看到「基础能力面板」入口。
开发与同步¶
本仓库当前使用 file: 本地依赖挂载到 web profile。pnpm build 仅更新本地仓库代码，不会更新 DSH 实际运行的代码。开发完成后，必须执行同步命令将构建产物复制到 DSH 的 profile 安装副本。
pnpm build
pnpm run sync
同步后需要重启 DSH 进程，并在浏览器中硬刷新（Ctrl+F5）以加载新的客户端代码。配置文件（如 cordis.patch.yml / LICENSE）因硬链接机制，无需同步即可生效。
安全与约束¶
- 数据安全：敏感值只脱敏展示，绝不回传明文；所有写操作使用严格白名单与原子写（临时文件 + rename）机制。
- 会话保护：归档会话的恢复/删除仅接受归档集合内的 ID，且运行中的会话不可删除。
- 服务解析：可选服务（如
workspaceRegistry）必须在调用时刻解析，不能在apply()阶段缓存，否则会拿到undefined并导致功能失效。
适用场景¶
适合需要通过图形界面管理 DSH 配置、频繁调试技能与规则、或处理归档会话的用户。使用前请确认源码与许可证，插件以当前 DSH 进程的权限运行。
结尾¶
该插件为 DSH 生态提供了一个标准化的可视化配置入口，简化了 MCP 服务器与技能的管理流程。更多细节与源码，可访问插件目录或 GitHub 仓库。
