@michengai/dsh-skills-manager 1.2.16 → 1.2.19

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.
Files changed (8) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/CHANGELOG.zh-CN.md +14 -0
  3. package/README.md +6 -3
  4. package/README.zh-CN.md +6 -3
  5. package/lib/client.js +8 -6
  6. package/lib/core.js +179 -4
  7. package/lib/index.js +5 -3
  8. package/package.json +24 -22
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.2.19 - 2026-10-25
4
+
5
+ - Configurable external skill source folders: External read-only agent sources (Codex, Claude Code, Cursor, CC Switch, Google Antigravity, etc.) can now be pointed at custom folders directly from the UI, persisted to `~/.dsh/skills-manager/roots.json` taking precedence over environment variables with immediate effect (PR #66).
6
+ - New header "Source folders…" management action with in-dialog source switching, enabling first-time configuration for sources that are empty or have missing default directories.
7
+ - Fix custom folder dialog pre-fill: Retain the currently active directory instead of falling back to default, preventing accidental resets when saving without edits.
8
+ - Atomic configuration persistence: Commit in-memory root path configuration only after successful disk writes, preventing memory contamination on filesystem errors.
9
+ - Responsive custom badge layout: Move the "Custom" badge into the header label to ensure visibility even when paths are hidden in narrow container widths.
10
+
11
+ ## 1.2.18 - 2026-10-24
12
+
13
+ - Upgrade host admission policy: Declare `engines.dsh: ">=0.2.0-rc.1 <0.3.0-0"` to support the entire DeepSeek Harness `0.2.x` line (including `0.2.0-rc.1` onwards, future alphas, RCs, and stable releases) without requiring routine plugin version bumps.
14
+ - Decouple peerDependencies locks: Broaden all `@deepseek-ai/dsh-*` peer dependencies to the `0.2.x` generation range.
15
+ - Upgrade build-time development dependencies: Synchronize all `@deepseek-ai/dsh-*` devDependencies to latest `0.2.1-rc.3`.
16
+
3
17
  ## 1.2.16 - 2026-10-24
4
18
 
5
19
  - Dynamically migrate non-baseline external sources in `migrateManagerStateDocument()`, resolving state lockup and accidental fail-closed disablement when upgrading from older releases (Issue #63).
package/CHANGELOG.zh-CN.md CHANGED
@@ -2,6 +2,20 @@
2
2
 
3
3
  [English](CHANGELOG.md)
4
4
 
5
+ ## 1.2.19 - 2026-10-25
6
+
7
+ - 支持自定义外部技能来源目录：外部只读 Agent 来源（Codex、Claude Code、Cursor、CC Switch、Google Antigravity 等）支持在面板中自定义读取路径，配置保存至 `~/.dsh/skills-manager/roots.json`，优先级高于环境变量且即时生效（PR #66）。
8
+ - 全局顶栏新增「来源目录…」管理入口，并在弹窗内提供来源下拉切换，支持对默认无技能或目录未创建的外部来源进行首次路径配置。
9
+ - 优化目录修改弹窗输入预填逻辑：优先填入当前实际生效的技能目录，防止未修改直接保存误恢复默认。
10
+ - 原子化持久化提交：外部来源目录配置落盘成功后才更新共享内存状态，杜绝磁盘写入失败时污染内存配置。
11
+ - 优化自定义来源徽标布局：将「自定义」标记移至标题行常驻展示，在窄容器面板下即便路径隐藏仍保持状态可见。
12
+
13
+ ## 1.2.18 - 2026-10-24
14
+
15
+ - 宿主准入机制全面升级：声明 `engines.dsh: ">=0.2.0-rc.1 <0.3.0-0"`，全面开放对 DeepSeek Harness 整个 `0.2.x` 系列的支持（包含已支持的 `0.2.0-rc.1` 起及后续全部 alpha/rc/正式版），非破坏性宿主升级无需再重复发版。
16
+ - 解除 peerDependencies 逐版本锁定：所有 `@deepseek-ai/dsh-*` peer 依赖统一放宽至 `0.2.x` 代际范围。
17
+ - 升级编译期开发依赖：将全部 `@deepseek-ai/dsh-*` 开发依赖对齐升级至最新 `0.2.1-rc.3`。
18
+
5
19
  ## 1.2.16 - 2026-10-24
6
20
 
7
21
  - 修复状态文档迁移逻辑：动态识别并补齐所有新增外部来源的缺省字段（含 `antigravity`），解决从旧版本升级后状态文件校验失败、导致所有技能被安全停用且写入锁定的问题（Issue #63）。
package/README.md CHANGED
@@ -19,7 +19,7 @@
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.16**. Released changes are in the [changelog](CHANGELOG.md).
22
+ This README describes **1.2.19**. Released changes are in the [changelog](CHANGELOG.md).
23
23
 
24
24
  ## Features
25
25
 
@@ -32,6 +32,7 @@ Bring skills from your computer and projects into DSH without switching between
32
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
33
  - **Wide reading experience**: 760px responsive detail modal with monospace syntax styling, vertical resizing, and a one-click "Copy body" action.
34
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.
35
36
 
36
37
  ## Screenshots
37
38
 
@@ -73,8 +74,8 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
73
74
 
74
75
  Restart DSH, refresh the page, and open **Settings → Skills**. To update, select **Check for updates** or run the installation command again.
75
76
 
76
- - Plugin `1.2.16` 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`.
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`.
77
+ - Plugin `1.2.19` 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`.
78
+ - Host compatibility: Full DeepSeek Harness `0.2.x` line (`>=0.2.0-rc.1 <0.3.0-0`), forwards-compatible with subsequent `0.2.x` releases, alphas, and RCs without requiring routine plugin version bumps. Legacy versions and breaking changes in the `0.3.0` generation are rejected by the version gate. If you still use a `0.1.x` host, install plugin `1.1.23` instead of `@latest`.
78
79
  - **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
 
80
81
  ## Plugin Configuration & Toggles
@@ -111,6 +112,7 @@ Two native switches are available:
111
112
  | **Find skills** | Switch between Global Skills and Project Skills tabs, expand/collapse source groups, or use the search bar and status filters. |
112
113
  | **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
114
  | **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. |
115
+ | **Change an external source folder** | Click **Source folders…** in the header or select **Change skills folder** on the source row, type or browse to a folder, and save. **Restore default** returns to the configured default. Only where this plugin reads changes; no files move and external sources stay read-only. |
114
116
  | **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
117
  | **Create & import** | Click **Create skill** or **Import skill** in the header. Select destination scope (User directory or a registered workspace project) and path. |
116
118
  | **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. |
@@ -183,6 +185,7 @@ The DeepSeek Harness loader enforces strict identifier policies:
183
185
  | <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` |
184
186
 
185
187
  Ordinary project-root `<project>/skills` directories are not scanned, so repository release resources are not exposed as Agent skills. OpenClaw / Clawdbot support is limited to the user-level sources above. Qoder CN CLI project skills use `<project>/.qoder/skills` and appear as Qoder. Qoder CN IDE uses the Lingma directories. Missing external source directories are not shown.
188
+ External agent sources (CC Switch, Codex, Claude Code and others) can be pointed at another folder from the source row; the change takes effect immediately. Overrides are stored in `~/.dsh/skills-manager/roots.json` and take precedence over `DSH_<AGENT>_HOME`; editing that file by hand requires restarting DSH. DSH and Shared Agent are the host's scan paths and are not offered here — use `DSH_HOME` / `DSH_AGENTS_HOME` to relocate them. The folder must already exist and must not overlap another source; when a custom folder disappears, the source stays listed so you can restore the default.
186
189
 
187
190
  ## DSH product ecosystem
188
191
 
package/README.zh-CN.md CHANGED
@@ -19,7 +19,7 @@
19
19
 
20
20
  > DSH Skills Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
21
21
 
22
- 本文描述 **1.2.16**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
22
+ 本文描述 **1.2.19**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
23
23
 
24
24
  ## 功能概览
25
25
 
@@ -32,6 +32,7 @@
32
32
  - **创建与自由导入**：新建技能，或导入 ZIP、文件夹与 `SKILL.md`，可精准写入用户全局目录或指定工作区项目目录。
33
33
  - **宽屏阅读与正文复制**：760px 宽屏自适应详情弹窗，等宽字体代码高亮排版，支持垂直自由拉伸与一键复制 Markdown 正文。
34
34
  - **回收站与防误删保障**：DSH 技能删除后优先移入回收站，支持完整保留安装身份与更新历史的安全恢复。
35
+ - **自定义来源目录**：外部 Agent 来源可以在面板里改读取位置，不移动任何文件；DSH 与公共 Agent 仍由宿主配置。
35
36
 
36
37
  ## 界面预览
37
38
 
@@ -73,8 +74,8 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
73
74
 
74
75
  安装后重启 DSH 并刷新页面，打开「设置 → 技能」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
75
76
 
76
- - `1.2.16` 已验证兼容 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`。
77
- - 不再支持 `0.2.0` 之前的宿主。仍在使用 `0.1.x` 的，请安装插件 `1.1.23`，不要装 `@latest`。
77
+ - `1.2.19` 已验证兼容 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`。
78
+ - 宿主支持范围：DeepSeek Harness `0.2.x` 全系列（`>=0.2.0-rc.1 <0.3.0-0`），自动支持后续日常小版本、alpha 与 RC，同代宿主升级无需重复等待发版。早期版本与 `0.3.0` 代际破坏性更新由版本门拦截。仍在使用 `0.1.x` 的，请安装插件 `1.1.23`，不要装 `@latest`。
78
79
  - **反向代理部署**：支持将 DSH 部署在带路径前缀的反向代理后面（如 `/app/dsh/`），插件 API 统一自动按页面基址（`document.baseURI`）相对解析。
79
80
 
80
81
  ## 插件配置与可选开关
@@ -111,6 +112,7 @@ dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=htt
111
112
  | **检索技能** | 切换「全局技能」或「项目技能」页签，按来源分组折叠/展开，或使用顶部搜索框与状态筛选器。 |
112
113
  | **阅读技能** | 点击技能行右侧「查看详情」，在 760px 宽屏弹窗中阅读 `SKILL.md` 正文及诊断信息，支持一键「复制正文」。 |
113
114
  | **控制启停** | 点击技能行右侧开关，切换其在 DSH 中的调用状态；仅影响 DSH 智能体执行，绝不改动第三方源文件。 |
115
+ | **更换外部来源目录** | 点击顶栏「来源目录…」或在来源行点「修改技能目录」，输入或浏览目录后保存；「恢复默认」回到默认位置。只改本插件读哪里，不移动文件，外部来源仍只读。 |
114
116
  | **分类与拖拽** | 在来源内点击「新建分类」，拖拽左侧把手（`⋮⋮`）直接跨分类移动或同组排序；支持分类一键批量启停与多选添加。 |
115
117
  | **创建与导入** | 点击顶栏「创建技能」或「导入技能」，并排选择写入目标（用户目录或已登记工作区项目目录），系统自动核对安全路径。 |
116
118
  | **发现与安装** | 切换到「发现」页签，浏览 ClawHub 热榜或搜索 skills.sh 目录，或点击「添加仓库」订阅公开 GitHub 仓库。 |
@@ -183,6 +185,7 @@ DeepSeek Harness 宿主加载机制对技能标识符遵循规范命名约束：
183
185
  | <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` |
184
186
 
185
187
  不扫描普通项目根目录的 `<project>/skills`，避免把仓库的发布资源当作 Agent 技能。OpenClaw / Clawdbot 仅保留上表中的用户级来源。Qoder CN CLI 的项目技能在 `<project>/.qoder/skills`，显示为 Qoder。Qoder CN IDE 使用 Lingma 目录。不存在的外部来源目录不会显示。
188
+ 外部 Agent 来源（CC Switch、Codex、Claude Code 等）可以在来源行直接改读哪个目录，保存后立即生效。覆盖保存在 `~/.dsh/skills-manager/roots.json`，优先级高于 `DSH_<AGENT>_HOME`；手工编辑该文件需重启 DSH。DSH 与公共 Agent 是宿主的扫描路径，不在此处开放，需要整体搬迁时请改 `DSH_HOME` / `DSH_AGENTS_HOME`。目录必须已存在，且不能与其它来源重叠；自定义目录失效时来源会保留在列表里，方便改回默认。
186
189
 
187
190
  ## DSH 产品生态
188
191