dsh-watcher 0.4.0-insights.1 → 0.4.2

package/README.en.md

@@ -2,13 +2,27 @@
 
 # Watcher
 
+Prefer npm (version-pinable):
+
+```sh
+dsh plugin --profile web add dsh-watcher@0.4.1
+```
+
+Or latest:
+
+```sh
+dsh plugin --profile web add dsh-watcher
+```
+
+Fallback: install from GitHub (tracks the default branch tip):
+
 ```sh
 dsh plugin --profile web add github:aa2246740/dsh-watcher
 ```
 
 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.
 
-`lib/` is committed, so a git install does not need a local build, `prepare`, or `allowBuilds`. DeepSeek Harness **0.1.5-rc.2**. Node `^22.19.0` or `>=24`.
+`lib/` is committed, so npm / git installs do not need a local build, `prepare`, or `allowBuilds`. DeepSeek Harness **0.1.5-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.
 
@@ -41,6 +55,8 @@ dsh plugin --profile web remove dsh-watcher
 
 DSH.app's `desktop` profile rejects `github:`. Use `dsh web` and install into the `web` profile.
 
+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.
 
 ## Build from source

package/README.md

@@ -2,13 +2,27 @@
 
 # Watcher
 
+推荐用 npm（可钉版本）：
+
+```sh
+dsh plugin --profile web add dsh-watcher@0.4.1
+```
+
+也可以装 latest：
+
+```sh
+dsh plugin --profile web add dsh-watcher
+```
+
+备选：从 GitHub 直装（跟默认分支最新提交）：
+
 ```sh
 dsh plugin --profile web add github:aa2246740/dsh-watcher
 ```
 
 PATH 上需要官方 `dsh`（或 `npx @deepseek-ai/dsh`）和 **pnpm**。`dsh plugin add` 会在 `$DSH_HOME/profiles/web` 里跑 pnpm，并因为本包装了 `dsh.bundle.patch` 而写入 profile bundles。然后**重启这个 Host，再刷新页面**。它只写 profile，不会热挂正在跑的进程。
 
-仓库已提交 `lib/`，git 安装不用再构建，也不走 `prepare` / `allowBuilds`。需要 DeepSeek Harness **0.1.5-rc.2**，Node `^22.19.0` 或 `>=24`。
+仓库已提交 `lib/`，npm / git 安装不用再构建，也不走 `prepare` / `allowBuilds`。需要 DeepSeek Harness **0.1.5-rc.2**，Node `^22.19.0` 或 `>=24`。
 
 DeepSeek Harness Web 的只读插件。点会话标题栏里的眼睛，把 Session 收成一张能折叠的工作路径：这轮走了几步、跑了几次、花了多久；再展开某一步看并行分支、工具结果，或一条默认折着的推理记录。
 
@@ -41,6 +55,8 @@ dsh plugin --profile web remove dsh-watcher
 
 DSH.app 的 `desktop` profile 不接受 `github:`。用 `dsh web` 装进 web profile。
 
+设置页和会话 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。
 
 ## 从源码构建