Codex Obsidian

TraeWork 官方插件 —— 通过官方 Obsidian 桌面 CLI 集成本地 Obsidian 工作流。7 个聚焦 skill 覆盖笔记、元数据、运行时管理、Sync、发布等。


一、定位

字段值
所属TraeWork 官方 marketplace 插件
开发者Greg Asher(社区贡献者)
版本0.1.0
协议MIT
类别development_tools
核心能力Obsidian 桌面 CLI 集成

二、它解决什么问题

2.1 传统痛点

  • AI 不能直接操作 Obsidian vault
  • 笔记、Tags、Tasks、Bases 等功能只能人工用
  • Sync / Publish 等高级功能缺乏自动化

2.2 Codex Obsidian 的解决方案

  • 通过官方 Obsidian 桌面 CLI——不用 hack、不用 OCR,直接走官方 API
  • 7 个聚焦 skill 覆盖完整工作流

三、7 个 Skill

Skill作用
obsidian-official-cli核心笔记和元数据
obsidian-cli-bases-and-bookmarksBases 查询、Bookmarks
obsidian-cli-runtime-admin插件 / 主题 / 片段 / 命令管理
obsidian-cli-devtools运行时诊断、开发者命令
obsidian-cli-sync-and-publishSync 状态、Publish(有版本检测)
obsidian-cli-workspace-and-navigationvault / 工作区 / tab / 导航
obsidian-cli-workflows命名工作流编排(preview 优先)

四、典型使用场景

"读我的 Obsidian 笔记 'XX'"
"查询 base 视图,返回 JSON 格式"
"列出 Obsidian 里所有已启用的社区插件"
"检查 Obsidian Sync 状态"
"加载保存的工作区,打开目标笔记"
"用 workflows 跑 tasks.rollup"
"用 workflows 跑 daily.bootstrap"

五、关键能力

5.1 完整 Obsidian 集成

  • 笔记 CRUD、元数据管理
  • Bases 查询
  • Bookmarks
  • 插件 / 主题 / 片段管理
  • Sync 状态
  • Publish(有 capability 检测——只在可用时启用)

5.2 安全设计

  • Publish 是能力门控的——只在本地 CLI 真正支持时才启用
  • 避免执行不可能的 API 导致错误
  • 每个 skill 都有「限制和边界」文档

5.3 命名工作流

  • tasks.rollup:汇总任务
  • daily.bootstrap:每日初始化
  • workspace.focus_mode:工作区聚焦
  • 等

preview-then-apply模式——先预览,确认后再应用。


六、什么时候用 / 不用

6.1 该用

  • ✅ 已经在用 Obsidian 做笔记
  • ✅ 想用 AI 自动化 Obsidian 任务
  • ✅ 需要 Sync / Publish 等高级功能
  • ✅ 想用社区插件管理

6.2 不该用

  • ❌ 不用 Obsidian
  • ❌ 需要的是「Obsidian 替代品」——本插件是给 Obsidian 用的
  • ❌ 自托管 Obsidian + 自定义 CLI——兼容性可能有问题

七、引用来源

  • TraeWork 插件目录 —— 本文内容完全来自此文件
  • 插件 README

八、一句话总结

Codex Obsidian 是「通过官方 CLI 集成 Obsidian」的插件——7 个聚焦 skill 覆盖笔记、元数据、运行时、Sync、Publish 全部。MIT 协议,社区贡献者 Greg Asher 维护。Publish 有 capability 门控,安全。适合重度 Obsidian 用户。