在 DeepSeek Harness (DSH) 中開發智能體時,讓模型理解用戶的情緒或意圖並據此調整語氣,通常需要複雜的 Prompt 工程。dsh-jev 插件解決了這個問題。它每輪對話都會調用 typesafe.ai 的 systemone(jev) 接口來分析用戶輸入,並將結果注入上下文。
核心功能¶
- 情緒/意圖判定:每輪對話調用
typesafe.ai的systemone(jev) 接口,判定用戶的情緒和意圖。 - 上下文注入:將判定結果作爲帶來源標記的運行時上下文注入模型,供模型調整語氣與優先級。
- GUI 配置:所有參數(包括 API Key)均在 GUI 的「設置 → JEV 情緒分析」中配置。
- 導出聲明:支持導出
apply(ctx, config)函數,以及inject聲明 agents。
安裝與啓用¶
使用官方安裝命令添加插件,並重啓宿主進程。
dsh plugin --profile web add github:Excalibur9527/dsh-jev
安裝完成後,需要重啓 dsh web 宿主進程以使插件生效。
配置與使用¶
重啓後,在 設置 → JEV 情緒分析 中配置參數。
核心配置項:
* 啓用 JEV 判定:控制是否調用接口。
* 把判定結果注入模型上下文:控制是否將結果追加到請求中。
* API Key:存儲在 settings.yaml 的 dsh-jev.apiKey 字段,標記爲 secret,不會通過瀏覽器 RPC 回傳。
* 接口地址:默認爲 https://api.typesafe.ai/v1/systemone。
* 判定問題:支持 noul(是/否)、score(評分)、choice(單選)等類型。
測試接口:
可以使用提供的腳本測試判定結果:
node scripts/try.mjs "測試文本"
權限與信任¶
這是一個社區插件,與 DeepSeek AI 無隸屬關係。
- 出網權限:僅允許出網 POST 請求到
https://api.typesafe.ai/v1/systemone。 - 讀取權限:讀取用戶最新一條消息和
~/.dsh/settings.yaml中的dsh-jev配置段。 - 寫入權限:僅寫入
settings.yaml中的dsh-jev段。 - 密鑰安全:API Key 存儲在本地文件中,且在 RPC 返回前顯式刪除,不會被回傳給瀏覽器。
- 兼容性:DSH 0.1.1-rc.2 實測通過,要求 Node ≥ 22。
工作原理¶
插件僅在每輪對話中 agent/pre-step 的 batch 裏出現 source.kind === 'user' 的消息時觸發調用。判定結果僅作爲自然語言上下文注入,不改變工具的必填字段。若未配置 Key、接口報錯或超時,插件會原樣放行,不會阻塞對話。