前言¶

在 DeepSeek Harness（DSH）里跑智能体任务时，模型还在一轮对话里执行，你往往想再补一句：改优先级、纠正误解、追加约束。若只能等回合结束再用主输入框，方向调整会滞后；若临时占用主输入框，又容易和 token 统计、缓存展示挤在一起。社区插件 dsh-steer-note（维护者 hffek）在任务运行时提供独立的「插话栏」，文字、图片、文件走原生 steering 链路，并附带插话记录与草稿回收。下文按安装、用法和注意事项说明。

这是什么¶

dsh-steer-note 是面向 DSH 的紧凑型「回合内插话」插件：英文简介为 Seamless mid-turn steering for DeepSeek Harness: text, images, files, read receipts, and draft rescue. 在 SkillHub 目录 中归类为「模型推理」；源码与说明见 GitHub：hffek/dsh-steer-note。npm 包当前版本为 0.2.3（以仓库 package.json 为准），许可证 MIT。

消息仍以普通 user/steering 进入会话，历史、日志与附件行为与主输入框一致；Host 侧通过 STEER_NOTE 系统提示词告知模型：中途插入的内容是航向修正，不要当成全新任务。

核心功能¶

下面介绍 README 中列出的能力，均可在安装后对照界面验证。

运行中插话¶

任务执行期间，主输入框上方出现独立插话栏，不覆盖主输入框，也不遮挡 token/缓存显示。Enter 发送，Shift+Enter 换行。

文字、图片与文件¶

• 点回形针选择图片或任意文件，支持粘贴与拖入；图片会识别并预览。
• 图片格式：PNG、JPEG、WebP、GIF，受原生 imageLimits 限制；模型不支持视觉输入时会提示。
• 普通文件经 conversation.createDrafts 注册并后台上传，发送时使用 { type: 'file', receiptId }；上传过程有进度，失败会显示原因。

远程发送走 ctx.remote.session.prompt({ mode: 'steer' }) 等原生接口。

草稿不丢¶

回合结束时尚未发送的内容会自动搬进主输入框；也可手动点「放入输入框」。切换会话或刷新后，文字与图片草稿会尽量恢复（文字在 localStorage；图片受容量限制，过大时提示）。普通文件草稿仅在当前页面内存中保留，切换会话仍可用，刷新页面会丢失。

若任务结束时焦点仍在插话框内，草稿不会自动搬走，需点「放入输入框」，以避免两个输入框同时出现。

插话记录与已读状态¶

时钟按钮可查看插话记录，状态包括：已读取、待读取、已送达、未读取。未读取的插话可取消（调用原生 updateQueue({ action: { kind: 'remove' } })）；已读取或已失效的会提示无法取消。记录按会话保存在本机，只回填文字；图片与文件需重新添加。

插话栏出现条件：当前会话正在运行，或该会话仍有未发送草稿。one-shot 子代理会话不显示插话栏。

安装与启用¶

先做 profile 选择：Web 与 Desktop 命令相同，仅 --profile 不同。安装后重启 DSH，Host 侧 STEER_NOTE 才会生效。

从 npm 安装（Web）：

dsh plugin --profile web add dsh-steer-note

GitHub 备用：

dsh plugin --profile web add github:hffek/dsh-steer-note

Desktop 将 --profile web 换成 --profile desktop：

dsh plugin --profile desktop add dsh-steer-note

本地开发可链接目录（路径换成你的绝对路径）：

dsh plugin --profile web add link:/absolute/path/to/dsh-steer-note

插件在 DSH 进程权限下运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境策略。社区目录（如 SkillHub、dshbase）为独立站点，与 DeepSeek / 幻方无官方从属关系。

典型用法¶

1. 安装并重启 DSH，打开一个会长时间运行的会话。
2. 任务开始后，在插话栏输入修正说明，必要时附加截图或文件，按 Enter 发送。
3. 需要撤回尚未被模型读到的插话时，打开插话记录并取消对应项。
4. 若回合在发送前结束，检查主输入框是否已自动收到草稿；若焦点仍在插话框，点「放入输入框」。

兼容性与降级¶

README 记载的测试环境：DSH Desktop 2.0.18、DSH 0.2.1-rc.2（Web profile）。DSH 大版本升级后，建议回归文本/图片/文件发送、历史与取消能力。

部分能力不可用时的行为（摘要）：

• updateQueue 不可用：不显示取消按钮。
• 附件相关接口不可用：文字仍可搬进主输入框，图片/文件留在插话栏并提示手动添加。
• fileUploads 不可用：普通文件不能发送或显示进度，图片与文字不受影响。
• useChat 为空或 inbox 不可用：历史状态可能停留在「已送达」。

文件附件与图片「搬家」使用了客户端内部服务，非公开文档 API；文本/图片/文件发送、历史与取消主要走原生公开接口。

结尾¶

dsh-steer-note 把「回合内改方向」从主输入框旁路出来：独立插话栏、多模态 steering、本机草稿与读信状态，适合需要在长任务中频繁微调的智能体使用场景。

• 目录页：https://www.skillhub.cn/plugins/hffek/dsh-steer-note
• GitHub：https://github.com/hffek/dsh-steer-note
• npm：https://www.npmjs.com/package/dsh-steer-note