Vai al contenuto principale
Y

dsh-composer-quill

yugyq/dsh-composer-quill

Suggests your next message after each turn and finishes the half-typed sentence inside the DSH composer, tidying typos and punctuation as it goes.

Installazione

dsh plugin --profile web add github:yugyq/dsh-composer-quill

README

续笔 · dsh-composer-quill

在 DSH 的输入框里,把接下来想说的话提前写出来。

一个回合刚结束,它已经猜到你下一句要问什么;你打字打到一半,它把后半句接上。想换个说法就换个候选,不想要就忽略。

它是 DeepSeek Harness(DSH)的插件,完全在本机运行:请求走你已经在 DSH 里配置好的模型路由,没有第三方服务器。

四种建议

下一句

回合刚结束时,它给几条「下一句」,左右键可以换。切回一个聊过的会话时也会给。

下一句:输入框为空时给出候选,提示条上标着第几条

补写

打字停一下就出补写。随着你继续打字,它会一点点收窄,最后只剩尾巴那几字。

补写:深色是已输入的内容,浅色是接上的后半句

改写

草稿里有错字、标点乱、或者一句话塞了好几件事,它会给一整段整理过的版本,采用就是整段替换。

改写:草稿里的错字和断句被整理成完整的一句,提示条上是改写后的版本

历史

以前说过类似的话时,它直接从你的历史输入里取,不花模型调用,反应是毫秒级的。

历史:打到一半时,后面接上你以前说过的原话

这几件事都不会打断你:Esc 关掉之后同一份草稿不会再弹回来;请求进行中不会清空重来,上一条建议留在屏幕上标一个「· 补写中…」;组字期间不打断输入,也不会把组字内容当成草稿。

按键

Tab 采用当前建议;左右方向键切换候选(只有「下一句」有多条时);Esc 关掉;Ctrl+Shift+Space 手动要一条,「仅手动」模式下这是唯一入口。

安装

需要 DSH >=0.2.1-rc.2 <0.3.0(不匹配的宿主会在安装阶段被拦下),并且已经在 DSH 里配好一个可用的模型。插件不改装模型,只借用你现有的路由;没配模型时不会有任何建议。

dsh plugin --profile desktop add dsh-composer-quill                # 从 npm 装
dsh plugin --profile desktop add github:yugyq/dsh-composer-quill   # 或从仓库装

界面里也可以:设置 → 插件 → 添加插件,输入框填 dsh-composer-quill。本地开发时填目录路径,dsh plugin --profile desktop add /path/to/dsh-composer-quill。

装完要重启 DSH,不是刷新页面:客户端代码在启动时按版本固定,刷新只会拿到旧的。想知道在跑哪一版,看日志里的 build 字段。

这是第三方插件,与 DeepSeek 官方没有隶属关系。遇到问题请开 issue,附上日志里相关的那几行。

设置

设置 → 通用 → 续笔。配置存在浏览器的 localStorage 里,不联网。

  • 启用(默认开):总开关
  • 模式(自动):「仅手动」时只在按快捷键时请求
  • 语言(跟随系统):跟随系统 / 中文 / English。指定后强制,草稿语言不同会整段翻译
  • 停顿(120 ms):打字后多久发请求,范围 80–2000
  • 超时(20000 ms):单次请求上限,范围 3000–60000
  • 采纳反馈(自动):Tab 采纳、Esc 忽略、没采纳就发送都计入,用来重排「下一句」候选

隐私

只在本机。补全请求走 DSH 已配置的模型路由,诊断日志写在 ~/.dsh/composer-quill.log。

上下文出机器前会遮蔽凭据,九类形状会被替换成 [redacted …]:私钥块、AWS AKIA…、GitHub ghp_ / github_pat_、OpenAI sk-…、Stripe、Slack xox…、JWT、Bearer …。正在编辑的草稿不遮蔽,这是刻意的——建议由「草稿 + 尾巴」拼成,遮蔽会把 [redacted] 写进你要发的消息。

接口有鉴权:宿主侧要求本启动周期的令牌或同源浏览器请求,会话历史接口只认令牌。

它怎么工作

补写走 SSE,模型边写建议边长,Tab 随时可采纳。模型的回答有两种形状:接在草稿后面的尾巴,或者 REWRITE: 加一条改写后的整句。

上下文只看最后两轮,更早的对话只作背景,且只保留一条与草稿相关的旧行。建议与「草稿 + 对话版本 + 设置」绑定成缓存键,键不变就回放,键一变就作废,所以同一份草稿不会重复花钱。

宿主侧三个路由:/composer-quill/predict 出建议,/composer-quill/history 取你自己的历史消息,/composer-quill/beacon 收诊断字段。建议层嵌在输入框内部,换行和裁切都交给宿主的排版。

细节见 架构设计 与 接口与流式协议。

测试

单测 67 项,浏览器场景 32 项,跑在 CI 里。场景覆盖快速连打、停顿出建议、取消、切会话、长文本排版这些真实节奏。

npm test                          # 67 项离线单测
npm run test:ui                   # 32 条浏览器场景(自带模拟器)
npm test -- --filter=transcript   # 只跑某个行为
npm test -- --list                # 列出全部用例名

真机脚本、审计探针和模拟器都在 dev/,用法见 开发与验证。

还没做好的地方

宿主还没加载会话时拿不到上下文,「下一句」和历史补全没有内容可依,补写还能用。

一两个字的草稿基本靠猜,给的多是完整短句。

建议最多换到三行,再长就省略了,因为输入框本身也只长到那里。

诊断

出问题先看 ~/.dsh/composer-quill.log,每行一条 JSONL。

request / cache-hit / cache-miss 表示有没有真的调用模型,miss 会记下键的各个成分。result 记录返回了几条候选,失败原因是 skipped / empty-thread / wrong-language。hydrated 表示复用了存储里的建议。next-ungrounded 和 next-empty 分别表示候选与会话无关、一条都没剩下。dock-state 是界面那一刻的完整状态:阶段、候选数、草稿是否为空。

许可证

MIT

Plugin correlati