返回目录

dsh-composer-prediction

维护状态: 活跃

jhckevin/dsh-composer-prediction

DeepSeek Harness 下一条消息预测插件。Cache-aware composer predictions for DSH: Tab completion, provider profiles and cost accounting.

前往 GitHub项目主页
$ dsh plugin add dsh-composer-prediction

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置,然后重启即可。

了解安装方式

0

星标

0

Fork

JavaScript

语言

MIT

许可证

2026-11-20

创建于

2026-11-20

最近推送

README

DSH Composer Prediction

npm CI MIT

当前版本: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 私有客户端代码或认证后才能取得的提示词。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。