yxsj245/dsh-Basics-Panel

Plugin插件 Native原生 ⭐ 3 MIT Prompts & Skills提示词与技能

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

Project Overview项目介绍

This is a native DSH web plugin that adds a dedicated settings panel to DSH for visualizing and managing MCP servers, skills, and rules. It is built on a modular feature registry architecture, so new visualization features can be added by simply creating a new feature directory and adding one entry to the registry, with no changes required to the core panel shell. Version 0.2.0 and up support DSH 0.1.2-rc.1 and newer, and it can be installed via the official DSH plugin CLI command or manually mounted to a DSH web profile. First-time installation requires a full restart of DSH to build the client bundle before the panel appears.

This plugin is built for all DSH users who prefer a graphical interface to manage their core DSH configurations instead of manually editing raw text config files. Users can view all configured MCP servers grouped by scope, see masked versions of sensitive configuration data like API keys and URLs, check current runtime status, and toggle each server on or off directly from the panel. They can also view all skills grouped by scope, search and filter skills by keyword, edit skill metadata and core content, and manage all global and project-level rules with full create and edit access.

This plugin is released under the open-source MIT license, and it enforces strict security measures for all file read and write operations. Only files on a pre-approved whitelist can be modified by the plugin, sensitive values are only displayed in masked form and are never sent back to the client as plaintext, and all write operations use atomic writes via temporary files to prevent data corruption. For development, the plugin uses pnpm as the package manager, requires TypeScript for type checking, Vitest for running unit tests, and tsdown to build the final distribution bundle.

这是一个专门为DSH(DeepSeek Harness)开发的原生网页插件,核心功能是为DSH提供可视化管理MCP服务器、技能与规则的设置面板。插件采用模块化的功能注册表架构,后续新增可视化功能只需要新增对应功能目录并在注册表添加一行即可,无需修改面板核心骨架。从0.2.0版本开始,该插件适配DSH 0.1.2-rc.1及以上版本,适配了上游依赖变更,不再依赖已移除的@deepseek-ai/dsh-client-runtime包。

它面向所有DSH用户,帮助用户更直观地管理配置各类核心DSH资源。典型使用流程中,用户可以在面板中按作用域分组查看所有MCP服务器,看到脱敏后的配置和当前运行状态,还能直接逐台开启或禁用MCP服务器;也可以分组查看、搜索过滤技能,编辑技能的各类元数据与内容,还支持查看、新建和编辑全局与项目级的规则文件。

插件遵循MIT开源许可协议,可通过官方命令dsh plugin --profile web add安装,也可以手动将包放入profile解析范围并修改配置文件挂载。首次安装后需要重启DSH完成客户端构建,后续配置改动可通过热重载或刷新页面生效。插件对写操作做了严格安全限制,仅允许操作白名单内的文件,敏感信息仅脱敏展示不会回传明文。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

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, rules and archived sessions, built on a modular feature registry so future visualizations slot in without touching the shell.

兼容性:支持 DSH 0.1.2-rc.1 ~ 0.2.x(peer 按 minor 线开窗,见下方 0.2.0 适配段落)。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),本插件不再声明对该包的注入依赖,构建外部模块清单同步收敛。

归档会话兼容性:恢复优先使用上游公开的 unarchiveSession(0.1.7-rc.1 已提供,运行中的 0.1.5-rc.3 尚无);在这类尚未提供该 API 的版本上,改用注册表自身的写入通道(操作队列 + setState,保证磁盘、进程内快照与工作区域变更三者一致);两者都不可用时面板置灰并明确提示,不会只改磁盘。

DSH 0.1.7 适配(0.4.0):客户端会话列表快照不再有 current 字段,面板改为按 retainedBy.mainView 找主视图会话(技能作用域靠它),并在宿主侧以最近的活动 Agent 兜底、在页面提示实际使用的会话;预设改为读取 @deepseek-ai/dsh-agent-preset 声明行的 config.plugins(bundle 内声明的只读),不再读取已废弃的 ~/.dsh/.agent-presets/ 目录,也不再显示没有 MCP 行的空预设卡片;开关后会轮询热重载结果,避免把「正在连接」误报成「未生效」。

DSH 0.2.0 适配(0.4.1):DSH 启动的兼容性预检(@deepseek-ai/dsh-app-boot 的 evaluatePluginCompatibility)会把本插件 package.json 里每一条以 @deepseek-ai/dsh 开头的 peer 按 semver.satisfies(宿主版本, 范围, { includePrerelease: true }) 判定,任一条不满足就让整条插件被启动预检拒绝(表现为设置里没有「基础能力」页签)。0.4.0 声明的 @deepseek-ai/dsh-home-paths@^0.1.2-rc.1 上界是 <0.1.3,虽然覆盖 0.1.x 全线(includePrerelease: true 下预发布版照常参与比较),但覆盖不到 0.2.0,对宿主 0.2.0-rc.2 判定为 false,插件因此被禁用;0.4.1 改为按 minor 线逐条列出的 ^0.1.2-rc.1 || >=0.2.0-rc.1 <0.3.0,同时覆盖 0.1.x 与 0.2.x 两条线。四条 @deepseek-ai/dsh-* devDependencies 同步升到 0.2.0-rc.2,让 pnpm typecheck 按宿主的实际类型核对(本插件只从宿主取 resolveDshHome / dshHomeDisplay 两个稳定函数,实际类型无漂移)。

功能

  • MCP 服务器:按作用域(用户 profile / 预设 preset)分组列出所有 MCP 服务器,展示脱敏后的配置(env / 请求头 / 密码参数 / URL 密码均打码),显示运行时状态(已连接 · N 工具 / 已启用 / 已禁用 / 未生效;预设行按预设组合清单显示,不误报「未生效」),并支持逐台开关(写入配置文件的 disabled 字段,profile 热重载、preset 新会话生效;开关后轮询到状态稳定)。
  • 技能:按作用域(项目级 / 自定义 / 用户级 / 内置 / 运行时)分组展示全部技能,支持搜索与过滤;可编辑技能的 description / whenToUse / metadata / 调用权限与正文,保存后经 filesystem watcher 热刷新生效。技能按会话预设作用域提供,面板会自动解析当前会话(并在兜底时明确提示用的是哪个会话)。
  • 规则:展示全局规则(~/.dsh/AGENTS.md)与项目链规则(项目根至当前目录的 AGENTS.md / CLAUDE.md / .local 覆盖),支持新建(全局 / 项目根 / 当前目录)与整文件编辑,保存后新会话生效。
  • 归档会话:列出所有已归档的会话(标题、工作目录、创建时间、日志大小、事件条数,并标出运行中 / 已装载 / 文件缺失),支持恢复(从归档集合移出,立即回到侧边栏原位置)与删除(永久移除会话日志目录、工作区记账与归档记录),删除提供单行、批量选中与全选删除全部(超过批量上限自动分批),全部走二次确认。只有 Agent 状态为 running 的会话不可删除;「已装载但空闲」的会话可删,确认条会点名提示。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-session-progress 下一个 Next dsh-side-chat →