@michengai/dsh-skills-manager 1.2.30 → 1.2.32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -0
- package/CHANGELOG.zh-CN.md +24 -0
- package/README.en.md +231 -0
- package/README.md +133 -128
- package/README.zh-CN.md +9 -4
- package/lib/client.js +11 -8
- package/lib/index.js +48 -83
- package/lib/plugin-updater.js +14 -96
- package/lib/provenance.js +189 -0
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -1,70 +1,69 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="assets/branding/dsh-banner-
|
|
2
|
+
<img src="assets/branding/dsh-banner-zh-CN.webp" alt="DSH Skills Manager" width="100%">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<div align="center">
|
|
6
6
|
|
|
7
7
|
# DSH Skills Manager
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**统一管理本机与项目技能，从 GitHub 安装、预览更新并备份回退**
|
|
10
10
|
|
|
11
|
-
[
|
|
11
|
+
[English](README.en.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
|
|
12
12
|
|
|
13
|
-
[](LICENSE)
|
|
14
14
|
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
15
|
-
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
16
16
|
[](https://github.com/MichengAI/dsh-skills-manager)
|
|
17
|
-
[](#安装)
|
|
18
18
|
</div>
|
|
19
19
|
|
|
20
|
-
> DSH Skills Manager
|
|
20
|
+
> DSH Skills Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
## 功能概览
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
把散落在本机和项目中的技能集中到 DSH，无需在多个 Agent 目录间来回查找。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
- **多视图集中管理**：提供「全局技能」、「项目技能」、「发现」与「回收站」四大工作区视图，支持搜索、状态筛选与来源折叠。
|
|
27
|
+
- **按来源仓库浏览**：可切换目录或仓库视图，依据安装记录、锁文件和技能元数据识别来源；没有可靠来源的技能显示为「来源未知」。
|
|
28
|
+
- **广泛的生态兼容**：覆盖 DSH、公共 Agent、Codex、Claude Code、Copilot、Cursor、Google Antigravity、Windsurf、Qoder、Trae 等 20+ 工具与 CLI 环境，统一管理且不侵入第三方文件。
|
|
29
|
+
- **分类整理与拖拽归类**：支持在各来源内创建分类文件夹、拖拽技能卡片归类排序、批量添加技能，并支持分类级一键启停。分类元数据独立保存，不改动物理文件。
|
|
30
|
+
- **公共市场与仓库订阅**：内置「发现」中心，一站式浏览 ClawHub 热门榜单与 skills.sh 技能市场，支持公开 GitHub 仓库订阅、增量更新检测与版本备份回退。
|
|
31
|
+
- **创建与自由导入**：新建技能，或导入 ZIP、文件夹与 `SKILL.md`，可精准写入用户全局目录或指定工作区项目目录。
|
|
32
|
+
- **宽屏阅读与正文复制**：760px 宽屏自适应详情弹窗，等宽字体代码高亮排版，支持垂直自由拉伸与一键复制 Markdown 正文。
|
|
33
|
+
- **回收站与防误删保障**：DSH 技能删除后优先移入回收站，支持完整保留安装身份与更新历史的安全恢复。
|
|
34
|
+
- **自定义来源目录**：外部 Agent 来源可以在面板里改读取位置，不移动任何文件；DSH 与公共 Agent 仍由宿主配置。
|
|
27
35
|
|
|
28
|
-
|
|
29
|
-
- **Broad ecosystem support**: Full coverage for 20+ tools and CLI environments including DSH, Shared Agent, Codex, Claude Code, Copilot, Cursor, Google Antigravity, Windsurf, Qoder, and Trae without touching third-party files.
|
|
30
|
-
- **Categorization and drag & drop**: Create category folders inside sources, drag skill rows (`⋮⋮`) to organize and order them, batch assign skills, and toggle entire categories with a single switch. Category metadata is saved without moving files.
|
|
31
|
-
- **Public markets & repositories**: Integrated Discover hub to explore trending skills from ClawHub and skills.sh, or subscribe to public GitHub repositories with incremental diff inspection and backups.
|
|
32
|
-
- **Create and flexible import**: Create skills or import ZIP archives, folders, and `SKILL.md` files directly into your global user root or a registered workspace.
|
|
33
|
-
- **Wide reading experience**: 760px responsive detail modal with monospace syntax styling, vertical resizing, and a one-click "Copy body" action.
|
|
34
|
-
- **Trash & safe rollback**: Soft delete protects skills from accidental loss, allowing complete restoration with provenance and update history preserved.
|
|
35
|
-
- **Custom source folders**: Point an external agent source at another folder from the panel without moving any file. DSH and Shared Agent stay configured by the host.
|
|
36
|
+
## 界面预览
|
|
36
37
|
|
|
37
|
-
|
|
38
|
+
全局技能：
|
|
38
39
|
|
|
39
|
-
|
|
40
|
+
|
|
40
41
|
|
|
41
|
-
|
|
42
|
+
项目技能：
|
|
42
43
|
|
|
43
|
-
|
|
44
|
+
|
|
44
45
|
|
|
45
|
-
|
|
46
|
+
技能仓库与发现：
|
|
46
47
|
|
|
47
|
-
|
|
48
|
+
|
|
48
49
|
|
|
49
|
-
|
|
50
|
+
*截图展示核心功能面板，包含全局技能、项目技能与技能发现仓库。采用无损 WebP 格式。*
|
|
50
51
|
|
|
51
|
-
|
|
52
|
+
## 安装
|
|
52
53
|
|
|
53
|
-
|
|
54
|
+
需要已安装并能正常运行 DeepSeek Harness。以下命令使用 `web` profile，请按实际环境替换。
|
|
54
55
|
|
|
55
|
-
|
|
56
|
+
插件安装支持 npm registry、本地构建的 `.tgz` 包和 GitHub。GitHub 与 npm 都包含可直接运行的 `lib`。改动源码后，提交前请先运行构建。
|
|
56
57
|
|
|
57
|
-
|
|
58
|
+
### 让 Agent 帮你安装
|
|
58
59
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
Send this to an agent that can use your local terminal:
|
|
60
|
+
把这段话发给能够操作本机终端的 Agent：
|
|
62
61
|
|
|
63
62
|
```text
|
|
64
|
-
|
|
63
|
+
请把 @michengai/dsh-skills-manager 最新版安装到我的 DSH web profile，使用官方 npm 源，安装后确认生效并告诉我如何重新加载。
|
|
65
64
|
```
|
|
66
65
|
|
|
67
|
-
###
|
|
66
|
+
### 手动安装
|
|
68
67
|
|
|
69
68
|
```powershell
|
|
70
69
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
@@ -72,99 +71,105 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
|
|
|
72
71
|
dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=https://registry.npmjs.org/
|
|
73
72
|
```
|
|
74
73
|
|
|
75
|
-
|
|
74
|
+
安装后重启 DSH 并刷新页面，打开「设置 → 技能」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
|
|
76
75
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
76
|
+
- `1.2.32` 已验证兼容 DeepSeek Harness `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-rc.1`。
|
|
77
|
+
- 宿主支持范围：DeepSeek Harness `0.2.x` 全系列（`>=0.2.0-rc.1 <0.3.0-0`），自动支持后续全部 0.2.x RC 版本，同代宿主升级无需重复等待发版。早期版本与 `0.3.0` 代际破坏性更新由版本门拦截。仍在使用 `0.1.x` 的，请安装插件 `1.1.23`，不要装 `@latest`。
|
|
78
|
+
- **反向代理部署**：支持将 DSH 部署在带路径前缀的反向代理后面（如 `/app/dsh/`），插件 API 统一自动按页面基址（`document.baseURI`）相对解析。
|
|
80
79
|
|
|
81
|
-
##
|
|
80
|
+
## 插件配置与可选开关
|
|
82
81
|
|
|
83
|
-
|
|
84
|
-
>
|
|
82
|
+
插件遵循 DSH 官方扩展配置规范，配置项位于：
|
|
83
|
+
> **主界面侧边栏「插件」→ 点击 `Skills Manager` 详情页**（对应宿主 `plugins.bundle.config` 槽位）。
|
|
85
84
|
|
|
86
|
-
|
|
85
|
+
此处提供两个原生扁平行开关：
|
|
87
86
|
|
|
88
|
-
### 1.
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
87
|
+
### 1. 侧边栏入口 (`sidebarEntry`)
|
|
88
|
+
- **默认状态**：关闭（`false`）
|
|
89
|
+
- **功能说明**：在宿主左侧主导航栏的「插件」下方增加常驻的 **「技能」** 图标入口。
|
|
90
|
+
- **生效效果**：
|
|
91
|
+
- 开启后，在侧边栏点击即可直达技能管理中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
|
|
92
|
+
- 关闭后安全注销侧栏槽位；
|
|
93
|
+
- 无论是否开启侧栏入口，DSH 原有的「设置 → 技能」入口始终保留，两处界面数据与状态 100% 实时同步。
|
|
95
94
|
|
|
96
|
-
### 2.
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
95
|
+
### 2. 在线更新 (`onlineUpdate` / `updater`)
|
|
96
|
+
- **默认状态**：开启（`true`）
|
|
97
|
+
- **功能说明**：控制是否允许在线检查并安装技能管理器的新版本。
|
|
98
|
+
- **生效效果**：
|
|
99
|
+
- **界面联动**：关闭开关后，技能管理面板顶部的「检查更新」按钮将即时隐藏，无需刷新页面；开启后自动恢复展示；
|
|
100
|
+
- **接口安全拦截**：关闭后，服务端的更新路由对任何版本检查和安装请求均返回 `HTTP 403` 禁用状态，彻底杜绝在插件内安装未审核版本；
|
|
101
|
+
- **宿主/平台级锁定**：面向精选插件索引（如 VibeDev）或企业安全合规环境，支持直接在 Cordis 配置文件（bundle patch）中声明，无需进入界面手动配置：
|
|
103
102
|
```yaml
|
|
104
|
-
updater: false #
|
|
103
|
+
updater: false # 或 onlineUpdate: false
|
|
105
104
|
```
|
|
106
|
-
|
|
105
|
+
配置生效后，更新器在启动时即被完全禁用，且更新入口默认保持隐藏。
|
|
107
106
|
|
|
108
|
-
##
|
|
107
|
+
## 使用指南
|
|
109
108
|
|
|
110
|
-
|
|
|
109
|
+
| 核心操作 | 操作方式 |
|
|
111
110
|
| --- | --- |
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
123
|
-
###
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
111
|
+
| **检索技能** | 切换「全局技能」或「项目技能」页签，按来源分组折叠/展开，或使用顶部搜索框与状态筛选器。 |
|
|
112
|
+
| **阅读技能** | 点击技能行右侧「查看详情」，在 760px 宽屏弹窗中阅读 `SKILL.md` 正文及诊断信息，支持一键「复制正文」。 |
|
|
113
|
+
| **控制启停** | 点击技能行右侧开关，切换其在 DSH 中的调用状态；仅影响 DSH 智能体执行，绝不改动第三方源文件。 |
|
|
114
|
+
| **更换外部来源目录** | 点击顶栏「来源目录…」或在来源行点「修改技能目录」，输入或浏览目录后保存；「恢复默认」回到默认位置。只改本插件读哪里，不移动文件，外部来源仍只读。 |
|
|
115
|
+
| **分类与拖拽** | 在来源内点击「新建分类」，拖拽左侧把手（`⋮⋮`）直接跨分类移动或同组排序；支持分类一键批量启停与多选添加。 |
|
|
116
|
+
| **创建与导入** | 点击顶栏「创建技能」或「导入技能」，并排选择写入目标（用户目录或已登记工作区项目目录），系统自动核对安全路径。 |
|
|
117
|
+
| **发现与安装** | 切换到「发现」页签，浏览 ClawHub 热榜或搜索 skills.sh 目录，或点击「添加仓库」订阅公开 GitHub 仓库。 |
|
|
118
|
+
| **仓库技能更新** | 点击「刷新」，再点击「查看更新」预览文件 Diff 差异，确认后自动创建本地备份并完成更新。 |
|
|
119
|
+
| **版本回退** | 对存在备份的技能点击「恢复上一版」，预览差异并确认恢复。 |
|
|
120
|
+
| **回收与防误删** | 删除的 DSH 技能自动进入「回收站」，可随时完整恢复或永久删除。 |
|
|
121
|
+
|
|
122
|
+
### 按来源仓库分组
|
|
123
|
+
|
|
124
|
+
技能列表可在默认的「按来源目录」和「按来源仓库」之间切换。仓库视图按来源目录、仓库、仓库内目录展示技能；不能确定来源的技能显示为「来源未知」。来源依次读取本插件安装记录、目录锁文件和技能元数据，不根据目录名猜测。
|
|
125
|
+
|
|
126
|
+
仓库视图只改变浏览方式，不移动技能文件；技能启停、详情等操作仍可使用。创建分类、调整归类和拖拽排序请切回来源目录视图。
|
|
127
|
+
|
|
128
|
+
### 技能管理四大板块
|
|
129
|
+
|
|
130
|
+
1. **全局技能（Global Skills）**
|
|
131
|
+
- 集中展示当前电脑上所有 Agent 目录下的全局技能（跨项目通用）。
|
|
132
|
+
- 支持按来源启停、按分类组织；当不同来源存在同名技能时，自动遵循优先级遮盖并给出来源提示。
|
|
133
|
+
2. **项目技能（Project Skills）**
|
|
134
|
+
- 顶部下拉选择当前 DSH 已登记的工作区目录，下方展示该项目所属的 Agent 技能。
|
|
135
|
+
- 仅扫描并管理所选工作区；项目级同名技能优于全局副本生效。
|
|
136
|
+
3. **发现（Discover）**
|
|
137
|
+
- **公共市场**：集成 ClawHub 热门下载榜与 skills.sh 全球技能库，输入关键字即可检索全球开源技能，一键完成多副本安装；
|
|
138
|
+
- **GitHub 仓库订阅**：输入 GitHub 仓库地址，整仓扫描技能清单，支持增量版本比对、本地修改保护与更新备份。
|
|
139
|
+
4. **回收站（Trash）**
|
|
140
|
+
- 存放从 DSH 或公共 Agent 来源中删除的技能副本，保留原始安装位置与关联信息。
|
|
141
|
+
- 误删技能可一键恢复回原目录，彻底杜绝意外丢失。
|
|
142
|
+
|
|
143
|
+
### 技能命名与 Frontmatter 规范
|
|
144
|
+
|
|
145
|
+
DeepSeek Harness 宿主加载机制对技能标识符遵循规范命名约束：
|
|
146
|
+
- **名称格式**：宿主严格要求技能名称必须为 ASCII 小写字母、数字与连字符构成的 kebab-case 格式（如 `my-custom-skill`）；
|
|
147
|
+
- **中文技能目录自救**：您的技能文件夹名称可以继续使用直观的中文名称（如 `文案排版/`），只需在其 `SKILL.md` 的 YAML frontmatter 中显式声明合法的英文 `name` 即可被宿主正常加载和调用：
|
|
143
148
|
```markdown
|
|
144
149
|
---
|
|
145
150
|
name: copy-formatting-helper
|
|
146
|
-
description:
|
|
151
|
+
description: 微信公众号与多平台文案排版辅助工具
|
|
147
152
|
---
|
|
148
153
|
|
|
149
|
-
#
|
|
154
|
+
# 技能正文内容...
|
|
150
155
|
```
|
|
151
|
-
-
|
|
156
|
+
- **界面智能诊断**：若本地存在缺少英文 `name` 的纯中文技能，管理器会在界面明确给出「宿主不支持此技能名称格式，无法启用」的诊断指引，并允许停用清理历史脏记录。
|
|
152
157
|
|
|
153
|
-
###
|
|
158
|
+
### 仓库与安装边界
|
|
154
159
|
|
|
155
|
-
-
|
|
156
|
-
-
|
|
157
|
-
- 32 MiB
|
|
158
|
-
-
|
|
160
|
+
- 顶栏「检查更新」用于更新技能管理器插件自身；仓库区「刷新」仅检查技能仓库内容更新，不自动覆盖本地。
|
|
161
|
+
- 仓库安装可以写入用户目录下的 DSH skills 或公共 Agent（`~/.agents/skills`，可用 `DSH_AGENTS_HOME` 覆盖），也可以写入已登记工作区的 `<项目根>/.dsh/skills`。选择器显示实际配置路径，并禁用不安全路径；缺少的目录仅在确认安装后创建。不能安装到 Codex、Claude 等其他 Agent 目录。
|
|
162
|
+
- 归档上限 32 MiB，指定子目录也需下载整库。
|
|
163
|
+
- 更新前检测本地修改，覆盖必须明确确认；历史备份不自动清理，可随时恢复上一版。
|
|
159
164
|
|
|
160
|
-
##
|
|
165
|
+
## 支持的 Agent 目录
|
|
161
166
|
|
|
162
|
-
`~`
|
|
167
|
+
`~` 表示用户主目录，`<project>` 表示已登记工作区的项目根。表中为默认路径；设置了对应环境变量时，以配置为准。环境变量覆盖对应 Agent 的主根目录，插件会在其目录下扫描 `skills` 文件夹（即 `<环境变量值>/skills`）。
|
|
163
168
|
|
|
164
|
-
|
|
|
169
|
+
| 来源 | 全局目录 | 环境变量 | 项目目录 |
|
|
165
170
|
| --- | --- | --- | --- |
|
|
166
171
|
| <img src="assets/brands/dsh.png" width="16" height="16" alt="DSH" valign="middle"> DSH | `~/.dsh/skills` | `DSH_HOME` | `<project>/.dsh/skills` |
|
|
167
|
-
| <img src="assets/brands/agents.svg" width="16" height="16" alt="Shared Agent" valign="middle">
|
|
172
|
+
| <img src="assets/brands/agents.svg" width="16" height="16" alt="Shared Agent" valign="middle"> 公共 Agent | `~/.agents/skills` | `DSH_AGENTS_HOME` | `<project>/.agents/skills` |
|
|
168
173
|
| <img src="assets/brands/cc-switch.png" width="16" height="16" alt="CC Switch" valign="middle"> CC Switch | `~/.cc-switch/skills` | — | — |
|
|
169
174
|
| <img src="assets/brands/codex.svg" width="16" height="16" alt="Codex" valign="middle"> Codex | `~/.codex/skills` | `DSH_CODEX_HOME` | `<project>/.codex/skills` |
|
|
170
175
|
| <img src="assets/brands/claude.svg" width="16" height="16" alt="Claude Code" valign="middle"> Claude Code | `~/.claude/skills` | `DSH_CLAUDE_HOME` | `<project>/.claude/skills` |
|
|
@@ -184,43 +189,43 @@ The DeepSeek Harness loader enforces strict identifier policies:
|
|
|
184
189
|
| <img src="assets/brands/qoder.svg" width="16" height="16" alt="Qoder CN" valign="middle"> Qoder CN | `~/.lingma/skills` | `DSH_LINGMA_HOME` | `<project>/.lingma/skills` |
|
|
185
190
|
| <img src="assets/brands/gemini.svg" width="16" height="16" alt="Google Antigravity" valign="middle"> Google Antigravity | `~/.gemini/config/skills` | `DSH_ANTIGRAVITY_HOME` | `<project>/.agents/skills` |
|
|
186
191
|
|
|
187
|
-
|
|
188
|
-
|
|
192
|
+
不扫描普通项目根目录的 `<project>/skills`，避免把仓库的发布资源当作 Agent 技能。OpenClaw / Clawdbot 仅保留上表中的用户级来源。Qoder CN CLI 的项目技能在 `<project>/.qoder/skills`，显示为 Qoder。Qoder CN IDE 使用 Lingma 目录。不存在的外部来源目录不会显示。
|
|
193
|
+
外部 Agent 来源（CC Switch、Codex、Claude Code 等）可以在来源行直接改读哪个目录，保存后立即生效。覆盖保存在 `~/.dsh/skills-manager/roots.json`，优先级高于 `DSH_<AGENT>_HOME`；手工编辑该文件需重启 DSH。DSH 与公共 Agent 是宿主的扫描路径，不在此处开放，需要整体搬迁时请改 `DSH_HOME` / `DSH_AGENTS_HOME`。目录必须已存在，且不能与其它来源重叠；自定义目录失效时来源会保留在列表里，方便改回默认。
|
|
189
194
|
|
|
190
|
-
###
|
|
195
|
+
### 自定义来源（清单外的 Agent）
|
|
191
196
|
|
|
192
|
-
|
|
197
|
+
表里没有的 Agent 不必等插件发版：打开「来源目录…」，点「添加来源」，填它的技能目录即可。自定义来源与外部只读来源同构——只扫描不写入、不改动第三方文件，支持分组、拖拽归类、来源级与分类级启停；显示名默认取目录名，也可以自己填。
|
|
193
198
|
|
|
194
|
-
|
|
199
|
+
如果一个 Agent 用多个子 profile（多账号、多工作区）各自维护一套技能，**填产品总目录再点「扫描子目录」**：插件会向下找两层内所有含 `SKILL.md` 的 `skills` 目录，列成候选，每条显示为「产品名 / 子目录名」并标注技能数量，确认后一次登记。扫描只产生候选，不会自动登记；与已有来源重叠的候选会被标出并禁止登记。
|
|
195
200
|
|
|
196
|
-
|
|
201
|
+
登记信息写在 `roots.json` 的 `customSources` 段，与目录覆盖共用同一个文件。移除登记只删除这条记录，磁盘上的技能文件保持原样。上限 32 个自定义来源。
|
|
197
202
|
|
|
198
|
-
## DSH
|
|
203
|
+
## DSH 产品生态
|
|
199
204
|
|
|
200
|
-
|
|
205
|
+
想使用桌面工作台，可下载 [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases)；已有 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。
|
|
201
206
|
|
|
202
|
-
|
|
|
207
|
+
| 插件 | 你可以用它做什么 |
|
|
203
208
|
| --- | --- |
|
|
204
|
-
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) |
|
|
205
|
-
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) |
|
|
206
|
-
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) |
|
|
207
|
-
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) |
|
|
208
|
-
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) |
|
|
209
|
-
| [Automation](https://github.com/MichengAI/dsh-automation) |
|
|
210
|
-
| [BTW](https://github.com/MichengAI/dsh-btw) |
|
|
211
|
-
| [Simplify](https://github.com/MichengAI/dsh-simplify) |
|
|
212
|
-
| [PUA](https://github.com/MichengAI/dsh-pua) |
|
|
213
|
-
| [Code Review](https://github.com/MichengAI/dsh-code-review) |
|
|
214
|
-
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) |
|
|
209
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
|
|
210
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
|
|
211
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 管理本机与项目技能，从仓库安装、更新和回退 |
|
|
212
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
|
|
213
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从消息平台下任务、收回复 |
|
|
214
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看每次运行的结果 |
|
|
215
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问，不打断主任务 |
|
|
216
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | 用 `/simplify` 整理 Git 改动范围内的代码 |
|
|
217
|
+
| [PUA](https://github.com/MichengAI/dsh-pua) | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
|
|
218
|
+
| [Code Review](https://github.com/MichengAI/dsh-code-review) | 用 `/review` 发起独立 Agent 代码审查，在当前会话接收报告 |
|
|
219
|
+
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |
|
|
215
220
|
|
|
216
|
-
##
|
|
221
|
+
## 反馈与贡献
|
|
217
222
|
|
|
218
|
-
[
|
|
223
|
+
遇到问题或有建议，欢迎[提交 Issue](https://github.com/MichengAI/dsh-skills-manager/issues)。请附上 DSH 与插件版本、复现步骤；界面问题可附完整截图。
|
|
219
224
|
|
|
220
|
-
|
|
225
|
+
源码位于 `src`，使用严格 TypeScript，保留现有插件架构。开发时执行 `npm run typecheck` 检查类型，`npm run build` 生成运行产物，`npm run verify` 执行完整回归与打包验证。GitHub 与 npm 都包含可直接运行的 `lib`。改动源码后，提交前请先运行构建。打包前仍会自动检查类型并构建，npm 安装包仍包含所需 JavaScript 产物。CI 在 Node.js 22.19.0 和 24 上执行完整验证，代码改动也会自动触发受支持宿主兼容矩阵。欢迎提交改进。
|
|
221
226
|
|
|
222
|
-
|
|
227
|
+
从源码制作测试包时，使用项目固定版本的 pnpm 安装依赖，执行 `npm run verify`，再执行 `npm pack`。用 `dsh plugin --profile web add <package.tgz>` 安装生成的 `.tgz`，重启 DSH 并刷新页面。打包时不要使用 `--ignore-scripts`，否则会跳过构建钩子。
|
|
223
228
|
|
|
224
|
-
##
|
|
229
|
+
## 许可证
|
|
225
230
|
|
|
226
231
|
[Apache License 2.0](LICENSE)
|
package/README.zh-CN.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
**统一管理本机与项目技能，从 GitHub 安装、预览更新并备份回退**
|
|
10
10
|
|
|
11
|
-
[English](README.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
|
|
11
|
+
[English](README.en.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
|
|
12
12
|
|
|
13
13
|
[](LICENSE)
|
|
14
14
|
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
@@ -19,14 +19,13 @@
|
|
|
19
19
|
|
|
20
20
|
> DSH Skills Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
|
|
21
21
|
|
|
22
|
-
本文描述 **1.2.30**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
|
|
23
|
-
|
|
24
22
|
## 功能概览
|
|
25
23
|
|
|
26
24
|
把散落在本机和项目中的技能集中到 DSH，无需在多个 Agent 目录间来回查找。
|
|
27
25
|
|
|
28
26
|
- **多视图集中管理**：提供「全局技能」、「项目技能」、「发现」与「回收站」四大工作区视图，支持搜索、状态筛选与来源折叠。
|
|
29
27
|
- **广泛的生态兼容**：覆盖 DSH、公共 Agent、Codex、Claude Code、Copilot、Cursor、Google Antigravity、Windsurf、Qoder、Trae 等 20+ 工具与 CLI 环境，统一管理且不侵入第三方文件。
|
|
28
|
+
- **按来源仓库浏览**：可切换目录或仓库视图，依据安装记录、锁文件和技能元数据识别来源；没有可靠来源的技能显示为「来源未知」。
|
|
30
29
|
- **分类整理与拖拽归类**：支持在各来源内创建分类文件夹、拖拽技能卡片归类排序、批量添加技能，并支持分类级一键启停。分类元数据独立保存，不改动物理文件。
|
|
31
30
|
- **公共市场与仓库订阅**：内置「发现」中心，一站式浏览 ClawHub 热门榜单与 skills.sh 技能市场，支持公开 GitHub 仓库订阅、增量更新检测与版本备份回退。
|
|
32
31
|
- **创建与自由导入**：新建技能，或导入 ZIP、文件夹与 `SKILL.md`，可精准写入用户全局目录或指定工作区项目目录。
|
|
@@ -74,7 +73,7 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
|
|
|
74
73
|
|
|
75
74
|
安装后重启 DSH 并刷新页面，打开「设置 → 技能」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
|
|
76
75
|
|
|
77
|
-
- `1.2.
|
|
76
|
+
- `1.2.32` 已验证兼容 DeepSeek Harness `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-rc.1`。
|
|
78
77
|
- 宿主支持范围：DeepSeek Harness `0.2.x` 全系列（`>=0.2.0-rc.1 <0.3.0-0`），自动支持后续全部 0.2.x RC 版本，同代宿主升级无需重复等待发版。早期版本与 `0.3.0` 代际破坏性更新由版本门拦截。仍在使用 `0.1.x` 的，请安装插件 `1.1.23`，不要装 `@latest`。
|
|
79
78
|
- **反向代理部署**：支持将 DSH 部署在带路径前缀的反向代理后面（如 `/app/dsh/`），插件 API 统一自动按页面基址（`document.baseURI`）相对解析。
|
|
80
79
|
|
|
@@ -120,6 +119,12 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
|
|
|
120
119
|
| **版本回退** | 对存在备份的技能点击「恢复上一版」，预览差异并确认恢复。 |
|
|
121
120
|
| **回收与防误删** | 删除的 DSH 技能自动进入「回收站」，可随时完整恢复或永久删除。 |
|
|
122
121
|
|
|
122
|
+
### 按来源仓库分组
|
|
123
|
+
|
|
124
|
+
技能列表可在默认的「按来源目录」和「按来源仓库」之间切换。仓库视图按来源目录、仓库、仓库内目录展示技能；不能确定来源的技能显示为「来源未知」。来源依次读取本插件安装记录、目录锁文件和技能元数据，不根据目录名猜测。
|
|
125
|
+
|
|
126
|
+
仓库视图只改变浏览方式，不移动技能文件；技能启停、详情等操作仍可使用。创建分类、调整归类和拖拽排序请切回来源目录视图。
|
|
127
|
+
|
|
123
128
|
### 技能管理四大板块
|
|
124
129
|
|
|
125
130
|
1. **全局技能（Global Skills）**
|