
dsh-weekstrip
为 DSH Desktop / DSH NEXT / 官方 0.2.1-rc.5、0.2.2-rc.1 客户端(DeepSeek Harness)准备的社区补丁: 在 设置 → 账号与余额 下方增加一块本地用量面板,包含 Token 统计、近 7 天用量与活跃度。
简体中文 · English
[!NOTE] 这是社区补丁,不是 DeepSeek 官方功能。它只修改你自己机器上 DSH 安装目录里的那个账号设置 bundle:
loose 布局(旧版 DSH Desktop)直接改resources/app/...下的文件;asar 布局(DSH NEXT 与 0.2.1-rc.5 起的官方客户端,含 0.2.2-rc.1)把整个应用打进resources/app.asar,补丁会把改好的 bundle 放进resources/app.asar.unpacked/...,并且只在归档头里把该条目标记为 unpacked。
asar 内的实际路径随构建变化(node_modules/...或dsh/node_modules/...),补丁按路径后缀自动定位。
应用升级会替换安装文件,补丁随之失效,重跑一次即可;revert可以逐字节还原。
浅色 / 深色静态预览:docs/preview.html(下载后用浏览器打开)。
效果图

新增内容
| 卡片 | 内容 | 数据来源 |
|---|---|---|
| Token 统计 | 累计计费 tokens、四段构成条(输入 / 缓存命中 / 缓存写入 / 输出)及占比、模型请求数 | 官方 tokenUsage 会话投影;缺失时退回 contextActivity 按天账本 |
| 近 7 天用量 | 每个本地日历日一根柱、7 天合计与日均 | contextActivity.days(dsh-context 注册的按天账本) |
| 活跃度 | 近 7 天强度格、活跃天数 x/7、连续天数、回合数、工具调用数 | 同上(requests / turns / toolCalls) |
- 口径为全部会话(含子代理会话,且不重复计入父会话)。
- 按浏览器本地时区切日;跨零点自动重算,无需刷新。
- 只读本机会话数据,面板自身不发起网络请求;唯一的外部请求是可选的
POST api/dsh-context/backfill(同源、dsh-context 插件的回填路由)。
环境要求
| DSH Desktop / DSH NEXT / 官方客户端 | 已安装的桌面版;锚点针对 0.2.1-rc.2(loose 布局)、0.2.1-rc.4(DSH NEXT,asar 布局)、0.2.1-rc.5 与 0.2.2-rc.1(官方客户端,asar 内 dsh/ 前缀)验证 |
| Node.js | 18 或更高(仅补丁脚本需要) |
| dsh-context 插件 | 可选。未安装时:累计 Token 仍可用,按天窗口/活跃度可能为空 |
安装
补丁改的是安装目录里的账号设置 bundle,两种安装布局都支持:
| 布局 | 目标 | 写入方式 |
|---|---|---|
| loose(旧版 DSH Desktop) | <resources>/app/node_modules/@deepseek-ai/dsh-client-ui-settings-account/lib/client.js |
备份后原地替换该文件 |
| asar(DSH NEXT / 0.2.1-rc.5、0.2.2-rc.1 官方客户端) | <resources>/app.asar 内的同一条目(归档根下或 dsh/ 下,按后缀自动定位) |
补丁写进 <resources>/app.asar.unpacked/...,并只重写归档头把该条目标记为 unpacked(数据区不动) |
显式传 resources 目录、app.asar 路径,或用环境变量:
# Windows 默认在 %LOCALAPPDATA%\Programs\... 下;自定义目录(例如 E:\DSHDesktop)就传它下面的 resources
node src/patch.mjs status --resources "<install>/resources" # 自动识别两种布局
node src/patch.mjs verify --resources "<install>/resources" # 只校验锚点与语法,不写文件
node src/patch.mjs apply --resources "<install>/resources" # 备份后打补丁
# 也可以直接指定目标
node src/patch.mjs apply --asar "<install>/resources/app.asar" # asar 布局
node src/patch.mjs apply --bundle "<...>/lib/client.js" # loose 布局(或 asar 内路径)
# 或用环境变量
$env:DSH_RESOURCES_ROOT = "<install>/resources" # PowerShell
$env:DSH_ASAR = "<install>/resources/app.asar"
$env:DSH_ACCOUNT_BUNDLE = "<...>/lib/client.js"
apply 是幂等的:已打补丁会直接跳过。每次写入前都会备份到 backups/,并在替换前用
node --check 做语法门禁。asar 布局下如果归档头放不下新内容(例如归档没有 integrity 冗余),
会自动退化成「整份归档重写」,此时需要先完全退出 DSH。
然后完全退出并重新启动 DSH(Web 外壳在 host 启动时对插件 bundle 做快照,刷新页面不会重新读取), 打开 设置 → 账号与余额。
自定义安装位置
自动探测覆盖默认位置(Windows 的 %LOCALAPPDATA%\Programs\DSH Desktop、DSH NEXT 与 Program Files;
macOS 的 /Applications;Linux 的 /opt、/usr/lib、~/.local/share)。如果 status 提示找不到 bundle,
按上面的方式传 --resources / --asar / --bundle。
如果你用的是源码启动或全局 npm 安装的 DSH,把 --bundle 指向那份安装里的
node_modules/@deepseek-ai/dsh-client-ui-settings-account/lib/client.js。
回滚与升级
node src/patch.mjs revert --resources "<install>/resources" # 还原最近一次备份
- 备份在
backups/(已被 .gitignore 忽略):- loose 布局:
client.js.<时间戳>.bak(整个 bundle 文件); - asar 布局:
app.asar.<时间戳>.hdr+.json(原始归档头,写入时数据区未改动,所以回滚能把归档 恢复成逐字节一致的原样);若走了整份重写,则保存app.asar.<时间戳>.bak。
- loose 布局:
- 回滚会同时删掉
app.asar.unpacked里由补丁创建的覆盖文件。 - 如果安装文件在打补丁后被更新/替换(
revert会比对归档大小),回滚会拒绝执行,避免把旧归档头写进新归档—— 此时重装或更新后重新apply即可。 - 应用升级会替换安装文件(asar 布局会整份换掉
app.asar),补丁随之消失——重跑一次apply即可。 - 若新版本的 bundle 结构变了,锚点将无法匹配:
apply会以anchor "<name>" matched 0 time(s)中止,且不修改文件。此时应补充锚点表(或提 PR),不要强行套用。
实现方式
账号设置页是一个 settings.section slot 条目,自身没有子 slot,所以面板通过五处锚点修改已编译的
client bundle 插入:
en/zh账号字典追加面板文案;- 在
AccountSection区域前插入自包含模块(src/snippet.js); - 原组件更名为
AccountSectionMain; - 新增
AccountSection,用Fragment同时渲染原组件与用量面板; settings.section注册项的注入里追加refreshSessions(回填后重新读取会话列表)。
面板读取框架的 useSessions 标准钩子(root scope 标准 kit),自带错误边界(面板出错不会连累账号与余额卡片),
钩子缺失时整块不渲染。
打包形态:loose 布局与 asar 布局
账号设置 bundle 在不同构建里的存放方式不同,apply 会按布局选择写入方式:
- loose(旧版 DSH Desktop):
resources/app/是解包目录,备份后原地改写lib/client.js。 - asar(DSH NEXT、0.2.1-rc.5 与 0.2.2-rc.1 起的官方客户端):整个应用打进
resources/app.asar。Electron 的 asar 读取器会把 header 中unpacked: true的条目改从resources/app.asar.unpacked/<path>读取(原生模块 就是这么发布的)。补丁因此只做两件事:把改好的 bundle 写到对应的.unpacked路径;重写归档头 (约 5 MB)把该条目标记为 unpacked、刷新size、去掉已失效的integrity。归档数据区完全不动, 回滚只需写回原始头部,恢复后与打补丁前逐字节一致。 - asar 内的目录前缀不固定:
0.2.1-rc.4(DSH NEXT)是归档根的node_modules/...,0.2.1-rc.5与0.2.2-rc.1(官方客户端)把运行时嵌在dsh/下面(dsh/node_modules/...)。补丁按node_modules/@deepseek-ai/dsh-client-ui-settings-account/lib/client.js后缀遍历归档头定位, 两种前缀都能命中。若归档里出现两份同名 bundle,补丁会中止并列出候选,要求用--bundle "<install>/resources/app.asar/<path>"指定,不会猜测。
这条路径依赖 Electron 自身的 asar 语义,并已实测:0.2.1-rc.5 与 0.2.2-rc.1 官方客户端的宿主进程由
DeepSeek Harness.exe 以 ELECTRON_RUN_AS_NODE=1 启动,读取客户端 bundle 时走 Electron 的 asar 垫片,
readFileSync / stat 都会命中 .unpacked 覆盖;该客户端启用了 asar 的 unpacked 机制,
但没有开启 EnableEmbeddedAsarIntegrityValidation,所以重写头部不会触发完整性校验。
开发与测试
npm run check # CI 门禁:语法 + 补丁引擎测试 + 聚合逻辑测试(无需安装)
npm run engine-test # 锚点处理、插入、幂等、拒绝路径、安装路径探测、asar 头往返/覆盖/回滚
npm run logic-test # 窗口 / 连续天数 / 四桶 / 敌意数据降级
npm run load-test # 按 __ModuleLoader__ 协议执行补丁后 bundle(需要安装)
npm run render-test # 用 React 垫片渲染面板并断言文案与数字
npm run preview # 重新生成 docs/preview.html(浅色 + 深色,中文);加 -- --locale en 生成英文版
需要真实安装的测试在找不到安装时会以退出码 0 跳过;对 asar 布局的安装跑加载/渲染测试时传
-- --resources "<install>/resources",它会从 app.asar(或已打的 .unpacked 覆盖)里读 bundle。
已验证版本登记在 src/anchors.mjs 的 VERIFIED_VERSIONS 中。
兼容性
| DSH 版本 | 状态 |
|---|---|
0.2.1-rc.2 |
已验证(loose 布局,锚点端到端测试) |
0.2.1-rc.4 |
已验证(DSH NEXT,asar 布局,含覆盖与回滚往返) |
0.2.1-rc.5 |
已验证(官方客户端,asar 内 dsh/ 前缀,含覆盖与回滚往返) |
0.2.2-rc.1 |
已验证(官方客户端,asar 内 dsh/ 前缀,头部原地重写,含覆盖与回滚往返) |
| 其它版本 | 会尝试套用;锚点移动则安全中止 |
许可与隐私
- 许可:MIT。与 DeepSeek 无关联;“DeepSeek Harness”“DSH”等标识归其所有者。
- 补丁只修改你本机的安装,不附带任何 DSH 代码、修改后的 bundle 或二进制。
- 无遥测、无远程存储:面板只读浏览器里已有的会话投影,另可选调用本地插件同源的回填路由。
- 第三方声明:THIRD_PARTY_NOTICES.md。
致谢
- dsh-context:提供了本面板使用的按天活动投影、回填路由与视觉语言。
- DSH 团队:公开了客户端包与源码布局(MIT)。
参与贡献:CONTRIBUTING.md
No comments yet. Be the first to write one.