Her · हेर — Build Small Hackathon 参赛项目深度研究

一句话版本

把你 Claude Code 会话日志（.jsonl）拖进去，Her 会自动读完整条记录，用大白话告诉你刚才发生了什么——哪里改了生产环境的配置文件、哪个工具烧掉最多 token、哪个子代理偷偷超时了——就跟请了个侦探一样。

1. 背景：Build Small Hackathon

Her 是 Hugging Face / Gradio 联合举办的 Build Small Hackathon 的参赛项目。该黑客松的核心规则是：

Jay 也参加了这个黑客松（https://github.com/geoffrey-young/anthropic-hackathon-2026），做的是 Claude Code Canary——一个 Claude Code 插件安全预警系统。

2. Her 是什么？

Her（हेर）在马拉地语（Marathi）中意为「侦探」。

> Every Claude Code session leaves a trace — a .jsonl file with every turn, tool call, and token. But in practice, that trace is write-only. Rarely anyone reads 4,000 lines of JSON to figure out...

Her 的定位非常清晰：Claude Code 每次会话都会产生一份 .jsonl 日志文件，详尽记录了每一次往返、每一次工具调用、每次 token 消耗——但从来没有人真正去读那 4000 行 JSON。Her 替你读。

2.1 核心功能

① 会话复盘（Report）

把 .jsonl 日志拖进去，Her 自动重构整个会话：

② Ask Her 问答副驾

内置 Copilot 模式。你可以直接问「为什么这个工具被调用了？」她会从 trace 中找到答案，引用具体轮次，甚至打开对应的工具调用记录。

③ 多会话项目视图

拖入多个 .jsonl 文件，Her 会建起一个项目视图，跨会话追踪同一个问题。

④ 工具识别数据库

内置 Homebrew、npm、PyPI 的常用 CLI 工具数据库。如果会话中执行了 deploy 工具、数据库客户端、开发服务器，Her 会自动标记出来。

2.2 技术架构

层面实现
**前端**React 应用，通过 Gradio 服务
**分析引擎****纯确定性**（deterministic evaluation）——不依赖模型做任何数值判断
**LLM 角色**仅用于写自然语言报告和提出建议性改进意见（从不「下结论」）
**模型****Nemotron-Mini-4B-Instruct**（4B 参数，符合黑客松规则）
**推理**HG ZeroGPU，**无需第三方 AI API**
**隐私**上传的文件只存在于运行实例的私有命名空间，自动删除

> The split that makes this trustworthy: the evaluation engine is purely deterministic. The model is used only to write the English and propose softer suggestions. It never asserts a finding. The numbers don't move when the model changes.

这是 Her 设计上最聪明的一点：分析引擎是确定性的，模型只负责写文章。这意味着即使换模型，数字不变，结论不变。

2.3 产品哲学

3. 开发故事

Her 诞生于一个周末：

1. 作者先给朋友做了一个 操作者视图（journey graph）——每个查询是一个节点，按 token 成本决定节点大小，最贵的那个发光

2. 另一个朋友觉得太复杂，想要更简单的版本 → 于是加了 Executive Report 作为默认视图

3. 第一个朋友抱怨"为什么我的 CLI 工具没显示？" → 于是有了 工具识别数据库

> "It grew over a weekend. It started as an operator's view — a journey graph where every query is a node sized by cost, the heaviest one glowing — built for a friend."

4. 开源情况

Her 的完整源代码在 HF Space 上完全公开可见：

https://huggingface.co/spaces/build-small-hackathon/her/tree/main

目录结构：

注意：代码是公开可读的（source-available），但仓库中没有单独的 LICENSE 文件，所以目前没有正式的开源协议声明。

如果想自己部署 self-hosted 版本，可以直接从 HF Space 下载全部代码，按照 DEPLOY.md 和 QUICKSTART.md 配置即可。架构很干净——确定性引擎 + Nemotron-Mini-4B 本地推理，适合私有化运行。

5. 与我们项目的关联

这个项目对 OpenClaw / Claude Code 用户的直接价值：

6. 评分表

维度评分说明
**问题匹配度**⭐⭐⭐⭐⭐Claude Code 日志分析的确是刚需，痛点精准
**技术设计**⭐⭐⭐⭐⭐确定性引擎 + 小模型写报告，架构优雅
**隐私设计**⭐⭐⭐⭐⭐无第三方 API，文件自动删除
**实用性**⭐⭐⭐⭐⭐对自己、对团队 debug 都有直接价值
**完成度**⭐⭐⭐⭐周末完成，功能已可用但还有扩展空间
**创新性**⭐⭐⭐⭐日志分析本身不新，但专注 Claude Code 会话并做多会话分析有差异化

来源链接