Claude Code → Langfuse 可观测方案

将 Claude Code 本地 session jsonl 解析并上报到 Langfuse，支持主会话 + 子代理嵌套可观测。

完整设计见：方案实现说明.md

目录结构

langfuse_trace/
├── 方案实现说明.md       # 统一设计与故障排查
├── requirements.txt      # langfuse>=2,<3
├── common/               # 共享：transcript 解析 + Langfuse 上报
├── hook/                 # 方案 A：Claude Code Stop Hook
├── watcher/              # 方案 B：jsonl 实时轮询 Watcher
├── transcript_demo/      # 样例 jsonl
├── tests/                # 单元测试
└── docs/                 # 历史文档

快速开始

pip install -r requirements.txt

export TRACE_TO_LANGFUSE=true
export CC_LANGFUSE_PUBLIC_KEY=pk-lf-xxx
export CC_LANGFUSE_SECRET_KEY=sk-lf-xxx

• Hook：见 hook/README.md
• Watcher：见 watcher/README.md

两种方案勿同时启用，以免重复上报。

测试

python3 -m unittest discover -s tests -q
./hook/run_e2e_langfuse_test.sh
./watcher/run_e2e_langfuse_watcher_test.sh