前言¶
在 DeepSeek Harness 里做长对话时，常见摩擦点包括：粘贴一大段文字却不好当附件管理、主窗口里多开会话互相抢注意力、批量整理历史会话只能一条条点、对 Agent 计划逐段写意见时容易冲掉输入框草稿。社区里也有通过改客户端或外挂脚本凑合的做法，维护和升级成本都偏高。
下面介绍维护者 z1223473749 发布的客户端插件 QiuYa 增强工具箱（npm 包名 dsh-qiuya-tools，仓库 dsh-QiuYaTools）。它在 Harness 客户端侧注入一批可单独开关的增强，覆盖长文本附件、会话独立窗口、批量归档、计划批注、会话菜单、提示词建议，以及可选的 Q 主题「鲸与海」。
这是什么¶
QiuYa 增强工具箱是面向 DeepSeek Harness 客户端 的插件（分类：客户端）。当前 npm 版本为 0.5.2，许可证 MIT。插件通过 Cordis patch 与多个 @deepseek-ai/dsh-client-ui-* 注入点挂接会话、工作区、对话与设置界面，在不动核心安装包的前提下扩展日常操作。
目录页：SkillHub · dsh-QiuYaTools。
核心功能¶
README 将能力归纳为下表；六项增强默认开启，可在设置里单独关闭或一键全选。Q 主题默认关闭，独立配置。
| 功能 | 说明 |
|---|---|
| 长文本附件 | 粘贴长文本时自动转为 TXT 附件；默认阈值为 1000 个字符或 15 行，可在设置中调整。 |
| 会话独立窗口 | 右键打开，或将会话从列表拖出；再次打开同一会话会唤起已有窗口。 |
| 批量归档 | Shift 连选、⌘ / Ctrl 多选后右键归档；也可归档工作区全部会话。 |
| 计划批注 | 选中计划中的文字添加评论并提交修改建议，保留输入框原有草稿。 |
| 会话菜单 | 右键置顶、手动标记已读 / 未读、复制标题 / 会话 ID / 工作目录路径、打开目录；工作区也可移到顶部。 |
| 提示词建议 | 回复结束且输入框为空时，根据当前会话推荐下一句；失焦仍保留。聚焦后 Tab 填入、Esc 隐藏，可改后再发送。 |
| Q 主题「鲸与海」 | 手绘鲸鱼与白发少年背景，半透明界面，支持浅色、深色外观。 |
补充说明：
- 设置页功能入口分两排展示，无需横向滚动。
- 提示词建议使用当前会话所选模型，会产生少量额外模型用量。
- 官方 README 写明当前适配 macOS Harness 0.2.1-rc.2；独立窗口需要 macOS 13+，GitHub 发布包含 Apple Silicon 与 Intel 组件。
安装与启用¶
- 打开 Harness 的 插件 → 添加插件。
- 输入 npm 包名
dsh-qiuya-tools，点击安装。 - 点击 立即启用，进入 设置 → QiuYaTools。
左下角账号菜单也有 QiuYaTools 入口。npm 包：dsh-qiuya-tools。
若镜像源尚未同步新版本，可稍后重试、切换到 npm 官方源，或在「添加插件」中粘贴 GitHub 安装包链接：
https://github.com/z1223473749/dsh-QiuYaTools/releases/latest/download/dsh-qiuya-tools.tgz
典型用法¶
长文本附件：在输入区粘贴超过阈值的文本，插件按设定转为 TXT 附件，避免整段挤在一条消息里。
会话独立窗口：在会话列表右键选择打开独立窗口，或把会话拖出列表；需要对照代码或文档时，可与主窗口并排使用。
批量归档：用 Shift 连选或 ⌘ / Ctrl 多选会话后右键归档；工作区会话较多时，也可用「归档工作区全部会话」一次性清理。
计划批注：在 Agent 计划区域选中文字，添加评论并提交修改建议；输入框里未发送的草稿不会被清掉。
提示词建议：等模型回复结束且输入框为空时查看灰色建议文案；需要使用时聚焦输入框，按 Tab 填入，按 Esc 隐藏。
版本更新：在 QiuYaTools → 版本更新 → 检查更新 中升级；完成后完全退出并重新打开 Harness，原有设置会保留。
适用场景与注意¶
适合长期在 Harness 客户端里维护多会话、多工作区的开发者：需要把长日志/文档当附件发、需要分窗对照、需要批量归档历史会话，或需要在计划上逐段留修改意见的场景。
安装前请注意：
- 插件在 当前 DSH 进程权限 下运行，安装前应自行查看 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。
package.json中engines.node要求 ^22.19.0 || >=24.0.0（构建/打包环境相关；日常用户以 Harness 内安装流程为准）。- 独立窗口与 README 中的兼容说明以 macOS 为主；其他平台请以实际 Harness 版本与插件发布说明为准。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，属于「一切皆插件」生态下的第三方条目。
问题与开发文档：Issues、使用与开发、维护者站点 www.qiuya.cc。
结尾¶
QiuYa 增强工具箱把长文本附件、会话分窗、批量归档、计划批注、菜单增强和可选主题收进同一套客户端设置，适合想少写脚本、直接在 Harness 里完成上述操作的用户。安装包名 dsh-qiuya-tools，详情见 GitHub 仓库 与 SkillHub 目录页。
