dsh-agent-skills 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# dsh-agent-skills
+
+[![npm](https://img.shields.io/npm/v/dsh-agent-skills)](https://www.npmjs.com/package/dsh-agent-skills)
+[![license](https://img.shields.io/npm/l/dsh-agent-skills)](./LICENSE)
+[![DeepSeek Harness plugin](https://img.shields.io/badge/DSH-plugin-4f46e5)](https://github.com/deepseek-ai/deepseek-harness)
+
+把 Claude Code、Codex、Gemini CLI、Cursor 等工具的本地 Agent Skills 接入 DeepSeek Harness，并在「设置 → Agent Skills」里统一查看、启停和管理。
+
+## 它解决什么问题
+
+很多 AI 编程工具都使用 `<技能名>/SKILL.md`，但技能分散在不同目录。`dsh-agent-skills` 会自动发现这些目录，把有效技能汇总进 DSH，并提供一个可视化设置页：
+
+- 自动发现 `~/.agents/skills`、`~/.claude/skills`、`~/.codex/skills`、`~/.gemini/skills` 等常用目录。
+- 支持添加任意自定义技能目录。
+- 显示每个来源是否存在、包含多少有效技能，以及技能名称和描述。
+- 可按目录或单个技能启停；变更会持久化，并在下一次 Agent step 生效。
+- 监听技能文件变化，也可随时手动重新扫描。
+- 不修改原始 `SKILL.md` 文件。
+
+## 安装
+
+### 方式一：DSH 插件市场（推荐）
+
+打开 DSH 的「设置 → 插件市场」，搜索 **Agent Skills**，点击安装。市场会优先使用 npm 包，安装速度快，也不需要在本机重新构建。
+
+安装后重启一次 DSH Web，再打开「设置 → Agent Skills」。
+
+### 方式二：从 npm 安装
+
+```bash
+dsh plugin --profile web add dsh-agent-skills
+```
+
+为了让技能开关覆盖 `standard` 和 `code` Agent preset 中的 filesystem provider，还需安装一次 preset-only 行：
+
+```bash
+DSH_INSTALL_ROOT="$(npm root -g)/@deepseek-ai/dsh" \
+  node ~/.dsh/profiles/web/node_modules/dsh-agent-skills/scripts/install-preset.mjs
+```
+
+然后重启 DSH Web。这个 preset 入口只注册 scoped skill provider，不会在 Agent preset 中创建 `agentSkills` host 服务。
+
+### 方式三：从 GitHub 安装
+
+```bash
+dsh plugin --profile web add github:minivv/dsh-agent-skills
+```
+
+仓库包含 `prepare: npm run build`，因此 pnpm 会在 Git 安装时自动构建。DSH/pnpm 可能会要求你授权构建脚本；不想授权构建时请使用 npm 或插件市场版本，npm 包已经包含构建好的 `lib/`。
+
+## 使用
+
+1. 打开 DSH Web。
+2. 进入「设置 → Agent Skills」。
+3. 检查自动发现的来源，或点击「+ 添加目录」。
+4. 使用来源开关或技能开关控制 Agent 可见范围。
+5. 修改磁盘上的技能后，点击「重新扫描」或等待自动刷新。
+
+插件状态保存在：
+
+```text
+$DSH_HOME/agent-skills/state.json
+```
+
+支持的目录结构：
+
+```text
+skills/
+├── my-skill/
+│   └── SKILL.md
+└── another-skill.md
+```
+
+`SKILL.md` 需要 YAML frontmatter，`name` 必须使用小写 kebab-case：
+
+```markdown
+---
+name: my-skill
+description: Explain when this skill should be used.
+---
+
+# Instructions
+```
+
+## 卸载
+
+如果安装过 preset-only 行，请先清理它，再卸载 npm 包：
+
+```bash
+DSH_INSTALL_ROOT="$(npm root -g)/@deepseek-ai/dsh" \
+  node ~/.dsh/profiles/web/node_modules/dsh-agent-skills/scripts/uninstall-preset.mjs
+
+dsh plugin --profile web remove dsh-agent-skills
+```
+
+最后重启 DSH Web。插件不会自动删除 `$DSH_HOME/agent-skills/state.json`，方便以后重装时保留设置。
+
+## 开发
+
+要求 Node.js 20+。
+
+```bash
+npm install
+npm run typecheck
+npm run build
+npm pack --dry-run
+```
+
+- `src/index.ts`：host 入口，提供设置页 remote service 和全局 provider。
+- `src/preset.ts`：preset-only 入口，只注册 scoped provider。
+- `src/client/`：设置页 UI。
+- `src/scan.ts`：技能目录扫描和 frontmatter 解析。
+- `lib/`：已提交的构建产物，供 npm 和免构建安装使用。
+
+## 已知约束
+
+- DSH 技能名必须匹配 `[a-z0-9]+(?:-[a-z0-9]+)*`。
+- 修改插件安装或 preset 组合后需要重启一次；技能启停和重新扫描不需要重启。
+- DSH 升级可能覆盖其内置 preset 文件；如开关不再生效，重新运行 `scripts/install-preset.mjs`。
+
+## 相关链接
+
+- [GitHub](https://github.com/minivv/dsh-agent-skills)
+- [npm](https://www.npmjs.com/package/dsh-agent-skills)
+- [WeiSpot 项目页](https://weispot.vercel.app/projects/dsh-agent-skills)
+
+## License
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+# The dsh-agent-skills bundle patch: mounts the plugin's host half as one
+# Cordis loader row. The same row is also the browser roster row (the plugin
+# declares `dsh.client`), so the client half is discovered from it by the
+# client-modules node half. Apply this bundle after `dsh-base` + `dsh-web-app`,
+# which provide `loader` (base) and the web settings shell; the plugin's own
+# `inject` resolves against those.
+#
+# The per-agent PRESET row (which registers the skill provider into the
+# agent-preset layer of the skill registry) is appended by
+# scripts/install-preset.mjs — see README.
+- insert:
+    - id: agent-skills
+      name: dsh-agent-skills