deepseekplugins

DeepSeek Harness 插件

dsh-skill-manager-yanglaof

Skill lifecycle manager: list, view, edit, import, delete, enable/disable skills on disk（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
yanglaofish/dsh-skill-manager
最近更新
2026年8月21日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/yanglaofish/dsh-skill-manager
插件名：dsh-skill-manager-yanglaof
作者：yanglaofish

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-skill-manager

一个 DeepSeek Harness（DSH）插件：为 DSH 代理的技能提供完整的管理平面——统一查看、编辑、导入、管理，并按照「技能库 / 工作区 / 会话」三层模型精细控制每个技能在何时何地生效。技能库只存技能，启用跟着项目走：技能放进库中不会自动生效，只有某个工作区勾选启用后，该工作区（及其会话）才看得到它。

DSH 的「技能」是带 YAML frontmatter 的 Markdown 文件，是代理可复用的能力包。技能一多就会散落，难以统一管理。dsh-skill-manager 把这一切收拢成一个管理平面：

  • 技能库 — 列出/查看/编辑/导入/删除全部技能（目录形式：文件夹 + SKILL.md）。库只是可用技能池，不负责启用。
  • 工作区技能 — 每个项目独立维护自己的技能集合（跟随项目目录走），唯一的启用开关：勾选=该项目启用，未勾选=该项目完全不可见。
  • 会话技能 — 针对当前会话临时勾选，默认跟随工作区，可固定自选（库全集自由勾选，不限于工作区启用集）。
  • 跨层搜索 — 名称 / 描述 / 使用场景 / 正文全文匹配，带命中标注。
  • 统一界面 — 设置页双标签页 + 会话页技能面板，三处共用同一套行组件（整行点击切换、启用高亮、停用置灰+描边、预设只读、自动分页）。
  • 跨插件集成 — 宿主侧提供 skillManager 服务门面，其他 Cordis 插件 inject: ['skillManager'] 即可调用全部能力。

它不改变 DSH 的技能加载机制——它管理技能在磁盘上的组织方式，让 DSH 原生引擎读到的正是你想要的集合。

> v4.1 里程碑：会话层放开为库全集自由勾选（「回到跟随」一键恢复，隐式回跟随移除）；技能详情模态收束为单一文件浏览（Markdown 渲染预览、根目录节点、左右 15%/高度 30–80% 可拖）；工作区列表自动补齐会话存储（含未打开面板的工作区）、死路径读即清、面板显示插件版本角标。 > > v4.0 里程碑：彻底移除单文件兼容（统一目录形式）、安全加固（路径穿越/zip 炸弹/越权 cwd 全防线）、平台兼容（Windows / Linux / macOS 均可部署）、前端体积预检、宿主服务门面、错误边界测试（165 条）。

安装

dsh plugin --profile web add github:yanglaofish/dsh-skill-manager

安装完成后直接启动：

dsh web

使用

推荐：页面管理 —— 启动 dsh web 后，进入设置 → 技能管理：

实际使用同目录形式技能：全局技能标签页：「查看/编辑」打开详情模态（直接进入文件浏览，默认选中 SKILL.md 技能文档，可点「✏ 编辑」改内容、顶部 ftbar 保存/取消，保存上限 2MB）；「导入 skill」支持技能压缩包（≤50MB，解压 ≤100MB）或整个文件夹批量导入。

  • 工作区技能标签页：顶部下拉选择工作区（自动定位当前会话的工作区），下方列出该工作区启用的技能（未启用行灰描边）；preset 技能只读并标注所属预设。
  • 搜索框：输入关键词即跨全部层级全文检索（名称/描述/whenToUse/正文），结果标注命中字段与上下文片段。
  • 会话页「技能」tab：查看并临时调整当前会话启用的技能子集。

备选：对话管理 —— 直接对 agent 说：

  • 「列出我有哪些技能」
  • 「把 markdown-formatter 在工作区启用」
  • 「导入这个技能压缩包」
  • 「搜索包含 SQL 优化的技能」

agent 会调用 skill_manager_* 工具（共 13 个）完成操作。其他插件则可通过 inject: ['skillManager'] 直接调用宿主服务门面（list/get/edit/delete/importZip/workspaceToggle/sessionSet 等 17 个方法）。

卸载

dsh plugin --profile web remove dsh-skill-manager

技术方案

整体架构

插件由「宿主侧」（Node，随 DSH 主进程运行）与「客户端侧」（浏览器 bundle，随 Web UI 运行）两部分组成，通过 /skill-manager/api/* 自注册 HTTP 接口衔接。宿主侧为原生 ESM（无编译步骤），客户端侧为手写 react.createElement 的原生 JS bundle。

dsh-skill-manager
├── lib/
│   ├── index.js               宿主侧（原生 ESM，无需编译）
│   │   ├── 模块级函数         扫描/解析/CRUD/导入/搜索/工作区/会话/预设/
│   │   │                      安全门禁（isValidIdentifier/isAbsolutePath/
│   │   │                      samePath/assertRegisteredWorkspace）
│   │   └── apply()            装配 13 个 skill_manager_* 工具 + HTTP 路由
│   │                          + skillManager 宿主服务门面 + sessions/
│   │                          agentPresets 注入解析
│   └── client.js              客户端 bundle（__ModuleLoader__ 包装）
│       ├── SkillManagerPanel    设置页：统计条 + 双 tab + 搜索 + 分页 + 详情模态
│       ├── WorkspaceSkillsPanel 工作区/会话技能面板
│       ├── SkillDetailModal      详情模态：文件浏览（默认 SKILL.md）+ 编辑
│       └── SkillRow             三处共用的统一技能行组件
├── cordis.patch.yml          bundle patch：挂载宿主侧插件行
├── test/
│   ├── unit.mjs              165 条隔离单测（临时 DSH_HOME，含错误边界）
│   └── seed-sample.mjs       示例技能写入工具（开发验证用）
├── README.md / README-en.md
└── package.json              bundle 清单：exports + dsh.client 声明（v4.1.0）

核心设计原则：技能的状态只有单一事实源 —— 磁盘上的目录结构。技能存放在技能库（~/.dsh/skill-manager/library/，引擎不扫描），工作区启用是 <cwd>/.dsh/skills 里的白名单（引擎唯一可见源），会话勾选在独立 JSON；所有界面与工具都读取同一份磁盘事实，不存在内存态与磁盘态的分叉。

三层模型

┌─ 会话层  (Session)     ~/.dsh/skill-manager/sessions/<sessionId>.json
│    默认跟随工作区；可用库中任意技能固定自选
├─ 工作区层 (Workspace)  <cwd>/.dsh/skills/   ← 引擎唯一扫描的工作区根
│    symlink/copy → 技能库文件；存在 == 该工作区启用
└─ 技能库   (Library)    ~/.dsh/skill-manager/library/  ← 纯技能池，引擎不扫
                         所有用户技能平铺于此；不做启用/停用

关键语义：技能库不是「全局启用」——库中的技能对任何工作区都不可见，直到某个工作区把它勾选进 <cwd>/.dsh/skills（白名单）。这避免了旧模型「全局启用了但项目不想开」的冲突：启用与否完全由每个项目自己决定。dsh 引擎只扫描工作区的 .dsh/skills（project-dsh 根）与 preset，技能库位于 ~/.dsh/skill-manager/ 下不被引擎发现，天然实现白名单。

关键模块

模块职责
parseSkillDoc / serializeSkillDoc技能文档解析/序列化：YAML frontmatter + 正文，剥离 UTF-8 BOM
scanDir / findSkill / searchSkills目录扫描、按名定位、跨层全文搜索（命中字段 + 片段）
importSkillDocs / importSkillZipFromBuffer文件夹批量导入 / zip 包导入，逐项校验、部分失败不中断
linkGlobalSkillToWorkspace / unlink…工作区启用/停用：目录级 symlink 优先，失败降级整目录复制（fs.cp）
readSessionConfig / setSessionSkills会话勾选读写：显式子集（库全集自由勾选）与跟随工作区
scanPresetSkills经 agent-presets 服务读取 preset 内物理捆绑的技能
normalizeParameters / registerTool工具参数规范化为标准 JSON Schema（等价 defineTool）
isValidIdentifier / isAbsolutePath / samePath / assertRegisteredWorkspace安全门禁：标识符白名单、平台无关绝对路径、大小写不敏感路径比较、写操作仅限已登记工作区
SkillManagerPanel / WorkspaceSkillsPanel / SkillDetailModal / SkillRow设置页与会话页 UI、统一行组件、详情模态、分页与排序

数据流

查看列表（/list）

scanDir(skillsRoot()) + scanPresetSkills() + listWorkspaces() 并行收集，合并为「技能库 → preset」的技能数组，连同统计条（技能库总数/preset 数/登记工作区数）一次返回。

工作区解析（/view）

Client 从会话 store 取当前 sessionId → /view?sessionId= → 宿主经 ctx.sessions.get(id).header.cwd 解析工作区（免手填路径），并自动登记该工作区；同一响应带回工作区列表供下拉选择，消除「暂无工作区」竞态。

工作区启用（/workspace/toggle）

目录形式技能整目录启用：优先 symlink(sourceDir, targetDir, 'dir') 创建目录符号链接（单副本、编辑即时同步；Windows 未开启开发者模式时自动降级）；降级用 fs.cp 整目录复制（跨盘可用）。重启用先清理旧目录再重建，幂等。写操作（toggle/文件写入/会话设置）仅允许已登记工作区，杜绝越权修改任意磁盘路径。

会话设置（/session/set）

Client 勾选技能即固定显式子集（explicit=true）：宿主允许库中任意技能入选（工作区启用集只定义「跟随」默认值，不限制显式自选）；点「回到跟随」恢复 explicit=false、清空子集，会话回到工作区启用集。

搜索（/search?q=）

跨全局（启用+禁用）/ preset / 所有已登记工作区收集，大小写不敏感子串匹配名称/描述/whenToUse/正文；同名去重按「工作区 > 全局 > preset」优先级，返回命中字段 why 与正文片段 snippet。

关键设计细节

  • Windows 跨盘：~/.dsh 在 C 盘、工作区在 D 盘时硬链接必然失败（EXDEV）。symlink 需要开发者模式/管理员权限，故设计为优先目录 symlink、自动降级整目录复制，两种传输方式对外行为一致。
  • 跨平台部署（v4.0）：绝对路径判断用 node:path.isAbsolute（Windows 正/反斜杠、POSIX /、UNC 均正确）；路径相等比较 samePath 在 Windows 大小写不敏感；客户端路径分隔符归一化。Windows / Linux / macOS 均可运行。
  • 安全门禁（v4.0）：技能名/sessionId 白名单（isValidIdentifier）杜绝路径穿越；写操作 cwd 必须是已登记工作区（assertRegisteredWorkspace）；HTTP body 2MB、zip 上传 50MB / 条目 1000 / 解压 100MB 上限；错误文案全部中文化，前端上传/保存前即有体积预检。
  • UTF-8 BOM：Windows 编辑器常给文件加 BOM，破坏严格的 ^--- frontmatter 分隔符导致整段解析失败——parseSkillDoc 开头剥离。
  • 工具 schema：裸 parameters 映射（{key: spec}）在模型投影时被当作 JSON Schema 读取，type 为 null 直接报错。registerTool 统一规范化为 {type:'object', properties, required}（与 defineTool 输出等价），13 个工具全部通过校验。
  • 宿主服务门面（v4.0）：ctx.provide('skillManager', …) 暴露 17 个方法的编程接口，其他插件 inject: ['skillManager'] 即用，无需走 HTTP 或模型工具。
  • 复用 dsh 渲染器：Markdown 预览 require 种子模块 @deepseek-ai/dsh-client-ui-primitives 取用官方 MarkdownText（KaTeX 数学 + 代码高亮 + 表格），不内置任何 markdown 库。
  • preset 根解析：bundle 以 junction 方式安装时，import.meta.dirname 指向工作区，基于模块相对路径的 preset 发现会失效——改从 agent-presets 服务的 resolvedRoots 读取权威根。
  • 无构建步骤：宿主侧与客户端侧都是纯 JS，客户端 bundle 手写 react.createElement，不依赖 JSX/TS/打包器，安装即用。

开发

# 语法检查
node --check lib/index.js lib/client.js

# 运行 165 条隔离单测（临时 DSH_HOME，不污染真实环境）
node test/unit.mjs
  • 所有文件操作均为模块级函数，无需真实运行环境即可单测；apply() 只在装配阶段工作。
  • GitHub 安装模式下：改代码需 git push 后执行 pnpm update dsh-skill-manager 再重启 dsh web 生效。
  • 本地开发模式（改代码重启即生效）：dsh plugin --profile web add . 或手动 link 依赖。

许可

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类