大家好，我做了一个免费、MIT 开源的插件 GPT Pages Importer，目前版本是 0.2.0。想和同样使用 ChatGPT Pages 与 Obsidian 的朋友分享，也欢迎试用反馈。
它解决什么问题？
Pages 中的图表和交互可视化，导出 Markdown 后不一定能直接在 Obsidian 中还原：原生图片引用可能失效，交互图表也需要完整 HTML 源码。
这个插件配合作者技能 gpt-pages-obsidian-visualizations，把图表配对信息、完整 HTML 和可携带的图片数据一起放进导出文件，再在 Obsidian 中验证、整理和还原。它不是云同步工具，也不会仅凭 Pages 引用自动下载缺失内容。
主要功能
- 图表配对与自动清理：支持精简 v3 标记，正文只保留简短图表 ID，完整 HTML、引用与 SHA-256 放在文末。验证成功后，把 HTML 移回图表位置，并清理对应标记及失效的原生图表引用；无法确认的内容会保留并提示。
- 手动导入与文件夹处理：手动导入时先看纯文本预览，完成后自动打开目标笔记；也可以监看一个库内文件夹及其全部子文件夹，直接清理其中的 Markdown 原文件。修改前会备份，并提供重复导入与冲突保护。
- 图片还原（0.2.0）：使用新版技能准备图片源数据后，可从单个 Markdown 文件还原 PNG、JPEG、GIF、WebP，保存到笔记旁的 GPT Pages Assets 文件夹，并改为相对路径。重复导入会复用一致的图片。限制为每张 1 MiB、合计 4 MiB、最多 32 个图片源块。仅有原生图片引用无法还原图片。
- 跨 Page 链接（新版技能）：导出前把内部 Page 链接解析为经过确认的 HTTPS 地址。无法解析的链接会保留并报告。链接仍指向在线 Page，需要相应访问权限，不会把目标 Page 下载成本地笔记。
- 数学公式（新版技能）：要求使用
$…$行内公式和$$…$$独立公式，保留反斜线、矩阵和多行表达式。Obsidian 使用内置 MathJax 渲染；已有的 latex/math 代码块仍然是代码，不会自动转换成公式。
如何开始
- 在 Obsidian 的“第三方插件”中搜索 GPT Pages Importer，安装并启用。最低支持 Obsidian 1.5.0。
- 在 AI 智能体中连接 @Pages，并安装或更新仓库内的 gpt-pages-obsidian-visualizations 技能。准备自己的 Page 时，这一步是必要的：技能负责生成可导出的配对标记、完整 HTML 和图片源数据。只安装 Obsidian 插件，不能补出导出文件里缺失的源码或图片。
- 可以这样要求智能体：“使用 gpt-pages-obsidian-visualizations 技能创建适合导出到 Obsidian 的 Page，使用 v3 配对格式；图片需要包含可携带的源数据，公式使用 Obsidian 数学定界符。”
- 从 Pages 菜单选择“下载”，导出 Markdown，再运行 GPT Pages Importer 的导入命令；也可以放入已配置的监看文件夹。
- 在 Obsidian 阅读视图中检查图片、公式与链接。需要交互 HTML 时，再检查源码并确认信任。
插件界面目前支持英文和繁体中文，跟随 Obsidian 语言设置；简体中文及其他未支持的语言回退英文。没有语言读取 API 的旧版 Obsidian 也回退英文。
HTML 渲染与信任
普通图片和原生数学公式不需要 Polyglot Renderer，也不需要 HTML 信任。
交互 HTML 需要另外安装并启用 Polyglot Renderer，开启它的 HTML 渲染设置，并明确确认内容可信。导入窗口与自动清理选项会提示 renderer 的安装、启用状态；检测不会自动安装或启用它，也不能保证其运行成功。
手动导入默认保存为不执行的 html-source。自动清理默认保留已有围栏语言；如果开启“清理后启用 HTML 渲染”，必须先确认文件夹信任。该信任范围包含文件夹及子文件夹中现在和以后出现的 HTML，包括未配对的区块。HTML 脚本可能执行并发起网络请求；哈希一致只能确认源码匹配，不能证明内容安全。
下载与文档
仓库 README 包含 Pages 下载 Markdown 的截图；Releases 中可找到 0.2.0。技能位于 skills/gpt-pages-obsidian-visualizations，繁体中文使用指南位于 docs/usage.zh-TW.md。插件与技能需要分别更新。
欢迎反馈
0.2.0 已通过 419 项自动化测试。跨 Page 链接和多图片示例通过了手动 Obsidian 验证；公式渲染在修正后的本地笔记中验证过，但还不能据此声称未经修改的 Page 公式导出已完整端到端通过。其他平台和不同导出内容仍欢迎测试。
尤其想了解：首次导入哪里不清楚？技能设置是否容易上手？多图片重复导入、文件夹清理和信任确认是否符合预期？
遇到问题可以在这里回复，或到 GitHub Issues 提供系统、Obsidian/插件/renderer 版本、复现步骤和去除隐私的最小示例。请不要上传私人 Page、原始私密导出或个人数据。
开发说明：本插件使用 AI 辅助开发，我能够理解其工作方式。免费使用，MIT 授权。谢谢大家！