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

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.1-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.1`** · DSH **`>=0.2.0-rc.1 <=0.2.0-rc.1`** (validated `0.2.0-rc.1`) · 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>
@@ -60,7 +62,7 @@ Nothing native is replaced — conversations, sessions, sidebar, settings and ap
 
 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 +104,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>
@@ -196,14 +200,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 inside `>=0.2.0-rc.1 <=0.2.0-rc.1` (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`).
 
 ### 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.1
 dsh web
 ```
 
@@ -213,7 +217,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.1
 dsh codingns
 ```
 
@@ -234,7 +238,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.1.tgz
 dsh web
 ```
 
@@ -304,3 +308,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.1-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.1`** · DSH **`>=0.2.0-rc.1 <=0.2.0-rc.1`**（已验证 `0.2.0-rc.1`）· 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>
@@ -62,7 +64,7 @@ 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 +106,11 @@ DSH 原生部分不会被替换：对话、会话列表、侧栏、设置、权
 
 模型列表直接读取自各 CLI，可随时切换；按钮上还会显示当前模型与思考强度。
 
+外部 Agent 自己组装请求，上下文面板的启发式构成与真实用量不同源；这些会话的面板只保留占用百分比与总量，不显示「系统 / 工具 / 消息」明细。
+
 ### 会话增强与订阅用量
 
-会话行显示 Agent Logo 与归档入口，输入框下方显示可读取额度的 Agent 的订阅或上游用量（含缓存命中率、按模型统计与费用）。
+会话行显示 Agent Logo 与归档入口，输入框下方显示可读取额度的 Agent 的订阅或上游用量（含缓存命中率、按模型统计与费用）。「显示订阅/用量检测」右侧的“设置”按钮可调整查询超时（默认 10 秒，作用于所有 Agent）与自动查询间隔（默认 5 分钟，0 表示不自动查询）；同一 Agent 在间隔内切回时复用上次结果，不重复请求上游。
 
 <div align="center">
   <table>
@@ -210,14 +214,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.1 <=0.2.0-rc.1` 范围内（插件与 DSH 版本独立发布，安装期与运行期都会拒绝不兼容版本）· 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.1
 dsh web
 ```
 
@@ -227,7 +231,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.1
 dsh codingns
 ```
 
@@ -248,7 +252,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.1.tgz
 dsh web
 ```
 
@@ -318,3 +322,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.1";
 //# sourceMappingURL=dsh-connection-adapter.d.ts.map

package/data/build/dist/bootstrap/index.d.ts

@@ -20,7 +20,7 @@ export interface CodingNsTransportRegistration {
     readonly transport: CodingNsPreCordisTransport;
     dispose(): void;
 }
-export declare const CODINGNS_BOOTSTRAP_DSH_VERSION: "0.1.6-alpha.2";
+export declare const CODINGNS_BOOTSTRAP_DSH_VERSION: "0.2.0-rc.1";
 /**
  * 在 DSH Client/Cordis 启动前登记唯一 Transport。
  *