Musset
一款面向写完书的人的 Mac 写作应用。
musset.app · 下载 Mac 版 · 与 Scrivener、Ulysses、iA Writer 和 Manuskript 对比
测试期间免费,1.0 版本起一次性付费 US$9.90,无论哪种方式都是开源。需 macOS 14 或更高版本,Apple 芯片。
Musset 如空白页般安静,如手稿般有条理,键盘响应如 WordStar 般迅速。它内置一位编辑,会阅读、提问、批注,但从不替你写一个字。你的书始终是一个纯文本文件文件夹,连同完整历史,支持英语、法语、德语、西班牙语、意大利语或葡萄牙语,打印时以 EB Garamond 排版。

- 结构:章节、场景、Bible
- 看板、窗格与窗口
- 版本,尽在掌控
- 与编辑一起修订
- 内置的编辑
- 六种语言
- 从草稿到出版方
- 导入一本书
- 价格,以及 Musset Sync
- 磁盘上的你的书
- 从源码构建
- 项目结构
- 翻译界面
- 参与贡献
为什么选 Musset
写作工具往往在三者中选其一:安静的编辑器、手稿管理器,或替你写作的机器。Musset 是前两者,并拒绝第三者。
- 你的文字始终属于你。Musset 中的 AI 会批评、引用、提问;原则上,它从不为你的书生成文字。关掉 AI,一切照常工作。
- 你的文件始终属于你。每一章都是可以随处打开的 Markdown 文件;历史记录就是普通的 git。你随时可以离开 Musset,整本书随之带走,完整无缺。
- 键盘优先。四种键盘模式,一切皆可用的命令栏,以及抹去除文字外一切的模式。
- 通往出版方的完整道路。与编辑一起修订,各国的手稿格式,以及专业排版的 PDF。
写作
- 单栏纯文本编辑器。底层是 Markdown,按你阅读时的方式呈现:强调标记会从你所在的段落中折叠隐去,场景标记变成安静的小标题。
- 写、改、读。工具栏里的三种模式。在「改」中,每一处改动都成为一条修正,供你日后斟酌。在「读」中,章节或整本书以排版样式逐页显示在正文旁边。
- 专注。专注模式会调暗你正在书写的段落之外的一切;打字机滚动让当前行保持在屏幕中央;小地图、行号和重复高亮都只隔一个快捷键。
- 展台模式(⌃⌘K)。你的 Mac 变成一台打字机:Musset 占据整个屏幕,包括菜单栏、Dock 和刘海,在你退出之前无法切换应用。章节、批注和三种模式仍触手可及。
- 超专注(⌃⌘U)。只有文字,只能向前:没有界面,不能回头。三个级别——Light 允许你修补当前的句子,Normal 允许退格,Hardcore 两者都不允许。可选锁定,直到达到某个字数或时间。你写下的内容会落到章节末尾,或一个新场景里,或草稿中。
- 浅色与深色,跟随 macOS 或在命令栏中选择。


键盘
在设置 › 键盘中选择你的双手早已熟悉的按键。一次只用一种模式;⌘ 在每种模式下都是 Musset 的,AZERTY 键盘也已处理妥当。
| 模式 | 带来的功能 |
|---|---|
| Mac(默认) | 每个 Mac 应用和 Word 的快捷键。 |
| WordStar | 光标菱形(⌃E ⌃S ⌃D ⌃X……),保持标记的区块(⌃K B / ⌃K K),跨章节复制和移动,放置标记(⌃K 0–9 / ⌃Q 0–9)。 |
| vi | 普通、插入和可视模式;理解散文的移动和文本对象——句子(( ) 等同于 s),段落,带撇号的单词;. 用于重复。Esc 归编辑器所有。 |
| Emacs | 标记、区域和kill ring(⌃Space ⌃W ⌃K ⌃Y),Meta 用 Esc——⌥ 仍可输入你的重音字符。 |
命令栏(⌘K)做其余所有事:跳转到你任何一本书中的任何章节或场景,运行批评,搜索文本,更改外观,导出。

结构:章节、场景、Bible
- 部、章和场景,每个都有状态(草稿、已写、已修订、最终)和字数。拖动以重新排序;将章节搁置为草稿而不删除它们。
- 情节网格(⌘5):每个场景一行,列为主情节、支线、角色和母题,由你填写或由 AI 从你的文本中提议。
- Bible:你书中一个可见的 bible/ 文件夹,用于工作表(角色、地点、时间线)、文档和剪辑。它是你的——可在 Finder 中阅读,在历史中追踪。你从章节中剪下的一段文字会自动进入 Cuts,并带有它来自何处。
- 场景卡片。一章的场景并排显示,每张卡片容纳其场景的完整文本。抓住卡片的标题将其拿起并放到别处:文本随之移动。在两个段落之间拆分一个场景,将其与下一个合并,就地重命名。
- 一览全书。概览显示每一章如何开头和如何结尾;进入一个部,在那里场景从一个章节移动到另一个章节,然后进入一个章节。
- 为你保留的演员表。Musset 在章节到来时阅读它们,并记录谁出现、出现频率以及以哪些名字出现。一张工作表有两部分:你的笔记,以及章节实际陈述的内容,每个都带有它来自的章节。
- 处处重命名。角色在每个章节、笔记和工作表中更改名字;你在每一行更改之前看到它,一次撤销即可全部还原。
- 锚定到段落的笔记和待办事项,可从任何地方快速捕获,以及章节计划(⌘6)。

板、窗格和窗口
- 书内的软木板。钉上一个角色、一个地点及其地图、一段对话碎片,并在它们之间画线。从 Bible 拖入一张工作表,它变成卡片;箭头抓住卡片的侧面并随之保留;一支笔和一支荧光笔用于其余部分。在章节旁边,你正在写的段落中的人和地点的卡片会亮起。
- 开放格式。板是你书文件夹中的 JSON Canvas 文件,无需 Musset 即可阅读。
- 窗格。将章节或工作表拖到窗格的一侧,它就会在那里打开:两个章节,都是实时的,每个都有自己的撤销。将布局保存在一个名称下,并从键盘调回。
- 窗口。拉出一个标签页,它变成自己的窗口;将板和 Bible 停放在第二块屏幕上。

版本,在掌控之中
不再有 chapter-3-final-v2-REAL.docx。Musset 在你写作时悄悄保留你书的每个状态:你从不保存副本,从不重命名文件,你删除的东西永远不会真正消失。
- 一章的两个版本,并排显示。在两个方向之间犹豫?两个都写。将它们并排阅读,标出不同之处,并选择哪一个进入书中——然后随时改变主意。
文章标题:Show HN: Musset,开源的 Scrivener 替代品,内置从不代笔的 AI
正文:
- 旁边的草稿。在平行草稿里对整本书大胆尝试;真正的手稿不会动。逐段把可行的部分拿回来,或者把草稿搁到一边。
- 回到过去。查看任何一章在上周二的样子,或者你把它寄出去那天的样子。设置里程碑——一次投稿、一次朗读会、一稿的结束——并回到其中任何一个。比较某一章任意两个时刻的样子。
背后是 git,软件世界用来记录自己工作的系统。你永远不必见到它。


与编辑一起修改
- 文本中的修改。删去的划掉,新增的标绿,评论落在它所针对的段落上。逐条接受或拒绝,也可以一次全部处理;每条修改都带有做出它的人的名字。
- 你自己的修订也一样。切换到 Revise(⇧⌘E),你的改动就变成可以稍后斟酌的修改。
- 生活在 Word 里的编辑。导出一个 .docx;他们的修订痕迹和评论会以修改和笔记的形式回来,即使你在此期间一直在这份文本上继续工作。
- 谁写了什么(⌥⌘B),当一本书被共享时。
修改以 CriticMarkup 的形式存储在章节自身之中——纯文本,随处可读:{++added++}、{--deleted--}、{~~old~>new~~}、{==highlighted==}{>>comment<<},后面跟着 {@Name} 表示是谁做的。

内置的编辑
这个 AI 读起来像一位好编辑:它引用你的句子,说出它看到了什么,并提出一个问题。它从不改写你的书。
- 页边笔记。批评、问题、连贯性检查、待核实的事实、口头禅、删减——还有赞美,它有自己的颜色。每条笔记都引用它所针对的段落;处理完后你把它勾掉。
- 一键全文通读。风格与问题、口头禅、连贯性、该删什么、开头与结尾、待核实的事实。
- 按评分标准批评。对章节进行盲读,按为你的体裁选定的标准打分,每一项论断都有引文支撑,Musset 会对照原文核实该引文。
- 你自己的规则。把你的风格表写一次,编号;Musset 按它检查每一章,把发现留在页边,并引用相应规则。
- 聊一聊。就你所在的章节聊天,它指出的内容会作为笔记落到页边。
- 语法,经确认。基于规则的检查器无法判断一个句子的含义;可选地,AI 会在语法提醒被划线之前确认它们。
AI 通过你自己在服务商那里的账户运行,从 Musset 登录:Claude 通过官方 Claude Code 命令行工具,ChatGPT 通过官方 Codex 命令行工具。Musset 不持有任何 AI 服务商的密钥,也不抽成。



六种语言
| 界面 | 排版 | 拼写与语法 | 稿件 | |
|---|---|---|---|---|
| English (US, UK) | ✓ | “ ” / ‘ ’, em or spaced en dash | LanguageTool | Standard manuscript format |
| Français | ✓ | « » with non-breaking spaces, dialogue dash | LanguageTool | Feuillets (25 × 60) |
| Deutsch (DE, CH) | ✓ | „ “ / « » in Switzerland, ß → ss, z. B. | LanguageTool | Normseite (30 × 60) |
| Español (ES, Latin America) | ✓ | « » or “ ”, raya for dialogue | LanguageTool | A4, characters with spaces |
| Italiano | ✓ | « », È, po’ | LanguageTool | Cartella (1,800 battute) |
| Português (PT, BR) | ✓ | « » or “ ”, travessão | LanguageTool | A4, characters with spaces |
每本书都有自己的语言和变体(书籍设置)。Musset 会在你输入时应用排版规则,并用 LanguageTool 检查拼写和语法,LanguageTool 运行在你的 Mac 上、Musset 内部:任何内容都不会发送到别处。巴西葡萄牙语和欧洲葡萄牙语各有自己的界面。
从草稿到出版
阅读模式会在文本旁边排版章节或整本书,呈现其印刷后的样子。

PDF 使用 Typst 和 EB Garamond 按书籍样式排版:
- 每个段落整体排版,并按照书籍语言的规则断词;
- 章节标题使用真正的小型大写字母,旧式数字、连字、场景之间的装饰符号;
- 对开页具有内侧和外侧页边距,页码位于外侧边缘,部扉页位于右手页;
- 你所在市场的常见开本(13 × 20、14 × 21、12.5 × 20.5 cm、B-format、5.5 × 8.5 和 6 × 9 in……)以及供印刷使用的裁切标记;
- 封面、扉页、献词、题词、目录、致谢和版权页,如果你需要的话。


投稿稿件遵循各国的惯例,并按照出版商的计数方式计数:
| 市场 | 格式 |
|---|---|
| US, UK | Standard manuscript: Letter or A4, double spaced, contact and word count on page one, “Surname / TITLE / page” header |
| France | Feuillets: 25 lines of 60 signs, 1,500 signs a page |
| Germany, Switzerland | Normseite: 30 lines of 60 characters |
| Italy | Cartella: 30 lines of 60 battute |
| Spain, Portugal, Brazil | A4, 1.5 spacing, characters with spaces |
参加文学奖?用笔名提交稿件,不要写你的名字或联系方式。Musset 还可以导出 Word(.docx,带有你的编辑可以使用的样式)和 EPUB。


导入书籍
欢迎屏幕可以打开已有的书籍,并保持原始文件不变:
- 一个 Markdown 文件文件夹:它们会原样成为章节。
- Word:一个 .docx,按照其标题切分为章节和场景。
- Scrivener:一个 .scriv 项目。
- Ulysses:以 Markdown 导出的文稿。
价格与 Musset Sync
Musset 在 beta 期间免费。从 1.0 版本起,它将一次性收费 US$9.90。它仍以 GPL 保持开源:你始终可以从这个仓库自行构建。
Musset Sync(每月 €4.99)是其背后的可选服务:
- 你的书籍存储在云端,并带有完整历史记录;
- 同一本书在你所有的 Mac 上,离线优先;
- 与编辑或 beta 读者共享一本书,他们无需付费;
- 谁写了什么,以及他们的更改作为修正返回。
Sync 构建在 git 之上:Musset 推送和拉取你书籍的历史记录;你的文件本身不会有任何改变。
磁盘上的你的书
文章标题:Show HN: Musset,开源版 Scrivener 替代品,内置一个从不代笔的 AI
正文: 一本书就是一个文件夹。Musset 只读写其中的章节文件、bible/ 文件夹和隐藏的 .musset/ 文件夹;文件夹里的其他内容一概不动。
My Book/
├── 01_the_ferry.md 章节:纯 Markdown,每章一个文件
├── 02_the_salt_works.md
├── bible/ 人物、地点、时间线、文档、弃稿
└── .musset/
├── book.json 标题、作者、语言、章节顺序、导出预设
├── notes/ 旁注,每章一个文件
├── versions/ 章节的其他版本
├── plot.json 情节网格
├── exports/ PDF、DOCX 和 EPUB 文件
└── … 评分标准、写作规则、词典、状态(被 git 忽略)
- 场景用单独一行的注释标记:<!-- scene: Morning crossing -->。
- 脚注是 Markdown 脚注:text[^1] … [^1]: The note。
- 历史记录就是书文件夹里的一个普通 git 仓库。写作时 Musset 会自动提交;无需任何 git 知识。
快捷键
| ⌘K | 命令栏 |
|---|---|
| ⌘1 · ⌘2 · ⌘3 · ⌘4 · ⌘6 · ⌘7 | 章节 · 笔记 · 聊天 · 统计 · 规划 · 历史 |
| ⌘5 | 情节网格 |
| ⇧⌘E · ⇧⌘R | 修改 · 阅读 |
| ⇧⌘D · ⇧⌘T | 专注模式 · 打字机滚动 |
| ⌃⌘K · ⌃⌘U | 亭模式 · 极致专注 |
| ⌃⌘R · ⌃⌘M · ⌃⌘L | 重复检测 · 小地图 · 行号 |
| ⌥⌘N · ⇧⌘N | 添加笔记 · 在此新建场景 |
| ⇧⌘M | 评论 |
| ⌥⌘] · ⌥⌘↩ · ⌥⌘⌫ | 下一条修改建议 · 接受 · 拒绝 |
| ⌘; | 下一条校对建议 |
| ⇧⌘F · ⌥⌘F | 搜索全书 · 查找与替换 |
| ⌘E · ⌘S | 导出 · 保存快照 |
| ⌥⌘H · ⌥⌘B | 历史 · 谁写了什么 |
| ⇧⌘H | 所有书籍 |
隐私
- 在你的 Mac 上:你的书、它们的历史、排版、拼写和语法(LanguageTool 在本地运行)。
- 仅当你开启 AI 并主动请求时,才会发送给 AI 提供商:该功能所需的段落或章节,通过你自己在该提供商处的账户发送,并受其条款约束。
- 仅当你添加自己的 Pangram 密钥并运行检查时,才会发送给 Pangram:正在被检查是否为 AI 写作的段落。密钥保存在你的钥匙串中。
- 仅当你订阅时,才会发送给 Musset Sync:你书籍的文件和历史。
- 仅当你选择使用 languagetool.org 而非 Musset 内置的 LanguageTool 时,才会发送给 languagetool.org。
- 仅当你查阅某些内容时,才会发送给 Apple Maps、Open Library 或 Crossref:你在画板上搜索的地点,或你添加的资料来源的 ISBN 或 DOI。
- 更新检查。Musset 每天向 musset.app 询问一次是否有新版本。服务器会按日期、版本和国家向计数器加一,下载也做同样处理。不保留任何地址和标识符;代码在 website/stats 中。
- 无分析、无追踪、写作无需账户。
安装
从 musset.app 下载 DMG,打开后将 Musset 拖入 Applications。它由 Apple 签名并公证,此后会自动更新。
需要 Apple 芯片上的 macOS 14 Sonoma 或更高版本。Intel Mac 的版本正在测试中:见 issue 1。
从源码构建
你需要 Xcode 26.5(旧版本可能无法编译)、Rust 和 XcodeGen。
brew install xcodegen
git clone https://github.com/Musset-App/musset.git musset && cd musset
scripts/build-typeset.sh --mac-only # 排版器(Rust,基于 Typst 库);会添加所需的 Rust 目标
xcodegen generate
open Musset.xcodeproj # 或:xcodebuild -scheme Musset build
首次构建会下载并校验以下内容(每项都对照固定的 SHA-256),保存到 ~/Library/Caches/Musset-build:
- pandoc 3.9.0.2(scripts/fetch-pandoc.sh),用于 DOCX、EPUB 和 Word 导入;
- LanguageTool 6.6,裁剪为六种语言,附带一个由 Eclipse Temurin 21 通过 jlink 生成的小型 Java 运行时(scripts/fetch-languagetool.sh)。
Typst 不是独立程序:它由 scripts/build-typeset.sh 作为库内置到 Musset 中。
一个已签名并公证的 DMG(需要 Developer ID 和通过 xcrun notarytool store-credentials AC_NOTARY 存储的公证凭据):
MUSSET_SIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" zsh scripts/package.sh
zsh scripts/package.sh --sign-only # sign, no notarization
默认情况下,应用会针对 Apple silicon 构建。MUSSET_ARCHS="arm64 x86_64" 会为两种芯片构建一个应用,MUSSET_ARCHS=x86_64 则只为 Intel 构建一个。
package.sh 会为打包的工具、Java 运行时以及 LanguageTool 的 jar 包内的原生库签名,对应用和 DMG 进行公证,为两者 stapling,并用 Gatekeeper 检查结果。
Tests
xcodebuild test -project Musset.xcodeproj -scheme Musset
要在使用 Musset 的同时运行测试,请为测试提供独立的构建文件夹和 bundle id,这样已打开的应用不会受到影响:
xcodebuild test -project Musset.xcodeproj -scheme Musset -derivedDataPath /tmp/musset-tests \
PRODUCT_BUNDLE_IDENTIFIER=dev.scratch.musset.tests
读取作者自己书籍的测试会在此处跳过:这些书籍不在本仓库中。
有些测试仅在请求时运行,因为它们会调用 AI、需要真实书籍或渲染截图。除非设置了相应的环境变量(传给 xcodebuild 时前缀为 TEST_RUNNER_),否则这些测试会被跳过:
| 变量 | 运行内容 |
|---|---|
| MUSSET_LIVE=1 | 实时 AI 调用(情节索引、批评意见、真实书籍的导出) |
| MUSSET_SNAPSHOT=<dir> | 屏幕和面板的截图 |
| MUSSET_SITE_SHOTS=<dir> | 本 README 中的截图,基于演示书籍 |
| MUSSET_PROOF_BOOK=<book> | 校对真实书籍(使用 MUSSET_ARBITER_REAL=sonnet 启用 AI 仲裁器) |
| MUSSET_PERF=1 | 在真实书籍副本上的耗时测量 |
Project layout
Musset/
├── App/ app state, a book’s session (chapters, versions, tracks, Word review), kiosk mode
├── Editor/ the text view, keyboard modes, typography, revisions, focus, minimap
├── Model/ the book on disk: manifest, chapters, scenes, languages
├── Notes/ margin notes
├── Bible/ the Bible, todos, quick capture
├── AI/ the editor inside: notes, critique, rubric, checkers, chat, proofreading, LanguageTool
├── Export/ Typst, pandoc, Word round trip, manuscript norms
├── Git/ history, tracks, sync
├── Collab/ accounts, sharing, who wrote what
├── Views/ the interface
└── Resources/ fonts, Typst templates, rubric, translations
MussetTests/ unit, integration and opt-in live tests
MussetReader/ Musset Reader for iPhone and iPad
musset-typeset/ the typesetter: Rust, on the Typst library
Packages/ MussetPage, the Swift package around the typesetter
scripts/ fetching pandoc and LanguageTool, packaging, screenshots, localization tools
website/ musset.app: the pages, the download and update functions, the counters
screenshots/ the pictures in this README
Translating the interface
界面文本在代码中以英文编写,并在 Musset/Resources/Localization/<language>.json 中查找:
Text(L("Export…")) // a plain string
Text(L("\(count) notes may lose their passage.")) // {%0} in the key; "one"/"other" forms in the tables
Text(L("Done", ctx: "Écrit")) // two senses of the same English, told apart
- 新字符串需要在每个表中都有条目(fr、de、es、it、pt-BR、pt-PT;en.json 仅用于复数形式)。
- python3 scripts/l10n-migrate.py --keys 会列出代码中的每个键;LocalizationTests 会检查每种语言是否都包含所有键,且占位符相同。
- 书籍本身中印刷的词语(Contents、Acknowledgements……)遵循书籍的语言,在 BookTerm 中定义。
Contributing
欢迎提交 issue 和 pull request。以下几点原则指导哪些内容会被纳入:
- Musset 从不生成作者的文本。功能可以阅读、引用、提问和注释;它们不会为书籍撰写正文。
- 作者的文件是神圣的。Musset 只写入章节文件、bible/ 和 .musset/,并且绝不会在没有恢复途径的情况下删除任何内容。
- 关闭 AI 后一切功能照常可用。
- 键盘优先;默认保持安静。每项功能都要在界面中证明自己的价值。
- 用真实文本做测试。每次改动都新增或更新测试;提交 pull request 前运行完整测试套件。
许可证
Musset 是自由软件,依据 GNU General Public License 第 3 版发布——见 LICENSE。应用随附的程序和字体保留各自的许可证,列于 THIRD-PARTY-NOTICES.md。
“Musset”及其图标用于标识官方应用;修改版请另取名称。