writing-agent

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-23

桌面版 1.0.0-rc.88 已公开发布，提供 Windows x64 安装包。相比 RC87，本次新增可选 DeepSeek 搜索、重复读取无进展时的暂停与恢复、过长限流等待提示，并复用同轮已授权来源快照，减少重复联网。作者确认、事实核查与标题选择继续保留。它是 RC（候选测试版），不是稳定正式版；未签名，验证范围见 RC88 发布记录。

原版 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. 可选免费搜索，也可以接 DeepSeek 或 Tavily

“设置 → 搜索”提供三种服务，也可以全部关闭：

选择	配置方式	使用边界
DeepSeek 搜索	默认关闭，显式开启并填写独立搜索 API Key	启用后优先使用，按成功搜索请求计费；不更换写作模型、不复用其 Key
Parallel 免费搜索	打开开关，无需填写 Key	为事实核查寻找公开来源；有服务限额，可用性与免费政策以服务方为准
Tavily	打开开关，填写自己的 API Key	按 Tavily 账户配额和套餐计费
不启用外部搜索	全部开关关闭，默认如此	模型结合已有材料和自身知识复核，未联网验证，仍可能有事实错误

Tavily 已完成真实联网验证（2026-09-30）：使用真实 API Key 返回搜索来源，并由 MiniMax 调用搜索、识别测试材料中的错误年份、保存带来源的核查报告；个人感受与比喻未被误判为事实错误。表中“未联网验证”指全部外部搜索开关关闭的模式。DeepSeek 本次通过合成接口回归，尚未执行真实付费搜索或配合真实模型的完整写作验收；不能沿用 Tavily / Parallel 的历史结果作为 DeepSeek 实测证据。

2026-09-30 实测中，个别来源网页的正文读取失败，报告如实说明使用搜索摘录；这不等于 Tavily 搜索失败，也不代表所有网页均可读取。

Parallel 也已完成真实搜索与模型核查保存验证。桌面端开启并保存搜索设置后，会自动检索公开事实，不再逐次弹窗；检索词、服务、耗时与结果均可在运行记录查看。公开 HTTP 和 HTTPS 来源都可读取。请勿将私人或客户机密作为检索内容；关闭全部搜索服务后，仅用已有材料与模型复核，并提示未联网验证。

三种服务均提供独立连接测试，只有验证成功才显示可用标记；保存配置不等于已验证。“保存并验证”会测试已启用服务，DeepSeek 每次成功验证消耗一次计费搜索请求，Tavily 验证消耗账户用量。DeepSeek 查询最多 128 个 Unicode 字符，默认只取最多五条摘要，不额外调用付费 Fetch。每轮检索默认 6 次，可在设置中调整为 1—30 次，重复查询复用缓存。搜索失败时可选择重试或不再搜索，额度用尽时可选择追加 3 次；纯传输超时不占应用检索额度，但网络尝试另有保护上限。单 HTTP 请求最长 20 秒、单服务 30 秒、含回退的整次检索 60 秒。不再搜索后会说明未联网核对的范围；检索额度不是模型、HTTP 请求或服务商费用的统一上限。公开公众号链接可作为素材读取，但验证码、登录墙、站点拒绝及失效链接仍可能无法读取。

搜索顺序为 DeepSeek → Parallel → Tavily，只请求已启用服务，仅失败时转向下一个；未启用 DeepSeek 时沿用 Parallel → Tavily。回退可能消耗对应服务的用量。搜索结果仍需核对来源、时间与上下文，不是搜到网页就算核查通过。

这个模块服务于事实性问题，不用于挑剔个人感受、修辞或措辞偏好；也不等同于原版开放式资料研究的全部能力。具体实测范围见搜索验收记录。

5. 主对话看进展，稿件与版本看细节

• 在主对话讨论方向、看阶段成果、补材料、选标题，直接打开当前稿件。
• 在“稿件与版本”查看历史、比较修改、处理精细调整，并导出 TXT / HTML。
• 在“运行记录”按完整日期和新旧方向追溯专家、模型和工具步骤；点击查看已保存的输入、回复、工具参数与结果、Schema 和耗时，区分模型、搜索与网页读取失败。输入页提供字符构成统计，不将字符等同于 Token 或费用。详情按需加载，支持搜索摘要与加载历史；普通用户仍可只看主对话。记录可能包含文章和材料，分享前请自行检查隐私。
• 已保存成果保留在本机；停止或失败后可按当前状态继续或重试，不必重新填写全部需求。未保存的生成内容不等于已保存稿件。
• 同状态重复读取没有业务进展时会暂停，重试继续原专家；正常分页、保存和角色交接仍可推进。过长限流等待会显示可恢复提示及有效重试时间，到期前恢复不会向同一服务和模型提前重发；没有自动恢复定时器。

事实核查绑定当前版本；正文、标题或证据变化后，旧结论可能需要更新。核查通过也不是“绝对无误”的保证，重要内容仍需人工复核。

下载与第一次使用

查看 rc.88 发布说明和全部附件 · 直接下载 Windows x64 安装包 · SHA-256 校验文件

此包未签名，Windows 可能显示“未知发布者”或 SmartScreen 提醒。请核对仓库来源和校验值，不要关闭安全防护。不要把旧 app-preview-0.1.0 当作这次新版。

升级前请备份工作区并退出旧版，再运行新安装包。安装与 RC87 → RC88 升级的实际验证范围见 RC88 发布记录，不代表所有历史数据库已穷举；当前没有自动更新。历史构建与 RC80 → RC87 升级结果保留在 RC87 记录，其哈希不能用于新包。请以当前 Release 附件及校验值为准。系统复制粘贴偶发异常仍在排查，本版不宣称解决该问题。

1. 找到明确标注“桌面版”的 Release，阅读 RC 限制，下载 Windows x64 的 Writing-Agent-Setup-版本号-x64.exe。GitHub 自动附带的 Source code.zip 是源码，不是安装包。
2. 安装后进入“设置 → 模型”，选择供应商，填写 Key 与模型 ID，验证连接。
3. 按需启用搜索；不启用也能写作，但事实复核不等于联网查证。
4. 点击“新建项目”，用一句自然语言开始讨论，按阶段查看和反馈。
5. 在主对话打开当前稿件，在“稿件与版本”中选择导出。

普通安装包用户不需要另装 Claude Code、Node.js 或 Python，也不必克隆源码。模型访问费用由自己的服务商账户承担。

完整步骤、备份和常见问题见桌面快速开始。当前提供 Windows x64；不把源码可跨平台构建等同于已有 macOS / Linux 安装包。

RC 状态：哪些已接入，哪些还没有迁完？

新版继承原版的写作理念和专家方法，但不是把旧流程原封不动搬进窗口，也尚未完成全部能力迁移。

范围	新版桌面目前的情况
对话需求、导演与独立专家、阶段确认	已接入；自然语言交流与恢复有专项验证，完整用户旅程仍需验收
初稿、审校、集中修订、去 AI 味、标题与事实核查	已接入；正在依据真实反馈修正交接与提示体验
稿件版本、局部修改、TXT / HTML 导出	已接入；正式交付受当前版本核查状态约束
风格参考与分析	已接入参考和方法；原版的量化指纹、陌生题材仿写与独立盲测尚未形成完整自动闭环
配图	支持配图策划和确认，尚未接入自动生成图片
外部资料与搜索	有公开 URL 读取与可选事实搜索，不代表原版所有研究工具已迁移
发布后复盘与学习	不宣称与原版完整复盘流程等价；自动指标采集、历史改稿差异学习等仍未形成闭环

更完整的说明见桌面与 Skill 能力对照。

公开 RC 的安装、升级和代表性写作检查进展见发布门禁与 RC88 发布记录。Parallel / Tavily 的真实搜索与模型核查保存记录属于历史专项；DeepSeek 和本次恢复逻辑的合成回归不等于真实付费搜索、真实模型耗时或文章质量验收。来源网页正文仍可能读取失败。OneDrive 路径 GPU 异常与本地路径 smoke 通过的证据分别保留，smoke 禁用硬件加速，不能据此宣称正常 GPU 已通过。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-runtime

Windows 打包：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。

回到新版 App 介绍