Writing Agent · 写稿 Agent
把写作从“一次性吐全文”，变成有讨论、有审校、能修改、可追溯的共创过程。
从一个模糊想法出发，与写作导演、主笔、审校和去 AI 味专家一起把文章写出来。你可以在过程中补充材料、改变方向、选择标题，而不只是等着接收最终结果。
了解新版 App · 下载 Windows 桌面 RC · 上手说明 · RC 状态与迁移进度 · 老用户：Claude Code Skill + Subagent 入口
老朋友，这个项目正在发生什么变化？
你没有走错仓库。原来的 Claude Code Skill + Subagent 写作工作流仍然保留，现在新增了一个不依赖 Claude Code 的独立桌面 App。
过去，需要先配置 Claude Code，再加载 Skill 和各位专家。此次桌面化重构，是为了让不熟悉终端、不想搭建开发环境的人，也能通过界面和对话使用这套写作方法。
变化的不只是外壳：新版把阶段推进、用户确认、稿件保存、版本管理和失败恢复等重要过程交给程序管理，让模型专注于理解、判断与写作。这是我们用工程化 Harness 承接原版工作流的方向，而不是把多 Agent 写作变成“一句话自动跑完”。
- 新用户：后文优先介绍桌面 App，不需要学习 Claude Code 或 Skill 安装。
- 原版用户：可以继续使用原工作流，不必迁移；直接跳到原版介绍与安装入口。
- 准备尝试新版的老用户：请先看迁移边界。原版能力尚未全部迁入，桌面版目前不是完整替代品。
当前状态 · 2026-10-10
桌面版 1.0.0-rc.80 已公开发布，提供 Windows x64 安装包。相比公开 RC68，本次聚焦轻量事实核查、搜索失败恢复与追加额度、来源读取超时和去重、三个并行模拟读者，以及阶段身份、耗时和下一步指引。它是 RC（候选测试版），不是稳定正式版；未签名，欢迎用独立测试项目体验并反馈。
原版 Skill 版本线仍为
v0.11.x。Releases 中的v0.11.0是 Skill 版本，app-preview-0.1.0是早期桌面预览，两者都不是这次重构的新 App。公开下载以本仓库标注“桌面版”的 Release 为准。
新版 App：不配置 Claude Code，也能一起写作
适合写公众号文章、观点分析、个人随笔、经验分享的人：已经有材料，想把它写好；或者只有一个想法，希望先聊清楚再动笔。
1. 从聊天开始，不从填表开始
直接说“我想写一篇关于工作节奏的文章”，或“还没想好写什么，帮我找找方向”。
助手会和你讨论主题、读者、篇幅和材料。共创模式下，阶段成果需要你参与确认；你可以说“认可，继续”，也可以说“这个开头太绕，直接一点”。缺少必要信息时，应在当前环节询问，而不是先写完再告诉你材料不够。
这也是 RC 持续验收的重点：自然语言确认、阶段交接和异常恢复仍在迭代，不宣称所有场景都已稳定。
2. 多位专家协作，而不是一个提示词包办全文
| 角色 | 帮你解决什么问题 |
|---|---|
| 写作导演 | 理清需求、安排下一步、汇总你的决定 |
| 资料研究与选题策划 | 整理材料、观点和文章结构 |
| 内容主笔 | 写初稿，集中落实已确认的修改意见 |
| 编辑与发布审校 | 检查结构、表达、读者价值与发布风险 |
| 读者审校 | 按目标平台模拟读者感受、弃读点和分享动机 |
| 去 AI 味与语言润色 | 减少套话和机械表达，保留作者声音，不编造亲历 |
| 标题策划与事实核查 | 讨论发布标题与文案，复核可能存在的事实错误 |
专家采用独立调用上下文，接收与当前任务相关的材料和阶段成果；程序记录调度、保存和确认状态。读者模拟是写作参考，不是真实读者调查，也不保证文章成为热文。
3. 内置 99 个模型接入预设，保留自定义配置
不用从零找地址、拼配置：在“设置 → 模型”中搜索和选择预设，填写该账户的 API Key 和模型 ID，再验证连接。已经配置好的模型可以在主对话输入区切换。
目录覆盖 MiniMax、DeepSeek、智谱 / Z.AI、千问 / 百炼、Kimi、OpenAI、Anthropic、Gemini，以及聚合平台和第三方中转；标明国内 / 国际、通用 API、Coding Plan、Token Plan 等产品区别，帮助你选对账户入口。
- 99 指当前界面的可选配置预设数，不是 99 家独立厂商或 99 个模型。 同一供应商可能有不同地区或套餐入口。
- 预置资料参考 CC-Switch，并按本项目适配器整理；收录不等于所有服务都已实连验收。
- 保留自定义模型 API，支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三类协议，具体以服务端支持为准。
- 网页会员、API 余额与编程套餐不一定通用；选择预设不会替你开通套餐，也不保证套餐允许用于写作。第三方中转需自行评估可信度。
统计口径：2026-09-30 当前源码的可选目录。后续版本可能调整。
4. 可选免费搜索，也可以接自己的 Tavily
“设置 → 搜索”提供三个选择：
| 选择 | 配置方式 | 使用边界 |
|---|---|---|
| Parallel 免费搜索 | 打开开关，无需填写 Key | 为事实核查寻找公开来源；有服务限额，可用性与免费政策以服务方为准 |
| Tavily | 打开开关，填写自己的 API Key | 按 Tavily 账户配额和套餐计费 |
| 不启用外部搜索 | 两个开关都关闭，默认如此 | 模型结合已有材料和自身知识复核，未联网验证，仍可能有事实错误 |
Tavily 已完成真实联网验证（2026-09-30）：使用真实 API Key 返回搜索来源，并由 MiniMax 调用搜索、识别测试材料中的错误年份、保存带来源的核查报告；个人感受与比喻未被误判为事实错误。它不是“仅模型复核”。表中“未联网验证”只指两个外部搜索开关均关闭的模式。
本次个别来源网页的正文读取失败，报告如实说明使用搜索摘录；这不等于 Tavily 搜索失败，也不代表所有网页均可读取。
Parallel 也已完成真实搜索与模型核查保存验证。桌面端开启并保存搜索设置后，会自动检索公开事实，不再逐次弹窗；检索词、服务、耗时与结果均可在运行记录查看。公开 HTTP 和 HTTPS 来源都可读取。请勿将私人或客户机密作为检索内容；关闭全部搜索服务后，仅用已有材料与模型复核，并提示未联网验证。
两个服务均提供独立连接测试，只有验证成功才显示可用标记；保存配置不等于已验证。每轮检索默认 6 次，可在设置中调整为 1—30 次，重复查询复用缓存。搜索失败时可选择重试或不再搜索，额度用尽时可选择追加 3 次；纯传输超时不占应用检索额度，但网络尝试另有保护上限。单 HTTP 请求最长 20 秒、单服务 30 秒、含回退的整次检索 60 秒，以适应跨境网络波动。不再搜索后会明确说明未联网核对的范围；检索额度不是所有模型、HTTP 请求或服务商费用的统一上限。公开公众号链接可作为素材读取，但验证码、登录墙、站点拒绝及失效链接仍可能无法读取。
两者都开启时，先用 Parallel，请求失败才转 Tavily，可能消耗 Tavily 配额。搜索结果仍需核对来源、时间与上下文，不是搜到网页就算核查通过。
这个模块服务于事实性问题，不用于挑剔个人感受、修辞或措辞偏好；也不等同于原版开放式资料研究的全部能力。具体实测范围见搜索验收记录。
5. 主对话看进展，稿件与版本看细节
- 在主对话讨论方向、看阶段成果、补材料、选标题，直接打开当前稿件。
- 在“稿件与版本”查看历史、比较修改、处理精细调整，并导出 TXT / HTML。
- 在“运行记录”按完整日期和新旧方向追溯专家、模型和工具步骤；点击查看已保存的输入、回复、工具参数与结果、Schema 和耗时，区分模型、搜索与网页读取失败。输入页提供字符构成统计，不将字符等同于 Token 或费用。详情按需加载，支持搜索摘要与加载历史；普通用户仍可只看主对话。记录可能包含文章和材料，分享前请自行检查隐私。
- 已保存成果保留在本机；停止或失败后可按当前状态继续或重试，不必重新填写全部需求。未保存的生成内容不等于已保存稿件。
事实核查绑定当前版本；正文、标题或证据变化后，旧结论可能需要更新。核查通过也不是“绝对无误”的保证，重要内容仍需人工复核。
下载与第一次使用
查看 rc.80 发布说明和全部附件 · 直接下载 Windows x64 安装包 · SHA-256 校验文件
此包未签名，Windows 可能显示“未知发布者”或 SmartScreen 提醒。请核对仓库来源和校验值，不要关闭安全防护。不要把旧 app-preview-0.1.0 当作这次新版。
升级前请备份工作区并退出旧版，再运行新安装包。安装与 RC68 → RC80 升级的实际验证范围见 RC80 发布记录，不代表所有历史数据库已穷举；当前没有自动更新。此前本地 RC80 测试包与本次固定提交构建的公开包不同，请以 Release 附件及校验值为准。系统复制粘贴偶发异常仍在排查，本版不宣称解决该问题。
- 找到明确标注“桌面版”的 Release，阅读 RC 限制，下载 Windows x64 的
Writing-Agent-Setup-版本号-x64.exe。GitHub 自动附带的Source code.zip是源码，不是安装包。 - 安装后进入“设置 → 模型”，选择供应商，填写 Key 与模型 ID，验证连接。
- 按需启用搜索；不启用也能写作，但事实复核不等于联网查证。
- 点击“新建项目”，用一句自然语言开始讨论，按阶段查看和反馈。
- 在主对话打开当前稿件，在“稿件与版本”中选择导出。
普通安装包用户不需要另装 Claude Code、Node.js 或 Python，也不必克隆源码。模型访问费用由自己的服务商账户承担。
完整步骤、备份和常见问题见桌面快速开始。当前提供 Windows x64；不把源码可跨平台构建等同于已有 macOS / Linux 安装包。
RC 状态：哪些已接入，哪些还没有迁完？
新版继承原版的写作理念和专家方法，但不是把旧流程原封不动搬进窗口，也尚未完成全部能力迁移。
| 范围 | 新版桌面目前的情况 |
|---|---|
| 对话需求、导演与独立专家、阶段确认 | 已接入；自然语言交流与恢复有专项验证，完整用户旅程仍需验收 |
| 初稿、审校、集中修订、去 AI 味、标题与事实核查 | 已接入；正在依据真实反馈修正交接与提示体验 |
| 稿件版本、局部修改、TXT / HTML 导出 | 已接入；正式交付受当前版本核查状态约束 |
| 风格参考与分析 | 已接入参考和方法；原版的量化指纹、陌生题材仿写与独立盲测尚未形成完整自动闭环 |
| 配图 | 支持配图策划和确认，尚未接入自动生成图片 |
| 外部资料与搜索 | 有公开 URL 读取与可选事实搜索，不代表原版所有研究工具已迁移 |
| 发布后复盘与学习 | 不宣称与原版完整复盘流程等价；自动指标采集、历史改稿差异学习等仍未形成闭环 |
更完整的说明见桌面与 Skill 能力对照。
公开 RC 的安装、升级和代表性写作检查进展见发布门禁。Parallel / Tavily 已分别完成真实搜索与模型核查保存专项验证；来源网页正文可能读取失败，不能外推所有网站或文章。模型服务仍可能出现延迟、限流或中断，99 个接入预设尚未逐个实连验收。RC 用于收集社区反馈，不代表完整人工体验或全部旧版能力已经验收。
如果依赖原版的完整能力，请继续使用 Claude Code Skill；尝试桌面 RC 时先用独立测试项目，重要稿件另做备份。欢迎反馈，但请不要把 RC 当作无需人工检查的生产工具。
本地保存、费用与升级
- 本地保存 ≠ 离线写作：稿件与项目保存在本机 SQLite 工作区，写作相关上下文仍会发送给你配置的模型服务。
- 搜索是可选外部请求：开启并保存搜索设置即允许自动发送公开事实检索词，不再逐次询问；运行记录可查看具体请求。启用不代表自动脱敏保证，请勿用私人信息或客户机密检索。关闭全部服务后不再联网搜索或读取来源，只使用已有材料与模型复核。
- 免费搜索 ≠ 免费模型：模型请求由你的供应商账户计费；多专家、修改与重试会产生调用用量。
- 保护凭据：Key 优先存入系统凭据存储，不支持持久存储时界面会提示仅会话有效。不要向 Issue 上传 Key、私人稿件、数据库或未脱敏日志。
- 当前没有自动下载安装更新：升级需下载新安装包。安装器设计为保留项目与设置，升级前仍需备份，以对应 Release 实测说明为准；新数据库不保证能被旧程序打开。
- 本次 RC 未签名：发布页已说明签名状态与 Windows 风险提示，不要求关闭系统安全防护。
桌面与 Skill 独立管理版本，使用 desktop-v版本号 标记桌面发布，Skill 保留 v0.x。旧项目不会因为安装 App 自动变成桌面项目；需要迁移时先备份，再参考迁移指南，不要直接覆盖或混用工作区。
开发、反馈与致谢
桌面源码位于 apps/desktop、apps/web 和 packages/*；原版 Skill 的运行时源位于 claude-runtime/。两套入口继续放在同一个仓库，安装包仅作为 Release 附件，不进入源码历史。旧 Tauri 预览保留在历史 Release，不是新桌面的代码入口。
开发者按 CI 使用 Node.js 24.18.0、Python 3.11：
npm ci
npm run check:runtime
npm run check:ui
npm run check:desktop
npm run check:claude-runtimeWindows 打包：npm run desktop:package，输出到 output/desktop；不自动安装或发布。更多信息：项目结构 · 实施记录 · 发布流程。
提交问题时，请注明版本、系统、模型协议、复现步骤及脱敏记录；不要提交凭据。欢迎分别反馈桌面版和 Skill 的体验，说明所用入口。
本项目使用 MIT 许可。第三方代码与配置资料来源见 THIRD_PARTY_NOTICES.md 和 upstream-sources.json。感谢原版用户的持续反馈，以及 CC-Switch 等开源项目提供的参考。Writing Agent 并非 DeepSeek、Anthropic 或其他服务商的官方产品。
原版：Claude Code Skill + Subagent
原来的写稿 Agent 没有被删掉。 如果你熟悉之前的用法，可以继续在 Claude Code 中写作；安装新桌面 App 不是继续使用原版的前提。
原版的核心能力仍在
原版通过 Skill 总控、专业 Subagent、工作流文件和配套脚本，把选题、立场、材料、提纲、写作、审校与交付串起来。它不仅生成文章，也保留每一步的材料与决定：
- 先确定观点和边界：讨论文体、读者与作者声音，收集真实素材，禁止用虚构亲历填补缺口。
- 多角色分工：主笔写作，编辑、发布与平台读者分别审校，集中修订后再去 AI 味。
- 风格与传播：风格档案、量化指纹与独立盲测工具；标题/开头方案、平台分发文案和读者模拟。风格有验证状态，不是所有档案都已充分验证，也不保证流量。
- 证据与交付：保留事实证据账本、核查快照与报告，交付纯文本，并可额外导出 HTML。
- 过程可复盘：按文章保存阶段文件、运行记录和可选发布反馈；中断后可以检查已有产物，再继续。
这些介绍属于原版 Skill，不能据此推断桌面 RC 已经全部实现。原版当前行为以工作流契约为准。
先看一个完整样本
《工资的一半，是你受的气折算的》不只放终稿，还保留选题、立场、素材、提纲、审校与核查过程：
选题 → 证据账本 → 提纲 → 初稿 → 去 AI 味稿 → 核查报告。
这是原版的历史样本，不是桌面版验收结果；样本中的旧核查状态也不代表自动通过当前门禁。
安装或继续使用
需要已可用的 Claude Code、Node.js 和 Python 环境，以及自己的模型访问配置。具体版本和两种安装方式见原版安装指南。
插件方式：
claude plugin marketplace add dongbeixiaohuo/writing-agent
claude plugin install writing-agent@writing-agent-marketplace在写作目录启动 Claude Code，用自然语言提出需求。插件首次初始化需要准备依赖；不是只复制一个 Skill 文件就得到完整工作流。
克隆仓库方式：
git clone https://github.com/dongbeixiaohuo/writing-agent.git
cd writing-agent
npm ci
claude从仓库根目录启动，才能加载项目级配置。维护者修改 claude-runtime/ 后，通过同步脚本更新 .claude/ 与 plugins/writing-agent/，避免两种安装入口漂移。
老用户升级须知与原文入口
- 桌面模型设置不会替 Claude Code 配置模型，两个入口的工作区也不是同一份存储。
- 更新前备份自己的工作流与文章；插件自举只补缺失文件，不覆盖已有自定义工作流。
- 从 v0.10.0 及更早 Skill 升级时，旧事实核查通过不能直接继承；请按 v0.11.0 升级说明处理当前正文、标题和账本。
- 原 README 完整归档保留详细教程与历史演进；其中价格、模型推荐和早期桌面说明属于历史信息，不作为当前购买或下载依据。
- CHANGELOG · 写作质量评估 · 所有 Releases。