@jingyi0605/codingns4dsh 0.1.7-rc.3 → 0.2.0-beta.2

package/README.en.md

@@ -5,12 +5,13 @@
 **External Agent CLIs, persistent terminals, workspace debug and remote access — inside DSH's own UI.**
 
 [![npm version](https://img.shields.io/npm/v/%40jingyi0605%2Fcodingns4dsh?logo=npm)](https://www.npmjs.com/package/@jingyi0605/codingns4dsh)
-[![DSH compatibility](https://img.shields.io/badge/DSH-%3E%3D0.1.5--rc.3%20%3C%3D0.1.7--rc.2-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+[![DSH compatibility](https://img.shields.io/badge/DSH-0.2.0--rc.2-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.19-3C873A?logo=node.js&logoColor=white)](https://nodejs.org)
+[![License: GPL-3.0-or-later](https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
 
 [简体中文](README.md) · **English**
 
-**Current release `@jingyi0605/codingns4dsh@0.1.7-rc.3`** · DSH **`>=0.1.5-rc.3 <=0.1.7-rc.2`** (validated `0.1.5-rc.3`, `0.1.6-alpha.2`, `0.1.7-rc.2`) · Node **`>= 22.19`** · macOS / Linux / Windows
+**Current release `@jingyi0605/codingns4dsh@0.2.0-beta.2`** · DSH **`0.2.0-rc.2`** (the only formally supported and validated version) · Node **`>= 22.19`** · macOS / Linux / Windows
 
 **[GitHub](https://github.com/jingyi0605/Codingns4DSH)** · **[npm](https://www.npmjs.com/package/@jingyi0605/codingns4dsh)** · **QQ group 1092985965**
 
@@ -23,7 +24,8 @@
   <a href="#first-run">First run</a> ·
   <a href="#troubleshooting">Troubleshooting</a> ·
   <a href="#development">Development</a> ·
-  <a href="#acknowledgements">Acknowledgements</a>
+  <a href="#acknowledgements">Acknowledgements</a> ·
+  <a href="#license">License</a>
 </p>
 
 </div>
@@ -42,7 +44,7 @@ The CodingNS workbench brings the conversation, Agent picker and Git sidebar tog
 
 **DSH (DeepSeek Harness)** is a coding-agent harness — a CLI plus Web UI that runs an agent loop inside your workspace.
 
-**Codingns4DSH is a DSH plugin bundle** (Host + browser layers) adding seven modules, all configured under **Settings → Codingns4DSH**.
+**Codingns4DSH is a DSH plugin bundle** (Host + browser layers) adding eleven modules, all configured under **Settings → Codingns4DSH**.
 
 > Naming: this plugin is **Codingns4DSH** (npm package `@jingyi0605/codingns4dsh`; its settings entry is labelled Codingns4DSH). **Codingns4DSH** on its own refers to the platform service that provides the Control API, accounts and the relay tunnel.
 
@@ -50,17 +52,21 @@ The CodingNS workbench brings the conversation, Agent picker and Git sidebar tog
 | --- | --- | :---: |
 | **External Agent integration** | Run installed Agent CLIs as native DSH sessions: streaming, tools, approvals, questions, usage, thinking levels | On |
 | **Workspace session enhancement** | Agent logos on session rows, archived-session entry, subscription/usage readout | Off |
+| **Mobile access enhancements** | On phones or narrow viewports, collapse the main sidebar, turn the settings navigation into an icon rail, support horizontal swipes, Android vibration and LAN PWA notifications | On |
 | **Terminal enhancement** | Persistent terminals plus shell, theme, font, cursor and scrollback settings | Off · restart |
-| **LAN access to DSH** | Listener forwarding a LAN address to the local DSH Web port | Always on |
+| **LAN access to DSH** | Listener forwarding a LAN address to the local DSH Web port, with a status indicator and one-click copy of a usable access URL | Always on |
 | **Login protection** | One optional local account guarding LAN **and** relay access; loopback always allowed | Always on (card) |
 | **Relay access service** | **Your DSH Web from anywhere on the internet**, end-to-end encrypted | Off |
 | **Workspace debug** | Per-workspace launch profiles, port checks, HTTP service proxy | On |
+| **Git repository management** | View changes, stage files, commit and browse Git history in the right sidebar | On |
+| **File management enhancement** | Create, rename, move, copy and delete files/directories, with code and script detection | Off |
+| **PeerHost workbench** | Proxy other handshaken DSH Hosts and aggregate workspaces, sessions and scoped tools | Off |
 
 Nothing native is replaced — conversations, sessions, sidebar, settings and approvals stay DSH's own.
 
 Everything runs on the **Host** (your machine): Agents, terminals, files, LAN/relay listeners; the browser is only a view. Agent CLIs run as DSH child processes with their own credentials and providers — model traffic never goes through Codingns4DSH. Remote access is available through optional modules.
 
-Notes: the sidebar terminal exists as soon as the plugin is installed — **Terminal enhancement** only switches it to the persistent backend (tmux on macOS/Linux, ConPTY on Windows) and applies on restart; on DSH `0.1.5.x` Codingns4DSH runs in compatibility mode (no multi-tab or shell selection) and the cards say so; the 调试 card is currently Chinese-only.
+Notes: the sidebar terminal exists as soon as the plugin is installed — **Terminal enhancement** only switches it to the persistent backend (tmux on macOS/Linux, ConPTY on Windows) and applies on restart; the 调试 card is currently Chinese-only.
 
 ---
 
@@ -102,9 +108,11 @@ After you pick an Agent and a model, Codingns4DSH starts (or resumes) that CLI a
 
 The model list is read from each CLI and can be switched at any time; the composer button also shows the current model and thinking effort.
 
+External Agents assemble their own requests, so the context panel's heuristic composition never matches the provider-reported usage; those sessions keep only the occupancy percentage and totals, without the System / Tools / Messages breakdown.
+
 ### Session Enhancement and Usage
 
-Session rows show the Agent logo and archive entry, and the composer dock shows subscription or upstream usage for Agents whose limits can be read (cache hit rate, per-model stats and cost included).
+Session rows show the Agent logo and archive entry, and the composer dock shows subscription or upstream usage for Agents whose limits can be read (cache hit rate, per-model stats and cost included). The "Settings" button next to "Show subscription and usage" adjusts the query timeout (10 seconds by default, applied to every Agent) and the auto refresh interval (5 minutes by default, 0 disables automatic refresh); switching back to the same Agent within the interval reuses the previous result instead of querying upstream again.
 
 <div align="center">
   <table>
@@ -132,6 +140,18 @@ Each workspace keeps its own launch profiles (`<workspace>/.codingns/debug.json`
 
 The panel shows live port state and PID, and issues an unguessable proxy URL per running instance.
 
+### Git Repository Management
+
+The Git panel is opened from DSH's native right sidebar and persists per workspace across sessions. It can initialize a repository, show staged and unstaged files, stage or unstage paths, discard changes, create commits, switch branches and browse commit history. Disabling the module removes its sidebar tab and Host Git RPC without affecting other modules.
+
+### File Management Enhancement
+
+File management enhancement adds common file operations to DSH's native file sidebar: create files and directories, rename, move, copy and delete entries, with code and script type detection for the editor entry point. Workspace path validation rejects paths outside the active workspace; disabling the module removes its sidebar entry and Host RPC.
+
+### PeerHost Workbench
+
+PeerHost proxies other DSH Hosts without replacing the current logged-in Host. It can add LAN peers, persist target configuration and login state, and route workspaces, sessions, chat input, live events, files, Git, terminals and right-sidebar tools through an explicit HostScope. A failing peer does not block the local Host or other peers. Unsupported native navigation surfaces report `degraded` or `unsupported` instead of creating an iframe or pretending to be a native three-column view.
+
 ### Modules and Settings
 
 The settings page renders one card per module — switch, description and restart notice all come from the module itself; terminal appearance, LAN mapping, login protection and relay account are configured inside their own cards.
@@ -196,14 +216,14 @@ The “access” line tells you whether you entered DSH Web locally, over the LA
 
 ## Installation
 
-**Requirements**: DSH inside `>=0.1.5-rc.3 <=0.1.7-rc.2` (plugin and DSH versions ship independently; both the installer and the runtime reject unsupported versions) · Node.js `>= 22.19` · `pnpm` on `PATH` (`dsh plugin` forwards to pnpm) · optional: Agent CLIs, and `tmux` on macOS/Linux for persistent terminals (`brew install tmux` / `sudo apt install tmux`).
+**Requirements**: DSH `0.2.0-rc.2` · Node.js `>= 22.19` · `pnpm` on `PATH` (`dsh plugin` forwards to pnpm) · optional: Agent CLIs, and `tmux` on macOS/Linux for persistent terminals (`brew install tmux` / `sudo apt install tmux`).
 
 ### Simplest install: use the built-in `web` profile
 
 DSH automatically initializes the `web` profile on first use. You do not need to create a config file or run `--dump-config`:
 
 ```bash
-dsh plugin --profile web add @jingyi0605/codingns4dsh@0.1.7-rc.3
+dsh plugin --profile web add @jingyi0605/codingns4dsh@0.2.0-beta.2
 dsh web
 ```
 
@@ -213,7 +233,7 @@ If you do not want to modify the built-in `web` profile, create a separate profi
 
 ```bash
 dsh codingns --from-default-profile web --dump-config
-dsh plugin --profile codingns add @jingyi0605/codingns4dsh@0.1.7-rc.3
+dsh plugin --profile codingns add @jingyi0605/codingns4dsh@0.2.0-beta.2
 dsh codingns
 ```
 
@@ -234,7 +254,7 @@ dsh plugin --profile web remove @jingyi0605/codingns4dsh
 ```bash
 git clone https://github.com/jingyi0605/Codingns4DSH.git && cd Codingns4DSH
 pnpm install && pnpm build
-dsh plugin --profile web add "$PWD"                # or: npm pack, then add ./jingyi0605-codingns4dsh-0.1.7-rc.2.tgz
+dsh plugin --profile web add "$PWD"                # or: npm pack, then add ./jingyi0605-codingns4dsh-0.2.0-beta.2.tgz
 dsh web
 ```
 
@@ -264,11 +284,12 @@ A directory install links the checkout — rebuild (`pnpm build` / `pnpm dev:wat
 
 ## Troubleshooting
 
-- **Versions** — `dsh --version`, `dsh plugin --profile web list --depth 0` (replace `web` for a separate profile), `npm view @jingyi0605/codingns4dsh version`; install and startup both reject DSH outside the supported range.
+- **Versions** — `dsh --version`, `dsh plugin --profile web list --depth 0` (replace `web` for a separate profile), `npm view @jingyi0605/codingns4dsh version`; startup rejects DSH outside the supported range, and installation does too whenever it can identify the runtime actually in use.
+- **Install-time rejection from a stale `dsh` on `PATH`** — installation only blocks on the host-injected version, the Desktop Runtime root, and a `@deepseek-ai/dsh` resolvable from the profile; `dsh --version` from `PATH` is advisory and never blocks. Runtime still validates the DSH that actually loaded.
 - **`patch: entry "terminal-controller" not found`** — the profile lacks the Web app layer; recreate it from the `web` template as shown above.
 - **Agent not detected** — run `<cli> --version` on the Host; ensure its directory is on the `PATH` of the process that started DSH (GUI launchers often differ); log in with the vendor tool, then restart DSH.
 - **Terminal** — persistent mode needs `tmux` on macOS/Linux; enabling/disabling the module and changing the binding scope need a restart; terminals are addressed per workspace.
-- **LAN** — check the card's forwarding line, allow the port through the firewall, keep both devices on one network; with several DSH instances pick the detected port manually; sign in first when login protection is on.
+- **LAN** — check the card's status indicator and access URL, allow the port through the firewall, keep both devices on one network; with several DSH instances pick the detected port manually; sign in first when login protection is on.
 - **Relay** — verify Control API reachability, log in again if the session expired, refresh devices, then bind the Host.
 - **Logs** — `CODINGNS4DSH_TUNNEL_DEBUG=1 dsh codingns --no-open` (metadata only); pnpm install logs live in `$DSH_HOME/profiles/<profile>/.plugin-manager/logs/`.
 - **Reporting** — include DSH and Codingns4DSH versions, OS, module and exact error: [GitHub Issues](https://github.com/jingyi0605/Codingns4DSH/issues) or QQ **1092985965**.
@@ -282,7 +303,7 @@ Requires Node `>= 22.19` and pnpm:
 ```bash
 pnpm install
 pnpm build            # version check -> tsc -> client + H5 bundles
-pnpm test             # build, then 61 suites under tests/
+pnpm test             # build, then the full test suite (currently 901 cases)
 pnpm typecheck
 pnpm run capability:check   # capability retirement check
 ```
@@ -291,7 +312,7 @@ Dev loop: `pnpm dev:watch` with `pnpm dev:link <profile>`, then restart DSH. Ver
 
 Layout: `src/host` (Host layer), `src/client` (browser layer), `src/dsh-capabilities` (capability registry and version routing), `src/shared/contracts`, `src/transport` (tunnel + WebRTC), `src/features` (module registry), `tests/`, `specs/`, `docs/`, `data/build` (git-ignored).
 
-A `v*` tag runs GitHub Actions (tag/version check, frozen install, typecheck, tests, `npm pack`) and publishes with provenance; prereleases get the `next` dist-tag. Roadmap: PeerHost, file management, workspace sessions, debug-proxy completion (auth + WebSocket), Git, SKILL, more.
+A `v*` tag runs GitHub Actions (tag/version check, frozen install, typecheck, tests, `npm pack`) and publishes with provenance; prereleases get the `next` dist-tag. Releases also run DSH installation replay, runtime module resolution and per-file npm artifact checks.
 
 Screenshot assets and shot list: [assets/screenshots](assets/screenshots/README.md) (Chinese).
 
@@ -304,3 +325,13 @@ Screenshot assets and shot list: [assets/screenshots](assets/screenshots/README.
 The inspiration for Codingns4DSH — and part of its implementation approach — comes from **[CodexHost](https://github.com/BytePioneer-AI/codex-host)**, which runs Pi, Claude Code, Grok Build and other Harnesses natively inside Codex Desktop. It showed the direction Codingns4DSH follows from the other side: host *other* Harnesses as first-class Agents instead of replacing them. The multi-Harness adapter model, projecting a CLI event stream into native sessions, and keeping each Agent's sessions in the host sidebar and composer trace back to that design. Thanks to its authors and community.
 
 Codingns4DSH is an independent project and is not affiliated with CodexHost.
+
+---
+
+## License
+
+Codingns4DSH is released under the **GNU General Public License version 3 or later** (SPDX: `GPL-3.0-or-later`); the full terms are in [LICENSE](LICENSE), and the `license` field in `package.json` matches.
+
+Copyright (C) 2026 jingyi0605
+
+You may use, modify and distribute the project freely under the terms of the license; derivative works must stay under the same license, ship the complete source and keep the copyright notice, and the project comes with no warranty.

package/README.md

@@ -5,12 +5,13 @@
 **把外部 Agent CLI、持久终端、工作区调试和远程访问，装进 DSH 原生界面。**
 
 [![npm version](https://img.shields.io/npm/v/%40jingyi0605%2Fcodingns4dsh?logo=npm)](https://www.npmjs.com/package/@jingyi0605/codingns4dsh)
-[![DSH compatibility](https://img.shields.io/badge/DSH-%3E%3D0.1.5--rc.3%20%3C%3D0.1.7--rc.2-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+[![DSH compatibility](https://img.shields.io/badge/DSH-0.2.0--rc.2-4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.19-3C873A?logo=node.js&logoColor=white)](https://nodejs.org)
+[![License: GPL-3.0-or-later](https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
 
 **简体中文** · [English](README.en.md)
 
-**当前版本 `@jingyi0605/codingns4dsh@0.1.7-rc.3`** · DSH **`>=0.1.5-rc.3 <=0.1.7-rc.2`**（已验证 `0.1.5-rc.3`、`0.1.6-alpha.2`、`0.1.7-rc.2`）· Node **`>= 22.19`** · macOS / Linux / Windows
+**当前版本 `@jingyi0605/codingns4dsh@0.2.0-beta.2`** · DSH **`0.2.0-rc.2`**（仅正式兼容并验证该版本）· Node **`>= 22.19`** · macOS / Linux / Windows
 
 **[GitHub](https://github.com/jingyi0605/Codingns4DSH)** · **[npm](https://www.npmjs.com/package/@jingyi0605/codingns4dsh)** · **QQ 群 1092985965**
 
@@ -23,7 +24,8 @@
   <a href="#首次使用">首次使用</a> ·
   <a href="#故障排查">故障排查</a> ·
   <a href="#开发">开发</a> ·
-  <a href="#鸣谢">鸣谢</a>
+  <a href="#鸣谢">鸣谢</a> ·
+  <a href="#许可证">许可证</a>
 </p>
 
 </div>
@@ -42,7 +44,7 @@ CodingNS 工作台把会话、Agent 选择器与右侧 Git 面板放在同一界
 
 **DSH（DeepSeek Harness）** 是一个编码 Agent 运行框架，由 CLI 和 Web 界面组成，在你的 Workspace 中运行 Agent 循环。
 
-**Codingns4DSH 是一个 DSH 插件 Bundle**（Host 层 + 浏览器层），提供九个模块，全部在 **设置 → Codingns4DSH** 中配置。
+**Codingns4DSH 是一个 DSH 插件 Bundle**（Host 层 + 浏览器层），提供十一个模块，全部在 **设置 → Codingns4DSH** 中配置。
 
 > 名称说明：本插件名为 **Codingns4DSH**（npm 包 `@jingyi0605/codingns4dsh`，设置页入口显示为 Codingns4DSH）；文中单独出现的 **Codingns4DSH** 指提供 Control API、账号与中继隧道的平台服务。
 
@@ -50,19 +52,21 @@ CodingNS 工作台把会话、Agent 选择器与右侧 Git 面板放在同一界
 | --- | --- | :---: |
 | **外部Agent集成** | 把已安装的 Agent CLI 变成 DSH 原生会话：流式输出、工具调用、权限确认、提问、用量、思考强度 | 开 |
 | **工作区会话增强** | 会话行显示 Agent Logo、归档会话入口、工作区隐藏/恢复入口、订阅/用量信息 | 关 |
+| **移动端访问增强** | 手机或窄屏下收起主侧栏、设置导航改为图标轨道，支持左右横滑开合侧栏、Android 振动与局域网 PWA 通知 | 开 |
 | **终端强化** | 持久终端，以及 Shell、主题、字体、光标、滚动缓冲区设置 | 关 · 需重启 |
-| **局域网访问DSH** | 监听端口并把局域网地址转发到本机 DSH Web | 常驻 |
+| **局域网访问DSH** | 监听端口并把局域网地址转发到本机 DSH Web；状态指示器显示启动状态，一键复制可用的访问地址 | 常驻 |
 | **登录保护** | 可选：用统一的本地账号保护局域网**和**中继访问，回环地址始终放行 | 常驻（卡片） |
 | **中转访问服务** | **在互联网任何位置访问自己的 DSH Web**，端到端加密 | 关 |
 | **工作区调试** | 按工作区保存启动配置、检查端口、HTTP 服务代理 | 开 |
 | **Git 仓库管理** | 在右侧 Sidebar 标签页查看改动、暂存文件、提交和 Git 版本历史 | 开 |
+| **文件管理增强** | 在文件侧栏创建、重命名、移动、复制、删除文件和目录，并支持代码与脚本识别 | 关 |
 | **PeerHost 聚合工作台** | 当前 Host 代理已握手的其他 DSH Host，按 HostScope 聚合工作区、会话和受控工具 | 关 |
 
 DSH 原生部分不会被替换：对话、会话列表、侧栏、设置、权限确认仍然是 DSH 自己的组件。
 
 一切都跑在 **Host（你的电脑）** 上：Agent 进程、终端、文件、局域网/中继监听；浏览器只是视图。Agent CLI 作为 DSH 子进程使用自己的凭据与上游，模型流量不经过插件。远程访问全部可用。
 
-补充说明：Codingns4DSH 装好后侧栏终端就已存在，**终端强化** 只是把它从基础本地 PTY 切换为持久后端（macOS/Linux 用 tmux，Windows 用 ConPTY），重启后生效；在 DSH `0.1.5.x` 上 Codingns4DSH 运行于兼容模式（无多 Tab 与 Shell 选择），卡片会给出提示；**工作区调试** 目前界面文案只有中文。
+补充说明：Codingns4DSH 装好后侧栏终端就已存在，**终端强化** 只是把它从基础本地 PTY 切换为持久后端（macOS/Linux 用 tmux，Windows 用 ConPTY），重启后生效；**工作区调试** 目前界面文案只有中文。
 
 ---
 
@@ -104,9 +108,11 @@ DSH 原生部分不会被替换：对话、会话列表、侧栏、设置、权
 
 模型列表直接读取自各 CLI，可随时切换；按钮上还会显示当前模型与思考强度。
 
+外部 Agent 自己组装请求，上下文面板的启发式构成与真实用量不同源；这些会话的面板只保留占用百分比与总量，不显示「系统 / 工具 / 消息」明细。
+
 ### 会话增强与订阅用量
 
-会话行显示 Agent Logo 与归档入口，输入框下方显示可读取额度的 Agent 的订阅或上游用量（含缓存命中率、按模型统计与费用）。
+会话行显示 Agent Logo 与归档入口，输入框下方显示可读取额度的 Agent 的订阅或上游用量（含缓存命中率、按模型统计与费用）。「显示订阅/用量检测」右侧的“设置”按钮可调整查询超时（默认 10 秒，作用于所有 Agent）与自动查询间隔（默认 5 分钟，0 表示不自动查询）；同一 Agent 在间隔内切回时复用上次结果，不重复请求上游。
 
 <div align="center">
   <table>
@@ -138,6 +144,10 @@ DSH 原生部分不会被替换：对话、会话列表、侧栏、设置、权
 
 Git 面板通过 DSH 原生右侧 Sidebar 的标签页入口打开，按 Workspace 保存状态并跨会话复用。未初始化的目录可直接初始化仓库；已初始化的仓库支持查看暂存文件和未提交文件、暂存/取消暂存、丢弃更改、填写提交说明、切换分支和浏览提交历史。模块关闭后会移除右侧标签及对应 Host Git RPC，不影响其他模块。
 
+### 文件管理增强
+
+文件管理增强把常用文件操作接入 DSH 原生文件侧栏：可以创建文件和目录、重命名、移动、复制、删除，并按代码与脚本类型选择编辑入口。操作会经过 Workspace 路径校验，拒绝越出当前工作区；模块关闭后清理对应的侧栏入口和 Host RPC。
+
 ### PeerHost 多 Host 工作区
 
 PeerHost 是当前 Host 的代理能力，不会切换当前登录 Host。启用后可在管理面板添加局域网 PeerHost，Host 侧保存目标配置和登录态，Client 只提交 `targetHostId` 与完整 `HostScope`（`hostId`、`targetHostId`、`workspaceId`、`sessionId`、`scopeGeneration`）。工作区、会话、聊天输入、实时事件、文件、Git、终端和右侧工具都按作用域路由，单个 PeerHost 故障不会阻塞当前 Host 或其他 PeerHost。
@@ -210,14 +220,14 @@ DSH 设置按钮旁的账户入口会显示登录状态、访问路径与延迟
 
 ## 安装
 
-**环境要求**：DSH 在 `>=0.1.5-rc.3 <=0.1.7-rc.2` 范围内（插件与 DSH 版本独立发布，安装期与运行期都会拒绝不兼容版本）· Node.js `>= 22.19` · `PATH` 中有 `pnpm`（`dsh plugin` 转发给 pnpm）· 可选：Agent CLI，以及 macOS/Linux 上用于持久终端的 `tmux`（`brew install tmux` / `sudo apt install tmux`）。
+**环境要求**：DSH `0.2.0-rc.2`· Node.js `>= 22.19` · `PATH` 中有 `pnpm`（`dsh plugin` 转发给 pnpm）· 可选：Agent CLI，以及 macOS/Linux 上用于持久终端的 `tmux`（`brew install tmux` / `sudo apt install tmux`）。
 
 ### 最简单的安装方式：使用内置 `web` Profile
 
 DSH 的 `web` Profile 会在首次使用时自动初始化，不需要手动创建配置文件，也不需要执行 `--dump-config`：
 
 ```bash
-dsh plugin --profile web add @jingyi0605/codingns4dsh@0.1.7-rc.3
+dsh plugin --profile web add @jingyi0605/codingns4dsh@0.2.0-beta.2
 dsh web
 ```
 
@@ -227,7 +237,7 @@ dsh web
 
 ```bash
 dsh codingns --from-default-profile web --dump-config
-dsh plugin --profile codingns add @jingyi0605/codingns4dsh@0.1.7-rc.3
+dsh plugin --profile codingns add @jingyi0605/codingns4dsh@0.2.0-beta.2
 dsh codingns
 ```
 
@@ -248,7 +258,7 @@ dsh plugin --profile web remove @jingyi0605/codingns4dsh
 ```bash
 git clone https://github.com/jingyi0605/Codingns4DSH.git && cd Codingns4DSH
 pnpm install && pnpm build
-dsh plugin --profile web add "$PWD"                # 或 npm pack 后 add ./jingyi0605-codingns4dsh-0.1.7-rc.2.tgz
+dsh plugin --profile web add "$PWD"                # 或 npm pack 后 add ./jingyi0605-codingns4dsh-0.2.0-beta.2.tgz
 dsh web
 ```
 
@@ -278,11 +288,12 @@ dsh web
 
 ## 故障排查
 
-- **版本** —— `dsh --version`、`dsh plugin --profile web list --depth 0`（独立 Profile 请替换 `web`）、`npm view @jingyi0605/codingns4dsh version`；安装与启动都会拒绝范围外的 DSH。
+- **版本** —— `dsh --version`、`dsh plugin --profile web list --depth 0`（独立 Profile 请替换 `web`）、`npm view @jingyi0605/codingns4dsh version`；启动时会拒绝范围外的 DSH，安装期在能识别当前运行时版本时同样拒绝。
+- **安装期被 `PATH` 上的旧 `dsh` 误判** —— 安装期只把宿主注入的版本、Desktop Runtime 根和 Profile 内可解析的 `@deepseek-ai/dsh` 当作阻断依据；`PATH` 上的 `dsh --version` 仅用于提示，不会阻断安装。运行期仍以实际加载的 DSH 为准。
 - **`patch: entry "terminal-controller" not found`** —— Profile 缺少 Web 应用层，按上文用 `web` 模板重建。
 - **检测不到 Agent** —— 在 Host 上执行 `<cli> --version`；确认其目录在启动 DSH 的进程的 `PATH` 中（图形启动器常不同）；用各家工具登录后重启 DSH。
 - **终端** —— macOS/Linux 持久模式需要 `tmux`；启停模块与修改绑定范围需重启；终端按工作区寻址。
-- **局域网** —— 确认卡片转发信息、防火墙放行、两台设备同网络；多个 DSH 实例时手动选择探测到的端口；开启登录保护后需先登录。
+- **局域网** —— 确认卡片启动状态与访问地址、防火墙放行、两台设备同网络；多个 DSH 实例时手动选择探测到的端口；开启登录保护后需先登录。
 - **中转** —— 检查 Control API 可达性，会话过期则重新登录，刷新设备后绑定 Host。
 - **日志** —— 默认不输出调试日志；需要排查启动或 RPC 时使用 `CODINGNS4DSH_DEBUG=1 dsh --profile stage0 --no-open`。旧变量 `CODINGNS4DSH_TUNNEL_DEBUG=1` 仍兼容；pnpm 安装日志在 `$DSH_HOME/profiles/<profile>/.plugin-manager/logs/`。
 - **反馈** —— 附上 DSH 与 Codingns4DSH 版本、操作系统、涉及模块和完整错误：[GitHub Issues](https://github.com/jingyi0605/Codingns4DSH/issues) 或 QQ **1092985965**。
@@ -296,7 +307,7 @@ dsh web
 ```bash
 pnpm install
 pnpm build            # 版本校验 → tsc → Client + H5 Bundle
-pnpm test             # 构建后运行 61 个测试套件
+pnpm test             # 构建后运行完整测试（当前 901 个用例）
 pnpm typecheck
 pnpm run capability:check   # DSH 能力注册表退休检查
 ```
@@ -305,7 +316,7 @@ pnpm run capability:check   # DSH 能力注册表退休检查
 
 目录：`src/host`（Host 层）、`src/client`（浏览器层）、`src/dsh-capabilities`（DSH 能力注册与版本路由）、`src/shared/contracts`、`src/transport`（隧道与 WebRTC）、`src/features`（模块注册表）、`tests/`、`specs/`、`docs/`、`data/build`（已忽略）。
 
-推送 `v*` tag 触发 GitHub Actions（tag/版本校验、冻结安装、类型检查、测试、`npm pack`）并以 provenance 发布，预发布版本用 `next` dist-tag。路线图：PeerHost、文件管理、工作区会话、调试代理完善（鉴权 + WebSocket）、Git、SKILL、更多。
+推送 `v*` tag 触发 GitHub Actions（tag/版本校验、冻结安装、类型检查、测试、`npm pack`）并以 provenance 发布，预发布版本用 `next` dist-tag。当前发布还会执行 DSH 安装回放、运行时模块解析和 npm 产物逐文件校验。
 
 截图素材与清单见 [assets/screenshots](assets/screenshots/README.md)。
 
@@ -318,3 +329,13 @@ pnpm run capability:check   # DSH 能力注册表退休检查
 Codingns4DSH 的项目灵感与部分实现思路来自 **[CodexHost](https://github.com/BytePioneer-AI/codex-host)**——它把 Pi、Claude Code、Grok Build 等 Harness 原生跑在 Codex Desktop 里，展示了 Codingns4DSH 从另一侧沿用的方向：**把其他 Harness 作为一等 Agent 接入**，而不是替换它们。多 Harness 适配器模型、把 CLI 事件流投影为宿主原生会话、让每个 Agent 的会话留在宿主侧栏与输入框，都源自该项目的设计。感谢其作者与社区。
 
 Codingns4DSH 是独立项目，与 CodexHost 无隶属关系。
+
+---
+
+## 许可证
+
+本项目以 **GNU 通用公共许可证第 3 版或更高版本**发布（SPDX：`GPL-3.0-or-later`），完整条款见 [LICENSE](LICENSE)，`package.json` 中的 `license` 字段与之保持一致。
+
+Copyright (C) 2026 jingyi0605
+
+你可以在许可证允许的范围内自由使用、修改和分发本项目；分发衍生作品时须同样以 GPL 授权、附上完整源码并保留版权声明，且本项目不提供任何担保。

package/data/build/dist/bootstrap/dsh-connection-adapter.d.ts

@@ -93,5 +93,5 @@ export declare function installDshTransport(options: {
 }): CodingNsTransportRegistration & {
     hooks: DshClientTransportHooks;
 };
-export declare const SUPPORTED_DSH_CONNECTION_VERSION: "0.1.6-alpha.2";
+export declare const SUPPORTED_DSH_CONNECTION_VERSION: "0.2.0-rc.2";
 //# sourceMappingURL=dsh-connection-adapter.d.ts.map

package/data/build/dist/bootstrap/dsh-connection-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-connection-adapter.d.ts","sourceRoot":"","sources":["../../../../src/bootstrap/dsh-connection-adapter.ts"],"names":[],"mappings":"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"}

package/data/build/dist/bootstrap/dsh-connection-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-connection-adapter.js","sourceRoot":"","sources":["../../../../src/bootstrap/dsh-connection-adapter.ts"],"names":[],"mappings":"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"}

package/data/build/dist/bootstrap/dsh-peer-host-preboot-shim.d.ts

@@ -0,0 +1,50 @@
+import type { CodingNsTransportHooks } from '../shared/contracts/transport.js';
+/** 页面级 PeerHost preboot shim 的全局名称。 */
+export declare const DSH_PEER_HOST_PREBOOT_SHIM_GLOBAL: "__CODINGNS4DSH_PREBOOT_SHIM__";
+export type DshPeerHostPrebootShimState = 'not-installed' | 'installed' | 'active' | 'requires-reload' | 'external' | 'disposed';
+/**
+ * shim 接管页面 Transport 的方式。
+ *
+ * - `web`：普通 Web Host。shim 自己提供 `rpc`/`openStream`，激活后由 facade 直接分流。
+ * - `desktop`：Desktop 壳（存在 `dshDesktopBoot` 或协议为 `dsh-app:`）。Desktop 的
+ *   Transport 由前端 Bundle 在运行时**直接赋值**为 `{ ownsHost, streamBaseUrl }`，
+ *   因此 shim 用带 setter 的访问器接管这次赋值，并且**只提供 `fetch` 等外壳字段**：
+ *   `rpc`/`openStream` 故意留空，让 DSH 继续创建原生 `createWebConnectionRpc`
+ *   （完整保留 rpcId 校验、multipart 解析与 Remote mux 启动条件）。聚合分流由
+ *   业务侧在 Connection 就绪后补 `connection.rpc.open` 完成。
+ * - `external`：Transport 形状未知（非对象，例如字符串标记），无法包装，保持原样。
+ */
+export type DshPeerHostPrebootShimMode = 'web' | 'desktop' | 'external';
+export interface DshPeerHostPrebootShimApi {
+    readonly version: string;
+    readonly getState: () => DshPeerHostPrebootShimState;
+    readonly getMode: () => DshPeerHostPrebootShimMode;
+    readonly activate: (transport?: CodingNsTransportHooks) => DshPeerHostPrebootShimState;
+    readonly deactivate: () => DshPeerHostPrebootShimState;
+    readonly dispose: () => void;
+}
+/**
+ * 在当前 JavaScript Realm 安装 shim。生产页面通过启动页脚本安装，测试和
+ * H5 宿主可以直接调用这个函数。版本不在插件兼容范围内时不写入任何全局状态。
+ */
+export declare function installDshPeerHostPrebootShim(options: {
+    readonly dshVersion: string;
+}): DshPeerHostPrebootShimApi;
+/**
+ * 读取当前页面 shim 的状态；没有安装过 shim 时返回 `not-installed`。
+ *
+ * 供设置面板与账户入口判断"结构性不支持"（`external`）与"尚未注入"
+ * （`not-installed`）两种情况，避免把结构问题误报成"刷新即可"。
+ */
+export declare function readDshPeerHostPrebootShimState(): DshPeerHostPrebootShimState;
+/** 读取当前页面 shim 的接管方式；没有安装过 shim 时返回 `undefined`。 */
+export declare function readDshPeerHostPrebootShimMode(): DshPeerHostPrebootShimMode | undefined;
+/**
+ * 生成启动页 head script；脚本只依赖浏览器原生 API，不引用插件模块。
+ *
+ * 脚本与 `installDshPeerHostPrebootShim` 覆盖不同注入路径（脚本走 `<head>`，
+ * 函数供测试与 H5 宿主直接调用），两者必须保持同一组行为；
+ * `tests/dsh-peer-host-preboot-shim.spec.ts` 对同一批场景分别断言两条路径。
+ */
+export declare function createDshPeerHostPrebootShimScript(dshVersion?: string): string;
+//# sourceMappingURL=dsh-peer-host-preboot-shim.d.ts.map

package/data/build/dist/bootstrap/dsh-peer-host-preboot-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-peer-host-preboot-shim.d.ts","sourceRoot":"","sources":["../../../../src/bootstrap/dsh-peer-host-preboot-shim.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAE9E,uCAAuC;AACvC,eAAO,MAAM,iCAAiC,EAAG,+BAAwC,CAAA;AAEzF,MAAM,MAAM,2BAA2B,GAAG,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,GAAG,UAAU,GAAG,UAAU,CAAA;AAEhI;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAA;AAEvE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,2BAA2B,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,0BAA0B,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,sBAAsB,KAAK,2BAA2B,CAAA;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,2BAA2B,CAAA;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B;AAQD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,yBAAyB,CAwJjH;AAYD;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,2BAA2B,CAM7E;AAED,oDAAoD;AACpD,wBAAgB,8BAA8B,IAAI,0BAA0B,GAAG,SAAS,CAMvF;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAAC,UAAU,GAAE,MAA8B,GAAG,MAAM,CAMrG"}