前言¶
DeepSeek Harness (DSH) 的插件生态允许开发者通过提示词注入来扩展功能。在构建聊天机器人时,纯文本回复有时显得过于生硬。dsh-kaomoji 插件通过在系统提示词中注入规则,让模型根据对话情绪自动复制日式颜文字,从而在不修改代码或增加额外 API 调用的情况下丰富回复的语气。
插件简介¶
这是一个由 TianJie52009 维护的 DSH 插件。它采用纯提示词方案,不截断流,也不额外调用模型,对 KV 缓存友好。词库精选自日本颜文字站 kaomojiya.org,内置 12 种情绪分类。
核心功能¶
- 纯提示词方案:利用 DSH 的
systemPrompt服务,在模型生成前注入规则,不截断流,不增加额外 API 调用。 - 白名单防乱码:模型只能从内置词库复制颜文字,不会凭印象拼出乱码字符。
- 情绪分类:内置 12 个情绪分类(开心、心动、难过、大哭、生气、惊讶、困惑、害羞、俏皮、鼓励、感谢、道歉)。
- 频率与位置控制:
- 模式:支持
auto(智能触发,默认)、frequent(每条回复都带)、off(关闭)。 - 位置:支持
inline(情绪最贴切的句子后,默认)或end(固定在回复末尾)。
- 模式:支持
- 可视化配置:提供 Web 端配置卡片,位于「设置 → 通用设置」,修改后无需重启立即生效。
- 零依赖:仅使用 DSH 自带服务和 Node 标准库,无第三方运行时依赖。
安装与启用¶
使用 dsh CLI 安装:
dsh plugin --profile web add dsh-kaomoji
安装后,重启 Web Host 或等待热挂载生效。Web 端「设置 → 通用设置」底部会出现「颜文字」配置卡片。
配置与使用¶
插件默认配置即可使用(mode: auto)。配置分为两层:用户层(通用设置卡片)和部署默认层(cordis.patch.yml)。
用户设置文件位于 ~/.dsh/dsh-kaomoji.json。通过 POST POST /dsh-kaomoji-settings 接口可远程修改配置。
以下是一个 cordis.patch.yml 的配置示例:
- id: dsh-kaomoji
config:
mode: frequent # off | auto | frequent
placement: end # inline | end
customPrompt: "正式场景克制一点,优先使用「感谢 / 鼓励」类颜文字"
在 frequent + end 模式下的效果示例:
当然可以,我帮你把正则改成忽略大小写再跑一次测试。
测试已经全绿了 (๑•̀ㅂ•́)و✧
兼容性与注意事项¶
- 版本兼容:兼容 dsh
0.1.x与0.2.x。 - 共存性:可与
dsh-emoji等既有插件共存,提示词段名不同(dsh-kaomoji:guidance@ 176)。 - 代码来源:插件代码与文档由 OpenAI Codex 自动生成,未经人工逐行审查,使用前建议自行阅读源码。
- 安全期:npm 发布 24 小时内,若对方 pnpm 开启新包安全期,可能无法直接通过裸名安装,建议使用 GitHub 直装方式。
总结¶
dsh-kaomoji 提供了一种低成本增加对话亲和力的方案。它通过限制模型只能从白名单复制字符,既保证了显示效果,又避免了额外资源消耗。