WTStarMark/DSH-QAQ

README 摘要

QAQ — DeepSeek Harness 启动容灾守卫 English 当 profile 配置损坏导致 DeepSeek Harness（下称 DSH）无法正常启动（宿主崩溃 或 Web UI 红屏）时，QAQ 自动回溯到「上一次成功启动」的配置快照并重启，同时保留被回退的坏配置便于手动还原。 作者 ：WTStarMark 不侵入 DSH 源码 ：守卫是独立可执行，只通过 spawn 进程 + CDP 读浏览器真实 DOM；备份插件只读配置不改行为。 它解决什么 DSH Web 存在一种「宿主活、UI 红屏」的失败模式：宿主进程正常、端口可达，但浏览器渲染出 Failed to load plugins 。这类失败纯监听宿主进程抓不到、纯 curl 抓空 root 也测不到（服务端 HTML 里 是空的，由 React 运行时渲染）。唯一可靠且不侵入的手段，是用 headless 浏览器打开页面、读取真实 DOM。QAQ 的 UI 侦测线正是这么做。 环境要求 - Node.js = 22 - 机器上有 Chrome/Chromium/Edge（经 CDP 无头驱动；无 Playwright/Puppeteer 依赖） - dsh 在 PATH ，或用 QAQ DSH CMD / --cwd 指定 DSH 启动命令与工作目录 安装 / 快速上手 一条命令 ： qaq setup 安装依赖并构建，然后 qaq tui 打开全屏实时守卫仪表盘。 手动安装： 日常使用推荐 qaq tui （全屏实时仪表盘，全能入口：一键启动守卫、浏览日志、管理插件、热更新、侧载 watch 都在里面）： 不想用仪表盘时，也可以直接单次受监督启动： 也可以用浏览器 Web GUI： qaq web （默认 http://127.0.0.1:3090 ）——与 DSH Web GUI 视觉统一（浅色/深色主题），可启动/停止守卫、备份/还原、插件管理、日志、热更新、版本检测。 用哪个 dsh 启动？ 守卫默认执行 dsh web （PATH 解析）。若要从 DSH 源码树启动： 启动前自检 ： qaq dsh web （和控制台）会自动发现 dsh 命令—— QAQ DSH CMD → --cwd → 就近的 DSH checkout（当前目录的祖先链，以及 与当前目录并排的兄弟 checkout ，如 QAQ 与 deepseek-harness 同目录并列）→ PATH ——挑选 Chrome/Chromium/Edge 作为 UI 探测浏览器、确认目标端口空闲。发现问题会在拉起任何进程前给出中文可操作提示。 命令面 命令 作用 qaq dsh web [--port N] [--yes] 接管启动：侦测 host/UI 失败 - 计数 - 触发时回滚 - 重启（带防死循环…

分类