論文潤飾器 (Paper Polisher)
範疇與參考資料
使用此技能進行 TeX 安全的學術英文潤飾、翻譯、校對、原始碼到輸出驗證、術語或符號審查、數值一致性審查，以及經明確授權的符號標準化。
對於完整論文、長篇幅章節、驗證、一致性審計、標準化或嚴格的格式指南工作，在執行動作前，請先閱讀 references/tex_safe_polishing.md。當中文面向的工作流程指引實質上有用時，請改讀 references/tex_safe_polishing_zh.md；請勿僅僅為了複製上下文而同時載入兩份文件。對於短篇幅的局部潤飾，請使用下方的核心規則，並僅在需要時查閱參考資料。
請勿將此技能用作以下任務的主要工具：
- 新穎性、貢獻可辯護性、危險基線或 reviewer 攻擊審計；如有可用技能，請使用
idea-novelty-auditor； - 文獻回顧、研究缺口框架、參考文獻選擇或引用角色分配；如有可用技能，請使用
problem-driven-literature-review； - 廣泛的故事主線、引言結構或實驗到論點的重新設計；如有可用技能，請使用
paper-argument-reconstructor。
當請求將上述任務與潤飾結合時，請先完成上游的推理任務，然後僅將此技能用於最終的忠實語言與一致性處理。
模式選擇與優先順序
在使用者的明確請求動作之前，遵循其指示，而非考慮輸入內容的來源。來源本身絕不能凌駕於明確的潤飾、審計、驗證或標準化請求之上。如果請求多個動作，請保持它們的產出物和報告分開，除非使用者要求合併的交付成果。
特定模式的輸出規則優先於基於文件長度的輸出規則。特別是，完整手稿的驗證或僅限一致性的審計仍應僅產出報告。
如果使用者同時請求符號標準化和散文潤飾，請先執行並批准標準化，將標準化後的 TeX 視為新的基準，然後再針對該基準進行潤飾。請勿試圖將結合了散文和符號的變更驗證為一次標準化比較。
預設潤飾模式
潤飾或翻譯提供的文字，同時保留每一個受保護的元素。對於完整手稿，同時執行術語、符號以及來源內部的數值一致性審計，並報告來源層級的問題，但不要默默修正它們。
驗證模式
當使用者要求比較或品質檢查候選版本與原始版本時，使用驗證模式。
- 對於每個關於 TeX、數學、數字、單位、符號、引用、技術意義或論點強度的比較判斷，都需要原始版本和候選版本。
- 如果原始版本不可用，僅檢查候選版本的內在屬性，並將每個來源比較檢查標記為
NOT ASSESSED；切勿僅從候選版本推斷保留情況。 - 在驗證模式下，絕不重寫或修復候選版本，包括違反硬性規則的情況。報告每個偏差及其位置。僅在單獨的、明確請求的編輯輪次或模式中應用修正。
- 將候選版本引入的偏差與來源中已存在的術語、符號或數值衝突分開。
一致性審計模式
當使用者僅要求檢查術語、變數、符號或數值的一致性時，請勿重寫手稿。審計可用的範圍，並酌情報告 TERM-*、SYM-* 和 NUM-* 的發現。保持來源文字、符號、數值、單位和符號不變。
經批准的符號標準化模式
僅在使用者明確要求標準化並已批准確切的符號映射時使用此模式。經批准的映射必須標明數學實體、新舊符號、受影響的範圍或位置，以及任何有意的別名或排除項。
- 僅套用已批准的符號替換。請勿重新解讀定義或代表使用者選擇標準符號。
- 將每個已套用的替換記錄為
AUTHORIZED CHANGE；將每個未映射的數學、結構、文字或數值差異視為錯誤。 - 保持所有數字、單位、百分比、維度、樣本大小、數值標記的順序以及正號、負號或加減號不變。
- 如果受影響的符號出現在不可用或不可編輯的圖形資產、自訂環境、生成檔案或未展開的巨集展開結果中，請報告未解析的位置，且不要聲稱完成了完整標準化。
- 根據批准的映射驗證標準化後的結果。如果無法進行映射感知的比較，請先獲得標準化後 TeX 的批准，作為新的作者批准基準，然後針對該基準進行所有後續的潤飾工作。
請勿使用 --allow-additions 來授權符號變更。在任何論文潤飾器模式中，請勿修改數字、單位或數值符號，即使在報告了 NUM-* 衝突之後。要求使用者在此技能外部修正來源，並提供修正後的 TeX 作為新的作者批准基準；切勿推斷或套用替換值。
共享的覆蓋範圍與結果協定
對於每個術語、符號和數值一致性審計，分別報告覆蓋範圍和結果。
Coverage: FULL MANUSCRIPT表示下方的完整度閘門已通過。Coverage: PARTIAL表示僅審計了所述的本機或可解析範圍。Result: PASS表示在評估的範圍內未發現衝突或未解決的歧義。Result: ISSUE REPORTED表示發現了至少一個明確的不一致，且沒有發現仍需要作者做出決定。Result: AUTHOR DECISION REQUIRED表示至少有一個看似合理的發現無法僅從手稿中解決。已確認的問題仍會單獨標記為ISSUE REPORTED。Result: NOT ASSESSED表示該審計或比較完全無法執行。請勿僅因為覆蓋範圍是部分的就使用此結果。
以根目錄相對的檔案和原始碼順序分配確定性的發現標識符：TERM-001、SYM-001 和 NUM-001。當檔案可用時，為每個發現提供精確的檔案和行號位置；否則，使用最穩定的章節、方程式、表格、演算法、標題或引用文字錨點。
使用 ISSUE REPORTED 表示已確認的不一致。當證據無法確定比較的用法是否指向同一個實體、概念、數量或實驗條件，或者它們的差異是否有意為之時，使用 AUTHOR DECISION REQUIRED。保持衝突確定性與修正措施分開：即使作者仍必須選擇替換的術語、符號或數值，已確認的衝突仍標記為 ISSUE REPORTED。
完整手稿完整度閘門
僅在以下所有條件都滿足時，才能聲明 FULL MANUSCRIPT 覆蓋範圍：
- 識別權威的根目錄 TeX 檔案，並按文件順序解析每個靜態可達的
\input、\include、\subfile、\import及等效的包含指令。 - 考慮缺失的、條件式的、巨集生成的、生成的或循環的包含，以及每個包含符號的附錄或補充材料。
- 檢查產生符號的使用者巨集和自訂數學環境；不要依賴保留腳本處理來展開或理解它們。
- 檢查散文、方程式、演算法、標題、表格和提供的圖形資產中的符號和數值論點。如果資產包含相關嵌入文字但無法檢查，則覆蓋範圍是部分的。如果標準化影響了圖形但可編輯的來源不可用，則標準化不完整。
- 保留發現項目的根目錄相對檔案和行號位置，並驗證沒有跳過任何請求的範圍。
如果任何條件失敗，請說明覆蓋範圍缺口並使用 Coverage: PARTIAL。完整的檔案上傳本身並不構成完整的分析覆蓋範圍。
不可協商的規則
- 保留 TeX 結構、環境、引用、標籤、交叉引用、參考文獻鍵、函數名稱、模組名稱、資料集名稱、指標名稱和技術含義。
- 保留結構化命令中的確切引數和鍵，例如
\label{...}、\ref{...}、\eqref{...}、\includegraphics{...}、引用命令、\bibitem{...}和 BibTeX 鍵。請勿對它們進行重新命名、合併、刪除、重新排序或標準化。 - 在每種模式下，將註解和文字或類似程式碼的原始碼（包括
comment、verbatim、列表環境和行內文字命令）視為精確的受保護原始碼。請勿將散文移入或移出這些區域，不要將行內註解改為整行註解，也不要將它們移到受保護的數學或 TeX 結構之間。 - 在潤飾、翻譯、散文新增和驗證期間，保留每個原始數學區域及其文件順序。唯一的例外是作者批准的符號映射中列出的精確替換。
- 在潤飾、翻譯、散文新增、驗證、一致性審計和符號標準化期間，保留每個數字、單位、百分比、維度、參數、樣本大小、表格數值、圖形報告的數值、顯著性標記、數值標記的順序以及正號、負號或加減號。這包括嵌入在識別碼中的數字，以及位於註解、文字範例、URL 或受保護命令引數內的數值標記。此技能中沒有數值編輯的例外情況，且
--allow-additions不會放寬此規則。 - 將原始碼到輸出的保留檢查與原始碼內部的一致性檢查視為獨立的檢查。原始碼內部的術語、符號、數值、單位或符號衝突是發現，而非編輯許可。
- 切勿在此技能中修正可疑數值。在報告
NUM-*發現後，要求使用者在外部修訂來源並返回經作者批准的基準。 - 請勿更改數學定義、定理條件、證明邏輯、演算法步驟、實驗設定、報告的結果、基線或資料集。
- 請勿在此技能中修改參考文獻記錄或標識符。參考文獻清理請求僅可授權非數值、非標識符的元數據編輯，且這些編輯不得與其他受保護規則衝突；年份、頁碼、卷號、期號、DOI/URL/arXiv 標識符以及每個其他數值標記必須在論文潤飾器外部修正，並作為經作者批准的基準返回。
- 請勿發明論點、實驗、保證、部署價值、限制或結論。
- 請勿僅為了風格多樣性而變換技術術語。僅在實體映射得到支援時才使用標準術語。
- 避免在句子開頭、從句順序、語態、過渡以及段落結構上出現機械性的重複，同時不更改受保護內容。
- 請勿在作者撰寫的手稿散文中使用破折號標點。精確保留詞彙連字元、數學減號、帶符號的值、受保護鍵、URL、DOI 字串、檔名、引用鍵和參考文獻元數據。
如果請求的編輯將違反這些規則且不受精確批准的映射涵蓋，請停止該編輯並報告缺少哪些授權或來源資訊。如果您自己的草稿違反了規則，請在返回前修正它。
工作流程
- 根據使用者的明確意圖選擇模式，並確定提供的範圍。
- 對於完整手稿工作，套用完整度閘門並保留已解析的文件順序。
- 建立相關登記簿：
- 術語：實體、標準術語、允許的上下文形式、定義和位置；
- 符號：數學實體、符號、定義和使用、範圍、類型或維度、框架和別名；
- 數值：測量或配置的數量、數值、單位、符號、條件、來源位置以及匹配的散文/表格/圖形使用。
- 在潤飾模式下，修訂散文，同時保持受保護的數學和數值標記順序不變。僅當這樣做不會重新排列受保護的數學、數字、單位或符號時，才重新排列從句或句子。
- 執行雙向一致性檢查：實體到術語或符號，術語或符號到實體，以及數量或實驗條件到報告的數值、單位和符號。
- 在評估範圍內執行句子結構、無破折號散文、客觀語氣和論點邊界檢查。
- 當原始檔案和候選檔案可用時，執行保留檢查器。對於多檔案手稿，使用專案模式。
- 返回特定模式的輸出，並區分授權變更、來源層級發現、候選版本引入的偏差以及未評估的檢查。
保留檢查器
對於一個原始和一個候選 TeX 檔案，執行嚴格比較：
python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex
僅當使用者授權了普通的散文新增時，才使用 --allow-additions：
python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions
此選項不允許新增、刪除、更改或重新排序結構鍵、數學區域、數值標記、單位或符號。已識別的註解和文字或類似程式碼的區域仍是精確的受保護原始碼，包括它們的行內與整行註解邊界，以及它們相對於受保護數學和 TeX 的順序。手動比較任何自訂或未識別的文字巨集。它不授權新的圖形、表格、方程式、引用、圖片資產或符號映射。為有意的受保護結構變更建立經作者批准的基準，或者當數值內容必須在論文潤飾器外部修正時，使用外部修正且經作者批准的 TeX 作為新的基準。
對於多檔案手稿，傳遞兩個權威的根目錄 TeX 檔案並啟用專案遍歷：
python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project
專案模式從每個根目錄解析靜態可達的 \input、\include、\subfile、\subfileinclude、\import、\subimport、\inputfrom、\subinputfrom、\includefrom 和 \subincludefrom 指令，包括從目前和先前目錄解析的路徑，並正確處理巢狀包含。它不解析動態包含、由巨集展開產生的包含或對分叉構建過程產生的檔案的包含。如果根目錄檔案不在一個共用的父目錄下，請提供一個共同根目錄（例如，--project-root /path/to/common/base）。驗證解析器遇到的每個包含是否都存在且具有非空內容；對於缺失的包含，報告缺少的檔案而不是退出。包括所有發現的檔案中的輔助資料（\label、\ref、\cite、\bibitem 等）；對於不可解除引用的引用，將其報告為 UNRESOLVED 而不是缺少它們。對於已經標準化或修正的候選版本，比較應指示哪些差異對應於 AUTHORIZED CHANGE 以及哪些是原始碼到候選版本的偏差。