Presswork 使用手册 (ZH)

本手册涵盖 Presswork 的全部功能。

1. 概览

Presswork 是面向出版的专业 Markdown 编辑器，集写作、编辑工具（风格、概要、版本）与 专业导出（PDF、PDF/X、EPUB、DOCX、HTML、ICML、FDX）于一体。内置 Typst，PDF/X 使用 LaTeX + Ghostscript。

2. 依赖与安装

内置：Pandoc、Typst。
可选（Pro）：LaTeX + Ghostscript。

检查位置：

工具 → 导出检查。

3. 模式（Base / Pro）

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

4. 主界面

顶部菜单、Markdown 编辑器、侧边栏、状态栏。

5. 文档菜单

新建、保存、导入、项目、结构模式、打印、版本。

6. 工具菜单

目标、统计、用户指南、导出检查、命令面板、风格分析、AI、Vim、协作、导览、数字签名。

7. 导出菜单

格式：PDF、PDF/X、剧本 PDF、FDX、DOCX/ODT、EPUB、HTML、ICML。选项：PDF 样式、ICC、验证、预检、历史、多重导出、多格式、资源导出、批量转换。

8. 视图菜单

写作/代码/预览/页面/分屏、语言、主题、打字机、专注、演示、无障碍。

9. 工具栏

格式化、标题、链接、图片、代码、列表、表格、CriticMarkup、模板、元数据、快照、概要。

10. 侧边栏

大纲、快照、反向链接、Scrivener、Scene Navigator。

11. Markdown

基础语法 + \newpage。支持拖拽图片。

12. 模板

内置 + 自定义。

.md 可加载到编辑器。
.tex 作为 PDF 样式。
共享库。

13. 元数据

YAML front‑matter、EPUB 元数据与封面。

14. 项目

章节管理、顺序、整体导出。

15. 导出细节

PDF（Typst）、PDF/X（LaTeX）、剧本 PDF、FDX、DOCX/ODT、EPUB、HTML、ICML（样式映射，预设模板 + 导入 .icml）。包含 Excel 导出（breakdown、模板、multi‑sheet 导入 + 选表、图表预览）。

16. 高级导出

多重导出、多格式导出、资源导出、导出历史。

17. KDP

快速导出、计算器、KDP 模板，以及 ePub 验证器（清单、Kindle 预览、可下载报告）。

18. 风格分析

重复、可读性、建议。

19. AI 助手

摘要、改写、一致性检查。

20. 协作

共享会话、实时同步。

21. 数字签名

PAdES‑T PDF 签名。

22. 演示

文档转幻灯片。

23. 无障碍

字体大小、高对比度、阅读友好字体。

24. 快捷键

Ctrl/Cmd+S, Ctrl/Cmd+N, Ctrl/Cmd+P, F11, Ctrl/Cmd+B/I/U, Ctrl+Alt+V.

25. 故障排查

PDF/X 不可用、模板不可见、导出慢。

26. 路径

模板：`presswork/templates`，PDF/X ICC：`presswork/pdfx`。

最近更新（Data Hub / 图表）

现在从 Excel Data Hub 插入图表时，会立即在编辑器内显示图片预览，而不只是在右侧预览面板显示。
编辑器内联图表预览已缩小（约 50%），减少写作时的遮挡感。
双向切换：📝 显示代码 打开 chart-data 代码块，🖼️ 返回图表 可再次切回图片预览。
chart-data 代码块仍会保留在 Markdown 中，以保证 preview/render/export 的兼容性。
将表格或图表作为图片插入时，文件会保存到文档资源目录（文档名.assets/images/），编辑器中只插入 Markdown 引用：即使是非常大的表格也能正常工作。
如果文档尚未保存，应用会提示立即保存（与拖放图片相同的流程）；拒绝后表格以 Markdown 文本插入，图表留在表格视图中。
文本/图片的选择现在也能识别 "png"、"jpg"、"图片"、"照片" 等回答；无法识别的回答会重新询问。
数据网格跟随当前的明亮/深色主题。
另存为模板：窗口按应用风格重新设计并已翻译。需要网格中有数据且编辑器中有使用 {{列名}} 占位符的模板；"生成 Markdown" 会为每一行重复该模板。
Excel 导出（breakdown）：读取编辑器文本（INT./EXT. 场景或 # 章节）；如果找不到场景，现在会给出警告，而不是静默生成空文件。
简化 Tables 菜单：删除了重复的"作为模板导入"（与"打开 Tables 表格"完全相同）。
导入/导出面板：新增批量标签页（在基本格式 / 专业打印 / 剧本 / 出版旁边），包含批量操作：转换文件夹、批量导出、多格式导出、带资源导出。高级选项只显示与所选格式相关的内容。
🧪 校验 ICML：在导出面板（ICML 格式）中检查生成的文档 — 层级、front matter、转义、空段落 — 不写入任何文件；详情显示在应用内窗口中。每次 ICML 导出时也会自动运行同样的校验。
更安全的 FDX 导出：通用 Markdown（列表、表格、注释）始终转换为动作段落 — 绝不会被误判为角色/对白；真正的剧本仍会被正确解析。\newpage 会成为真正的分页符（ICML 中同样支持，样式可重新映射）。
通过 PDF 打印：打印按钮生成临时 PDF（Typst，与导出相同的排版）并在系统查看器中打开 — 使用原生对话框打印，预览与实际输出一致。
设置重新整理：新增 安装组件 部分（一键安装 LaTeX、Ghostscript 状态）、紧凑的语言视图、深色/浅色主题按钮。AI 面板的快速提示可折叠。

27. 深度功能分析（新增）

本节补充了应用中已存在但在速览手册中说明不足的高级能力。

27.1 AI：配置与诊断

通过 PRESSWORK_AI_ENDPOINT、PRESSWORK_AI_MODEL、PRESSWORK_AI_API_KEY 配置云端/本地 AI 端点（OpenAI-compatible、Ollama、LM Studio）。
提供连接诊断，并可导出 JSON 报告用于 IT/支持排障。
支持响应风格（简洁/平衡/详细）、技术提示词预览/复制、重试上次提示词。
支持按项目固定 endpoint/model，保证编辑一致性。

27.2 统计指标计算方法

生产力均值基于 7 天/30 天窗口。
写作速度基于会话内词数增量与时间跨度（词/小时、词/分钟）。
TTR = 唯一词数 / 总词数；MSTTR = 每 50 词窗口 TTR 的平均值。
实时 flow 状态：平均击键间隔 + 近期删除比例。
完成预测：基于 7d 与 30d 基线输出乐观/保守区间。

27.3 现已完整记录的高级导出流程

Final Draft (.fdx)：将章节式标题映射为 Scene Heading，支持备注/分页/场景编号，并生成 .breakdown.json sidecar。
ICML：标题/列表/引用/剧本元素的样式映射 + 预设 + 自定义 .icml 导入。
EPUB/ICML 向导：未填写最小元数据与封面时阻止导出。
PDF 签名链路：PKCS#7 detached + RFC 3161 时间戳。

27.4 Bundle 模式（.pwk）

主动作变为 Export（选择目标路径）。
自动输出目标可减少路径配置错误。
Header 开关可临时恢复经典快速导出按钮。

27.5 受限网络下的协作策略

可分享会话 ID pw-...、彩色远程光标、行内评论、实时同步。
会话内语音/视频通话。
WebRTC 失败时可切换 WebSocket relay（presswork-collab-relay-url）。