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。安裝包會同時註冊 Finder 擴充功能；如果系統沒有自動啟用，請在「系統設定 → 登入項目與擴充功能」裡為文隱開啟。
4. 更新管道與手動更新
- 應用程式內更新：由 Sparkle 負責檢查、下載、簽章驗證與安裝。預設自動檢查並在介面上提醒，由你按下後才下載與安裝。
- 手動檢查：在「設定 → 一般 → 軟體更新」裡可以改為手動模式，也可以隨時按「檢查更新」；手動模式下不會安排背景檢查。
- 更新線路：可以切換國內線路與海外線路，兩條線路發布同一份建置，只是下載來源不同。
- 手動安裝：也可以直接從下載頁或下載倉庫下載新的 DMG 覆蓋安裝，資料庫與授權記錄會保留。
- 特殊情況：標記為大版本的更新會保留黃色提示，需要你按下才會安裝；處理中文書、未完成複核或系統對話框出現時，安裝會延後到你手頭工作結束。
更新只下載版本清單與安裝包，不上傳文書，不傳送使用統計；更新包使用密碼簽章驗證。版本變化見公開發布記錄。
5. 移除
只把「文隱」拖進垃圾桶，不會刪除資料庫、授權與快取。安裝包內提供了「卸载文隐.command」：
- 結束正在執行的文隱；
- 登出 Finder 擴充功能與系統開啟方式註冊；
- 把
/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. 安全問題
以下問題請透過電子郵件私下說明，不要在公開管道貼出細節：
- 去識別化輸出裡殘留了敏感原文；
- 原始檔案被修改、移動或覆蓋；
- 應用程式出現連網行為、遙測或當機回報；
- Finder 擴充功能或本機介面越權：讀到文書正文、接觸資料庫內容或對外暴露埠；
- 匯入、匯出或復原鏈路遺失、錯配檔案。
說明時同樣不要附真實文書，用合成範例或去識別化後的片段描述即可。
9. 支援範圍與不提供的服務
| 我們提供 | 我們不提供 |
|---|---|
| 本機辨識、核對、取代與匯出 | 雲端辨識或雲端去識別化（文書不離開你的 Mac） |
| 應用程式內更新與公開發布記錄 | 替你傳送文書，或代你把檔案交給任何 AI 服務 |
| 離線授權碼與試用 | 帳號體系、訂閱、遠端撤銷授權、跨裝置同步 |
| 電子郵件與微信群組裡的使用答疑 | 電話或在線客服；中國增值稅發票 |
| 依版本說明如實告知已知限制 | 對辨識完整性、執行環境或交付時限的保證 |
| 一碼一機的個人授權 | 團隊、教育或批次授權（尚未形成條款） |
10. 已知限制清單
辨識
- 辨識會遺漏，也會誤認：敘述性的隱私資訊、複雜地址與姓名寫法仍需要人工補漏。
- 辨識結果是候選，預設勾選只代表建議，不代表已經確認。
- 我們不在頁面上公布辨識率，也不把它寫成保證；請以自己文書上的實際核對結果為準。
版面與結構
- DOCX 的註解、修訂、隱藏文字與文件屬性，PDF 的中繼資料與附件，需要依版本說明單獨確認。
- 部分 PDF 與 DOCX 會被拒絕處理：不符合安全刪除條件時，應用程式寧可拒絕，也不產生可能殘留原文的副本。
- 取代後版面可能受字級、字型與替代詞長度影響；匯出後請檢查文字與排版。
字型與顯示
- 預覽與匯出使用系統提供的字型呈現；如果文書依賴本機沒有的字型，顯示效果可能與原編輯器不同，但這不影響文字是否被取代。
- 不要只憑預覽判斷資訊已被刪除，請開啟匯出檔案檢查。
超大檔案與效能
- 辨識會佔用較多記憶體與 CPU，文件越長越明顯。目前版本支援取消辨識，取消後該文書保持「未掃描」狀態，可以重新掃描。
- 辨識一次處理一份並排隊；在佇列裡切換文書不會打斷目前任務。
- 對超過 2 萬字的長文件，可以在設定裡開啟「長文書快速模式」：只跑規則辨識以換取速度，介面會明確標註這一份沒有使用模型辨識。需要完整候選時請關閉該模式重跑。
- 建議：長文件單獨處理，辨識期間不要同時執行其他大型任務；批次處理時先小批量驗證再放大。
執行環境
- 目前安裝包未做 Apple 公證，首次開啟需要手動放行。
- Intel Mac 與 macOS 12 到 14 尚未完成驗收；批次、大文書與輔助技術的完整驗收仍在進行。