僅記錄未完成工作。項目完成時,須在同一次提交中刪除該項目,並於 docs/updates/ 新增 #done 紀錄,格式與查詢指令見 docs/updates/README.md。不保留已完成項目、歷史或規則,規則另存於 CLAUDE.md。
項目編號不得重複使用。狀態標籤:[待決定] 表示需要使用者決定,[受阻] 表示等待其他條件,[待驗證] 表示已觀察但尚未確認。優先順序:第一優先為接下來處理,第二優先為值得處理,第三優先為使用者有需求時才處理。
原生環境驗證項目保留追蹤,取得對應環境後繼續驗證。
跨專案與工作區項目另存於 D:\Codes\progress.md。
-
#136 [待驗證] 在原生作業系統環境確認螢幕閱讀器的實際朗讀、系統高對比模式、原生資料夾選擇器與作業系統快捷鍵派送。現有隱藏視窗驗證使用本機高對比配色模擬、元件鍵盤事件及選擇器回傳值替身,不代表上述系統行為已通過;後續驗證仍須遵守全程背景執行限制。
-
#114 [受阻] 需要使用者在實機驗證互動:確認程式所管理的系統管理員重新啟動背景工作,在 Windows 使用者帳戶控制提示中同意與取消的行為。模擬殼層執行及 COM 執行緒模型檢查不足以證明實際行為。此外,必須在使用者實際發生卡住的路徑上,驗證 Python 原始碼掃描、非同步關閉與來源檔案操作流程,才能宣告所有卡住問題已解決。需要使用者在電腦前操作。
-
#4 [待驗證] 在 macOS 驗證檔案管理員的選取與備援行為、垃圾桶行為、從 Finder 拖曳掃描時保留來源、圖形介面中受保護重複檔案的連結核准,以及經核准移至垃圾桶後在原路徑建立符號連結的行為。使用者目前未提供 Mac 或 macOS 虛擬機,無法驗證 Finder 互動與授權。
- #21(第二優先)[受阻] macOS 垃圾桶查詢與 Finder 全域清空功能仍缺少原生驗證環境,使用者目前未提供 Mac。須驗證 macOS 原生自動化授權、APFS 與 firmlink 範圍去重、多磁碟區涵蓋範圍、執行中操作的生命週期,以及失敗或部分完成時的中繼資料重新整理。測試資料與模擬執行無法證明原生行為。
- #76(第一優先)[受阻] 須在真實雲端服務供應商環境驗證雲端預留位置檔案,目前使用者未提供此環境。測試資料無法證明供應商實際配置的空間。無法量測的共用儲存區段與目錄中繼資料須維持未知,Windows 無資源回收筒時的結果也仍未知。磁碟容量核對仍由 #75 追蹤。已取得的證據(U-20261114-13):真實 OneDrive 同步根目錄中 2 個僅限線上的檔案,FileTree 與 Windows 都回報佔用 0,掃描沒有觸發下載;樣本只有 2 個檔案、一家供應商,大量檔案與其他供應商(Dropbox、Google Drive、iCloud)仍未驗證。
- #142(第二優先)[待驗證] 由主檔案表讀取 NTFS 磁碟的掃描(U-20261115-05、-07)只在一台機器的一顆系統磁碟上量測與比對。尚未驗證:檔案紀錄為 4096 位元組的磁碟(4Kn);檔案表本身高度分散的磁碟;資料磁碟與外接磁碟;啟用系統壓縮(CompactOS)或含大量雲端預留位置的磁碟;真正的 Windows 10;冷快取下與列出資料夾的秒數比較;CI 的 Windows 工作能否讀取檔案表(讀不到時
test_mft_scan.py的實機測試會略過);已發行的 wheel 與獨立版是否含新版模組;有日光節約時間的時區下原生時間文字與 Python 是否相同(U-20261115-10)。另有 85 個資料夾的大小與 Windows 回報不同,原因未查明;這些項目在操作前會被判定為已變更而拒絕,重新掃描該資料夾即可。 - #144(第二優先)[待驗證] 「跟隨變更」只重新讀取變動資料夾(U-20261120-01),Windows 的 NTFS USN 與目錄通知已在本機原生驗證(U-20261120-02)。macOS FSEvents 監看(U-20261120-03)只在 CI 的 macOS 工作上原生執行。尚未驗證:在實體 Mac 上的 Finder 操作與外接磁碟;Linux inotify 新舊監看短暫並存時,是否會超過監看數量上限;在使用者實際使用、變動頻繁的資料夾上,重新讀取監看範圍的背景負擔。
- #138(第三優先)[待驗證] 選用的原生掃描模組
je_file_tree._native已隨 0.2.9 發行(PyPI 的 Windows wheel 與 Windows 獨立版),發行本身已驗證。尚未驗證的環境:真正的 Windows 10;未安裝 Visual C++ 可轉散發套件的乾淨機器(模組須可載入並被採用);非 NTFS 磁碟區中的 exFAT 與 ReFS(FAT32 已驗證),須確認掃描起點比對會正確決定是否使用原生讀取;ARM64 的 Windows(目前只發行 x64 wheel)。目前沒有這些環境。任何一項失敗時,程式仍以 Python 讀取掃描,結果相同。 - #35(第二優先)[受阻] 須在實際緩慢的遠端 SMB 連線上,量測 UNC 路徑與對應磁碟機在不同背景工作數量下的處理量,再建議該環境的並行程度。使用者目前未提供遠端共用資料夾或慢速連線驗證環境,本機回送連線的原生量測無法證明遠端效能。
- #75(第一優先)[受阻] 須透過原生目錄走訪防護,驗證 macOS 與其他 POSIX 系統上同一裝置內的掛載邊界。使用者目前未提供可拋棄的對應驗證環境。FreeBSD 的 nullfs 具有不同的
st_dev,無法證明此情境。未掛載的 APFS 同容器磁碟區容量仍未知。圖形介面與命令列的容量帳目仍為估計值;無法獨立量測的共用空間、保留空間、檔案系統中繼資料、遺漏位元組及其他磁碟區總量,均須維持未知。直接顯示垃圾桶標籤與 Finder 清空功能仍由 #21 追蹤。
- #38(第三優先)[受阻] 須驗證 macOS 原生警示互動、實際使用者登入時的自動啟動,以及 Windows 與 macOS 通知顯示權限。原生 Qt 元件與註冊測試資料無法證明作業系統原生互動或真實登入行為,成功送出通知也不代表具有顯示權限。使用者目前未提供登入或 macOS 桌面驗證環境,Windows 通知畫面擷取仍待驗證。
- #47(第二優先)[受阻] 須設定使用者的 Azure Artifact Signing Public Trust 帳戶、設定檔及 OIDC 環境識別資訊,以啟用自選的版本簽署流程,詳見
docs/windows-signing.md。接著驗證實際含時間戳記的 EXE 與 MSI 簽章,以及下載成品的雜湊值。目前沒有可用的簽署憑證或服務環境。macOS Developer ID 簽署與公證也需要使用者尚未提供的憑證,未簽署的建置無法證明簽署流程或 SmartScreen 信譽。 - #48(第三優先)[受阻] 須針對確切的已發布版本成品,提交審查過的 winget、Scoop 與 Chocolatey 草稿,並驗證實際套件平台的安裝與升級。使用者目前尚未提供發布所需的權杖或帳戶。