1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | session-viewer |
| 项目自述名称 | 无独立自述标题差异——agent-skills 仓库 README 中直接以 session-viewer 称呼该子技能，与正式名称一致 |
| 作者/维护者 | OpenClaw 官方组织（GitHub: openclaw）；该子技能主要贡献者为 steipete（6 次提交中的 5 次），另有 spboyer 参与 |
| 来源链接 | https://github.com/openclaw/agent-skills/tree/main/skills/session-viewer （所属合集仓库：openclaw/agent-skills，OpenClaw 官方“共享技能”公共源） |
| 许可证 | MIT（仓库级 LICENSE 文件确认，GitHub API 直接读取） |
| GitHub Stars / Forks | 合集仓库整体 882 / 55（GitHub API 直接确认，2026-07-13）；因属合集仓库，该数值不直接归属于本子技能，见第 6 章说明 |
| 最新版本 | 无独立版本号；该子技能最近一次提交为 2026-07-01（“fix: normalize session viewer metadata”），首次加入仓库时间为 2026-05-25 |
| 安装方式 | git clone 仓库后，对 Claude Code 执行 ln -sfn "$(pwd)/skills" ~/.claude/skills；对 Codex 执行等效软链到 ~/.codex/skills/agent-skills；也可用仓库自带 scripts/install-skills 一键安装全部或指定技能 |
2. 功能介绍与亮点
session-viewer 是一个将 Agent 会话日志（JSONL 格式）渲染为可搜索、可分享单文件 HTML 查看器的工具，核心能力：
- 多来源自动识别：自动检测并解析 Codex、Claude Code、OpenClaw/Pi 三种不同的会话日志格式，统一渲染为同一套查看界面。
- 单文件产出：渲染结果是一个独立 HTML 文件，内嵌规范化后的会话数据，无需额外依赖即可在浏览器中打开、搜索、分享。
- 可搜索归档：工具输入输出文本保留在 DOM 中，支持浏览器原生搜索；提供
--raw模式保留原始 JSONL 供前端自行解析，也提供--blank模式生成可反复使用的文件选择器查看器。 - 配套技能联动：与同仓库的
agent-transcript技能配合，可先按目标任务/分支自动定位最可能相关的会话文件，再交给session-viewer渲染。
主要亮点：
- 代码执行范围清晰可审计：核心脚本仅 136 行，唯一的进程调用（
spawn）用于在系统默认程序中打开生成的本地 HTML 文件（open/xdg-open/cmd start），未发现网络请求、无凭据读取、无eval。 - 持续维护：自 2026-05-25 加入仓库以来已有 6 次针对该子技能的提交，最近一次为 2026-07-01（本次运行 12 天前），涵盖搜索性能优化、渲染打磨、元数据规范化等迭代。
- 官方出品：所属仓库由 OpenClaw 官方组织维护，定位为“跨仓库复用 SKILL.md 的公共源”，而非个人业余项目。
3. 适用场景
所属固定分类：元技能与 Agent 增强
- 需要复盘、调试某次 Agent 会话（例如排查 Agent 为何做出某个决策、核对工具调用序列）的开发者。
- 希望把关键会话片段整理成可读报告分享给同事或用于 PR/Issue 说明的用户（可与
agent-transcript联动做敏感信息脱敏）。 - 同时使用 Claude Code、Codex、OpenClaw 等多种编码 Agent、需要一套统一工具查看不同格式会话日志的用户，无需为每种 Agent 单独找查看方案。
4. 跨 Agent 兼容性
| Agent | 结论 | 判断依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | SKILL.md 与仓库 README 均给出针对 ~/.claude/skills 的软链接安装步骤；脚本内置对 $HOME/.claude/projects 下 JSONL 会话文件的识别逻辑 |
| Codex | ✅ 原生支持 | README 给出针对 ~/.codex/skills 的软链接安装步骤；脚本内置对 ${CODEX_HOME}/sessions 下 rollout-*.jsonl 的识别逻辑 |
| OpenClaw | ✅ 原生支持 | 本身即 OpenClaw 官方仓库产出；脚本内置对 ${OPENCLAW_STATE_DIR}/agents/*/sessions 的识别逻辑，且默认支持 Pi/OpenClaw 会话格式 |
| Hermes Agent | ❓ 未验证 | SKILL.md 与仓库文档均未提及 Hermes Agent；未为此单独发起搜索，如实标注未验证 |
5. 推荐理由
绝大多数 Agent 技能推荐关注“帮 Agent 干活”，session-viewer 关注的是“帮人看懂 Agent 干了什么”——这是日常使用多种编码 Agent 时经常缺失的一环。它的核心价值在于：一次安装，覆盖 Claude Code / Codex / OpenClaw 三种日志格式，省去为不同 Agent 各自寻找日志查看工具的麻烦；渲染产物是零依赖的单文件 HTML，方便本地排查也方便分享给同事复盘；代码体量小、执行范围收窄到“打开本地文件”，审计成本低，适合对 Agent 行为留痕、复盘决策路径有需求的用户直接采用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 所属 openclaw/agent-skills 为 OpenClaw 官方组织维护的公共技能源；OpenClaw 主仓库（openclaw/openclaw）GitHub Stars 超 38 万，属该领域一线机构，符合“官方出品”档位。因本仓库属合集仓库，882 Stars 未直接计入本子技能评分，改以该子技能自身提交历史（6 次提交、2 名贡献者、持续 2 个月的迭代）作为独立热度佐证 |
| 可用性 | 8 | 针对 Claude Code 与 Codex 均给出明确的一条命令软链接安装步骤，另有 scripts/install-skills --list/--dry-run 辅助；文档（SKILL.md + 仓库 README）完整；最近维护距今 12 天。轻微扣分：脚本为原生 Node TypeScript，需要较新版本 Node 运行时支持 |
| 安全性 | 9 | 逐项核查：①代码执行范围仅限 spawn 调用系统默认程序打开本地生成的 HTML 文件，参数固定、无拼接外部输入；②抓取脚本全文未发现任何网络请求（fetch/http.request/axios 等均未命中）；③无需任何 API Key 或凭据；④ SKILL.md 与脚本内容均为常规操作指令，未见可疑注入；⑤作者为 OpenClaw 官方组织及具名贡献者（steipete 等），信誉良好；⑥ License 为 MIT，明确清晰；⑦最近一次维护为 12 天前，非弃置项目 |
| 综合评分 | 8.7 | 三项均值，高于 7.0 门槛；安全性 9 分，未触发一票否决 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 session-viewer 的差异 |
|---|---|---|
各 Agent 自带的原始 JSONL 日志/CLI --replay 类命令 |
官方内置的原始日志查阅方式 | 通常只支持单一 Agent 自身格式，且多为终端文本输出，不支持跨会话搜索或分享；session-viewer 统一多种格式并产出可搜索、可分享的 HTML |
| 各类通用日志可视化工具（如 Kibana、自建脚本） | 通用日志/事件可视化平台 | 需要额外部署与索引成本，非针对 Agent 会话（工具调用、推理片段等结构）专门设计；session-viewer 零部署、专为 Agent 会话结构定制渲染 |
同仓库 agent-transcript 技能 |
面向 GitHub PR/Issue 场景的会话脱敏与插入 | 二者互补而非竞争：agent-transcript 负责“脱敏后放进 PR/Issue”，session-viewer 负责“本地/浏览器里完整复盘”，可配合使用 |
核心差异化：session-viewer 是目前少见的、由 Agent 生态官方组织维护、同时覆盖三大主流编码 Agent 日志格式的统一查看工具，且以单文件 HTML 产出降低分享与归档门槛。
8. 用户评价
本次仅对该子技能的仓库提交历史完成亲自验证（见第 2、6 章），未检索到经亲自抓取确认的独立第三方用户评价（Reddit / Hacker News / X 等渠道均未发现专门讨论该技能的可验证帖子）。如实说明：本次未收集到足够的用户评价，不做凑数。
9. 其他补充
- 仓库文档提供英文说明；未见多语言版本。
- 仓库根目录
VISION.md说明了该公共技能源的“收录边界与准入原则”，社区可按此规范提交新技能或改进现有技能（PR 贡献）。 - 该子技能自 2026-05-25 加入仓库以来经历 6 次迭代提交，属于仓库内较新但打磨较充分的技能之一。
10. 安装使用方式
方式一：clone 仓库 + 软链接（推荐，便于跟随上游更新）
git clone https://github.com/openclaw/agent-skills.git
cd agent-skills
# Claude Code
mkdir -p ~/.claude
ln -sfn "$(pwd)/skills" ~/.claude/skills
# Codex
mkdir -p ~/.codex/skills
ln -sfn "$(pwd)/skills" ~/.codex/skills/agent-skills方式二：仓库自带安装脚本（可选择单独安装该技能）
scripts/install-skills --list # 查看所有可用技能
scripts/install-skills --dry-run # 预览安装，不改动文件
scripts/install-skills session-viewer # 仅安装 session-viewer使用：
node skills/session-viewer/scripts/session-viewer.ts <session.jsonl> --out /tmp/session.html --open注意事项：安装为软链接后无需重启 Agent 即可生效；触发方式为直接调用脚本，或在支持 Skill 自动发现的 Agent 中按技能描述自然语言触发（如“帮我看看刚才那次会话记录”）。
11. 注意事项
- 运行脚本依赖较新版本的原生 TypeScript 支持的 Node.js 运行时；过旧的 Node 版本可能无法直接执行
.ts脚本。 - Hermes Agent 兼容性未获验证，如需在该平台使用需自行测试。
- 该技能所属的
agent-skills仓库是一个包含agent-transcript、autoreview、behavior-validator、crabbox、handoff、session-viewer六个独立技能的合集仓库；本次评分与推荐仅针对session-viewer本身，其余技能未在本次评估范围内。 - 未发现已知的安全缺陷或异常行为，但建议按常规做法在首次使用前自行审阅脚本内容。