dsh-plugin-runcat-inventory 0.3.7

package/CHANGELOG.en.md

@@ -0,0 +1,223 @@
+# Changelog
+
+[中文](CHANGELOG.md) | **English**
+
+This file records the version history of `dsh-plugin-runcat-inventory` (Runcat Plugin Overview / 逃咪-插件总览).
+
+## [0.3.7] - 2026-08-27
+
+### Docs
+
+- **Added preview screenshots**: `assets/preview-zh.png` (Chinese UI) and
+  `assets/preview-en.png` (English UI); the Chinese README gained a
+  "效果预览" section showing the Chinese screenshot, and the English README
+  gained a "Screenshot" section showing the English one.
+
+---
+
+## [0.3.6] - 2026-08-27
+
+### Docs
+
+- **Added `CHANGELOG.en.md`** (this file): full English translation of the
+  changelog; both changelogs link to each other via the language switcher at
+  the top (`中文 | English`).
+- The English README now links to the English changelog.
+
+---
+
+## [0.3.5] - 2026-08-27
+
+### Docs
+
+- **Installation gained "Method B: install directly from the GitHub source"**:
+  `dsh plugin --profile web add github:runcat-tommy/dsh-plugin-runcat-inventory`
+  (listed alongside Method A — local clone; both note their differences:
+  `link:` for local development / direct fetch).
+- **Added `README.en.md`**: a complete English documentation
+  (features / structure / prerequisites / installation A & B / how it works /
+  uninstall / limitations / changelog summary); both READMEs link to each
+  other via the language switcher (`中文 | English`).
+
+---
+
+## [0.3.4] - 2026-08-27
+
+### Docs
+
+- **Folder name unified**: the directory name in the usage instructions was
+  changed from `runcat-inventory` to `dsh-plugin-runcat-inventory` (matching
+  the local folder name after cloning
+  `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory`); the
+  structure tree and install steps were updated accordingly.
+- **Added a "Prerequisites" section**: clarifies Node.js (DSH is a Node
+  program, required), pnpm (`dsh plugin` forwards to pnpm, required), Git
+  (needed for cloning or GitHub-source installs), and network (GitHub access,
+  configure a proxy if needed); also notes that the plugin itself has zero
+  dependencies.
+- Clarified the loader entry in the verification paragraph: id is
+  `runcat-inventory`, name is `dsh-plugin-runcat-inventory`, to avoid
+  confusion with the folder name.
+
+---
+
+## [0.3.3] - 2026-08-27
+
+### Changes
+
+- **The plugin's own description now follows the UI language**: the zh/en
+  dictionaries gained a `selfDescription` key (one per language); in the
+  "Details" expanded row, this plugin's Description is shown in the current
+  language. Other plugins still show their package.json `description` verbatim
+  (a single language chosen by the author; no generic translation possible).
+
+---
+
+## [0.3.2] - 2026-08-27
+
+### Fixes
+
+- **Only this plugin shows the repo URL in the Source column**: the previous
+  version wrongly showed the repo URL for every plugin carrying a
+  `repository` field; corrected — only `dsh-plugin-runcat-inventory` shows
+  `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory`, the rest
+  fall back to their install method (link/file/github/npm/builtin).
+- **Source-column overflow fix**: long URLs could spill into the adjacent
+  "Actions" column — the Source content now forces line breaking with
+  `word-break: break-all` + `overflow-wrap: anywhere`, so content always
+  wraps inside the 21% column.
+
+### Tests
+
+- mock tests updated: `hello` restored to its `link` source assertion; a new
+  entry for this plugin added (`sourceKind='repo'` + URL-cleanup assertion).
+  All 5 cases pass.
+
+---
+
+## [0.3.1] - 2026-08-27
+
+### Changes
+
+- **Fixed column ratios** (`table-layout: fixed` + `<colgroup>`):
+  Name 36% / Status 15% / Source 21% / Actions 28% (name is the most
+  important and takes the largest share); the Status and Actions columns have
+  minimum widths to protect badges and buttons from being squeezed.
+- **Source column prefers the repo URL**: the host reads the `repository`
+  field of each package's `package.json` (cleaning the `git+` prefix and
+  `.git` suffix), showing the repo URL when present; otherwise falls back to
+  the install method (link/file/github/npm/builtin).
+- This plugin's `package.json` gained a `repository` field →
+  `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory`.
+
+### Tests
+
+- mock tests updated: the fake `dsh-plugin-hello` package gained a
+  `repository`; assertions for `sourceKind='repo'` and URL cleaning added;
+  other cases unchanged. All 5 cases pass.
+
+---
+
+## [0.3.0] - 2026-08-27
+
+### Internationalization (UI language follows the DSH environment)
+
+- **Bilingual dictionaries**: registered Simplified Chinese / English
+  dictionaries through DSH's built-in locale service
+  (`@deepseek-ai/dsh-client-locale`); the UI follows the DSH environment
+  (Settings → General → Language or the browser language) without restart.
+- **Tab name**: 逃咪-插件总览 in Chinese, **Runcat Plugin Overview** in
+  English (the label became a locale function, re-rendered on language
+  switch).
+- **All UI copy goes through dictionaries**: 40+ items — search / filters /
+  sorting / buttons / badges / hints / empty states — all `t('key')`-based.
+- **Full host i18n**:
+  - Error messages became **error codes** (`MISSING_PARAMS`,
+    `PATCH_READ_FAILED`, `PATCH_PARSE_FAILED`, `PATCH_WRITE_FAILED`, and 9
+    more — 13 in total), translated client-side from dictionaries;
+  - The source field became `sourceKind`
+    (link/file/github/npm/builtin/other) + `sourceSpec` (raw spec); display
+    copy is translated client-side.
+- Terminal logs (host logger) and README/CHANGELOG docs stay Chinese
+  (operational convention).
+
+### Tests
+
+- mock unit tests updated in sync: source assertions now use
+  `sourceKind`/`sourceSpec`, error assertions use error codes; the 403 test
+  asserts code `FORBIDDEN`. All 5 cases pass.
+
+---
+
+## [0.2.1] - 2026-08-27
+
+### Changes
+
+- The plugin's Chinese name changed from "**逃猫**-插件总览" to
+  "**逃咪**-插件总览" (tab label, package.json description and keywords,
+  README/CHANGELOG and code comments updated together).
+
+---
+
+## [0.2.0] - 2026-08-27
+
+### UI redesign (a slimmer table)
+
+- **Fixed 4-column table**: `Name (incl. id + version) / Status / Source /
+  Actions`; the "Description" column was removed — the full description moved
+  into the "Details" expanded row; the list got noticeably narrower and
+  generally needs no horizontal scrolling at normal widths.
+- **Sticky columns removed**: the Name and Actions columns are no longer
+  fixed; at extremely narrow widths they scroll with the content.
+- **"Details" button rule**: shown when there is a description (non-empty)
+  or a config (non-empty); hidden when both are empty. Empty objects `{}` /
+  empty arrays `[]` count as no content.
+- **Details expanded row**: colSpan adjusted (5→4); still shows the full
+  description + config JSON + a "Copy config" button.
+
+### Interaction improvements
+
+- **Search**: confirmed a single combined search (name + id + description +
+  source + version); no field selector. The id is displayed under the name
+  column, so searching by id locates entries directly.
+- **Description**: kept the full-text hover tooltip (native title); removed
+  click-to-expand on the description itself (that entry point is now the
+  unified "Details" button).
+- **Sorting**: added name sorting — `Config order` (default) / `Name ↑` /
+  `Name ↓` (Chinese localeCompare).
+- **Keyboard scrolling**: after focusing the table container, ←/→ scroll
+  horizontally; Home/End jump to the start/end.
+- **Narrow screens**: the Source column hides automatically below 900px.
+
+### Technical fixes
+
+- Fixed the `node:fs` callback-style `readFile` being passed `'utf8'` as the
+  callback (switched to `node:fs/promises`).
+- Fixed Windows `require.resolve` returning a drive-letter path that could not
+  be passed straight to `import()` (converted to a file URL).
+- Added `hasConfigContent` to unify the "does the config have content"
+  semantics.
+
+### Tests
+
+- All 5 host-half mock unit tests pass (`node test/mock-test.mjs`): route
+  registration, inventory collection, enable/disable write & restore,
+  security check, parameter validation.
+
+---
+
+## [0.1.0] - 2026-08-27
+
+### Initial release
+
+- First usable version: a 7-column table (Name / Status / Version / Source /
+  Description / Config / Actions).
+- Data collected live from the host's `ctx.loader.entries()` + description /
+  version from each package's `package.json` + source derived from the
+  profile manifest.
+- Enable/Disable: edits the profile's `cordis.patch.yml` (user override
+  layer); DSH hot-applies it via HMR — no Web UI restart needed.
+- Communication: the browser half fetches same-origin `/runcat-api` routes
+  with a loopback trust check (CSRF protection).
+- Config view/copy, copy plugin name/module name, search box + status filter.
+- Install: `dsh plugin --profile web add .`

package/CHANGELOG.md

@@ -0,0 +1,193 @@
+# 更新记录 (Changelog)
+
+**中文** | [English](CHANGELOG.en.md)
+
+本文件记录 `dsh-plugin-runcat-inventory`（逃咪-插件总览 / Runcat Plugin Overview）的版本变更。
+
+## [0.3.7] - 2026-08-27
+
+### 文档
+
+- **新增效果预览图**：`assets/preview-zh.png`（中文界面）、
+  `assets/preview-en.png`（英文界面）；中文 README 新增"效果预览"章节
+  展示中文截图，英文 README 新增 "Screenshot" 章节展示英文截图。
+
+---
+
+## [0.3.6] - 2026-08-27
+
+### 文档
+
+- **新增英文版更新记录 `CHANGELOG.en.md`**：完整英文翻译；两份 CHANGELOG
+  顶部互加语言切换链接（`中文 | English`）。
+- 英文 README 的更新记录链接指向英文 CHANGELOG。
+
+---
+
+## [0.3.5] - 2026-08-27
+
+### 文档
+
+- **安装新增"方法 B：GitHub 源直接安装"**：
+  `dsh plugin --profile web add github:runcat-tommy/dsh-plugin-runcat-inventory`
+  （与方法 A 本地克隆安装并列，均注明差异：link: 本地开发 / 直接拉取）。
+- **新增英文说明 `README.en.md`**：完整英文版文档（功能/结构/前置条件/
+  安装 A/B/原理/卸载/限制/更新摘要），中英文文档顶部互加语言切换链接
+  （`中文 | English`）。
+
+---
+
+## [0.3.4] - 2026-08-27
+
+### 文档
+
+- **文件夹名统一**：使用说明中的目录名由 `runcat-inventory` 改为
+  `dsh-plugin-runcat-inventory`（与 GitHub 仓库
+  `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory` 克隆后的
+  本地文件夹名一致）；结构树、安装步骤同步更新。
+- **新增"前置条件"章节**：明确 Node.js（DSH 为 Node 程序，必需）、
+  pnpm（`dsh plugin` 为 pnpm 转发器，必需）、Git（克隆/GitHub 源安装时
+  需要）、网络（访问 GitHub，必要时配置代理）；并说明本插件自身零依赖。
+- 验证段落澄清 loader 条目：id 为 `runcat-inventory`、name 为
+  `dsh-plugin-runcat-inventory`，避免与文件夹名混淆。
+
+---
+
+## [0.3.3] - 2026-08-27
+
+### 变更
+
+- **本插件自身的描述随界面语言切换**：zh/en 字典新增 `selfDescription`
+  键（中文/英文各一套），"详情"展开行的 Description 内容对本插件按当前
+  语言显示；其余插件仍显示其 package.json 的 `description` 原文（作者
+  单一语言，无法通用翻译）。
+
+---
+
+## [0.3.2] - 2026-08-27
+
+### 修复
+
+- **来源列仅本插件显示仓库地址**：上一版错误地让所有带 `repository`
+  字段的插件都显示仓库 URL，已纠正——只有 `dsh-plugin-runcat-inventory`
+  显示 `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory`，
+  其余插件恢复按安装方式显示（link/file/github/npm/builtin）。
+- **来源列内容溢出修复**：长 URL 可能溢出到相邻"操作"列——来源内容
+  增加 `word-break: break-all` + `overflow-wrap: anywhere` 强制断行，
+  内容始终在 21% 列内换行。
+
+### 测试
+
+- mock 测试更新：hello 恢复 `link` 来源断言；新增本插件条目
+  （`sourceKind='repo'` + URL 清理断言）。5 用例全部通过。
+
+---
+
+## [0.3.1] - 2026-08-27
+
+### 变更
+
+- **列宽改为固定比例**（`table-layout: fixed` + `<colgroup>`）：
+  名称 36% / 状态 15% / 来源 21% / 操作 28%（名称最重要、占比最大）；
+  状态、操作列设最小宽度保护徽章与按钮不挤压。
+- **来源列优先显示仓库地址**：host 读取各包 `package.json` 的
+  `repository` 字段（自动清理 `git+` 前缀与 `.git` 后缀），有仓库即显示
+  仓库 URL；无仓库才回退到安装方式（link/file/github/npm/builtin）。
+- 本插件 `package.json` 补充 `repository` 字段 →
+  `https://github.com/runcat-tommy/dsh-plugin-runcat-inventory`。
+
+### 测试
+
+- mock 测试更新：`dsh-plugin-hello` 假包加 `repository`，断言
+  `sourceKind='repo'` 与 URL 清理结果；其余用例不变。5 用例全部通过。
+
+---
+
+## [0.3.0] - 2026-08-27
+
+### 国际化（界面语言随 DSH 环境自动切换）
+
+- **双语字典**：通过 DSH 内置 locale 服务（`@deepseek-ai/dsh-client-locale`）
+  注册简体中文 / English 两套字典，界面语言跟随 DSH 环境（设置 → 通用 →
+  Language 或浏览器语言）自动切换，无需重启。
+- **选项卡名**：中文"逃咪-插件总览"，英文 **Runcat Plugin Overview**
+  （label 改为 locale 函数，语言切换时自动重渲染）。
+- **全部界面文案走字典**：搜索/筛选/排序/按钮/徽章/提示/空状态等 40+ 项
+  全部 `t('key')` 化。
+- **host 彻底国际化**：
+  - 错误消息改为**错误码**（`MISSING_PARAMS`、`PATCH_READ_FAILED`、
+    `PATCH_PARSE_FAILED`、`PATCH_WRITE_FAILED` 等 13 个），由客户端字典翻译；
+  - 来源字段改为 `sourceKind`（link/file/github/npm/builtin/other）+
+    `sourceSpec`（原始 spec），显示文案由客户端翻译。
+- 终端日志（host logger）与 README/CHANGELOG 文档保持中文（运维惯例）。
+
+### 测试
+
+- mock 单元测试同步更新：来源断言改为 `sourceKind`/`sourceSpec`，
+  错误断言改为错误码；403 断言错误码 `FORBIDDEN`。5 用例全部通过。
+
+---
+
+## [0.2.1] - 2026-08-27
+
+### 变更
+
+- 插件中文名由"**逃猫**-插件总览"改为"**逃咪**-插件总览"（选项卡显示名、
+  package.json 描述与关键词、README/CHANGELOG/代码注释同步更新）。
+
+---
+
+## [0.2.0] - 2026-08-27
+
+### 界面重构（表格全面瘦身）
+
+- **表格改为固定 4 列**：`名称（含 id + 版本）/ 状态 / 来源 / 操作`，
+  删除"描述"列——描述全文移入"详情"展开行查看，列表整体变窄，
+  常规窗口宽度下基本无需横向滚动。
+- **移除粘性固定列**：名称、操作两列不再固定，极端窄窗口下随内容
+  滚动（之前保留的粘性列效果已去掉）。
+- **"详情"按钮显示规则**：有描述（非空）或 有配置（非空）才显示；
+  两者皆空不显示。空对象 `{}` / 空数组 `[]` 视为无内容。
+- **详情展开行**：colSpan 随列数调整（5→4），仍展示描述全文 +
+  配置 JSON + "复制配置"按钮。
+
+### 交互改进
+
+- **搜索**：确认采用单一联合搜索（名称 + id + 描述 + 来源 + 版本），
+  不引入字段选择器；id 在名称列下方有展示，搜索 id 可直接定位条目。
+- **描述**：保留悬浮显示全文（原生 title），移除点击描述展开
+  （该入口由"详情"按钮统一承担）。
+- **排序**：新增名称排序——`配置顺序`（默认）/ `名称 ↑` / `名称 ↓`
+  （中文 localeCompare）。
+- **键盘滚动**：表格容器聚焦后可用 ←/→ 横向滚动，Home/End 到头/尾。
+- **窄屏适配**：窗口宽度 < 900px 时自动隐藏"来源"列。
+
+### 技术修复
+
+- 修复 `node:fs` 回调版 `readFile` 误传 `'utf8'` 导致读取失败的问题
+  （改用 `node:fs/promises`）。
+- 修复 Windows 下 `require.resolve` 返回盘符路径无法直接 `import()`
+  的问题（转 file URL）。
+- 新增 `hasConfigContent` 判断，统一"配置是否有内容"的语义。
+
+### 测试
+
+- host 半端 mock 单元测试 5 用例全部通过
+  （`node test/mock-test.mjs`）：路由注册、清单采集、启用/停用写入与
+  恢复、安全校验、参数校验。
+
+---
+
+## [0.1.0] - 2026-08-27
+
+### 初始版本
+
+- 首个可用版本：7 列表格（名称 / 状态 / 版本 / 来源 / 描述 / 配置 / 操作）。
+- 数据来自 host 端 `ctx.loader.entries()` 实时采集 + 各包 `package.json`
+  补充描述/版本 + profile 清单判定来源。
+- 启用/停用：编辑 profile 的 `cordis.patch.yml`（用户覆盖层），
+  DSH 通过 HMR 热生效，无需重启 Web UI。
+- 通信：浏览器半端同源 fetch → host `/runcat-api` 路由，带 loopback
+  信任校验（防 CSRF）。
+- 配置查看/复制、复制插件名/模块名、搜索框 + 状态过滤。
+- 安装方式：`dsh plugin --profile web add .`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 runcat-tommy
+
+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.en.md

@@ -0,0 +1,120 @@
+# dsh-plugin-runcat-inventory (Runcat Plugin Overview / 逃咪-插件总览)
+
+[中文](README.md) | **English**
+
+> Version: **v0.3.7** · Changelog: [CHANGELOG.en.md](CHANGELOG.en.md) ([中文](CHANGELOG.md))
+
+A better DSH plugin list: **table view, status filters, enable/disable switches (hot-applied), config viewer and copy, automatic zh/en UI switching**.
+Sits alongside the official "Plugin list" tab, registered at **Settings → Plugins → Runcat Plugin Overview** (shown as 逃咪-插件总览 in Chinese).
+
+## Screenshot
+
+![Runcat Plugin Overview (English UI)](assets/preview-en.png)
+
+## Features
+
+| Capability | Description |
+|---|---|
+| Table view | 4 columns with fixed ratios: **Name 36% / Status 15% / Source 21% / Actions 28%** (name takes the largest share) |
+| Languages | Built-in Simplified Chinese / English; the UI follows the DSH environment (Settings → General → Language, or the browser language); the plugin's own description switches too |
+| Runtime status | Enabled/Disabled + Cordis status (Mounted / Waiting for deps / Loading / Mount failed / Not mounted / Unloading) |
+| Description / Version | Read from each package's `package.json`; the full description is shown in the expanded row (click "Details") |
+| Source | Only this plugin shows its repository home page (https://github.com/runcat-tommy/dsh-plugin-runcat-inventory); others show the install method (local link / local path / GitHub / npm / built-in) |
+| Details expansion | The "Details" button appears when a plugin has a description or a config; the expanded row shows the full description + config JSON, with one-click copy |
+| Enable / Disable | Edits the profile's `cordis.patch.yml` (user override layer), **hot-applied via HMR — no restart needed** |
+| Search & filter | Keyword (combined search over name / id / description / source / version) + status filter |
+| Sorting | Config order (default) / Name ↑ / Name ↓ |
+| Width | No sticky columns; ←/→ arrow keys scroll horizontally; the Source column hides on narrow screens |
+
+## Structure
+
+```
+dsh-plugin-runcat-inventory/   # local folder name after git clone (same as the repo)
+├── package.json      # dsh.bundle.patch + dsh.client declarations
+├── cordis.patch.yml  # patch layer: inserts this plugin entry into the root entry list
+├── lib/
+│   ├── index.js      # Host half: loader inventory + /runcat-api routes + patch file editing
+│   └── client.js     # Browser half: hand-written ModuleLoader bundle, table UI
+├── test/
+│   └── mock-test.mjs # host-half unit tests (node test/mock-test.mjs, 5 cases)
+├── assets/
+│   ├── preview-zh.png # Chinese-UI screenshot
+│   └── preview-en.png # English-UI screenshot
+├── CHANGELOG.md      # changelog (Chinese)
+├── CHANGELOG.en.md   # changelog (English)
+├── README.md         # Chinese docs
+└── README.en.md      # English docs (this file)
+```
+
+## Prerequisites
+
+| Dependency | Required? | Notes |
+|---|---|---|
+| **Node.js** | ✅ Required | DSH itself is a Node program; install Node.js (suggest 20+ or the latest LTS; no strict minimum) |
+| **DSH CLI** | ✅ Required | `npm i -g @deepseek-ai/dsh` |
+| **pnpm** | ✅ Required | `dsh plugin` forwards to pnpm; without it you get `pnpm not found on PATH`; install with `npm i -g pnpm` |
+| **Git** | ⚠️ Depends on method | Needed to clone the repo or to install from the GitHub source (`dsh plugin add github:...`); not needed for a local-folder install |
+| **Network** | ⚠️ Depends on environment | Needs access to GitHub; if direct connections fail, configure a git proxy, e.g. `git config --global http.https://github.com.proxy http://127.0.0.1:7897` |
+
+> This plugin itself has **zero dependencies**: the host half only uses Node built-ins (plus lazily resolving js-yaml from the profile), and the browser half is a hand-written ModuleLoader bundle. Nothing extra to install.
+
+## Installation
+
+Installs into the `web` profile (replace `web` with your profile name if different).
+
+### Method A: local folder (recommended for development/debugging)
+
+```sh
+git clone https://github.com/runcat-tommy/dsh-plugin-runcat-inventory.git
+cd dsh-plugin-runcat-inventory
+dsh plugin --profile web add .
+```
+
+> `dsh plugin add .` links this folder into the profile via `link:` — dev-friendly: code changes take effect after restarting the Web UI, no reinstall needed.
+
+### Method B: install directly from GitHub
+
+```sh
+dsh plugin --profile web add github:runcat-tommy/dsh-plugin-runcat-inventory
+```
+
+> pnpm pulls the repo directly from GitHub; this plugin has no build scripts, so no `allowBuilds` is needed.
+
+### Verify
+
+`dsh --profile web --dump-config` should end with an entry whose **id is `runcat-inventory` and name is `dsh-plugin-runcat-inventory`**.
+Then **restart the Web UI** and open **Settings → Plugins → Runcat Plugin Overview** (逃咪-插件总览 in Chinese).
+
+## How it works
+
+- **Data**: the host half iterates `ctx.loader.entries()` (same as the official inventory); fiber status maps from FiberState; description/version are read from each package's `package.json`; source is derived from the profile's `package.json` dependency declarations.
+- **Enable/Disable**: writes `{id, name, disabled: true}` patches into `~/.dsh/profiles/web/cordis.patch.yml` (to disable) or removes them (to enable). DSH watches this file via HMR (`watchUserPatches`) and hot-applies changes to the loader — plugins toggle instantly without a restart.
+- **Communication**: the browser half fetches same-origin `/runcat-api` routes; routes carry a loopback trust check (CSRF protection).
+- **Lazy js-yaml resolution**: when installed via `link:`, the plugin's real path is the workspace (no node_modules there), so at runtime js-yaml is resolved anchored at the profile directory.
+
+## Uninstall
+
+```sh
+dsh plugin --profile web remove dsh-plugin-runcat-inventory
+```
+
+## Known limitations
+
+- If `cordis.patch.yml` contains `!!js` expressions, the enable/disable switch reports a failure (the file is never corrupted; it just cannot be auto-edited).
+- The disable patch is matched and removed exactly as `{id, name, disabled: true}` (three keys); conflicts with hand-written content are resolved by the "exactly three keys" rule.
+
+## Changelog
+
+Full history in [CHANGELOG.en.md](CHANGELOG.en.md) ([中文](CHANGELOG.md)).
+
+- **v0.3.7** (2026-08-27): added preview screenshots — the Chinese README shows the Chinese-UI screenshot, the English README shows the English-UI screenshot (`assets/` folder).
+- **v0.3.6** (2026-08-27): docs — added `CHANGELOG.en.md` (English changelog) with language switcher links on both changelogs.
+- **v0.3.5** (2026-08-27): docs — added Method B (install from GitHub source); added `README.en.md` (English docs) with language switcher links on both READMEs.
+- **v0.3.4** (2026-08-27): docs — folder name unified to `dsh-plugin-runcat-inventory`; added the "Prerequisites" section.
+- **v0.3.3** (2026-08-27): the plugin's own description now follows the UI language (zh/en, in the Details row).
+- **v0.3.2** (2026-08-27): fix — only this plugin shows the repo URL; others show install methods again; Source column content wraps (long URLs no longer overflow into Actions).
+- **v0.3.1** (2026-08-27): fixed column ratios (Name 36% / Status 15% / Source 21% / Actions 28%); Source shows the repo URL for this plugin.
+- **v0.3.0** (2026-08-27): i18n — zh/en dictionaries via the DSH locale service; host errors become error codes; source becomes kind+spec.
+- **v0.2.1** (2026-08-27): Chinese name changed from 逃猫-插件总览 to 逃咪-插件总览.
+- **v0.2.0** (2026-08-27): 4-column layout, details expansion, name sorting, keyboard scrolling, narrow-screen adaptation; two cross-platform bug fixes; mock unit tests.
+- **v0.1.0** (2026-08-27): initial release — 7-column table, enable/disable (HMR hot-applied), config viewer/copy, search filters.