dsh-console-sentinel

自动隐藏（或关闭）Windows 上空闲的 AI/脚本控制台窗口 —— 一个 DeepSeek Harness 插件。

长时间运行的自动化工作流（Fluent 无人值守任务、批量脚本、WMI 拉起的脱离进程） 会在任务栏堆下一排 PowerShell/Python 黑窗口。你分不清哪些还在跑，也不敢随手关。 本插件替你追踪它们、区分「在忙」和「用完了」，并把用完的隐藏掉 —— 进程继续跑、 数据不丢，每个窗口都能随时叫回来。

工作原理

1. 每隔 scanIntervalSec 秒（默认 10）用零依赖的 Windows PowerShell 探针 （user32 + ntdll P/Invoke）枚举控制台窗口：CASCADIA_HOSTING_WINDOW_CLASS （Windows Terminal）、ConsoleWindowClass（传统 conhost）、 PseudoConsoleWindow（ConPTY 伪控制台）。
2. 按进程归类：优先看父进程（父进程是 WmiPrvSE.exe → wmi-detached， WMI 拉起的脱离任务，无人值守 Fluent 计算正是这样启动的；父进程是 DSH Desktop.exe → dsh-host；父进程已退出 → orphaned）。当父链说明 不了问题时（Windows Terminal 的窗口归属于 WindowsTerminal 进程，而不是 它里面跑的脚本），改看控制台标题：脚本启动的控制台标题默认是 被启动程序的路径（...\python.exe），而交互式手开的控制台是提示符式 标题（Windows PowerShell）→ 归为 script-console。
3. 每轮采样进程 CPU（累计 CPU 时间差值）。CPU 低于 cpuThresholdPct（默认 1%） 且持续 idleThresholdSec（默认 60 秒）即判定为用完了。单次采样的后台 CPU 抖动不会重置空闲时钟（spikeTolerance，默认 2）。
4. 在管理范围内的「用完了」窗口执行配置的 autoAction（默认 hide = SW_HIDE， 进程继续跑）。close 发送 WM_CLOSE。前台窗口永不自动处理（guardForeground）。

父进程 PID 用 NtQueryInformationProcess 而非 CIM（Get-CimInstance Win32_Process） —— 参考机上实测 39 秒 vs 24 毫秒（13 个进程）。单次完整探针约 350 毫秒。

安装

dsh plugin --profile <name> add dsh-console-sentinel

Bundle 插件（dsh.bundle.patch）：进入 profile bundle 栈，重启后生效。 仅限 Windows —— patch 行在其他平台 disabled，apply() 运行时也会再守一次。

工具（模型可见）

• console_windows_list —— 列出所有被追踪的控制台窗口及其空闲状态和来源归类。先用它。
• console_window_action —— 对单个窗口执行 hide / show / minimize / restore / close （用 hwnd 或 pid 定位）。hide 无损；close 可能丢失未保存输出。 对前台窗口操作需传 force。
• console_windows_sweep —— 一次性对所有空闲且在范围内的窗口执行动作 （跑完一批 Fluent 任务后清任务栏很好用）。
• desktop_windows_cleanup —— 一键关闭其他窗口：关闭桌面上除前台、自身、 系统外壳和受保护进程以外的所有应用窗口（dryRun 先出计划；protected / keepTitle / keepPid 可临时加固保护）。
• sentinel_whitelist —— 管理持久化豁免白名单：list / add / remove / reset， kind=process（按映像名，如 code.exe）或 kind=title（按标题子串）。 白名单同时作用于自动隐藏/关闭与一键关闭窗口，落盘到 ~/.dsh/console-sentinel/whitelist.json。

设置面板（DSH 设置页 · 0.3.0+）

插件在 DSH「设置」里注册「控制台哨兵」分区（客户端 bundle lib/client.js）， 不记工具名也能点操作：

• 概览：总窗口 / 空壳 PowerShell / 可见空壳 / 已隐藏 计数 + 「隐藏可见空壳」。
• 任务栏窗口清理：预演 / 一键关闭其他窗口（前台、系统进程、白名单自动跳过）。
• 控制台窗口：逐行显示进程名 / 标题 / hwnd / pid / CPU / 空闲秒数 / 子进程数，行内可隐藏 / 显示 / 关闭。
• 豁免白名单：进程名与标题关键字 标签式增删、清空，即时落盘。

面板通过宿主路由 /dsh-console-sentinel/* 取数（客户端 fetch 根相对路径，桌面端自动带 capability header），不使用 iframe。改 lib/client.js 后按 Ctrl+Shift+R 硬刷新； 改宿主（lib/index.js / package.json）需完全退出 DSH 再启动。

配置（cordis.yml）

键	默认值	含义
enabled	true	总开关
scanIntervalSec	10	扫描 + CPU 采样间隔
idleThresholdSec	60	持续低 CPU 多少秒算「用完了」
cpuThresholdPct	1	CPU 低于此值算空闲
autoAction	hide	none | hide | close
probeTimeoutMs	20000	探针硬超时
spikeTolerance	2	连续多少次「忙」采样才重置空闲时钟
guardForeground	true	永不自动处理前台窗口
scope.wmiDetached	true	管理 WMI 拉起的脱离控制台
scope.dshHost	true	管理宿主派生的控制台
scope.orphaned	false	管理父进程已退出的控制台
scope.scriptConsole	true	管理标题是脚本可执行文件路径的控制台（Windows Terminal 承载的脚本会话）
scope.excludeTitles	[]	标题 substring 黑名单
scope.emptyConsole	true	把「没有任何工作子进程」的解释器控制台（PowerShell/Python/cmd 只剩 conhost）判为空壳，无论父链如何都纳入管理 —— 这是安全清理残留空 PowerShell 的开关（不必打开整个 orphaned，后者会误伤 mpiexec/fl2610/在跑的计算）
emptyConsoleAction	hide	对空壳控制台的动作：none | hide | close；独立于 autoAction，即便自动动作关闭也能单独生效
whitelist.processes	[]	豁免进程映像名（如 code.exe），永不自动处理/一键关闭（运行时用 sentinel_whitelist 增删）
whitelist.titles	[]	豁免标题子串，永不自动处理/一键关闭

- id: dsh-console-sentinel
  config:
    idleThresholdSec: 90
    scope:
      excludeTitles:
        - keep-alive

安全性

hide 只调用 ShowWindow(SW_HIDE) —— 进程、日志、输出一概不动； console_window_action 的 show 可随时恢复（用 SW_SHOWNORMAL —— 实测 SW_SHOW 无法恢复被隐藏的 Windows Terminal 窗口）。close 发 WM_CLOSE （优雅关闭，和你点 X 一样），但可能丢失未保存状态，所以从不是默认动作。 自动动作绝不触碰：前台窗口、手动打开的控制台（manual 来源）、 标题命中黑名单或白名单的窗口、以及 HARD_PROTECTED_PROCESSES 里的系统/计算进程 （explorer、taskmgr、dsh desktop、fl2610/cx2610/mpiexec/smpd/fluent 等）。 每个动作都发 console-sentinel/action 事件并写日志。

开发

lib/index.js   Cordis 插件：配置、扫描调度、工具
lib/logic.js   纯台账/空闲状态机（单测覆盖）
lib/probe.js   内嵌 PowerShell 探针 + 窗口动作
tests/         仅 node 的回归测试，不需要真实 Windows

node tests/logic.test.mjs —— 24 项断言，覆盖来源归类、空闲累积、 忙碌脉冲重置、范围守卫、台账 GC、排序。

MIT License。