dsh-watcher 0.6.0 → 0.8.0

package/README.en.md

@@ -2,27 +2,35 @@
 
 # Watcher
 
-Prefer npm (version-pinable):
+[![npm version](https://img.shields.io/npm/v/dsh-watcher)](https://www.npmjs.com/package/dsh-watcher)
 
-```sh
-dsh plugin --profile web add dsh-watcher@0.6.0
-```
+## Install / Update
+
+### Install on DeepSeek Harness web or desktop
+
+Fill `dsh-watcher` in the **Add plugin** wizard's search box, and click **Install**:
+
+![Add plugin wizard](https://raw.githubusercontent.com/aa2246740/dsh-watcher/main/docs/add-plugin-wizard.png)
 
-Or latest:
+### Install with `dsh` cli
+
+Install [`dsh-watcher`](https://www.npmjs.com/package/dsh-watcher) plugin from [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh):
 
 ```sh
 dsh plugin --profile web add dsh-watcher
 ```
 
-Fallback: install from GitHub (tracks the default branch tip):
+Or update the `dsh-watcher` plugin:
 
 ```sh
-dsh plugin --profile web add github:aa2246740/dsh-watcher
+dsh plugin --profile web update dsh-watcher@latest
 ```
 
-You need official `dsh` (or `npx @deepseek-ai/dsh`) and **pnpm** on `PATH`. `dsh plugin add` runs pnpm in `$DSH_HOME/profiles/web` and, because this package declares `dsh.bundle.patch`, appends the bundle to that profile. Then **restart that Host and reload the page**. The command writes the profile. It does not hot-load a running process.
+Then start the web UI with `dsh web`. No build step, no restart.
+
+This official CLI command writes only the `web` profile; it cannot modify the Desktop App profile — use the in-app **Add plugin** wizard above for desktop. This release commits `lib/`; normal use needs no clone, build, or DSHX installation.
 
-`lib/` is committed, so npm / git installs do not need a local build, `prepare`, or `allowBuilds`. DeepSeek Harness **0.1.7-rc.1** (`@deepseek-ai/dsh@0.1.7-rc.1`). Node `^22.19.0` or `>=24`.
+DeepSeek Harness **0.2.0-rc.2** (`@deepseek-ai/dsh@0.2.0-rc.2`, `dsh-v0.2.0-rc.2`). The `@deepseek-ai/dsh-*` peer range is `>=0.2.0-rc.1 <0.2.1`: it accepts **0.2.0-rc.2** and stable **0.2.0**, rejects alphas, and rejects **0.1.7-rc.2**. Node `^22.19.0` or `>=24`.
 
 A read-only plugin for DeepSeek Harness Web. Open the eye in the session header. A Session becomes a foldable work path: how many steps ran, how many tools fired, how long it took. Open a step for parallel branches, a tool result, or a reasoning row that stays folded until you ask.
 
@@ -40,26 +48,49 @@ It does not inject messages, invent hidden chain-of-thought, or replace the offi
 
 Grouped view only stacks what it can prove. Two different bash calls stay apart. The model stage shows only provider-visible reasoning already written into the Session. If nothing was recorded, it says so.
 
-From a clone:
+### Advanced installs
+
+Pin to a GitHub tag:
+
+```sh
+dsh plugin --profile web add github:aa2246740/dsh-watcher#v0.8.0
+```
+
+From a clone (development/local testing):
 
 ```sh
 git clone https://github.com/aa2246740/dsh-watcher.git
 dsh plugin --profile web add ./dsh-watcher
 ```
 
-That path also needs pnpm, then a Host restart and page reload.
+That path also needs pnpm, then reopen that Web Host and reload the page.
 
 ```sh
 dsh plugin --profile web remove dsh-watcher
 ```
 
-DSH.app's `desktop` profile rejects `github:`. Use `dsh web` and install into the `web` profile.
+The public CLI manages `web` only; use the in-app “Add plugin” entry above for the Desktop App.
 
 The settings summary and session HUD show **Estimated cost** (not “total value”) next to total tokens. Input / output / cache buckets are priced from `pricing/models.yaml`. A missing row is **Unknown**, never $0. A partial estimate keeps the known dollar in the main number and footnotes **Some models unpriced**. It is an estimate, not a bill. The default table covers mainstream DeepSeek, MiniMax, OpenAI, Anthropic, Gemini, Grok, GLM, and Qwen rows and is static (no live fetch). Override it in Watcher settings (`localStorage` key `dsh-watcher:pricing-override:v1`). PRs to the default table are welcome.
 
 The interaction contract lives in [DESIGN.md](./DESIGN.md). MIT.
 
-## What's new in 0.6.0
+## What's new in 0.8.0
+
+- The daily chart books each token settlement on the local calendar day. A session total is no longer piled onto the last active day. Version 1 caches keep the old display until that session is refolded into version 2.
+- With dsh-better-sidebar installed, the right sidebar gains a Watcher page for the work picture. Without it, the header button and the settings section stay as they are. The sidebar package is not a dependency.
+
+## 0.7.0
+
+- Targets official DeepSeek Harness **0.2.0-rc.2** (`dsh-v0.2.0-rc.2`, SHA `639ed015397290b3745d163aafe02ffee4aa3f84`). `@deepseek-ai/dsh-*` peers are `>=0.2.0-rc.1 <0.2.1`: the range accepts `0.2.0-rc.2` and stable `0.2.0`, rejects alphas, and rejects `0.1.7-rc.2`.
+- Icons stay `IconChevronRightOutlineRegular`, `IconRefreshOutlineRegular`, `IconCheckOutlineRegular`, and `IconCopyOutlineRegular`. Those four names are still exported by primitives at `dsh-v0.2.0-rc.2`. The size-suffixed names are still absent.
+
+## 0.6.1
+
+- Checked on official DeepSeek Harness **0.1.7-rc.2**. `@deepseek-ai/dsh-*` peers stay `>=0.1.7-rc.1 <0.1.8`, so install accepts `0.1.7-rc.1` and `0.1.7-rc.2` and rejects `0.1.7-alpha.*`.
+- Icons stay `IconChevronRightOutlineRegular`, `IconRefreshOutlineRegular`, `IconCheckOutlineRegular`, and `IconCopyOutlineRegular`. rc.2 still does not export the size-suffixed names.
+
+## 0.6.0
 
 - Targets official DeepSeek Harness **0.1.7-rc.1**. `@deepseek-ai/dsh-*` peers are `>=0.1.7-rc.1 <0.1.8`, so install accepts `0.1.7-rc.1` and rejects `0.1.7-alpha.*`.
 - Icons are `IconChevronRightOutlineRegular`, `IconRefreshOutlineRegular`, `IconCheckOutlineRegular`, and `IconCopyOutlineRegular`. rc.1 removed the size-suffixed exports and ships no aliases.

package/README.md

@@ -2,27 +2,35 @@
 
 # Watcher
 
-推荐用 npm（可钉版本）：
+[![npm version](https://img.shields.io/npm/v/dsh-watcher)](https://www.npmjs.com/package/dsh-watcher)
 
-```sh
-dsh plugin --profile web add dsh-watcher@0.6.0
-```
+## 安装 / 更新
+
+### 在 DeepSeek Harness 网页版或桌面端安装
+
+在 **添加插件** 向导的搜索框中填入 `dsh-watcher`，点击 **Install**：
+
+![Add plugin wizard](https://raw.githubusercontent.com/aa2246740/dsh-watcher/main/docs/add-plugin-wizard.png)
 
-也可以装 latest：
+### 使用 `dsh` 命令行安装
+
+从 [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh) 安装 [`dsh-watcher`](https://www.npmjs.com/package/dsh-watcher) 插件：
 
 ```sh
 dsh plugin --profile web add dsh-watcher
 ```
 
-备选：从 GitHub 直装（跟默认分支最新提交）：
+更新 `dsh-watcher` 插件：
 
 ```sh
-dsh plugin --profile web add github:aa2246740/dsh-watcher
+dsh plugin --profile web update dsh-watcher@latest
 ```
 
-PATH 上需要官方 `dsh`（或 `npx @deepseek-ai/dsh`）和 **pnpm**。`dsh plugin add` 会在 `$DSH_HOME/profiles/web` 里跑 pnpm，并因为本包装了 `dsh.bundle.patch` 而写入 profile bundles。然后**重启这个 Host，再刷新页面**。它只写 profile，不会热挂正在跑的进程。
+然后用 `dsh web` 启动 Web 界面。无需构建、无需重启。
+
+这条官方 CLI 命令只写入 `web` profile，不能修改 Desktop App 的 profile；桌面端请使用上面的应用内“添加插件”向导。本发布已提交 `lib/`；普通使用不需要 clone、构建或安装 DSHX。
 
-仓库已提交 `lib/`，npm / git 安装不用再构建，也不走 `prepare` / `allowBuilds`。需要 DeepSeek Harness **0.1.7-rc.1**（`@deepseek-ai/dsh@0.1.7-rc.1`），Node `^22.19.0` 或 `>=24`。
+需要 DeepSeek Harness **0.2.0-rc.2**（`@deepseek-ai/dsh@0.2.0-rc.2`，`dsh-v0.2.0-rc.2`）。`@deepseek-ai/dsh-*` 的 peer 范围是 `>=0.2.0-rc.1 <0.2.1`：接受 **0.2.0-rc.2** 和稳定版 **0.2.0**，拒绝 alpha，也拒绝 **0.1.7-rc.2**。Node `^22.19.0` 或 `>=24`。
 
 DeepSeek Harness Web 的只读插件。点会话标题栏里的眼睛，把 Session 收成一张能折叠的工作路径：这轮走了几步、跑了几次、花了多久；再展开某一步看并行分支、工具结果，或一条默认折着的推理记录。
 
@@ -40,26 +48,49 @@ DeepSeek Harness Web 的只读插件。点会话标题栏里的眼睛，把 Sess
 
 归类只叠能证明相同的调用。两条不同的 bash 不会被捏在一起。模型阶段只显示供应商已经写进 Session 的可见 reasoning；没有记录就写未记录。
 
-已经 clone 过的目录也可以：
+### 高级安装方式
+
+固定到某个 GitHub 标签：
+
+```sh
+dsh plugin --profile web add github:aa2246740/dsh-watcher#v0.8.0
+```
+
+已经 clone 过的目录也可以（开发/本地测试）：
 
 ```sh
 git clone https://github.com/aa2246740/dsh-watcher.git
 dsh plugin --profile web add ./dsh-watcher
 ```
 
-同样需要 pnpm，然后重启 Host 并刷新页面。
+同样需要 pnpm，然后重新打开该 Web Host 并刷新页面。
 
 ```sh
 dsh plugin --profile web remove dsh-watcher
 ```
 
-DSH.app 的 `desktop` profile 不接受 `github:`。用 `dsh web` 装进 web profile。
+官方 CLI 只管理 `web` profile；Desktop App 请使用上面的应用内“添加插件”入口。
 
 设置页和会话 HUD 的 Token 总数旁有 **估算费用**（不是「总价值」）。按模型的输入 / 输出 / 缓存桶对照 `pricing/models.yaml` 计价；缺行显示 **未知**，不会当成 $0。部分已知时主数字只显示已标价金额，未标价写在脚注。这是估算，不是账单。默认表含 DeepSeek、MiniMax、OpenAI、Anthropic、Gemini、Grok、GLM、Qwen 主流行，不联网。设置里打开的是当前生效价格表；保存只把改动过的行写入 `localStorage` 键 `dsh-watcher:pricing-override:v1`。欢迎对默认表提 PR。
 
 交互约定在 [DESIGN.md](./DESIGN.md)。MIT。
 
-## 本次更新（0.6.0）
+## 本次更新（0.8.0）
+
+- 日图按每次结算的本地日历日记 token，不再把整段会话堆到最后活跃日。旧的 version 1 缓存仍按原来的方式显示，会话重算后变成 version 2。
+- 装了 dsh-better-sidebar 时，右侧栏多一个 Watcher 页，内容是工作图。没装时，会话头按钮和设置页不变。侧栏不是依赖。
+
+## 0.7.0
+
+- 对齐官方 DeepSeek Harness **0.2.0-rc.2**（`dsh-v0.2.0-rc.2`，SHA `639ed015397290b3745d163aafe02ffee4aa3f84`）。`@deepseek-ai/dsh-*` 的 peer 是 `>=0.2.0-rc.1 <0.2.1`：接受 `0.2.0-rc.2` 和稳定版 `0.2.0`，拒绝 alpha，也拒绝 `0.1.7-rc.2`。
+- 图标仍是 `IconChevronRightOutlineRegular`、`IconRefreshOutlineRegular`、`IconCheckOutlineRegular`、`IconCopyOutlineRegular`。这四个名字在 `dsh-v0.2.0-rc.2` 的 primitives 里还在。带尺寸后缀的旧导出仍然没有。
+
+## 0.6.1
+
+- 在官方 DeepSeek Harness **0.1.7-rc.2** 上核对通过。`@deepseek-ai/dsh-*` 的 peer 仍是 `>=0.1.7-rc.1 <0.1.8`，安装期接受 `0.1.7-rc.1` 和 `0.1.7-rc.2`，不接受 `0.1.7-alpha.*`。
+- 图标仍是 `IconChevronRightOutlineRegular`、`IconRefreshOutlineRegular`、`IconCheckOutlineRegular`、`IconCopyOutlineRegular`。rc.2 同样没有带尺寸后缀的旧导出。
+
+## 0.6.0
 
 - 对齐官方 DeepSeek Harness **0.1.7-rc.1**。`@deepseek-ai/dsh-*` 的 peer 改为 `>=0.1.7-rc.1 <0.1.8`，安装期接受 `0.1.7-rc.1`，不接受 `0.1.7-alpha.*`。
 - 图标改为 `IconChevronRightOutlineRegular`、`IconRefreshOutlineRegular`、`IconCheckOutlineRegular`、`IconCopyOutlineRegular`。rc.1 删掉了带尺寸后缀的旧导出，没有别名。