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-bookmarks | Bases 查询、Bookmarks |
obsidian-cli-runtime-admin | 插件 / 主题 / 片段 / 命令管理 |
obsidian-cli-devtools | 运行时诊断、开发者命令 |
obsidian-cli-sync-and-publish | Sync 状态、Publish(有版本检测) |
obsidian-cli-workspace-and-navigation | vault / 工作区 / 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 用户。