dsh-basics-panel
DSH Web 插件「基础能力面板」：在 DSH 设置中可视化并管理 MCP 服务器、技能 与 规则。采用模块化 feature 注册表，后续的 DSH 可视化功能只需新增一个 feature 目录并在注册表加一行即可，无需改动面板骨架。
A DSH web plugin: a native Settings panel for visualizing and managing MCP servers, skills and rules, built on a modular feature registry so future visualizations slot in without touching the shell.
兼容性：0.2.0 起适配 DSH 0.1.2-rc.1。上游已移除 @deepseek-ai/dsh-client-runtime，其 slots / sessions / locale 客户端服务改由标准 web 组合提供（ui-renderer / api-session-controller / client-locale），本插件不再声明对该包的注入依赖，构建外部模块清单同步收敛。
功能
- MCP 服务器：按作用域（用户 profile / 预设 preset）分组列出所有 MCP 服务器，展示脱敏后的配置（env / 请求头 / 密码参数 / URL 密码均打码），显示运行时状态（已连接 · N 工具 / 已启用 / 已禁用 / 未生效），并支持逐台开关（写入配置文件的
disabled 字段，profile 热重载、preset 新会话生效）。
- 技能：按作用域（项目级 / 自定义 / 用户级 / 内置 / 运行时）分组展示全部技能，支持搜索与过滤；可编辑技能的 description / whenToUse / metadata / 调用权限与正文，保存后经 filesystem watcher 热刷新生效。
- 规则：展示全局规则（
~/.dsh/AGENTS.md）与项目链规则（项目根至当前目录的 AGENTS.md / CLAUDE.md / .local 覆盖），支持新建（全局 / 项目根 / 当前目录）与整文件编辑，保存后新会话生效。
作用域说明
| 能力 | 全局 | 项目级 | 用户级 | 预设级 | 内置 |
|---|
| 技能 | — | <项目>/.dsh/skills、<项目>/.agents/skills | ~/.dsh/skills、~/.agents/skills | — | 随发行版内置 |
| MCP | — | DSH 暂无项目级组合文件 | ~/.dsh/cordis.patch.yml、~/.dsh/profiles/*/cordis.patch.yml | ~/.dsh/.agent-presets/*/agent.cordis.yml | — |
| 规则 | ~/.dsh/AGENTS.md | 项目根至 cwd 链上的 AGENTS.md / CLAUDE.md / .local | — | — | — |
同名技能按注册表优先级显示生效版本（项目级 > 自定义 > 用户级 > 内置）。
安装
开发完成后，用官方通道安装（或手动挂载）：
dsh plugin --profile web add dsh-basics-panel@<version>
手动挂载：将本包放入 profile 解析范围，并在 ~/.dsh/profiles/web/cordis.patch.yml 写入：
- insert:
- id: basics-panel
name: 'dsh-basics-panel'
首次安装需重启 DSH（客户端 bundle 启动图在启动时构建）；之后 Host 侧改动经 patch 热重载、客户端改动重建后刷新页面即可。
开发
pnpm install
pnpm typecheck # tsc --noEmit
pnpm test # vitest
pnpm build # tsc 声明 + tsdown（lib/index.js + lib/client.js + lib/client-registry.js）
目录结构
src/index.ts — Host 半边：fenced /basics/api 路由 + feature 合并src/features/<id>/ — Host 侧 feature 后端（MCP / skills / rules）src/client/index.tsx — 客户端半边：注册 settings.sectionsrc/client/feature-registry.tsx — 客户端 feature 注册表（扩展点）docs/ — 使用文档与设计文档
安全
- 所有路由过浏览器信任围栏（loopback /
webRuntime.trustedHosts）
- 敏感值只脱敏展示、绝不回传明文
- 写文件严格白名单：MCP 仅可改写扫描发现且非 system 的组合文件；技能仅可改写注册表返回且非内置/运行时的文件；规则仅可读写 DSH 规则发现机制认可的路径（全局
AGENTS.md 与项目链候选文件）
- 所有写操作原子写（临时文件 + rename）+ mtime 冲突拒绝
License
MIT
