前言¶
DeepSeek Harness (DSH) 是一个以插件为核心的模型推理平台。开发者在使用大模型进行长篇写作时,常遇到风格切换生硬、上下文记忆丢失以及输出文本“AI 味”过重的问题。该插件通过档位系统、项目记忆管理和去 AI 味后处理,提供了一套从输入到输出的全链路写作增强方案。插件由 Azonda 维护,基于 MIT 协议开源。
功能概览¶
该插件主要包含以下三个核心模块:
写作档位¶
支持风格与严谨度的双重自动切换。
* 风格档位:覆盖 T1 至 T4(如鲸定谔、海明鲸、奥格鲸、鲸尔德),通过 Host 侧的 systemPrompt.section 在生成步骤中注入提示词。
* 严谨度档位:覆盖 L1 至 L5(如史官、辩护律师、科普作家、说书人、小说家)。
* 叠加逻辑:严谨度在前、风格在后,两者正交叠加,按 (档位, 输出语言) 解析单一键,一次只注入一份提示词。
项目记忆¶
在会话目录下管理上下文,包含 .mem/config.md 文件。
* 三区结构:包含人工锁定区(只读)、术语表和上下文资产。
* 硬守卫:在 tools/pre-execute 阶段运行,保护人工区与 frontmatter 不被覆盖。
* 预算化注入:自动追加内容,但受限于 800 token 估算封顶;超过 30 条术语会自动拆分至 glossary.md。
去 AI 味后处理¶
提供动态工具 whale_polish,用于成稿后的微调。
* 改动清单:工具调用卡展示具体的修改规则与证据(与档位联动 12 条规则,包含 P0 语言守恒与 P1 单位数守恒)。
* 触发阈值:仅当文本长度达到 ≥50 单位(汉字+英文词)时执行。
安装与启用¶
使用官方提供的 GitHub 源码安装命令:
dsh plugin --profile web add github:Azonda/dsh-whale-writing
安装完成后需重启 DSH(执行 dsh web)。
使用方法¶
重启后,插件通过以下方式提供交互入口:
- 快捷条:会话输入框上方会出现快捷条,包含风格、严谨、记忆、后处理及收起功能,所有配置入口集中于此。
- 模型工具:模型工具列表中会出现
whale_set_profile和whale_polish。 - 后处理展示:
whale_polish的调用卡以改动清单视图展示。
插件没有独立的设置页面,所有开关与配置均通过上述快捷条或 Harness 自身的插件管理功能进行。
技术说明与注意事项¶
- 依赖声明:插件不声明任何
@deepseek-ai/*运行期依赖(如@deepseek-ai/cordis、@deepseek-ai/dsh-tools),以避免核心包分叉。核心包由 DSH 安装闭包提供,插件运行时通过 parent-walk 解析。 - 安装方式:请仅使用
dsh plugin add命令安装。不要在 profile 中手动pnpm add核心包,这可能导致TOOL_RUNTIME_SCHEDULER符号分叉,引发Cannot read properties of undefined错误。 - 环境要求:Node.js 版本需满足
^22.19.0 || >=24.0.0,DSH 版本需兼容0.1.1-rc.2。 - 故障恢复:若发生核心包分叉导致的报错,需从 profile 的
package.json移除核心包,删除node_modules下的对应实体,并执行pnpm dedupe。若会话已毒化,需导出后重建。 - 兼容性:项目结构中包含 Host 半侧 TS 代码与 Client 半侧 lazy-CJS 代码,源码提交包含构建产物,安装时无需额外构建。
结语¶
dsh-whale-writing 插件聚焦于 DSH 生态下的写作场景,通过 Host 注入、浏览器快捷条和模型工具调用三种方式提供控制。用户可参考 GitHub 获取源码与维护文档。