为专业长文作者打造的 Cursor 式 AI 写作 IDE
让 AI 读懂整个项目、协助每一个段落，同时把每一次修改的决定权留给你。
Important
当前为 macOS Developer Preview，采用专有评估许可证。它适合体验和反馈，尚不是面向生产环境的正式版本。请先备份重要文稿。
写一本书、一份研究报告或一篇方法论长文，需要同时管理结构、上下文、事实、人物关系和大量修订。普通 AI 对话很快忘记前文，传统编辑器又不理解你的写作意图。
笔触把 Cursor 的项目式 AI 协作带进写作现场：
- 项目级：用
edit.md固化主旨、读者、边界与大纲，让 AI 始终理解整部作品。 - 文件级：在章节之间切换、检索和跨文件修订，不再反复复制上下文。
- 段落级：选中原文，按
⌘K写下本次改写要求，再逐项审阅差异；接受、拒绝或重载都清清楚楚。⌘L则专注项目、文件与选区对话。 - 一致性图谱：追踪人物、概念、变量、关系与时间，提前发现冲突、遗漏和漂移。
- 研究与溯源：把来源、主张和适用边界留在写作流程里，而不是散落在浏览器标签页中。
- 本地 Markdown：作品仍是你熟悉的文件，方便备份、迁移和版本管理。
flowchart LR
A["edit.md<br/>写作意图"] --> B["项目上下文"]
C["章节与资料"] --> B
B --> D["AI 协作 / 对话 / 改写"]
D --> E["差异审阅"]
E --> F["由作者确认写入"]
F --> G["关系与时间一致性检查"]
G --> B
在笔触里，“接受建议”只是完成审阅选择；只有点击底部确认按钮，修改才会安全写入项目。已决定的 Diff 会收起成摘要，随时可以在写入前改主意。
- macOS 12 或更高版本
- Node.js 22.12 或更高版本
- npm 10 或 npm 11
npx writ-craft@preview想先确认环境而不启动应用：
npx writ-craft@preview --check推荐从这个简单结构开始：
我的写作项目/
├── edit.md # 主旨、目标读者、写作边界与结构
├── chapters/
│ ├── 01-开篇.md
│ └── 02-核心观点.md
└── references/ # 资料与引用
第一次使用时，先打开 edit.md，把“为什么写、写给谁、要讲清什么”告诉笔触。你可以直接进入章节，通过项目对话、段落改写和一致性图谱推进作品。当前公开的 0.3.0 Preview 已包含统一任务进度、受限 @ 上下文、处理建议 → 正文内 Diff → 接受或撤销的透明协作任务流。
左侧书脊式活动栏在项目文件、搜索、来源与图谱之间保持唯一清晰的工作区状态；新建或打开其他项目时，从项目标题右侧的 ••• 菜单进入。
更完整的首次启动、MiniMax 配置、推荐工作流和排错方法，请阅读 《从安装到第一篇作品》。
笔触坚持三个原则：
- 先理解意图，再改正文：项目对话解释上下文，正文只通过可审阅 Diff 修改。
- 修改必须可见：AI 变更通过差异界面呈现，不静默覆盖作品。
- 作者拥有最终决定权：关键写入、来源判断和一致性结论都由作者确认。
MiniMax API Key 只应在应用设置中配置。不要把 Key 写进项目文件、终端命令、GitHub Issue 或诊断截图。AI 请求会产生第三方服务费用，具体能力与额度以服务商账号为准。
| 写作环节 | 当前能力 |
|---|---|
| 项目启动 | edit.md 引导、项目卡、章节批量创建 |
| 日常写作 | 项目/文件/选区对话、段落改写、Chapter，以及候选版建议→正文内 Diff 统一任务 |
| 修订控制 | 差异审阅、历史记录、安全撤销、冲突恢复 |
| 长文理解 | 跨文件上下文、章节检索、来源与脚注 |
| 一致性 | 人物/概念/变量/时间关系图谱与问题回到正文 |
| 多模态 | MiniMax 图片生成、评分、插入与可恢复回收 |
| 隐私诊断 | 先预览、再导出的脱敏诊断信息 |
0.2.0 的工作区能力已纳入当前预览；其 GitHub/App 候选记录仍保留在状态账本中，npm registry 的中间版本不作为当前安装入口。
公开的 0.3.0 透明 AI 协作 Preview，已验证统一任务进度、受限 @ 引用、Context Catalog 过期保护、五入口统一 Context Manifest v2、正文内 Diff、Safe Undo、同 profile Key 重启恢复，以及真实作者隔离副本的 Chat → Navigation → Diff → 冲突阻止 → 接受 → Safe Undo。Chapter、Research、普通 Changes、Graph、图片、五入口 edit.md revision 漂移旧结果丢弃、来源不足“添加来源”恢复、取消/60 秒超时和跨项目迟到结果零写入均已有获批 GUI 证据；阶段 E 独立复审已签收 P0=0、P1=0、P2=3。该版本已发布到 npm preview 和 GitHub prerelease，但仍是 Developer Preview。
- 目前仅支持 macOS arm64 / x64，通过终端启动。
- 尚未提供 Apple Developer ID 签名与公证的
.app安装包。 - 当前公开 Preview 为
writ-craft@0.3.0；安装时请始终显式使用@preview。latest保留为上一稳定指针0.1.0，不代表本次 prerelease。 - 重要文稿请保留独立备份；正式生产使用尚未开放。
- 源码公开可见，不等于开源授权。评估、复制和使用边界以 专有评估许可证 为准。
笔触将沿着“真实作者可用 → 更稳定的个人创作工具 → 可持续的专业服务”推进。未来计划提供付费的 Pro 能力，例如更强的长文上下文、专业研究工作流、模型与费用管理，以及面向团队的协作与治理功能。
我们不会用付费功能削弱一个基本承诺：你的作品归你，AI 的修改必须可见，作者始终拥有最后决定权。
查看 公开路线图，了解当前阶段、未来付费方向和不会越过的产品边界。
- 遇到问题：提交 Bug Report
- 有产品建议：发起 Feature Request
- 涉及安全或隐私：请先阅读 安全报告说明，不要公开披露凭证或文稿
- 希望贡献：请阅读 参与指南
开发进度、验证证据和下一门禁记录在 v0/DEVELOPMENT-STATUS.md。内部工程材料不代表稳定版承诺。
Copyright © 2026 Max Hou. All rights reserved.
WritCraft 当前依据 WritCraft Proprietary Evaluation License 1.0 提供。允许个人或组织内部评估；生产、商业交付、托管、转售、再分发和未经授权的衍生开发均受限制。第三方组件保留各自许可证。
如果你也相信 AI 应该放大作者，而不是取代作者，欢迎关注笔触的下一次进化。