WTStarMark/DSH-QAQ--packages-dsh-qaq4

dsh-qaq

QAQ backup plugin: snapshots the profile's startup config to ~/.dsh/.qaq once the host boot settles. Backup-only; does not detect failure, roll back, or alter DSH behavior.

包名
dsh-qaq
版本
0.4.5
许可证
MIT
最近更新
2026年8月21日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:WTStarMark/DSH-QAQ#779d5e6696e24c4199f9b1ea73a2bf4bf1da2ff4&path:packages/dsh-qaq

首次配置(Windows)

  1. 安装 — 运行 qaq setup。它会检查 Node.js >= 22、安装依赖(pnpm,失败时回退 npx)、并构建 dist/qaq.mjs
  2. 挂载备份插件(推荐) — 打开 qaq tui(仪表盘打开时会自动挂载 dsh-qaq;若需手动重挂/覆盖更新,用菜单 [6])。它把 dsh-qaq 加进 profile 的 bundle 列表,并在 profile 的 node_modules 里建好模块链接。此后插件会在一次真实用户对话发生后自动把配置快照到 ~/.dsh/.qaq——因为只有人类真的发过消息才能证明这套配置可用(宿主 settle 但 Web UI 红屏的坏配置永远不会被记为 good,见下方"可疑 last-good")。仅备份、绝不改 DSH 行为。profile 自己的 cordis.patch.yml 故意不动——DSH 会从 bundle 声明自动加载插件的 patch 层。
  3. 启动 — 在 TUI 菜单按 1 一键启动守卫。仪表盘会重新做启动前自检(dsh 命令、浏览器、端口),然后接管 dsh web。UI 稳定通过确认窗口后,配置被记为 last-good,守卫转入后台持续监控(随时可退出菜单,守卫继续运行)。
  4. 验证qaq statushostFailures / uiFailures 应为 0,且存在 lastSuccess / lastGoodSnapshot

日常使用

  • 每次都用同一方式启动 DSH:qaq tui → 按 1。之后尽量不要再直接跑 dsh web——守卫是唯一能发现红屏的监督者。
  • 若 UI 连续红屏(或宿主崩溃)3 次,QAQ 会给出回滚确认(带 diff 预览)。接受即可——坏配置会保留在 ~/.dsh/.qaq/rolled-back/ 供事后检查,守卫会自动重启一次。
  • 回滚 + 重启成功后,失败计数清零、防死循环栅栏解除;恢复的配置就是坏掉之前的那份。