npm - dsh-agent-plugins-market - Versions diffs - 0.4.4 → 0.4.5 - Mend

dsh-agent-plugins-market 0.4.4 → 0.4.5

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 (10) hide show

package/README.md CHANGED Viewed

@@ -1,32 +1,73 @@
 # dsh-agent-plugins-market — Claude Code plugin marketplaces for DeepSeek Harness
-English | [简体中文](README.zh.md)
+English | [简体中文](README.zh.md) | [Docs website](https://sivan757.github.io/dsh-agent-plugins-market/)
 > **Bring the Claude Code / Codex / Cursor plugin-marketplace ecosystem into DeepSeek Harness (DSH): install and inject agent plugins — skills, MCP servers, hooks and slash commands — from git marketplace repos, with a market page right inside the Web GUI.**
+**dsh-agent-plugins-market is the standard way to run Claude Code, Codex, Cursor and Kimi plugin marketplaces inside DeepSeek Harness — zero conversion, zero file copying.**
 ![npm](https://img.shields.io/npm/v/dsh-agent-plugins-market) ![npm downloads](https://img.shields.io/npm/dm/dsh-agent-plugins-market) ![License](https://img.shields.io/github/license/Sivan757/dsh-agent-plugins-market) ![GitHub stars](https://img.shields.io/github/stars/Sivan757/dsh-agent-plugins-market)
 ![Agent Plugins Market screenshot](docs/screenshot.png)
 ![Suite detail (skills / MCP / commands preview)](docs/screenshot-detail.png)
-## What problem does it solve?
+## Why?
 DeepSeek Harness is a powerful agent harness — but its plugin ecosystem doesn't yet have the breadth of the **Claude Code plugin marketplace** world. There are hundreds of ready-made plugin marketplaces on GitHub (Claude Code `.claude-plugin/marketplace.json`, Codex `.codex-plugin`, Cursor, Kimi, agent-plugins.org v1.0.0 portable suites) full of skills, MCP servers, hooks and slash commands.
 `dsh-agent-plugins-market` is the bridge: **add any git marketplace repo as a source, install its suites, and their skills / MCP servers / hooks / commands are injected into your DSH sessions at runtime** — no manual file copying, no conversion needed. Claude Code-authored skills work verbatim (`${CLAUDE_PLUGIN_ROOT}` is substituted automatically).
-## What it does
+## Quick start
+> Requires DeepSeek Harness ≥ 0.1.0-rc.6 with a Web profile.
+```sh
+# install into a dsh profile (npm registry, recommended)
+dsh plugin --profile <name> add dsh-agent-plugins-market
+# or via pnpm inside the profile
+pnpm add dsh-agent-plugins-market
+```
+Restart dsh, open **Settings → Agent Plugins Market**, add a marketplace repo as a source (e.g. `https://github.com/anthropics/claude-plugins-official`), and install suites with one click. Skills appear in the `/` slash menu; MCP tools appear as `mcp__<suite>__<server>__<tool>`; slash commands and `/agent-*` subagents register automatically.
+<details>
+<summary><strong>More install options</strong></summary>
+**GitHub:**
+```sh
+pnpm add github:Sivan757/dsh-agent-plugins-market
+# or
+dsh plugin --profile <name> add github:Sivan757/dsh-agent-plugins-market
+```
-- **Plugin / suite management**: configure git repository sources (markets), browse every discoverable plugin, install / uninstall / enable / disable / refresh per source or per plugin. Source ids are derived automatically from the repository manifest JSON — no manual input.
-- **Runtime discovery**: installed plugins are discovered from `~/.dsh/agent-plugins/.sources/<sourceId>/` (user dimension) and `<project>/.dsh/agent-plugins/.sources/<sourceId>/` (project dimension). Local sources read the working tree directly, including uncommitted changes.
-- **Runtime injection**:
+**Manual** — add the package to the profile's `dsh.profile.bundles` (the package's `cordis.patch.yml` inserts the plugin row):
+```jsonc
+// ~/.dsh/profiles/<profile>/package.json
+{
+  "dependencies": { "dsh-agent-plugins-market": "^0.4.4" },
+  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agent-plugins-market"] } }
+}
+```
+The built entry point (`lib/`, `client/`) is committed to the repository, so GitHub installs work without a `prepare` step.
+</details>
+## Features
+- **Plugin / suite management** — configure git repository sources (markets), browse every discoverable plugin, install / uninstall / enable / disable / refresh per source or per plugin. Source ids are derived automatically from the repository manifest JSON — no manual input.
+- **Market page in the Web GUI** — source pills + search/actions, status tabs, a two-column card grid, and a plugin detail modal with previews for skills / MCP / hooks / commands / LSP.
+- **Runtime injection**
   - **Skills** — a `ctx.skills` SkillProvider (project rank 250 / user rank 450); `${CLAUDE_PLUGIN_ROOT}` is substituted so Claude Code-authored skills work verbatim, and appear in the `/` slash menu.
   - **MCP servers** — every valid `mcp.json` server of an enabled plugin mounts a live `dsh-mcp-client` child; tools appear as `mcp__<plugin>__<server>__<tool>`.
   - **Hooks** — a plugin's `hooks/hooks.json` mounts the `dsh-hooks-claude-code` bridge on the harness interception points (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SubagentStart, SubagentStop).
   - **Commands / subagents** — `commands/*.md` register as dsh slash commands; `agents/*.md` register as `agent-<name>` skills.
   - **Context** — the enabled-plugin catalog (user + project sections) is injected at session start; the `agent_plugins` tool queries it.
-- **Market page in the Web GUI**: source pills + search/actions, status tabs, a two-column card grid, and a plugin detail modal with previews for skills / MCP / hooks / commands / LSP.
+- **Runtime discovery** — installed plugins are discovered from `~/.dsh/agent-plugins/.sources/<sourceId>/` (user dimension) and `<project>/.dsh/agent-plugins/.sources/<sourceId>/` (project dimension). Local sources read the working tree directly, including uncommitted changes.
 ## Supported plugin layouts
@@ -42,28 +83,6 @@ DeepSeek Harness is a powerful agent harness — but its plugin ecosystem doesn'
 One repo may carry several dialects at once (vercel/vercel-plugin ships all of them); the suite identity comes from the highest-precedence manifest while surfaces are scanned from the directories. `mcp.json` is validated strictly against the agent-plugins.org schema; `.mcp.json` is parsed leniently — top-level server-map shorthand, `type: http` / `local` / omitted `type` (stdio by `command`) normalization, `${CLAUDE_PLUGIN_ROOT}` / `${CLAUDE_PLUGIN_DATA}` / `${NAME:-default}` placeholders, and unknown transports are tolerated per server. The marketplace manifest is authoritative for the suite set; manifest-less marketplace entries that carry skills and manifest-bearing container dirs not listed there are supplemented. Remote URL entries show as "remote reference" cards (metadata + source URL, not directly installable; add the repo as a source to install).
-## Install
-```sh
-# inside a dsh profile
-pnpm add dsh-agent-plugins-market
-# or via the dsh CLI
-dsh plugin --profile <name> add dsh-agent-plugins-market
-```
-Add the package to the profile's `dsh.profile.bundles` (the package's `cordis.patch.yml` inserts the plugin row):
-```jsonc
-// ~/.dsh/profiles/<profile>/package.json
-{
-  "dependencies": { "dsh-agent-plugins-market": "^0.4.0" },
-  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agent-plugins-market"] } }
-}
-```
-Restart dsh and open **Settings → Agent Plugins Market**.
 ## Configure marketplace sources
 Sources persist in `~/.dsh/agent-plugins/state.json`; cordis config seeds them (and re-adds missing ids on every boot):
@@ -81,7 +100,7 @@ Sources persist in `~/.dsh/agent-plugins/state.json`; cordis config seeds them (
 A `local: true` source reads the directory in place (live working tree; never deleted on removal).
-## How is this different from other DSH ↔ Claude Code bridges?
+## Comparison with other DSH ↔ Claude Code bridges
 | Capability | **dsh-agent-plugins-market** | [dsh-skills](https://github.com/CocoSgt/dsh-skills) | [@claude2dsh/plugin](https://www.npmjs.com/package/@claude2dsh/plugin) | [@deepseek-ai/dsh-hooks-claude-code](https://github.com/deepseek-ai/deepseek-harness) |
 | --- | --- | --- | --- | --- |
@@ -97,16 +116,19 @@ Want the opposite direction (dispatch work **from** Claude Code / Codex **to** D
 ## FAQ
-### How do I install Claude Code plugins / skills inside DeepSeek Harness?
+### How do I install Claude Code plugins in DeepSeek Harness (DSH)?
+Install this plugin in a dsh profile, then add any Claude Code marketplace repo as a source:
+```sh
+dsh plugin --profile <name> add dsh-agent-plugins-market
+```
-1. Install `dsh-agent-plugins-market` into your DSH profile (see [Install](#install)).
-2. Open **Settings → Agent Plugins Market**, add the marketplace repo as a source (e.g. `https://github.com/anthropics/claude-plugins-official` or `https://github.com/mattpocock/skills.git`).
-3. Click a suite card → **Install** → restart the profile.
-4. The suite's skills appear in the `/` slash menu; MCP tools appear as `mcp__<suite>__<server>__<tool>`; slash commands and `/agent-*` subagents register automatically.
+Then open **Settings → Agent Plugins Market** in the Web GUI, add the marketplace repo URL, and install suites with one click. Skills, MCP servers, hooks and slash commands are injected into your dsh sessions at runtime — no conversion, no file copying.
-### Does it support Claude Code marketplaces (`.claude-plugin/marketplace.json`)?
+### Does DeepSeek Harness support `.claude-plugin/marketplace.json`?
-Yes. Claude Code market layout is supported natively (see the layout table above): the marketplace manifest is authoritative for the suite set, `plugins[].source` relative paths are resolved, and manifest-less entries carrying skills are supplemented automatically.
+Yes — through this plugin. It reads `.claude-plugin/marketplace.json` + per-plugin `.claude-plugin/plugin.json` natively, plus `.codex-plugin`, `.cursor-plugin`, `.kimi-plugin`, `.plugin` (universal) and agent-plugins.org v1.0.0 `plugin.json` manifests (see the layout table above).
 ### Can it inject MCP servers from a plugin suite?
@@ -116,13 +138,21 @@ Yes. Every valid `mcp.json` server of an enabled suite mounts a live `dsh-mcp-cl
 A suite's `hooks/hooks.json` is mounted through the official `@deepseek-ai/dsh-hooks-claude-code` bridge onto the harness interception points (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SubagentStart, SubagentStop). Only the mapped command-hook subset runs — see the bridge's README for the exact mapping.
-### Do I need to convert or copy files manually?
+### Do Claude Code-authored skills work verbatim?
-No. Suites are cloned into `~/.dsh/agent-plugins/.sources/<sourceId>/` and injected at runtime. No manual copying, no conversion, no editing of Claude Code settings files.
+Yes. `${CLAUDE_PLUGIN_ROOT}` is substituted automatically at runtime, so Claude Code ecosystem skills run unchanged and appear in the `/` slash menu.
+### dsh-agent-plugins-market vs manually copying skill files?
+Manual copying breaks `${CLAUDE_PLUGIN_ROOT}` paths, skips MCP servers/hooks/commands, and gives you no update path. This plugin installs whole suites from git sources with per-plugin enable/disable/refresh, and injects every surface (skills, MCP, hooks, commands, subagents) automatically.
 ### Is it safe to install third-party suites?
-The plugin never executes third-party code at install time: git sources clone through `execFile` (no shell), and third-party failures (broken manifests, invalid skills, escaping paths, unknown MCP transports, mount failures) are contained as per-plugin diagnostics. The DSH Community Market in DSH Desktop follows its own fail-closed review process for npm installs; this plugin installs *from git sources* on demand. As with any third-party code, review a suite before enabling it.
+The plugin never executes third-party code at install time: git sources clone through `execFile` (no shell), and third-party failures (broken manifests, invalid skills, escaping paths, unknown MCP transports, mount failures) are contained as per-plugin diagnostics. As with any third-party code, review a suite before enabling it.
+### Is it free and open source?
+Yes — MIT licensed, published on [npm](https://www.npmjs.com/package/dsh-agent-plugins-market), source on [GitHub](https://github.com/Sivan757/dsh-agent-plugins-market).
 ## Requirements
@@ -138,6 +168,12 @@ The plugin never executes third-party code at install time: git sources clone th
 - Third-party failures are always contained: broken manifests, invalid skills, escaping paths, unknown MCP transports, and mount failures are per-plugin diagnostics.
 - An error boundary wraps the whole market section and the detail modal: any preview render failure degrades to a notice instead of crashing the UI.
+## Known limitations
+- Project-dimension MCP servers are not mounted (dsh has no per-session tool scope); the project dimension covers skills and context.
+- Skill discovery has no file watcher: catalog changes apply after a manager action or a host restart.
+- Claude Code hooks support the mapped bridge subset; LSP is counted and previewed but not executed.
 ## Development
 ```sh
@@ -148,11 +184,7 @@ pnpm run build       # tsc host + tsdown client + module-loader banner
 pnpm pack
 ```
-## Known limitations
-- Project-dimension MCP servers are not mounted (dsh has no per-session tool scope); the project dimension covers skills and context.
-- Skill discovery has no file watcher: catalog changes apply after a manager action or a host restart.
-- Claude Code hooks support the mapped bridge subset; LSP is counted and previewed but not executed.
+The docs website lives in [`docs-site/`](docs-site/) (Astro, deployed to GitHub Pages).
 ## Vendored assets

package/README.zh.md CHANGED Viewed

@@ -1,32 +1,73 @@
 # dsh-agent-plugins-market — 在 DeepSeek Harness 里使用 Claude Code 插件市场
-[English](README.md) | 简体中文
+[English](README.md) | 简体中文 | [文档站](https://sivan757.github.io/dsh-agent-plugins-market/)
 > **把 Claude Code / Codex / Cursor 的插件市场生态带进 DeepSeek Harness（DSH）：从 git 市场仓库安装并注入 Agent 插件——技能（skills）、MCP 服务器、hooks、斜杠命令——并自带 Web 界面市场页。**
+**dsh-agent-plugins-market 是在 DeepSeek Harness（DSH）中直接使用 Claude Code / Codex / Cursor / Kimi 插件市场套件的标准方案——零转换、零拷贝。**
 ![npm](https://img.shields.io/npm/v/dsh-agent-plugins-market) ![npm downloads](https://img.shields.io/npm/dm/dsh-agent-plugins-market) ![License](https://img.shields.io/github/license/Sivan757/dsh-agent-plugins-market) ![GitHub stars](https://img.shields.io/github/stars/Sivan757/dsh-agent-plugins-market)
 ![Agent Plugins 市场截图](docs/screenshot.png)
 ![套件详情（技能 / MCP / 命令预览）](docs/screenshot-detail.png)
-## 它解决什么问题？
+## 为什么需要它？
 DeepSeek Harness 是很强的 Agent 底座，但它的插件生态还没有 Claude Code 插件市场那么丰富。GitHub 上有成百上千现成的插件市场仓库（Claude Code 的 `.claude-plugin/marketplace.json`、Codex 的 `.codex-plugin`、Cursor、Kimi、agent-plugins.org v1.0.0 便携包），里面装满了技能、MCP 服务器、hooks 和斜杠命令。
 `dsh-agent-plugins-market` 就是那座桥：**把任意 git 市场仓库添加为源，安装其中的套件，它们的技能 / MCP / hooks / 命令就会在运行时注入到你的 DSH 会话**——无需手工拷贝文件，无需格式转换。Claude Code 生态的技能可以原样使用（`${CLAUDE_PLUGIN_ROOT}` 自动替换）。
-## 它能做什么
+## 快速开始
+> 需要 DeepSeek Harness ≥ 0.1.0-rc.6 且带 Web profile。
+```sh
+# 安装到某个 dsh profile（npm registry，推荐）
+dsh plugin --profile <名字> add dsh-agent-plugins-market
+# 或在 profile 中用 pnpm
+pnpm add dsh-agent-plugins-market
+```
+重启 dsh，打开 **设置 → Agent Plugins 市场**，把市场仓库添加为源（例如 `https://github.com/anthropics/claude-plugins-official`），一键安装套件。技能出现在「/」斜杠菜单；MCP 工具以 `mcp__<套件>__<server>__<工具>` 出现；斜杠命令与 `/agent-*` 子代理自动注册。
+<details>
+<summary><strong>更多安装方式</strong></summary>
+**GitHub：**
+```sh
+pnpm add github:Sivan757/dsh-agent-plugins-market
+# 或
+dsh plugin --profile <名字> add github:Sivan757/dsh-agent-plugins-market
+```
-- **套件管理**：配置 git 仓库源（市场），浏览每个源的套件，支持安装、卸载、启用、禁用、刷新；源 ID 自动从仓库清单 JSON 解析，无需手填。
-- **运行时发现**：已安装套件从 `~/.dsh/agent-plugins/.sources/<源id>/`（用户维度）与 `<项目>/.dsh/agent-plugins/.sources/<源id>/`（项目维度）发现；本地源直接读取工作树（含未提交改动）。
-- **运行时注入**：
+**手动**——把本包加入 profile 的 `dsh.profile.bundles`（包内 `cordis.patch.yml` 自动插入插件行）：
+```jsonc
+// ~/.dsh/profiles/<profile>/package.json
+{
+  "dependencies": { "dsh-agent-plugins-market": "^0.4.4" },
+  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agent-plugins-market"] } }
+}
+```
+构建产物（`lib/`、`client/`）已提交到仓库，GitHub 安装无需 `prepare` 步骤。
+</details>
+## 功能特性
+- **套件管理**——配置 git 仓库源（市场），浏览每个源的套件，支持安装、卸载、启用、禁用、刷新；源 ID 自动从仓库清单 JSON 解析，无需手填。
+- **Web 市场页**——设置面板内的市场页：顶部源胶囊 + 搜索/操作、状态标签、两列卡片网格、套件详情弹窗（技能/MCP/hooks/命令/LSP 全部可预览）。
+- **运行时注入**
   - **技能**：注册 `ctx.skills` SkillProvider（项目 rank 250 / 用户 rank 450），`${CLAUDE_PLUGIN_ROOT}` 自动替换，Claude Code 生态技能原样可用，出现在「/」斜杠菜单；
   - **MCP 服务器**：启用套件的 `mcp.json` 每个合法 server 动态挂载 `dsh-mcp-client` 子插件，工具名 `mcp__<套件>__<server>__<工具>`；
   - **Hooks**：套件 `hooks/hooks.json` 挂载 `dsh-hooks-claude-code` 桥，映射到宿主拦截点（SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStart、SubagentStop）；
   - **命令 / 子代理**：`commands/*.md` 注册为 dsh 斜杠命令；`agents/*.md` 注册为 `agent-<name>` 技能；
   - **上下文**：会话启动注入启用套件清单（用户级 + 项目级），`agent_plugins` 工具可查询。
-- **Web 市场页**：设置面板内的市场页——顶部源胶囊 + 搜索/操作、状态标签、两列卡片网格、套件详情弹窗（技能/MCP/hooks/命令/LSP 全部可预览）。
+- **运行时发现**——已安装套件从 `~/.dsh/agent-plugins/.sources/<源id>/`（用户维度）与 `<项目>/.dsh/agent-plugins/.sources/<源id>/`（项目维度）发现；本地源直接读取工作树（含未提交改动）。
 ## 兼容的套件布局
@@ -42,31 +83,9 @@ DeepSeek Harness 是很强的 Agent 底座，但它的插件生态还没有 Clau
 一个仓库可同时携带多种清单（如 vercel/vercel-plugin 全部都有）；套件身份取优先级最高的清单，内容面（skills/commands/agents/hooks/mcp）按目录扫描。`mcp.json` 严格按 agent-plugins.org schema 校验；`.mcp.json` 宽容解析——支持顶层 server map 简写、`type: http`/`local`/省略 type（按 command 判 stdio）归一化、`${CLAUDE_PLUGIN_ROOT}` / `${CLAUDE_PLUGIN_DATA}` / `${NAME:-default}` 占位符，未知 transport 逐 server 容错。marketplace 清单权威决定套件集合；无清单但含技能的市场条目与容器内未列出的清单插件也会被补全。远程 URL 引用条目以「远程引用」卡片展示（元信息 + 源 URL，不可直接安装，可添加对应仓库为源后安装）。
-## 安装
-```sh
-# 在某个 dsh profile 中
-pnpm add dsh-agent-plugins-market
-# 或通过 dsh CLI
-dsh plugin --profile <名字> add dsh-agent-plugins-market
-```
-把本包加入 profile 的 `dsh.profile.bundles`（包内 `cordis.patch.yml` 自动插入插件行）：
-```jsonc
-// ~/.dsh/profiles/<profile>/package.json
-{
-  "dependencies": { "dsh-agent-plugins-market": "^0.4.0" },
-  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agent-plugins-market"] } }
-}
-```
-重启 dsh，在 设置 → Agent Plugins 市场 中管理。
 ## 配置市场源
-源持久化在 `~/.dsh/agent-plugins/state.json`，也可用 cordis 配置预置（也是"持久种子"，启动时自动补齐缺失源）：
+源持久化在 `~/.dsh/agent-plugins/state.json`，也可用 cordis 配置预置（也是“持久种子”，启动时自动补齐缺失源）：
 ```yaml
 - id: dsh-agent-plugins-market
@@ -81,7 +100,7 @@ dsh plugin --profile <名字> add dsh-agent-plugins-market
 `local: true` 的源直接读取本地目录（实时反映工作树，移除源时不会删除目录）。
-## 与其他 DSH ↔ Claude Code 桥接项目的区别
+## 与其他 DSH ↔ Claude Code 桥接项目的对比
 | 能力 | **dsh-agent-plugins-market** | [dsh-skills](https://github.com/CocoSgt/dsh-skills) | [@claude2dsh/plugin](https://www.npmjs.com/package/@claude2dsh/plugin) | [@deepseek-ai/dsh-hooks-claude-code](https://github.com/deepseek-ai/deepseek-harness) |
 | --- | --- | --- | --- | --- |
@@ -97,16 +116,19 @@ dsh plugin --profile <名字> add dsh-agent-plugins-market
 ## 常见问题（FAQ）
-### 如何在 DeepSeek Harness 里安装 Claude Code 插件 / 技能？
+### 如何在 DeepSeek Harness（DSH）里安装 Claude Code 插件？
+先在 dsh profile 中安装本插件，再把任意 Claude Code 市场仓库添加为源：
+```sh
+dsh plugin --profile <名字> add dsh-agent-plugins-market
+```
-1. 把 `dsh-agent-plugins-market` 装进 DSH profile（见[安装](#安装)）；
-2. 打开 **设置 → Agent Plugins 市场**，把市场仓库添加为源（例如 `https://github.com/anthropics/claude-plugins-official` 或 `https://github.com/mattpocock/skills.git`）；
-3. 点击套件卡片 → **安装** → 重启 profile；
-4. 套件的技能出现在「/」斜杠菜单；MCP 工具以 `mcp__<套件>__<server>__<工具>` 出现；斜杠命令与 `/agent-*` 子代理自动注册。
+然后在 Web GUI 打开 **设置 → Agent Plugins 市场**，添加市场仓库 URL，一键安装套件。技能、MCP 服务器、hooks、斜杠命令会在运行时自动注入 dsh 会话——无需转换、无需拷贝文件。
-### 支持 Claude Code 市场（`.claude-plugin/marketplace.json`）吗？
+### DeepSeek Harness 支持 `.claude-plugin/marketplace.json` 吗？
-支持。Claude Code 市场布局原生支持（见上方布局表）：marketplace 清单权威决定套件集合，`plugins[].source` 相对路径正确解析，含技能的无清单条目自动补全。
+支持——通过本插件。原生读取 `.claude-plugin/marketplace.json` + 各插件的 `.claude-plugin/plugin.json`，同时支持 `.codex-plugin`、`.cursor-plugin`、`.kimi-plugin`、`.plugin`（通用）与 agent-plugins.org v1.0.0 `plugin.json` 清单（见上方布局表）。
 ### 能从套件注入 MCP 服务器吗？
@@ -116,14 +138,22 @@ dsh plugin --profile <名字> add dsh-agent-plugins-market
 套件的 `hooks/hooks.json` 会通过官方 `@deepseek-ai/dsh-hooks-claude-code` 桥挂载到宿主拦截点（SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStart、SubagentStop）。仅支持该桥映射的命令 hooks 子集，具体映射见桥的 README。
-### 需要手工转换或拷贝文件吗？
+### Claude Code 生态的技能可以原样使用吗？
-不需要。套件被克隆到 `~/.dsh/agent-plugins/.sources/<源id>/` 并运行时注入，无需手工拷贝、转换或修改任何 Claude 配置文件。
+可以。`${CLAUDE_PLUGIN_ROOT}` 在运行时自动替换，Claude Code 生态技能无需改动即可运行，并出现在「/」斜杠菜单中。
+### dsh-agent-plugins-market 和手动拷贝技能文件有什么区别？
+手动拷贝会破坏 `${CLAUDE_PLUGIN_ROOT}` 路径、丢掉 MCP/hooks/命令，也没有更新通道。本插件从 git 源整体安装套件，支持按插件启用/禁用/刷新，并自动注入全部能力面（技能、MCP、hooks、命令、子代理）。
 ### 安装第三方套件安全吗？
 安装阶段绝不执行第三方代码：git 源经 `execFile` 克隆（无 shell）；第三方故障（坏清单、非法技能、路径逃逸、未知 MCP transport、挂载失败）都作为逐套件诊断受控处理。与任何第三方代码一样，启用前请自行审阅套件内容。
+### 免费开源吗？
+是——MIT 协议，发布于 [npm](https://www.npmjs.com/package/dsh-agent-plugins-market)，源码在 [GitHub](https://github.com/Sivan757/dsh-agent-plugins-market)。
 ## 环境要求
 - 必需 `ctx.skills`（dsh-skill）。
@@ -138,6 +168,12 @@ dsh plugin --profile <名字> add dsh-agent-plugins-market
 - 第三方套件故障永远受控：坏清单、非法技能、逃逸路径、未知 MCP transport、挂载失败均为逐套件诊断。
 - 错误边界包裹整个市场区与详情弹窗：任何预览渲染异常降级为提示，不会崩掉界面。
+## 已知限制
+- 项目维度 MCP server 不挂载（dsh 无按会话的 tool scope）；项目维度覆盖技能 + 上下文。
+- 技能发现无文件监听：目录变化在管理动作或重启后生效。
+- Claude Code hooks 仅支持 bridge 映射的子集；LSP 只计数与预览，不执行。
 ## 开发
 ```sh
@@ -148,11 +184,7 @@ pnpm run build       # tsc 宿主 + tsdown 客户端 + 模块加载器包装
 pnpm pack            # 构建并打 tgz
 ```
-## 已知限制
-- 项目维度 MCP server 不挂载（dsh 无按会话的 tool scope）；项目维度覆盖技能 + 上下文。
-- 技能发现无文件监听：目录变化在管理动作或重启后生效。
-- Claude Code hooks 仅支持 bridge 映射的子集；LSP 只计数与预览，不执行。
+文档站位于 [`docs-site/`](docs-site/)（Astro，部署到 GitHub Pages）。
 ## Vendored 资产