ClaudeMap

harness-profiler

经 hooks 记录每次 skill、subagent 与工具调用的 Claude Code 插件,给你一个剖析器视角——带耗时的调用树、上下文的 UML 式时序图、逐上下文的 token 成本

SDK 与工具profilerhooksobservabilityplugintokens

harness-profiler 展示一套非平凡 Claude Code(或 Codex,暂不支持)配置——skill、subagent、记忆文件——底层实际做了什么。它只记录 Claude Code 自己经 hooks 上报的内容(每次工具调用后、subagent 停止、会话开始、压缩前后),每个事件追加一行 JSON 到 git 根的 .harness-profile/<session-id>.jsonl;首次写入会把该目录加进 .git/info/exclude,trace 不会进提交。tree 命令把会话变成剖析器视图:每个 skill 或 subagent 调用一行,含 UTC 开始时间、平方根比例的时长条、该上下文花费的 token(新输入、缓存输入、输出),--verbose 展开每条工具调用;--format html 把同一数据渲染成 UML 时序图——每根竖条是一个上下文,颜色区分全新上下文与 fork。/show-profile 在会话内发布 trace(网页会话发布为私密 claude.ai artifact,本机则打开浏览器)。安装路径:CLI 会话走 /plugin marketplace add afurmanov/harness-profiler 加 /plugin install;云会话走 npx -y github:afurmanov/harness-profiler init claude 提交 hook 进 .claude/,本机会话随即开始记录;doctor 报告哪个 Node 跑 hook、提交的副本是否过期。整个工具是一个零依赖文件加一个启动器与页面模板;hook 异步运行且恒退出 0,trace 坏掉也不影响会话。token 取自 ~/.claude/projects/ 下的会话转录;除非在云会话里运行 /show-profile,数据不出本机。Codex 暂不支持——README 逐条写明其 hooks 能与不能看到什么。

它做什么

  • agent harness 的剖析器视角:调用树带 UTC 时间、平方根比例时长条、逐上下文 token 列(新 / 缓存 / 输出),数据直接来自 Claude Code 的转录
  • UML 式时序图(--format html):每根竖条是一个上下文——subagent 与 context:fork skill 有专属颜色;内联 skill 以菱形出现在调用者内
  • 低打扰记录:hook 向 .harness-profile/<session-id>.jsonl 追加 JSON 行、异步运行、恒退出 0,目录自动进 .git/info/exclude,trace 不进提交
  • 两条安装路径:CLI 会话走插件市场;云会话用 npx ... init claude 把 hook 提交进仓库;doctor 校验 Node、hook 与过期副本
  • /show-profile 在会话内发布(网页会话为私密 claude.ai artifact,本机开浏览器);CLI tree 支持会话前缀、--branch 与 --verbose

什么时候用

适合组合式配置(编排 skill、校验器、fork 上下文)变慢、变贵或行为不符预期,需要看清哪个 skill 在哪个上下文里跑、花了多少 token。只跑单会话提示词就用不上——没有多少结构可剖析。

如何上手

Claude Code CLI:

/plugin marketplace add afurmanov/harness-profiler
/plugin install harness-profiler@harness-profiler
运行 /reload-plugins,或开新会话

Claude Code 网页版(改为提交 hook):

npx -y github:afurmanov/harness-profiler init claude
git add .claude/harness-profiler .claude/skills/show-profile .claude/settings.json && git commit -m "Record tool calls with harness-profiler"

在你工作的仓库里自检:

npx -y github:afurmanov/harness-profiler doctor

最近一个会话的文本树:

npx -y github:afurmanov/harness-profiler tree

需 Node 18+ 与 git(未上 npm;npx 直接从 GitHub 运行)。

注意事项

trace 记录 token 数量而非内容,转录格式无文档——若格式变更,token 数字会直接消失而非出错。内联 skill 的开销并入调用者、无法拆分;经 Bash 完成的文件读写(cat、sed、python 一次性脚本)显示为 Bash 调用。hook 由 sh 启动:Windows 上需要 Git Bash 或 WSL,否则什么都记录不到。Codex 暂不支持:hook 需先在 /hooks 信任、失败的 shell 命令显示为普通调用、skill 只有在命令读取其 SKILL.md 或运行其脚本时才计入、并发的两次 spawn 在树中可能对调。MIT 许可。撰稿时 40 星(2026-11-21)。

代码仓库

afurmanov/harness-profiler

收录日期

地图上的相关资源

  • 开放的 Agent Skills 标准——任何 agent 都能加载的 SKILL.md 文件夹,2026-10-22 起由 Agentic AI Foundation 治理。

    • official
    • spec
    • agent-skills
    • standard
  • Harness Bridge

    SDK / 工具

    一个本地启动器:让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

    • launcher
    • local-models
    • cli
    • menu-bar
  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation