前言¶
在 DeepSeek Harness（DSH）的使用中，開發者往往需要通過閱讀日誌來判斷智能體當前的狀態，這種判斷方式不僅耗時，且容易遺漏細微的行爲異常。dsh-mood 插件旨在解決這一痛點，它不干預模型行爲，而是通過觀察會話中的工具調用和結果，提供一個直觀的“狀態燈”。
插件簡介¶
dsh-mood 是一個爲 AI 編碼智能體設計的微型行爲觀察器。它將複雜的會話行爲摺疊爲四種可驗證的狀態：GOOD、CONFUSED、FRUSTRATED、OVERWHELMED。插件以純觀察者模式運行，不會注入提示詞或阻止工具執行。項目由 Raphaelutumn 維護，開源協議爲 MIT。
核心功能¶
插件主要提供以下能力：
* 四種狀態指示：在會話標題旁顯示低摩擦的狀態燈。狀態變化基於連續失敗、重複操作或高活動水平。
* 可解釋的原因：每個狀態都對應可驗證的觸發條件（例如“3次連續失敗”）。
* 會話旅程：記錄會話過程中的狀態變化，鼠標懸停時可查看。
* 純觀察模式：不修改模型請求，不 veto 工具調用，不中斷工作流。
安裝與啓用¶
下載或構建插件包後，使用以下命令安裝到 Web Profile：
dsh plugin --profile web add .\dsh-mood-0.1.0.tgz
安裝完成後，刷新 dsh web 界面，狀態燈會自動出現在會話標題旁。
配置與調優¶
插件支持通過配置文件調整行爲閾值。在 cordis.patch.yml 中覆蓋以下字段（默認值）：
- id: mood
config:
frustratedFailureThreshold: 3 # 觸發 FRUSTRATED 的連續失敗次數
stableSuccessesToRecover: 2 # 恢復到 GOOD 所需的連續成功次數
confusedRepeatThreshold: 3 # 觸發 CONFUSED 的重複操作次數
changeCooldownMs: 60000 # 原因去重冷卻時間
repetitionWindow: 12 # 用於檢測重複的最近工具調用窗口
highActivityThreshold: 4 # 觸發高活動的窗口長度
注意：所有配置值必須爲正整數。
適用場景與限制¶
- 適用場景：適合需要在開發過程中快速掌握智能體當前健康度、發現潛在卡頓的開發者。
- 限制：這不是科學測量，而是可解釋的行爲分類。插件僅在 Web Profile 中提供會話頭部 UI。
結語¶
dsh-mood 提供了一種低摩擦的方式，讓開發者無需深挖日誌即可瞭解智能體的行爲傾向。通過調整 cordis.patch.yml 中的閾值，可以適配不同的項目需求。
