崩溃监视(crash-watch)
为什么存在
桌面上的崩溃是看不见的。一个程序被信号打死,窗口直接消失;内核或服务段错误,
只在 journalctl 里留下几行,用户不会去看。等到有人想起去查,现场已经被重启、
日志滚屏、升级覆盖掉了。
崩溃监视解决的是「现场留存」,不是「修复」。它在崩溃发生的那一刻就把证据写成文本, 放进一个可以事后翻阅、也可以交给 agent 的目录。这一步不需要模型参与, 因此捕获本身不花任何 token。
抓完证据就停下。只有用户在通知里显式选了一个动作,才会有一个 agent 被唤起。
职责边界
| 负责 | 具体内容 |
|---|---|
| 捕获 | 监视 systemd-coredump 的新条目,记录崩溃的程序、信号、时间与 dumpRef |
| 初筛 | 判断这次崩溃是否值得进队列,抑制重复与已知噪声 |
| 写工作区 | 把文本证据写进调试工作区,维护索引与待办队列 |
| 通知 | 用 notify-send 发出带动作按钮的通知,把「要不要看」交给用户 |
| 不负责 | 原因 |
|---|---|
| 自动修复 | 崩溃大多需要人判断;自动改配置会把一次崩溃变成一次事故 |
| 自动唤起 agent | 捕获与诊断解耦,没有用户动作就不消耗算力,也不产生误改 |
| 拥有系统配置 | 配置的读写入口属于 linxira-config,崩溃监视只读它的诊断信息 |
| 保存 core dump | 转储体留在 systemd-coredump 里,工作区只保存引用(dumpRef) |
工作区
工作区默认在 ~/Linxira/debug,可通过配置项 [workspace].path 更改。
它是一个 git 仓库,且只存放文本:索引、队列、日志摘录、命令输出。
二进制与 core dump 不进工作区,所以仓库可以放心提交、对比、回溯。
| 路径 | 作用 |
|---|---|
INDEX.md |
人读的崩溃索引,按时间排列,指向各批次的证据 |
backlog.json |
机器可读的待处理队列 |
mute.json |
按程序的静音规则 |
batches/ |
按批次组织的证据文件,一批一次崩溃事件 |
.agents/skills/<name>/SKILL.md |
工作区自带的技能,gitignored(属工具,不是证据) |
.zeta/sessions/ |
agent 会话记录;不是崩溃证据,但未被 .gitignore 忽略 |
gitignore 掉 .agents/skills/ 是有意为之:技能是工具配置,
不属于「这次崩溃发生了什么」的记录。.zeta/sessions/ 目前不在忽略列表里,
提交工作区前要自己确认没有把会话记录带进去。工作区第一次被创建时会执行 git init,
并补齐 INDEX.md、backlog.json、mute.json 与 .gitignore。
配置文件是 ~/.config/linxira/crash-watch.toml:
[workspace]
path = "~/Linxira/debug"
[triage]
timeout = "6h"
repeat_threshold = 3
[escalate]
driver_related = true
[lane.unattended]
enabled = false
schedule = "04:00"
tools = "read,grep,glob,lsp"
怎么用
后台捕获由用户服务 linxira-crash-watch.service 承担,preset 在首次登录时启用;
它运行 linxira-crash daemon --interval 60。日常操作都在同一个 CLI 里:
linxira-crash status # 工作区、超时、无人值守开关、事件计数
linxira-crash list --state pending # 按状态列出事件
linxira-crash pin <id> # 只进 backlog,0 token
linxira-crash ignore <id> # 忽略,可加 --reason
linxira-crash restore <id> # 撤销分流,回到 pending
linxira-crash mute <program> # 按程序静音(--list / --off <program>)
linxira-crash investigate <id> # 启动 zetacode(会花 token)
linxira-crash investigate <id> --dry-run # 只打印将要执行的命令
应用菜单的「Linxira Crash Watch」执行 linxira-crash status。status、list、
pin、ignore、restore、mute 都不花 token,也可以离线使用;
只有 investigate 会启动 agent。
三条 lane
崩溃监视不自己写 agent 的调用逻辑,而是把三种入口固定成三条 lane。
三条 lane 都以同一个工作区为 --cwd,区别只在于会话形态与工具权限。
只有交互 lane 接在通知与 linxira-crash investigate 上;另外两条是固定的命令形状,
需要时手动执行:
| lane | 命令 | 用途 |
|---|---|---|
| 交互 | zetacode --cwd <ws> --session-dir <ws>/.zeta/sessions "<PROMPT> @<evidence>" |
用户在场,边看边问;会话落在工作区里,可续 |
| 批处理 | zetacode --cwd <ws> -p "<PROMPT>" |
打印模式,一次给目标,跑完即止,用于成批整理证据 |
| 无人值守 | zetacode --cwd <ws> -p --tools=read,grep,glob,lsp "<PROMPT>" |
无人值守形状,工具集只读:读、搜、glob、LSP 查询 |
crash-watch 源码里的批处理 lane 写的是 --goal,但当前 Zetacode CLI 没有这个开关;
本页因此给出可用的 -p 打印模式。无人值守 lane 默认关闭,由 [lane.unattended].enabled 控制;即便开启,它的
--tools 也只给 read、grep、glob、lsp,没有编辑与执行——产物是结论,不是补丁。
当前版本没有调度器会自己启动这条 lane:通知和 investigate 走的都是交互 lane。
schedule 键会被读取,但不会触发运行。
技能
工作区里随崩溃监视一起物化的技能只有一个:diagnose-crash,
落在 <ws>/.agents/skills/diagnose-crash/SKILL.md。它是这个子系统的诊断流程说明,
内容随 crash-watch 的版本一起发布,不由用户手写。
当前版本不再把 linxira-config 技能复制进工作区。
系统级技能留在系统位置,工作区只放与这个子系统相关的那一个:
- 系统技能:
/usr/share/linxira/agent/skills/<name>/SKILL.md(目前只有linxira-config,由linxira-config-hub的 PKGBUILD 安装) - 配套清单:
/usr/share/linxira/agent/capabilities.json
技能的作用域、安装方式与 linxira-skills CLI 见 Agent 技能。
工作区本身是什么、为什么按子系统划分见 Agent 工作区。
交互
通知用 notify-send 发出,带四个固定动作:调查、复制提示词、固定、静音。
在用户点下按钮之前,什么都不会运行——没有后台 agent,没有预先写好的补丁。
静音是按程序的:mute.json 里记录的是程序名,不是这次崩溃。
一个已知会崩的第三方程序被静音后,它的新崩溃不再弹通知,
但记录仍按策略写入工作区,需要时还能翻出来。
何时需要 root
从不需要。 捕获端是无特权用户服务:NoNewPrivileges、ProtectHome=read-only、
只允许 AF_UNIX 地址族,可写路径只有 %h/Linxira 与 %h/.local/state/linxira-crash-watch。
linxira-crash的全部子命令都以当前用户运行;investigate也是以当前用户启动zetacode,工作区在用户主目录里。- 原始 core dump 留在
systemd-coredump的存储里,工作区只保存引用;抓取不需要读 root 文件,也不需要journalctl提权。 - 没有任何上传:分析纯本地,不联网、不自动向上游报 bug。
已知限制
- 只捕获
systemd-coredump的新条目;没有经过 coredump 的崩溃(例如被 OOM killer 直接杀掉的进程)不会出现在队列里。 - 通知依赖
notify-send;没有通知守护进程时通知退化为空操作,捕获与分流照常进行。 - 静音按程序名记录在
mute.json,不是按单次崩溃;被静音的后续崩溃仍按策略写入工作区。 - 自动分流只在超时后改变状态,永不唤醒 agent;每条决策可用
restore撤销。 - 无人值守 lane 不会自动运行(见上),
schedule目前只是配置字段。 - 工作区只存文本;core dump 本体不会被复制进来,事后复查需要
dumpRef指向的原始转储仍在。 .zeta/sessions/不在.gitignore里;提交工作区前要确认没有把 agent 会话记录一起提交。
深入设计
崩溃分类、队列推进、批次布局与 dumpRef 的解析规则见
crash-watch-design.md。
| 项目 | 仓库 |
|---|---|
| 崩溃监视 | linxira-crash-watch |