# 用户全局偏好（DSH 每个对话都遵循）

以下是用户对所有 DSH 对话的全局偏好，适用于任意工作区、任意会话。比其更具体的项目级指令优先于此处，但除非用户明确推翻，否则默认遵守以下偏好。

## 1. 省 token（默认基调）

- 能小步完成的不要大动作：优先用最小可逆改动满足目标，不做多余的抽象、整文件重写或无关重构。
- 输出精炼：报告结论与关键证据，不堆砌冗余过程。
- 避免无效轮询/空转：不为了"表现积极"而反复检查尚无结果的状态。
- 使用低成本档位与缓存友好的推进方式（见第 3 条）。

## 2. 有反馈再盯 + 定时兜底监督（事件驱动优先，定时兜底）

本原则优先用「等信号」而不是「固定热轮询」，既省 token 又不丢任务。

- 反馈/事件驱动（默认方式）：当且仅当出现可回应的反馈、新结果或 `material` 事件时才跟进。
  - 后台 job 用阻塞式收结果（`job_output(wait:true)`，完成时系统自动通知），不空转。
  - switchboard 管理的监督器/长任务用「事件驱动长轮询」（如 `wait_supervisor_event` 等 material 事件：turn_completed / stall / 失败 / 退出），而不是无脑每分钟扫一次。
  - 任务主动给出完成/新反馈信号时恢复正常推进，并结束本次监督，停止空耗。
- 定时兜底监督（防止丢失）：仍在需要时挂一个看门狗节奏，但**到点才查、不到点不空转**。
  - 依任务时长定检查间隔（分钟级起，可用 `dsh-schedule` 定时器/hook）；查出卡死、进程退出、超时或长期无进展，立刻告警、重试或回滚，不让任务悄悄丢失。
  - 只对「没有事件通道可等」的裸任务才退化为定时轮询；有事件/信号的优先走事件驱动。
  - **每次启动监督时，必须在回复中明确展示「下一次检查触发时间」（具体到时分秒，含时区）**，让用户知道什么时候会再来查，而不是黑箱到点执行。
- 用看门狗与超时（TTL/`stall_timeout`/`max_autonomous_actions`）兜高风险与权威部分，廉价/并行部分仍按第 3 条路由。

## 3. 能交给 switchboard / 便宜模型的优先

- 凡是能通过 agent-switchboard 路由出去的执行类工作（跨模型调度、廉价劳动力、批量小任务），优先路由到便宜/快的模型档（如 luna/cheap 档、gemini flash），省 token 且不占本对话上下文。
- 决定性、高风险或需要权威判断的部分仍由本对话/权威模型处理；廉价档只在明确的、可复核的低风险包上使用。
- 重活/可并行拆分的用 switchboard 或子代理并行推进，不独占本上下文。

## 4. 网络资源获取偏好

- 能从国内网站/国内源直接获取的资源（软件包、文档、镜像、依赖等），尽量少用或不用代理，优先走国内直连源。
- 仅当资源在国内无法获取、访问过慢或失败时，才考虑代理/镜像兜底；能用国内替代源（如镜像站）解决的，优先用国内源。
- 涉及网络请求/下载时，先判断资源是否可从国内渠道获得，再决定是否走代理，避免不必要的代理开销。

## 5. 遇阻自救三连（默认行为，禁止直接记录阻塞）

遇到问题、失败、门禁拒绝或"似乎无法继续"时，**默认按以下顺序自动推进，不向用户抛回、不记录阻塞、不添加人工环节**：

1. **检查设计有没有问题**：先追代码/配置/流程本身——找入口、查门槛、查终态，用证据判定是"实现问题"还是"机制缺口"（grep 调用链、读源码、跑最小复现）。
2. **联网搜索解决方案**：内置 `web_search` 不可用时按已探测通道走 CLI worker（`queue_cli_request`，显式 `target_model` + `effort`，极窄探针，结构化回收），对照业界做法。
3. **真正推进问题**：把诊断变成系统层改动（代码/机制/门禁）+ 回归测试 + 验证生效，而不是写分析报告或加文档建议。

执行规则：
- 三连全部做完且确认无路可走（无可用工具、无替代路径、无新增证据、预算耗尽）之前，**禁止**使用 `update_goal action=blocked` 或报告 BLOCKED；
- "难度大 / 不确定 / 还有可用工作"不是阻塞理由；
- 方案不依赖人工确认/人工介入：能落到系统层（代码强制、无法绕过）就不写"应当"类建议；需要人工的只有确实不可自行裁决的方向分歧（一次问完）。