@michengai/dsh-skills-manager 1.2.12 → 1.2.14
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 +10 -0
- package/CHANGELOG.zh-CN.md +10 -0
- package/README.md +90 -39
- package/README.zh-CN.md +90 -39
- package/lib/client.js +6 -5
- package/lib/index.js +2 -2
- package/package.json +10 -10
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.2.14 - 2026-10-24
|
|
4
|
+
|
|
5
|
+
- Support DeepSeek Harness `0.2.1-rc.3` while retaining all existing supported versions.
|
|
6
|
+
|
|
7
|
+
## 1.2.13 - 2026-10-23
|
|
8
|
+
|
|
9
|
+
- Hide the heading version chip when online updates are disabled alongside the update check action.
|
|
10
|
+
- Disable the bundle config toggle with localized diagnostics when online updates are locked by host configuration (`updater: false` or `onlineUpdate: false`), preventing silent 403 bounces.
|
|
11
|
+
- Clean up sidebar controller listeners and slots on plugin teardown, invalidating late initialization and rollback responses.
|
|
12
|
+
|
|
3
13
|
## 1.2.12 - 2026-10-23
|
|
4
14
|
|
|
5
15
|
- Support opt-out toggle for online updates with a native switch under bundle configuration (Issue #50).
|
package/CHANGELOG.zh-CN.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
[English](CHANGELOG.md)
|
|
4
4
|
|
|
5
|
+
## 1.2.14 - 2026-10-24
|
|
6
|
+
|
|
7
|
+
- 支持 DeepSeek Harness `0.2.1-rc.3`，继续兼容此前已支持的宿主版本。
|
|
8
|
+
|
|
9
|
+
## 1.2.13 - 2026-10-23
|
|
10
|
+
|
|
11
|
+
- 修复关闭在线更新后标题栏版本号标签仍残留的问题：将门控前置，关闭后同步隐藏版本号与检查更新按钮。
|
|
12
|
+
- 完善宿主配置锁定（`updater: false` / `onlineUpdate: false`）体验：锁定后在配置卡片中明确禁用开关并提示锁定原因，防止点击后静默回弹 403。
|
|
13
|
+
- 修复侧边栏入口控制器的生命周期管理：在插件卸载清理钩子中安全释放监听器与插槽注册，并在销毁时阻断延迟初始化与回滚回调。
|
|
14
|
+
|
|
5
15
|
## 1.2.12 - 2026-10-23
|
|
6
16
|
|
|
7
17
|
- 支持在插件详情配置中提供「在线更新」开关（默认开启），关闭后自动隐藏检查更新入口（#50）。
|
package/README.md
CHANGED
|
@@ -14,26 +14,24 @@
|
|
|
14
14
|
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
15
15
|
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
16
16
|
[](https://github.com/MichengAI/dsh-skills-manager)
|
|
17
|
-
[](#installation)
|
|
18
18
|
</div>
|
|
19
19
|
|
|
20
20
|
> DSH Skills Manager is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
|
|
21
21
|
|
|
22
|
-
This README describes **1.2.
|
|
22
|
+
This README describes **1.2.14**. Released changes are in the [changelog](CHANGELOG.md).
|
|
23
23
|
|
|
24
24
|
## Features
|
|
25
25
|
|
|
26
|
-
|
|
27
26
|
Bring skills from your computer and projects into DSH without switching between Agent folders.
|
|
28
27
|
|
|
29
|
-
- **
|
|
30
|
-
- **
|
|
31
|
-
- **
|
|
32
|
-
- **
|
|
33
|
-
- **
|
|
34
|
-
- **
|
|
35
|
-
|
|
36
|
-
- **Source tracking and updates**: distinguish local and repository skills, preview file changes, protect local edits, and confirm backup, update or rollback.
|
|
28
|
+
- **Unified multi-view management**: Browse Global Skills, Project Skills, Discover, and Trash in unified tabs with instant search, status filtering, and collapsible source groups.
|
|
29
|
+
- **Broad ecosystem support**: Full coverage for 19+ tools and CLI environments including DSH, Shared Agent, Codex, Claude Code, Copilot, Cursor, 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.
|
|
37
35
|
|
|
38
36
|
## Screenshots
|
|
39
37
|
|
|
@@ -45,11 +43,11 @@ Project skills:
|
|
|
45
43
|
|
|
46
44
|
|
|
47
45
|
|
|
48
|
-
Skill repositories:
|
|
46
|
+
Skill repositories & discover:
|
|
49
47
|
|
|
50
48
|
|
|
51
49
|
|
|
52
|
-
*Screenshots show
|
|
50
|
+
*Screenshots show core feature views for global skills, project skills, and skill discovery. Lossless WebP.*
|
|
53
51
|
|
|
54
52
|
## Installation
|
|
55
53
|
|
|
@@ -75,34 +73,87 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
|
|
|
75
73
|
|
|
76
74
|
Restart DSH, refresh the page, and open **Settings → Skills**. To update, select **Check for updates** or run the installation command again.
|
|
77
75
|
|
|
78
|
-
- Plugin `1.2.
|
|
76
|
+
- Plugin `1.2.14` is tested with 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`.
|
|
79
77
|
- Hosts before `0.2.0` are no longer supported. If you still use a `0.1.x` host, install plugin `1.1.23` instead of `@latest`.
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
78
|
+
- **Reverse proxy deployment**: Supports hosting DSH behind prefix-stripping reverse proxies (e.g. `/app/dsh/`). API and update endpoints resolve against the page base URI (`document.baseURI`).
|
|
79
|
+
|
|
80
|
+
## Plugin Configuration & Toggles
|
|
81
|
+
|
|
82
|
+
The plugin follows standard DSH bundle configuration conventions. Options are located at:
|
|
83
|
+
> **Sidebar → Plugins → Click `Skills Manager`** (the host's `plugins.bundle.config` slot).
|
|
84
|
+
|
|
85
|
+
Two native switches are available:
|
|
86
|
+
|
|
87
|
+
### 1. Sidebar Entry (`sidebarEntry`)
|
|
88
|
+
- **Default**: Disabled (`false`)
|
|
89
|
+
- **Description**: Displays a persistent **Skills** navigation icon directly under **Plugins** in the host's left primary sidebar.
|
|
90
|
+
- **Effect**:
|
|
91
|
+
- When enabled, clicking the sidebar icon opens the Skills Manager directly in the primary workspace with a **960px centered container** (matching host plugin manager conventions). This eliminates vertical scrolling constraints in narrow settings dialogs;
|
|
92
|
+
- When disabled, unregisters the sidebar entry cleanly;
|
|
93
|
+
- The standard **Settings → Skills** view remains active either way, and state is synchronized live across both entry points.
|
|
94
|
+
|
|
95
|
+
### 2. Online Updates (`onlineUpdate` / `updater`)
|
|
96
|
+
- **Default**: Enabled (`true`)
|
|
97
|
+
- **Description**: Controls whether the plugin checks for and installs updates from npm.
|
|
98
|
+
- **Effect**:
|
|
99
|
+
- **Dynamic UI Sync**: Disabling the toggle hides the **Check for updates** button in the header immediately without requiring a full page reload;
|
|
100
|
+
- **Endpoint Guard**: When disabled, the update API route returns `HTTP 403` for all check and install requests, preventing unreviewed updates;
|
|
101
|
+
- **Host / Platform Lock**: For curated plugin indexes (such as VibeDev) or restricted enterprise environments, this can be locked directly via Cordis configuration (bundle patch) without needing UI interaction:
|
|
102
|
+
```yaml
|
|
103
|
+
updater: false # or onlineUpdate: false
|
|
104
|
+
```
|
|
105
|
+
Once configured, the built-in updater is disabled at startup and the update action stays hidden.
|
|
106
|
+
|
|
107
|
+
## Usage Guide
|
|
108
|
+
|
|
109
|
+
| Action | How to do it |
|
|
84
110
|
| --- | --- |
|
|
85
|
-
| Find
|
|
86
|
-
|
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
| Update repository skills |
|
|
92
|
-
| Roll back
|
|
93
|
-
| Recover
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
-
|
|
103
|
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
111
|
+
| **Find skills** | Switch between Global Skills and Project Skills tabs, expand/collapse source groups, or use the search bar and status filters. |
|
|
112
|
+
| **Inspect content** | Click **View details** on any skill row to read `SKILL.md` content and diagnostics in a 760px wide resizable dialog, with one-click **Copy body**. |
|
|
113
|
+
| **Toggle invocation** | Toggle the switch on the right side of a skill row to enable or disable it for DSH without editing third-party files. |
|
|
114
|
+
| **Organize categories** | Click **New category** within a source, then drag the grab handle (`⋮⋮`) to reorder or move skills across categories. Toggling a category turns all its member skills on or off. |
|
|
115
|
+
| **Create & import** | Click **Create skill** or **Import skill** in the header. Select destination scope (User directory or a registered workspace project) and path. |
|
|
116
|
+
| **Discover & install** | Open the **Discover** tab to browse trending ClawHub skills or search the skills.sh catalog, or click **Add repository** to subscribe to a public GitHub repo. |
|
|
117
|
+
| **Update repository skills** | Click **Refresh**, inspect file diffs with **Review update**, and confirm to update with an automated backup. |
|
|
118
|
+
| **Roll back updates** | Click **Restore previous version** on skills with backup history, preview changes, and confirm rollback. |
|
|
119
|
+
| **Recover deletions** | Open **Trash** to restore accidentally deleted DSH skills with their original locations preserved. |
|
|
120
|
+
|
|
121
|
+
### Four Main Tabs
|
|
122
|
+
|
|
123
|
+
1. **Global Skills**
|
|
124
|
+
- Manage cross-project skills stored across all detected agent home directories on your machine.
|
|
125
|
+
- Categorize and toggle skills by source; same-name precedence automatically highlights shadowed copies.
|
|
126
|
+
2. **Project Skills**
|
|
127
|
+
- Select any registered workspace from the dropdown to manage its project-level skills (`<project>/.dsh/skills`, etc.).
|
|
128
|
+
- Scans and searches only the selected workspace; project copies take precedence over global counterparts.
|
|
129
|
+
3. **Discover**
|
|
130
|
+
- **Public Catalogs**: Direct integration with ClawHub and skills.sh to find and install popular community skills;
|
|
131
|
+
- **GitHub Repositories**: Subscribe to public repositories, scan skill lists, preview diffs, and install copies with local edit protections.
|
|
132
|
+
4. **Trash**
|
|
133
|
+
- Soft-delete buffer for DSH and Shared Agent skills, preserving provenance and install destinations.
|
|
134
|
+
- Deleted skills can be restored anytime with a single click.
|
|
135
|
+
|
|
136
|
+
### Skill Naming & Frontmatter Requirements
|
|
137
|
+
|
|
138
|
+
The DeepSeek Harness loader enforces strict identifier policies:
|
|
139
|
+
- **Format constraint**: Host loaders require skill names to strictly match lowercase ASCII alphanumeric characters and hyphens (kebab-case, e.g. `my-tool`).
|
|
140
|
+
- **Non-ASCII & Chinese skill folders**: Your skill directory name can remain in Chinese (e.g. `文案排版/`), provided you specify a valid English `name` in `SKILL.md` frontmatter:
|
|
141
|
+
```markdown
|
|
142
|
+
---
|
|
143
|
+
name: copy-formatting-helper
|
|
144
|
+
description: Helper for multi-platform article formatting
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
# Skill instructions...
|
|
148
|
+
```
|
|
149
|
+
- **Diagnostics**: Skills lacking an English name are flagged with clear in-app diagnostics explaining that the host loader cannot invoke them, with options to safely disable or clean up records.
|
|
150
|
+
|
|
151
|
+
### Repository & Installation Boundaries
|
|
152
|
+
|
|
153
|
+
- The header **Check for updates** updates the plugin itself; repository **Refresh** checks subscribed skill contents without replacing local files.
|
|
154
|
+
- Repository installation can target user DSH skills, Shared Agent (`~/.agents/skills`, overridable via `DSH_AGENTS_HOME`), or `<project>/.dsh/skills` for registered workspaces. Unsafe paths and external agent roots (Codex, Claude) are locked against writes.
|
|
155
|
+
- 32 MiB archive limit; downloading subdirectories still fetches the full archive.
|
|
156
|
+
- Local edits are detected and require explicit confirmation before overwriting; backup history is preserved for rollback.
|
|
106
157
|
|
|
107
158
|
## Supported Agent directories
|
|
108
159
|
|
package/README.zh-CN.md
CHANGED
|
@@ -14,26 +14,24 @@
|
|
|
14
14
|
[](https://www.npmjs.com/package/@michengai/dsh-skills-manager)
|
|
15
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
20
|
> DSH Skills Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
|
|
21
21
|
|
|
22
|
-
本文描述 **1.2.
|
|
22
|
+
本文描述 **1.2.14**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
|
|
23
23
|
|
|
24
24
|
## 功能概览
|
|
25
25
|
|
|
26
26
|
把散落在本机和项目中的技能集中到 DSH，无需在多个 Agent 目录间来回查找。
|
|
27
27
|
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
- **来源追踪与更新**：区分本机和仓库安装，预览文件差异，保护本地修改，确认后备份更新并可恢复上一版。
|
|
28
|
+
- **多视图集中管理**：提供「全局技能」、「项目技能」、「发现」与「回收站」四大工作区视图，支持搜索、状态筛选与来源折叠。
|
|
29
|
+
- **生态目录全覆盖**：支持 DSH、公共 Agent（Shared Agent）、Codex、Claude Code、Copilot、Cursor、Windsurf、Qoder、Trae 等 19+ 种常见开发工具与 CLI 生态，启停不修改第三方源文件。
|
|
30
|
+
- **分类整理与拖拽归类**：支持在各来源内创建分类文件夹、拖拽技能卡片归类排序、批量添加技能，并支持分类级一键启停。分类元数据独立保存，不改动物理文件。
|
|
31
|
+
- **公共市场与仓库订阅**：内置「发现」中心，一站式浏览 ClawHub 热门榜单与 skills.sh 技能市场，支持公开 GitHub 仓库订阅、增量更新检测与版本备份回退。
|
|
32
|
+
- **创建与自由导入**：新建技能，或导入 ZIP、文件夹与 `SKILL.md`，可精准写入用户全局目录或指定工作区项目目录。
|
|
33
|
+
- **宽屏阅读与正文复制**：760px 宽屏自适应详情弹窗，等宽字体代码高亮排版，支持垂直自由拉伸与一键复制 Markdown 正文。
|
|
34
|
+
- **回收站与防误删保障**：DSH 技能删除后优先移入回收站，支持完整保留安装身份与更新历史的安全恢复。
|
|
37
35
|
|
|
38
36
|
## 界面预览
|
|
39
37
|
|
|
@@ -45,11 +43,11 @@
|
|
|
45
43
|
|
|
46
44
|
|
|
47
45
|
|
|
48
|
-
|
|
46
|
+
技能仓库与发现：
|
|
49
47
|
|
|
50
48
|
|
|
51
49
|
|
|
52
|
-
|
|
50
|
+
*截图展示核心功能面板，包含全局技能、项目技能与技能发现仓库。采用无损 WebP 格式。*
|
|
53
51
|
|
|
54
52
|
## 安装
|
|
55
53
|
|
|
@@ -75,34 +73,87 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
|
|
|
75
73
|
|
|
76
74
|
安装后重启 DSH 并刷新页面，打开「设置 → 技能」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
|
|
77
75
|
|
|
78
|
-
- `1.2.
|
|
76
|
+
- `1.2.14` 已验证兼容 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`。
|
|
79
77
|
- 不再支持 `0.2.0` 之前的宿主。仍在使用 `0.1.x` 的，请安装插件 `1.1.23`，不要装 `@latest`。
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
78
|
+
- **反向代理部署**：支持将 DSH 部署在带路径前缀的反向代理后面（如 `/app/dsh/`），插件 API 统一自动按页面基址（`document.baseURI`）相对解析。
|
|
79
|
+
|
|
80
|
+
## 插件配置与可选开关
|
|
81
|
+
|
|
82
|
+
插件遵循 DSH 官方扩展配置规范，配置项位于：
|
|
83
|
+
> **主界面侧边栏「插件」→ 点击 `Skills Manager` 详情页**（对应宿主 `plugins.bundle.config` 槽位）。
|
|
84
|
+
|
|
85
|
+
此处提供两个原生扁平行开关：
|
|
86
|
+
|
|
87
|
+
### 1. 侧边栏入口 (`sidebarEntry`)
|
|
88
|
+
- **默认状态**：关闭（`false`）
|
|
89
|
+
- **功能说明**：在宿主左侧主导航栏的「插件」下方增加常驻的 **「技能」** 图标入口。
|
|
90
|
+
- **生效效果**：
|
|
91
|
+
- 开启后，在侧边栏点击即可直达技能管理中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
|
|
92
|
+
- 关闭后安全注销侧栏槽位；
|
|
93
|
+
- 无论是否开启侧栏入口，DSH 原有的「设置 → 技能」入口始终保留，两处界面数据与状态 100% 实时同步。
|
|
94
|
+
|
|
95
|
+
### 2. 在线更新 (`onlineUpdate` / `updater`)
|
|
96
|
+
- **默认状态**：开启（`true`）
|
|
97
|
+
- **功能说明**：控制是否允许在线检查并安装技能管理器的新版本。
|
|
98
|
+
- **生效效果**：
|
|
99
|
+
- **界面联动**：关闭开关后，技能管理面板顶部的「检查更新」按钮将即时隐藏，无需刷新页面；开启后自动恢复展示；
|
|
100
|
+
- **接口安全拦截**：关闭后，服务端的更新路由对任何版本检查和安装请求均返回 `HTTP 403` 禁用状态，彻底杜绝在插件内安装未审核版本；
|
|
101
|
+
- **宿主/平台级锁定**：面向精选插件索引（如 VibeDev）或企业安全合规环境，支持直接在 Cordis 配置文件（bundle patch）中声明，无需进入界面手动配置：
|
|
102
|
+
```yaml
|
|
103
|
+
updater: false # 或 onlineUpdate: false
|
|
104
|
+
```
|
|
105
|
+
配置生效后，更新器在启动时即被完全禁用，且更新入口默认保持隐藏。
|
|
106
|
+
|
|
107
|
+
## 使用指南
|
|
108
|
+
|
|
109
|
+
| 核心操作 | 操作方式 |
|
|
84
110
|
| --- | --- |
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
-
|
|
103
|
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
111
|
+
| **检索技能** | 切换「全局技能」或「项目技能」页签，按来源分组折叠/展开，或使用顶部搜索框与状态筛选器。 |
|
|
112
|
+
| **阅读技能** | 点击技能行右侧「查看详情」，在 760px 宽屏弹窗中阅读 `SKILL.md` 正文及诊断信息，支持一键「复制正文」。 |
|
|
113
|
+
| **控制启停** | 点击技能行右侧开关，切换其在 DSH 中的调用状态；仅影响 DSH 智能体执行，绝不改动第三方源文件。 |
|
|
114
|
+
| **分类与拖拽** | 在来源内点击「新建分类」，拖拽左侧把手（`⋮⋮`）直接跨分类移动或同组排序；支持分类一键批量启停与多选添加。 |
|
|
115
|
+
| **创建与导入** | 点击顶栏「创建技能」或「导入技能」，并排选择写入目标（用户目录或已登记工作区项目目录），系统自动核对安全路径。 |
|
|
116
|
+
| **发现与安装** | 切换到「发现」页签，浏览 ClawHub 热榜或搜索 skills.sh 目录，或点击「添加仓库」订阅公开 GitHub 仓库。 |
|
|
117
|
+
| **仓库技能更新** | 点击「刷新」，再点击「查看更新」预览文件 Diff 差异，确认后自动创建本地备份并完成更新。 |
|
|
118
|
+
| **版本回退** | 对存在备份的技能点击「恢复上一版」，预览差异并确认恢复。 |
|
|
119
|
+
| **回收与防误删** | 删除的 DSH 技能自动进入「回收站」，可随时完整恢复或永久删除。 |
|
|
120
|
+
|
|
121
|
+
### 技能管理四大板块
|
|
122
|
+
|
|
123
|
+
1. **全局技能（Global Skills）**
|
|
124
|
+
- 集中展示当前电脑上所有 Agent 目录下的全局技能（跨项目通用）。
|
|
125
|
+
- 支持按来源启停、按分类组织；当不同来源存在同名技能时，自动遵循优先级遮盖并给出来源提示。
|
|
126
|
+
2. **项目技能（Project Skills）**
|
|
127
|
+
- 顶部下拉选择当前 DSH 已登记的工作区目录，下方展示该项目所属的 Agent 技能。
|
|
128
|
+
- 仅扫描并管理所选工作区；项目级同名技能优于全局副本生效。
|
|
129
|
+
3. **发现（Discover）**
|
|
130
|
+
- **公共市场**：集成 ClawHub 热门下载榜与 skills.sh 全球技能库，输入关键字即可检索全球开源技能，一键完成多副本安装；
|
|
131
|
+
- **GitHub 仓库订阅**：输入 GitHub 仓库地址，整仓扫描技能清单，支持增量版本比对、本地修改保护与更新备份。
|
|
132
|
+
4. **回收站（Trash）**
|
|
133
|
+
- 存放从 DSH 或公共 Agent 来源中删除的技能副本，保留原始安装位置与关联信息。
|
|
134
|
+
- 误删技能可一键恢复回原目录，彻底杜绝意外丢失。
|
|
135
|
+
|
|
136
|
+
### 技能命名与 Frontmatter 规范
|
|
137
|
+
|
|
138
|
+
DeepSeek Harness 宿主加载机制对技能标识符遵循规范命名约束：
|
|
139
|
+
- **名称格式**：宿主严格要求技能名称必须为 ASCII 小写字母、数字与连字符构成的 kebab-case 格式（如 `my-custom-skill`）；
|
|
140
|
+
- **中文技能目录自救**：您的技能文件夹名称可以继续使用直观的中文名称（如 `文案排版/`），只需在其 `SKILL.md` 的 YAML frontmatter 中显式声明合法的英文 `name` 即可被宿主正常加载和调用：
|
|
141
|
+
```markdown
|
|
142
|
+
---
|
|
143
|
+
name: copy-formatting-helper
|
|
144
|
+
description: 微信公众号与多平台文案排版辅助工具
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
# 技能正文内容...
|
|
148
|
+
```
|
|
149
|
+
- **界面智能诊断**：若本地存在缺少英文 `name` 的纯中文技能，管理器会在界面明确给出「宿主不支持此技能名称格式，无法启用」的诊断指引，并允许停用清理历史脏记录。
|
|
150
|
+
|
|
151
|
+
### 仓库与安装边界
|
|
152
|
+
|
|
153
|
+
- 顶栏「检查更新」用于更新技能管理器插件自身；仓库区「刷新」仅检查技能仓库内容更新，不自动覆盖本地。
|
|
154
|
+
- 仓库安装可以写入用户目录下的 DSH skills 或公共 Agent（`~/.agents/skills`，可用 `DSH_AGENTS_HOME` 覆盖），也可以写入已登记工作区的 `<项目根>/.dsh/skills`。选择器显示实际配置路径，并禁用不安全路径；缺少的目录仅在确认安装后创建。不能安装到 Codex、Claude 等其他 Agent 目录。
|
|
155
|
+
- 归档上限 32 MiB，指定子目录也需下载整库。
|
|
156
|
+
- 更新前检测本地修改，覆盖必须明确确认；历史备份不自动清理，可随时恢复上一版。
|
|
106
157
|
|
|
107
158
|
## 支持的 Agent 目录
|
|
108
159
|
|