dsh-whale-writing
老人与大肥鱼 · 超级写作增强
「老人与大肥鱼 · 超级写作增强」—— DeepSeek Harness (DSH) 插件：写作档位（T1–T4 风格 × L1–L5 严谨）、项目记忆（.mem 三区 + 硬守卫）、去 AI 味后处理（whale_polish）。双半体（Host 工具/提示词注入 + 浏览器快捷条/工具卡）。
功能
| 模块 | 说明 |
|---|
| 写作风格 | T1 鲸定谔 / T2 海明鲸 / T3 奥格鲸 / T4 鲸尔德 + 自动挡；Host systemPrompt.section 每步注入档位提示词 + 一份同源风格样例（隔离协议：按 (档位, 输出语言) 解析单一键，一次只注入一份） |
| 严谨性 | L1 史官 / L2 辩护律师 / L3 科普作家 / L4 说书人 / L5 小说家 + 自动挡；与风格正交叠加（严谨在前、风格在后） |
| 项目记忆 | 会话 cwd 下 .mem/config.md（人工锁定区只读 + 术语表/上下文资产自动追加）；tools/pre-execute 硬守卫保护人工区与 frontmatter；>30 条自动拆 glossary.md；预算化注入（≤800 token 估算封顶） |
| 后处理 | 动态工具 whale_polish：成稿去 AI 味微调（与档位联动 12 条证据版规则 + P0 语言守恒 / P1 单位数守恒）；快捷条开关；工具调用卡展示改动清单；≥50 单位（汉字+英文词）才执行 |
| 总开关 | 快捷条最左侧的 🐳 图标即开关：关闭后整条快捷条只剩这个按钮（风格/严谨/记忆/后处理全隐藏），档位与记忆注入、后处理流程指令、记忆守卫、两个工具一并停用；状态存在 .mem/config.md 的 plugin_enabled（缺省开，旧文件自动视为开） |
快捷条（输入框上方）：🐳 总开关 / 风格 / 严谨 / 记忆 / 后处理 / 收起；中英双语跟随 Harness 语言。
点 🐳 关闭插件后只剩鲸鱼按钮（灰色虚线态），再点一次恢复整条快捷条。
（无 ✍ 润色徽标——全自动后处理不打扰，改动清单自查见 whale_polish 工具卡。）
无设置页：插件开关用 Harness 自身的插件管理（Plugins）或快捷条的 🐳 总开关；快捷条即全部设置入口。
安装
收录标签：本仓库已打 GitHub Topics dsh-plugin / deepseek-harness（+ writing / creative-writing / ai / deepseek），
被 DSH 插件目录自动收录；上方的 awsome·DSH plugin 徽章由 awesome-dsh-plugin.com 服务自动生成。
# 方式一（推荐）：GitHub 源码安装。无需构建——dist/ 与 lib/ 已提交，
# 且无 prepare 脚本，安装时不会触发 pnpm 的构建脚本拦截。
dsh plugin --profile web add github:Azonda/dsh-whale-writing
# 方式二：npm（发布后）
dsh plugin --profile web add dsh-whale-writing
# 方式三：本地源码（开发调试）
dsh plugin --profile web add file:/绝对/路径/dsh-whale-writing
安装后重启 DSH（dsh web）。启动后：
- 会话输入框上方出现 🐳 快捷条；
- 模型工具列表出现
whale_set_profile / whale_polish；
- 会话流中
whale_polish 的调用卡为改动清单视图。
维护者注意：本仓库的 content 是从「超级写作」主工作区同步生成的（node .dev/whale/sync-github-repo.mjs，脚本在工作区，不在本仓库）。改逻辑请改主工作区的 .dev/whale/host.js 后重跑生成链；详见 MAINTAIN.md。
依赖与安装安全
本插件没有任何 @deepseek-ai/* 运行期导入（dist/index.js 里一条 import 都没有）：
@deepseek-ai/cordis 只做类型导入（构建时擦除），工具定义用的 defineToolWw 是生成器自带的本地实现。
因此不存在「核心包第二份物理副本」导致的符号分叉（上游 #1337 / #1633）。
- 为什么不用
@deepseek-ai/dsh-tools 的 defineTool：DSH 0.2.x 改由运行时解析器把核心包供给
profile 插件，而机器上若同时留着旧版全局安装（$DSH_HOME/profiles/node_modules 里的 0.1.x 回退目录），
同一次加载里 dsh-tools 可能解析到旧副本、它的依赖又解析到新副本，ESM 链接期直接失败：
SyntaxError: The requested module '@deepseek-ai/dsh-llm' does not provide an export named 'CallId'
（0.1.x 的 dsh-tools 用 CallId，0.2.x 的 dsh-llm 已改名 ToolCallId——0.1.1-rc.2 ↔ 0.2.1-rc.2
实机复现）。本地实现按同一套 schema DSL 的插件子集产出同构定义，彻底绕开版本解析。
- 请只用
dsh plugin add 安装；不要在 profile 里手动 pnpm add @deepseek-ai/dsh-tools / @deepseek-ai/cordis。
pnpm（尤其 autoInstallPeers 为默认 true 的旧 profile）会在 profile 顶层平铺出第二份物理副本，
同样会分叉 TOOL_RUNTIME_SCHEDULER（dsh-tools 的 module 级唯一 Symbol），表现为任何会话任何工具调用报
Cannot read properties of undefined (reading 'prepare')，且残留孤儿 tool_calls 会把会话毒化成持续 400 INVALID_REQUEST。
- 已发生同款故障的恢复步骤：① 从 profile
package.json 的 dependencies 移除 @deepseek-ai/* 核心包；
② 删除 profiles/<name>/node_modules/@deepseek-ai 下对应实体（dsh-tools、cordis 等）；③ 重装插件；④ 已毒化会话导出后重建。
pnpm-workspace.yaml 保持 nodeLinker: hoisted + autoInstallPeers: false（initProfile 默认写入）。
- 上游防线：
npm pack / npm publish 前的 prepack 守卫（scripts/guard-publish.mjs）自动拦断——
运行期依赖（dependencies/peerDependencies/optional/bundled）出现任何 @deepseek-ai/*、
发布物里出现任何 @deepseek-ai/* 模块导入（裸说明符也不行）、或出现 dsh-tools 调度器字面量（捆绑副本），发布即失败。
结构
assets/banner.jpg 项目横幅（本 README 顶部引用）
src/index.ts host 半侧 TS（tsc → dist/index.js；由主工作区 .dev/whale/host.js 迁移生成，
scripts/generate-host.mjs 可重新生成——改逻辑请改源文件，勿在此手改）
lib/client.js browser 半侧（lazy-CJS：window.__ModuleLoader__.load({id, factory})）
dist/ tsc 构建产物（随仓库提交：GitHub/源码安装零构建）
cordis.patch.yml bundle patch：配置树插入插件行（id: whale-writing, name: dsh-whale-writing）
scripts/guard-publish.mjs 发布守卫（prepack）：防核心包重复副本（见上）
- Host↔Client 通信：
POST /whale-writing/<method>（profile/get、profile/set、mem/status、mem/toggleGuard），JSON 入出。
dsh.client.inject：@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-conversation（加载顺序；dsh-client-runtime 在 0.2.x 已不存在，勿再声明）。
兼容
- 实机验证：DSH
0.2.1-rc.2（Desktop） —— host 半体加载、两个工具注册、快捷条（conversation.input.dock，id whale）、whale_polish 工具卡、POST /whale-writing/profile/get 全部通过。
- 同时保持对 DSH
0.1.1-rc.2 可用：agent/session-start 与 agent/created 两个事件都挂；finish.reason.kind 的 done（0.1.x）与 stop（0.2.x）都按正常结束处理。
- 构建基线：
@deepseek-ai/cordis ^4.0.1（仅类型）、TypeScript ^5.6、React ^18.2.0（浏览器半体由宿主提供）。
- 最低要求：DSH
0.1.1-rc.2；Node ^22.19.0 || >=24.0.0（DSH 要求）。
- 0.2.x 的两处行为差异已在插件内对齐：
systemPrompt.section/context 默认做 {{变量}} 插值（本插件一律 interpolate: false，避免 .mem 内容里的花括号触发组装失败）；webServer 路由要求显式 kind（已是 exact）。
- 0.2.x 的
ctx.fs 是沙箱后端：writeText 必须带 per-call 沙箱策略，否则按部署默认（workspace-write + 进程 cwd）判越界。插件统一按调用会话解析策略（v0.1.2）——workspace-write 会话写自己的 .mem/** 正常，read-only 会话下切档位会被策略拒绝（与模型侧写盘同待遇）。
更新日志
v0.1.2 — 0.2.x 切档位修复 + 快捷条总开关
- 现象：DSH
0.2.x 上快捷条点档位只闪一下又弹回；whale_set_profile 报
cannot write "…/.mem/config.md": file access denied under workspace-write mode。
- 根因：
0.2.x 的 ctx.fs 是 SandboxedFileSystem，writeText(target, content, expected, signal, sandboxPolicy)
的第 5 参是 per-call 策略。插件不传时它回落 sandboxPolicy.resolve()（无会话）——用部署默认
workspace-write + 进程 cwd 当工作区根，会话工作区里的 .mem/** 因此被判越界而拒写
（0.1.x 的裸后端忽略该参数，所以旧版不受影响）。
- 修复：四处写盘（frontmatter 持久化、旧版记忆迁移、记忆回写、术语表拆分）统一走
writeTextFor()，
按调用会话 sandboxPolicy.resolve({ session }) 取策略——与 dsh-tool-fs 写盘同口径；
0.1.x 没有该服务时退回旧行为。
- 新增总开关：快捷条最左侧的 🐳 图标改成开关。关闭后整条快捷条只剩这只鲸鱼（灰色虚线态），
风格/严谨/记忆/后处理连同收起按钮全部不渲染；同时档位与记忆注入、后处理流程指令、记忆守卫一并停用，
whale_polish 回原稿、whale_set_profile 拒写档（返回 disabled: true）。再点一次恢复。
- 开关状态写进
.mem/config.md 的 plugin_enabled（缺省 true：旧文件没有这个键也算开），
重启/新会话仍保持；关闭态下快捷条仍能经 profile/set 重新打开（只读策略会话除外）。
- 回归：
host-integration-test 的 fs 后端改为按 0.2.x 沙箱语义把关（不带策略即拒写）；
新增 dist-sandbox-test.mjs 直接校验发布产物：POST /whale-writing/profile/set 与
whale_set_profile 都能写盘，缺策略时确实按沙箱拒写；host-test / m2-test / m4-test /
m6-client-test 补了总开关的解析、零注入与快捷条渲染回归（10 套测试全绿）。
v0.1.1 — 兼容 DSH 0.2.x
- 修复 0.2.x 上 host 半体导入失败：
SyntaxError: The requested module '@deepseek-ai/dsh-llm' does not provide an export named 'CallId'。
根因是运行期 import { defineTool } from '@deepseek-ai/dsh-tools' 在同机存在旧版全局安装时解析到旧副本；
现改为生成器自带的本地 defineToolWw（同一 schema DSL 子集、同构产物），dist/index.js 运行期零核心包导入。
agent/session-start → 同时监听 0.2.x 的 agent/created（0.2.x 已移除前者），会话预热不再失效。finish.reason.kind 兼容 stop（0.2.x）/done（0.1.x）；tool-calls 按 fail-closed 处理。- 四个提示词 section/context 显式
interpolate: false，防止 .mem 用户内容里的 {{…}} 触发组装期报错。
dsh.client.inject 去掉已不存在的 @deepseek-ai/dsh-client-runtime。- 发布守卫升级：发布物里出现任何
@deepseek-ai/* 模块导入即拦断（不再只拦非裸说明符）。
- 补充
repository / homepage / bugs 元数据。
LICENSE
MIT
