claude-code-log 的项目扩展与二次开发

项目的基础介绍

claude-code-log 是一个开源的 Python 命令行工具，它可以将 Claude Code 转录的 JSONL 文件转换成可读的 HTML 格式。这个工具能够帮助用户创建一个清晰、简洁的 HTML 日志，按照时间顺序显示用户提示和助手的响应，支持单个文件和整个项目结构的处理。

项目核心功能

• 项目结构处理：能够处理整个 ~/.claude/projects/ 目录，生成带有项目统计信息的索引页面。
• 单独会话文件：为每个会话生成单独的 HTML 文件，并提供导航链接。
• 单文件或目录处理：可以转换单个 JSONL 文件或特定目录。
• 会话导航：提供交互式目录，显示会话摘要和快速导航。
• 令牌使用跟踪：显示每条消息和会话总体的令牌消耗情况。
• 运行时消息过滤：通过 JavaScript 实现的消息类型过滤（用户、助手、系统、工具使用等）。
• 按时间排序：跨会话按时间戳对所有消息进行排序。
• 跨会话摘要匹配：正确匹配异步生成的摘要和它们原始的会话。

项目使用的框架或库

项目使用了以下框架和库：

• Click：用于命令行接口和参数解析。
• Pydantic：用于健壮的数据建模和验证。
• dateparser：用于自然语言日期解析。
• mistune：用于快速的 Markdown 渲染。
• Jinja2：用于 HTML 模板渲染。

项目的代码目录及介绍

• claude_code_log/parser.py：从 JSONL 文件中提取和解析数据。
• claude_code_log/renderer.py：生成 HTML 并渲染模板。
• claude_code_log/converter.py：高层次的转换协调。
• claude_code_log/cli.py：命令行接口和项目发现。
• claude_code_log/models.py：用于转录数据结构的 Pydantic 模型。
• claude_code_log/templates/：Jinja2 HTML 模板。
• pyproject.toml：项目配置和依赖。

对项目进行扩展或二次开发的方向

• 增强过滤功能：可以扩展消息过滤功能，支持更复杂的过滤条件，比如基于内容的搜索。
• 扩展输出格式：除了 HTML，可以添加对其他格式（如 PDF 或 markdown）的支持。
• 增加交互性：为 Web 界面添加交互性，比如消息的时间线视图或者标签系统。
• 集成其他服务：将 claude-code-log 集成到其他服务中，例如通过 API 将数据发送到分析工具。
• 多语言支持：优化项目，使其能够支持国际化和本地化，包括多语言界面。
• 性能优化：优化大数据量的处理性能，比如通过异步处理或数据库支持。