Obsidian Chat Archive

一个用于把 Codex 对话保存到 Obsidian 的 Codex skill。

默认保存路径结构：

codex/YYYY-MM-DD/<对话标题>.md

功能

• 将当前 Codex 对话整理为适合 Obsidian 阅读的 Markdown 笔记。
• 自动创建日期目录。
• 自动清理 Windows 文件名中不允许使用的字符。
• 同一段 Codex 对话再次保存时，可以复用同一个 Markdown 文件。
• 支持同步保存模式：再次保存时刷新同一个 Markdown 文件，让一个对话始终对应一个文件。
• 默认追加到已有笔记；保存完整对话快照时建议使用 --sync。
• 默认保存当前可见的完整用户和助手对话正文，不会把普通长回答自动省略成摘要。
• 使用 UTF-8 with BOM 写入 Markdown，提升 Windows 和 Obsidian 下的中文兼容性。

安装

推荐直接克隆到 Codex skills 目录：

git clone https://github.com/Zeon814/obsidian-chat-archive.git "$env:USERPROFILE\.codex\skills\obsidian-chat-archive"

也可以克隆到其他目录，再创建 junction 到 Codex skills 目录：

git clone https://github.com/Zeon814/obsidian-chat-archive.git F:\projects\obsidian-chat-archive
New-Item -ItemType Junction `
  -Path "$env:USERPROFILE\.codex\skills\obsidian-chat-archive" `
  -Target "F:\projects\obsidian-chat-archive"

安装后重启 Codex，让 skill 列表重新加载。

配置

建议用环境变量设置 Obsidian vault 路径：

$env:OBSIDIAN_VAULT = "D:\Documents\Obsidian Vault"

如果希望长期生效，可以写入 Windows 用户级环境变量：

[Environment]::SetEnvironmentVariable("OBSIDIAN_VAULT", "D:\Documents\Obsidian Vault", "User")

也可以在每次运行脚本时通过 --vault 显式传入 vault 路径。

使用

在 Codex 对话中直接提出保存需求，例如：

保存这次对话到 Obsidian。
把当前 Codex 对话归档成 Obsidian 笔记。
同步这次聊天到我的 Obsidian。

skill 会整理 Markdown 内容，并调用脚本保存：

python scripts/save_chat.py --vault "<Obsidian vault 路径>" --title "<对话标题>" --content-file "<准备好的 Markdown 文件>"

如果已经设置了 OBSIDIAN_VAULT，可以省略 --vault。

如果同一段对话之前已经保存过，skill 会优先复用之前的文件路径，并用 --sync 刷新该文件，避免因为标题变化新建多个 Markdown 文件。

默认保存模式是“完整可见对话”：用户消息和助手回答应完整保留。只有以下内容会被摘要或标注省略：

• 当前上下文里已经不可见的早期对话。
• 很长、重复、噪声较多的工具输出或命令日志。
• 用户明确要求“摘要版”“简短版”“整理成摘要”的情况。

如果发生摘要或省略，笔记中应明确标注，例如 [summary: tool output omitted for length]，避免误以为是完整逐字稿。

真正同步保存

如果希望不用每次手动说“保存当前对话”，可以运行外部 watcher：

python scripts/watch_codex_sessions.py

它会监听 Codex 本地会话日志：

%USERPROFILE%\.codex\sessions\**\*.jsonl

默认行为：

• 自动选择最近更新的 Codex session JSONL。
• 只提取 user 和 assistant 消息。
• 过滤 system、developer、工具调用和工具输出。
• 用短 session id 写入稳定文件名，例如 对话标题 [019e38ee].md。
• 会话日志变化时，覆盖更新同一个 Obsidian Markdown 文件。

常用参数：

python scripts/watch_codex_sessions.py --once
python scripts/watch_codex_sessions.py --session-file "C:\Users\Administrator\.codex\sessions\2026\05\18\rollout-xxx.jsonl"
python scripts/watch_codex_sessions.py --interval 5

如果已经设置了 OBSIDIAN_VAULT，可以不传 --vault；否则使用：

python scripts/watch_codex_sessions.py --vault "D:\Documents\Obsidian Vault"

注意：watcher 是 skill 之外的常驻脚本。它实现真正同步；skill 本身仍然不能作为后台钩子自动运行。

脚本用法

也可以直接运行 bundled script：

python scripts/save_chat.py `
  --vault "D:\Documents\Obsidian Vault" `
  --date 2026-05-18 `
  --title "示例对话" `
  --content-file ".\example.md"

默认行为是追加到已有笔记。若要同步刷新同一个对话笔记，使用 --sync：

python scripts/save_chat.py --title "示例对话" --content-file ".\example.md" --sync

如果要明确复用某个已有文件：

python scripts/save_chat.py `
  --title "示例对话" `
  --content-file ".\example.md" `
  --target-file "D:\Documents\Obsidian Vault\codex\2026-05-18\示例对话.md" `
  --sync

如果在同一天同一段 Codex 对话中再次保存，但当前上下文里没有上次保存路径，可以复用当天最近修改的归档文件：

python scripts/save_chat.py --title "示例对话" --content-file ".\example.md" --sync

--sync 的选择顺序是：先使用 --target-file，再使用同标题已有文件，再使用当天最近修改的 .md 文件，最后才新建文件。

中文编码注意事项

在 Windows 上保存中文或其他非 ASCII 内容时，优先使用 --content-file，不要把 Markdown 正文通过 PowerShell 管道传给脚本。部分控制台编码会在 Python 收到内容之前把中文替换成问号。

脚本会用 utf-8-sig 读取和写入 Markdown，以便兼容 Obsidian 和 Windows 常见工具。

限制

Codex skill 不是后台钩子，不能保证每一次对话都自动捕获。它适用于用户明确要求保存、归档、导出、记录或同步当前对话到 Obsidian 的场景。

许可证

当前仓库还没有添加许可证。若希望他人明确复用、修改或分发，建议后续添加 MIT 等开源许可证。