资讯详情

开发指南|如何为Claude Chat Exporter做贡献:Artifacts、附件导出等未来功能路线图

📅 2026/10/31 0:14:45 | 华诺云谱 👁 阅读
开发指南|如何为Claude Chat Exporter做贡献:Artifacts、附件导出等未来功能路线图
【免费下载链接】claude-chat-exporterOne-click, privacy-first exporter for Claude.ai chats — clean Markdown with artifacts and attachments, ready for Obsidian and RAG.项目地址https://gitcode.com/gh_mirrors/cl/claude-chat-exporter点击查看免费下载Claude Chat Exporter 是一个开源的一键式 Claude 对话导出工具能在浏览器里将 Claude.ai 的完整聊天记录导出为干净的 Markdown 文件且全程本地处理、保护隐私。如果你想参与它的开发本文是面向新手的完整贡献指南从读懂项目结构到更新选择器、调优性能再到 Artifacts 与附件导出等未来功能路线图并给出从 clone 到提交 PR 的实操步骤。1. 先了解项目它解决了什么问题很多开发者想把与 Claude 的对话归档到 Obsidian、Notion或喂给 RAG 知识库但手动复制粘贴极易丢失表格、公式和代码块格式。claude-chat-exporter 的聪明之处在于不自己解析 HTML而是直接复用 Claude 官方的复制按钮。它自动点击每条消息的复制按钮并拦截剪贴板写入从而得到与官方复制 100% 一致的 Markdown。项目描述One-click, privacy-first exporter for Claude.ai chats — clean Markdown with artifacts and attachments, ready for Obsidian and RAG授权协议MIT见 LICENSE核心脚本仅一个文件 claude-chat-exporter.js约 300 行新人完全读得懂2. 上手贡献第一步只需读懂 3 个文件文件作用README.md功能说明、原理、配置项与贡献指南claude-chat-exporter.js全部导出逻辑LICENSEMIT 协议贡献前建议重点通读脚本里的三处配置区它们正是最常被贡献者修改的位置SELECTORSDOM 选择器集中定义UI 变了改这里即可见 claude-chat-exporter.js#L10-L15DELAYS点击复制按钮之间的间隔慢机器可增大见 claude-chat-exporter.js#L17-L19状态提示与导出流程startExport主控整个两阶段导出见 claude-chat-exporter.js#L218-L2633. 工作原理两阶段复制按钮捕获理解架构后贡献才不至于改坏逻辑拉取元数据调用 Claude 同源 API 获取会话标题和每条人类消息的时间戳见fetchConversationDataclaude-chat-exporter.js#L46-L73阶段一人类消息找出没有点赞按钮的操作栏逐个点击复制按钮阶段二Claude 回复找出有点赞按钮的操作栏同样逐个点击剪贴板拦截临时替换navigator.clipboard.writeText把每次写入按当前阶段分别存进两个数组见 claude-chat-exporter.js#L125-L132拼装输出buildMarkdown按顺序合并并为人类消息附加时间戳见 claude-chat-exporter.js#L183-L199区分两类消息的判定逻辑集中在getCopyButtonsclaude-chat-exporter.js#L151-L162——这也是 Claude 界面改版时最先需要跟进的地方。4. 官方点名的四大贡献方向README.md 的 Contributing 章节明确列出了社区最需要的四类贡献方向一Selector 更新最容易上手Claude 网页改版后复制按钮或操作栏的data-testid、aria-label可能变化。做法是打开 Chrome DevTools 重新定位元素然后更新SELECTORS对象即可无需改动任何逻辑。这是典型的低门槛、高价值贡献。方向二性能调优脚本在每次点击之间等待DELAYS.copy默认 100ms并配合 waitForClipboardOperations 做超时检测。你可以针对不同浏览器测量更小的安全间隔缩短导出时间优化超时阈值减少弱机上的误报方向三错误处理与健壮性目前脚本对 API 失败、消息未完全加载等场景只做console.warn降级。可以贡献更明确的失败原因提示状态条目前是英文短文案见 claude-chat-exporter.js#L256-L262对单边消息只有一方有复制按钮场景的告警与重试建议参考现有检测逻辑 claude-chat-exporter.js#L236-L240方向四Artifacts 与附件导出路线图核心README.md 的 Limitations 一节坦承当前两大空缺这正是最有影响力的功能型贡献No Attachments—— 无法导出用户上传的文件与图片No Artifacts—— Artifact 内容目前被跳过5. 未来功能路线图Artifacts、附件与 Obsidian/RAG按预期影响排序社区最可能的演进方向如下① Artifact 导出Artifact 是 Claude 生成的可交互网页、应用或长文档目前导出中完全缺失。思路可以是在抓取阶段识别 Artifact 消息调用其源码视图或复制入口获取完整代码再作为独立代码块写入 Markdown。② 附件与图片导出用户上传的图片、PDF 等目前丢失。可行方案是导出时下载附件到同名目录并在 Markdown 中以相对路径引用实现文件夹级归档。③ Obsidian 与 RAG 就绪的元数据项目定位是 ready for Obsidian and RAG因此可贡献 YAML front matter标题、时间、消息数、分块友好的分隔符方便下游知识库直接解析。④ 批量导出当前一次导出一个会话未来可扩展为遍历会话列表批量导出整个工作区。6. 贡献流程从 clone 到 PR克隆仓库仓库只读请勿在本地误提交到主仓库git clone https://gitcode.com/gh_mirrors/cl/claude-chat-exporter本地 Fork 一份后修改代码核心改动通常只涉及 claude-chat-exporter.js 与 README.md自测在浏览器控制台粘贴运行脚本确认状态条依次出现Fetching conversation data...→Copying human messages...→Copying Claude responses...→✅ Downloaded: xxx.md通过 issue 讨论或直接向维护者提交 Pull Request——README.md 的 Contributing 章节明确欢迎 PR 与 issue 讨论遵循 MIT 协议保留 LICENSE 文件7. 写在最后claude-chat-exporter 代码量小、结构清晰是练习浏览器自动化与 DOM 操作的优秀入门项目。从更新一个选择器开始到实现 Artifacts 导出每一步贡献都在让这个一键导出、隐私优先的工具更完整——而 Artifacts 与附件导出正是它离 Obsidian 和 RAG 完美归档最近的两块拼图。赞分享【免费下载链接】claude-chat-exporterOne-click, privacy-first exporter for Claude.ai chats — clean Markdown with artifacts and attachments, ready for Obsidian and RAG.项目地址https://gitcode.com/gh_mirrors/cl/claude-chat-exporter点击查看免费下载相关推荐输入一个网址整站打包成 zipWebsite-downloader 离线备份三步上手输入一个网址整站打包成 zipWebsite downloader 离线备份三步上手 上周维护的旧系统周五要下线内网文档还挂在服务器上做前端练习想拆解某后端网页爬虫HoloISO项目路线图未来功能开发与社区贡献指南HoloISO项目路线图未来功能开发与社区贡献指南 HoloISO项目致力于为普通PC用户提供接近官方体验的SteamOS 3系统。这个开源项目正在不断发展操作系统2025终极指南btop系统监控工具开发路线图与社区贡献全攻略2025终极指南btop系统监控工具开发路线图与社区贡献全攻略 btop是一款功能强大的系统资源监控工具能够实时显示处理器、内存、磁盘、网络和进程的使用情况指标监控CLI运维观测创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑