dsh-dscost-tide 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/CHANGELOG.md +7 -1
  2. package/README.en.md +5 -3
  3. package/README.md +132 -130
  4. package/lib/index.js +1 -1
  5. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  本文件记录 `dsh-dscost-tide` 的发布变更。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
4
4
 
5
+ ## 1.0.1 — 2026-10-31
6
+
7
+ **修复**
8
+
9
+ - npm 包里的 README 安装命令写成了 `@yanzi-251147/dsh-dscost-tide`，而实际发布名是不带 scope 的 `dsh-dscost-tide`（`@yanzi-251147` 不是 npm 账号所拥有的 scope）。本版本把中英 README、`publish.yml`、`CHANGELOG` 里的名字全部对齐为 `dsh plugin add dsh-dscost-tide`，并改由 GitHub Actions 发布，顺带验证 CI 发布链路。
10
+
5
11
  ## 1.0.0 — 2026-10-31
6
12
 
7
13
  首个公开版本。侧边栏底部卡片 + 点击弹窗，覆盖「现在是不是高峰时段、账户还有多少钱、这些钱花在哪些 token 上」。
@@ -18,7 +24,7 @@
18
24
  **变更**
19
25
 
20
26
  - 行 id 与座位占用 id 统一为插件名（先改名 `dsh-deepseek-tide`，最终随仓库定名 `dsh-dscost-tide`；更早是 `deepseek-tide`），避免与其他峰谷插件撞 id。
21
- - 项目定名 **`dsh-dscost-tide`**（与 GitHub 仓库同名），npm 发布名 `@yanzi-251147/dsh-dscost-tide`；回环路由前缀随之改为 `/dsh-dscost-tide/api`。
27
+ - 项目定名 **`dsh-dscost-tide`**（与 GitHub 仓库同名），npm 发布名同为 `dsh-dscost-tide`（不带 scope，2026-10-31 已发布 1.0.0）；回环路由前缀随之改为 `/dsh-dscost-tide/api`。
22
28
  - 包元数据补全：`repository` / `homepage` / `bugs` / `keywords` / `files` / `engines`，可用于 npm 发布与插件市场收录。
23
29
 
24
30
  ## 0.4.1 — 2026-10-31
package/README.en.md CHANGED
@@ -42,7 +42,7 @@ Window 2026-10-05 to 2026-10-05
42
42
  Once published:
43
43
 
44
44
  ```bash
45
- dsh plugin add @yanzi-251147/dsh-dscost-tide
45
+ dsh plugin add dsh-dscost-tide
46
46
  ```
47
47
 
48
48
  or open it in **Plugins → Installed**. Afterwards, **fully quit and restart DeepSeek Harness** — the client bundle is preloaded at startup, so a hot reload cannot pick up new UI code.
@@ -91,13 +91,15 @@ node scripts/check-publish.mjs # manifest / files / placeholder checks
91
91
  node scripts/prepare-publish.mjs # build the publishable copy and pack it
92
92
  ```
93
93
 
94
- The working tree keeps `"name": "dsh-dscost-tide"` (it is the install key in the profile's `dependencies` / `dsh.profile.bundles`), so publishing under the scoped npm name starts with:
94
+ The working tree keeps `"name": "dsh-dscost-tide"` (it is the install key in the profile's `dependencies` / `dsh.profile.bundles`), and that same unscoped name is used on npm, so publishing starts with:
95
95
 
96
96
  ```bash
97
- node scripts/prepare-publish.mjs --name @yanzi-251147/dsh-dscost-tide --repo yanzi-251147/dsh-dscost-tide
97
+ node scripts/prepare-publish.mjs --repo yanzi-251147/dsh-dscost-tide
98
98
  cd _intermediate/publish && npm publish --access public
99
99
  ```
100
100
 
101
+ > npm writes a `0.0.0-stage` placeholder version when the package is first created and then uploads the real version — that is npm's current policy for bypass-2FA tokens, not a failure. One `npm publish` is enough; no approval step is involved.
102
+
101
103
  ## License
102
104
 
103
105
  [MIT](./LICENSE)
package/README.md CHANGED
@@ -1,130 +1,132 @@
1
- # dsh-dscost-tide
2
-
3
- > 在 DeepSeek Harness 侧边栏底部看一眼就知道：**现在是高峰还是低谷、账户还有多少钱、这些钱花在哪些 token 上。**
4
-
5
- 一个 DSH 组合包（Cordis 插件）插件，占用侧边栏底部的 `sidebar.footer.action` 座位，排在官方余额插件之后。
6
-
7
- ## 长什么样
8
-
9
- 侧边栏底部是一张两行卡片，高峰染红、低谷染绿：
10
-
11
- ```
12
- ● 高峰期 距入谷 2 小时 30 分
13
- ¥余额 14:32
14
- ```
15
-
16
- 点一下卡片弹出详情（四个区）：
17
-
18
- ```
19
- 现在 高峰期
20
- 高峰按时段价，低谷五折 ← Hero 胶囊
21
-
22
- 计费时段
23
- 倒计时 距入谷 2 小时 30 分
24
- 下次切换 今天 12:00（入谷）
25
- [ 24 格峰谷条：凌晨 / 上午 / 午后 / 晚间 ]
26
-
27
- 账户余额
28
- 总额 ¥数字
29
- 充值钱包 ¥数字
30
- 赠送钱包 ¥数字
31
-
32
- 用量统计 [今天][近 7 天][近 30 天][全部]
33
- 消耗 token 1,069 万 缓存命中率 95.57%
34
- 消耗金额 ¥1.27 API 请求次数 137
35
- 提示词 10,550,026（命中 10,082,816 · 未命中 467,210）
36
- 输出 149,427
37
- 模型调用 137 次 · ¥1.2666
38
- 联网搜索 0 次 · ¥0.0000
39
- 统计天数 6 天 · 日均 ¥0.2111
40
- 统计区间 2026-10-05 至 2026-10-05
41
- ```
42
-
43
- ## 功能
44
-
45
- - **峰谷一眼可见**：按官方峰谷时段（北京时间工作日 09:00–12:00、14:00–18:00 为高峰，其余为低谷；2026-08-23 起周末全天低谷）给卡片染色，并显示距下次切换的倒计时。
46
- - **账户余额**：优先读取 Host 已授权的 DeepSeek 账户余额（充值钱包 + 赠送钱包），读不到时回退到 `DEEPSEEK_API_KEY` 查询 `api.deepseek.com/user/balance`。
47
- - **用量统计（按时间维度）**：`今天` / `近 7 天` / `近 30 天` / `全部` 四档，给出消耗 token、缓存命中率、消耗金额、API 请求次数，以及提示词命中/未命中、输出、模型调用、联网搜索、日均与统计区间。
48
- - **真实计价**：token 不估算，逐个 `assistant/message` 事件按**它自己的时间戳**套用当时生效的峰谷价（含 2026-09-10 12:00 的 Flash 调价），联网搜索按 ¥0.02/次计。
49
- - **不打扰**：只在弹窗打开时拉取用量；折叠结果按会话日志版本号缓存，刷新只重读变化的日志。
50
-
51
- ## 安装
52
-
53
- ### 方式一：作为组合包安装（推荐）
54
-
55
- 发布到 npm 之后，在 DSH 的 **插件** 页直接安装并启用：
56
-
57
- ```bash
58
- npm install -g dsh # 已有 DSH 可跳过
59
- dsh plugin add @yanzi-251147/dsh-dscost-tide
60
- ```
61
-
62
- 或在「插件 → 已安装」里打开本插件。装好后**完全退出并重启 DeepSeek Harness**（客户端 bundle 在启动时预载，热更新拿不到新的 UI 代码）。
63
-
64
- ### 方式二：从本地源码 `link:` 安装
65
-
66
- 适合改代码调试。编辑 `~/.dsh/profiles/<profile>/package.json`：
67
-
68
- ```json
69
- {
70
- "dependencies": {
71
- "dsh-dscost-tide": "link:E:/path/to/dsh-dscost-tide"
72
- },
73
- "dsh": {
74
- "profile": {
75
- "bundles": ["...", "dsh-dscost-tide"]
76
- }
77
- }
78
- }
79
- ```
80
-
81
- 然后在 profile 目录执行一次 `pnpm install`，再完全重启 DSH。源码改动同样需要重启才能生效。
82
-
83
- ### 卸载
84
-
85
- 在插件页关闭或移除即可；手动安装的话，删掉 `dependencies` 与 `dsh.profile.bundles` 里的条目，重启。
86
-
87
- ## 计费口径
88
-
89
- | 模型族 | 低谷 · 输入 | 低谷 · 缓存命中 | 低谷 · 输出 | 高峰 |
90
- | --- | ---: | ---: | ---: | ---: |
91
- | Flash（`deepseek-v4-flash` / `deepseek-flash`） | ¥1 / 1M | ¥0.02 / 1M | ¥4 / 1M | ×2 |
92
- | Flash（2026-09-10 12:00 之前） | ¥1.5 / 1M | ¥0.05 / 1M | ¥4.5 / 1M | ×2 |
93
- | Pro（`deepseek-v4-pro`） | ¥4.5 / 1M | ¥0.15 / 1M | ¥13.5 / 1M | ×2 |
94
-
95
- - 高峰窗口：北京时间 **工作日 09:00–12:00、14:00–18:00**；低谷 = 其余时间（2026-08-23 起含周末全天）。
96
- - 峰谷价自 **2026-08-17** 起生效；更早的会话按低谷价计。
97
- - 一次调用的花费 = `未命中 token × 输入价 + 命中 token × 缓存价 + 输出 token × 输出价`；联网搜索另计 ¥0.02/次。
98
- - 金额单位 CNY。价格随官方调整而变化，若与账单有出入，以 [DeepSeek 官方定价](https://api-docs.deepseek.com/quick_start/pricing) 为准。
99
-
100
- ## 数据来源与隐私
101
-
102
- - **峰谷**：纯本地时钟计算，不联网。
103
- - **余额**：Host 侧账户授权（或你配置的 `DEEPSEEK_API_KEY`）向 DeepSeek 查询，只走本机回环路由 `/dsh-dscost-tide/api/balance`。
104
- - **用量**：只读本机 `~/.dsh/sessions/**` 会话日志，不读取、不外发任何消息内容；fork/子代理会话按 `inheritedEventCount` 跳过继承的父前缀，避免重复计数。
105
- - 两条路由都只服务本机回环请求：校验 `Host` 必须是回环或受信主机，拒绝跨站请求与不匹配的 `Origin`。
106
-
107
- ## 兼容性
108
-
109
- - 需要 DeepSeek Harness **0.2.x**（`engines.dsh: >=0.2.0-rc.1 <0.3.0-0`），在 `0.2.1-rc.5`（Windows 桌面端）上验证。
110
- - 浏览器端需要 `@deepseek-ai/dsh-client-ui-primitives`（存在时使用其 `Modal`，缺失时自动回退到自带遮罩层）。
111
- - Node.js ≥ 22（仅开发/测试需要）。
112
-
113
- ## 开发
114
-
115
- ```bash
116
- node --test test/plugin.test.mjs # 纯函数级离线测试，不需要 DSH 运行时
117
- node scripts/check-publish.mjs # 发布前自检（清单字段 / 文件 / 占位符）
118
- node scripts/prepare-publish.mjs # 生成可发布副本并打包，打印 tarball 内容
119
- ```
120
-
121
- `prepare-publish` 会把可发布的文件复制到 `_intermediate/publish/`，可选择改写包名与仓库地址。发布到 npm 用 scoped 名是惯例，而本地工作树里的 `name` 保持 `dsh-dscost-tide` 不动（它是 profile `dependencies` / `dsh.profile.bundles` 里的安装键，改名会让两者失配），所以发布前跑一次：
122
-
123
- ```bash
124
- node scripts/prepare-publish.mjs --name @yanzi-251147/dsh-dscost-tide --repo yanzi-251147/dsh-dscost-tide
125
- cd _intermediate/publish && npm publish --access public
126
- ```
127
-
128
- ## 许可
129
-
130
- [MIT](./LICENSE)
1
+ # dsh-dscost-tide
2
+
3
+ > 在 DeepSeek Harness 侧边栏底部看一眼就知道：**现在是高峰还是低谷、账户还有多少钱、这些钱花在哪些 token 上。**
4
+
5
+ 一个 DSH 组合包（Cordis 插件）插件，占用侧边栏底部的 `sidebar.footer.action` 座位，排在官方余额插件之后。
6
+
7
+ ## 长什么样
8
+
9
+ 侧边栏底部是一张两行卡片，高峰染红、低谷染绿：
10
+
11
+ ```
12
+ ● 高峰期 距入谷 2 小时 30 分
13
+ ¥余额 14:32
14
+ ```
15
+
16
+ 点一下卡片弹出详情（四个区）：
17
+
18
+ ```
19
+ 现在 高峰期
20
+ 高峰按时段价，低谷五折 ← Hero 胶囊
21
+
22
+ 计费时段
23
+ 倒计时 距入谷 2 小时 30 分
24
+ 下次切换 今天 12:00（入谷）
25
+ [ 24 格峰谷条：凌晨 / 上午 / 午后 / 晚间 ]
26
+
27
+ 账户余额
28
+ 总额 ¥数字
29
+ 充值钱包 ¥数字
30
+ 赠送钱包 ¥数字
31
+
32
+ 用量统计 [今天][近 7 天][近 30 天][全部]
33
+ 消耗 token 1,069 万 缓存命中率 95.57%
34
+ 消耗金额 ¥1.27 API 请求次数 137
35
+ 提示词 10,550,026（命中 10,082,816 · 未命中 467,210）
36
+ 输出 149,427
37
+ 模型调用 137 次 · ¥1.2666
38
+ 联网搜索 0 次 · ¥0.0000
39
+ 统计天数 6 天 · 日均 ¥0.2111
40
+ 统计区间 2026-10-05 至 2026-10-05
41
+ ```
42
+
43
+ ## 功能
44
+
45
+ - **峰谷一眼可见**：按官方峰谷时段（北京时间工作日 09:00–12:00、14:00–18:00 为高峰，其余为低谷；2026-08-23 起周末全天低谷）给卡片染色，并显示距下次切换的倒计时。
46
+ - **账户余额**：优先读取 Host 已授权的 DeepSeek 账户余额（充值钱包 + 赠送钱包），读不到时回退到 `DEEPSEEK_API_KEY` 查询 `api.deepseek.com/user/balance`。
47
+ - **用量统计（按时间维度）**：`今天` / `近 7 天` / `近 30 天` / `全部` 四档，给出消耗 token、缓存命中率、消耗金额、API 请求次数，以及提示词命中/未命中、输出、模型调用、联网搜索、日均与统计区间。
48
+ - **真实计价**：token 不估算，逐个 `assistant/message` 事件按**它自己的时间戳**套用当时生效的峰谷价（含 2026-09-10 12:00 的 Flash 调价），联网搜索按 ¥0.02/次计。
49
+ - **不打扰**：只在弹窗打开时拉取用量；折叠结果按会话日志版本号缓存，刷新只重读变化的日志。
50
+
51
+ ## 安装
52
+
53
+ ### 方式一：作为组合包安装（推荐）
54
+
55
+ 发布到 npm 之后，在 DSH 的 **插件** 页直接安装并启用：
56
+
57
+ ```bash
58
+ npm install -g dsh # 已有 DSH 可跳过
59
+ dsh plugin add dsh-dscost-tide
60
+ ```
61
+
62
+ 或在「插件 → 已安装」里打开本插件。装好后**完全退出并重启 DeepSeek Harness**（客户端 bundle 在启动时预载，热更新拿不到新的 UI 代码）。
63
+
64
+ ### 方式二：从本地源码 `link:` 安装
65
+
66
+ 适合改代码调试。编辑 `~/.dsh/profiles/<profile>/package.json`：
67
+
68
+ ```json
69
+ {
70
+ "dependencies": {
71
+ "dsh-dscost-tide": "link:E:/path/to/dsh-dscost-tide"
72
+ },
73
+ "dsh": {
74
+ "profile": {
75
+ "bundles": ["...", "dsh-dscost-tide"]
76
+ }
77
+ }
78
+ }
79
+ ```
80
+
81
+ 然后在 profile 目录执行一次 `pnpm install`，再完全重启 DSH。源码改动同样需要重启才能生效。
82
+
83
+ ### 卸载
84
+
85
+ 在插件页关闭或移除即可；手动安装的话，删掉 `dependencies` 与 `dsh.profile.bundles` 里的条目，重启。
86
+
87
+ ## 计费口径
88
+
89
+ | 模型族 | 低谷 · 输入 | 低谷 · 缓存命中 | 低谷 · 输出 | 高峰 |
90
+ | --- | ---: | ---: | ---: | ---: |
91
+ | Flash（`deepseek-v4-flash` / `deepseek-flash`） | ¥1 / 1M | ¥0.02 / 1M | ¥4 / 1M | ×2 |
92
+ | Flash（2026-09-10 12:00 之前） | ¥1.5 / 1M | ¥0.05 / 1M | ¥4.5 / 1M | ×2 |
93
+ | Pro（`deepseek-v4-pro`） | ¥4.5 / 1M | ¥0.15 / 1M | ¥13.5 / 1M | ×2 |
94
+
95
+ - 高峰窗口：北京时间 **工作日 09:00–12:00、14:00–18:00**；低谷 = 其余时间（2026-08-23 起含周末全天）。
96
+ - 峰谷价自 **2026-08-17** 起生效；更早的会话按低谷价计。
97
+ - 一次调用的花费 = `未命中 token × 输入价 + 命中 token × 缓存价 + 输出 token × 输出价`；联网搜索另计 ¥0.02/次。
98
+ - 金额单位 CNY。价格随官方调整而变化，若与账单有出入，以 [DeepSeek 官方定价](https://api-docs.deepseek.com/quick_start/pricing) 为准。
99
+
100
+ ## 数据来源与隐私
101
+
102
+ - **峰谷**：纯本地时钟计算，不联网。
103
+ - **余额**：Host 侧账户授权（或你配置的 `DEEPSEEK_API_KEY`）向 DeepSeek 查询，只走本机回环路由 `/dsh-dscost-tide/api/balance`。
104
+ - **用量**：只读本机 `~/.dsh/sessions/**` 会话日志，不读取、不外发任何消息内容；fork/子代理会话按 `inheritedEventCount` 跳过继承的父前缀，避免重复计数。
105
+ - 两条路由都只服务本机回环请求：校验 `Host` 必须是回环或受信主机，拒绝跨站请求与不匹配的 `Origin`。
106
+
107
+ ## 兼容性
108
+
109
+ - 需要 DeepSeek Harness **0.2.x**（`engines.dsh: >=0.2.0-rc.1 <0.3.0-0`），在 `0.2.1-rc.5`（Windows 桌面端）上验证。
110
+ - 浏览器端需要 `@deepseek-ai/dsh-client-ui-primitives`（存在时使用其 `Modal`，缺失时自动回退到自带遮罩层）。
111
+ - Node.js ≥ 22（仅开发/测试需要）。
112
+
113
+ ## 开发
114
+
115
+ ```bash
116
+ node --test test/plugin.test.mjs # 纯函数级离线测试，不需要 DSH 运行时
117
+ node scripts/check-publish.mjs # 发布前自检（清单字段 / 文件 / 占位符）
118
+ node scripts/prepare-publish.mjs # 生成可发布副本并打包，打印 tarball 内容
119
+ ```
120
+
121
+ `prepare-publish` 会把可发布的文件复制到 `_intermediate/publish/`，并改写仓库地址。本地工作树里的 `name` 保持 `dsh-dscost-tide` 不动（它是 profile `dependencies` / `dsh.profile.bundles` 里的安装键），npm 上的包名也沿用同一个，发布前跑一次：
122
+
123
+ ```bash
124
+ node scripts/prepare-publish.mjs --repo yanzi-251147/dsh-dscost-tide
125
+ cd _intermediate/publish && npm publish --access public
126
+ ```
127
+
128
+ > npm 会先在建包时写一个 `0.0.0-stage` 占位版本再上传正式版本，这是 npm 对 bypass-2FA token 的新策略，属正常现象。发布只需要一次 `npm publish`，无需再批准。
129
+
130
+ ## 许可
131
+
132
+ [MIT](./LICENSE)
package/lib/index.js CHANGED
@@ -35,7 +35,7 @@
35
35
  /** Route prefix owned by this plugin — deliberately outside the built-in /api gateway. */
36
36
  const ROUTE_PREFIX = "/dsh-dscost-tide/api";
37
37
  /** Identity reported to Platform with every balance query. */
38
- const CLIENT_VERSION = "1.0.0";
38
+ const CLIENT_VERSION = "1.0.1";
39
39
  const CLIENT_LOCALE = "zh-CN";
40
40
  /** Fallback source, used only when the stored account grant cannot answer. */
41
41
  const API_KEY_REF = "DEEPSEEK_API_KEY";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-dscost-tide",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "DeepSeek peak/valley indicator in the DSH sidebar footer: phase at a glance, account balance, and a click-through dashboard with balance plus time-dimensioned token, cache-hit, cost and request statistics",
5
5
  "license": "MIT",
6
6
  "author": "yanzi-251147",
@@ -59,4 +59,4 @@
59
59
  "pack:check": "node scripts/check-publish.mjs",
60
60
  "prepare:publish": "node scripts/prepare-publish.mjs"
61
61
  }
62
- }
62
+ }