前言¶
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 提供了一種低成本增加對話親和力的方案。它通過限制模型只能從白名單複製字符,既保證了顯示效果,又避免了額外資源消耗。