npm - dsh-skills-tools - Versions diffs - 1.0.0 → 1.1.0 - Mend

dsh-skills-tools 1.0.0 → 1.1.0

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

package/README.en.md CHANGED Viewed

@@ -1,80 +1,127 @@
-# dsh-skills-tools
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/logo.png" width="72" height="72" alt="dsh-skills-tools" />
+</p>
-Manage Agent Skills as assets: import them from a Git repository (GitHub, GitLab or your intranet) or a local folder, then enable, disable, update and remove them in **Settings → Skills** — the Cursor-like workflow for the DSH skill catalog.
+<h1 align="center">dsh-skills-tools</h1>
-- Version **1.0.0**, MIT, zero dependencies, ESM host + classic-script client
-- Settings section **Skills** (order 19, right after MCP)
+<p align="center">
+  <b>Skills manager for DeepSeek Harness.</b><br />
+  Import Agent Skills from Git repositories or local folders, manage them by repository, and enable, disable, complete or inspect them at any time.
+</p>
-## Why
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-skills-tools"><img src="https://img.shields.io/npm/v/dsh-skills-tools?color=black" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/dsh-skills-tools"><img src="https://img.shields.io/npm/dm/dsh-skills-tools?color=black" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-black.svg" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D22.13-black.svg" alt="node" /></a>
+  <a href="https://github.com/hxlog/dsh-skills-tools"><img src="https://img.shields.io/badge/GitHub-hxlog%2Fdsh--skills--tools-black?logo=github" alt="GitHub" /></a>
+</p>
-Claude Code ships a **/skills** menu with on/off overrides, Cursor discovers .cursor/skills and plugin marketplaces, and Codex uses skill-installer to copy skills from GitHub. DSH native discovery scans directories but does not import, snapshot or toggle them.
+<p align="center">
+  <a href="https://github.com/hxlog/dsh-skills-tools">GitHub</a> ·
+  <a href="https://www.npmjs.com/package/dsh-skills-tools">npm</a> ·
+  <a href="https://github.com/hxlog/dsh-skills-tools/issues">Issues</a> ·
+  <a href="README.md">中文</a>
+</p>
-dsh-skills-tools fills that gap:
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/skills-overview.png" width="49%" alt="Skills grouped by repository" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/skill-content.png" width="49%" alt="Expanded SKILL.md content" />
+</p>
-1. **Import** from a Git URL (or local folder), optionally pinned to a branch, tag, commit or subdirectory.
-2. **Enable / disable** instantly; the DSH catalog is invalidated and disabled skills never reach the model context.
-3. **Read-only snapshots**: each repository is copied by commit into the data folder; the source is never modified.
-4. **Content-addressed updates**: check the remote head, then switch snapshots only after a successful clone.
-5. **Resources keep working**: skills register with resourceBase = { kind: "directory", path: snapshot/skill }, so ../../assets and ../check/... references resolve.
+> Disabled skills are not registered with the model: no context cost, no accidental calls.
-## Install
+## ✨ Features
-    dsh plugin add dsh-skills-tools
-    # or from a checkout
-    dsh plugin add file:D:/PythonProjects/dsh-skills-tools
+| Capability | Details |
+| --- | --- |
+| **Grouped by repository** | Skills are grouped into collapsible repository cards. Repositories with enabled skills come first; inside a repository, enabled skills come first. |
+| **Import the rest later** | A partially imported repository shows "N available". Click **Import more** to pick the remaining skills from the existing snapshot — no re-clone. |
+| **Repository switch** | Enable or disable every skill in a repository at once; the switch shows a mixed state when only some skills are enabled. |
+| **Inline content** | The chevron on each row expands the SKILL.md text, source repository, commit, path and update time, with update and remove actions. |
+| **Git import and snapshots** | https / ssh / intranet repositories, branches, tags, commits and subdirectories. Imports are read-only snapshots; source repositories are never modified. |
+| **Update checks** | Compare the remote head and switch snapshots only after a successful clone. |
-Add the bundle row to a profile's cordis.patch.yml if you prefer:
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/import-more.png" width="49%" alt="Import remaining skills from a repository" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/import-dialog.png" width="49%" alt="Import skills" />
+</p>
-    - insert:
-        - id: skills-tools
-          name: dsh-skills-tools
+## 🚀 Install
-Restart DSH, then open **Settings → Skills**.
+Requires **DeepSeek Harness 0.2.x** (Web GUI `dsh web` or DSH Desktop) and **Node.js ≥ 22.13**. Published on npm: [dsh-skills-tools](https://www.npmjs.com/package/dsh-skills-tools).
-## Usage
+> ⚠️ This is a **DeepSeek Harness plugin**, not a normal npm library: `npm i dsh-skills-tools` only downloads the package, it still has to be installed into a DSH profile.
-1. **Import skills** → paste a repository URL or local path.
-2. Optionally pin a ref (branch / tag / commit) or a subdirectory.
-3. **Scan**, select skills (duplicate names get an editable suggestion), then **Install selected**.
-4. Toggle rows on/off, search and filter, expand a row to read SKILL.md or update/remove it.
-5. **Check updates** marks skills whose repository has a newer commit; **Update from upstream** clones and switches the snapshot.
+**Install from the plugin page (recommended)**
-Supported sources: https://host/owner/repo(.git), GitHub-style /tree/<ref>/<subdir>, git@host:owner/repo.git, file:///path, and absolute local paths.
+1. Open DSH Web (or DSH Desktop) → **Plugins** (Desktop: **Settings → Plugins**).
+2. Click install, enter `dsh-skills-tools`, confirm.
+3. Enable the new bundle, refresh, then open **Settings → Skills**.
-## Intranet and private repositories
+**Install from the CLI**
-No token is stored. The plugin reuses your local git credentials (credential helper or SSH agent) and sets GIT_TERMINAL_PROMPT=0 so a missing credential fails fast instead of hanging.
+```bash
+dsh plugin add dsh-skills-tools                    # default profile
+dsh plugin --profile web add dsh-skills-tools      # Web
+dsh plugin --profile desktop add dsh-skills-tools  # Desktop
+```
-## Architecture
+Current version **1.1.0**: grouped by repository, repository switch, and completing skills from an existing snapshot.
-    Git repo / local folder
-      → clone --depth 1 --single-branch (or direct read)
-      → $DSH_HOME/dsh-skills-tools/repos/<slug>-<commit>   read-only snapshot
-      → scan SKILL.md (skips .git and symlinks, bounded depth/files)
-      → $DSH_HOME/dsh-skills-tools/state.json              repos + skills + enabled
-      → ctx.skills.registerProvider(rank 350)
-      → DSH catalog (enabled skills with an existing SKILL.md only)
+> Restart `dsh web` / DSH Desktop after upgrading.
+>
+> `dsh plugin add` only installs the package; it does not enable the bundle. Enable it once in the plugin page, or make sure `dsh-skills-tools` is in `dsh.profile.bundles`.
-Ranks: project-dsh 100, project-agents 200, **dsh-skills-tools 350**, user-dsh 400, user-agents 500, bundled 600.
+## ⚡ Quick start
-State writes use a directory lock plus atomic rename; the provider memoizes by state.json mtime, so several DSH windows share one library.
+1. **Settings → Skills → Import skills**: paste a Git URL (`https://`, `git@`, `file://` or a local absolute path). Intranet repositories use your local git credentials.
+2. Optionally set a **branch / tag / commit** and **subdirectory**, click **Scan**, select skills (duplicate names get an editable suggestion) and click **Install selected**. Installed skills are enabled.
+3. Manage by repository: the repository switch toggles all its skills, row switches toggle one, **Import more** completes partially imported repositories, and the chevron shows the content.
-## Security
+## 🧩 How it works
-- Every route is gated by DSH connection.requestRejection (Host/Origin/session); other local processes cannot drive the library.
-- 256 KiB request body cap, 20000 files / 300 MiB snapshot cap, 2 MiB SKILL.md cap.
-- Snapshots never follow symlinks; paths are verified to stay inside the snapshot; removal is verified to stay inside repos/.
-- Repository scripts are never executed; git runs with an argv array, never through a shell.
+```
+~/.dsh/dsh-skills-tools/
+├── state.json                 repositories, skills, enabled state
+└── repos/<repo>-<commit>/     read-only snapshot
+```
-## Development
+- **Snapshot isolation**: every import or update copies the repository into the data folder. Removing a skill only changes state.
+- **Registration-time toggles**: enabled state decides whether a skill is registered with the DSH skill catalog; disabled skills never reach the model.
+- **REST API**: `GET /skills-tools/api/state`, `POST /import/scan|commit`, `POST /repos/inspect|import|toggle|check-updates`, `POST /skills/toggle|bulk|remove|update`, `POST /refresh`, `GET /logs`. See [docs/API.md](docs/API.md).
-    npm test
-    npm run test:manager
-    npm run ci-check
-    node scripts/build-client.mjs
+## 🔒 Security
-Client source: client/client.src.js + client/ui.css → built into client/client.js (inlined CSS, classic script).
+- **No tokens stored**: git authentication stays with your credential helper or SSH key.
+- **Read-only snapshots**: imports and updates never modify your repositories.
+- **No telemetry**: no network requests besides the Git repositories you configure.
-## License
+## 📋 Requirements and limits
-MIT © 2026 Xingyu Liu
+- **Runtime**: DeepSeek Harness 0.2.x (Web or Desktop), **Node.js ≥ 22.13**
+- **Platforms**: DSH Web (`--profile web`) and DSH Desktop (`--profile desktop`)
+- **Files**: reads and writes `~/.dsh/dsh-skills-tools/`; reads the local folder only when you import one
+- **Network**: only the Git repositories you configure, during import and update checks
+- **Processes**: invokes local `git` for import and update checks
+**Known limits**
+- Manages the skills of the current DSH profile only
+- Git sources require local `git`; intranet repositories need working credentials
+- Content preview is capped at 64 KiB
+## ❓ FAQ
+| Question | Answer |
+| --- | --- |
+| No Skills section in Settings | The bundle is probably not enabled. Enable it in the plugin page, refresh, then restart `dsh web` if needed. |
+| Import fails | Complete git authentication first; verify the branch / subdirectory and that the repository contains SKILL.md files. |
+| Can the model still call a disabled skill? | No. Disabled skills are not registered. |
+| Where is the data? | `~/.dsh/dsh-skills-tools/state.json`; delete it to reset. |
+## 📄 License
+[MIT](LICENSE) · Powered by [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
+[![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)

package/README.md CHANGED Viewed

@@ -1,158 +1,138 @@
-# dsh-skills-tools
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/logo.png" width="72" height="72" alt="dsh-skills-tools" />
+</p>
-把 Agent Skills 当作可管理的资产：从 Git 仓库（GitHub、GitLab、公司内网）或本机目录导入，在 **设置 → 技能** 中随时启用、停用、更新和移除，像 Cursor 管理 Skills 一样管理 DSH 的技能目录。
+<h1 align="center">dsh-skills-tools</h1>
-- 版本：**1.0.0** · 许可：MIT · 零依赖 · 宿主 ESM + 经典脚本客户端
-- 设置入口：**设置 → 技能**（第 19 个分区，紧随 MCP 之后）
+<p align="center">
+  <b>DeepSeek Harness 的 Skills 管理器。</b><br />
+  从 Git 仓库或本机目录导入 Agent Skills，按仓库分组管理，随时启用、停用、补齐和查看内容。
+</p>
-## 为什么需要它
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-skills-tools"><img src="https://img.shields.io/npm/v/dsh-skills-tools?color=black" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/dsh-skills-tools"><img src="https://img.shields.io/npm/dm/dsh-skills-tools?color=black" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-black.svg" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D22.13-black.svg" alt="node" /></a>
+  <a href="https://github.com/hxlog/dsh-skills-tools"><img src="https://img.shields.io/badge/GitHub-hxlog%2Fdsh--skills--tools-black?logo=github" alt="GitHub" /></a>
+</p>
-Claude Code 用 **/skills** 菜单开关技能，Cursor 用 **.cursor/skills** 与插件市场分发技能，Codex 用 **skill-installer** 从 GitHub 拷贝技能目录。它们都提供「安装、查看、开关、更新、删除」这一套动作；DSH 原生的技能发现只负责扫描目录，不负责导入、快照和开关。
+<p align="center">
+  <a href="https://github.com/hxlog/dsh-skills-tools">GitHub 仓库</a> ·
+  <a href="https://www.npmjs.com/package/dsh-skills-tools">npm</a> ·
+  <a href="https://github.com/hxlog/dsh-skills-tools/issues">问题反馈</a> ·
+  <a href="README.en.md">English</a>
+</p>
-dsh-skills-tools 补上这一层：
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/skills-overview.png" width="49%" alt="按仓库分组的技能列表" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/skill-content.png" width="49%" alt="展开查看 SKILL.md 内容" />
+</p>
-1. **导入**：粘贴 Git URL（或本机目录），可指定分支、标签、提交和子目录，一次扫描全部 SKILL.md。
-2. **启用 / 停用**：开关即时生效并让 DSH 技能目录失效重载；停用的技能不会进入模型上下文。
-3. **只读快照**：仓库按提交复制到数据目录，原目录与远端永远不被修改；删除技能不会影响仓库。
-4. **按内容寻址的更新**：检查上游最新提交，确认后再切换快照。
-5. **资源完整**：技能以「目录 + resourceBase」注册，因此 ../../assets、../check/xxx 这类相对引用仍然可用。
+> 停用的技能不会注册进模型：不占上下文，也无法被误调用。
-## 安装
+## ✨ 功能
-DSH 插件（任选其一）：
+| 能力 | 说明 |
+| --- | --- |
+| **按仓库分组** | 技能按来源仓库聚合为可折叠的仓库卡片；有启用技能的仓库优先，仓库内已启用的技能优先。 |
+| **部分导入补齐** | 只导入了部分技能的仓库显示「可导入 N 个」，点「导入更多」从现有快照里勾选剩余技能，不重新克隆。 |
+| **仓库级开关** | 一键启用或停用整个仓库；部分启用时开关显示半选状态。 |
+| **展开查看内容** | 行右侧箭头展开 SKILL.md 正文、来源仓库、提交、路径与更新时间，也可就地更新或移除。 |
+| **Git 导入与快照** | 支持 https / ssh / 内网仓库、分支 / 标签 / 提交与子目录；导入的是只读快照，原目录和远端不会被修改。 |
+| **检查更新** | 对比上游最新提交，确认后再切换快照；多个仓库可一次检查。 |
-    # 已发布到 npm 后
-    dsh plugin add dsh-skills-tools
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/import-more.png" width="49%" alt="从仓库补齐剩余技能" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-skills-tools@main/docs/screenshots/import-dialog.png" width="49%" alt="导入技能" />
+</p>
-    # 本地开发
-    dsh plugin add file:D:/PythonProjects/dsh-skills-tools
+## 🚀 安装
-也可以把插件行加进 profile 的 cordis.patch.yml：
+需要 **DeepSeek Harness 0.2.x**（Web GUI `dsh web` 或 DSH Desktop）与 **Node.js ≥ 22.13**，包已发布到 npm：[dsh-skills-tools](https://www.npmjs.com/package/dsh-skills-tools)。
-    - insert:
-        - id: skills-tools
-          name: dsh-skills-tools
+> ⚠️ 这是一个 **DeepSeek Harness 插件**，不是普通 npm 依赖库：`npm i dsh-skills-tools` 只会下载包，运行时仍需装进 DSH profile。
-安装后重启 DSH，打开 **设置 → 技能**。
+**通过插件页安装（推荐）**
-## 使用
+1. 打开 DSH Web（或 DSH Desktop）→ 侧边栏 **插件**（Desktop 在 **设置 → 插件**）。
+2. 点击安装，填入 `dsh-skills-tools`，确认。
+3. 启用新 bundle，刷新页面，打开 **设置 → 技能**。
-### 导入技能
+**通过命令行安装**
-1. 点击右上角 **导入技能**。
-2. 填写 **仓库 URL 或本机目录**，例如 https://code.comein.cn/ai/luban.git 或 D:/work/my-skills。
-3. 可选：填写分支 / 标签 / 提交（例如 pro），或子目录（例如 skills）缩小扫描范围。
-4. 点击 **扫描**，勾选要安装的技能；重名项会自动给出建议名称（可修改）。
-5. 点击 **安装选中**。安装即启用。
+```bash
+dsh plugin add dsh-skills-tools                    # 默认 profile
+dsh plugin --profile web add dsh-skills-tools      # Web
+dsh plugin --profile desktop add dsh-skills-tools  # Desktop
+```
-支持的地址形式：
+当前版本 **1.1.0**：按仓库分组、仓库级开关、从快照补齐剩余技能。
-- https://host/owner/repo、https://host/owner/repo.git
-- https://host/owner/repo/tree/<ref>/<subdir>（GitHub 风格）
-- git@host:owner/repo.git（SSH）
-- file:///path/to/repo
-- 本机绝对路径（会复制快照，不修改原目录）
+> 升级包版本后需要重启 `dsh web` / 重启 DSH Desktop。
+>
+> `dsh plugin add` 只负责把包装进 profile，**不会自动启用 bundle**：装完请在插件页启用一次，或确认 profile 的 `dsh.profile.bundles` 已包含 `dsh-skills-tools`。
-### 启用、停用与批量操作
+## ⚡ 快速开始
-- 行首开关：即时启用或停用单个技能。
-- 工具栏：全部启用、全部停用。
-- 搜索：按名称、描述、路径或仓库过滤；筛选：全部 / 已启用 / 已停用。
-- 展开行：查看 SKILL.md 原文、来源、提交、快照路径，执行「从上游更新」「移除」「复制路径」。
+1. **设置 → 技能 → 导入技能**：粘贴 Git 地址（支持 `https://`、`git@`、`file://` 与本机绝对路径），内网仓库直接使用本机 git 凭据。
+2. 可选填**分支 / 标签 / 提交**与**子目录**，点 **扫描**；勾选要安装的技能，重名项会给出可修改的建议名称，点 **安装选中**。安装即启用。
+3. 回到列表按仓库管理：仓库开关批量启停，行开关控制单个技能，「导入更多」补齐同仓库剩余技能，点右侧箭头查看正文。
-### 更新与移除
+## 🧩 工作原理
-- **检查更新**：对每个仓库执行 git ls-remote，标记有新提交的技能。
-- **从上游更新**：重新克隆并生成新快照；快照只在成功后切换，失败不会破坏现有可用状态。
-- **移除**：从技能库删除；当仓库的最后一个技能被移除时，旧快照会被清理。
+```
+~/.dsh/dsh-skills-tools/
+├── state.json                 仓库、技能、启用状态与检查时间
+└── repos/<仓库>-<提交>/        只读快照
+```
-## 内网与私有仓库
+- **快照隔离**：每次导入或更新把仓库复制到数据目录，删除技能只删状态，不影响仓库与快照。
+- **注册即生效**：启用状态决定技能是否注册进 DSH 技能目录；停用即从模型上下文移除。
+- **REST 接口**：`GET /skills-tools/api/state`、`POST /import/scan|commit`、`POST /repos/inspect|import|toggle|check-updates`、`POST /skills/toggle|bulk|remove|update`、`POST /refresh`、`GET /logs`；详见 [docs/API.md](docs/API.md)。
-插件不保存任何令牌，直接复用本机 git 凭据：
+## 🔒 安全说明
-- HTTPS：系统 credential helper 已缓存的账号或令牌；
-- SSH：本机 SSH key / agent。
+- **不保存令牌**：Git 认证交给本机 credential helper 或 SSH key，插件只调用 `git`。
+- **只读快照**：导入与更新都写入数据目录，你的仓库目录与远端不会被修改。
+- **无遥测**：除你填写的仓库地址外不发起任何网络请求。
-克隆时设置 GIT_TERMINAL_PROMPT=0，凭据缺失会立即失败并提示，不会卡住设置页。
+## 📋 前置要求与权限边界
-## 架构
+- **运行环境**：DeepSeek Harness 0.2.x（Web `dsh web` 或 DSH Desktop），**Node.js ≥ 22.13**
+- **支持平台**：DSH Web（`--profile web`）、DSH Desktop（`--profile desktop`）
+- **文件访问**：读写插件数据目录 `~/.dsh/dsh-skills-tools/`；导入本机目录时只读取该目录
+- **网络**：仅在导入、检查更新时访问你填写的 Git 仓库
+- **进程**：导入 / 检查更新时调用本机 `git`
+- **UI 注入**：设置页「设置 → 技能」面板，依赖 `@deepseek-ai/dsh-client-ui-settings` 与 `@deepseek-ai/dsh-client-locale`
-    Git 仓库 / 本机目录
-          │ git clone --depth 1 --single-branch (或直接读取)
-          ▼
-    $DSH_HOME/dsh-skills-tools/repos/<slug>-<commit>   只读快照
-          │ 扫描 SKILL.md（跳过 .git、符号链接；深度与文件数有上限）
-          ▼
-    $DSH_HOME/dsh-skills-tools/state.json              仓库 + 技能 + enabled
-          │ ctx.skills.registerProvider(rank 350)
-          ▼
-    DSH 技能目录（仅 enabled 且文件存在的技能）
+**已知限制**
-- provider 名称：dsh-skills-tools，rank 350（低于项目级 100/200，高于用户级 400/500，因此同名时项目技能优先，管理器技能优先于用户目录技能）。
-- 每个技能以 resourceBase = { kind: "directory", path: <快照>/<技能目录> } 注册，所以 SKILL.md 里的相对资源引用可用。
-- 状态读取带 mtime 记忆；跨进程写入使用目录锁 + 临时文件原子替换，多个 DSH 窗口共享同一份状态。
-- 前端只做展示与调用，不直接读写文件。
+- 只管理当前 DSH profile 的技能，切换 profile 需重新导入
+- Git 来源需要本机安装 `git`；内网仓库需要事先配置好凭据
+- 技能内容预览最多 64 KiB，超出部分以省略号截断
-## 数据目录
+## ❓ 常见问题
-    $DSH_HOME/dsh-skills-tools/
-      state.json        技能与仓库状态
-      logs.jsonl        最近操作日志（环形缓冲 300 条）
-      repos/            只读快照
-      tmp/              扫描与更新的临时克隆（自动清理）
-      state.lock        写入锁（瞬时）
+| 问题 | 处理 |
+| --- | --- |
+| 设置里没有「技能」分区 | 多半是 bundle 未启用：插件页确认并刷新，必要时重启 `dsh web`。 |
+| 导入失败 | 内网仓库先在本机完成 git 认证；确认分支 / 子目录填写正确、仓库中存在 SKILL.md。 |
+| 停用后模型还能调用吗 | 不能。停用的技能不会出现在模型工具列表中。 |
+| 数据文件在哪 | `~/.dsh/dsh-skills-tools/state.json`；删除即重置，下次启动自动重建。 |
-DSH_HOME 默认为 ~/.dsh（Windows 为 %USERPROFILE%\.dsh）。
+## 🛠 开发
-## 安全
+```bash
+git clone https://github.com/hxlog/dsh-skills-tools.git
+cd dsh-skills-tools
+node scripts/build-client.mjs   # 构建 client/client.js
+npm test                        # 静态检查
+npm run test:manager            # 离线 manager 集成测试
+```
-- 所有管理接口位于 /skills-tools/api，先经过 DSH connection.requestRejection 的 Host/Origin/会话校验，其他本地进程无法直接驱动。
-- 请求体上限 256 KiB；快照上限 20000 文件 / 300 MiB；单文件 SKILL.md 上限 2 MiB。
-- 快照不跟随符号链接，路径必须落在快照目录内；删除操作校验目标位于 repos 之下。
-- 技能内容按原样呈现，不执行仓库中的脚本；git 命令以参数数组启动，不经过 shell。
-- 不写入仓库，不修改 SKILL.md，不调用远端 API（只有 git 传输本身）。
+## 📄 License
-## HTTP API
+[MIT](LICENSE) · Powered by [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
-前缀 /skills-tools/api，全部返回 JSON；失败为 { "ok": false, "error": "..." }。
-| 方法 | 路径 | 说明 |
-| --- | --- | --- |
-| GET | /state | 技能、仓库、统计、事件、数据目录 |
-| GET | /logs?limit=100 | 最近操作 |
-| POST | /import/scan | { url, ref?, subdir? } 克隆并扫描 |
-| POST | /import/commit | { scanId, skills: [{ relPath, name }] } 安装 |
-| POST | /skills/toggle | { name, enabled } |
-| POST | /skills/bulk | { action: all / none / invert } |
-| POST | /skills/remove | { name } |
-| POST | /skills/update | { name } 从上游更新所属仓库 |
-| POST | /repos/check-updates | 检查所有仓库最新提交 |
-| POST | /refresh | 重新解析本地 SKILL.md |
-| GET | /skills/content?name= | SKILL.md 原文（上限 64 KiB） |
-详见 docs/API.md。
-## 开发
-    npm test              # 离线 smoke：frontmatter、manager、provider、客户端 bundle
-    npm run test:manager  # 管理流程集成测试（临时 DSH_HOME + 本地 fixture 仓库）
-    npm run ci-check      # manifest / patch / ESM / 客户端 / i18n 契约检查
-    node scripts/build-client.mjs   # 修改 client/ui.css 后重新内联
-客户端源码为 client/client.src.js + client/ui.css，构建产物是 client/client.js（内联 CSS、经典脚本、无模块语法）。CI 会校验产物可被 vm.Script 解析。
-## 与原生技能的关系
-- 原生发现（dsh-skill-filesystem）继续工作；本项目只是额外的 provider。
-- 同名时按 rank 竞争：项目级技能（100/200）优先于本 provider（350），本 provider 优先于用户目录（400/500）。
-- 停用只影响本 provider 注册的技能，不会移动或修改原生目录中的文件。
-## 已知限制
-- 同名技能的最终名称由导入时决定；DSH 注册表以 name 去重，同名冲突需要在导入对话框里改名。
-- 一个仓库只跟踪一个 ref；需要多分支并存时，请分别以不同子目录或不同仓库导入。
-- 快照是完整仓库副本；超大 monorepo 请用子目录扫描并在导入前确认体量。
-## License
-MIT © 2026 Xingyu Liu
+[![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)