dsh-multi-chat 0.6.8 → 1.0.1

package/README.md

@@ -48,13 +48,16 @@ Install a **multi-window wall** into the official [DeepSeek Harness (DSH)](https
 ## 🚀 30-second quick start
 
 ```bash
-# 1. Install (npm / npx, no manual patch needed)
+# 1. Install — ONE command straight from the npm registry (no CLI to download):
+dsh plugin --profile web add dsh-multi-chat
+
+#    …or via the plugin's own npx CLI (packs a tarball and installs it):
 npx dsh-multi-chat install
 
 # 2. Start a few instances
 npx dsh-multi-chat start --ports 3080,3081,3082
 
-# 3. Open any instance and click "Multi-window" in the sidebar footer → done 🎉
+# 3. (Re)start any instance and click "Multi-window" in the sidebar footer → done 🎉
 ```
 
 ## Why this approach
@@ -67,18 +70,16 @@ npx dsh-multi-chat start --ports 3080,3081,3082
 ## Directory layout
 
 ```
-plugin/dsh-client-ui-multi-wall/   # spec-compliant client plugin package (node half + browser half)
+dsh-multi-chat/                    # single-package structure
   lib/                             # built artifacts (lib/index.js + lib/client.js + types)
-  src/                             # source (mirrors the official monorepo packages/client/ui-multi-wall)
-patches/multi-wall.yml             # optional `--patch` overlay (usually not needed; the plugin auto-mounts via dsh.bundle)
-scripts/
-  install-plugin.ps1               # pack + install into profile (DSH auto-mounts the bundle) + prompt restart
-  start-multi.ps1 / stop-multi.ps1 # start/stop multiple dsh web instances (-Remote can carry an authenticated gateway)
-  gateway.mjs                      # token-authenticated / optional-TLS reverse-proxy gateway (phone/remote access)
-  gateway-hidden.vbs               # no-window launcher: starts gateway.mjs hidden (no console flash)
-  gateway-start.ps1 / gateway-stop.ps1  # one-shot silent start/stop of the gateway
-bin/dsh-multi-chat.mjs             # cross-platform npx CLI (install/start/stop/gateway)
-harness-src/                       # official deepseek-harness source (dev/build reference)
+  src/                             # source (node half + browser half)
+  bin/dsh-multi-chat.mjs           # cross-platform npx CLI (install/start/stop/gateway)
+  scripts/
+    install-plugin.ps1             # pack + install into profile (DSH auto-mounts the bundle)
+    start-multi.ps1 / stop-multi.ps1 # start/stop multiple dsh web instances
+    gateway.mjs                    # token-authenticated reverse-proxy gateway (phone/remote)
+  cordis.patch.yml                 # DSH bundle layer declaration
+  harness-src/                     # official deepseek-harness source (dev/build reference)
 ```
 
 ## Install & enable (Windows)
@@ -96,14 +97,14 @@ dsh web --port 3084
 Or manual:
 
 ```bash
-cd plugin/dsh-client-ui-multi-wall && npm pack          # produce a tarball
-dsh plugin --profile web add <tarball>                  # DSH adds the package to the bundle layer stack automatically
+npm pack                                                  # produce a tarball (dsh-multi-chat-1.0.1.tgz)
+dsh plugin --profile web add dsh-multi-chat-1.0.1.tgz     # DSH adds the package to the bundle layer stack automatically
 ```
 
-Uninstall (one command, nothing manual to clean up):
+Uninstall (one command, nothing manual to clean up — restart `dsh web` to unload it):
 
 ```bash
-dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-multi-wall
+dsh plugin --profile web remove dsh-multi-chat
 ```
 
 ## Usage
@@ -133,27 +134,49 @@ Open that URL on your phone and enter the token to reach the full DSH UI. The ga
 
 ## Distribution & install
 
-The repo bundles a cross-platform CLI, `dsh-multi-chat` (`bin/dsh-multi-chat.mjs`), installable through any of the three channels below. Its `install` command probes `$DSH_HOME` (default `~/.dsh`) and idempotently appends the enable patch (same behavior as `install-plugin.ps1`).
+`dsh-multi-chat` is published to npm (unscoped public package) and released on GitHub (source zip/tarball per tag). Every channel below ends in the same three things: the package lands as a dependency of the web profile, DSH reconciles it into the bundle layer stack (the package declares `dsh.bundle.patch`, so its own `cordis.patch.yml` is mounted automatically — no manual patch edits), and a `dsh web` restart loads the wall.
+
+### Install / uninstall cheat-sheet
+
+| Channel | Install | Uninstall |
+|---------|---------|-----------|
+| **One-command (registry)** | `dsh plugin --profile web add dsh-multi-chat` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **npx (no download)** | `npx dsh-multi-chat install` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **Global CLI (npm)** | `npm i -g dsh-multi-chat` then `dsh-multi-chat install` | `dsh plugin --profile web remove dsh-multi-chat` then `npm rm -g dsh-multi-chat` |
+| **Tarball (offline)** | `npm pack` → `dsh plugin --profile web add ./dsh-multi-chat-1.0.1.tgz` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **Git clone** | `node bin/dsh-multi-chat.mjs install` | `dsh plugin --profile web remove dsh-multi-chat` |
+
+> `dsh plugin --profile web remove dsh-multi-chat` is the **single uninstall
+> command for every channel**: it removes the dependency from the profile, and
+> DSH strips it from the `dsh.profile.bundles` layer stack automatically
+> (reconciled from the installed dependency set — see `dsh plugin --help`).
+> Restart `dsh web` afterwards to unload the wall.
+
+The repo also bundles a cross-platform CLI, `dsh-multi-chat` (`bin/dsh-multi-chat.mjs`). Its `install` command probes `$DSH_HOME` (default `~/.dsh`), packs the package into the profile's `plugins/` folder, and runs `dsh plugin --profile web add <tarball>` (same behavior as `install-plugin.ps1`).
 
 ### Channel 1: npm / npx (recommended, easiest)
 
 ```bash
-# After publishing to npm, one line installs on any machine
+# Published on npm — one line installs on any machine (node + pnpm required)
 npx dsh-multi-chat install
 
-# Or run a single command straight from npx (no install needed)
+# Or install the CLI globally, then install the plugin from anywhere
+npm i -g dsh-multi-chat
+dsh-multi-chat install
+
+# Or run single commands straight from npx (no plugin install needed)
 npx dsh-multi-chat start --remote --token <token> --ports 3080,3081
 npx dsh-multi-chat gateway --target 127.0.0.1:3080 --token <token>
 ```
 
-Publishing (maintainer): `npm publish` (unscoped public package `dsh-multi-chat`).
+Maintaining / republishing (maintainer): `npm publish` (unscoped public package `dsh-multi-chat`).
 
 ### Channel 2: GitHub Release
 
 Download the source zip/tarball from [Releases](https://github.com/daetz-coder/dsh-multi-chat/releases), unpack it, and cd in:
 
 ```bash
-node bin/dsh-multi-chat.mjs install           # pack + dsh plugin add + append enable patch
+node bin/dsh-multi-chat.mjs install           # pack + dsh plugin add (see cheat-sheet)
 node bin/dsh-multi-chat.mjs start --ports 3080,3081
 ```
 
@@ -165,11 +188,13 @@ node bin/dsh-multi-chat.mjs start --ports 3080,3081
 git clone https://github.com/daetz-coder/dsh-multi-chat.git
 cd dsh-multi-chat
 
-node bin/dsh-multi-chat.mjs install           # install the plugin
+node bin/dsh-multi-chat.mjs install           # pack + dsh plugin add (see cheat-sheet)
 node bin/dsh-multi-chat.mjs start --ports 3080,3081
 node bin/dsh-multi-chat.mjs gateway --target 127.0.0.1:3080 --token <token>
 ```
 
+> For the one-command-on-this-machine flow, `dsh plugin --profile web add dsh-multi-chat` also works straight from a git clone — install the plugin _from_ the repo checkout without packaging it yourself.
+
 ### Running straight from this repo (development)
 
 ```bash
@@ -184,20 +209,53 @@ node bin/dsh-multi-chat.mjs gateway --target 127.0.0.1:3080 --token <token>
 This plugin follows the official [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) client plugin spec:
 
 - **Be found in the GitHub plugin ecosystem**: adding the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic to this repo makes it searchable on the official [`dsh-plugin` topic page](https://github.com/topics/dsh-plugin) (the officially recommended third-party discovery path).
-- **Bilingual technical docs**: under `plugin/dsh-client-ui-multi-wall/` there is `README.md` (English), `README.zh.md` (Chinese), and `README.i18n.yaml` (bilingual consistency record), matching the structure of official `packages/client/*` plugins.
+- **Bilingual technical docs**: this repo ships `README.md` (English) and `README.zh.md` (Chinese) at the root, matching the bilingual convention of official `packages/client/*` plugins.
 - **Purely additive, no core touching**: registers only the `conversation.view` / `sidebar.footer.action` list slots + `/multi/api/*` read-only routes, changing no official core logic.
 
-## Where it lives in the official monorepo
+## Building from source
 
-`packages/client/ui-multi-wall` is a spec-compliant client plugin package (separate host/client tsconfig, tsdown clientBundle, zh/en locales, invariant companion, HMR-safe tests) wired into `packages/bundle/web-app`'s dsh.client roster and the `tsconfig.client.json` aggregate. To build:
+The single-package layout uses `tsdown` for bundling and `tsc` for type declarations:
 
 ```bash
-cd harness-src
-pnpm install
-pnpm --filter @deepseek-ai/dsh-client-ui-multi-wall bundle   # produces lib/client.js
-npx vitest run packages/client/ui-multi-wall                 # 14 tests
+npm install
+npm run build          # tsc + tsdown → lib/
+npm test               # vitest (browser half in jsdom + node half)
 ```
 
+## Testing
+
+The unit suite (`tests/browser-plugin.client.spec.tsx`, 20 specs) exercises the
+browser half (view-ring entry, sidebar shortcut, wall store, recursion guard,
+HMR disposal) against a real cordis Context in jsdom, plus the node half
+(probe routes, config schema, stop semantics).
+
+The specs import `@deepseek-ai/*` platform packages whose published versions
+lag the snapshot this plugin was written against, so tests resolve them to the
+**vendored harness sources** in `harness-src/` instead of npm:
+
+1. First install the vendored workspace once (it is a full DSH checkout):
+   ```bash
+   cd harness-src && pnpm install && cd ..
+   ```
+2. `tsconfig.vitest.json` carries the workspace's `tsconfig.base.json` paths
+   map (rewritten with a `harness-src/` prefix) so every `@deepseek-ai/*`
+   import resolves to sources — never to unbuilt `lib/` outputs. Regenerate it
+   after updating the vendored checkout:
+   ```bash
+   node scripts/sync-vitest-paths.mjs
+   ```
+3. `vitest.config.ts` feeds that map to `vite-tsconfig-paths` and dedupes
+   `react`/`react-dom` so the component specs and `@testing-library/react`
+   share one React instance. Then:
+
+   ```bash
+   npm test
+   ```
+
+> `npm run build`'s `tsc` step resolves `@deepseek-ai/*` types from the
+> installed workspace (or from npm-installed versions on a machine with the
+> matching snapshot); the committed `lib/` is the reference output.
+
 ## License
 
 MIT

package/README.zh.md

@@ -48,13 +48,16 @@
 ## 🚀 30 秒上手
 
 ```bash
-# 1. 安装（npm / npx，免手工打包补丁）
+# 1. 安装 —— 从 npm 官方源一条命令搞定（无需下载任何 CLI）：
+dsh plugin --profile web add dsh-multi-chat
+
+#    ……或通过插件自带的 npx CLI（先打包再安装）：
 npx dsh-multi-chat install
 
 # 2. 启动几个实例
 npx dsh-multi-chat start --ports 3080,3081,3082
 
-# 3. 打开任意实例，点侧边栏底部「多窗口」→ 完成 🎉
+# 3.（重新）打开任意实例，点侧边栏底部「多窗口」→ 完成 🎉
 ```
 
 ## 为什么这样做
@@ -67,18 +70,16 @@ npx dsh-multi-chat start --ports 3080,3081,3082
 ## 目录结构
 
 ```
-plugin/dsh-client-ui-multi-wall/   # 官方规范 client 插件包（node half + browser half）
+dsh-multi-chat/                    # 单包结构
   lib/                             # 已构建产物（lib/index.js + lib/client.js + 类型）
-  src/                             # 源码（与官方 monorepo packages/client/ui-multi-wall 一致）
-patches/multi-wall.yml             # 可选 `--patch` overlay（通常不需要；插件经 dsh.bundle 自动挂载）
-scripts/
-  install-plugin.ps1               # 打包 + 装进 profile（DSH 自动挂载 bundle 层）+ 提示重启
-  start-multi.ps1 / stop-multi.ps1 # 启停多个 dsh web 实例（-Remote 可带认证网关）
-  gateway.mjs                      # 带令牌认证 / 可选 TLS 的反向代理网关（手机/远程访问）
-  gateway-hidden.vbs               # 无窗口启动器：用隐藏窗口方式启动 gateway.mjs（不弹控制台）
-  gateway-start.ps1 / gateway-stop.ps1  # 一键静默启动/停止网关
-bin/dsh-multi-chat.mjs             # 跨平台 npx CLI（install/start/stop/gateway）
-harness-src/                       # 官方 deepseek-harness 源码（开发/构建用）
+  src/                             # 源码（node half + browser half）
+  bin/dsh-multi-chat.mjs           # 跨平台 npx CLI（install/start/stop/gateway）
+  scripts/
+    install-plugin.ps1             # 打包 + 装进 profile（DSH 自动挂载 bundle 层）
+    start-multi.ps1 / stop-multi.ps1 # 启停多个 dsh web 实例
+    gateway.mjs                    # 带令牌认证的反向代理网关（手机/远程访问）
+  cordis.patch.yml                 # DSH bundle 层声明
+  harness-src/                     # 官方 deepseek-harness 源码（开发/构建用）
 ```
 
 ## 安装与启用（Windows）
@@ -96,14 +97,14 @@ dsh web --port 3084
 或手动：
 
 ```bash
-cd plugin/dsh-client-ui-multi-wall && npm pack          # 得到 tarball
-dsh plugin --profile web add <tarball>                  # DSH 自动把包加入 bundle 层栈
+npm pack                                                  # 得到 tarball (dsh-multi-chat-1.0.1.tgz)
+dsh plugin --profile web add dsh-multi-chat-1.0.1.tgz     # DSH 自动把包加入 bundle 层栈
 ```
 
-卸载（一条命令，无需手动清理任何文件）：
+卸载（一条命令，无需手动清理任何文件 —— 重启 `dsh web` 后生效）：
 
 ```bash
-dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-multi-wall
+dsh plugin --profile web remove dsh-multi-chat
 ```
 
 ## 使用
@@ -133,27 +134,47 @@ dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-multi-wall
 
 ## 分发与安装
 
-仓库内置跨平台 CLI `dsh-multi-chat`（`bin/dsh-multi-chat.mjs`），下面三种渠道都可安装。CLI 的 `install` 会探测 `$DSH_HOME`（缺省 `~/.dsh`）并幂等地追加启用 patch（与 `install-plugin.ps1` 行为一致）。
+`dsh-multi-chat` 已发布到 npm（无作用域公开包），并在 GitHub 按 tag 发布 Release（源码 zip/tarball）。下面每条渠道殊途同归：包成为 web profile 的依赖 → DSH 自动调和进 bundle 层栈（包声明了 `dsh.bundle.patch`，自带 `cordis.patch.yml` 自动挂载，无需手改任何文件）→ 重启 `dsh web` 生效。
+
+### 安装 / 卸载速查表
+
+| 渠道 | 安装 | 卸载 |
+|------|------|------|
+| **一条命令（npm 官方源）** | `dsh plugin --profile web add dsh-multi-chat` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **npx（免下载）** | `npx dsh-multi-chat install` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **全局 CLI（npm）** | `npm i -g dsh-multi-chat` 然后 `dsh-multi-chat install` | `dsh plugin --profile web remove dsh-multi-chat` 然后 `npm rm -g dsh-multi-chat` |
+| **Tarball（离线）** | `npm pack` → `dsh plugin --profile web add ./dsh-multi-chat-1.0.1.tgz` | `dsh plugin --profile web remove dsh-multi-chat` |
+| **Git clone** | `node bin/dsh-multi-chat.mjs install` | `dsh plugin --profile web remove dsh-multi-chat` |
+
+> `dsh plugin --profile web remove dsh-multi-chat` 是**所有渠道统一的卸载命令**：
+> 它从 profile 移除依赖，DSH 会自动把它从 `dsh.profile.bundles` 层栈里剔除
+> （层栈按已安装依赖实时调和，详见 `dsh plugin --help`）。之后重启 `dsh web` 卸载生效。
+
+仓库还内置了一个跨平台 CLI `dsh-multi-chat`（`bin/dsh-multi-chat.mjs`）。它的 `install` 命令会探测 `$DSH_HOME`（缺省 `~/.dsh`），把包打包进 profile 的 `plugins/` 目录，再执行 `dsh plugin --profile web add <tarball>`（与 `install-plugin.ps1` 行为一致）。
 
 ### 渠道一：npm / npx（推荐，最省事）
 
 ```bash
-# 发布到 npm 后，任意机器一句话安装
+# 已发布到 npm —— 任意机器一句话安装（需 node + pnpm）
 npx dsh-multi-chat install
 
-# 或直接 npx 跑单条命令（无需安装）
+# 或全局装 CLI，再从任意目录安装插件
+npm i -g dsh-multi-chat
+dsh-multi-chat install
+
+# 或直接用 npx 跑单条命令（无需安装插件）
 npx dsh-multi-chat start --remote --token <口令> --ports 3080,3081
 npx dsh-multi-chat gateway --target 127.0.0.1:3080 --token <口令>
 ```
 
-维护者发布：`npm publish`（无作用域公开包 `dsh-multi-chat`）。
+维护者发布/再发布：`npm publish`（无作用域公开包 `dsh-multi-chat`）。
 
 ### 渠道二：GitHub Release
 
 从 [Releases](https://github.com/daetz-coder/dsh-multi-chat/releases) 下载源码 zip/tarball，解压后进目录：
 
 ```bash
-node bin/dsh-multi-chat.mjs install           # 打包 + dsh plugin add + 追加启用 patch
+node bin/dsh-multi-chat.mjs install           # 打包 + dsh plugin add（见速查表）
 node bin/dsh-multi-chat.mjs start --ports 3080,3081
 ```
 
@@ -165,11 +186,13 @@ node bin/dsh-multi-chat.mjs start --ports 3080,3081
 git clone https://github.com/daetz-coder/dsh-multi-chat.git
 cd dsh-multi-chat
 
-node bin/dsh-multi-chat.mjs install           # 装插件
+node bin/dsh-multi-chat.mjs install           # 打包 + dsh plugin add（见速查表）
 node bin/dsh-multi-chat.mjs start --ports 3080,3081
 node bin/dsh-multi-chat.mjs gateway --target 127.0.0.1:3080 --token <口令>
 ```
 
+> 在 git clone 出来的仓库里也可以直接走一条命令：`dsh plugin --profile web add dsh-multi-chat` —— 直接从已发布版本安装，无需自己打包。
+
 ### 本仓库直接运行（开发）
 
 ```bash
@@ -184,20 +207,21 @@ node bin/dsh-multi-chat.mjs gateway --target 127.0.0.1:3080 --token <口令>
 本插件遵循 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 官方 client 插件规范：
 
 - **在 GitHub 插件生态中被发现**：给本仓库添加 [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic，即可在官方 [`dsh-plugin` topic 页](https://github.com/topics/dsh-plugin) 被搜索到（官方推荐的第三方插件发现方式）。
-- **三语技术文档**：插件包 `plugin/dsh-client-ui-multi-wall/` 下提供 `README.md`（英文）、`README.zh.md`（中文）与 `README.i18n.yaml`（双语一致性记录），结构与官方 `packages/client/*` 插件一致。
+- **双语技术文档**：本仓库在根目录提供 `README.md`（英文）和 `README.zh.md`（中文），与官方 `packages/client/*` 插件的双语惯例一致。
 - **纯增量、不碰核心**：只注册 `conversation.view` / `sidebar.footer.action` 两个列表槽位 + `/multi/api/*` 只读路由，不改动任何官方核心逻辑。
 
-## 在官方 monorepo 中的位置
+## 从源码构建
 
-`packages/client/ui-multi-wall` 是遵循官方 client 插件规范的包（tsconfig host/client 分离、tsdown clientBundle、locales zh/en、invariant 伴随、HMR 安全测试），并已接入 `packages/bundle/web-app` 的 dsh.client roster 与 `tsconfig.client.json` 聚合。构建：
+单包结构使用 `tsdown` 进行打包，`tsc` 生成类型声明：
 
 ```bash
-cd harness-src
-pnpm install
-pnpm --filter @deepseek-ai/dsh-client-ui-multi-wall bundle   # 产出 lib/client.js
-npx vitest run packages/client/ui-multi-wall                 # 14 项测试
+npm install
+npm run build          # tsc + tsdown → lib/
+npx vitest run         # 测试
 ```
 
+开发时可借助 `harness-src/` 目录（完整 DSH 源码）作为构建和参考工作区。
+
 ## License
 
 MIT

package/bin/dsh-multi-chat.mjs

@@ -29,7 +29,6 @@ import { fileURLToPath } from 'node:url'
 
 const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
 const STATE_FILE = join(ROOT, '.wall-pids.json')
-const PLUGIN_DIR = join(ROOT, 'plugin', 'dsh-client-ui-multi-wall')
 
 // Node ≥22 warns about spawn(shell:true, args[]) (DEP0190). The args here are
 // fixed strings we control (numeric ports, our own paths), so the warning is
@@ -123,11 +122,11 @@ const INSTALL_HELP = `dsh-multi-chat install — install the multi-window wall p
 Usage:
   dsh-multi-chat install [--profile web]
 
-Packs plugin/dsh-client-ui-multi-wall and installs the tarball into the profile
-with \`dsh plugin --profile <p> add\`. The plugin declares \`dsh.bundle.patch\`
+Packs the dsh-multi-chat package and installs the tarball into the profile
+with \`dsh plugin --profile <p> add\`. The package declares \`dsh.bundle.patch\`
 (pointing at its own cordis.patch.yml), so DSH mounts it automatically as a
 bundle layer — no manual profile patch is needed. Restart dsh web afterwards.
-Uninstall with: dsh plugin --profile <p> remove @deepseek-ai/dsh-client-ui-multi-wall
+Uninstall with: dsh plugin --profile <p> remove dsh-multi-chat
 `
 
 async function cmdInstall(args) {
@@ -137,17 +136,14 @@ async function cmdInstall(args) {
     else if (args[i] === '--help') { process.stdout.write(INSTALL_HELP); return }
     else throw new Error(`unknown install option: ${args[i]}`)
   }
-  if (!existsSync(PLUGIN_DIR)) {
-    throw new Error(`plugin directory not found: ${PLUGIN_DIR} — run from the dsh-multi-chat package root`)
-  }
 
-  // 1) pack the plugin tarball into a STABLE location under DSH home. The
+  // 1) pack the tarball into a STABLE location under DSH home. The
   // profile records a `file:` dependency on the tarball, so a temp directory
   // (deleted after install) would break every later `dsh plugin add` — the
   // tarball must outlive the CLI run. (npm pack is offline-safe.)
   const stableDir = join(dshHome(), 'profiles', profile, 'plugins')
   mkdirSync(stableDir, { recursive: true })
-  const packOut = run('npm', ['pack', '--pack-destination', stableDir], { cwd: PLUGIN_DIR })
+  const packOut = run('npm', ['pack', '--pack-destination', stableDir], { cwd: ROOT })
   const tarballName = packOut.trim().split(/\r?\n/).pop()
   const tarball = join(stableDir, tarballName)
   if (!existsSync(tarball)) throw new Error('npm pack produced no tarball')