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 中属于矢量绘图的内容（很多图表都是）不是图片，无法提取。
• 打开项目：加载按章节组织的项目。
• 结构模式：管理章节/顺序。
• 管理项目：创建/更新编辑项目。
• 打印：打印当前文档。
• 版本：自动保存历史与恢复。

推荐流程：

1. 创建文档或项目。
2. 经常保存。
3. 用「版本」找回修订。

6. 工具菜单

• 目标：每日或按文档的字数目标。
• 统计：写作趋势、节奏、难度、心流。
• 用户指南：内置手册。
• 导出检查：验证 LaTeX/Ghostscript。
• Command Palette：命令搜索（Ctrl/Cmd + P）。
• 风格分析：重复、可读性、语气、包容性。
• AI 助手：摘要、改写、一致性。
• Vim 模式：Vim 命令。
• Collab：P2P 协作会话，通过会话 ID 快速邀请。
  • 快速开始：打开 工具 → Collab，设置你的名字，创建或粘贴会话 ID（pw-...），点击连接。
  • 通话中：使用浮动面板上的麦克风和摄像头开关；若 WebRTC 不通，配置 WebSocket 中继（presswork-collab-relay-url）。
• 导览：特殊格式的引导之旅。
• 数字签名：用证书签署 PDF（Pro）。

7. 导出菜单

主要格式

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

选项

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

8. 视图菜单

• 模式：写作、代码、预览、页面、Split。
• 语言：9 种界面语言。
• 主题：浅色/深色。
• 打字机：当前行居中。
• 专注模式：隐藏界面（F11）。
• 演示：全屏幻灯片。
• 无障碍：文字大小、对比度、阅读障碍友好字体。

9. 编辑器工具栏

• 格式：加粗、斜体、下划线。
• 标题：H1/H2/H3。
• 元素：链接、图片、行内/块级代码。
• 列表：无序/有序。
• 引用。
• 表格。
• CriticMarkup：插入、删除、批注。
• 模板：排版预设。
• 元数据：YAML front matter。
• Snapshot：场景快照。
• 梗概：按章节的摘要。

10. 侧边栏面板

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

11. 用 Markdown 写作

基本语法

• # 标题 / ## 副标题
• **加粗**、*斜体*
• - 列表 / 1. 有序列表
• [链接](url)
• ![alt](图片)
• > 引用
• \newpage 分页

小贴士

• 拖放图片即可插入。
• 用 Split 或预览检查排版。

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。
• 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

• 建议设置元数据 + 封面。
• 兼容数字商店。

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）

• Quick Export：以 KDP 命名规则导出 PDF + EPUB。
• 计算器：尺寸与页边距。
• KDP 模板：专用封面/排版。
• ePub 校验器：检查清单、Kindle 预览与可下载报告。

18. 风格分析

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

19. AI 助手

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

20. 协作（P2P）

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

使用方法（分步）

1. 打开 工具 → Collab，选择一个易识别的名字。
2. 创建新会话，或粘贴同事发来的 ID。
3. 等待 Online 状态，在协作坞中确认参与者。
4. 需要语音/视频时，从 Collab 面板发起通话，使用静音/摄像头按钮。
5. 在受限的企业网络中，设置 WebSocket 中继（localStorage 键：presswork-collab-relay-url）。

21. 数字签名

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

22. 演示

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

23. 无障碍

• 文字大小 12–18px。
• 高对比度。
• 阅读障碍友好字体。

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 并重启。
• 看不到模板：使用「打开模板文件夹」并检查扩展名。
• 导出缓慢：草稿阶段可关闭校验。

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 真实场景中的协作（P2P）

• 可分享的会话 ID pw-...、彩色远程光标、行内批注、实时同步。
• 语音/视频通话集成在同一编辑会话中。
• WebRTC 不通时（企业网络/防火墙）回退到 WebSocket 中继，通过键 presswork-collab-relay-url 设置。

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 项目——章节、笔记、统计——无需复制粘贴。只读：本桥梁没有任何写入工具，只有七个读取工具。你所连接的助手若自带访问电脑文件的工具，那些工具不经过 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，作品照样能读。