npm - @hyzyn/dsh-plugin-kit - Versions diffs - 0.1.43 → 0.1.45 - Mend

@hyzyn/dsh-plugin-kit 0.1.43 → 0.1.45

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

package/README.en.md CHANGED Viewed

@@ -16,13 +16,16 @@
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>
-Repo gates: `pnpm typecheck` / `pnpm build` / `pnpm test` / `pnpm aggregate`.
 <p align="center">
   <strong>A plugin family for the DeepSeek Harness (DSH) Web GUI</strong><br>
   <em>Environment · MCP servers · Prompt · Profile · RSS · Global search · Codegraph · Terminal panel · Container panel · Scaffolding</em>
 </p>
+<p align="center">
+  <code>dsh plugin --profile web add @hyzyn/dsh-all</code><br>
+  <sub>installs the whole family · restart <code>dsh web</code> to take effect · only want a few? → <a href="#quick-start">install on demand</a></sub>
+</p>
 <p align="center">
 [What it is](#what-it-is) · [Packages](#packages) · [Quick start](#quick-start) · [Writing a new plugin](#writing-a-new-plugin) · [Documentation map](#documentation-map) · [Contributing](#contributing)
@@ -35,21 +38,30 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
 Every plugin mounts through the official profile mechanism — **DSH itself is never patched** —
 and you can install them one by one or all at once with the aggregate package.
-![SFTP dual pane: local on the left, remote on the right, inline transfer](https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-tty-sftp-dual.png)
+<table>
+<tr>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-tty-sftp-dual.png" alt="Terminal panel: multi-tab real PTY with the server status bar, and the SFTP dual-pane drawer below (local on the left, remote on the right)" width="400"></td>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-docker-dock.png" alt="Docker container panel: docked as a sidebar tab next to the conversation" width="400"></td>
+</tr>
+<tr>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-rss-view.png" alt="RSS digest &quot;Today's Worth Reading&quot;: the day's items grouped by category and source, searchable and filterable" width="400"></td>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-search-query.png" alt="Global search: typing codegraph, results grouped into recent sessions / history / Prompt / MCP tools / settings" width="400"></td>
+</tr>
+</table>
-![Docker container panel: docked as a sidebar tab next to the conversation](https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-docker-dock.png)
+Grouped configuration → panels → development:
-| Capability | Plain `dsh web` | The dsh-plugin-kit family |
-| --- | --- | --- |
+| Capability | Plain `dsh web` | dsh-plugin-kit |
+|---|---|---|
 | MCP servers | edit the patch file / CLI | visual card + connection test + hot reload after saving |
+| Environment variables | edit `env.yml` by hand / CLI | Web GUI card, written into `process.env` on save |
+| Prompt management | hand-edited config | visual editing + versioning / A/B testing / export & share |
 | Profile management | CLI | visual create / copy / rename / delete |
-| RSS aggregation | none | multi-source subscriptions + a daily digest + optional AI summaries (uses the host’s default model, zero config) |
-| Global search | session titles/content only | one full-text search over past sessions, Prompts, MCP tools and settings panels |
+| RSS aggregation | none | multi-source subscriptions + a daily “Today’s Worth Reading” + optional AI summaries (follows the host’s default model, zero config) |
+| Global search | session titles / content only | one full-text search in the sidebar over past sessions, Prompts, MCP tools and settings panels |
+| Terminal panel | none | real xterm.js multi-tab PTY + native SSH (connection book / host-key pinning / auto reconnect) + SFTP dual-pane transfer; registers `tty_*` / `sftp_*` tools |
+| Docker container panel | none | containers / images / Compose / live logs and stats / multi-target overview; **read-only by default**, mutations and exec behind explicit switches; registers `docker_*` tools |
 | Codegraph integration | none | code graph card: index status / symbol search / call chain / impact / one-click sync-index |
-| Terminal panel | none | real xterm.js multi-tab PTY (vim/htop/dev server); native SSH (connection book, host-key pinning, auto reconnect); SFTP single-dialog / dual-pane transfer; `tty_*` / `sftp_*` agent tools |
-| Docker container panel | none | containers / images / Compose / live logs and stats / multi-target overview; **read-only by default**, mutations and exec behind explicit switches; `docker_*` agent tools |
-| Environment variables | CLI / hand-edited config | Web GUI card, written into `process.env` on save |
-| Prompt management | hand-edited config | visual editing + versioning / A/B testing / export & share |
 | Plugin development | boilerplate by hand | `pnpm create-plugin` scaffolding + the `@hyzyn/dsh-kit` shared library |
 > **Each plugin’s full feature set, screenshots and caveats live in its own README** (table below).
@@ -63,35 +75,65 @@ direction and how they cooperate: [docs/architecture.md](docs/architecture.md) (
 | Package | What it does | Docs |
 |---|---|---|
 | `@hyzyn/dsh-kit` | **Library** (not a plugin): shared host-half utilities — HTTP loopback fence, managed blocks, `!!js` expressions, service access | [README](packages/kit/README.md) · [DEFECTS](packages/kit/DEFECTS.md) |
-| `@hyzyn/dsh-mcp` | MCP server configuration card, hot-reloaded on save | [README](packages/mcp/README.md) |
 | `@hyzyn/dsh-env` | Environment variables / secrets management | [README](packages/env/README.md) |
+| `@hyzyn/dsh-mcp` | MCP server configuration card, hot-reloaded on save | [README](packages/mcp/README.md) |
 | `@hyzyn/dsh-prompt` | systemPrompt editing / versions / A-B testing | [README](packages/prompt/README.md) |
 | `@hyzyn/dsh-profile` | Graphical management of `~/.dsh/profiles` | [README](packages/profile/README.md) |
+| `@hyzyn/dsh-kit-settings` | Adds a “Plugin configuration” row next to “General settings” | [README](packages/kit-settings/README.md) |
 | `@hyzyn/dsh-rss` | RSS aggregation → a daily digest | [README](packages/rss/README.md) |
-| `@hyzyn/dsh-search` | Sidebar global search | [README](packages/search/README.md) |
+| `@hyzyn/dsh-search` | Sidebar global search (⌘ / Ctrl + K) | [README](packages/search/README.md) |
 | `@hyzyn/dsh-codegraph` | Code graph card + MCP management + adoption measurement | [README](packages/codegraph/README.md) · [DEFECTS](packages/codegraph/DEFECTS.md) · [ROADMAP](packages/codegraph/ROADMAP.md) |
-| `@hyzyn/dsh-tty` | Terminal panel (PTY / SSH / SFTP / tunnels) | [README](packages/tty/README.md) · [DEFECTS](packages/tty/DEFECTS.md) · [ROADMAP](packages/tty/ROADMAP.md) |
+| `@hyzyn/dsh-tty` | Terminal panel: PTY / SSH / SFTP / tunnels | [README](packages/tty/README.md) · [DEFECTS](packages/tty/DEFECTS.md) · [ROADMAP](packages/tty/ROADMAP.md) |
 | `@hyzyn/dsh-docker` | Docker container panel (local / SSH), read-only by default | [README](packages/docker/README.md) · [DEFECTS](packages/docker/DEFECTS.md) · [ROADMAP](packages/docker/ROADMAP.md) |
-| `@hyzyn/dsh-kit-settings` | Adds a “Plugin configuration” row next to “General settings” | [README](packages/kit-settings/README.md) |
 | `@hyzyn/dsh-all` | Aggregate package: one bundle patch that mounts the 10 plugins above | [README](packages/all/README.md) |
 ## Quick start
 ### System requirements
-- DeepSeek Harness installed and `dsh web` starts normally. **The current baseline spans two DSH
-  cohorts, `0.1.7-rc.2` and `0.2.0-rc.1`**: settings now live in the current profile’s plugin-entry
-  configuration, and compatibility is enforced from `peerDependencies` both before install and at
-  startup; `0.1.6-alpha.2` and earlier are no longer supported.
-- Every installable plugin declares `@deepseek-ai/dsh: ^0.1.7-rc.2 || ^0.2.0-rc.1` in
-  `peerDependencies` (one `^<cohort>` per supported cohort joined with `||`; matching any branch
-  admits the host), enforced both **before install** and **at startup**. `dsh.engines.dsh` is kept as
-  a **marketplace display field** — the market resolver only accepts a single `>=X.Y.Z` segment, so it
-  carries the **lowest** cohort, `>=0.1.7-rc.2`. Mechanics, what to do when a version is rejected, and
-  how to admit an exact combination → [docs/troubleshooting.md § Compatibility](docs/troubleshooting.md#兼容性校验).
-- No extra requirements for npm installs; installing from this repository requires Node.js >= 22.19 and pnpm 10.
+- DeepSeek Harness installed and `dsh web` starts normally. **Three DSH cohorts are currently
+  supported: `0.1.7-rc.2`, `0.2.0-rc.1` and `0.2.0-rc.2`**; `0.1.6-alpha.2` and earlier are no longer
+  supported.
+- Compatibility is guaranteed by the `@deepseek-ai/dsh` range each installable plugin declares in
+  `peerDependencies`, which DSH checks once **before install** and once **at startup**. What a
+  rejection looks like and how to admit a combination temporarily →
+  [docs/troubleshooting.md § Compatibility](docs/troubleshooting.md#兼容性校验).
+- No extra requirements for npm installs; building from this repository’s sources requires
+  Node.js >= 22.19 and pnpm 10.
+### Install from npm
+**Installing only what you need is the recommended path** — one package per line below, install just
+the ones you want. Starting with the three configuration cards (`env` / `mcp` / `prompt`, none of
+which register tools) is the cheapest way in:
+```sh
+dsh plugin --profile web add @hyzyn/dsh-env          # env vars / secrets
+dsh plugin --profile web add @hyzyn/dsh-mcp          # MCP servers
+dsh plugin --profile web add @hyzyn/dsh-prompt       # systemPrompt
+dsh plugin --profile web add @hyzyn/dsh-profile      # profiles
+dsh plugin --profile web add @hyzyn/dsh-kit-settings # the "Plugin configuration" settings row
+dsh plugin --profile web add @hyzyn/dsh-rss          # RSS digest
+dsh plugin --profile web add @hyzyn/dsh-search       # ⌘/Ctrl+K global search
+dsh plugin --profile web add @hyzyn/dsh-codegraph    # code graph card
+dsh plugin --profile web add @hyzyn/dsh-tty          # terminal panel (PTY / SSH / SFTP)
+dsh plugin --profile web add @hyzyn/dsh-docker       # Docker container panel
+```
+Package names, one-line descriptions and per-package docs are in the [Packages](#packages) table above.
+**One thing to know before you install: the packages differ in what they touch** (details are in each
+package's README; the mechanism is in
+[docs/architecture.md § 7](docs/architecture.md#7-一条请求经过什么)):
+| Install it | What it means |
+|---|---|
+| **Registers tools — genuinely changes what the agent can do** | `tty` (`tty_*` / `sftp_*` — a real shell / SFTP channel) · `docker` (`docker_*`) · `codegraph` (it hosts the codegraph MCP row for you, so `mcp__codegraph__*` lands in the model's toolbox) |
+| **Only appends a section to the systemPrompt** | `rss` (the “Today's Worth Reading” section) · `search` (its capability announcement); what `prompt` does *is* edit the systemPrompt |
+| **Only touches your own configuration and UI** | `env` (saving writes into the host's `process.env` — still your own configuration) · `profile` · `kit-settings` · `mcp` (a configuration entry point — it adds no tools itself, but the servers you type into it will) |
-### Install from npm (recommended)
+Installing everything at once is the aggregate package — **its exposure is the union of each
+package's** — if you don't know which plugin you need, don't start there:
 ```sh
 dsh plugin --profile web add @hyzyn/dsh-all              # aggregate package
@@ -101,7 +143,6 @@ dsh plugin --profile web add @hyzyn/dsh-plugin-kit       # repo root bundle (mou
 **Restart `dsh web`** afterwards; all cards appearing under Settings → Plugins means it worked.
 If a card does not appear, you probably forgot to restart. You can also use
 `dsh --profile web --dump-config` to confirm the plugin configuration layer is mounted.
-For one plugin only, see “Install a single plugin” below.
 Uninstall: `dsh plugin --profile web remove @hyzyn/dsh-all` (or the matching subpackage), then restart.
 > **Which configuration entry exists in which version**: DSH ≥ `0.1.6-alpha.2` has **two** entries
@@ -111,10 +152,14 @@ Uninstall: `dsh plugin --profile web remove @hyzyn/dsh-all` (or the matching sub
 > DSH ≤ `0.1.5` uses the cards inside **Settings → Plugins → “Plugin configuration”**.
 > Client halves register all three slot generations (`plugins.row.config`, `settings.kit.item`,
 > `settings.plugin.item`), so one build works on every generation.
+> This configuration itself lives in the **current profile's plugin entry** (`cordis.patch.yml` user
+> layer), not in a global `settings.yaml` section — see the [glossary](docs/glossary.md).
+Install failures / missing cards / **every plugin gone** / HTTP 401 or 403 → [docs/troubleshooting.md](docs/troubleshooting.md) (Chinese).
 ### Install from the GitHub repository (development / debugging)
-Requires Node.js >= 22.19 and pnpm 10. The repository root is itself a DSH bundle
+The repository root is itself a DSH bundle
 (`package.json#dsh.bundle.patch`, generated by `pnpm aggregate`):
 ```sh
@@ -135,20 +180,6 @@ dsh web
 > With the `dsh` field on the root package, GitHub DSH marketplaces classify this repository as a DSH
 > plugin (cordis-plugin) instead of flagging it as “non-plugin”.
-### Install a single plugin
-Swap the package name for any entry in the table above (`@hyzyn/dsh-all` → `@hyzyn/dsh-<pkg>`):
-```sh
-dsh plugin --profile web add @hyzyn/dsh-env       # Environment variables / secrets management
-dsh plugin --profile web add @hyzyn/dsh-tty       # Terminal panel
-dsh plugin --profile web add @hyzyn/dsh-docker    # Docker container panel
-```
-Install failures / missing cards / **every plugin gone** / HTTP 401 or 403 → [docs/troubleshooting.md](docs/troubleshooting.md).
-Install failures / missing cards / HTTP 401 or 403 → [docs/troubleshooting.md](docs/troubleshooting.md) (Chinese).
 ## Writing a new plugin
 ```sh
@@ -185,9 +216,9 @@ pure logic into modules) → [docs/conventions.md § Client half](docs/conventio
 | How to run real-machine tests, and what counts as passing | [docs/agent-real-test.md](docs/agent-real-test.md) |
 | The full design and acceptance criteria of a cross-package plan (bastion / elevation / i18n…) | `*-plan.md` and `i18n.md` under `docs/`, routed by the [conventions.md knowledge-ownership table](docs/conventions.md) |
 | Windows 11 test environment setup | [scripts/windows/README.md](scripts/windows/README.md) |
-| Cross-package backlog | [ROADMAP.md](ROADMAP.md) |
-| Release process | [RELEASING.md](RELEASING.md) |
 | Runtime linking between plugins and the host in a dev checkout | [docs/link-dsh-runtime.md](docs/link-dsh-runtime.md) |
+| Cross-package backlog | [ROADMAP.md](ROADMAP.md) |
+| Release process (incl. the cohort change list) | [RELEASING.md](RELEASING.md) |
 | How one package is used | `packages/<pkg>/README.md` |
 | What a defect number means | `packages/<pkg>/DEFECTS.md` |

package/README.md CHANGED Viewed

@@ -16,13 +16,16 @@
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>
-仓库门禁：`pnpm typecheck` / `pnpm build` / `pnpm test` / `pnpm aggregate`。
 <p align="center">
   <strong>DeepSeek Harness（DSH）Web GUI 的插件全家桶</strong><br>
   <em>环境变量 · MCP 服务器 · Prompt · Profile · RSS · 全局搜索 · Codegraph 集成 · 终端面板 · 容器面板 · 插件脚手架</em>
 </p>
+<p align="center">
+  <code>dsh plugin --profile web add @hyzyn/dsh-all</code><br>
+  <sub>一次装齐，重启 <code>dsh web</code> 生效 · 只想要其中几个 → <a href="#快速开始">按需安装</a></sub>
+</p>
 <p align="center">
 [是什么](#是什么) · [包索引](#包索引) · [快速开始](#快速开始) · [开发新插件](#开发新插件) · [文档地图](#文档地图) · [参与贡献](#参与贡献)
@@ -34,21 +37,30 @@
 dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合。所有插件都走官方 profile
 机制挂载到 `dsh web`，**不改 DSH 源码**；可以逐个安装，也可以用聚合包一次装齐。
-![SFTP 双栏：左本机 / 右远程，行内直传](https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-tty-sftp-dual.png)
+<table>
+<tr>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-tty-sftp-dual.png" alt="终端面板：多标签真实 PTY + 顶部服务器状态条，下方抽屉是 SFTP 双栏（左本机 / 右远程）" width="400"></td>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-docker-dock.png" alt="Docker 容器面板：会话右侧栏标签，与对话同屏" width="400"></td>
+</tr>
+<tr>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-rss-view.png" alt="RSS「今日值得读」：当日条目按分类与来源分区，可搜索、按分类筛选与刷新" width="400"></td>
+<td><img src="https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-search-query.png" alt="全局搜索：输入 codegraph，结果按最近会话 / 历史会话 / Prompt / MCP 工具 / 设置分组" width="400"></td>
+</tr>
+</table>
-![Docker 容器面板：会话右侧栏标签，与对话同屏](https://cdn.jsdelivr.net/gh/hyzyn/dsh-plugin-kit@main/docs/dsh-plugin-kit-docker-dock.png)
+按「配置类」→「面板类」→「开发类」排：
-| 能力 | 原生 dsh web | dsh-plugin-kit 全家桶 |
-| --- | --- | --- |
+| 能力 | 原生 `dsh web` | dsh-plugin-kit |
+|---|---|---|
 | MCP 服务器 | 手改 patch / 命令行 | 可视化卡片 + 连接测试 + 保存后热加载 |
+| 环境变量 | 手改 `env.yml` / 命令行 | Web GUI 卡片，保存即写入 `process.env` |
+| Prompt 管理 | 手改配置 | 可视化编辑 + 版本管理 / A/B 测试 / 导出分享 |
 | Profile 管理 | 命令行 | 可视化创建 / 复制 / 重命名 / 删除 |
 | RSS 聚合 | 无 | 多源订阅 + 每日「今日值得读」+ 可选 AI 摘要（跟随宿主默认模型，零配置） |
-| 全局搜索 | 仅会话标题/内容 | 侧边栏统一全文搜索历史会话、Prompt、MCP 工具与设置面板 |
+| 全局搜索 | 仅会话标题 / 内容 | 侧边栏一处全文检索历史会话、Prompt、MCP 工具与设置面板 |
+| 终端面板 | 无 | xterm.js 多标签真实 PTY + SSH 直连（连接簿 / 指纹钉扎 / 断线重连）+ SFTP 双栏直传；注册 `tty_*` / `sftp_*` 工具 |
+| Docker 容器面板 | 无 | 容器 / 镜像 / Compose / 实时日志与统计 / 多目标总览；**默认只读**，变更与 exec 需显式开关；注册 `docker_*` 工具 |
 | Codegraph 集成 | 无 | 代码图谱卡片：索引状态 / 符号搜索 / 调用链 / 影响面 / 一键 sync-index |
-| 终端面板 | 无 | xterm.js 多标签真实 PTY（vim/htop/dev server）；SSH 直连（连接簿、指纹钉扎、断线重连）；SFTP 单窗体 / 双栏直传；`tty_*` / `sftp_*` 工具 |
-| Docker 容器面板 | 无 | 容器 / 镜像 / Compose / 实时日志与统计 / 多目标总览；**默认只读**，变更与 exec 需显式开关；`docker_*` 工具 |
-| 环境变量管理 | 命令行 / 手改配置 | Web GUI 卡片，保存即写入 `process.env` |
-| Prompt 管理 | 手改配置 | 可视化编辑 + 版本管理 / A/B 测试 / 导出分享 |
 | 插件开发 | 手写样板 | `pnpm create-plugin` 脚手架 + `@hyzyn/dsh-kit` 共享工具库 |
 > **每个插件的完整功能、截图与注意事项在它自己的 README 里**（见下表）。本文件只讲「是什么 + 装哪个」。
@@ -61,41 +73,66 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
 | 包 | 干什么 | 文档 |
 |---|---|---|
 | `@hyzyn/dsh-kit` | **库**（非插件）：宿主半体共享工具——HTTP 回环围栏、托管区块、`!!js` 表达式、服务读取 | [README](packages/kit/README.md) · [DEFECTS](packages/kit/DEFECTS.md) |
-| `@hyzyn/dsh-mcp` | MCP 服务器配置卡片，保存后热加载 | [README](packages/mcp/README.md) |
 | `@hyzyn/dsh-env` | 环境变量 / 密钥管理 | [README](packages/env/README.md) |
+| `@hyzyn/dsh-mcp` | MCP 服务器配置卡片，保存后热加载 | [README](packages/mcp/README.md) |
 | `@hyzyn/dsh-prompt` | systemPrompt 编辑 / 版本 / A/B | [README](packages/prompt/README.md) |
 | `@hyzyn/dsh-profile` | `~/.dsh/profiles` 图形化管理 | [README](packages/profile/README.md) |
+| `@hyzyn/dsh-kit-settings` | 在官方「设置」里补一行「插件配置」入口 | [README](packages/kit-settings/README.md) |
 | `@hyzyn/dsh-rss` | RSS 聚合 → 每日「今日值得读」 | [README](packages/rss/README.md) |
-| `@hyzyn/dsh-search` | 侧边栏全局搜索 | [README](packages/search/README.md) |
+| `@hyzyn/dsh-search` | 侧边栏全局搜索（⌘ / Ctrl + K） | [README](packages/search/README.md) |
 | `@hyzyn/dsh-codegraph` | 代码图谱卡片 + MCP 托管 + 采纳率测量 | [README](packages/codegraph/README.md) · [DEFECTS](packages/codegraph/DEFECTS.md) · [ROADMAP](packages/codegraph/ROADMAP.md) |
-| `@hyzyn/dsh-tty` | 终端面板（PTY / SSH / SFTP / 隧道） | [README](packages/tty/README.md) · [DEFECTS](packages/tty/DEFECTS.md) · [ROADMAP](packages/tty/ROADMAP.md) |
+| `@hyzyn/dsh-tty` | 终端面板：PTY / SSH / SFTP / 隧道 | [README](packages/tty/README.md) · [DEFECTS](packages/tty/DEFECTS.md) · [ROADMAP](packages/tty/ROADMAP.md) |
 | `@hyzyn/dsh-docker` | Docker 容器面板（本机 / SSH），默认只读 | [README](packages/docker/README.md) · [DEFECTS](packages/docker/DEFECTS.md) · [ROADMAP](packages/docker/ROADMAP.md) |
-| `@hyzyn/dsh-kit-settings` | 在官方「设置」里补一行「插件配置」入口 | [README](packages/kit-settings/README.md) |
 | `@hyzyn/dsh-all` | 聚合安装包：一条 bundle patch 挂载上面 10 个插件 | [README](packages/all/README.md) |
 ## 快速开始
 ### 系统要求
-- 已安装 DeepSeek Harness，`dsh web` 可正常启动。**当前适配的两档基线为 DSH `0.1.7-rc.2` 与
-  `0.2.0-rc.1`**：settings 存储改为「当前 profile 的插件 entry 配置」，兼容性改由
-  `peerDependencies` 在安装前与启动时强制校验；`0.1.6-alpha.2` 及更早不再支持。
-- 每个可安装插件都在 `peerDependencies` 声明
-  `@deepseek-ai/dsh: ^0.1.7-rc.2 || ^0.2.0-rc.1`（逐 cohort 用 `||` 写全，命中任一段即放行），
-  DSH 在**安装前**与**启动时**都用它判定兼容性；同时保留 `dsh.engines.dsh` 作**市场展示位**
-  ——市场解析器只认单段 `>=X.Y.Z`，所以它写的是**最低档** `>=0.1.7-rc.2`，与 peer 覆盖的最低档一致。
-  机制细节、被拦下怎么办、怎么临时放行 → [docs/troubleshooting.md § 兼容性校验](docs/troubleshooting.md#兼容性校验)。
-- npm 安装方式无额外要求；从仓库安装需要 Node.js >= 22.19 与 pnpm 10。
+- 已安装 DeepSeek Harness，`dsh web` 可正常启动。**当前适配三档基线：DSH `0.1.7-rc.2`、`0.2.0-rc.1`
+  与 `0.2.0-rc.2`**；`0.1.6-alpha.2` 及更早不再支持。
+- 兼容性由每个可安装插件在 `peerDependencies` 里声明的 `@deepseek-ai/dsh` 范围保证，DSH 在**安装前**
+  与**启动时**各校验一次。被拦下长什么样、怎么临时放行 → [docs/troubleshooting.md § 兼容性校验](docs/troubleshooting.md#兼容性校验)。
+- npm 安装无额外要求；从仓库源码安装需要 Node.js >= 22.19 与 pnpm 10。
+### 从 npm 安装
-### 从 npm 安装（推荐）
+**推荐按需装**——下面一行一个包，只装你要的。从「配置三件」起步最省（`env` / `mcp` / `prompt`，
+都不向模型注册工具）：
+```sh
+dsh plugin --profile web add @hyzyn/dsh-env          # 环境变量 / 密钥
+dsh plugin --profile web add @hyzyn/dsh-mcp          # MCP 服务器
+dsh plugin --profile web add @hyzyn/dsh-prompt       # systemPrompt
+dsh plugin --profile web add @hyzyn/dsh-profile      # Profile 管理
+dsh plugin --profile web add @hyzyn/dsh-kit-settings # 设置里的「插件配置」入口
+dsh plugin --profile web add @hyzyn/dsh-rss          # RSS「今日值得读」
+dsh plugin --profile web add @hyzyn/dsh-search       # ⌘/Ctrl+K 全局搜索
+dsh plugin --profile web add @hyzyn/dsh-codegraph    # 代码图谱卡片
+dsh plugin --profile web add @hyzyn/dsh-tty          # 终端面板（PTY / SSH / SFTP）
+dsh plugin --profile web add @hyzyn/dsh-docker       # Docker 容器面板
+```
+包名、一句话说明与各自的文档见上方 [包索引](#包索引)。
+**装之前知道一件事：各包动到的面不一样**（细节在各包 README；机制见
+[docs/architecture.md § 7](docs/architecture.md#7-一条请求经过什么)）：
+| 装了它 | 意味着 |
+|---|---|
+| **给模型注册工具**，真正改变 agent 能力 | `tty`（`tty_*` / `sftp_*`——真实的 shell / SFTP 通道）· `docker`（`docker_*`）· `codegraph`（替宿主托管 codegraph MCP 行，于是 `mcp__codegraph__*` 进模型工具箱） |
+| **只往 systemPrompt 添一段** | `rss`（「今日值得读」那段）· `search`（插件能力公告）；`prompt` 卡片做的本身就是编辑 systemPrompt |
+| **只动你自己的配置与界面** | `env`（保存即写进宿主的 `process.env`，环境变量仍是你自己的配置）· `profile` · `kit-settings` · `mcp`（它是配置入口——自己不加工具，你填进去的服务器会） |
+一次装齐就是聚合包，**权限敞口是各包的并集**——不知道要哪个就先别装它：
 ```sh
 dsh plugin --profile web add @hyzyn/dsh-all              # 聚合安装包
 dsh plugin --profile web add @hyzyn/dsh-plugin-kit       # 仓库根 bundle（同样挂载全家桶）
 ```
-装完**重启** `dsh web`，插件配置页里出现全部条目即生效。只想用某一个插件，见下方「单独安装某个插件」。
-条目没出现多半是没重启；也可以用 `dsh --profile web --dump-config` 确认插件配置层已挂载。
+装完**重启** `dsh web`，插件配置页里出现全部条目即生效；条目没出现多半就是没重启，
+也可以用 `dsh --profile web --dump-config` 确认插件配置层已挂载。
 卸载：`dsh plugin --profile web remove @hyzyn/dsh-all`（或对应子包名），再重启。
 > **配置入口在哪一版**：DSH ≥ `0.1.6-alpha.2` 有**两个**入口，指向同一份配置——侧边栏
@@ -104,11 +141,14 @@ dsh plugin --profile web add @hyzyn/dsh-plugin-kit       # 仓库根 bundle（
 > DSH ≤ `0.1.5` 是**设置 → 插件 →「插件配置」**标签页里的卡片。
 > 客户端半体同时注册三代插槽（`plugins.row.config`、`settings.kit.item`、`settings.plugin.item`），
 > 一份产物在各代上都能用。
+> 这份配置本身落在**当前 profile 的插件 entry**（`cordis.patch.yml` 用户层），不再是全局 `settings.yaml`
+> section，见 [术语表](docs/glossary.md)。
+装不上 / 卡片不出现 / **插件整体消失** / 接口报 401、403 → [docs/troubleshooting.md](docs/troubleshooting.md)。
 ### 从 GitHub 仓库安装（开发调试）
-需要 Node.js >= 22.19 与 pnpm 10。仓库根目录本身也是一个 DSH bundle
-（`package.json#dsh.bundle.patch`，由 `pnpm aggregate` 生成）：
+仓库根目录本身也是一个 DSH bundle（`package.json#dsh.bundle.patch`，由 `pnpm aggregate` 生成）：
 ```sh
 git clone https://github.com/hyzyn/dsh-plugin-kit.git
@@ -124,22 +164,10 @@ dsh web
 > 不要再 add 根包（或 `packages/all`），否则插件行重复挂载会在启动时报
 > `duplicate loader entry id`。
-> 只想用某个子包：第 3 步改为 `dsh plugin --profile web add link:$(pwd)/packages/<name>`。
+> 只想用某个子包：最后一步改为 `dsh plugin --profile web add link:$(pwd)/packages/<name>`。
 > 根包声明了 `dsh` 字段后，GitHub 的 DSH 插件市场会把本仓库识别为 DSH 插件（cordis-plugin）。
-### 单独安装某个插件
-不想装全家桶时，把包名换成上表里的任意一个即可（`@hyzyn/dsh-all` → `@hyzyn/dsh-<包名>`）：
-```sh
-dsh plugin --profile web add @hyzyn/dsh-env       # 环境变量 / 密钥管理
-dsh plugin --profile web add @hyzyn/dsh-tty       # 终端面板
-dsh plugin --profile web add @hyzyn/dsh-docker    # Docker 容器面板
-```
-装不上 / 卡片不出现 / **插件整体消失** / 接口报 401、403 → [docs/troubleshooting.md](docs/troubleshooting.md)。
 ## 开发新插件
 ```sh
@@ -173,9 +201,9 @@ dsh plugin --profile web add link:$(pwd)/packages/<name>
 | 真机测试怎么跑、什么算通过 | [docs/agent-real-test.md](docs/agent-real-test.md) |
 | 某个跨包方案的完整设计与验收（跳板机 / 就地提权 / i18n…） | `docs/` 下的 `*-plan.md` 与 `i18n.md`，由 [conventions.md 的知识归属表](docs/conventions.md) 路由 |
 | Windows 11 真机环境搭建 | [scripts/windows/README.md](scripts/windows/README.md) |
-| 跨包待办 | [ROADMAP.md](ROADMAP.md) |
-| 发版流程 | [RELEASING.md](RELEASING.md) |
 | 开发环境里插件与宿主的 runtime 链接 | [docs/link-dsh-runtime.md](docs/link-dsh-runtime.md) |
+| 跨包待办 | [ROADMAP.md](ROADMAP.md) |
+| 发版流程（含 cohort 变更清单） | [RELEASING.md](RELEASING.md) |
 | 某个包怎么用 | `packages/<pkg>/README.md` |
 | 某个编号是什么意思 | `packages/<pkg>/DEFECTS.md` |

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@hyzyn/dsh-plugin-kit",
-  "version": "0.1.43",
+  "version": "0.1.45",
   "type": "module",
   "description": "通用 DSH 插件库（pnpm monorepo）：模板插件、插件开发工具包、一键聚合安装包。根包同时是全家桶 bundle（dsh.bundle.patch），DSH 与插件市场可直接识别安装。",
   "main": "lib/index.js",
@@ -40,19 +40,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@hyzyn/dsh-codegraph": "0.6.2",
-    "@hyzyn/dsh-docker": "0.9.2",
-    "@hyzyn/dsh-env": "0.3.2",
-    "@hyzyn/dsh-kit-settings": "0.2.1",
-    "@hyzyn/dsh-mcp": "0.2.3",
-    "@hyzyn/dsh-profile": "0.2.2",
-    "@hyzyn/dsh-prompt": "0.2.2",
-    "@hyzyn/dsh-rss": "0.4.2",
-    "@hyzyn/dsh-search": "0.4.2",
-    "@hyzyn/dsh-tty": "0.22.2"
+    "@hyzyn/dsh-codegraph": "0.6.3",
+    "@hyzyn/dsh-docker": "0.9.4",
+    "@hyzyn/dsh-env": "0.3.3",
+    "@hyzyn/dsh-kit-settings": "0.2.2",
+    "@hyzyn/dsh-mcp": "0.3.0",
+    "@hyzyn/dsh-profile": "0.2.3",
+    "@hyzyn/dsh-prompt": "0.2.3",
+    "@hyzyn/dsh-rss": "0.4.3",
+    "@hyzyn/dsh-search": "0.4.3",
+    "@hyzyn/dsh-tty": "0.24.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh": "^0.1.7-rc.2 || ^0.2.0-rc.1"
+    "@deepseek-ai/dsh": "^0.1.7-rc.2 || ^0.2.0-rc.1 || ^0.2.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh": {
@@ -66,6 +66,7 @@
     "test:watch": "vitest",
     "create-plugin": "node scripts/create-plugin.mjs",
     "aggregate": "node scripts/aggregate.mjs",
-    "live-smoke": "node scripts/live-host-smoke.mjs"
+    "live-smoke": "node scripts/live-host-smoke.mjs",
+    "verify:list": "node scripts/verify-list.mjs"
   }
 }