dsh-composer-prediction
维护状态: 活跃jhckevin/dsh-composer-prediction
DeepSeek Harness 下一条消息预测插件。Cache-aware composer predictions for DSH: Tab completion, provider profiles and cost accounting.
$ dsh plugin add dsh-composer-prediction0
星标
0
Fork
JavaScript
语言
MIT
许可证
2026-11-20
创建于
2026-11-20
最近推送
README
DSH Composer Prediction
当前版本:0.8.0-beta.4(beta)。
English · 安装 · 功能介绍 · 架构 · 边界与费用
DeepSeek Harness 的非官方下一条消息预测插件。助手正常回复结束后,在空输入框里显示建议;按 Tab 填入可编辑草稿,发送仍由你决定。
优先复用上下文缓存,逐次记录预测费用。支持 DeepSeek、OpenAI Responses、Anthropic Messages 和 Chat Completions。

真实插件组件的测试截图,使用演示对话;不是用户聊天记录。
安装
需要已安装的 DeepSeek Harness。当前是 beta,支持的 DSH 范围见 package.json。
在 DSH 内安装: 插件 → 添加插件,输入:
@jhckevin/dsh-composer-prediction
从 npm 安装:
dsh plugin --profile desktop add @jhckevin/dsh-composer-prediction@latest --ignore-scripts --registry=https://registry.npmjs.org/
Windows 没有 dsh 命令时,使用 DSH 自带 CLI:
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add @jhckevin/dsh-composer-prediction@latest --ignore-scripts --registry=https://registry.npmjs.org/
也可从 Releases 下载 Windows 安装包 ZIP,解压后运行 install.cmd。它调用 DSH 自带 CLI,不安装全局 Node/npm。详细步骤、离线安装和校验见 Windows 安装。
从 npm 来源安装后,在插件详情页的“版本”中检查更新。是否下载安装由用户决定;本插件不另设后台更新器。离线文件来源不具备同样的 registry 更新入口。
功能与使用
- 助手正常完成后,每个有效来源生成一次。错误、中断、取消不触发预测。
- 建议只在适合输入时显示。切换线程、开始发送、来源变化时撤下旧建议;接受前再校验一次。
- 已有预测按线程保存。切换界面不重新请求;历史改变后不能继续接受旧建议。
- 新线程默认开启;工作区和特定线程可以加入黑名单。
- 旧线程补生成默认限最后用户发送在 24 小时内、最新最多 3 个。这不是已保存预测的过期时间。
设置位于 设置 → 下一条消息预测。思考默认是“关闭/最低”,可以主动改为“按后端配置”并保存。修复请求沿用同一策略,切换策略不会自动重做当前轮。
额外约束写入 instruction_prediction.md;本地安全与可靠性限制优先。
完整功能介绍 包含触发流程、线程资格、两层缓存、后端切换、默认限制与更新方式。
缓存和费用
保持稳定前缀,预测指令放在后部。沿用父线程已有的有效压缩上下文;可选完整上下文、前缀加近期窗口、冻结窗口等方案。恢复选择器按已知用量和价格估算修复成本,不保证全局最优。
思考档位、模型、工具、摘要或前部历史改变,都可能损失缓存。短输入也可能比长而高命中的输入更贵。以服务商返回的 usage 为准,不承诺固定命中率。

真实组件的响应式测试截图,费用为演示数据。
Prediction 占比 = Prediction /(主会话 + Prediction)
按线程、币种和统计覆盖范围计算,包含自动重试、手动重试和修复。每次请求保留开始时的价格快照;支持价表声明的峰谷时段。缺失价格或 usage 不记作零,缺少缓存明细也不伪造命中率。完整统计、历史缺口和估算范围分别展示。
异常处理
| 遇到的情况 | 处理与恢复 |
|---|---|
| 助手未正常完成,或输入框已有草稿 | 不覆盖输入;等待正常完成和可接受状态 |
| 依据不足 | 返回 suggestion:false,本次不显示 |
| 超长、语言或用户视角不合格 | 默认最多修复一次;可选截断,其他检查仍生效 |
| 临时网络错误 | 最多额外 3 次网络重试,与修复共用任务计数;可关闭 |
| 请求已发出但 usage 不全 | 停止自动消费,保留未结算记录;不当作免费失败 |
| 额度明确不足 | 暂停被动预测并启动恢复监测;额度层仍允许主动重试 |
| 第三方不支持余额/缓存细项 | 保持未知,不猜接口、不付费探测 |
| 历史被外部修改 | 撤下旧建议,重新映射;预计保留前缀低于 50% 时暂停 |
| 价格未知、历史统计不全 | 发送前拦截缺价的新预测;历史缺口不补零,完整占比可能不可用 |
事件按从早到晚排列,仅保留最近 32 条。上下文更新、快照校验和排队不等于又发起模型请求;核对重复消费要看账本中的物理尝试。
详见 异常、日志与恢复方法:包含重试边界、额度恢复、上下文超限、第三方兼容,以及“有金额但占比为 —”的原因。
设置

本版本组件实测,使用演示配置。默认关闭/最低思考,修改后需保存。
实现
flowchart LR
A[用户发送] --> B[助手正常完成]
B --> C[资格与来源校验]
C --> D{已有有效结果}
D -->|是| H[线程结果缓存]
D -->|否| E[上下文与修复成本选择]
E --> F[思考策略 / 价格 / 额度预检]
F --> G[后端请求与用量入账]
G --> I[长度 / 语言 / 用户视角校验]
I --> H
H --> J[空输入框显示]
J --> K[Tab 填入草稿]
- 生命周期: 用户发送和正常完成驱动,不按秒轮询对话。来源修订号、轮次和草稿状态共同保护显示与接受。
- 缓存: 本地结果缓存与服务端前缀缓存分开。命中旧结果不调用模型;服务端命中仍由 usage 确认。
- 上下文: 工具调用与结果完整配对;使用父线程有效快照。窗口选择是本地增强,不宣称复刻 Codex 私有服务端。
- 后端: 原生 DSH 适配器和便携协议分开。未知第三方能力要声明,不收费探测、不静默换协议。
- 计费: 每次物理请求独立入账,推理 token 不重复计费。请求用量未结算时阻止继续自动消费。
数据
配置、黑名单、结果和账本保存在 ~/.dsh/plugins-data/composer-prediction。预测会把选定上下文发送给你配置的模型服务商。该目录及其中的密钥引用、聊天快照和账本不属于开源仓库,也不应上传到 issue。
开发
Node.js 24.9+,以下命令在仓库根目录运行:
npm ci
npm run setup
npm run build
npm test
npm run verify
setup 下载固定 commit 的 DSH 公共源码,并校验 SHA-256。依赖和锁文件随仓库提供。测试使用模拟网络,不需要 API Key,不产生模型费用。CI 覆盖构建、回归和 Windows 安装脚本检查;开发流程见 CONTRIBUTING。
许可证
MIT。包含 DeepSeek Harness 的公共适配器、Schema 和 tokenizer 相关代码;上游版权与许可证见 第三方说明。不包含 Codex 私有客户端代码或认证后才能取得的提示词。
更多「桌面与应用」插件
ds-harness-remote
作者 liguobao
基于 DeepSeek Harness 插件机制构建的远程访问方案,通过低延迟、端到端加密的 P2P 网络,支持使用 PC、移动端 和 Web 随时访问本地设备上的DSH 、CodeX、Cursor、Claude Code等工作区。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自动化插件,将 CursorTouch/Windows-MCP 接入内置 MCP 客户端桥接。提供默认关闭的 Computer Use 开关和应用内依赖安装器。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
