Codexian

一个运行在 Obsidian 侧边栏里的本地 Codex 工作区。
保留 Claudian 式的克制交互，换成独立的紫色主题，并接入本机 Codex CLI。

特性

• 原生 Codex 工作流：使用本机已登录的 Codex CLI，不保存登录凭据。
• 模型与思考强度：动态读取可用模型，并选择 Low、Medium、High、XHigh 等 reasoning effort。
• Vault 上下文：读取当前笔记、选中文本、显式附加的 vault 文件和图片。
• ChatGPT 对话引用：在输入框内引用 标题，完整引用 JSON 可携带聊天正文。
• 连续会话：本地保存、切换、重命名和删除历史对话。
• Claudian 风格 UI：Thought、命令、文件修改和工具调用以紧凑结构展示，品牌强调色为紫色。
• 可控权限：默认 workspace-write；YOLO 会明确提示并关闭审批与沙箱。

安装

GitHub Release

1. 从 Releases 下载 main.js、manifest.json 和 styles.css。

2. 在 vault 中创建目录：

   <your-vault>/.obsidian/plugins/codexian/
   

3. 将三个文件放入该目录。

4. 打开 Obsidian → 设置 → 第三方插件，启用 Codexian。

从源码构建

git clone https://github.com/lucassete10-dot/codexian.git
cd codexian
npm install
npm run build

随后把 main.js、manifest.json 和 styles.css 复制到 vault 的插件目录。

使用要求

• Obsidian 1.8.9+
• 桌面端 Windows、macOS 或 Linux
• 已安装并登录 OpenAI Codex CLI

打开 Codexian 后，可在输入框底部选择模型与 Effort。文件夹图标用于附加 vault 文件；相邻的聊天图标用于选择或粘贴 ChatGPT 对话引用。

单独的 chatgpt-conversation:// 链接只包含标题和对话 ID。要让 Codexian 真正读取旧聊天正文，需要粘贴包含 conversation 或 messages 的完整引用 JSON。

权限与隐私

• Codexian 只把当前 vault 作为 Codex 工作目录。
• 插件不会读取或存储 Codex 登录凭据。
• 对话、模型偏好和引用记录保存在本地 Obsidian 插件数据中。
• 引用的旧聊天会作为带边界的背景资料传入，并明确要求模型把其中的指令视为引用数据。
• YOLO 使用 --dangerously-bypass-approvals-and-sandbox，只应临时开启。

开发

npm ci
npm run check
npm run build
npm run verify

main.js 会随仓库提交，方便手动安装；CI 会验证源文件语法，并确保构建产物已同步。

项目状态

Codexian 目前处于早期版本。欢迎通过 Issues 报告兼容性问题或提出功能建议。

致谢与声明

界面布局与部分交互模型参考了 Claudian，相关 MIT 许可见 THIRD_PARTY_CLAUDIAN_LICENSE.txt。

Codexian 是独立的社区项目，与 OpenAI、Obsidian 或 Claudian 官方无隶属关系。Codex、OpenAI 和 Obsidian 等名称及标识归各自权利人所有。

License

MIT