cowrite

Cowrite

cowrite

「你在 Agent 里说，文章在浏览器里长出来。」

MIT · Codex / Claude Code compatible · Contact: Space

Cowrite 是一个本地运行的对话式写作画布。浏览器负责承载和编辑文章，Codex / Claude Code 通过 MCP 读写同一份数据；配图统一调用 Codex 内置 image_gen，HTML 解释图和文章优化由仓库内置 Skill 完成。它同时提供 Codex 与 Claude Code marketplace，安装后会自动准备依赖、构建前端并启动本地服务。

安装

要求：Node.js 20.19+（或 22.12+）、npm，以及已登录的 Codex CLI 或 Claude Code。使用“发送到飞书”还需要本机安装并登录 lark-cli，同时安装其 lark-doc Skill。

让 Codex 自动安装

把下面这段口令发给 Codex：

请安装 Cowrite：https://github.com/SpaceZephyr/cowrite.git
请依次运行：
1. codex plugin marketplace add SpaceZephyr/cowrite --ref main
2. codex plugin add cowrite@cowrite
3. codex plugin list，确认 Cowrite、8 个 Skills 和 Cowrite MCP 已安装
安装完成后告诉我需要新建一个任务来加载插件；新任务中调用 cowrite_get_status，返回本地画布地址。

也可以直接在终端安装：

codex plugin marketplace add SpaceZephyr/cowrite --ref main
codex plugin add cowrite@cowrite

安装后新建一个 Codex 任务，然后说：

启动 Cowrite，并告诉我本地画布地址。

让 Claude Code 自动安装

把下面这段口令发给 Claude Code：

请安装 Cowrite：https://github.com/SpaceZephyr/cowrite.git
请依次运行：
1. claude plugin marketplace add SpaceZephyr/cowrite
2. claude plugin install cowrite@cowrite --scope user
3. claude plugin list，确认 Cowrite、8 个 Skills 和 Cowrite MCP 已安装
安装完成后提醒我运行 /reload-plugins 或新开一个 Claude Code 会话；加载后调用 cowrite_get_status，返回本地画布地址。

也可以在 Claude Code 中手动执行：

/plugin marketplace add SpaceZephyr/cowrite
/plugin install cowrite@cowrite
/reload-plugins

或直接使用终端命令：

claude plugin marketplace add SpaceZephyr/cowrite
claude plugin install cowrite@cowrite --scope user

首次启动会发生什么

插件的 MCP 首次加载时会自动：

1. 检查并安装 npm 依赖；
2. 构建 Cowrite 浏览器前端；
3. 在 http://127.0.0.1:4320 启动生产服务；
4. 注册 Cowrite MCP 工具；
5. 将页面和资产持久化到 ~/.cowrite/。

首次启动可能需要几十秒。服务仅监听本机，不会把文章上传到远端。插件会话结束时，由插件启动的服务也会停止；下一次加载会自动恢复。

从源码运行

git clone https://github.com/SpaceZephyr/cowrite.git
cd cowrite
npm install
npm run dev

开发模式默认打开 http://127.0.0.1:4321，API 位于 127.0.0.1:4320，测试页面数据保存在 data/cowrite.json。若 4321 被占用，Vite 会在终端显示自动切换后的地址。

写作工作流

1. 新建页面时可填写标题和创作要求，也可从本地导入 .md / .markdown 文件；导入会自动识别一级标题或使用文件名。编辑时可直接粘贴 PNG、JPEG、GIF 或 WebP 图片，Cowrite 会先存入本地资产库再插入短链接，避免 base64 导致页面卡顿。
2. 点击顶部「Cowrite」，在“按页面内容为要求创作”和“输入自定义创作要求”之间二选一；任务会连同当前页面全文复制到 Agent 对话框。
3. 在编辑器中选中文字，使用浮动工具栏的「配图」「HTML」「优化」或「对话」；「对话」会复制带原文引用的草稿，粘贴到 Agent 输入框后补充修改要求。
4. 点击每个 Page 顶部的「Slide」，选择 PPT 或 HTML；PPT 模式会同时生成可编辑 PPTX 和浏览器可打开的 PDF 预览，Agent 把交付链接插回文章顶部。
5. 点击「排版」，选择公众号或小红书：公众号生成可复制富 HTML；小红书按确认后的策略用 Codex 内置 image_gen 生成 3:4 图片组。
6. 点击顶部「配图」，确认后由 Agent 分析整篇文章，使用 Codex 内置 image_gen 生成 2-6 张统一风格的 16:9 配图并插入对应段落。
7. 点击「发送」，可选择飞书、公众号或知乎；飞书确认后通过本机 lark-cli 创建云文档，公众号与知乎暂标记为“待完善”。
8. Agent 读取页面最新 revision，调用指定 Skill 产出结果，再通过 MCP 精确写回。
9. 编辑器轮询更新，人和 Agent 可以继续编辑同一页面；revision 乐观锁会阻止相互覆盖。
10. 删除页面时，在左侧目录对应标题最右侧点击删除图标，并在确认弹窗中执行删除。

内置 Skill 路由

Cowrite 操作	仓库内 Skill	固定产物与约束
配图	skills/image-studio	Codex 内置 image_gen、16:9 图片、禁止外部模型回退
整篇配图	skills/article-batch-illustration + skills/image-studio	自动规划 2-6 个锚点、统一风格、逐图安全插入
HTML	skills/text-logic-diagram	16:9 HTML/PPT 风格单页、内联 CSS + SVG、适合 iframe
优化	skills/ai-writing-assistant	Method 5 局部改写，只替换选中文字
Slide	skills/space-multi-design-ppt	智能品牌匹配；原生可编辑 PPTX + PDF 浏览器预览，或 16:9 HTML deck
排版	skills/space-wechat-layout	自动匹配 Claude / OpenAI / Google；微信公众号可复制富 HTML 预览页
小红书排版	skills/baoyu-xhs-images + skills/image-studio	两次方案确认；Codex 内置 image_gen 逐张生成 3:4 图片组
页面读写	skills/cowrite	MCP 操作、revision 合并、防覆盖规则

按钮复制的口令会显式声明 Skill 名称和已确认参数。所有位图生成统一走 Codex 内置 image_gen，不需要配置图片 API key，也不会改用外部模型或插入来源不明的图片。

内置图片生成

Cowrite 不再包含 LabNana、Gemini 或其他外部图片 API 脚本。配图、整篇配图、小红书图片和 Slide 图片模式都使用 Codex 内置 image_gen：

• 不需要 LABNANA_API_KEY 或 OPENAI_API_KEY
• 每张不同图片单独调用一次内置工具
• 生成后先检查，再复制到项目目录、上传并插入 Cowrite
• 内置工具不可用或失败时停止，不使用 CLI 或外部模型回退

Codex 提供内置生图时图片按钮可直接执行。Claude Code 仍可使用页面编辑、排版、HTML、PPTX 和 MCP 能力；如果当前运行时没有 Codex 内置 image_gen，图片任务会明确停止，不会自动切换供应商。

Agent 接入