Presswork 使用手册 (ZH)

本手册涵盖 Presswork 的全部功能，并为应用的每个区域提供引导式说明。

1. 概览

Presswork 是一款面向出版与自出版的专业 Markdown 编辑器。它将纯净写作、编辑工具（风格、梗概、版本）与专业导出（PDF、PDF/X、EPUB、DOCX、HTML、ICML、FDX）融为一体。内置 Typst 用于快速 PDF，并支持 LaTeX + Ghostscript 生成认证的 PDF/X。

2. 要求与安装

• 内置：Pandoc、Typst（基础 PDF）、内部引擎。
• 可选（Pro）：LaTeX 与 Ghostscript，用于认证的 PDF/X。

在哪里检查：

• 设置 → 应用 → 安装组件 → 打开完整导出检查：验证与安装指引。

3. 模式与许可（Base / Pro）

• Base：简化界面，Typst 快速 PDF，选项较少。
• Pro：PDF/X、预检、多重导出、进阶选项与完整编辑工具。
• 可通过顶栏的 Base/Pro 开关快速切换；完整方案与许可在 设置 → App → 工作视图 中管理。

4. 主界面

• 顶栏：快速访问文档、工具、导出、视图、许可、手册。
• 编辑器：带工具栏和快捷键的 Markdown 区域。
• 侧边栏：Outline、Snapshot、Backlink、Scrivener。
• 状态栏：字数、字符、行/列、目标。

5. 文档菜单

• 新建：创建新文档。
• 保存 MD / 另存为…：保存为 .md。
• 导入文档：Word（.docx、.doc）、ODT、HTML、Markdown、PDF、ICML、Final Draft。图片会随文字一起进来：Word 文档中的图片——包括以图片形式粘贴的 Excel 表格——以及 PDF 中嵌入的图片，都会提取到导入文件旁边的文件夹里。PDF 中属于矢量绘图的内容（很多图表都是）不是图片，无法提取。
• 打开项目：加载按章节组织的项目。
• 结构模式：管理章节/顺序。
• 管理项目：创建/更新编辑项目。
• 打印：打印当前文档。
• 时间线（历史 分区）：自动保存下来的节点与恢复（Ctrl/Cmd + Shift + H）。
• 版本（历史 分区）：书的其他版本，与付印的定稿并列（§29）。

推荐流程：

1. 创建文档或项目。
2. 经常保存。
3. 用「时间线」回到之前的某个节点。

6. 工具菜单

• 目标：每日或按文档的字数目标。
• 统计：写作趋势、节奏、难度、心流。
• 用户指南：内置手册。
• 导出检查（LaTeX/Ghostscript）：不在这个菜单里，而在 设置 → 应用 → 安装组件（“打开完整导出检查”）。
• Command Palette：命令搜索（Ctrl/Cmd + P）。
• 风格分析：重复、可读性、语气、包容性。
• AI 助手：摘要、改写、一致性。
• Vim 模式：不在这个菜单里，而在 设置 → 编辑器 → 写作模式（或 Ctrl + Alt + V）。
• Collab：实时协作会话，通过会话 ID 快速邀请；文本、聊天和附件经由 PressWork 的中继转发（见 §20）。
  • 快速开始：打开 工具 → Collab，设置你的名字，创建或粘贴会话 ID（pw-...），点击连接。
  • 通话中：使用浮动面板上的麦克风和摄像头开关；语音和视频通过 WebRTC 直接传送，网络不允许时则经由转发服务器（TURN）：无需任何设置。
• 导览：特殊格式的引导之旅。
• 数字签名：用证书签署 PDF（Pro）。

7. 导出菜单

主要格式

• PDF（Typst，快速）
• PDF/X（LaTeX，认证）
• 剧本 PDF（好莱坞）
• FDX（Final Draft）
• DOCX / ODT
• EPUB
• HTML
• ICML（InCopy/InDesign）

选项

• PDF 样式：选择 PDF 模板。
• PDF/X：ICC 配置文件、校验、字体嵌入。
• 裁切标记：在「专业印刷选项（PDF）」中。用于 KDP 的内文始终不带裁切标记。
• EPUB 元数据 + 封面。
• 预检：质量与印刷检查清单。
• 导出历史：导出日志。
• 多重导出：多个文件合为一个。
• 多格式导出：PDF + EPUB + HTML 等。
• 随资源导出：包含图片/资源。
• 转换文件夹：批量转换。

8. 视图菜单

• 模式：写作、MD 代码、页面视图。
• 语言（9 种）：不在这个菜单里，而在 设置 → 应用 → 界面语言。
• 主题：设置 → 应用 → 主题，🌙 深色 / ☀️ 浅色，也可以通过 Command Palette。
• 打字机（当前行居中）：设置 → 编辑器 → 写作模式 → 打字机模式。
• 专注模式：隐藏界面（F11）。
• 演示：全屏幻灯片。
• 无障碍（文字大小、高对比度、阅读障碍友好字体）：不在这个菜单里，而在 设置 → 编辑器 → 文本与排版。

9. 编辑器工具栏

• 格式：加粗、斜体、下划线。第一次点击应用格式并保持该词选中，第二次点击恢复为普通文字（代码同样适用）。
• 标题：H1/H2/H3。
• 元素：链接、图片、行内/块级代码。
• 列表：无序/有序。
• 引用。
• 表格。
• CriticMarkup：插入、删除、批注。
• 模板：排版预设。
• 元数据：YAML front matter。
• Snapshot：场景快照。
• 梗概：按章节的摘要。

10. 侧边栏面板

• Outline：章节导航。
• Snapshot：快照管理。
• Backlink：文档间的链接。
• Scrivener：章节与拖放。
• Scene Navigator：用于剧本。

11. 用 Markdown 写作

基本语法

• # 标题 / ## 副标题
• **加粗**、*斜体*
• - 列表 / 1. 有序列表
• [链接](url)
• ![alt](图片)
• > 引用
• \newpage 分页
• 行内 $E=mc^2$，单独一行 $$ … $$：公式

小贴士

• 拖放图片即可插入。
• 用 Split 或预览检查排版。
• 公式，无需联网：预览中离线即可显示（PressWork 启动时不下载任何东西）。预览中是公式的，在 PDF、PDF/X、打印、快速 PDF、ePub 和 HTML 中也输出为公式，反之亦然：像「$50」这样的价格仍是普通文字。只有在打印和快速 PDF 中，\cancel 会按原样输出，\color 会失去颜色，但 PDF 照样生成。
• Emoji：在 PDF 中正常显示，不再是方块；普通 PDF 中为彩色，PDF/X 中为黑色。

12. 模板

• 预置模板：从工具栏访问（Tpl）。
• 自定义模板：
  • 导入单个文件或整个文件夹（模板菜单 → 「导入文件 / 导入文件夹」）。
  • 自动分类到标签页：css→UI Kit，xlsx/xls/ods/csv→Business，其余→文档。
  • Custom 徽章，悬停显示完整提示（名称 + 描述）。
  • .md：可加载到编辑器。
  • .tex/.pdfx/.pdft：可用作 PDF 导出样式。
  • .xlsx/.xls/.ods/.csv：可用于数据表/报表流程。
• UI↔PDF 自动配对：CSS 主题可自动匹配 PDF 模板（开关 + 解除配对）。
• 共享库：保存共享的排版预设。
• 模板功能完整参考：docs/template-functions-overview-en.md。

13. 元数据与 front matter

• 顶部栏的 元数据 打开「🏷 管理元数据」；在编辑中心里，「编辑元数据（标题、作者…）」也会打开它：标题、作者、语言、日期、ISBN、出版社、类型、标签。
• 语言，位于标题和作者下方：九种语言各以本身的文字列出（Italiano、English (US)、English (UK)、Español、Français、Deutsch、中文、Русский、العربية、עברית）；选「其他…」可填写 pt-BR 或 de-CH 这样的代码，错误的代码不会被保存。语言对 ePub 和各种 PDF 都有效：断字、引号、目录标题（例如「Indice」或「Contents」）。中文、日文和韩文在经 LaTeX 生成的 PDF 和 PDF/X 中仍为意大利语，窗口会提示这一点。选「未指定」时，ePub 采用应用的语言，PDF 采用意大利语。
• 语言会成为文档中的 lang: 行：如果你曾手动写过这一行，会在窗口中看到它。「出版社」和有效的 ISBN 会写入 ePub（ISBN 不写入 PDF），页面格式（Page size 字段）会成为导出的「纸张」，.md 也一样。
• YAML front matter 保证导出一致。
• EPUB：强烈建议设置封面与元数据。

14. 项目与结构模式

1. 文档 → 管理项目。
2. 创建项目文件夹。
3. 添加章节（.md）。
4. 拖放重新排序。
5. 按自动顺序导出全部内容。

15. 导出详解

15.1 基础 PDF（Typst）

• 快速，无需 LaTeX。
• 适合草稿与审阅。

15.2 PDF/X（LaTeX）

• 使用认证模板。
• 需要 LaTeX + Ghostscript。
• 支持 ICC、校验与预检。

15.3 剧本 PDF

• 好莱坞版式。
• 兼容 Fountain。

15.4 FDX（Final Draft）

• 面向影视工作流的导出，附带 .breakdown.json 报告（场景、角色、标签）。
• 同步对白：在第二个角色名后加 ^（GUIDO^）——在 Final Draft 中两段台词并排显示（原生 dual dialogue）；导入 .fdx 时 ^ 会自动恢复。
• 制作标签：右键选中的词 → 标记制作元素，或在行尾写 [[prop: 手电筒]] 或 #prop: 手电筒。在 FDX 中它们成为 Tagger 原生标签（词高亮、类别进入 breakdown）；其他格式会移除标记；在 Final Draft 里打的标签导入时会回来。
• 主要键名（意大利语或英语）：prop、costume、vehicle、sound、music、makeup、animal、effects、location、note。
• 标题和作者（front matter，或文档开头的 # 标题 + "by …"）会进入 Final Draft 的 Title Page。

15.5 DOCX/ODT

• 通过 Pandoc 转换。

15.6 EPUB

• 建议设置元数据 + 封面；元数据中的「语言」（§13）决定阅读器如何断字和朗读。
• 兼容数字商店。

15.7 HTML

• 带资源的网页输出。

15.8 ICML

• 为 InDesign/InCopy 映射的样式。
• 标题、列表、引用与剧本转换为专用样式。
• 内置模板预设 + 自定义 .icml 导入。
• 真实脚注（由 InDesign 编号）、带目标的链接、含表头与对齐的表格、作为链接框架的图片（链接面板）、上下标与小型大写——在单元格、脚注和链接内同样有效。
• 忠实再导入：导出的 ICML 在 PressWork 中重新打开后文档保持不变（往返已在 CI 中验证，长篇书稿亦然）。

15.9 Excel

• 带场景、角色与制片分解的 Excel 导出。
• 模板支持：写入现有工作表以保留基础样式。
• 多工作表导入为 Markdown 表格（含类型/单元格元数据）。
• 导入时可选择工作表与范围，避免多余数据。
• Chart Mapper：可选，从 Excel 数据生成预览图表。

16. 高级导出

• 多重导出：合并多个文档。
• 多格式导出：在一个文件夹中生成 PDF+EPUB+HTML。
• 随资源导出：复制图片与资源。
• 导出历史：日志与结果。

17. KDP（Amazon）

• 编辑中心（顶部按钮）：Amazon KDP 的工具，分为五个标签页：导出、封面、验证、计算器、AI。
• 🚀 导出 KDP（PDF + ePub） 生成要上传的文件：书名_interior.pdf（已安装 LaTeX 时为 PDF/X，否则为普通 PDF；始终不含封面和裁切标记）、书名_ebook.epub，以及在「封面」标签页中选了封面时的 书名_cover.pdf。完成后，「打开」会打开内文。
• 封面 → 纸质书封面：该标签页给出展开封面的尺寸（整个封面的毫米和英寸、书脊、出血），按导出中选择的「纸张」（A4、A5、US Letter）以及计算器中的纸张类型和页数计算。用「选择展开封面…」选择已经做好的封面（PDF、JPG 或 PNG），PressWork 会立即检查它的尺寸：带裁切标记的 PDF 需要去掉标记重新导出，按成品尺寸制作的封面缺少出血，低于 300 DPI 会有警告。「移除」可以把它去掉。
• 尺寸不符时不会写出封面，提示信息会说明需要的尺寸。没有封面时导出照常进行，封面可直接上传到 KDP。所选封面只对当前打开的书有效，重启后不会保留。
• 计算器：根据页数和纸张（奶油纸、白纸、标准彩色、高级彩色）给出书脊厚度和最小内侧边距。标准彩色没有 A4，并且 72 页起才能印刷。
• KDP 模板：三个文本骨架（小说 6x9、随笔 6x9、自助 5x8）；选中的模板经确认后会替换编辑器中的文本。
• ePub 校验器：检查清单、Kindle 预览与可下载报告。

18. 风格分析

• 长句、重复、被动语态。
• 行内建议。
• 可读性指标。

19. AI 助手

• 摘要、改写、一致性、标题。有选区时，「插入到编辑器」不会直接替换，而是提出建议，由你在正文中决定（§36）。
• 菜单中已备好云端服务：OpenAI、Anthropic（Claude）、Mistral，以及 OpenRouter 之类的聚合服务。选择其一即可设定地址与模型，剩下的只是粘贴密钥。
• 每个服务各自记住自己的密钥：在服务之间切换不必每次重新输入。密钥保存在操作系统的钥匙串里，而不是应用程序的文件中。
• 本地模型：点击「检测 Ollama」即可列出你电脑上已安装的模型。那里不需要任何密钥，也没有任何内容离开本机。
• 连接测试会检查你真正在用的通道——有密钥就测云端，否则测本地——并告诉你验证的是哪一个。

20. 协作

• 共享会话：彩色远程光标、行内评论、实时同步。
• 会话期间内置语音/视频通话。
• 可分享的会话 ID（pw-...），快速邀请其他用户。

使用方法（分步）

1. 打开 工具 → Collab，选择一个易识别的名字。
2. 创建新会话，或粘贴同事发来的 ID。
3. 等待 Online 状态，在协作坞中确认参与者。
4. 需要语音/视频时，从 Collab 面板发起通话，使用静音/摄像头按钮。

数据如何传输

• 文本、聊天和附件经由 PressWork 的连接服务器（中继）转发给其他参与者，服务器不作保存：无需任何设置。如果中继没有响应，PressWork 会尝试让参与者直接互连。
• 语音和视频通过 WebRTC 传输：在参与者之间直接传送，网络不允许时则经由转发服务器（TURN）。
• 连接在传输途中受到保护，但文本、聊天和附件没有端到端加密：连接服务器在转发时能看到这些内容。因此协作功能不适合处理保密材料。
• 任何拿到会话 ID 的人都能加入：只把它交给你邀请的人，就像交出一把钥匙。

21. 数字签名

• 用 PAdES-T 证书签署 PDF。
• RFC 3161 时间戳（需要网络）。

22. 演示

• 将文档变成幻灯片。
• 可配置的版式与配色。

23. 无障碍

• 文字大小 12–18px：设置 → 编辑器 → 文本与排版。
• 高对比度（菜单和窗口）：在同一部分。它改变菜单、工具栏和窗口；正文页面保持不变。
• 菜单使用阅读障碍友好字体：在同一部分。如果系统中已安装 OpenDyslexic 或 Atkinson Hyperlegible，就使用它们（PressWork 不自带这些字体），只作用于菜单，不作用于正文。

24. 主要快捷键

• Ctrl/Cmd + S → 保存
• Ctrl/Cmd + N → 新建
• Ctrl/Cmd + P → Command Palette
• Ctrl/Cmd + Shift + P → 演示
• F11 → 专注模式
• Ctrl/Cmd + B/I/U → 加粗/斜体/下划线（再按一次即取消）
• Ctrl + Alt + V → Vim

25. 疑难解答

• PDF/X 不可用：安装 LaTeX + Ghostscript 并重启。
• 导出失败：阅读提示信息，它会说明哪里出了什么问题（§35）。
• 看不到模板：使用「打开模板文件夹」并检查扩展名。
• 导出缓慢：草稿阶段可关闭校验。

26. 常用路径

• 自定义模板：用户配置目录下的 presswork/templates 文件夹。
• PDF/X ICC：presswork/pdfx 文件夹。

Presswork 将简洁与专业编辑工具合而为一：用 Base 快速写作，用 Pro 出版。

近期更新（Data Hub / 图表）

• 从 Excel Data Hub 插入图表时，现在编辑器中也会立即显示图片预览，而不仅是预览面板。
• 行内预览已缩小（约 50%），写作时更不打扰。
• 双向切换：📝 显示代码 打开 chart-data 块，🖼️ 返回图表 恢复图片视图。
• chart-data 块仍保留在 Markdown 中，以保证预览/渲染/导出的兼容性。
• 以图片方式插入表格或图表时，文件现在保存到文档资源（文档名.assets/images/），编辑器中只写入 Markdown 引用：即使工作表非常大也能正常工作。
• 若文档尚未保存，应用会提议立即保存（与拖放图片相同）；拒绝时表格以 Markdown 文本插入，图表留在工作表中。
• 文本/图片询问也能理解「png」「jpg」「图片」「照片」等回答；无法识别的回答会重复提问。
• 数据网格跟随当前的浅色/深色主题。
• 另存为模板：窗口按应用风格重新设计并已翻译。需要网格中有数据且编辑器中有含 {{列名}} 占位符的模型；「生成 Markdown」会为每一行重复该模型。
• Excel 导出（分解表）：读取编辑器文本（INT./EXT. 场景或 # 章节）；找不到场景时现在会提示，而不是生成空文件。
• 精简 Tables 菜单：移除重复项「作为模板导入」（与「打开 Tables 工作表」相同）。
• 导入/导出面板：新增批量标签页（在基础格式 / 专业打印 / 剧本 / 出版旁边），汇集批量操作：转换文件夹、多重导出、多格式、随资源。高级选项只显示与所选格式相关的内容。
• 🧪 校验 ICML：在导出面板（ICML 格式）检查生成的文档——层级、front matter、转义、空段落——不向磁盘写入任何内容；详情显示在应用内的窗口中。每次 ICML 导出也会执行同样的校验。
• 更安全的 FDX 导出：普通 Markdown（列表、表格、注释）总是转换为 Action——绝不会意外成为角色/对白；真正的剧本仍被解析（场景、角色、台词、转场）。\newpage 成为真正的分页（在 ICML 中也是，通过可重映射的「分页」样式）。
• 通过 PDF 打印：打印按钮生成临时 PDF（Typst，与导出相同的排版）并在系统查看器中打开——从原生对话框打印，预览忠实。
• 设置重新排列：安装组件区域（一键安装 LaTeX、Ghostscript 状态）、语言紧凑视图、深色/浅色主题芯片。AI 面板的快捷提示可折叠。

27. 功能深度解析（补齐盲区）

本节补充那些因在菜单中不显眼而常被忽略的高级功能。

27.1 AI：配置、诊断与回答质量

• 可配置的云端/本地 endpoint（兼容 OpenAI、Ollama、LM Studio），通过变量 PRESSWORK_AI_ENDPOINT、PRESSWORK_AI_MODEL、PRESSWORK_AI_API_KEY 设置。
• AI 连接诊断，可导出 JSON 报告（便于技术支持/IT 团队）。
• 回答风格控制（简洁/均衡/详尽）、技术提示词预览与上次提示词重试。
• 按项目固定 endpoint/模型：在不同文档间保持编辑一致性。

27.2 统计：计算方法（实操）

• 平均生产力：按每日历史计算（7 天 / 30 天）。
• 写作速度：总字数除以会话窗口（字/小时与字/分钟）。
• TTR（Type-Token Ratio）：独立词数 / 总词数。
• MSTTR：按 50 词窗口的平均 TTR（降低长文本的偏差）。
• 实时心流状态：平均击键间隔 + 近期删除比例。
• 完成预测：用 7 天与 30 天平均值给出乐观/悲观估计。

27.3 快速指南中缺失的高级导出

• Final Draft（.fdx）：将标题映射为真正的 Scene Heading，支持注释/分页/场景编号，并生成 .breakdown.json 附属文件。
• ICML：高级排版映射（标题/列表/引用/剧本）+ 预设 + 自定义 .icml 导入。
• EPUB/ICML 向导：在最低限度的元数据（标题/作者/ISBN）与封面设置完成前阻止导出。
• PDF 签名：PKCS#7 detached + RFC 3161 时间戳。

27.4 Bundle 模式（.pwk）

• 主要操作：导出并选择目标位置。
• 自动输出目标，减少手动路径错误。
• 顶栏开关可临时显示经典的快速导出。

27.5 真实场景中的协作

• 可分享的会话 ID pw-...、彩色远程光标、行内评论、实时同步。
• 语音/视频通话集成在同一编辑会话中。
• 文本、聊天和附件经由 PressWork 的中继转发（无法设置自己的中继），中继不作保存；内容没有端到端加密，因此不适合处理保密材料（见 §20）。

27.6 模板系统（专业用途）

• 文件/文件夹导入并自动分类（Business / 文档 / UI Kit）。
• 支持二进制与电子表格模板，用于报表流程。
• UI↔PDF 自动配对，连接编辑器主题与导出样式，可解除配对。

27.7 推荐的操作检查清单

1. 根据交付物设置 Base/Pro 模式。
2. 在导出检查中验证先决条件（设置 → 应用 → 安装组件；仅当需要 PDF/X 时才需 LaTeX/Ghostscript）。
3. 交付前运行预检。
4. EPUB/ICML 需完成元数据 + 封面向导。
5. 需签名的文档启用 PKCS#7 签名 + 时间戳。
6. 团队协作时，将 Collab 会话 ID 写入内部说明。

28. 连接助手（MCP）

从 4.2 起，PressWork 可充当 MCP 桥梁：聊天 AI 助手（Claude Desktop、Codex CLI、Gemini CLI…）直接在你的电脑上读取 .pwk 项目——章节、笔记、统计——无需复制粘贴。从不写入正文：本桥梁有八个读取工具，并且只在你允许的文档上，提供两个留下建议、由你来决定的工具（§36）。没有任何工具会改动正文。你所连接的助手若自带访问电脑文件的工具，那些工具不经过 PressWork。

• 一键配置：设置 → AI → 连接助手（MCP） → 「替我配置」（Claude Desktop / Codex CLI / Gemini CLI）。连接的是当前项目所在的文件夹，包含其中所有 .pwk。
• 配置前请完全关闭助手（Claude Desktop 会在关闭时重写自己的配置），然后重新打开。写入前应用会先备份配置。
• 文件夹会累加：从不同文件夹的项目分别配置，助手就能看到全部。PressWork 关闭时也能用。
• 在 Claude 中：普通聊天在云端，够不到你的电脑——请选择**「在你的电脑上」**活动，或勾选 presswork 连接器。
• 其他 MCP 客户端（Cursor、OpenCode…）：可复制手动配置片段。通过导出专长生成教 Claude 善用你项目的 skill（添加一次，永久有效）。
• 坦诚的隐私说明：助手读取的内容会发送到其云端服务以生成回答——如同复制粘贴，只是自动的。别连接你不愿在聊天里发送的项目。
• 需要 Complete 工作视图。

29. 版本与章节变体

两种不同的工具，回答同一个问题——“要是换一种呢……”——只是尺度不同。

一个版本是另一本书。在每个版本里，每一章都可以有自己的变体。

29.1 版本

• 版本是整个文档的另一种写法：换个结局、去掉一个人物、试另一种结构。定稿，也就是要付印的那一版，保持不动。
• 面板：Ctrl/Cmd+Shift+B 或从菜单打开。打开一个版本就是进入它：从那一刻起你写的是这个版本。
• 你在哪里，随时看得见：窗口底部会出现带版本名的标签。没有标签 = 你在定稿上。
• 设为定稿让这个版本成为付印的文本；之前的文本不会丢失，会作为时间线中的一个检查点保留，可以恢复。比较逐行显示与定稿的差异。**复制到新文档…**把版本拆成一个独立的 .pwk。
• 所有版本都在同一个 .pwk 里：没有多余文件，不需要 Git。
• 梗概卡片会告诉你岔路在哪里：在每张章节卡片上，如果该章节在某个版本里不同，就会出现该版本颜色的标记；如果那里没有这一章，标记会加删除线。点击即可打开「版本」。在所有版本中都相同的卡片保持干净：没有标记就表示「这里没有分岔」。身处某个版本时，比较也包含定稿——探索另一条路时，正是要和它对照。
• 只存在于别处的章节不会被忽略：需要时，梗概底部会列出只存在于另一个版本中的章节。这对改过标题的章节尤其有用，因为章节是靠标题识别的。

29.2 章节变体

• 变体是同一章的第二个版本：纸上写作时划掉一段、在旁边重写的那个动作。正文里只有一个是活的，也正是输出到文件里的那个。
• 新建：大纲（摘要）→ 鼠标移到章节卡片上 → 右上角 ⑂。当前文字成为第一稿；新的由你命名。
• 切换：点击卡片上的 ⑂ 标签并选择。当前的标有“在正文中”。只有这一章会变。
• 删除：菜单里的垃圾桶。使用中的变体不能删：先切换到另一个。
• 在哪里看到：状态栏、字数旁边——⑂ 变体：名称。如果光标所在章节没有变体，也会用灰字说明。
• 每个版本有自己的变体：在某个版本里创建的不会出现在定稿上，这是有意为之。

29.3 如果对不上了

• 改了章节标题，变体不见了：并没有丢。大纲底部有一条**“无章节归属的变体”**，收着当前找不到位置的一切；用“指派给…”菜单把它们放回原处。PressWork 会尝试自动跟随被改名的标题，但拿不准时，它宁可把材料摆给你看，也不去猜。
• 撤销在这里同样有效：切换变体和其他编辑一样（Ctrl/Cmd+Z）。
• 在磁盘上：.pwk 里的 versions/branches/<id>/ 和 versions/variants/。都是普通 .md 文件：即使没有 PressWork，作品照样能读。

30. 概览表视图、交稿日期与 4.4 的其他新功能

30.1 概览表视图与交稿日期

• 在大纲面板中，概览表视图以表格形式列出各章：每章的字数目标、已写字数以及两者之间的差值。拖动行即可重新排序，新顺序会应用到真实文档。
• 表格底部汇总全局：文档目标、已分配给各章的数量、尚待分配的数量。面向印刷：最后一行估算页数，并提示距离 16 的倍数（印刷帖）还差多少页。
• 在**🎯 目标窗口（顶栏按钮）中可以添加交稿日期**：概览表底部会显示剩余天数和每天需要写多少字——按已写字数计算，而不是按目标。它是可选的，选择每日目标时会隐藏；达成目标后，节奏提示即安静下来。

30.2 更新窗口

• 有新版本时，启动几秒后会出现一个窗口，告知可用版本与当前版本。**「新变化」会以你的语言打开更新日志；「立即更新」下载并重启；「稍后」**直接关闭，不再打扰——下次启动时会再次提示。

30.3 助手的两种语言

• 助手用应用界面的语言与你交流，用手稿的语言写作：应用为中文、小说为英文时，说明以中文呈现，正文仍保持英文。想让文本换语言时，请明确要求翻译。

31. 导入 Markdown 文件夹（Notion、Obsidian、笔记）

• 文件与项目 → 导入 Markdown 文件夹：选择一个 .md 文件夹——Notion 导出（导出 → Markdown 与 CSV，包含子页面，然后解压）、Obsidian 仓库（本身就是文件夹）或笔记文件夹。PressWork 显示真实结构并询问书从哪里开始：所选位置下的一级条目成为章节，更深层的成为小节。在文件夹旁新建一个 .pwk；原文件夹不会被改动。
• Notion 与 Obsidian 会被自动识别：标题中的十六进制代码被去掉，小数据库 → 表格、大数据库 → 笔记，数据库行被排除，标注框 → 引用；[[wikilink]] 与嵌入按名称解析，front matter 被移除。图片被复制到文档中；书内页面之间的链接变成交叉引用，指向外部的链接变成文本。
• 最终报告说明什么进来了、什么没有——页面、章节、已复制与未找到的图片、已重写与已转为文本的链接、表格、未纳入的文件、已闭合的代码块。为零的条目同样显示。

32. 另存为、导出为、从系统打开（4.5）

• 另存为…（文件与项目，保存 旁边）：对 .md 以所选名称保存副本并继续在副本上工作；对 .pwk 复制整个文档——正文、元数据、图片、笔记、历史、版本——并打开副本，不含 exports/ 中的输出。部分标题始终显示当前打开的文件（“文档 · 小说.pwk”）；另存为 .pwk 文档 仅在 .md 上显示。
• 导出为…（导出面板，生成 旁边）：始终打开系统对话框选择名称和文件夹，即使常规导出不询问直接写入。文件名 字段位于 格式 下方，所选名称按文档记住，与元数据标题无关。
• 打开方式：在 Mac 和 Windows 上，PressWork 会出现在 .md 文件的“打开方式”中，但不会成为默认程序：安装后，.md 仍用原来的程序打开。双击与 PressWork 关联的 .md 即可打开该文件，即使应用已在运行。在 Mac 上（自 4.6 起）.pwk 是一个文档：双击即打开 PressWork；要查看内部内容，请右键选择 显示包内容，导出的文件可从输出标签或 共享 打开。在 Windows 和 Linux 上 .pwk 仍是文件夹：可从最近文件、拖入窗口或 打开文档 打开。

33. 用口述代替打字

• 用口述代替打字：PressWork 使用系统听写，像在任何文本框中一样输入到编辑器，并支持口述标点（“逗号”“句号”）。macOS：按两下 fn；没有 fn 时，系统设置 → 键盘 → 听写 → 快捷键，例如“按两下 Control”。Windows：Win+H。Linux 系统没有听写功能。

34. 你在哪里，哪些已保存（4.6、4.7）

• 文档名称始终可见：在左下角的状态栏中（鼠标悬停可看到完整路径），以及系统显示时的窗口标题中。在某个版本上时，旁边会出现 🌿 和版本名称；重新打开停留在某个版本上的文档时，PressWork 会回到该版本。
• 有未保存修改的 .md 名称显示为斜体，前面带“•”。在这种状态下关闭 PressWork，应用会询问是否不保存就关闭。如果仍然关闭，修改会被暂存：重新打开时，PressWork 会打开最后一个 .md 并提示恢复，之后保存即可。.pwk 会自动保存，只要保存成功，就不会询问任何事。
• 如果保存失败（.pwk 在外部被重命名或移动、磁盘已满、权限不足、U 盘被拔出），这个状态会一直显示：名称前出现「•」，底部的指示器和顶部的状态标签显示 ⚠️ 未保存，直到保存成功为止。在关闭应用、切换到其他版本、「设为定稿」或打开其他文档之前，会弹出 「文档无法保存」 窗口，并说明原因。
• 窗口中的选项：「重新保存」（重新插好 U 盘或腾出磁盘空间之后）、「保存副本…」（把文本存到别处）、关闭时的「不保存并退出」或其他情况下的「不保存并继续」，以及留在原处的「取消」。如果之后离开仍然失败，你会留在该文档中，下次还会再问。能正常保存的文档不会多问任何事。
• 如果 content.md 被其他程序修改，会出现一条横幅提示重新加载。

35. 导出与求助（4.6、4.7）

• 导出会记住每个文档上次使用的文件夹（仅限本机）。如果更改标题，exports/ 中旧名称的文件会被新名称的文件替换，避免发错文件。
• 导出之后，「已保存到：…」提示有两个按钮：打开 打开文件，在文件夹中显示 打开文件夹并选中该文件。导出 PDF/X 之后或有警告时也有这两个按钮，鼠标停在提示上时它不会消失；KDP 导出之后，「打开」会打开内文。
• 如果导出失败，提示会用应用的语言说明哪里出了什么问题：未知的 LaTeX 命令以及它出现在哪句话附近、缺少的 LaTeX 宏包及安装方法、Typst 错误及所在行、损坏的 YAML front matter。如果缺少图片，会说明缺了几张、第一张是哪张，以及在哪个文件夹中查找过。
• Word 和 ODT 采用与 PDF 相同的页面尺寸和页边距；ePub 带有目录和 PressWork 样式表，单独导出一个文档时也是如此。
• 大尺寸照片（例如手机全分辨率照片）在编辑器和预览中以缩小的副本显示，第一次约一秒生成：应用不会卡住，导出始终使用原始照片。
• 需要技术支持时：信息窗口 → “复制技术支持信息”。它会复制版本、系统和已安装的导出引擎，不含任何文本或文件名：粘贴到你的消息中即可。

36. 修订与建议，在正文中决定（4.7）

• 每个修订标记都有自己的按钮。 在插入、删除或替换旁边有 ✓（接受）和 ✗（拒绝）；高亮或批注只有 ✓（完成：移除标记、保留文字）。就在标记所在的地方逐条决定；撤销（Ctrl/Cmd+Z）可以返回。
• 助手可以提建议，但从不写入。 通过 MCP 桥梁（§28）连接的助手——Claude、Codex、Gemini——只能在你允许的文档上留下建议：点击底部的文档名 →「助手可以提出修改建议」。开启期间，名称旁会显示 ✎ AI 建议已开启：点击一下即可关闭。新文档默认关闭。
• 建议在正文之外等待。 建议到达时会出现 ✎ 来自 Claude 的建议：3：点击一下即可把它们作为标记放入正文，带有提出者的名字和理由（@Claude: …），再用 ✓ 和 ✗ 决定。撤销会一次性全部移除。它们不会自行进入：你写作时正文不会移动。
• PressWork 内置的 AI 也只提建议。 有选区时，AI 助手中的 插入到编辑器 会把 AI 的文本作为建议放入，带有 ✓ 和 ✗（跨多行时，每一行单独决定）；在你接受之前，付印的仍是原来的文字。没有选区时，像以前一样在光标处插入。有选区时，AI 只回复新的文本。
• 一次全部处理。 建议的 ✓ ✗ 旁边有 ▾，其中有「接受 AI 的全部建议（15）」和「拒绝 AI 的全部建议（15）」：只针对提出这条建议的作者，其他作者的建议和你自己的修订保持不动。撤销可以把它们全部恢复。
• 如果你在此期间改了那句话，该建议不会改动任何内容：提示条会把它计入「已不适用」，并将其舍弃。
• 你没有决定的内容不会付印。 待处理的建议不会出现在预览和任何导出中，视同被拒绝，导出菜单会显示有多少条。你自己的修订照常视为已接受。
• 笔记和梗概也可以。 助手可以建议一条新笔记（笔记、资料、人物）或某一章的梗概。通过提示条，它们会到达各自的位置：笔记出现在「笔记」面板中并带有「✎ @Claude」标签，梗概出现在该章卡片上的一个框里。你在那里保留或舍弃它们；任何内容都不会覆盖你已经写下的东西。
• 建议只针对定稿，不针对其他版本。