1. 系统要求
| 项目 | 要求 | 验收状态 |
|---|---|---|
| 系统版本 | macOS 12 或更新版本 | 本机验证集中在 macOS 15；macOS 12 到 14 尚未完成单独验收 |
| 处理器 | 当前公开发布的内测版面向 Apple 芯片 Mac | Intel Mac 尚未验收，请不要把它当作已支持 |
| 磁盘 | 安装包约 73 MB；安装后约 130 MB（含识别模型与推理运行库） | 识别过程会额外占用内存与 CPU，长文档更明显 |
| 网络 | 离线可用 | 只有检查与下载更新需要联网，见隐私政策第 5 节 |
如果你在 macOS 12 到 14 或 Intel Mac 上遇到问题，请在反馈里注明系统与机型，我们不会把它描述为已支持。
2. 格式支持矩阵
| 文件类型 | 支持程度 | 已知限制 |
|---|---|---|
Word 文稿 .docx |
支持：识别正文文字并生成独立脱敏副本 | 含图片、嵌入对象或复杂结构的文件在后台自动流程会被保守拒绝（可在应用内导入后逐项复核）；批注、修订、隐藏文字与文档属性尚未完整处理 |
| 文字型 PDF | 支持：识别并按完整文字值删除 | 不同字体、编码与内容流的适配仍在收敛；当同一段文字同时出现在选中与保留位置时，应用会拒绝生成并建议改用 Word 版本；不要只凭预览判断信息已被删除 |
| 扫描件 PDF（纯图片） | 不支持：没有文字层 | 应用会拒绝处理，而不是生成可能残留原文的副本 |
| 图文混合 PDF | 不在完整支持范围 | 图片、注释、图案、特殊字体或软蒙版等结构会导致拒绝 |
| 加密文档 | 不支持 | 无法读取内容的文件不会被处理 |
旧版 Word（.doc）、WPS、图片、Markdown |
尚未支持 | 这些方向上已有规划，但在对应版本发布前不提供 |
被拒绝不是故障：当文件结构无法保证「原文被真正删除」时，应用宁可拒绝，也不生成可能残留信息的副本。
3. 安装与首次打开
- 从下载页或下载仓库获取 DMG 安装包。
- 打开 DMG，把「文隐」拖入「应用程序」。
- 双击打开。当前版本未做 Apple 公证，首次打开可能被系统阻止。
- 如果被阻止：打开「系统设置 → 隐私与安全性」，为文隐选择「仍要打开」。macOS 12 中对应「系统偏好设置 → 安全性与隐私」。
不需要关闭系统安全保护。首次安装使用 DMG，应用内更新使用带签名的 ZIP。安装包会同时注册访达扩展；如果系统没有自动启用，请在「系统设置 → 登录项与扩展」里为文隐打开。
4. 更新渠道与手动更新
- 应用内更新：由 Sparkle 负责检查、下载、签名校验与安装。默认自动检查并在界面上提醒，由你点击后才下载与安装。
- 手动检查：在「设置 → 通用 → 软件更新」里可以改为手动模式，也可以随时点「检查更新」；手动模式下不会安排后台检查。
- 更新线路：可以切换国内线路与海外线路，两条线路发布同一份构建，只是下载来源不同。
- 手动安装：也可以直接从下载页或下载仓库下载新的 DMG 覆盖安装，资料库与授权记录会保留。
- 特殊情况：标记为大版本的更新会保留黄色提示，需要你点击才会安装；处理中文书、未完成复核或系统对话框出现时，安装会推迟到你手头工作结束。
更新只下载版本清单与安装包，不上传文稿，不发送使用统计；更新包使用密码签名校验。版本变化见公开发布记录。
5. 卸载
只把「文隐」拖进废纸篓，不会删除资料库、授权与缓存。安装包内提供了「卸载文隐.command」：
- 退出正在运行的文隐；
- 注销访达扩展与系统打开方式注册；
- 把
/Applications/文隐.app移入废纸篓； - 删除
~/Library/Application Support/文隐（含导入的文书副本、授权码与试用记录）； - 删除偏好、缓存、网络缓存与扩展容器；
- 删除钥匙串里的试用记录（系统可能询问一次）。
在应用内删除资料时进入系统废纸篓的副本不会自动清空，需要你自己清空废纸篓。手动清理清单：删除 /Applications/文隐.app、~/Library/Application Support/文隐、~/Library/Preferences/com.songsong.docredactor*.plist、~/Library/Caches/com.songsong.docredactor、~/Library/HTTPStorages/com.songsong.docredactor、~/Library/Containers/com.songsong.docredactor*、~/Library/Application Scripts/com.songsong.docredactor*、~/Library/Group Containers/group.com.songsong.docredactor，再到「系统设置 → 登录项与扩展」关闭文隐扩展，并在「钥匙串访问」里删除 com.songsong.docredactor.trial.v2。
本机的「文隐开发版」与签发工具「文隐工具」是独立渠道、独立数据，卸载脚本不处理它们。
6. 反馈问题时请附上这些
- 版本与构建号：应用「设置 → 关于」，或下载文件名里带的两段数字（版本 / 构建号）；
- macOS 版本与机型（Apple 芯片或 Intel）；
- 复现步骤：你做了什么、期望的结果、实际的结果；
- 是否换一份合成样例或另一个资料库后仍然出现；
- 相关截图。
不要附真实文书。真实法律文书、当事人信息、凭据，以及截图里的真实内容都不要发送。需要说明识别或脱敏问题时，请先用合成写法造一份样例再描述。
反馈渠道：邮箱 songsong24@foxmail.com，或官网页脚「加入群聊」处的两个微信群。
7. 响应时间
文隐由个人开发者维护，我们不承诺固定的响应时限，会尽力在合理时间内确认并回复。安全类问题的处理顺序优先于普通咨询；如果是内测群里的问题，在群里再提醒一次通常最快。
8. 安全问题
以下问题请通过邮箱私下说明，不要在公开渠道贴出细节：
- 脱敏输出里残留了敏感原文；
- 原文件被修改、移动或覆盖；
- 应用出现联网行为、遥测或崩溃上报；
- 访达扩展或本机接口越权：读到文书正文、接触资料库内容或对外暴露端口；
- 导入、导出或撤销链路丢失、错配文件。
说明时同样不要附真实文书，用合成样例或脱敏后的片段描述即可。
9. 支持范围与不提供的服务
| 我们提供 | 我们不提供 |
|---|---|
| 本机识别、核对、替换与导出 | 云端识别或云端脱敏（文书不离开你的 Mac） |
| 应用内更新与公开发布记录 | 替你发送文书，或代你把文件交给任何 AI 服务 |
| 离线授权码与试用 | 账号体系、订阅、远程吊销授权、跨设备同步 |
| 邮箱与微信群里的使用答疑 | 电话或在线客服；中国增值税发票 |
| 按版本说明如实告知已知限制 | 对识别完整性、运行环境或交付时限的保证 |
| 一码一机的个人授权 | 团队、教育或批量授权（尚未形成条款） |
10. 已知限制清单
识别
- 识别会遗漏，也会误认：叙述性的隐私信息、复杂地址与姓名写法仍需要人工补漏。
- 识别结果是候选，默认勾选只代表建议，不代表已经确认。
- 我们不在页面上公布识别率，也不把它写成保证；请以自己文书上的实际核对结果为准。
版式与结构
- DOCX 的批注、修订、隐藏文字与文档属性，PDF 的元数据与附件，需要按版本说明单独确认。
- 部分 PDF 与 DOCX 会被拒绝处理：不满足安全删除条件时，应用宁可拒绝，也不生成可能残留原文的副本。
- 替换后版面可能受字号、字体与占位词长度影响；导出后请检查文字与排版。
字体与显示
- 预览与导出使用系统提供的字体渲染；如果文书依赖本机没有的字体，显示效果可能与原编辑器不同，但这不影响文字是否被替换。
- 不要只凭预览判断信息已被删除，请打开导出文件检查。
超大文件与性能
- 识别会占用较多内存与 CPU，文档越长越明显。当前版本支持取消识别，取消后该文稿保持「未扫描」状态，可以重新扫描。
- 识别一次处理一份并排队；在队列里切换文稿不会打断当前任务。
- 对超过 2 万字的长文档，可以在设置里打开「长文档快速模式」：只跑规则识别以换取速度，界面会明确标注这一份没有使用模型识别。需要完整候选时请关闭该模式重跑。
- 建议：长文档单独处理，识别期间不要同时运行其他大型任务；批量处理时先小批量验证再放大。
运行环境
- 当前安装包未做 Apple 公证，首次打开需要手动放行。
- Intel Mac 与 macOS 12 到 14 尚未完成验收；批量、大文稿与辅助技术的完整验收仍在进行。