前言¶
在 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 中的阈值，可以适配不同的项目需求。
