127.0.0.1ABCD-2345 就是全部凭证01 · 上手
三步开始写
没有账号体系要配置，没有服务要部署。编辑器、网关、一本书，就绪。
装编辑器
用官方 Zed 作壳，写作能力由 writer 扩展挂载，不改动上游。
运行网关
一条命令启动本机网关，自动读入 ~/.writer/upstream.env 里的模型配置。
从模板建书
复制 templates/novel/，人物卡、时间线、伏笔账本一次就位。
02 · 功能
写长篇时真正缺的那几件事
每一条都对应一个写长篇绕不开的坑：设定遗忘、人称漂移、人名写错、稿子散落多台设备。
智能续写
停下即出灰字，Tab 采纳。每次请求自动携带全书设定、人称与续写状态卡，写到第几章都接得上。
问设定，不用翻文档
右侧面板直接问「沈砚欠谁人情」——答案从你的人物卡与世界观简报里检索命中，不是模型现编。
选区改写
选中一段，按你的指令改。主角与被点名人物的设定自动随行，改写不崩人设。
一致性检查进编辑器
人名近似写错当场画波浪线、一键修正；禁用词标红；每章字数就在行内。
一串码同步
sync --push / --link / --pull 三步走。服务端防并发覆盖，删除与重命名真实生效，.git/ 永不上传。
快照与成书
保存即存快照，中文可读 diff 随时回滚；一键导出 txt / md / docx / epub，docx 带中文首行缩进与宋体。
03 · 原理
它是如何工作的
一个本机网关把编辑器与模型连起来：网关负责拼设定、改请求、跑检查，你的正文不出本机。
官方 Zed + writer 扩展
你写正文的地方。灰字续写、设定问答、诊断提示都发生在编辑器里。
writer-core
一个 Rust 单二进制：拼装设定上下文、改写模型请求、运行一致性检查与 MCP 设定检索。
任意 OpenAI 兼容上游
DeepSeek 等兼容服务皆可。换供应商只改一个环境变量，编辑器配置不动。
正文不经 writer 的任何服务器
写作链路是编辑器 → 本机 127.0.0.1 网关 → 你自己配置的模型上游，writer 的服务器不参与写作；
只有你主动同步时，稿件归档才会到 sync.topwriter.club（HTTPS 传输，端到端加密在路线图上）。
04 · 答疑
常见问题
更完整的说明在使用说明 · 常见问题。
我的稿件会被传到你们的服务器吗？
正文不会。写作流量走本机 127.0.0.1 网关；只有你主动执行 sync --push 时，
稿件归档才会上传到同步服务，且 sync --delete --yes 可一键清空云端（本地稿件不动）。
支持哪些模型？
任何 OpenAI 兼容上游。在 ~/.writer/upstream.env 里改
WRITER_UPSTREAM_BASE 与 WRITER_CHAT_MODEL 即可，编辑器侧固定写别名 writer-main，不用动。
为什么我的配置没有生效？
模型与续写类配置只认编辑器的全局 settings；项目级配置只承载语言与上下文服务。 这是常见踩坑点，使用说明 · 配置里有完整的作用域表。
两台设备同时写作会冲突吗？
不会静默冲突。后 push 的一端会被服务端拒绝并提示先 pull；pull 覆盖前会自动存本地快照，不怕丢稿。
同步码泄露了怎么办？
writer-core cli sync --rotate 秒换新码，旧码立即失效，云端版本完整搬迁。
收费吗？
软件内测阶段免费；模型费用由你自己的 API Key 直接支付给供应商，writer 不经手。