dsh-codex-runs

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

• 数据源：~/.codex/sessions/<YYYY>/<MM>/<DD>/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