dsh-skill-importer 0.1.2 → 0.2.0

package/README.md

@@ -26,7 +26,7 @@
 
 | Import | Organize | Invoke |
 | :--- | :--- | :--- |
-| Upload `SKILL.md` or paste a URL. Frontmatter is validated and normalized before writing. | Browse skills grouped across project, legacy project, and global roots. Remove any copy individually. | Use the composer picker, run `/skills`, or type `/skill-name` directly. |
+| Upload `SKILL.md`, paste a URL, or migrate a complete skills directory from Claude Code, Codex, and similar agents. | Browse skills grouped across project and global roots. Remove any copy individually. | Use the composer picker, run `/skills`, or type `/skill-name` directly. |
 
 ### Built for a fast loop
 
@@ -37,6 +37,12 @@
 - **Bilingual UI** — English and Chinese copy follows the harness locale.
 - **Safe by design** — fixed skill roots, 256 KB limit, and same-origin POST checks.
 
+### Batch migration with a real preflight
+
+The third import entry accepts a local skills root such as `~/.claude/skills`, `~/.codex/skills`, or another `.agents/skills` directory. It scans before it writes, validates every `SKILL.md`, preserves each skill's `scripts`, `references`, `assets`, and other resources, and reports invalid entries without touching the destination.
+
+Destination name conflicts are skipped by default. Choose **Replace** per skill, review the add/replace/skip summary, then confirm. Each accepted skill is copied through a same-root staging directory; replacements keep a temporary backup and roll back if the swap fails. A preflight is single-use, expires after ten minutes, and verifies source-content fingerprints again at commit time.
+
 ## Three natural ways to use a skill
 
 1. **Composer picker** — open the pill beside the access-mode selector, search by name, and choose.
@@ -64,7 +70,7 @@ Add the following entry to `$DSH_HOME/profiles/web/cordis.patch.yml`:
 
 ### 3. Restart dsh Web
 
-Open **Settings → Skills**. Import a Markdown file or URL, choose a target, and the skill will appear as soon as the filesystem watcher discovers it.
+Open **Settings → Skills**. Import a Markdown file or URL, or choose **Batch import** to migrate another agent's complete skills directory. Choose a target and the imported skills will appear as soon as the filesystem watcher discovers them.
 
 > Requires DeepSeek Harness `>= 0.1.0-rc.6` via `npx @deepseek-ai/dsh web`.
 
@@ -90,7 +96,6 @@ POST routes verify the `Origin` header and only accept loopback sources (`127.0.
 | Scope | Directory |
 | :--- | :--- |
 | Project | `.agents/skills` |
-| Legacy project | `.dsh/skills` |
 | Global | `~/.dsh/skills` |
 
 ## Development
@@ -109,7 +114,7 @@ npm run build
 | Composer picker | `src/client/SkillsPicker.tsx` |
 | Settings experience | `src/client/SkillImporterSection.tsx` |
 
-Available routes: `GET /skill-importer/health` · `GET /skill-importer/list` · `POST /skill-importer/import` · `POST /skill-importer/import-url` · `POST /skill-importer/delete`
+Available routes: `GET /skill-importer/health` · `GET /skill-importer/list` · `POST /skill-importer/import` · `POST /skill-importer/import-url` · `POST /skill-importer/delete` · `POST /skill-importer/batch/scan` · `POST /skill-importer/batch/commit`
 
 ### Local checkout
 
@@ -124,6 +129,7 @@ Add the profile entry shown above, then restart dsh Web.
 ## Notes
 
 - A single imported file may be up to 256 KB.
+- Batch import accepts up to 200 skills per scan; each skill may contain up to 2,000 files and 10 MB of resources. Symbolic links are refused.
 - URL import preserves `.md` sources; HTML pages use lightweight text extraction, so direct Markdown URLs work best.
 - The installed list polls briefly after import (every 2 seconds for up to 20 seconds). **Refresh** syncs external changes immediately.
 

package/README.zh.md

@@ -26,7 +26,7 @@
 
 | 导入 | 管理 | 调用 |
 | :--- | :--- | :--- |
-| 上传 `SKILL.md` 或粘贴 URL，写入前自动校验并规范化 frontmatter。 | 按项目、旧版项目和全局目录分组查看，每个副本都能独立删除。 | 使用输入框选择器、运行 `/skills`，或直接输入 `/skill-name`。 |
+| 上传 `SKILL.md`、粘贴 URL，或从 Claude Code、Codex 等 Agent 的技能目录完整迁移。 | 按项目和全局目录分组查看，每个副本都能独立删除。 | 使用输入框选择器、运行 `/skills`，或直接输入 `/skill-name`。 |
 
 ### 为高速工作流而生
 
@@ -37,6 +37,12 @@
 - **中英双语** — UI 文案自动跟随 harness 语言。
 - **安全边界清晰** — 固定技能目录、256 KB 限制、同源 POST 校验。
 
+### 带完整预检的批量迁移
+
+第三个导入入口支持选择 `~/.claude/skills`、`~/.codex/skills` 或其他 `.agents/skills` 目录。写入前会扫描并校验每个 `SKILL.md`，同时完整保留技能的 `scripts`、`references`、`assets` 等资源；不合规项只展示错误，绝不会写入目标目录。
+
+目标中存在同名技能时默认跳过。用户可逐项勾选「替换」，检查新增、替换和跳过数量后再确认。每个技能先复制到目标根目录下的临时目录；替换时会暂存旧版本，交换失败自动回滚。扫描结果只能提交一次、十分钟后过期，并在提交时重新核对源内容摘要。
+
 ## 三种自然的技能入口
 
 1. **输入框选择器** — 点击权限模式旁边的 pill，按名称搜索并选中。
@@ -64,7 +70,7 @@ dsh plugin --profile web add dsh-skill-importer
 
 ### 3. 重启 dsh Web
 
-打开 **设置 → 技能**，选择 Markdown 文件或粘贴 URL，再选择目标目录。文件系统 watcher 发现后，技能会立即出现。
+打开 **设置 → 技能**，选择 Markdown 文件、粘贴 URL，或通过「批量导入」迁移其他 Agent 的完整技能目录，再选择目标范围。文件系统 watcher 发现后，技能会立即出现。
 
 > 需要 DeepSeek Harness `>= 0.1.0-rc.6`，使用 `npx @deepseek-ai/dsh web` 运行。
 
@@ -85,12 +91,11 @@ Markdown 文件或 URL
 skills/change → 热刷新
 ```
 
-所有 POST 路由都会校验 `Origin`，仅接受 loopback 来源（`127.0.0.1` 或 `localhost`）。写入范围固定为三个标准目录：
+所有 POST 路由都会校验 `Origin`，仅接受 loopback 来源（`127.0.0.1` 或 `localhost`）。写入范围固定为两个标准目录：
 
 | 范围 | 目录 |
 | :--- | :--- |
 | 项目 | `.agents/skills` |
-| 旧版项目 | `.dsh/skills` |
 | 全局 | `~/.dsh/skills` |
 
 ## 开发
@@ -109,7 +114,7 @@ npm run build
 | 输入框技能选择器 | `src/client/SkillsPicker.tsx` |
 | 设置页 | `src/client/SkillImporterSection.tsx` |
 
-路由一览：`GET /skill-importer/health` · `GET /skill-importer/list` · `POST /skill-importer/import` · `POST /skill-importer/import-url` · `POST /skill-importer/delete`
+路由一览：`GET /skill-importer/health` · `GET /skill-importer/list` · `POST /skill-importer/import` · `POST /skill-importer/import-url` · `POST /skill-importer/delete` · `POST /skill-importer/batch/scan` · `POST /skill-importer/batch/commit`
 
 ### 本地源码安装
 
@@ -124,6 +129,7 @@ dsh plugin --profile web add /path/to/dsh-skill-importer
 ## 注意事项
 
 - 单个导入文件最大 256 KB。
+- 批量导入每次最多扫描 200 个技能；单个技能最多包含 2,000 个文件和 10 MB 资源，不接受符号链接。
 - URL 导入会原样保留 `.md`；HTML 页面仅做轻量正文提取，因此推荐使用 Markdown 直链。
 - 导入后列表会短暂轮询（每 2 秒一次，最多 20 秒）；外部改动可点击 **刷新** 立即同步。