yxsj245 / dsh-Basics-Panel

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.

功能

• 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.section
• src/client/feature-registry.tsx — 客户端 feature 注册表（扩展点）
• docs/ — 使用文档与设计文档

安全

• 所有路由过浏览器信任围栏（loopback / webRuntime.trustedHosts）
• 敏感值只脱敏展示、绝不回传明文
• 写文件严格白名单：MCP 仅可改写扫描发现且非 system 的组合文件；技能仅可改写注册表返回且非内置/运行时的文件；规则仅可读写 DSH 规则发现机制认可的路径（全局 AGENTS.md 与项目链候选文件）
• 所有写操作原子写（临时文件 + rename）+ mtime 冲突拒绝

License

MIT