WriteX

WriteX

English

WriteX is an Obsidian-native writing workspace for WeChat creators. Your Markdown note remains the source of truth while you use Codex, Claude, or WorkBuddy to develop material, generate images, preview WeChat layouts, and create or update WeChat drafts only. It never publishes or mass-sends on your behalf.

中文

AI 强化原创

不再为写公众号单独购买一套 AI 服务。

WriteX 直接调用你本地的 Agent，共用现有的 AI 订阅额度，不额外产生模型调用成本。它把散落在聊天记录、文件夹和不同工具里的创作流程，收拢到一个固定的 Obsidian 工作台中。现支持 Codex、Claude、WorkBuddy。

从记录想法、筛选选题、寻找切口、整理大纲，到 AI 生图、公众号排版，手机端预览、再一键同步至草稿箱，都在当前笔记旁边完成。

你提供真实经历、材料和判断，Agent 负责梳理、改写与补强。WriteX 不替你成为作者，只帮你把原本想说的话，表达得更完整。

它不承诺绕过 AI 检测，也不会自动发布或群发文章。它只创建或更新微信公众号草稿，最终发不发，仍由你决定。

只创建或更新微信公众号草稿。不会自动发布，不会群发。

30 秒安装 WriteX

1. 从 WriteX v0.5.6 下载 main.js、manifest.json 和 styles.css。
2. 将三份文件放进 <你的 Vault>/.obsidian/plugins/writex/；从旧版 obsidian-agent 迁移时，保留旧目录和数据，并只启用 writex。
3. 重启 Obsidian，在 设置 → 第三方插件 启用 WriteX，然后打开一篇笔记，从右侧栏进入。

WriteX 需要 Obsidian 1.11.4 或更高版本。

当前可用的手动安装包是 v0.5.6 GitHub Release，仅含上面三份文件：

<你的 Vault>/.obsidian/plugins/writex/

然后在第三方插件中启用 WriteX。社区目录正在审核；审核通过并公开前，上方图片展示的是未来的目录入口，不是当前可点击入口。

它适合什么场景

• 材料很多，还不是一篇文章：从采访、旧稿和灵感中找角度、搭结构或改一段。
• 文章写完了，排版还没开始：Markdown 正文、手机预览、图片和公众号排版保持同步。
• 同一篇草稿还要继续修改：标题不变更新原稿；标题改变创建新稿。
• 没有固定 IP，也想先跑通：主动选择 Write Cloud 免费体验。

核心功能

• Skill 创作：在 Chat 中选择 Vault Skill，用于文字创作与图片生成；也可以直接在 Chat 中生成图片。
• 三种 Agent：支持 Codex、Claude 和 WorkBuddy。调用使用你自己的 Agent 订阅或 API 额度，不消耗 WriteX 积分。
• 历史与选题：保留各 Agent 的会话历史，把值得继续写的回复一键收为选题。
• 图片集与预览：管理正文图片和排版主题，用固定手机视图检查最终效果。
• 公众号交付：可一键复制微信公众号格式；也可使用高级同步，一键创建或更新草稿，执行前仍需确认。
• 本地优先：Markdown 正文留在 Vault；Agent、同步路线和图片能力都由用户明确选择，不静默回退。

两条公众号同步路线

两条路线彼此独立，不会自动切换。

数据安全

• 正文归 Obsidian：Markdown 笔记始终是唯一编辑源。
• 凭据不进普通配置：Relay Key、图片 API Key 和 Write Cloud 匿名设备凭据保存在 Obsidian SecretStorage，不写进 data.json。
• 真实写入前必确认：同步前明确显示目标、内容、创建或更新、费用和余额变化。
• 自建路线不收费：用户自建 Relay 永远消耗 0 WriteX 积分。
• 没有客户端遥测：本地点赞或点踩只保存结构偏好，不上传历史正文。

隐私与边界

• 发送消息时，所选 Agent 会收到当前笔记内容；WorkBuddy 可读取 Vault 中获准读取的上下文，不是严格的单文件沙箱。# WriteX

English

WriteX is an Obsidian-native writing workspace for WeChat creators. Your Markdown note remains the source of truth while you use Codex, Claude, or WorkBuddy to develop material, generate images, preview WeChat layouts, and create or update WeChat drafts only. It never publishes or mass-sends on your behalf.

中文

AI 强化原创

你提供经历、材料和判断，AI 帮你梳理、改写和补强。WriteX 把 Agent、图片、公众号排版和草稿同步放进当前 Obsidian 笔记旁边，但不把作者的位置让出去。

它不承诺绕过 AI 检测。它做的是让文章从你的真实材料出发，而不是生成一篇完整却不像你的文章。

只创建或更新微信公众号草稿。不会自动发布，不会群发。

30 秒安装 WriteX

1. 从 WriteX v0.5.6 下载 main.js、manifest.json 和 styles.css。
2. 将三份文件放进 <你的 Vault>/.obsidian/plugins/writex/；从旧版 obsidian-agent 迁移时，保留旧目录和数据，并只启用 writex。
3. 重启 Obsidian，在 设置 → 第三方插件 启用 WriteX，然后打开一篇笔记，从右侧栏进入。

WriteX 需要 Obsidian 1.11.4 或更高版本。

当前可用的手动安装包是 v0.5.6 GitHub Release，仅含上面三份文件：

<你的 Vault>/.obsidian/plugins/writex/

然后在第三方插件中启用 WriteX。社区目录正在审核；审核通过并公开前，上方图片展示的是未来的目录入口，不是当前可点击入口。

它适合什么场景

• 材料很多，还不是一篇文章：从采访、旧稿和灵感中找角度、搭结构或改一段。
• 文章写完了，排版还没开始：Markdown 正文、手机预览、图片和公众号排版保持同步。
• 同一篇草稿还要继续修改：标题不变更新原稿；标题改变创建新稿。
• 没有固定 IP，也想先跑通：主动选择 Write Cloud 免费体验。

核心功能

• Skill 创作：在 Chat 中选择 Vault Skill，用于文字创作与图片生成；也可以直接在 Chat 中生成图片。
• 三种 Agent：支持 Codex、Claude 和 WorkBuddy。调用使用你自己的 Agent 订阅或 API 额度，不消耗 WriteX 积分。
• 历史与选题：保留各 Agent 的会话历史，把值得继续写的回复一键收为选题。
• 图片集与预览：管理正文图片和排版主题，用固定手机视图检查最终效果。
• 公众号交付：可一键复制微信公众号格式；也可使用高级同步，一键创建或更新草稿，执行前仍需确认。
• 本地优先：Markdown 正文留在 Vault；Agent、同步路线和图片能力都由用户明确选择，不静默回退。

两条公众号同步路线

两条路线彼此独立，不会自动切换。

数据安全

• 正文归 Obsidian：Markdown 笔记始终是唯一编辑源。
• 凭据不进普通配置：Relay Key、图片 API Key 和 Write Cloud 匿名设备凭据保存在 Obsidian SecretStorage，不写进 data.json。
• 真实写入前必确认：同步前明确显示目标、内容、创建或更新、费用和余额变化。
• 自建路线不收费：用户自建 Relay 永远消耗 0 WriteX 积分。
• 没有客户端遥测：本地点赞或点踩只保存结构偏好，不上传历史正文。

隐私与边界

• 发送消息时，所选 Agent 会收到当前笔记内容；WorkBuddy 可读取 Vault 中获准读取的上下文，不是严格的单文件沙箱。
• Agent CLI、主题下载、用户选择的图片 API、自建 Relay 和 Write Cloud 会分别联网，并遵循各自的服务条款。
• Write Cloud 是可选的闭源托管服务；开源插件、本地 Agent、预览复制和自建 Relay 不依赖它。
• 当前没有支付、订阅、充值、正式发布、群发、定时发布、自动同步、数据分析、团队或多渠道分发。
• Write Cloud 仍处于受控体验阶段。它提供当前设备撤销以及连接/AppSecret 删除；完整的设备/会话清单与管理能力尚未提供，且每一项破坏性操作都需要单独确认。

更完整的边界见 隐私说明和公开仓库边界。

从旧版迁移

v0.5.3 把插件 ID 从 obsidian-agent 改为 writex。升级时先停用旧插件；如果新目录没有自己的数据，WriteX 会复制旧数据并保留原文件不动。既有 SecretStorage 键与侧栏布局保持兼容。

旧插件的自定义快捷键不会自动迁移，需要在 Obsidian 快捷键设置中重新绑定。

开发

npm install
npm run check

插件源码采用 AGPL-3.0-only。可安装主题包及其来源、作者和许可证见 https://github.com/pakco77/writex-theme-packs。

参与贡献 · 安全报告 · 发布清单 · 商标说明