什么是 agentpng？

agentpng 是一款专业工具，旨在弥合复杂、文本密集的 AI 代理交互与视觉吸引力强、易于分享的内容之间的鸿沟。在现代开发工作流程中，AI 编码助手会生成详细的会话日志、推理步骤和最终代码片段。agentpng 将这些原始记录——来自 Claude Code、Kiro、Cursor 和 Codex 等平台的记录——渲染成高保真、风格化的屏幕截图。

该工具对于需要记录、展示或分享 AI 协作会话特定时刻的开发人员、技术作者和教育工作者至关重要。无需分享原始文本文件或混乱的终端输出，agentpng 提供了一个干净、专业的视觉工件，捕捉了上下文、推理和最终代码，使知识转移无缝且引人入胜。

核心功能亮点

广泛的记录兼容性： 支持解析主流 AI 编码环境的会话日志，包括 Claude Code (.jsonl)、Kiro (.md)、Cursor (.md)、Codex (.jsonl)、Gemini CLI 以及标准的通用格式。
样式化图像导出： 生成美观、可直接分享的代理对话截图，具有语法高亮显示，并清晰区分用户提示、代理推理和工具调用。
直接集成： 为兼容的代理环境提供 agent-transcript 技能，可直接导出（运行 npx skills add siegerts/agent-transcript），从而简化工作流程。
灵活的输入方式： 用户可以轻松直接粘贴记录、拖放会话文件（.jsonl, .txt, .md, .log），或利用直接技能集成。
格式自动检测： 智能尝试解析输入格式，但仍可手动选择特定格式（如 Claude Code 或 Kiro）以获得最佳渲染效果。

如何使用 agentpng

agentpng 的上手过程设计得快速直观，重点是最小化从会话完成到图像创建之间的摩擦。

获取记录： 使用您选择的 AI 代理（例如 Claude Code、Kiro）完成会话。导出会话日志或复制相关文本片段。
输入数据： 导航到 agentpng 界面。您有三种主要选择：
- 粘贴： 将原始文本记录直接粘贴到输入区域。
- 拖放文件： 将您的会话文件（例如 session.jsonl 或 .md）拖放到指定区域。
- 直接导出（高级）： 如果使用兼容的代理，请在您的代理环境中安装 agent-transcript 技能（运行 npx skills add siegerts/agent-transcript）并直接导出到 agentpng。
解析与预览： 选择正确的输入格式（或让自动检测处理）。工具将处理文本并显示结果图像内容的样式化预览。
导出图像： 对预览满意后，使用导出功能下载最终的高质量图像文件，即可用于文档、博客文章或演示文稿中。

使用场景

技术文档与知识库： 开发人员可以快速捕获涉及 AI 协助的复杂调试会话或成功的实现步骤，将这些视觉证明直接嵌入内部文档（如 Confluence、Notion）中以供将来参考。
撰写博客和教程： 撰写有关使用特定 AI 代理（如提示工程指南）的教程的内容创作者，可以使用 agentpng 精确展示代理如何推理解决问题，从而增强指南的可信度和清晰度。
代码审查与协作： 在寻求同行评审由 AI 代理生成的解决方案时，分享整个上下文——初始提示、代理的内部规划和最终代码——作为一个干净的图像，可以加速理解。
展示代理能力： 演示新 AI 模型或代理框架能力的产品经理或研究人员，可以在演示文稿或营销材料中使用这些精美的图像来突出成功的交互。
个人知识管理 (PKM)： 利用 Obsidian 或 Logseq 等工具的用户可以轻松地将 AI 问题解决会话的视觉摘要集成到他们的个人知识图中。

常见问题 (FAQ)

问：agentpng 支持哪些 AI 代理和格式？ 答：agentpng 支持广泛的格式，包括 Claude Code (.jsonl)、Kiro (.md)、Cursor (.md)、Codex (.jsonl)、Gemini CLI 以及通用的用户/助手格式。工具会尝试自动检测，但允许手动选择以获得最佳效果。

问：使用 agentpng 有费用吗？ 答：网站通常暗示免费的工具模式，通常由可选的直接导出技能提供支持。对于核心 Web 应用程序功能（粘贴/拖放记录），通常是免费使用的，但用户应查看网站了解任何高级功能或使用限制。

问：我能自定义导出图像的外观吗？ 答：虽然主要重点是提供模仿常见终端/IDE 主题的干净、风格化的输出，但根据当前版本，通常会提供或暗示自定义选项（如主题选择或字体大小）。

问：如何使用直接导出技能？ 答：您可以通过在兼容的代理环境中运行 npx skills add siegerts/agent-transcript 将 agentpng 直接集成到您的工作流程中，从而无需手动复制或处理文件即可直接导出会话。

问：如果我的记录格式未列出怎么办？ 答：如果未明确列出您的格式，请尝试“通用（用户:/助手:）”解析器。如果该方法失败，复制并粘贴原始文本通常也有效，因为该工具旨在有效解析对话轮次。

agentpng