Codex 运行记录 zehuan-huang/dsh-codex-runs

dsh-codex-runs

一个自包含的 DSH Web 插件：把 Codex CLI 自己的 rollout 会话文件渲染成右上角的只读运行记录面板。

- 数据源：~/.codex/sessions/<YYYY>/<MM>//rollout-<时间>-<sessionUuid>.jsonl
- 只读路由：GET /api/codex-runs
- 不改任何 Codex 文件、不写状态文件、不依赖任何第三方补丁

安装

dsh plugin --profile web add /path/to/dsh-codex-runs
确认 profile 的 dsh.profile.bundles 里出现 "dsh-codex-runs"，然后重启 dsh web

面板

标题 Codex 运行记录 (N)，右上角固定，10s 轮询，折叠状态存
localStorage["dsh-codex-runs:open"]。

每行：HH:MM · <cwd basename> · ●done / ◐running / ✕aborted / ?unknown · 耗时

展开后：sessionId（可复制）、model、cwd 全路径、totalTokens、lastMessage 全文。

数据是怎么读的

一个 rollout 文件就是一个 run。为了一次读多份又不把多 MB 的文件整个拉进内存：

| 读取 | 大小 | 用途 |
| head | 4 KB，按行边界自动增长到能读完 session_meta（实测该行约 22 KB），必要时向前探测，上限 256 KB | sessionId / cwd / 起始时间（session_meta）、model（turn_context） |
| tail | 64 KB | task_started / task_complete / turn_aborted、累计 token（info.total_token_usage.total_tokens）、最后一条 assistant 消息 |

只扫描 mtime 在最近 7 天内的文件，最多 200 个；返回按 startedAt 倒序的 50 条。
解析结果按 (path, size, mtimeMs) 缓存，所以 10s 一次的轮询只在文件真的变长时才重读。

status 判定：最后一个事件是 task_complete → done；turn_aborted → aborted；只有 task_started 时，文件仍在新写入（5 分钟内）→ running，否则 aborted；读到的窗口里没有任何回合事件 → unknown。

durationMs = endedAt - startedAt（整段会话跨度，包含多轮之间的空闲时间）；running 时由前端用当前时间算实时耗时。

路由响应

{ "ok": true, "runs": [{ "id": "…", "cwd": "…", "model": "gpt-6.1-sol", "startedAt": "…", "endedAt": "…", "status": "done", "durationMs": 5480, "lastMessage": "…", "totalTokens": 21413, "rolloutPath": "…" }], "rootMissing": false, "scannedFiles": 10, "matchedFiles": 10, "generatedAt": "…" }

任何异常都返回 { "ok": false, "error": { "name", "message", "code"? } }，日志里只有条数与错误码，不含 rollout 内容。

信任模型：只接受同源 GET。回环调用（面板自己）直接放行；其它来源必须由宿主的 connection 服务放行（Host/Origin 围栏 + 已认证的浏览器会话），围栏不可用时一律 403。

License

MIT