dsh-bottom-cost 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 本插件的所有显著变更。版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)；
 投影状态的形状变化会体现为 `stateVersion` 递增（旧检查点会自动作废并重放，不需要你手工清理）。
 
+## [0.5.2] - 2026-10-14
+
+### 文档
+
+- **安装方式改为「输入包名 `dsh-bottom-cost`」优先**，仓库地址作为 `dsh web` 上的备选写在同一条里（它要经 codeload 下载 tarball，网络抖动会失败）。包名这条路到处都能用，**包括官方桌面客户端——它只支持 npm 源**。
+- 新增一句「**更新是显式的**」：安装会钉住精确版本（profile 里写成 `"dsh-bottom-cost": "0.5.1"` 这种），新版本要你在插件管理里点**更新**才生效。
+
+（纯文档改动；之所以要单独发一个版本，是因为**已经发布的 npm 版本不可覆盖**，npm 页面上的 README 只会随新版本更新。）
+
 ## [0.5.1] - 2026-10-13
 
 ### 修复
@@ -111,6 +120,7 @@
   每次调用按**发生时刻**的档位计费。
 - 非 DeepSeek 官方路由一律「未计价」并统计次数，不假装是 0 元。
 
+[0.5.2]: https://github.com/LanFeng97/dsh-bottom-cost/releases/tag/v0.5.2
 [0.5.1]: https://github.com/LanFeng97/dsh-bottom-cost/releases/tag/v0.5.1
 [0.5.0]: https://github.com/LanFeng97/dsh-bottom-cost/releases/tag/v0.5.0
 [0.4.0]: https://github.com/LanFeng97/dsh-bottom-cost/releases/tag/v0.4.0

package/README.md

@@ -11,11 +11,15 @@ A **session cost** chip for [DeepSeek Harness](https://github.com/deepseek-ai/de
 ### Option 1 — install it from the DSH UI (simplest)
 
 1. Open **插件 → 添加插件** (Plugins → Add plugin) in the sidebar;
-2. Paste the repository URL: `https://github.com/LanFeng97/dsh-bottom-cost`;
+2. Type either one:
+   - the package name **`dsh-bottom-cost`** — works everywhere, including the official desktop client (which can only install npm sources), or
+   - the repository URL `https://github.com/LanFeng97/dsh-bottom-cost` — works on `dsh web`; the market resolves it to a tarball from codeload, so a flaky network can fail it;
 3. Click **安装** (Install), then **restart DeepSeek Harness** as its banner tells you to (close the running `dsh` process and start it again, e.g. `dsh web`).
 
 The host half is a Node module, so **a config reload alone will not import it** — that restart is not optional. Once restarted, open the UI and the chip is there; no page refresh needed.
 
+**Updating later is explicit.** An installation pins the exact version (the profile ends up with `"dsh-bottom-cost": "0.5.1"`), so a new release reaches you when you press **更新** (Update) in the plugin manager — nothing changes under you in between.
+
 ### Option 2 — let your AI install it
 
 Paste this whole block into any AI that can read and write your machine (an agent inside DSH, Claude Code, Codex — anything):

package/README.zh.md

@@ -11,11 +11,15 @@
 ### 方式一：在 DSH 界面里装（最简单）
 
 1. 侧栏打开**插件 → 添加插件**；
-2. 粘贴仓库地址：`https://github.com/LanFeng97/dsh-bottom-cost`；
+2. 二选一填进去：
+   - 包名 **`dsh-bottom-cost`** —— 到处都能装，**包括官方桌面客户端**（它只支持 npm 源）；
+   - 仓库地址 `https://github.com/LanFeng97/dsh-bottom-cost` —— 在 `dsh web` 上可用；它要经 codeload 下载 tarball，网络抖动会失败；
 3. 点**安装**，再按它的提示**重启 DeepSeek Harness**（关闭当前 `dsh` 进程后重新运行，例如 `dsh web`）。
 
 宿主半区是 Node 模块，**只重载配置不会被导入**，所以这一步重启不能省。重启后打开界面就能看到胶囊，不需要再刷新页面。
 
+**以后的更新是显式的。** 安装会钉住精确版本（profile 里会写成 `"dsh-bottom-cost": "0.5.1"`），所以新版本要你在插件管理里点**更新**才会生效——它不会在你不知情的时候自己变。
+
 ### 方式二：让你的 AI 帮你装
 
 把下面这一整段复制给任意一个能读写你电脑的 AI（DSH 里的 agent、Claude Code、Codex 都行），它会自己完成克隆与安装：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bottom-cost",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Per-turn session cost chip in the composer stats row: each turn's spend, with the conversation total split into cache-hit and cache-miss (CNY), priced from an official price table that refreshes on demand. · 输入框下方统计栏里的会话费用胶囊：逐轮列出每轮花费，并把总额拆成缓存命中与未命中两笔（CNY）；价目表按需从官方定价页刷新。",
   "license": "MIT",
   "author": "LanFeng97",