前言¶
在 DSH 里写长提示词或对话草稿时,错别字往往在发送之后才被注意到。通用大模型对话可以顺带改稿,但往往会动语序、换同义词、改标点风格,和「只想找出错字别字」的需求不一致。下面介绍社区插件 dsh-plugin-typo-check(维护者 kviiinh,分类:模型推理):它在输入框工具栏增加「查错」按钮,把当前草稿交给你自配的 OpenAI 兼容接口,只找错别字(错字、别字、多字、漏字、同音/形近误用),在输入框里标黄,并在浮动卡片里逐条列出,支持一键替换;不做润色、不改文风、不动标点风格。
DSH 的生态思路是「一切皆插件」;插件目录在 SkillHub 等独立站点展示,与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证——插件在 DSH 宿主进程权限下运行,API 请求会发往你在配置里填写的服务商地址。
这是什么¶
dsh-plugin-typo-check 是给 DeepSeek Harness(DSH)输入框用的查错插件。点「查错」后,宿主端把草稿作为用户消息发给你配置的来源,模型按内置/自定义系统提示词返回结构化结果;前端用 CSS Custom Highlight API(::highlight())标黄,不往 Lexical 编辑器里塞节点,输入、撤销、引用 chip 不受影响。当前 package 版本为 0.2.0。
核心功能¶
只查错别字,不重写¶
提示词里明确列了「什么不算」:同义替换、语序、口头/书面、繁简、标点风格等都不改。模型第一次答「没有错别字」时,插件会自动换一种问法复查一次(空结果常是小模型扫漏,不是文本干净);复查也只接受「真查出东西」的答案。
单次检查:超过 6000 字只检查前 6000 字(卡片上会注明),一次最多返回 20 条。
任意 OpenAI 兼容来源与多行回退¶
支持 …/v1/chat/completions、…/v1/responses(例如 DeepSeek、OpenAI、OpenRouter、各类中转站)。URL 填到 /v1 会自动补 /chat/completions;填完整地址则原样使用。
配置表里可配多行来源,按顺序尝试,第一个成功的就用它;全失败时按钮左侧显示「api 无效」,每一行的失败原因都能看到。关掉的来源不会被尝试;拖动行首 ⠿ 可调整优先级。
每行可单独配置¶
| 列 | 说明 |
|---|---|
| 名称 | 自己认得出的名字;留空时用 URL 的域名 |
| URL | 服务商地址 |
| Key | API Key,页面只显示掩码;编辑时留空 = 不修改 |
| 模型 | 例如 deepseek-chat、gpt-4o-mini |
| 系统提示词 | 默认跟随内置版本;改过则存成你自己的版本 |
| max_tokens | 64~32000,留空用 2000;太小会把 JSON 截断 |
| 思考模式 | 先想再答;来源不认该参数(400/422)时会自动退回普通请求 |
弹窗里还有 测试连接:用内置示例句(带典型同音错别字)当场跑一次,能连上会显示耗时和查到的词。
界面与交互¶
- 浮动结果卡片:悬浮在输入框上方;
原文 → 建议+ 简短原因;「替换」「忽略」「重新检查」「收起」。 - 耗时可见:点「查错」后按钮左边实时计时,出结果后停在最终耗时;发送或清空输入框时卡片和标黄一起清掉。
- 密钥不出后端:API Key 只存在本机
$DSH_HOME/plugin-data/dsh-typo-check/settings.json(默认~/.dsh/...),页面只看得到前后 4 位的掩码;三个本地路由会校验Sec-Fetch-Site/Origin,无遥测、无外部上报。
安装与启用¶
- 打开 DSH 桌面端 → 侧边栏 「插件」 → 安装。
- 填入本仓库地址,格式为:
github:kviiinh/dsh-plugin-typo-check
本地开发时也可使用 link: 路径,或把仓库目录链接进 profile 的 node_modules,让 DSH 以 link: 依赖加载。
- 安装或更新后 重启 DSH:宿主端(
index.js)的改动只有重启才生效;纯前端改动重载页面即可。
典型用法¶
- 在插件页找到「输入框查错」→ 打开配置页,添加至少一行启用的来源(URL、Key、模型等),必要时点「测试连接」确认。
- 在输入框正常写草稿,点工具栏 「查错」;按钮左边开始走计时。
- 有错别字时出现浮动卡片;点 「替换」 按当前文本重新定位并改掉;点 「忽略」 只从列表去掉。
- 需要时用 「重新检查」 对当前内容再跑一遍;点 「收起」 清掉结果和计时。
- 直接发送消息或清空输入框时,卡片、标黄和计时一起消失。
查错请求经宿主本地路由 POST /plugins-local/dsh-typo-check-check 发出;草稿文本会作为用户消息发给你配置的服务商——不想让某段文字离开本机,就不要对它点查错。
适用场景与注意¶
适合:在 DSH 里写中文(或混合)长文本、希望发送前快速扫错别字,且愿意自备 OpenAI 兼容 API 的开发者或日常用户。
注意:
- 高亮依赖 CSS Custom Highlight API,Chromium 内核的 DSH 桌面端可用。
- 替换时若目标范围含
@引用 chip,会拒绝并提示。 - 模型返回非约定 JSON 时可能当作「没查出来」或解析错误;可换更听话的模型或调大
max_tokens。 - 同一来源连续两次结果可能略不一致(
temperature已固定为 0,但模型仍有随机性);小模型可能过度报错,可点「忽略」。 - 插件以当前 DSH 进程权限运行;请求只发往你自己填的 URL,除此之外不发往任何地方。
结尾¶
dsh-plugin-typo-check 把「查错别字」从「顺便让模型改稿」里拆出来:标黄 + 浮动卡片 + 多来源回退 + 本机存 Key,适合在 DSH 输入框里写完再点一下查错、确认后再发送。