yxsj245/dsh-Basics-Panel

Name: yxsj245/dsh-Basics-Panel
Author: yxsj245

插件Plugin 原生Native ⭐ 4 MIT cat_label.typescriptcat_label.typescript

DSH Web 插件「基础能力面板」：在 DSH 设置中可视化并管理 MCP 服务器、技能与规则。采用模块化 feature 注册表，后续的 DSH 可视化功能只需新增一个 feature 目录并在注册表加一行即可，无需改动面板骨架。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

DSH Web 插件「基础能力面板」，在 DSH 设置内可视化并管理 MCP 服务器、技能与规则。模块化 feature 注册表使新增可视化面板只需新增一个 feature 目录并在注册表登记一行，无需改动骨架。适用于需要集中查看与编辑这三类基础能力的场景。需注意：MCP 服务器只显示脱敏配置，敏感字段以打码形式展示；首次安装需重启 DSH 客户端使 bundle 启动图生效。

A DSH web plugin that adds a native Settings panel for visualizing and managing MCP servers, skills, and rules. A modular feature registry lets new visualization panels slot in by adding a single feature directory and one registry entry, without altering the shell. Use it when you need a single place to inspect and edit these core capabilities. Caveat: MCP server values are shown redacted, and a DSH client restart is required after first install so the bundle startup graph is rebuilt.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-Basics-Panel】【https://github.com/yxsj245/dsh-Basics-Panel】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:yxsj245/dsh-Basics-Panel

把 yxsj245/dsh-Basics-Panel 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.6 KB · 缓存于 2026-08-25 04:53:53 · 3.6 KB

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

渲染基于仓库 yxsj245/dsh-Basics-Panel 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install