dsh-budget 0.3.0 → 0.4.0

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.
package/README.zh.md CHANGED
@@ -1,177 +1,184 @@
1
- <div align="center">
2
-
3
- # 💰 dsh-budget
4
-
5
- **DeepSeek Harness 的成本治理:预算、碳足迹与延迟,一个面板全览。**
6
-
7
- *让每次会话的成本在超支之前就被看清。*
8
-
9
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
10
- [![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
11
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
12
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-budget/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-budget/actions)
13
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-budget?label=version)](https://github.com/PerryLink/dsh-budget/releases)
14
- [![npm version](https://img.shields.io/npm/v/dsh-budget)](https://www.npmjs.com/package/dsh-budget)
15
- [![npm downloads](https://img.shields.io/npm/dm/dsh-budget)](https://www.npmjs.com/package/dsh-budget)
16
-
17
- [English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
18
-
19
- </div>
20
-
21
- ---
22
-
23
- ## 兼容性
24
-
25
- | 方面 | 状态 |
26
- |---|---|
27
- | Harness | DeepSeek Harness `0.1.1-rc.2` |
28
- | Node | `^22.19.0 \|\| >=24.0.0` |
29
- | 界面 | Host + Web 客户端(设置页预算页签);`/budget` 命令 |
30
-
31
- ## 你能得到什么
32
-
33
- `dsh-budget` 把会话事件流变成四合一成本治理闭环:
34
-
35
- - **聚合计量** —— token(未缓存输入 / 输出 / 缓存读 / 缓存写)、估算 USD 成本与碳足迹,按模型/会话/天聚合;内置 USD/百万 token 价目表与 `config.prices` 合并定价。
36
- - **预算治理** —— 会话/日/月三档封顶;warnRatio 阈值告警(webhook POST + 桌面通知开关)与三种超限策略:`alert`(仅告警)、`block`(在用户解除前短路新模型请求)、`degrade`(阻断并给出指向 `degradation` 映射中更便宜模型的修正提示)。
37
- - **碳足迹与延迟** —— token→碳桥接(tokens × kWh/token × PUE × 区域电网强度,移植自 AI-Carbon-Footprint-Calculator)与按模型延迟百分位。
38
- - **界面** —— 设置页预算页签(用量条、按天用量曲线、模型明细、告警、上限编辑、解除阻断按钮)与 `/budget` 命令(`/budget`、`/budget models`、`/budget unblock <scope>`)。
39
-
40
- ## 快速开始
41
-
42
- ```sh
43
- # 1. 把 bundle 装进你的 profile
44
- dsh plugin --profile web add "github:PerryLink/dsh-budget#main"
45
-
46
- # 或从 npm 安装(正式发布版)
47
- dsh plugin --profile web add dsh-budget
48
-
49
- # 2. 重启并核实行
50
- dsh --profile web --dump-config | grep -A2 'id: budget'
51
- ```
52
-
53
- 然后在会话里输入 `/budget`,并在设置页查看预算页签。
54
-
55
- ## 安装与卸载
56
-
57
- - **git 通道**(最新 `main`):`dsh plugin --profile web add "github:PerryLink/dsh-budget#main"` —— `prepare` 脚本仅用生产依赖构建。
58
- - **npm 通道**(正式发布版):`dsh plugin --profile web add dsh-budget`。
59
- - **tarball 通道**:在本仓库执行 `pnpm pack`,然后 `dsh plugin --profile web add ./dsh-budget-<version>.tgz`。
60
- - **卸载**:`dsh plugin --profile web remove dsh-budget`。
61
-
62
- > 如果 pnpm 对本包报 `ERR_PNPM_IGNORED_BUILDS`(esbuild 的平台二进制无害校验),在你的 `pnpm-workspace.yaml` 中加入 `allowBuilds: { esbuild: true }` —— `dsh` CLI 会打印确切片段。
63
-
64
- ## 配置
65
-
66
- 所有可调项都是 Schemastery `Config` 字段(可在 cordis.yml 中修改)。`cordis.patch.yml` 内联说明每个键。
67
-
68
- | 键 | 默认值 | 含义 |
69
- |---|---|---|
70
- | `prices` | `{}` | 每模型 USD/百万 token 价格,合并覆盖内置价目表 |
71
- | `defaultPrice` | `{input: 1.0, output: 3.0}` | 两表均无该模型时的回退价格 |
72
- | `budgets.session` / `daily` / `monthly` | `10` / `50` / `500` | 各作用域 USD 预算上限;缺省表示不限 |
73
- | `warnRatio` | `0.8` | 用量达到上限该比例时告警(0..1) |
74
- | `overLimit` | `alert` | 超限后策略:`alert` / `block` / `degrade` |
75
- | `degradation` | `{}` | 模型 id → 同厂商更便宜模型 id 的映射 |
76
- | `webhookUrl` | *(无)* | 可选阈值告警 webhook URL(POST JSON) |
77
- | `webhookTimeoutMs` | `5000` | webhook 请求超时 |
78
- | `alertsEnabled` | `true` | 阈值告警总开关 |
79
- | `alertCooldownMs` | `3600000` | 同一作用域两次告警的最小间隔(ms) |
80
- | `desktopNotifications` | `false` | 页签打开时的浏览器桌面通知 |
81
- | `refreshIntervalMs` | `5000` | 设置页签轮询间隔 |
82
- | `carbon.enabled` / `region` / `pue` / `energyKwhPerToken` | `true` / `global` / `1.58` / `0.000007` | 碳桥接(区域:global, us, eu, china, india, uk, france, iceland) |
83
- | `latency.enabled` / `windowSize` | `true` / `200` | 按模型延迟百分位与其窗口 |
84
- | `currency` | `{code: USD, rate: 1.0, decimals: 2}` | 展示货币(成本以 USD 计算,仅展示换算) |
85
- | `outputLanguage` | `en` | `/budget` 输出语言:`en` / `zh` |
86
- | `historyDays` | `30` | 面板快照保留的按天用量历史天数 |
87
- | `persistence.enabled` / `intervalMs` | `true` / `10000` | 日/月用量跨重启持久化(storage 域);域缺失时降级为进程内聚合 |
88
-
89
- ## 工具与界面
90
-
91
- | 界面 | 类型 | 说明 |
92
- |---|---|---|
93
- | `/budget` | 命令 | 各作用域概览(用量、比例、碳足迹、阻断状态) |
94
- | `/budget models` | 命令 | 按模型明细 + 延迟百分位 |
95
- | `/budget unblock <scope>` | 命令 | 解除某作用域阻断(`session` / `daily` / `monthly`) |
96
- | 设置 → 插件 → 预算 | 设置页签 | 用量条、按天用量曲线、模型明细、告警、上限编辑、解除阻断按钮 |
97
- | `budget/status`、`budget/setSettings`、`budget/unblock` | Typert Remote | 客户端通道(页签消费这些方法) |
98
-
99
- ## 权限与数据
100
-
101
- - **权限**:`network:outbound`(仅可选告警 webhook)、`session:append`(审计事件)、`native-code:none`。
102
- - **数据**:展示内容全部来自会话事件流;主机侧唯一网络调用是配置的 webhook,URL 在加载时校验、入日志前剥离凭据。任何 prompt/载荷都不会离开主机。
103
- - **会话日志**:`budget/alert` 与 `budget/block` 是仅日志审计事件,只携带作用域名与 USD 金额(微任务延后以绕过会话 append 重入保护)。
104
-
105
- ## 安全边界
106
-
107
- - **不伪造数据**:预算阻断在 `llm/stream` 瀑布上产出修正性错误 finish —— 插件绝不编造模型输出。
108
- - **不改写请求**:loop 构建的请求被冻结;`degrade` 因此在修正消息中点名目标模型,而非替换请求。
109
- - **失败大声**:非法价格、URL、比例、区域与边界在挂载时即失败。
110
- - **如实作用域**:面板的运行时编辑仅会话级生效;重载后恢复 cordis.yml 配置。
111
-
112
- ## 已知限制
113
-
114
- - 聚合为进程本地:harness 重启后用量清零(日/月桶从当前会话日志视图重建)。
115
- - `block`/`degrade` 依赖 `llm/stream` 瀑布;无此 seam 的构建无法阻断请求(告警仍有效)。
116
- - 内置价目会漂移;用 `config.prices` 覆盖条目。
117
-
118
- ## 开发
119
-
120
- ```sh
121
- pnpm install # node ^22.19 || >=24
122
- pnpm run typecheck # tsc:src + tests,对照本地 harness checkout
123
- pnpm run typecheck:ci # tsc:对照已发布的 0.1.1-rc.2 类型(无 paths)
124
- pnpm test # vitest
125
- pnpm run build # tsc 声明 + tsdown bundles(lib/)
126
- pnpm run verify:self-contained # 依赖声明全部来自 registry
127
- pnpm run verify:artifacts # 构建产物 ESM 面 + typert manifest + 客户端 bundle
128
- pnpm pack # 发布用 tarball
129
- ```
130
-
131
- ## Topics
132
-
133
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `budget`, `cost-tracking`, `carbon-footprint`, `latency-benchmark`, `token-usage`
134
-
135
- ## Contributors
136
-
137
- - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:聚合、预算治理、碳足迹与延迟移植、设置页签与五语文档。
138
-
1
+ <div align="center">
2
+
3
+ # 💰 dsh-budget
4
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-budget`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)。
5
+
6
+ **DeepSeek Harness 的成本治理:预算、碳足迹与延迟,一个面板全览。**
7
+
8
+ *让每次会话的成本在超支之前就被看清。*
9
+
10
+ > **官方仓库。** 本仓库是 dsh-budget 的唯一官方仓库,由 PerryLink 维护。其他账号下的同名仓库与本项目无关。
11
+
12
+ [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
13
+ [![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
14
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
15
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-budget/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-budget/actions)
16
+ [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-budget?label=version)](https://github.com/PerryLink/dsh-budget/releases)
17
+ [![npm version](https://img.shields.io/npm/v/dsh-budget)](https://www.npmjs.com/package/dsh-budget)
18
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-budget)](https://www.npmjs.com/package/dsh-budget)
19
+
20
+ [English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
21
+
22
+ </div>
23
+
24
+ ---
25
+
26
+ ## 兼容性
27
+
28
+ | 方面 | 状态 |
29
+ |---|---|
30
+ | Harness | DeepSeek Harness `0.1.1-rc.2` |
31
+
32
+ | 审计事件 | `0.1.2-alpha.1` 之前的宿主上写入;在 `0.1.2-alpha.1` 及以后抑制并记录降级原因(fail-closed 会话事件词表,无外部注册面) || Node | `^22.19.0 \|\| >=24.0.0` |
33
+ | 界面 | Host + Web 客户端(设置页预算页签);`/budget` 命令 |
34
+
35
+ ## 你能得到什么
36
+
37
+ `dsh-budget` 把会话事件流变成四合一成本治理闭环:
38
+
39
+ - **聚合计量** —— token(未缓存输入 / 输出 / 缓存读 / 缓存写)、估算 USD 成本与碳足迹,按模型/会话/天聚合;内置 USD/百万 token 价目表与 `config.prices` 合并定价。
40
+ - **预算治理** —— 会话/日/月三档封顶;warnRatio 阈值告警(webhook POST + 桌面通知开关)与三种超限策略:`alert`(仅告警)、`block`(在用户解除前短路新模型请求)、`degrade`(阻断并给出指向 `degradation` 映射中更便宜模型的修正提示)。
41
+ - **碳足迹与延迟** —— token→碳桥接(tokens × kWh/token × PUE × 区域电网强度,移植自 AI-Carbon-Footprint-Calculator)与按模型延迟百分位。
42
+ - **界面** —— 设置页预算页签(用量条、按天用量曲线、模型明细、告警、上限编辑、解除阻断按钮)与 `/budget` 命令(`/budget`、`/budget models`、`/budget unblock <scope>`)。
43
+
44
+ ## 快速开始
45
+
46
+ ```sh
47
+ # 1. 把 bundle 装进你的 profile
48
+ dsh plugin --profile web add "github:PerryLink/dsh-budget#main"
49
+
50
+ # 或从 npm 安装(正式发布版)
51
+ dsh plugin --profile web add dsh-budget
52
+
53
+ # 2. 重启并核实行
54
+ dsh --profile web --dump-config | grep -A2 'id: budget'
55
+ ```
56
+
57
+ 然后在会话里输入 `/budget`,并在设置页查看预算页签。
58
+
59
+ ## 安装与卸载
60
+
61
+ - **git 通道**(最新 `main`):`dsh plugin --profile web add "github:PerryLink/dsh-budget#main"` —— `prepare` 脚本仅用生产依赖构建。
62
+ - **npm 通道**(正式发布版):`dsh plugin --profile web add dsh-budget`。
63
+ - **tarball 通道**:在本仓库执行 `pnpm pack`,然后 `dsh plugin --profile web add ./dsh-budget-<version>.tgz`。
64
+ - **卸载**:`dsh plugin --profile web remove dsh-budget`。
65
+
66
+ > 如果 pnpm 对本包报 `ERR_PNPM_IGNORED_BUILDS`(esbuild 的平台二进制无害校验),在你的 `pnpm-workspace.yaml` 中加入 `allowBuilds: { esbuild: true }` —— `dsh` CLI 会打印确切片段。
67
+
68
+ ## 配置
69
+
70
+ 所有可调项都是 Schemastery `Config` 字段(可在 cordis.yml 中修改)。`cordis.patch.yml` 内联说明每个键。
71
+
72
+ | 键 | 默认值 | 含义 |
73
+ |---|---|---|
74
+ | `prices` | `{}` | 每模型 USD/百万 token 价格,合并覆盖内置价目表 |
75
+ | `defaultPrice` | `{input: 1.0, output: 3.0}` | 两表均无该模型时的回退价格 |
76
+ | `budgets.session` / `daily` / `monthly` | `10` / `50` / `500` | 各作用域 USD 预算上限;缺省表示不限 |
77
+ | `warnRatio` | `0.8` | 用量达到上限该比例时告警(0..1) |
78
+ | `overLimit` | `alert` | 超限后策略:`alert` / `block` / `degrade` |
79
+ | `degradation` | `{}` | 模型 id → 同厂商更便宜模型 id 的映射 |
80
+ | `webhookUrl` | *(无)* | 可选阈值告警 webhook URL(POST JSON) |
81
+ | `webhookTimeoutMs` | `5000` | webhook 请求超时 |
82
+ | `alertsEnabled` | `true` | 阈值告警总开关 |
83
+ | `alertCooldownMs` | `3600000` | 同一作用域两次告警的最小间隔(ms) |
84
+ | `desktopNotifications` | `false` | 页签打开时的浏览器桌面通知 |
85
+ | `refreshIntervalMs` | `5000` | 设置页签轮询间隔 |
86
+ | `carbon.enabled` / `region` / `pue` / `energyKwhPerToken` | `true` / `global` / `1.58` / `0.000007` | 碳桥接(区域:global, us, eu, china, india, uk, france, iceland) |
87
+ | `latency.enabled` / `windowSize` | `true` / `200` | 按模型延迟百分位与其窗口 |
88
+ | `currency` | `{code: USD, rate: 1.0, decimals: 2}` | 展示货币(成本以 USD 计算,仅展示换算) |
89
+ | `outputLanguage` | `en` | `/budget` 输出语言:`en` / `zh` |
90
+ | `historyDays` | `30` | 面板快照保留的按天用量历史天数 |
91
+ | `persistence.enabled` / `intervalMs` | `true` / `10000` | 日/月用量跨重启持久化(storage 域);域缺失时降级为进程内聚合 |
92
+
93
+ ## 工具与界面
94
+
95
+ | 界面 | 类型 | 说明 |
96
+ |---|---|---|
97
+ | `/budget` | 命令 | 各作用域概览(用量、比例、碳足迹、阻断状态) |
98
+ | `/budget models` | 命令 | 按模型明细 + 延迟百分位 |
99
+ | `/budget unblock <scope>` | 命令 | 解除某作用域阻断(`session` / `daily` / `monthly`) |
100
+ | 设置 → 插件 → 预算 | 设置页签 | 用量条、按天用量曲线、模型明细、告警、上限编辑、解除阻断按钮 |
101
+ | `budget/status`、`budget/setSettings`、`budget/unblock` | Typert Remote | 客户端通道(页签消费这些方法) |
102
+
103
+ ## 权限与数据
104
+
105
+ - **权限**:`network:outbound`(仅可选告警 webhook)、`session:append`(审计事件)、`native-code:none`。
106
+ - **数据**:展示内容全部来自会话事件流;主机侧唯一网络调用是配置的 webhook,URL 在加载时校验、入日志前剥离凭据。任何 prompt/载荷都不会离开主机。
107
+ - **会话日志**:`budget/alert` 与 `budget/block` 是仅日志审计事件,只携带作用域名与 USD 金额(微任务延后以绕过会话 append 重入保护)。在 `0.1.2-alpha.1` 及以后的宿主上不再写入——fail-closed 事件词表会拒绝含未注册事件类型的日志,且没有外部注册面——审计轨迹因此仅降级到预算日志与 webhook。
108
+
109
+ ## 安全边界
110
+
111
+ - **不伪造数据**:预算阻断在 `llm/stream` 瀑布上产出修正性错误 finish —— 插件绝不编造模型输出。
112
+ - **不改写请求**:loop 构建的请求被冻结;`degrade` 因此在修正消息中点名目标模型,而非替换请求。
113
+ - **失败大声**:非法价格、URL、比例、区域与边界在挂载时即失败。
114
+ - **如实作用域**:面板的运行时编辑仅会话级生效;重载后恢复 cordis.yml 配置。
115
+
116
+ ## 已知限制
117
+
118
+ - 聚合为进程本地:harness 重启后用量清零(日/月桶从当前会话日志视图重建)。
119
+ - `block`/`degrade` 依赖 `llm/stream` 瀑布;无此 seam 的构建无法阻断请求(告警仍有效)。
120
+ - 内置价目会漂移;用 `config.prices` 覆盖条目。
121
+
122
+ ## 开发
123
+
124
+ ```sh
125
+ pnpm install # node ^22.19 || >=24
126
+ pnpm run typecheck # tsc:src + tests,对照本地 harness checkout
127
+ pnpm run typecheck:ci # tsc:对照已发布的 0.1.1-rc.2 类型(无 paths)
128
+ pnpm test # vitest
129
+ pnpm run build # tsc 声明 + tsdown bundles(lib/)
130
+ pnpm run verify:self-contained # 依赖声明全部来自 registry
131
+ pnpm run verify:artifacts # 构建产物 ESM 面 + typert manifest + 客户端 bundle
132
+ pnpm pack # 发布用 tarball
133
+ ```
134
+
135
+ ## Topics
136
+
137
+ `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `budget`, `cost-tracking`, `carbon-footprint`, `latency-benchmark`, `token-usage`
138
+
139
+ ## Contributors
140
+
141
+ - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:聚合、预算治理、碳足迹与延迟移植、设置页签与五语文档。
142
+
139
143
  ## PerryLink DSH Plugin Family
140
144
 
141
- 本项目是由 [PerryLink](https://github.com/PerryLink) 维护的 [29 个 DeepSeek Harness 插件](https://github.com/PerryLink)之一。如果这个对你有用,其他插件很可能也会:
145
+ 这是 [PerryLink](https://github.com/PerryLink) 维护的 [33 个 DeepSeek Harness 插件](https://github.com/PerryLink) 之一。如果它能帮到你,其他的也会:
142
146
 
143
147
  | Plugin | One-liner |
144
148
  |---|---|
145
- | [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | 审批链上的第二模型自动审查,默认失败关闭 |
146
- | [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | 持久化后台子代理,带 Web UI 侧边栏、消息与打断 |
147
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | DeepSeek Harness 的成本治理:预算、碳排与延迟一屏呈现。 |
148
- | [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind 等价物:快照、会话分叉、一次性恢复 |
149
- | [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | 将 Claude Code 会话、记忆、技能与 CLAUDE.md 迁入 DSH |
150
- | [dsh-click](https://github.com/PerryLink/dsh-click) | 跨平台原生桌面控制(DeepSeek Harness),Windows 优先。 |
151
- | [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web 输入框的终端式输入历史:方向键、Ctrl+R 搜索 |
152
- | [dsh-defend](https://github.com/PerryLink/dsh-defend) | DeepSeek Harness 的提示注入、越狱与密钥泄露防护。 |
153
- | [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | 工程纪律门禁:需求质询、测试门禁、对抗式审查 |
154
- | [dsh-draw](https://github.com/PerryLink/dsh-draw) | DeepSeek Harness 的统一静态图像生成路由。 |
155
- | [dsh-fast](https://github.com/PerryLink/dsh-fast) | DeepSeek Harness 的只读性能诊断。 |
156
- | [dsh-github](https://github.com/PerryLink/dsh-github) | DSH 的 GitHub PR/issue 集成,每次写入都经审批门 |
157
- | [dsh-library](https://github.com/PerryLink/dsh-library) | DeepSeek Harness 的本地文档知识库。 |
158
- | [dsh-local-ai](https://github.com/PerryLink/dsh-local-ai) | DeepSeek Harness 的本地模型(Ollama)接入。 |
159
- | [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | 经语言服务器的 LSP 诊断、格式化、补全、代码操作与重命名 |
160
- | [dsh-mask](https://github.com/PerryLink/dsh-mask) | DeepSeek Harness 的 PII 脱敏中间件——数据到模型前匿名化,展示层还原。 |
161
- | [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | 只读 MCP 运行时面板:/mcp 命令 + 带状态、工具与错误的设置页 |
162
- | [dsh-memento](https://github.com/PerryLink/dsh-memento) | 带审批门的跨会话记忆:ctx.memory 接缝 + SQLite + memory 工具 |
163
- | [dsh-observe](https://github.com/PerryLink/dsh-observe) | DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测导出器。 |
164
- | [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles 等价的运行时样式切换 |
165
- | [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code 风格声明式 allow/deny/ask 权限规则,带审计 |
166
- | [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | 按需 agent 技能形式的插件开发知识库 |
167
- | [dsh-score](https://github.com/PerryLink/dsh-score) | DeepSeek Harness 插件的多指标质量评分。 |
168
- | [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | 在 Web 侧边栏置顶会话,顺序持久化 |
169
- | [dsh-session-sync](https://github.com/PerryLink/dsh-session-sync) | DeepSeek Harness 的跨设备会话同步——会话存储的专用 git 镜像。 |
170
- | [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | 安全审计技能包:密钥扫描、依赖与供应链审查 |
171
- | [dsh-talk](https://github.com/PerryLink/dsh-talk) | DeepSeek Harness 的语音优先会话闭环:对它说,听它答。 |
172
- | [dsh-test-drive](https://github.com/PerryLink/dsh-test-drive) | DeepSeek Harness 插件的隔离式安装冒烟实测。 |
173
- | [dsh-translate](https://github.com/PerryLink/dsh-translate) | DeepSeek Harness 的厂商参数翻译与确定性 JSON 修复。 |
174
-
175
- ## License
176
-
177
- [Apache License 2.0](LICENSE) © 2026 dsh-budget contributors
149
+ | **[dsh-dsh-auto-review](https://github.com/PerryLink/dsh-dsh-auto-review)** | 审批链上的第二模型自动审查,默认失败关闭 | |
150
+ | **[dsh-dsh-background-agents](https://github.com/PerryLink/dsh-dsh-background-agents)** | 带 Web UI 侧栏、消息与中断的持久后台子代理 | |
151
+ | **[dsh-dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-dsh-checkpoint-rewind)** | Claude Code /rewind 等价:快照、会话 fork、一次性恢复 | |
152
+ | **[dsh-dsh-claude-move](https://github.com/PerryLink/dsh-dsh-claude-move)** | 把 Claude Code 会话、记忆、技能与 CLAUDE.md 迁入 DSH | |
153
+ | **[dsh-dsh-click](https://github.com/PerryLink/dsh-dsh-click)** | 跨平台原生桌面控制(DeepSeek Harness),Windows 优先。 | |
154
+ | **[dsh-dsh-composer-history](https://github.com/PerryLink/dsh-dsh-composer-history)** | Web 输入框的终端式历史:方向键、Ctrl+R 搜索 | |
155
+ | **[dsh-dsh-data-quality](https://github.com/PerryLink/dsh-dsh-data-quality)** | 数据集质量检查与引文核查(本插件可选消费的数字核查桥) | |
156
+ | **[dsh-dsh-defend](https://github.com/PerryLink/dsh-dsh-defend)** | DeepSeek Harness 的提示注入、越狱与密钥泄露防护。 | |
157
+ | **[dsh-dsh-doublecheck](https://github.com/PerryLink/dsh-dsh-doublecheck)** | 工程纪律守卫:需求质询、测试门禁、对手评审 | |
158
+ | **[dsh-dsh-draw](https://github.com/PerryLink/dsh-dsh-draw)** | DeepSeek Harness 的统一静态图像生成路由。 | |
159
+ | **[dsh-dsh-fast](https://github.com/PerryLink/dsh-dsh-fast)** | DeepSeek Harness 只读性能诊断。 | |
160
+ | **[dsh-dsh-fund-research](https://github.com/PerryLink/dsh-dsh-fund-research)** | 面向中国公募基金的确定性研究报告 | |
161
+ | **[dsh-dsh-github](https://github.com/PerryLink/dsh-dsh-github)** | 面向 DSH 的 GitHub PR/issues 集成,每次写入经审批门控 | |
162
+ | **[dsh-dsh-industry-research](https://github.com/PerryLink/dsh-dsh-industry-research)** | 行业研究编排,经本插件的 `ctx.researchReport.assemble` 封存交付物 | |
163
+ | **[dsh-dsh-library](https://github.com/PerryLink/dsh-dsh-library)** | DeepSeek Harness 的本地文档知识库。 | |
164
+ | **[dsh-dsh-local-ai](https://github.com/PerryLink/dsh-dsh-local-ai)** | DeepSeek Harness 的本地模型(Ollama)接入。 | |
165
+ | **[dsh-dsh-lsp-actions](https://github.com/PerryLink/dsh-dsh-lsp-actions)** | 通过语言服务器的 LSP 诊断、格式化、补全、代码操作与重命名 | |
166
+ | **[dsh-dsh-mask](https://github.com/PerryLink/dsh-dsh-mask)** | PII 脱敏中间件:模型边界匿名化、展示层还原 | |
167
+ | **[dsh-dsh-mcp-panel](https://github.com/PerryLink/dsh-dsh-mcp-panel)** | 只读 MCP 运行时面板:/mcp 命令 + 带状态、工具与错误的 Settings 标签页 | |
168
+ | **[dsh-dsh-memento](https://github.com/PerryLink/dsh-dsh-memento)** | 审批门控的跨会话记忆:ctx.memory 接缝 + SQLite + 记忆工具 | |
169
+ | **[dsh-dsh-observe](https://github.com/PerryLink/dsh-dsh-observe)** | DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测导出器。 | |
170
+ | **[dsh-dsh-output-styles](https://github.com/PerryLink/dsh-dsh-output-styles)** | Claude Code outputStyles 等价的运行时风格切换 | |
171
+ | **[dsh-dsh-permission-rules](https://github.com/PerryLink/dsh-dsh-permission-rules)** | Claude Code 风格声明式 allow/deny/ask 权限规则,带审计 | |
172
+ | **[dsh-dsh-plugin-guide](https://github.com/PerryLink/dsh-dsh-plugin-guide)** | 作为按需代理技能的插件开发知识库 | |
173
+ | **[dsh-dsh-research-report](https://github.com/PerryLink/dsh-dsh-research-report)** | 可验证研究报告引擎:内容寻址证据账本与封存版本 | |
174
+ | **[dsh-dsh-score](https://github.com/PerryLink/dsh-dsh-score)** | DeepSeek Harness 插件的多维质量评分。 | |
175
+ | **[dsh-dsh-session-pin](https://github.com/PerryLink/dsh-dsh-session-pin)** | 在 Web 侧栏置顶会话,带持久排序 | |
176
+ | **[dsh-dsh-session-sync](https://github.com/PerryLink/dsh-dsh-session-sync)** | DeepSeek Harness 的跨设备会话同步——会话存储的专用 git 镜像。 | |
177
+ | **[dsh-dsh-skill-pack-security](https://github.com/PerryLink/dsh-dsh-skill-pack-security)** | 安全审计技能包:密钥扫描、依赖与供应链审查 | |
178
+ | **[dsh-dsh-talk](https://github.com/PerryLink/dsh-dsh-talk)** | DeepSeek Harness 的语音优先会话闭环:对它说,听它答。 | |
179
+ | **[dsh-dsh-test-drive](https://github.com/PerryLink/dsh-dsh-test-drive)** | DeepSeek Harness 插件的隔离试装冒烟。 | |
180
+ | **[dsh-dsh-translate](https://github.com/PerryLink/dsh-dsh-translate)** | DeepSeek Harness 的厂商参数翻译与确定性 JSON 修复。 | |
181
+
182
+ ## License
183
+
184
+ [Apache License 2.0](LICENSE) © 2026 dsh-budget contributors
package/lib/client.js CHANGED
@@ -4547,11 +4547,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
4547
4547
  warnRatio: number().min(0).max(1),
4548
4548
  refreshIntervalMs: number().int().min(1e3)
4549
4549
  });
4550
+ /** Strict wire schema for the optional status session id. */
4551
+ const BUDGET_SESSION_ID_SCHEMA = string().optional();
4550
4552
  /**
4551
4553
  * The `budget/status` invocation descriptor, shared verbatim by the host
4552
4554
  * `TYPERT` manifest and the client `TypertRemoteContribution`. Hand-written
4553
4555
  * in the exact shape the Typert generator emits; validated by the typert
4554
- * loader and the client registry at mount time.
4556
+ * loader and the client registry at mount time. The optional `sessionId`
4557
+ * parameter matches `BudgetService.status(sessionId?)` and the client
4558
+ * `remote.budget.status(sessionId?)` — it attributes the snapshot to one
4559
+ * session and may be omitted (missing wire fields decode to `undefined`).
4555
4560
  */
4556
4561
  const BUDGET_STATUS_DESCRIPTOR = Object.freeze({
4557
4562
  id: "dsh-budget#budget/status",
@@ -4559,7 +4564,17 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
4559
4564
  namespace: "budget",
4560
4565
  method: "status",
4561
4566
  invocation: Object.freeze({ kind: "direct" }),
4562
- parameters: Object.freeze([]),
4567
+ parameters: Object.freeze([Object.freeze({
4568
+ name: "sessionId",
4569
+ wire: "sessionId",
4570
+ source: "json",
4571
+ codec: Object.freeze({
4572
+ mode: "strict",
4573
+ typeSymbol: "dsh-budget/types#SessionId",
4574
+ schema: BUDGET_SESSION_ID_SCHEMA
4575
+ }),
4576
+ acceptsUndefined: true
4577
+ })]),
4563
4578
  result: Object.freeze({
4564
4579
  mode: "strict",
4565
4580
  typeSymbol: "dsh-budget/types#BudgetStatus",
@@ -4926,7 +4941,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
4926
4941
  const status = async () => unwrap(await scope.remote.budget.status(currentSessionId(scope.get("sessions"))), "status");
4927
4942
  const setSettings = async (settingsJson) => unwrap(await scope.remote.budget.setSettings(settingsJson), "setSettings");
4928
4943
  const unblock = async (scopeName) => unwrap(await scope.remote.budget.unblock(scopeName), "unblock");
4929
- scope.slots.inject("settings.plugins.tab", () => scope.slots.register({
4944
+ const slots = scope.get("slots");
4945
+ slots.inject("settings.plugins.tab", () => slots.register({
4930
4946
  name: "settings.plugins.tab",
4931
4947
  id: "budget",
4932
4948
  order: 40,