🛠️Maintenance and Diagnostic Tools｜維護與診斷工具
The following three tools cover most routine Mod and CC maintenance tasks. Each tool serves a different purpose and should be used according to the issue being investigated.
以下三款工具可處理大部分日常 Mod 與 CC 維護工作。三者用途不同，應根據實際問題選擇使用。
1. Sims 4 Mod Manager
Used for file organization, duplicate detection, resource-conflict review, merged package management, and supported update tracking.
主要用於整理文件、檢查重複內容、分析資源衝突、管理合併包，以及追蹤部分內容更新。
🛠️Duplicate Files｜重複文件
Detects files with identical content and files that share the same filename.
檢測內容完全相同的文件，以及使用相同文件名的文件。
The following results must be interpreted separately:
以下結果必須分開判斷：
Exact Same File / Same Content: The files contain identical data. Only one copy is normally required.
*完全相同／內容相同：*文件保存了相同資料，通常只需要保留一份。Same Filename: The names are identical, but the contents may be different. Further verification is required before removal.
*文件名相同：*文件名稱相同，但實際內容可能不同，移除前必須進一步確認。
The official documentation separates duplicate content from same-name files because they represent different situations.
官方說明將「內容完全相同」與「僅文件名相同」分為不同檢測類別，兩者不能使用相同方式處理。
🛠️ID Conflicts｜ID 衝突
Lists internal resource IDs shared by multiple Package files.
列出多個 Package 文件之間重複使用的內部資源 ID。
A conflict result does not automatically indicate a broken file. It may represent an old and updated version, an override, a translation, a recolor and mesh relationship, or a required compatibility patch.
衝突結果並不代表文件一定損壞，也可能是新舊版本、覆蓋文件、漢化、Recolor 與 Mesh 關係，或必須與原文件共同使用的兼容性補丁。
🛠️Merged Packages｜Merged 合併包
Supported Sims 4 Studio merged packages can be reviewed and, when the required manifest data is present, unmerged into standalone files.
部分由 Sims 4 Studio 建立的合併包可以查看內容；如果文件保留了必要的 Manifest 資料，也可以拆分為獨立文件。
Older packages or files merged through other applications may not support automatic unmerging.
較早製作或使用其他工具建立的合併包，可能無法自動拆分。
🛠️CurseForge Updates｜CurseForge 更新
Tracks available updates for supported content installed or recognized through CurseForge.
用於追蹤由 CurseForge 安裝或識別的受支援內容更新。
Files downloaded manually from Patreon, Tumblr, Sim File Share, or creator websites may still require manual update checks.
從 Patreon、Tumblr、Sim File Share 或作者網站手動下載的文件，通常仍需自行檢查更新。
Example｜案例
A scan finds two differently named files with identical content:
掃描結果發現兩個名稱不同、但內容完全相同的文件：
Creator_ModernSofa.package
download_839274.package
Review both paths → retain the clearly named file in the creator folder → move the duplicate to a quarantine folder → delete localthumbcache.package → test the game before permanent deletion.
檢查兩個文件的路徑 → 保留作者文件夾內名稱清楚的版本 → 將另一份移入隔離文件夾 → 刪除 localthumbcache.package → 測試遊戲後再決定是否永久刪除。
2. Better Exceptions
Better Exceptions is an in-game diagnostic Mod used to analyze errors generated while the game is running.
Better Exceptions 是一款遊戲內診斷 Mod，主要分析遊戲運行期間產生的錯誤。
🛠️Runtime Reports｜運行時報告
It can assist with:
可協助排查：
Script Mod errors
腳本模組錯誤UI and CAS problems
UI 與 CAS 異常Gameplay exceptions
遊戲功能異常LastException reports
LastException 報告Possible Mod-related runtime conflicts
可能與 Mod 有關的運行時衝突
When an exception occurs, Better Exceptions generates a readable report and may identify files associated with the error.
當遊戲產生異常時，Better Exceptions 會生成較易閱讀的報告，並可能列出與錯誤相關的文件。
A file appearing in the report should be treated as a diagnostic lead, not automatic proof that the file is defective.
文件出現在報告中，只代表需要優先檢查，不能直接視為已確認損壞。
🛠️Basic Use｜基本使用
Install Better Exceptions → enable Script Mods in Game Options → launch the game → reproduce the issue → review the generated report.
安裝 Better Exceptions → 在遊戲選項中啟用腳本模組 → 啟動遊戲 → 重現問題 → 查看生成的報告。
The .ts4script file should not be placed more than one folder below the Mods directory.
.ts4script 文件所在位置不要超過 Mods 目錄下一層。
🛠️Limitations｜限制
Better Exceptions is not designed to scan an entire Build/Buy CC library for duplicate files, damaged meshes, missing dependencies, or every possible resource conflict.
Better Exceptions 並不適合全面掃描大型 Build/Buy CC 資料庫，也不能完整檢測重複文件、損壞 Mesh、缺失依賴或所有資源衝突。
Example｜案例
After a game update, CAS displays distorted buttons or fails to load correctly.
遊戲更新後，CAS 出現按鈕錯位、介面變形或無法正常載入。
Reproduce the issue → open the Better Exceptions report → review the listed UI and CAS Mods → verify their current versions → temporarily remove the most likely outdated file → clear localthumbcache.package → restart and test again.
重現問題 → 查看 Better Exceptions 報告 → 檢查其中列出的 UI 與 CAS 模組 → 確認是否已更新 → 暫時移出最可能過期的文件 → 清除 localthumbcache.package → 重啟遊戲測試。
3. Sims 4 Studio
Sims 4 Studio is used for manual Package inspection, internal resource review, supported Batch Fixes, and merged package management.
Sims 4 Studio 主要用於人工檢查 Package、查看內部資源、執行受支援的 Batch Fix，以及管理合併包。
🛠️Package Inspection｜Package 檢查
Use My CC to review installed Custom Content, thumbnails, catalog information, and associated Package files.
使用 My CC 查看已安裝的自定義內容、縮圖、目錄資訊及相應的 Package 文件。
For more detailed inspection, open the file through My Projects and review its internal resources in Warehouse.
需要進一步檢查時，可通過 My Projects 打開文件，並在 Warehouse 中查看內部資源。
Common resource identifiers include:
常見資源識別資訊包括：Type，Group，Instance
These values can help determine whether two Packages contain the same resource, act as overrides, or represent different versions of the same object.
比較這些資料，可以協助判斷兩個 Package 是否包含相同資源、是否屬於覆蓋文件，或是否為同一物件的不同版本。
🛠️Batch Fixes｜批量修復
Batch Fixes address specific compatibility issues caused by documented game updates.
Batch Fix 用於處理特定遊戲更新後已記錄的兼容性問題。
Open Sims 4 Studio → Tools → Batch Fixes → select the relevant category → choose the folder to process → run the fix → review the completion report.
打開 Sims 4 Studio → Tools → Batch Fixes → 選擇相應類別 → 指定需要處理的文件夾 → 執行修復 → 查看完成報告。
Only run a fix that applies to the affected CC category. Batch Fixes are not universal repair functions.
僅執行明確適用於相關 CC 類別的修復項目。Batch Fix 並不是通用修復功能。
They cannot automatically repair every damaged mesh, missing dependency, excessive polygon count, outdated script, or incompatible resource.
它不能自動修復所有損壞 Mesh、缺失依賴、過高面數、過期腳本或不兼容資源。
🛠️Merged Packages｜Merged 合併包
Compatible Sims 4 Studio merged files can be unmerged through the Content Management tools.
兼容的 Sims 4 Studio 合併文件可通過 Content Management 工具進行拆分。
Back up the merged file → unmerge it to a folder outside Mods → confirm that the extracted files are complete → test the standalone files before replacing the original merged package.
備份原合併包 → 將拆分結果輸出至 Mods 之外的文件夾 → 確認獨立文件完整 → 測試後再決定是否替換原合併包。
Example｜案例
Several older custom chairs remain visible in the catalog but no longer function correctly after a game update.
遊戲更新後，部分舊版自定義椅子仍顯示在目錄中，但已無法正常使用。
Copy the affected Packages into a test folder → confirm that an appropriate chair Batch Fix exists → run the fix only on the test folder → place the repaired copies in Mods → clear localthumbcache.package → test the chairs in a clean save.
將受影響的 Package 複製到測試文件夾 → 確認存在適用的椅子 Batch Fix → 僅對測試文件夾執行修復 → 將修復後的文件放回 Mods → 清除 localthumbcache.package → 在乾淨存檔中測試。
Together, these tools cover the majority of routine Mod and Custom Content maintenance scenarios. They should be treated as complementary utilities rather than interchangeable replacements.
以上工具可覆蓋大多數 Mod 與自定義內容的日常維護場景。三者功能互補，不應互相替代。