plugin 使用指南
在用户自定义时间窗口内自动暂停长任务与模型请求,让 DeepSeek 等分时计价 API 高峰时段零扣费;支持余额显示与 10 分钟粒度消费柱状图。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-save-money
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add dsh-save-money
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 多组时间窗口:暂停 / 继续时间自由增删,支持跨午夜(23:00–08:00)、按星期过滤;
- 到点自动暂停:暂停时刻到达后,正在运行的任务会被安全地"冻住"(进度现场原样保留,不会中断或丢失),窗口结束自动恢复接着跑;没有任务在跑就不暂停;
- 暂停期间不发请求(省钱核心):暂停窗口内,AI 不会向模型服务发出任何新请求,不产生任何费用;窗口结束 / 停用 / 结束本次窗口后自动恢复继续,对话上下文和进行中的任务都不受影响。窗口内 AI 不回复(包括新对话)是预期行为,想立刻恢复就点「结束本次省钱模式」按钮(不经 AI,直接生效);
- 结束本次省钱模式(一次性,仅当前窗口):横幅与设置浮层上的按钮只结束当前触发的这一个暂停窗口——已暂停则立即恢复并放行闸门,即将暂停则取消本次暂停;本窗口一直跳过到其继续时间,随后状态自动清除。下一个窗口(今天或以后)照常生效,且不会改动持久化的「启用」开关——不用担心忘记重新启用导致以后不再省钱;
- 界面提醒:顶部浮动横幅(即将暂停浅黄 / 已暂停浅红,含【结束本次省钱模式】按钮)+ 会话头部唯一常驻入口(Session log 旁,"省钱 · 🟢 工作中"彩色状态文字,点击展开设置),颜色随状态实时变化;
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
这个插件和 DSH 自带的"预算 / 费用"功能有什么区别?
官方费用工具是被动记账、给"超支提醒";本插件是主动把闸门合上——到点不向模型发请求、不产生任何费用,并把正在运行的任务"冻住"等窗口结束再继续(src/host.ts:80 / src/gate.ts:81-88 / src/host-goals.ts:67-95)。
安装之后页面上看不到"省钱"状态文字怎么办?
必须完全重启 DSH(Ctrl+C 停掉再启动)并强制刷新浏览器(Ctrl+Shift+R)——界面在启动时挂载。v1.2.5 之前的构建存在"启用勾不上"问题,请升级到最新版本(README.zh.md:298-306)。
暂停期间 AI 不回复是 bug 吗?
不是 bug,是预期行为。暂停窗口内的设计就是"不发请求、不产生费用",运行中的任务被冻结、对话上下文保留;窗口结束自动全部恢复,或点「结束本次省钱模式」立即恢复(README.zh.md:27 / src/state.ts:50-79)。
配置文件存在哪里?卸载后会不会丢失?
配置自动落到工作区的 save-money.config.json(已 .gitignore)。位置按 6 级候选自动解析:指针文件 ~/.dsh/save-money-config-path.json > 当前会话工作区 > 名为 dsh-save-money 的会话工作区 > DSH 启动目录 > 启动目录的同级 dsh-save-money 目录 > sandboxPolicy.workspaceRoot。卸载 / 重装不会动它,删除该文件即恢复默认(README.zh.md:286-296 / src/config.ts:104-185)。
「结束本次省钱模式」会把总开关关掉吗?
不会。这个按钮是一次性的内存态操作,只结束当前触发的这一个暂停窗口;下一次窗口(今天或以后)照样生效,持久化的"启用"开关不会被改。想关掉所有窗口的省钱模式,手动取消勾选「启用」即可(README.zh.md:29 / src/host-tools.ts:69-73)。
余额显示只支持 DeepSeek 官方吗?
是的。余额与消费统计仅在最近一次模型请求跑在官方 DeepSeek 上时显示;其他厂商(硅基流动、中转等)的 Key 不会出现余额。余额历史按 API Key 指纹保存到 ~/.dsh/dsh-save-money-balance.json,换 Key 自动作废旧历史(README.zh.md:33-37 / src/balance-host.ts:88-130)。
「一键 DeepSeek 分时计价策略」会自动启用吗?
不会。一键策略只会把高峰窗口去重追加进配置(北京时 08:58–12:02、13:58–18:02,提前 2 分钟 / 延后 2 分钟留余量),「启用」开关需用户自己勾选——由你决定(README.zh.md:32 / README.zh.md:316)。
如何卸载?
dsh plugin --profile web remove dsh-save-money,然后重启 DSH。配置文件 save-money.config.json 与余额历史 ~/.dsh/dsh-save-money-balance.json 不会被删除,需要彻底清除可手动删除(README.zh.md:241-244)。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 未声明
- Node: 未声明
- Platforms: 跨平台
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则