Skip to content

refactor: 統一產品目錄與命名,按責任分類下載模組 - #764

Merged
crazysmile-PhD merged 1 commit into
mainfrom
refactor/project-layout
Nov 16, 2026
Merged

crazysmile-PhD merged 1 commit into
mainfrom
refactor/project-layout

Conversation

@crazysmile-PhD

Copy link
Copy Markdown
Owner

產品原始碼原本分散在根目錄與 src/,ViewModel 同時使用 View 前綴和 ViewModel 後綴,下載模組的準備、傳輸、產物與 UI 投影則混在同一層。查找一項責任時,需要先排除大量無關檔案;掃描、測試與打包入口也各自維護多個來源根目錄。

本次將產品專案統一到 src/、簡化重複命名,並按既有責任整理下載目錄。驗收聚焦於分類一致、來源內容保留、依賴方向與行為相容。

改動

  • 將 DownKyi 與 DownKyi.Core 移入 src/,更新 solution、ProjectReference、圖示/notice/FFmpeg 資源、建置、macOS 打包及 API audit 路徑。舊版本重建使用舊 checkout,保留其歷史路徑。
  • 將 34 個 View…ViewModel 型別改為 …ViewModel,同步調整 43 個含 partial 的來源檔、XAML binding、DI、導航 factory 與測試。保留能區分領域與用途的名稱。
  • 下載模組分成 Planning、Transfer、Artifacts、Presentation、Runtime。根目錄保留 DownloadComposition 與 DownloadRuntimeFactory。83 個搬移檔案在搬移前後逐位元組相同,沿用 namespace、型別與 assembly。
  • 刪除空的 Directory.Build.targets、兩行失效的註解程式碼,以及重複列舉產品來源根目錄的設定;來源統計從實體 src/ 推導。
  • 將下載架構檢查的掃描改為遞迴,保留搬移前的來源涵蓋範圍及所有既有斷言。更新 advisory baseline 的來源 identity/path,保留 metric、分類與審查門檻。
  • 將 artifacts/ ignore 限定為根目錄 /artifacts/:原規則在 Windows 上會連來源目錄 Artifacts 一起忽略。已確認所有搬移檔案均納入 Git,根目錄產物仍被排除。

整個 diff 有 301 個搬移/更名;檔案數量主要來自路徑與型別名稱傳播。

論文與實際專案的交叉對照

以下「採用方式」是對 DownKyi 的設計取捨。外部原始碼連結固定在所檢查的提交。

研究原則 實際專案的觀察 本 PR 的採用方式
Parnas 1972:依隱藏的設計決策與變更責任劃分模組 YoutubeDownloader 將 Core 的下載處理 與 UI 下載項目 分開;Parabolic 的 DownloadService 與 MainWindowController 也承擔不同責任。 以準備、傳輸、產物、投影與生命週期分類,保留現有組裝與狀態 owner。目錄分類沿用既有責任,沒有建立新的架構層或 DI 模組。
Lawrie、Feild、Binkley 2007:識別名稱應精確且一致 YoutubeDownloader 使用 DownloadViewModel;Parabolic 用 RecoverableDownload 表達恢復資料的用途。 移除重複的 View 前綴,保留 ViewModel、Download 等有意義的角色/領域詞。不同協定 DTO 與 UI projection 仍是不同概念,這次保留其既有名稱與 namespace。
Kim、Zimmermann、Nagappan 2012:重構的效益與成本需要實證評估 該研究包含調查、訪談與版本歷史分析;論文也明確區分關聯與因果。本專案 #759 已整理 observer/checkpoint 與專用 artifact writers。 沿用既有取消、checkpoint、durable claims 與提交邊界,以來源內容比對和既有正式測試驗證相容性;本次只整理這些責任的查找位置。

適用差異與實際踩坑

  • YoutubeDownloader 的 DashboardViewModel 會在下載失敗後嘗試刪除未完成檔案。DownKyi 的 partial files、completed keys 與 retry checkpoint 需要保留到既有提交邊界,因此只借用責任分離的方向,保留本專案的清理策略。
  • Parabolic 的 2026.4.1 發布說明 記錄了 muxed-only 串流下載失敗、播放清單解析度/音訊及區段成品不完整等修正。這些案例支持保留 media capability、使用者選擇與輸出驗證的區別;本次保留 DownloadMediaContract 和既有 Requested/Available/Finalized/Result 語義。
  • Parabolic 的 2026.5.0 發布說明 記錄了無效資料庫導致無法啟動、macOS 設定目錄與 bundle 依賴的修正。本次區分「原始碼位置」與「使用者資料/發布包位置」,同步建置引用並保留原有 JSON、SQLite、資料目錄與 package layout。

這些案例是取捨的參考;外部專案的修正不代表 DownKyi 存在相同缺陷。研究與比較集中在本 PR 描述,儲存庫文件只同步目前分類、命名與路徑。

驗證

Windows x64,.NET SDK 11.0.100;提交 a50aa450123b1794bb625ab9238d218da2f884e6 的 tree 與完成本機驗證的 index 完全相同,提交後 worktree clean。

  • restore、release-version contract:通過。
  • strict Release solution build:--no-incremental、all analyzers、warnings-as-errors、禁用 shared compilation;0 warnings / 0 errors。
  • 正式 script/test-solution.ps1 -Configuration Release -NoRestore -NoBuild:8 個 Windows 適用專案,2,000 passed、0 failed。另有 1 個既有 explicit 子程序探針為 NotRunnable,由父測試另行呼叫。
  • format、module-boundary audit、actionlint 1.7.12、diff check:通過。
  • NuGet vulnerable/deprecated 查詢:無發現。
  • Gitleaks 8.30.1:0 findings。
  • 搬移前後來源 hash 比對、Git tracked-file inventory 與 ignore 行為檢查:通過。

正式命令依 repository 規定在同一 worktree 順序執行。macOS/Linux 原生執行、打包與遠端 CodeQL 由本 PR CI 驗證。

回滾

整體 revert 本次整理提交,讓來源、測試、建置與打包引用一起恢復。設定、SQLite schema 與續傳格式均未遷移。

@crazysmile-PhD
crazysmile-PhD marked this pull request as ready for review November 16, 2026 06:41
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 16, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-16T06:43:09.641398Z a50aa45 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@crazysmile-PhD
crazysmile-PhD merged commit c9ceefc into main Nov 16, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant