dsh-carryon 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to dsh-carryon. Versions follow [SemVer](https://semver.org/
 release may change behaviour or configuration. Each release supports exactly one dsh release, given by
 `engines.dsh` in `package.json`.
 
+## 0.1.1 (2026-11-06)
+
+Documentation only; the code is the same as 0.1.0. It supports dsh `0.2.2-alpha.3`.
+
+- **npm page.** The READMEs use full GitHub URLs for images and links, so they work on npmjs.com.
+- **Quick start.** How to check that the plugin is installed, update it, and remove it.
+- **Troubleshooting.** New `docs/troubleshooting.md`: install errors, no folds, failed folds and their messages.
+- **Issue forms** for bug reports and feature requests.
+- **Release.** Published from GitHub Actions through npm trusted publishing (OIDC).
+
 ## 0.1.0 (2026-11-06)
 
 First release. It supports dsh `0.2.2-alpha.3`.

package/README.md

@@ -8,14 +8,15 @@
   <a href="https://ethannju.github.io/carryon/"><img src="https://img.shields.io/badge/Project-Page-2d6bb1?style=flat-square" alt="Project Page"></a>
   <a href="https://arxiv.org/abs/2610.18784"><img src="https://img.shields.io/badge/arXiv-2610.18784-B31B1B?style=flat-square&amp;logo=arxiv&amp;logoColor=white" alt="arXiv 2610.18784"></a>
   <a href="https://huggingface.co/papers/2610.18784"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2610.18784&amp;query=%24.upvotes&amp;label=Hugging%20Face&amp;prefix=%E2%96%B2%20&amp;suffix=%20upvotes&amp;color=ffd21e&amp;logo=huggingface&amp;style=flat-square" alt="Hugging Face Paper upvotes"></a>
+  <a href="https://www.npmjs.com/package/dsh-carryon"><img src="https://img.shields.io/npm/v/dsh-carryon?style=flat-square&amp;logo=npm" alt="npm"></a>
   <a href="https://github.com/xuan-tu-ai/dsh-carryon/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/xuan-tu-ai/dsh-carryon/ci.yml?branch=main&amp;style=flat-square&amp;logo=githubactions&amp;logoColor=white&amp;label=CI" alt="CI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat-square" alt="License Apache-2.0"></a>
+  <a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat-square" alt="License Apache-2.0"></a>
   <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-0.2.2--alpha.3-4D6BFE?style=flat-square" alt="dsh 0.2.2-alpha.3"></a>
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A522-339933?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white" alt="Node.js 22 or later">
 </p>
 
 <p align="center">
-  <strong>English</strong> · <a href="README.zh-CN.md">简体中文</a>
+  <strong>English</strong> · <a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/README.zh-CN.md">简体中文</a>
 </p>
 
 When a [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) session grows long, dsh compacts it
@@ -29,9 +30,9 @@ https://github.com/user-attachments/assets/5f4a6889-5cf6-41a4-aff1-327a9d5d6b7b
 <p align="center"><sub>CarryOn demo by the paper's authors. Also on the <a href="https://ethannju.github.io/carryon/">project page</a>.</sub></p>
 
 <p align="center"><img src="https://raw.githubusercontent.com/Ethannju/carryon/2d5c8db78e136a74d6e1cccfdf984607b565ee6e/docs/assets/overview.png" alt="Overview of CarryOn" width="860"></p>
-<p align="center"><sub>The CarryOn runtime, from the paper. In dsh-carryon, dsh decides when to fold and keeps the recent turns; the Grounder is not ported yet (<a href="docs/how-it-works.md">details</a>).</sub></p>
+<p align="center"><sub>The CarryOn runtime, from the paper. In dsh-carryon, dsh decides when to fold and keeps the recent turns; the Grounder is not ported yet (<a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md">details</a>).</sub></p>
 
-[Configuration](docs/configuration.md) · [How it works](docs/how-it-works.md) · [Development](docs/development.md) · [Benchmark](bench/README.md) · [Releasing](docs/release.md) · [Changelog](CHANGELOG.md)
+[Configuration](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/configuration.md) · [How it works](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md) · [Development](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/development.md) · [Benchmark](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/bench/README.md) · [Troubleshooting](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/troubleshooting.md) · [Releasing](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/release.md) · [Changelog](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/CHANGELOG.md)
 
 ## Highlights
 
@@ -61,7 +62,7 @@ flowchart LR
 The checkpoint holds every carrier and the execution context. dsh keeps the most recent turns verbatim after it.
 A fold costs one Tracker call, plus one Compiler call when the Tracker asks for compilation; dsh's own compaction
 makes one summary call. The engine, the state format and how this port differs from the paper are described in
-[How it works](docs/how-it-works.md).
+[How it works](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md).
 
 ## Results reported in the paper
 
@@ -99,16 +100,36 @@ Restart dsh. In the terminal UI, every compaction is now a CarryOn fold. In the
 **CarryOn mode**, which you can switch from the mode menu next to the chat box:
 
 <p align="center">
-  <img src="docs/images/web-carryon-mode-menu.png" alt="CarryOn mode in the dsh Web UI mode menu" width="720">
+  <img src="https://raw.githubusercontent.com/xuan-tu-ai/dsh-carryon/main/docs/images/web-carryon-mode-menu.png" alt="CarryOn mode in the dsh Web UI mode menu" width="720">
 </p>
 
-The plugin is listed under **Plugins → Installed plugins**. A fold's checkpoint appears where dsh shows a compaction
-summary, and its full state is under Trajectory → Raw Output. To remove the plugin:
+### Check, update, remove
+
+`dsh plugin` passes its arguments to pnpm in the profile's directory, so pnpm's commands work. Check that the plugin
+is installed:
+
+```bash
+npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui list
+```
+
+In the Web UI it is also listed under **Plugins → Installed plugins**. Once the session is long enough to compact
+(or after `/compact`), a fold's checkpoint appears where dsh shows a compaction summary, and its full state is under
+Trajectory → Raw Output.
+
+Update to the latest release for your dsh version:
+
+```bash
+npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui update dsh-carryon
+```
+
+Remove it:
 
 ```bash
 npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui remove dsh-carryon
 ```
 
+Use `--profile web` for the Web UI. Something not working? See [Troubleshooting](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/troubleshooting.md).
+
 ## Configuration
 
 The plugin's config row is `carryon-compaction`. It accepts dsh's own compaction keys (`thresholdRatio`,
@@ -124,7 +145,7 @@ half of the context window and run the CarryOn roles on the cheaper `deepseek-fl
 ```
 
 dsh replaces a row's whole `config` with the patched one, so list all your keys together. See
-[Configuration](docs/configuration.md) for every key, the defaults, and the Web UI's limits.
+[Configuration](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/configuration.md) for every key, the defaults, and the Web UI's limits.
 
 ## Citation
 
@@ -147,5 +168,5 @@ paper's authors or with DeepSeek.
 
 ## License
 
-dsh-carryon's code is [Apache-2.0](LICENSE). The demo video and the figures shown above belong to the paper's authors,
+dsh-carryon's code is [Apache-2.0](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/LICENSE). The demo video and the figures shown above belong to the paper's authors,
 who gave permission to show them here; they are not covered by that license.

package/README.zh-CN.md

@@ -8,14 +8,15 @@
   <a href="https://ethannju.github.io/carryon/"><img src="https://img.shields.io/badge/Project-Page-2d6bb1?style=flat-square" alt="Project Page"></a>
   <a href="https://arxiv.org/abs/2610.18784"><img src="https://img.shields.io/badge/arXiv-2610.18784-B31B1B?style=flat-square&amp;logo=arxiv&amp;logoColor=white" alt="arXiv 2610.18784"></a>
   <a href="https://huggingface.co/papers/2610.18784"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fhuggingface.co%2Fapi%2Fpapers%2F2610.18784&amp;query=%24.upvotes&amp;label=Hugging%20Face&amp;prefix=%E2%96%B2%20&amp;suffix=%20upvotes&amp;color=ffd21e&amp;logo=huggingface&amp;style=flat-square" alt="Hugging Face Paper upvotes"></a>
+  <a href="https://www.npmjs.com/package/dsh-carryon"><img src="https://img.shields.io/npm/v/dsh-carryon?style=flat-square&amp;logo=npm" alt="npm"></a>
   <a href="https://github.com/xuan-tu-ai/dsh-carryon/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/xuan-tu-ai/dsh-carryon/ci.yml?branch=main&amp;style=flat-square&amp;logo=githubactions&amp;logoColor=white&amp;label=CI" alt="CI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat-square" alt="License Apache-2.0"></a>
+  <a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat-square" alt="License Apache-2.0"></a>
   <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/dsh-0.2.2--alpha.3-4D6BFE?style=flat-square" alt="dsh 0.2.2-alpha.3"></a>
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A522-339933?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white" alt="Node.js 22 或更高版本">
 </p>
 
 <p align="center">
-  <a href="README.md">English</a> · <strong>简体中文</strong>
+  <a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/README.md">English</a> · <strong>简体中文</strong>
 </p>
 
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）的会话变长时，dsh 会把较早的轮次总结成一段自由文本来压缩上下文。dsh-carryon 用论文 [*Pack Light, CarryOn*](https://arxiv.org/abs/2610.18784) 中的 **CarryOn** 替换这一步：较早的轮次被折叠（fold）成两部分。一部分是记录智能体已确立内容的小型、带版本的记录，称为“载体”（carrier）。另一部分是执行上下文，包含任务、未完成的义务和下一步。每次折叠在提交前都会经过校验，被拒绝的折叠不会改变任何东西。
@@ -25,9 +26,9 @@ https://github.com/user-attachments/assets/5f4a6889-5cf6-41a4-aff1-327a9d5d6b7b
 <p align="center"><sub>论文作者制作的 CarryOn 演示视频，也可在<a href="https://ethannju.github.io/carryon/">项目主页</a>观看。</sub></p>
 
 <p align="center"><img src="https://raw.githubusercontent.com/Ethannju/carryon/2d5c8db78e136a74d6e1cccfdf984607b565ee6e/docs/assets/overview.png" alt="Overview of CarryOn" width="860"></p>
-<p align="center"><sub>论文中的 CarryOn 运行时示意图。在 dsh-carryon 中，何时折叠以及保留哪些最近轮次由 dsh 决定；Grounder 尚未移植（<a href="docs/how-it-works.md">详情</a>，英文）。</sub></p>
+<p align="center"><sub>论文中的 CarryOn 运行时示意图。在 dsh-carryon 中，何时折叠以及保留哪些最近轮次由 dsh 决定；Grounder 尚未移植（<a href="https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md">详情</a>，英文）。</sub></p>
 
-[配置](docs/configuration.md) · [工作原理](docs/how-it-works.md) · [开发](docs/development.md) · [基准测试](bench/README.md) · [发布](docs/release.md) · [更新日志](CHANGELOG.md)
+[配置](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/configuration.md) · [工作原理](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md) · [开发](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/development.md) · [基准测试](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/bench/README.md) · [故障排除](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/troubleshooting.md) · [发布](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/release.md) · [更新日志](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/CHANGELOG.md)
 
 以上文档为英文。
 
@@ -52,7 +53,7 @@ flowchart LR
     R -.->|上下文接近上限| F["退回：<br/>dsh 的总结"]
 ```
 
-检查点包含所有载体和执行上下文，dsh 会在它之后原样保留最近的轮次。每次折叠调用一次 Tracker；Tracker 请求编译时，再调用一次 Compiler。dsh 自带的压缩只调用一次总结。引擎、状态格式以及本移植与论文的差异，见[工作原理](docs/how-it-works.md)。
+检查点包含所有载体和执行上下文，dsh 会在它之后原样保留最近的轮次。每次折叠调用一次 Tracker；Tracker 请求编译时，再调用一次 Compiler。dsh 自带的压缩只调用一次总结。引擎、状态格式以及本移植与论文的差异，见[工作原理](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/how-it-works.md)。
 
 ## 论文报告的结果
 
@@ -85,15 +86,33 @@ npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile web add dsh-carryon
 重启 dsh。在终端界面中，每次压缩都会变成一次 CarryOn 折叠。在 Web UI 中，新会话默认使用 **CarryOn mode**，可以在输入框旁的模式菜单中切换：
 
 <p align="center">
-  <img src="docs/images/web-carryon-mode-menu.png" alt="dsh Web UI 模式菜单中的 CarryOn mode" width="720">
+  <img src="https://raw.githubusercontent.com/xuan-tu-ai/dsh-carryon/main/docs/images/web-carryon-mode-menu.png" alt="dsh Web UI 模式菜单中的 CarryOn mode" width="720">
 </p>
 
-插件会出现在 **Plugins → Installed plugins** 中。折叠的检查点显示在 dsh 显示压缩总结的位置，完整状态在 Trajectory → Raw Output 中。卸载插件：
+### 检查、更新、卸载
+
+`dsh plugin` 会把参数转交给配置目录中的 pnpm，所以 pnpm 的命令都可以使用。检查插件是否已安装：
+
+```bash
+npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui list
+```
+
+在 Web UI 中，插件也会出现在 **Plugins → Installed plugins** 中。会话长到触发压缩（或执行 `/compact`）后，折叠的检查点显示在 dsh 显示压缩总结的位置，完整状态在 Trajectory → Raw Output 中。
+
+更新到适用于你的 dsh 版本的最新发布：
+
+```bash
+npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui update dsh-carryon
+```
+
+卸载：
 
 ```bash
 npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui remove dsh-carryon
 ```
 
+Web UI 请使用 `--profile web`。遇到问题？见[故障排除](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/troubleshooting.md)（英文）。
+
 ## 配置
 
 插件的配置行是 `carryon-compaction`。它接受 dsh 自带压缩的键（`thresholdRatio`、`retainTokens` 等），以及少量 CarryOn 专用的键。例如，下面的配置写入 `$DSH_HOME/profiles/tui/cordis.patch.yml` 后，会在上下文窗口用到一半时折叠，并让 CarryOn 的角色调用使用更便宜的 `deepseek-flash`：
@@ -106,7 +125,7 @@ npx @deepseek-ai/dsh@0.2.2-alpha.3 plugin --profile tui remove dsh-carryon
     runtimeModel: deepseek-flash
 ```
 
-dsh 会用补丁中的 `config` 整体替换该行的配置，所以请把所有要改的键写在一起。全部键、默认值以及 Web UI 中的限制见[配置](docs/configuration.md)。
+dsh 会用补丁中的 `config` 整体替换该行的配置，所以请把所有要改的键写在一起。全部键、默认值以及 Web UI 中的限制见[配置](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/docs/configuration.md)。
 
 ## 引用
 
@@ -128,4 +147,4 @@ carrycode 和 dsh-carryon 是仅依据论文完成的独立实现，与论文作
 
 ## 许可证
 
-dsh-carryon 的代码采用 [Apache-2.0](LICENSE)。上文的演示视频和图片属于论文作者，经作者许可在此展示，不在该许可证范围内。
+dsh-carryon 的代码采用 [Apache-2.0](https://github.com/xuan-tu-ai/dsh-carryon/blob/main/LICENSE)。上文的演示视频和图片属于论文作者，经作者许可在此展示，不在该许可证范围内。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-carryon",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CarryOn context folding (arXiv:2610.18784) as a compaction plugin for DeepSeek Harness (experimental)",
   "keywords": [
     "dsh-plugin",