矛盾指标 iimaguest/dsh-contradictions-indicator

矛盾指示器

一个 DeepSeek Harness 插件，为实时对话中的内部矛盾打分，并在会话标题栏显示 0–100 的一致性徽章。

0 表示对话里矛盾重重。100 表示前后一致。点击徽章可以查看评语、手动触发 Analyze Now 按钮，以及按会话单独控制。

安装、更新与移除

使用 web 配置档：

dsh plugin --profile web add https://github.com/iimaguest/dsh-contradictions-indicator

dsh plugin --profile web update dsh-contradictions-indicator

dsh plugin --profile web remove dsh-contradictions-indicator

dsh plugin --profile web 会把命令转发到该配置档目录下的 pnpm（add / update / remove）。add 或 update 之后，重启 dsh web，让宿主端和客户端两半都加载。徽章会出现在对话标题栏的工具区。全局默认值在 Settings → Plugins → Contradictions 下。

需要 DSH web 0.2.0-rc.1 或更新版本（不支持 dsh 0.1 宿主），并且要带上本插件注入的 settings 和 conversation UI 包。已在 dsh 0.2.0-rc.2 上测试。

它做什么

- 监听主对话的 llm/stream 调用（跳过 compaction、session-title，以及它自己的分析调用）。
- 按需触发，或按轮次间隔触发一次并行的模型调用：复用对话的服务商、模型、系统提示词、工具、会话 id 和消息，再追加一条分析用的用户消息，让服务商的 KV 缓存保持温热。会话声明的其他请求字段——reasoning effort、temperature、stop sequences、输出预算——也原样转发，所以请求体就是主调用加上恰好一条消息，任何适配器默认值都不会被替换进来。唯一被有意替换的字段是 abort signal。为了引导模型作答，绝不会从请求里删掉任何东西：丢掉工具列表会让整个上下文缓存失效。
- 从响应里解析 SCORE: <n> 和 ANALYSIS: <text>。
- 显示带颜色的标题栏徽章（绿色 ≥80，黄色 ≥50，红色 <50），以及一个展示评语的浮层。
- 新对话默认开启自动分析（默认间隔 25 轮，可改，范围 1–500）。可以在 Settings → Plugins → Contradictions 里全局关闭，也可以在面板里按会话关闭。
- 可选系统提醒引导，使用 {{score}} 和 {{commentary}}。一轮正在运行时，分析一结束就会把它作为用户消息推入对话（对活跃智能体调用 agent.steer()，落在下一个步骤边界）。空闲对话绝不会仅仅为了捎带一条通知而被唤醒——文本会保持待发状态，等该对话下一个步骤时再交给它。如果解析不到活跃智能体（注册表缺失、会话已关闭、收件箱拒收），则同样走 agent/pre-step 回退。取消勾选即可完全关闭。
- 如果响应忽略了必须的 SCORE:/ANALYSIS: 格式，或者只发来一个没有任何文本的裸工具调用，会在整个运行被报告为失败之前重试一次。重试会重新发送完全相同的缓存前缀，所以几乎不花什么成本——而且请求里永远不会丢掉工具列表，因为删掉它会让服务商的上下文缓存失效。
- 徽章、面板和设置标签页都通过 shell 的 locale 服务做了本地化（English / 简体中文），所以 Settings → Language 对这个插件同样生效；每个界面的颜色、圆角、阴影都取自 shell 的 --dsw- 主题 token，所以 Settings → Appearance 能像给宿主 UI 换肤一样给它换肤。

设置：两个层面，严格分离

全局默认值（autoEnabled、间隔、steer、两段提示词文本）放在插件的 Settings 区，通过 DSH 的 settings 服务持久化进 profile 补丁（见下文「Settings in dsh 0.2 (native)」）。每个会话在创建时快照一次这些默认值；之后会话自己的面板就拥有自己的副本。因此编辑设置只影响之后启动的会话——它绝不会伸进正在运行的会话——而调整某个会话也绝不会写回默认值（/contradictions/auto 上旧的 persist 标志已被忽略并移除）。

HTTP 端点（本地 DSH web 服务器）

宿主那一半在 DSH web 服务器上注册了四个精确路径。它们供同源下本插件的客户端 UI 使用：

| Method | Path | Purpose |
| GET | /contradictions/state?sessionId= | 当前评分、评语和会话标志 |
| POST | /contradictions/auto?sessionId= | 更新自动分析、间隔、steer、提示词 |
| GET/POST | /contradictions/defaults | 读取或写入全局默认值 |
| POST | /contradictions/trigger?sessionId= | 立即运行分析 |

这些路由不在 DSH 的 /api 浏览器信任围栏覆盖范围内，所以插件自己做了同源检查（Sec-Fetch-Site / Origin 对比 Host），在触碰会话状态之前就拒绝跨站请求。这四个路由还都会拒绝超过 1 MB 的请求体，并限制持久化的提示词文本长度。

本地克隆之后的 peer 包

如果你把本目录 link: 进某个 profile，Node 会从真实路径解析 import，看不到 profile 里的 @deepseek-ai 包。全新克隆之后要重新跑一遍（node_modules/ 已被 gitignore）：

./link-peer-deps.sh

dsh-settings、schemastery 和 cordis 都被链接了——前两个是宿主那一半一直在 Node 里执行的裸 import，而从 2.0.0 起 cordis 也是（Service 基类）。react 通过 DSH 浏览器模块表解析，不走 Node 的 node_modules，所以这里不需要链接。

@deepseek-ai/dsh-settings 和 react 在 package.json 里标记为 optional——这是 DSH 宿主插件正确的安装*契约（pnpm 不能重复安装宿主已提供的包）——而 cordis 和 schemastery 从 2.0.0 起，这些 peer 是必需的，因为 Service 导入是承重的。可选从来不代表「没有它们也能跑」：lib/index.js 会硬导入它需要的 peer，如果配置档没有提供，就会加载失败。

消息来源与 v4 会话格式

这个插件发出的每条持久消息——投递给运行中回合的 steer 通知，以及 pre-step 回退插入——都带有生产者自有的来源类型 plugin:contradictions-indicator。dsh 的 v4 会话格式在准入时拒绝已废弃的 v3 包装 kind: 'plugin'，而且拒绝会连带整个运行中的回合一起挂掉，所以插件绝不能发出它（有一条回归测试锁住这一点，对照准入规则）。在途的分析请求消息用同样的类型；它从不持久化。

dsh 0.2 中的设置（原生）

从 2.0.0 起，宿主侧是一个 Cordis Service，带 static Config schema，覆盖五个全局默认值（autoEnabled、interval、steerEnabled、prompt1、prompt2）。dsh 的设置服务会根据这个 schema，为插件的组合入口自动生成 Settings 标签页表单，编辑内容通过 settings.update 持久化进配置档补丁，而且每个字段都是 volatile——编辑会经 loader/volatile-update 热应用，无需重新挂载插件。每个会话的条目在创建时对这些默认值做一次快照（Settings 编辑只影响之后开始的对话，绝不影响在途的）。插件面板的全局平面（POST /contradictions/defaults）通过同一个服务写入，所以面板和原生表单不会出现偏差。在宿主没有设置服务、或没有组合入口时，全局写入留在内存里，并附一条控制台说明；dsh 0.1 宿主完全不支持（peer 收窄为 @deepseek-ai/dsh-settings ^0.2.0-rc.1）。

运行宿主侧回归测试：

npm test

./client 导出（lib/client.js）是 DSH window.__ModuleLoader__ 的懒加载工厂，不是标准 ESM/CJS 模块。它只在 DSH 浏览器运行时里跑；import … from 'dsh-contradictions-indicator/client' 在它之外不会工作。

目录结构

- lib/index.js — 宿主插件（Cordis apply）
- lib/client.js — Web 客户端（徽标、浮层、设置标签页）
- cordis.patch.yml — 供 dsh plugin add 使用的 bundle 插入
- test/ — 宿主侧投递时机回归测试（npm test）
- plugin/ — 同一套宿主/客户端源码的工作副本

许可证

Apache License 2.0。见 LICENSE。