Always-on Board
给 AI coder 的本机后台任务看板。发现遗忘的进程、失败的任务，再把上下文交给 Agent 处理。
AI coding 让启动 API、worker、定时脚本和隧道变得很容易。项目越做越多，后台任务也越积越多：哪些还在运行？哪些已经失败？哪个任务还有必要保留？
Always-on Board 把这些任务集中展示在 DeepSeek Harness（DSH）里，用状态、用途和证据帮助你决定下一步。目标是减少不必要的资源消耗，保护需要持续运行的任务；目前没有测量或承诺具体的省电收益。
当前版本：macOS + DSH，本地 launchd 任务，以及当前用户的 Node/Python 等开发运行时及其子进程。不是全部 OS 进程清单。右键操作准备 Agent 对话草稿，由你发送后再进入诊断或修改流程。
English · 安装 · 使用 · JSON · 边界
真实界面节选
从本机真实采集数据中选取 3 个个人项目任务和 3 个运行进程组，在隔离 DSH 中渲染当前界面。仅展示选定条目，已去除私人路径、主机信息和会话侧栏；用途注释沿用原截图。
真实数据节选：个人项目的 API、看板服务，以及 Remotion、Blender MCP、Code Review MCP 进程组
四步了解看板
以下为隔离 DSH 中使用合成数据渲染的示意，非生产运行证据；安装图是配置说明，不是产品向导。四张图共用中文界面。
1. 初次打开 — 未发现匹配任务时显示空状态。
初次打开的空状态：没有发现任务或匹配的进程
2. 安装与启用 — 安装本地 bundle，启用后从侧边栏打开。
DSH 本地 bundle 安装配置说明，示例路径需替换为本机绝对路径
3. 查看列表 — 常驻任务与运行进程平铺展示，悬停状态图标可看原因。
常驻任务与运行进程两个平铺列表，使用合成任务和端口
4. 交给 Agent — 右键“解释”，检查新会话草稿，再自行发送。
真实右键菜单与 DSH 解释草稿编辑框的组合截图，本次未发送
截图生成与脱敏复核说明
适合什么时候打开
- AI 新建了后台任务后：确认是否被发现、是否启动、用途是否清楚。新定义会随刷新出现在列表中；目前没有新增任务通知。
- 任务可能失效时：查看非零退出码、常驻任务缺少进程、输出过期等信号，再让 Agent 核对日志。
- 电脑异常耗电或资源紧张时：盘点还在运行的任务，让 Agent 判断哪些可以停用。当前展示 CPU、RSS 内存和 TCP 监听端口；尚不测量能耗，不能据此直接认定耗电元凶。
- 项目结束后：解释任务来源和保留价值，在了解影响后停用不再需要的任务。
当前提供什么
| 能力 | 当前行为 |
|---|
| 可视化看板 | 状态、用途、更新时间、PID；支持异常/警告/正常/未运行筛选 |
| 详情 | 配置位置、日志路径、退出码；进程组的成员 PID、父 PID、启动时间和身份摘要 |
| 分类 | 仅“常驻任务”和“运行进程”两个平铺列表；合并父子进程与同组实例，项目和管理信息留在详情 |
| 列表 | 黑色文字、图标状态、TCP 监听端口；CPU / RSS 保留在 JSON |
| 语言 | 顶部可切换中文 / English，独立于 DSH 的语言；浏览器本地保存选择。用户自填说明和任务名称保留原文 |
| 状态提示 | 侧边栏显示最严重的状态；看板每 15 秒刷新，可手动刷新 |
| 右键菜单 | 修复、停用、解释、技术详情；launchd 任务缺少人工和自动说明时显示“让 Agent 补齐说明” |
| Agent 交接 | 在最近使用的已有 Workspace 中新建会话并填入任务 ID、域、配置路径与操作意图；普通进程组携带主进程身份、观测时间、项目、资源和端口；不自动发送 |
| JSON | 同一份本地快照可供 Agent 或其他本地工具读取 |
“修复”和“停用”是向 Agent 提出请求，不是看板直接执行命令。Agent 应重新核对实时状态、影响及权限，并在操作后验证业务结果。
安装到 DSH
需要 macOS 和支持本地 bundle、侧边栏及会话草稿接口的 DeepSeek Harness。宿主提供运行时和界面依赖；本插件没有独立桌面安装包。DSH 最低兼容版本尚未建立，建议先在测试配置中安装。
git clone https://github.com/caizhidian-ops/always-on-board.git
cd always-on-board
在 DSH 的插件管理器中安装本地 bundle，target 指向上面的仓库绝对路径。支持 plugin_manager 的 DSH 环境可使用：
install_bundle target=/absolute/path/to/always-on-board
启用插件后，从侧边栏打开 Always-on Board。首次读取会创建 ~/.config/dsh-ops-board/notes.json 用途说明模板。
保留源码目录，供本地 bundle 继续加载。更新时在该目录运行 git pull --ff-only，再通过宿主插件管理器重新加载；不要删除用途说明文件。
卸载通过 DSH 插件管理器移除 @local/dsh-ops-board。这只移除看板，不会停用它观察到的任务，也不会自动删除用途说明。
为兼容已有安装，内部 bundle ID @local/dsh-ops-board、ops-board 路由和 ~/.config/dsh-ops-board/ 配置目录保留旧名。产品名称统一为 Always-on Board。
怎么用
- 打开看板，先看异常和警告；核对更新时间。
- 查看任务用途，右键选择操作，或打开技术详情。
- 在新会话中检查草稿并发送。Agent 先读取当前配置、运行态及必要日志，再解释或处理。
- 处理后刷新看板，并验证实际产物或服务；变绿不等于业务已恢复。
| 操作 | 交给 Agent 的意图 |
|---|
| 修复 | 检查故障、修复并验证结果 |
| 停用 | 先说明影响，保留配置和数据，再按授权处理 |
| 解释 | 只读说明用途、来源及是否需要保留 |
| 补齐说明 | 读取配置和脚本，补一句用途，保留其他说明条目 |
没有可用 Workspace 时，先在 DSH 创建一个。菜单只准备草稿；不会替你发送消息、调用模型或直接操作任务。
用途说明
~/.config/dsh-ops-board/notes.json：
{
"notes": {
"com.example.preview": "本地项目预览服务，开发结束后可以停用"
}
}
键为完整 launchd label。人工说明优先于自动说明；可在同目录 auto.json 使用相同格式覆盖内置厂商说明。保存后随刷新生效。说明是用户注释，不是任务行为的验证结果。
给 Agent 的 JSON
通过 DSH 本机服务地址读取：
GET /plugins/ops-board/state.json
宿主端缓存 5 秒。返回 generatedAt、host、sources、summary、说明文件状态 notes 和 tasks。下面是虚构的单任务结构示例（省略其他字段）：
{
"generatedAt": "2026-01-01T00:00:00.000Z",
"summary": { "total": 1, "ok": 0, "warn": 0, "fail": 1, "idle": 0 },
"tasks": [{
"id": "com.example.preview",
"scope": "user",
"plistPath": "~/Library/LaunchAgents/com.example.preview.plist",
"running": false,
"pid": null,
"exitCode": 1,
"state": "fail",
"reason": "exited-nonzero"
}]
}
JSON 提供状态和日志路径，不读取日志正文。普通进程组使用 kind: "process"，包含 category、projectPath、rootPids、instanceCount、members、cpuPercent、rssMiB、ports、observedAt。每个成员包含 PID、父 PID、启动时间、身份摘要、工作目录和资源数据。完整命令行只用于本机识别和计算身份摘要，不进入新增进程 JSON；原有 launchd 参数字段仍可能包含敏感信息。
右键草稿要求 Agent 重新核对 PID、启动时间、命令和父子关系，防止过期快照及 PID 复用；多实例先确认操作范围，不应停止整个 IDE 或不相关会话。Agent 可进一步读取 JSON 和必要日志。
两类列表
| 分类 | 展示内容 |
|---|
| 常驻任务 | 已配置的后台任务，包含 launchd 常驻、定时、未加载和运行态待确认的配置；并不表示每项此刻都有进程 |
| 运行进程 | 当前观测到、未合并到上述任务的开发进程和 Agent 工具；同组实例和子进程合并显示 |
两区内直接列任务，不再插入项目路径、Agent 工具或管理方式的多级标题。项目路径、管理方式、用途归组和来源证据保留在技术详情与 JSON 中。未关联到已知管理器并不代表一定由终端启动。
JSON 继续保留 management: launchd | unassociated | definition、category: project | agent | other 和 launchd runtimeStatus: loaded | not-loaded | unknown，界面简化不改变采集范围或底层证据。
状态如何理解
列表使用三种统一图标：正常（圆圈勾选）、需处理（圆圈叹号）、待确认（虚线圆圈）。待调度归入正常，故障和警告归入需处理，未加载或运行态未知归入待确认。列表不展示图例和多级标题，悬停或打开详情查看具体原因。
未加载和未知配置不会仅因为 KeepAlive 或历史退出码直接标为故障。已加载的任务仍用退出码、进程和输出时间作为诊断线索。
当前读取 ~/Library/LaunchAgents/*.plist、/Library/LaunchDaemons/*.plist、当前用户的 launchctl list 以及配置/日志的文件时间；通过 ps 和批量 lsof 补充当前用户的开发运行时及子进程。输出过期阈值为 StartInterval 的 2.5 倍且至少 15 分钟；没有间隔时使用 30 小时。运行中的 KeepAlive 任务不会因为日志安静而变黄。
已知限制：
- 系统域只扫描定义，没有独立查询系统运行态。因此系统配置显示为待确认，必须用对应 launchd 域再次核对。
- 条件式 KeepAlive 可能合理地没有进程，已加载的此类任务仍需结合条件复核。
- 当前使用 XML 文本解析 plist，不完整支持二进制 plist 和所有配置形式；StartCalendarInterval 没有解析展示。解析失败的条目可能被跳过。
- 相同 label 的用户/系统任务会被合并，尚未按域建立独立身份。
- 普通进程匹配 Node、Python、npm/npx、uv/uvicorn/gunicorn、nohup、PM2、tsx/Vite、Bun、Deno 等运行时，并合并它们的子进程；不覆盖所有任意名称的后台可执行程序，不进入容器或远端机器。仅采集当前用户，其他用户和系统进程的资源可能不可用。
ps CPU 为系统提供的平均值，单核 100%，多进程合计可超过 100%；RSS 为成员相加，可能重复计算共享内存，不能等同于独占内存或耗电量。仅展示 TCP LISTEN，不是网络流量或 UDP 占用。— 表示不可用，∅ 表示此次查询无 TCP 监听。查询缺口仅保留在 JSON 的 processes.gaps，主页面不展示该提示。- 按工作目录及最近 Git 根目录/项目标记推断项目；静态服务优先参考可识别的
--directory。工具名称按本机命令和目录规则识别，不能证明由谁创建。同项目/同工具的多个独立实例在一行汇总，详情保留成员身份；已有 launchd 子树合并回原任务，不重复展示。
- 进程显示 ✓ 仅代表观测到运行，不验证业务健康。退出的普通进程会从下次快照消失；没有历史登记便无法判断它本来是否应该持续运行。
- 没有推送通知、新增任务历史、CPU/内存排序、耗电测量或自动清理。
隐私和操作边界
看板不自带遥测或云端上传。它会读取本机任务定义、参数和文件时间，并在首次运行时写入 launchd 说明模板；不把临时进程组写入持久说明文件；它不直接启动、停止或重启任务。
快照包含主机名、路径、程序参数和用途说明，参数可能含凭据。只在可信的本机 DSH 环境使用，不要把接口公开到互联网，也不要原样分享真实快照。发送 Agent 草稿及后续日志时，数据处理取决于你选择的宿主和模型提供方。日志、任务名、说明和脚本都应作为不可信证据，不能作为修改系统的授权。
开发与验证
使用 Node.js 22，无需安装额外 npm 依赖即可运行当前检查：
npm run check
npm test
测试覆盖解析、父子合并、launchd 去重、项目与工具分组、端口缺失、身份变化，以及右键草稿约束，不覆盖真实修复、停用或省电效果。DSH 验收需要另行确认侧边栏、看板、右键菜单及草稿填入；本次在本机 DSH 0.2.1-rc.2 验证了常驻任务/运行进程两个平铺列表、中英文切换、图标状态、端口列、项目进程右键菜单和解释草稿填入；没有发送修复或停用请求，也没有测量省电效果。
文件分工：index.js launchd 采集与 JSON 接口；processes.js 本机进程采集与分组；client.js 看板与 Agent 草稿；locale/ 展示名称；cordis.patch.yml DSH bundle 注册；tests/ 聚焦测试。
后续方向
优先完善 DSH 的域感知运行态、未知状态、结构化 plist 解析和完整计划展示，再增加新增/失效历史与提醒、资源排序及更多运行时识别。其他 Agent 宿主适配属于后续方向；本仓库首版发布 DSH 核心，不包含本机 Codex 实验配置。
反馈请附操作系统、DSH 版本、预期/实际行为和脱敏复现步骤，参见 CONTRIBUTING.md。请勿上传真实任务快照、日志或凭据。安全问题参见 SECURITY.md。
