dsh-calibration-tier

简称 CT（全名 DSH Calibration Tier）：C 取自 calibration——把用力程度校准到任务；T 取自 tier——一根条上的档位；两代旧名（dsh-clarify-tier / dsh-calibration）的首字母也都落在这两个词里。给 DSH 输入框加一条档位条：一框四模式：思考 / 循环 / 对抗 / 检索。思考与循环互斥切换，对抗与检索可叠加在任一种上。 常规 | 严格 | 极致 ‖ 循环 | 对抗 | 检索（思考）↔ 轻量 | 交付 | 极致 ‖ 循环亮（循环）↔ 检索开时最左多出 本地 | 增量 | 全量。拨档或拨开关 → 模型通过 clarify_tier / forge_level 读到 → 决定开工问多深、交付后磨几轮、要不要额外做对抗审、要不要去找技能。

demo

同框四模式：思考 / 循环 / 对抗 / 检索

思考：  [常规] [严格] [极致] ‖ [循环] [对抗] [检索]      ← 思考 / 循环 / 对抗 / 检索 四色
循环：  [轻量] [交付] [极致] ‖ [循环]亮 [对抗] [检索]
检索：  [本地] [增量] [全量] ‖ [常规] [严格] [极致] ‖ [循环] [对抗] [检索]亮
循环+对抗：[轻量] [交付] [极致]橙 ‖ [循环]亮 [对抗]亮  ← 选中格转橙（红 + 绿 中和）

一根框里四种模式，关系是「二选一 + 两个可叠加」：

思考（默认）与循环互斥：拨「循环」在两者之间切，前三格的语义从「问多深」变成「磨几轮」，标签与配色一起换；
对抗可叠加：不改变前三格，只决定这一轮要不要额外做一轮对抗审查（思考下=动手前审方案 + 交付前审改动；循环下=每轮审改动）；
检索（v2.2.0）也可叠加：开启后主条最左侧多出三格「本地 / 增量 / 全量」，思考档与循环档原样保留，三者互不覆盖。

界面不挂悬停解释（2026-10-24 起只留按钮本体，避免一格一个 tip 打断视线）；配色（2026-10-24 定版，检索 2026-10-27 加入）：思考 #877be3、循环 #66ae7c、对抗 #da7f7f、检索 #3a9ad9，连同雾橙 #cf8a4a 一起，只在客户端 CSS 的 --dct-think/--dct-loop/--dct-counter/--dct-mix/--dct-route 五个变量里定义。循环与对抗之间另有一条隔离线；对抗一旦亮起就保持红，检索一旦亮起就保持天蓝，都不跟循环换色。

循环 + 对抗同开（2026-10-27 起）：左边三格的选中格由绿转橙 #cf8a4a（--dct-mix，红 + 绿中和），提示这一轮是「边磨边审」；两个开关各留原色，橙只落在等级格上。橙色是手工取的暖橙——#66ae7c 与 #da7f7f 直接平均得 #a0967d（土黄），既不像橙也发灰。

模式	格	含义	模型读到
思考	常规（值 `off`）	按平时标准直接做：不锚定、不复述、不提问	`clarify_tier=off`
思考	严格（默认）	复述 + 2 确认点 + 回滚 + 验收 + 失败分支	`clarify_tier=high`
思考	极致	严格之上再加反例与代价、对抗自检、对抗复审	`clarify_tier=max`
循环	轻量	3 轮纯自检，适合小修小补	`forge_level=lite`
循环	交付	5 轮，第 2 轮独立评审 + 收敛复核	`forge_level=high`
循环	极致	8 轮，第 2 轮起每轮独立评审	`forge_level=max`
检索	本地	只用已装技能，不联网，命中隐藏技能要手工 `read`	`route.level=off`
检索	增量（默认）	联网找已装之外能用的技能，只读文本不安装，落暂存等你定	`route.level=high`
检索	全量	地毯式检索 + 重合组差异分析，出判别卡；只跑首轮，不跟循环叠加	`route.level=max`

对抗开关决定「每轮几条攻击」：常规/严格 3 条、极致 5 条；关着就是 0 条，行为与以前完全一致。

为什么对抗/检索不做成第四格：三格表示「强度」（问多深 / 磨几轮 / 找多宽），两个开关表示「多做一件事」（多审一遍 / 多找一轮）。做成可叠加的开关才能和思考/循环自由组合，也不挤占格位。检索之所以保留自己的三格，是因为「找多宽」和「问多深」是两个独立维度，共用 level 会让「检索=全量」把「思考=极致」冲掉。

状态模型（每个对话各用各的）

{
  "schema": 8,
  "sessions": {
    "<sessionId>": {
      "mode": "think" | "loop",
      "level": "off" | "high" | "max",
      "counter": true | false,
      "route": { "on": true | false, "level": "off" | "high" | "max" },
      "owner": "tool" | "client" | null,
      "updatedAt": "…"
    }
  }
}

会话键：客户端用插槽 inject 给的 sessionId，经 ?session= 传给桥；工具用 exec.agent.session.id，读不到才落 default
clarify_tier：思考模式返回 level + counter；循环模式返回 off（不叠加锚定）+ counter；两种模式都返回 route（开关 + 档位 + 执行口径，关着时 plan=null）
counter = 对抗开关：{ enabled, maxAttacks, scope }，密度随档位（常规/严格 3 条、极致 5 条），scope 思考为 plan+delivery、循环为 round-changes
forge_level：思考模式返回 off；循环模式把 off/high/max 映射成 lite/high/max 与 3/5/8 轮；同样带 counter
每轮快照：一条用户消息 = 一轮（轮号取 agent.phase.turn）。开工第一次调工具时，把当时的设置记成本轮快照（turn{id,mode,level,counter,route}）；本轮内再点档位条只改「下轮的值」，条尾显示一个循环色小点（pending）
下一轮开工自动换用新值；取不到轮 id 时退回实时值（不做轮内保护，但功能不坏）
没单独设置过的对话，继承 default 会话（迁移自 0.6 的全局值），再没有就用内置 think/high
文件：$DSH_HOME/storages/calibration.json；每会话只写自己那条，切模式不会丢档位；最多保留 100 个会话（删最旧的非 default）
实时同步：GET /events?session=… 只推本会话；同一对话开两个窗口才互通，跨对话互不干扰；普通断线按 retry: 2000 自动重连，连接被彻底关掉（readyState=2）时客户端按 CONFIG.reconnectDelay 自己重建，最多 CONFIG.maxReconnects 次

安装

需要：DSH Desktop / DSH NEXT（带 Web 客户端插件支持的版本）。

pwsh -File install-profile.ps1             # 装进 desktop profile
pwsh -File install-profile.ps1 -Uninstall  # 卸载

脚本做三件事：往 profile 的 package.json 加一条 link: 依赖、把包名追加进 dsh.profile.bundles、在 profile 的 node_modules 下建链接。装完完全退出并重开 DSH（关窗口不够，要退出进程）。

验证：输入框工具行、模型选择左边出现一条「三格 + 两条隔离线 + 循环 / 对抗」的框，默认停在「严格」；点「循环」，前三格变「轻量 / 交付 / 极致」、框转绿；点「对抗」，那颗开关转红且循环模式下也保持红。再问模型「现在什么档」，它应能调 clarify_tier / forge_level 报出同值。

工作原理

层	文件	职责
客户端	`lib/client.js`	三格 + 循环/对抗两个可拨控件，注册进 `conversation.input.right`（`order=10`）。单文件 bundle，模块加载器只吃一个 factory，不能拆 import
宿主入口	`lib/index.js`	装配层：起桥 + 注册工具 + 把 dispose 挂到 `ctx.effect`
宿主模块	`lib/core.js` / `lib/state.js` / `lib/bridge.js` / `lib/tools.js`	常量与文案表 / 状态读写与迁移 / 回环桥 HTTP+SSE / 两个只读工具与轮内快照
形态	`cordis.patch.yml` + `package.json` 的 `dsh.client`	进 cordis 树，客户端产物编进启动包

桥：http://127.0.0.1:43871/state（GET/POST）与 /events（SSE）；只绑回环，宿主在 43871–43880 里取第一个能绑的端口，客户端按同区间探测 /state 的 plugin 标记自动对齐，两套 DSH 同时开着也不打架
对抗是独立开关：开/关记在 counter 上，密度随档位（常规/严格 3 条、极致 5 条），关着就是 0 条、行为与旧版一致；两个工具都返回 counter，客户端只多一格
两套 DSH 同开时靠「会话归属」认桥：/state 带 knownSession，只有本实例的工具为该会话落过盘才算认识（客户端写只标 owner:"client"，认领不到）——plugin 标记只能证明「是同一个插件」，分不出是哪个实例
认不准就不碰桥：扫一遍端口后若「两套以上、且谁都不认识本会话」，客户端不读不写任何桥、也不连 SSE，只用本地值（本地值天生属于本应用），并显示 !；期间点击先记账，认准实例后补写一次。工具只在本轮的第一次调用时落盘，所以通常几秒内就会认准
只有一套在跑就直接认：端口上只找到一个本插件实例时不存在「连错」的可能，不必等工具落盘
点一次只发一个 POST：宿主在 POST 响应里直接回带 mode/level/counter/pending/turnLocked，客户端不再补 GET（老宿主不回 pending 才退回拉一次）
端口发现失败后 3 秒内不重扫：一轮探空会记住时间，期间点击不再打 10 个 fetch；挂载时 pull 与 SSE 并发要端口，同一时刻只跑一轮发现
档名 / 悬停 / 轮次表只在宿主定义一次，客户端从 /state 的 labels、titles 读；离线兜底文案由测试锁死与宿主一致
三条纪律：fail-open（注册失败只是控件不出现）、不碰官方 DOM、不注入会话消息

安全边界

桥只绑 127.0.0.1，并且：

带 Origin 的请求只放行本机页面（127.0.0.1 / localhost / ::1），其余返回 403，且不回显 Access-Control-Allow-Origin
无 Origin 的请求（curl、测试、本地脚本）照常放行
POST 必须是 application/json，挡掉 text/plain 这类绕过预检的简单请求
没有 token 鉴权：同机其它进程仍可写。这台机器上的信任边界就是本机，够用但不防本机恶意程序

测试

npm test        # node --test，81 项，约 5 秒
npm run lint    # scripts/check.mjs：lib 下所有模块 + 所有测试逐个 node --check
npm run verify  # lint + test，本地 CI 就用这条

覆盖（按类，不按条数）：

状态与迁移：默认值、模式/档位/对抗/检索四轴合并写、非法值 400、标量与坏 JSON 400、schema 4/5 迁移 + .bak、schema 6 → 7 补 counter、7 → 8 补 route、坏 JSON 与未知 schema 不覆写（含「未来 schema 带旧字段」也不降级）、字段坏只保留能认的一半
工具投影：clarify_tier / forge_level 的档位值、pending/turnLocked、counter（开关 / 条数随档位 3 与 5 / scope 随模式）
桥与安全：跨站 Origin 403（读/写/预检/null/子域伪装）、本机 Origin 回显 204、text/plain 415、写盘失败 500、SSE 首帧与广播、跨站 SSE 403、端口退让与 plugin 标记、退让日志只报一次且端口正确、knownSession 只认工具写过的会话
界面与交互：九节点结构（3 档 + 3 隔离线 + 循环 + 对抗 + 检索），检索开时变 13 节点（多出本地/增量/全量）、两套标签、循环格亮起、对抗恒红、只提交变化的一维、focus 重新对齐、/state 文案优先、兜底文案与宿主表逐字一致、pending 小点、循环 + 对抗同开时 data-mix=1 且橙只落在等级格（单开时都是 0）、检索开时 data-route=1 且天蓝只落在检索格与检索开关（循环/对抗怎么切都不跟着变色）
容错与实例识别：桥不可达只探一遍且 TTL 内不重扫、老宿主缺 pending 补一次 GET、SSE 断后重建不超上限、诊断默认关、离线与待生效同显、两套实例按会话归属切端口、单实例直接认领、两套都不认领时不读不写桥且认领后补写
一致性守则：版本号与 CHANGELOG 同条、files 清单覆盖 lib 全部模块、文案不再出现旧名「极限」、工具描述与档位表同字、skill 表与宿主 LEVELS 同一套、对抗密度与 LEVELS 绑定、counter-review 技能 frontmatter 合规、README 边界与测试条数自校验

CI：.github/workflows/ci.yml，推上去后在 Node 22 / 24 上跑 npm run lint + npm test。本地没有网络通道时以 npm run verify 为准。

给使用者的说明

分享给不写代码的同学看：使用说明（Markdown） · 使用说明（Word）。内容：三种模式与三档怎么拨、安装三步、常见问题、卸载。

工作方式（项目内约定）

开放性作业先方案再动手（2026-10-24 定）：新功能、方案设计、架构选型这类没定论的事，先把方案、取舍、代价摆出来讨论，敲定后再写代码；不要先实现再解释。已定论的修 bug、补测试、改文案不受此限。

配套技能

技能	位置	作用
clarify-needs	`skill/clarify-needs/`	拿到思考档后怎么问：复述 / 确认点 / 设计树 / 共识摘要
counter-review	`skill/counter-review/`	开了「对抗」之后怎么杠：六轴矩阵 → 攻击卡（触发条件/后果/检查方法）→ 三态收口；思考模式前后各一轮、循环模式每轮
loop-forge	`D:\AI\Skills\mine\loop-forge`（junction 到技能目录）	拿到循环档后怎么磨：判据 → 每轮报数 → 自动下一轮 → 自动止损

cmd /c mklink /J "D:\AI\DSH-NEXT\skills\loop-forge" "D:\AI\Skills\mine\loop-forge"
cmd /c mklink /J "D:\AI\DSH-NEXT\skills\clarify-needs" "%CD%\skill\clarify-needs"
cmd /c mklink /J "D:\AI\DSH-NEXT\skills\counter-review" "%CD%\skill\counter-review"

数据安全

读不出来不覆写：坏 JSON / 未知 schema（如未来的 schema:8）只返回默认值并标 corrupt / unsupported，原文件原样保留
迁移前留备份：旧的 {tier, forge} 迁移时先写 calibration.json.bak
原子写：临时文件 + rename，避免写到一半断电留下半截 JSON
写失败不谎报：磁盘不可写时 POST 返回 500（error: write failed），不返回 200

已知边界

端口区间全被占（43871–43880 十个都绑不上，例如三套 DSH 同开）时，控件退化为只读（虚线边框 + !）：本地点击仍然换档，但不会同步到宿主，重启后按宿主里的值走
DSH_CLARIFY_TIER_PORT 只改宿主起点，客户端按同区间探测、认 plugin 标记，两端不用手工对齐；要改区间宽度得同时改宿主与客户端的 PORT_SPAN
「会话归属」认桥的空窗：刚开的对话还没被工具写过时，两边都可能回 knownSession=false，这段时间控件只显示本地值（不读另一套的档位）并带 !，点击只记账不落地；本轮的第一次 clarify_tier 落盘后（最长 5 秒一轮的轮询）自动认准、补写、连 SSE
面板显示的是「最后一次认准后」的值：认准之前改的档，认准后以宿主值为准；要立刻用新档就在认准后再点一次
降级后不会自己变回来：端口全占 / 宿主没起时，控件停在只读（!）；恢复靠下一次成功写入、切窗口，或 SSE 重建成功
SSE 重建有上限（CONFIG.maxReconnects，默认 3 次、间隔 2 秒）：连不上就停手，不做无限重试；重建时会顺手作废端口缓存，宿主换了端口也能重新发现
状态文件只有一个（storages/calibration.json）：并发写按「最后落盘为准」，没有跨进程锁
工具返回的是调用时刻的值；中途改档要再调一次
循环模式不叠加思考档：需要强提问就先退回思考模式；但「对抗」在思考/循环两种强度模式下都能叠加，不冲突
多窗口实时同步：SSE 推送，同一对话两窗同时改动以最后落盘为准；SSE 不可用时退回「切窗口重新对齐」
快照是按轮的：只影响「我这一轮用什么」，不改你拨出来的值；别的对话互不影响
诊断默认关：启动时不再往宿主写 calibration-debug.jsonl（那个文件不轮转，会一直长）。要抓注册链路时在控制台执行 localStorage.setItem("dsh-tier-debug","1") 再刷新，用完删掉这个键

踩过的坑（别重犯）

坑	症状	正解
客户端 bundle 的 `id` 写成短名	`duplicate factory registration` → `web boot: 1 entry did not activate` → GUI 起不来	`id` 必须等于包名（含 `@scope`）
宿主没声明 `inject`	`cannot get property "tools" without inject`，工具静默消失	`export const inject = ["tools"]`
两个开关写同一文件不做合并	切档把另一轴冲掉	`writeState` 读旧值再合并
把「读不到」当成「要重置」	一次 GET 就把用户设置冲成默认	坏文件/未知 schema 只读兜底，迁移才写盘

卸载

install-profile.ps1 -Uninstall
删 $DSH_HOME/storages/calibration.json
重开应用

License

MIT

dsh-calibration-tier

简称 CT（全名 DSH Calibration Tier）：C 取自 calibration——把用力程度校准到任务；T 取自 tier——一根条上的档位；两代旧名（dsh-clarify-tier / dsh-calibration）的首字母也都落在这两个词里。给 DSH 输入框加一条档位条：一框四模式：思考 / 循环 / 对抗 / 检索。思考与循环互斥切换，对抗与检索可叠加在任一种上。 常规 | 严格 | 极致 ‖ 循环 | 对抗 | 检索（思考）↔ 轻量 | 交付 | 极致 ‖ 循环亮（循环）↔ 检索开时最左多出 本地 | 增量 | 全量。拨档或拨开关 → 模型通过 clarify_tier / forge_level 读到 → 决定开工问多深、交付后磨几轮、要不要额外做对抗审、要不要去找技能。

demo

同框四模式：思考 / 循环 / 对抗 / 检索

思考：  [常规] [严格] [极致] ‖ [循环] [对抗] [检索]      ← 思考 / 循环 / 对抗 / 检索 四色
循环：  [轻量] [交付] [极致] ‖ [循环]亮 [对抗] [检索]
检索：  [本地] [增量] [全量] ‖ [常规] [严格] [极致] ‖ [循环] [对抗] [检索]亮
循环+对抗：[轻量] [交付] [极致]橙 ‖ [循环]亮 [对抗]亮  ← 选中格转橙（红 + 绿 中和）

一根框里四种模式，关系是「二选一 + 两个可叠加」：

思考（默认）与循环互斥：拨「循环」在两者之间切，前三格的语义从「问多深」变成「磨几轮」，标签与配色一起换；
对抗可叠加：不改变前三格，只决定这一轮要不要额外做一轮对抗审查（思考下=动手前审方案 + 交付前审改动；循环下=每轮审改动）；
检索（v2.2.0）也可叠加：开启后主条最左侧多出三格「本地 / 增量 / 全量」，思考档与循环档原样保留，三者互不覆盖。

模式	格	含义	模型读到
思考	常规（值 `off`）	按平时标准直接做：不锚定、不复述、不提问	`clarify_tier=off`
思考	严格（默认）	复述 + 2 确认点 + 回滚 + 验收 + 失败分支	`clarify_tier=high`
思考	极致	严格之上再加反例与代价、对抗自检、对抗复审	`clarify_tier=max`
循环	轻量	3 轮纯自检，适合小修小补	`forge_level=lite`
循环	交付	5 轮，第 2 轮独立评审 + 收敛复核	`forge_level=high`
循环	极致	8 轮，第 2 轮起每轮独立评审	`forge_level=max`
检索	本地	只用已装技能，不联网，命中隐藏技能要手工 `read`	`route.level=off`
检索	增量（默认）	联网找已装之外能用的技能，只读文本不安装，落暂存等你定	`route.level=high`
检索	全量	地毯式检索 + 重合组差异分析，出判别卡；只跑首轮，不跟循环叠加	`route.level=max`

对抗开关决定「每轮几条攻击」：常规/严格 3 条、极致 5 条；关着就是 0 条，行为与以前完全一致。

状态模型（每个对话各用各的）

{
  "schema": 8,
  "sessions": {
    "<sessionId>": {
      "mode": "think" | "loop",
      "level": "off" | "high" | "max",
      "counter": true | false,
      "route": { "on": true | false, "level": "off" | "high" | "max" },
      "owner": "tool" | "client" | null,
      "updatedAt": "…"
    }
  }
}

会话键：客户端用插槽 inject 给的 sessionId，经 ?session= 传给桥；工具用 exec.agent.session.id，读不到才落 default
clarify_tier：思考模式返回 level + counter；循环模式返回 off（不叠加锚定）+ counter；两种模式都返回 route（开关 + 档位 + 执行口径，关着时 plan=null）
counter = 对抗开关：{ enabled, maxAttacks, scope }，密度随档位（常规/严格 3 条、极致 5 条），scope 思考为 plan+delivery、循环为 round-changes
forge_level：思考模式返回 off；循环模式把 off/high/max 映射成 lite/high/max 与 3/5/8 轮；同样带 counter
每轮快照：一条用户消息 = 一轮（轮号取 agent.phase.turn）。开工第一次调工具时，把当时的设置记成本轮快照（turn{id,mode,level,counter,route}）；本轮内再点档位条只改「下轮的值」，条尾显示一个循环色小点（pending）
下一轮开工自动换用新值；取不到轮 id 时退回实时值（不做轮内保护，但功能不坏）
没单独设置过的对话，继承 default 会话（迁移自 0.6 的全局值），再没有就用内置 think/high
文件：$DSH_HOME/storages/calibration.json；每会话只写自己那条，切模式不会丢档位；最多保留 100 个会话（删最旧的非 default）
实时同步：GET /events?session=… 只推本会话；同一对话开两个窗口才互通，跨对话互不干扰；普通断线按 retry: 2000 自动重连，连接被彻底关掉（readyState=2）时客户端按 CONFIG.reconnectDelay 自己重建，最多 CONFIG.maxReconnects 次

安装

需要：DSH Desktop / DSH NEXT（带 Web 客户端插件支持的版本）。

pwsh -File install-profile.ps1             # 装进 desktop profile
pwsh -File install-profile.ps1 -Uninstall  # 卸载

工作原理

层	文件	职责
客户端	`lib/client.js`	三格 + 循环/对抗两个可拨控件，注册进 `conversation.input.right`（`order=10`）。单文件 bundle，模块加载器只吃一个 factory，不能拆 import
宿主入口	`lib/index.js`	装配层：起桥 + 注册工具 + 把 dispose 挂到 `ctx.effect`
宿主模块	`lib/core.js` / `lib/state.js` / `lib/bridge.js` / `lib/tools.js`	常量与文案表 / 状态读写与迁移 / 回环桥 HTTP+SSE / 两个只读工具与轮内快照
形态	`cordis.patch.yml` + `package.json` 的 `dsh.client`	进 cordis 树，客户端产物编进启动包

桥：http://127.0.0.1:43871/state（GET/POST）与 /events（SSE）；只绑回环，宿主在 43871–43880 里取第一个能绑的端口，客户端按同区间探测 /state 的 plugin 标记自动对齐，两套 DSH 同时开着也不打架
对抗是独立开关：开/关记在 counter 上，密度随档位（常规/严格 3 条、极致 5 条），关着就是 0 条、行为与旧版一致；两个工具都返回 counter，客户端只多一格
两套 DSH 同开时靠「会话归属」认桥：/state 带 knownSession，只有本实例的工具为该会话落过盘才算认识（客户端写只标 owner:"client"，认领不到）——plugin 标记只能证明「是同一个插件」，分不出是哪个实例
认不准就不碰桥：扫一遍端口后若「两套以上、且谁都不认识本会话」，客户端不读不写任何桥、也不连 SSE，只用本地值（本地值天生属于本应用），并显示 !；期间点击先记账，认准实例后补写一次。工具只在本轮的第一次调用时落盘，所以通常几秒内就会认准
只有一套在跑就直接认：端口上只找到一个本插件实例时不存在「连错」的可能，不必等工具落盘
点一次只发一个 POST：宿主在 POST 响应里直接回带 mode/level/counter/pending/turnLocked，客户端不再补 GET（老宿主不回 pending 才退回拉一次）
端口发现失败后 3 秒内不重扫：一轮探空会记住时间，期间点击不再打 10 个 fetch；挂载时 pull 与 SSE 并发要端口，同一时刻只跑一轮发现
档名 / 悬停 / 轮次表只在宿主定义一次，客户端从 /state 的 labels、titles 读；离线兜底文案由测试锁死与宿主一致
三条纪律：fail-open（注册失败只是控件不出现）、不碰官方 DOM、不注入会话消息

安全边界

桥只绑 127.0.0.1，并且：

带 Origin 的请求只放行本机页面（127.0.0.1 / localhost / ::1），其余返回 403，且不回显 Access-Control-Allow-Origin
无 Origin 的请求（curl、测试、本地脚本）照常放行
POST 必须是 application/json，挡掉 text/plain 这类绕过预检的简单请求
没有 token 鉴权：同机其它进程仍可写。这台机器上的信任边界就是本机，够用但不防本机恶意程序

测试

npm test        # node --test，81 项，约 5 秒
npm run lint    # scripts/check.mjs：lib 下所有模块 + 所有测试逐个 node --check
npm run verify  # lint + test，本地 CI 就用这条

覆盖（按类，不按条数）：

状态与迁移：默认值、模式/档位/对抗/检索四轴合并写、非法值 400、标量与坏 JSON 400、schema 4/5 迁移 + .bak、schema 6 → 7 补 counter、7 → 8 补 route、坏 JSON 与未知 schema 不覆写（含「未来 schema 带旧字段」也不降级）、字段坏只保留能认的一半
工具投影：clarify_tier / forge_level 的档位值、pending/turnLocked、counter（开关 / 条数随档位 3 与 5 / scope 随模式）
桥与安全：跨站 Origin 403（读/写/预检/null/子域伪装）、本机 Origin 回显 204、text/plain 415、写盘失败 500、SSE 首帧与广播、跨站 SSE 403、端口退让与 plugin 标记、退让日志只报一次且端口正确、knownSession 只认工具写过的会话
界面与交互：九节点结构（3 档 + 3 隔离线 + 循环 + 对抗 + 检索），检索开时变 13 节点（多出本地/增量/全量）、两套标签、循环格亮起、对抗恒红、只提交变化的一维、focus 重新对齐、/state 文案优先、兜底文案与宿主表逐字一致、pending 小点、循环 + 对抗同开时 data-mix=1 且橙只落在等级格（单开时都是 0）、检索开时 data-route=1 且天蓝只落在检索格与检索开关（循环/对抗怎么切都不跟着变色）
容错与实例识别：桥不可达只探一遍且 TTL 内不重扫、老宿主缺 pending 补一次 GET、SSE 断后重建不超上限、诊断默认关、离线与待生效同显、两套实例按会话归属切端口、单实例直接认领、两套都不认领时不读不写桥且认领后补写
一致性守则：版本号与 CHANGELOG 同条、files 清单覆盖 lib 全部模块、文案不再出现旧名「极限」、工具描述与档位表同字、skill 表与宿主 LEVELS 同一套、对抗密度与 LEVELS 绑定、counter-review 技能 frontmatter 合规、README 边界与测试条数自校验

CI：.github/workflows/ci.yml，推上去后在 Node 22 / 24 上跑 npm run lint + npm test。本地没有网络通道时以 npm run verify 为准。

给使用者的说明

分享给不写代码的同学看：使用说明（Markdown） · 使用说明（Word）。内容：三种模式与三档怎么拨、安装三步、常见问题、卸载。

工作方式（项目内约定）

配套技能

技能	位置	作用
clarify-needs	`skill/clarify-needs/`	拿到思考档后怎么问：复述 / 确认点 / 设计树 / 共识摘要
counter-review	`skill/counter-review/`	开了「对抗」之后怎么杠：六轴矩阵 → 攻击卡（触发条件/后果/检查方法）→ 三态收口；思考模式前后各一轮、循环模式每轮
loop-forge	`D:\AI\Skills\mine\loop-forge`（junction 到技能目录）	拿到循环档后怎么磨：判据 → 每轮报数 → 自动下一轮 → 自动止损

cmd /c mklink /J "D:\AI\DSH-NEXT\skills\loop-forge" "D:\AI\Skills\mine\loop-forge"
cmd /c mklink /J "D:\AI\DSH-NEXT\skills\clarify-needs" "%CD%\skill\clarify-needs"
cmd /c mklink /J "D:\AI\DSH-NEXT\skills\counter-review" "%CD%\skill\counter-review"

数据安全

读不出来不覆写：坏 JSON / 未知 schema（如未来的 schema:8）只返回默认值并标 corrupt / unsupported，原文件原样保留
迁移前留备份：旧的 {tier, forge} 迁移时先写 calibration.json.bak
原子写：临时文件 + rename，避免写到一半断电留下半截 JSON
写失败不谎报：磁盘不可写时 POST 返回 500（error: write failed），不返回 200

已知边界

端口区间全被占（43871–43880 十个都绑不上，例如三套 DSH 同开）时，控件退化为只读（虚线边框 + !）：本地点击仍然换档，但不会同步到宿主，重启后按宿主里的值走
DSH_CLARIFY_TIER_PORT 只改宿主起点，客户端按同区间探测、认 plugin 标记，两端不用手工对齐；要改区间宽度得同时改宿主与客户端的 PORT_SPAN
「会话归属」认桥的空窗：刚开的对话还没被工具写过时，两边都可能回 knownSession=false，这段时间控件只显示本地值（不读另一套的档位）并带 !，点击只记账不落地；本轮的第一次 clarify_tier 落盘后（最长 5 秒一轮的轮询）自动认准、补写、连 SSE
面板显示的是「最后一次认准后」的值：认准之前改的档，认准后以宿主值为准；要立刻用新档就在认准后再点一次
降级后不会自己变回来：端口全占 / 宿主没起时，控件停在只读（!）；恢复靠下一次成功写入、切窗口，或 SSE 重建成功
SSE 重建有上限（CONFIG.maxReconnects，默认 3 次、间隔 2 秒）：连不上就停手，不做无限重试；重建时会顺手作废端口缓存，宿主换了端口也能重新发现
状态文件只有一个（storages/calibration.json）：并发写按「最后落盘为准」，没有跨进程锁
工具返回的是调用时刻的值；中途改档要再调一次
循环模式不叠加思考档：需要强提问就先退回思考模式；但「对抗」在思考/循环两种强度模式下都能叠加，不冲突
多窗口实时同步：SSE 推送，同一对话两窗同时改动以最后落盘为准；SSE 不可用时退回「切窗口重新对齐」
快照是按轮的：只影响「我这一轮用什么」，不改你拨出来的值；别的对话互不影响
诊断默认关：启动时不再往宿主写 calibration-debug.jsonl（那个文件不轮转，会一直长）。要抓注册链路时在控制台执行 localStorage.setItem("dsh-tier-debug","1") 再刷新，用完删掉这个键

踩过的坑（别重犯）

坑	症状	正解
客户端 bundle 的 `id` 写成短名	`duplicate factory registration` → `web boot: 1 entry did not activate` → GUI 起不来	`id` 必须等于包名（含 `@scope`）
宿主没声明 `inject`	`cannot get property "tools" without inject`，工具静默消失	`export const inject = ["tools"]`
两个开关写同一文件不做合并	切档把另一轴冲掉	`writeState` 读旧值再合并
把「读不到」当成「要重置」	一次 GET 就把用户设置冲成默认	坏文件/未知 schema 只读兜底，迁移才写盘

卸载

install-profile.ps1 -Uninstall
删 $DSH_HOME/storages/calibration.json
重开应用

License

MIT

YokosWY/dsh-calibration-tier

dsh-calibration-tier

同框四模式：思考 / 循环 / 对抗 / 检索

状态模型（每个对话各用各的）

安装

工作原理

安全边界

测试

给使用者的说明

工作方式（项目内约定）

配套技能

数据安全

已知边界

踩过的坑（别重犯）

卸载

License

Community comments

YokosWY/dsh-calibration-tier

dsh-calibration-tier

同框四模式：思考 / 循环 / 对抗 / 检索

状态模型（每个对话各用各的）

安装

工作原理

安全边界

测试

给使用者的说明

工作方式（项目内约定）

配套技能

数据安全

已知边界

踩过的坑（别重犯）

卸载

License

Community comments