本 Repository 為 LiangHao 開發環境與多專案治理的中央控制中心。保存全域開發憲法 v8.5、LiangHao 四大核心共用技能庫(Shared Skill Pack v2)、14 個開發 Repository 清單,以及 Windows 環境重建與一鍵自癒佈置腳本。目前版本為 v1.8.0。
🌐 公開專案展示入口:所有作品集、Demo 與 GitHub Pages 頁面已獨立遷移至 lianghao02/Project-Hub(展示站:https://lianghao02.github.io/Project-Hub/)。中央控制中心專注於環境與治理,不再兼任展示網站。
- 工作區主力技術依專案用途分流:AI 鑑識與行政自動化維持 Python、免安裝資料工具維持純 Web、Windows 原生工具採 C#/.NET 8/WPF。
03_Police-Image-Toolkit、06_System-Optimizer-Tool與09_PaperSwitch已完成 C#/.NET 8/WPF 遷移;舊版分別封存於legacy_web/與legacy-python/,供回歸比對與備援。04_Photo-Report-Generator已為純前端 SPA,並不依賴 VBA 或 Microsoft Office;其餘專案尚未進行 Rust、Tauri 或 TypeScript 遷移。- 專案入口網站已獨立為
13_Project-Hub,採純靜態 Web 與 GitHub Pages 託管。 - 最新納入相片管理工具
14_Google-Photos-Takeout-Organizer,總計管理 14 個 Repository。
- 用途:集中管理專案清單、Git 同步、Codex/Antigravity 規則,以及仍採 Python 的專案可攜環境。
- 必要軟體:Windows 10/11、Git for Windows;建議使用 PowerShell 7,未安裝時各入口會自動退回 Windows PowerShell 5.1。管理功能本身不要求先安裝 Python。
- 下載:
git clone https://github.com/lianghao02/Dev-Control-Center.git 00_Dev-Control-Center。 - 主要入口:一般使用者直接雙擊
0_開發中樞.bat進入終端選單;1_~3_保留為直接快捷入口,0_控制中心_手帳儀表板.bat則保留為選用 GUI 儀表板。進階使用者可執行scripts/下對應 PowerShell 腳本。 - 網路需求:Clone、Pull、Push 與首次下載 Python 可攜核心時需要網路;若
downloads/已有安裝母檔,Python 環境可離線建置。 - 打包方式:本專案是管理腳本集合,不需編譯或安裝;備份時保留完整資料夾即可。
在 00_Dev-Control-Center 根目錄提供精煉的批次入口;BAT 只負責定位 PowerShell 與啟動腳本,Git、建置、環境與 Agent 邏輯皆集中於 PowerShell:
-
🧭
0_開發中樞.bat(日常主入口):- 開啟
scripts\dev-hub.ps1終端選單,可快速檢查、執行安全同步、建置、檢查/同步 Agent 技能庫與憲法、檢查環境或開啟 GUI。 - 選單項目
[4] 檢查 / 同步 Agent 設定支援一鍵執行:1:AgentCheck(唯讀檢查),比對本機與雙平台(Codex / Antigravity)的技能目錄與雜湊一致性。2:AgentSync(正式同步),一鍵將全域憲法與 4 大共用 Skill 鏡像推播至雙平台原生設定目錄。
- 優先使用 PowerShell 7,未安裝時自動退回 Windows PowerShell 5.1;以 BAT 自身位置推導路徑,不依賴固定磁碟代號或目前工作目錄。
- PowerShell 7 的唯讀快速掃描採最多 4 條平行工作;Windows PowerShell 5.1 維持序列掃描,兩者均使用相同安全狀態分類。
- 開啟
-
📔
0_控制中心_手帳儀表板.bat(選用 GUI):- 啟動後立即顯示儀表板,預設維持「尚未掃描」;使用者可按 Level 1/2/3 按鈕才執行所需檢查。
- 保留 Repository 視覺總覽、同步、桌面建置、Agent、環境與日誌等進階操作。
-
🌟
1_全專案智慧同步中樞.bat(日常開發主力):- 雙擊即時掃描 14 個專案之本機與雲端狀態。
[1] ⚡ 智慧全自動同步:只拉取工作目錄乾淨的版本庫,分發 AI 設定後只推送既有提交;未提交修改一律保留並提示逐案檢視。- 支援
main與master,並提供[2]僅拉取更新、[3]僅推送既有提交、[4]僅分發 AI 憲法與 Skills。
-
🌟
2_建置所有桌面應用程式.bat(版本建置主力):- 一鍵集中編譯 6 個桌面/可攜式應用程式(
01,03,04,06,07,09)。 - 嚴格分離「建置」與「發布(Release)」;GUI 與批次檔皆提供安全建置與即時輸出檢視。
- 一鍵集中編譯 6 個桌面/可攜式應用程式(
-
🌟
3_環境建置與工具安裝.bat(環境初始化與維護):[1]一鍵為 Python 專案(01,07,10,12)建置可攜式 Python 3.13 環境(python_embed)。[2]檢測並補齊核心 Git、GitHub CLI、Python 3.13 與 .NET 8;Node.js 為建議元件,Rust、Playwright 與 Tauri 前置元件依實際需求安裝。
成品維持在各專案既有的發布目錄;AG-MONITOR 完整 CPU 可攜包輸出至 01_AG-MONITOR-Smart-Video-Screening\dist\。若只想確認路徑與發布腳本是否齊全,可省略 -Execute 進行預覽。
先安裝 Git for Windows,再於 PowerShell 執行:
New-Item -ItemType Directory -Path 'C:\Development\GitHub' -Force
git clone https://github.com/lianghao02/Dev-Control-Center.git 'C:\Development\GitHub\00_Dev-Control-Center'
# 預覽,不修改檔案
powershell.exe -NoProfile -ExecutionPolicy Bypass -File 'C:\Development\GitHub\00_Dev-Control-Center\scripts\sync_projects.ps1'
# 正式複製/更新專案並部署 Codex、Antigravity 規則
powershell.exe -NoProfile -ExecutionPolicy Bypass -File 'C:\Development\GitHub\00_Dev-Control-Center\scripts\sync_projects.ps1' -Execute腳本會依 development-repositories.json 處理 14 個 Repository。遇到既有未提交變更時會略過;遇到分支分歧時會繼續檢查其餘專案並於結尾列出,不會自動刪除任何本機資料夾,也不會強制覆蓋 Git 歷史。
- 全域規則唯一編輯源:configs/AGENTS.md(部署至各 Agent 環境之全域開發憲法 v8.5)
- 共用技能庫唯一編輯源:
skills/(Canonical 來源目錄,嚴禁反向覆蓋) - 分流部署定義檔:configs/skills-manifest.json(定義雙平台共用與專用技能)
- 跨專案改善事項總表:IMPROVEMENTS.md(所有專案已確認改善與待辦唯一彙整表)
- 當前交接狀態斷點:HANDOFF.md(本專案之工作交接與中斷紀錄)
本開發生態系統採用模組化 Skill 架構,提供判斷框架與安全預設,所有技能均為 Stable 維護狀態:
lianghao-development(v1.0.0):跨 Agent 軟體工程與專案治理標準(AUDIT、EVALUATE、FIX、IMPROVE、RELEASE、HANDOFF 與發布門檻)。taiwan-office-automation(v1.0.0):臺灣公務行政與 Office/PDF 自動化(民國日期、Excel 長帳號/前導零防破壞、Word/PDF 雙軌擷取、公文文風)。safe-data-processing(v1.0.0):使用者原始資產安全處理(Inspect-First 盤點、Copy 優先、Dry Run 模擬預覽、來源模式驗收、隔離審查概念)。windows-tool-ux(v1.0.0):Windows 桌面工具與使用者體驗(Win10/11 雙相容、Portable 免安裝架構、零假死防凍結設計、實測導向非同步)。
scripts/sync_codex.ps1 執行時,會將中央設定單向鏡像部署至雙平台原生目錄:
- 全域憲法 ➜
%USERPROFILE%\.codex\AGENTS.md與%USERPROFILE%\.gemini\config\AGENTS.md - Codex 技能目錄 ➜
%USERPROFILE%\.agents\skills\<skill-name> - Antigravity 技能目錄 ➜
%USERPROFILE%\.gemini\config\skills\<skill-name>
外圍輔助技能亦由 configs/skills-manifest.json 統一管理分流(如 project-readiness-check、webapp-testing、document-to-markdown 等 shared 技能,以及 Antigravity 專用的 skill-creator)。%USERPROFILE%\.codex\skills 的個人獨立 Skill 與系統原生 Skill 均不會被覆寫。
# 唯讀檢查(比對本機與雙平台目錄狀態與 Hash)
.\scripts\sync_codex.ps1 -CheckOnly
# 或透過 dev-hub 執行
.\scripts\dev-hub.ps1 -Action AgentCheck
# 正式同步(將全域憲法與所有共用 Skill 推播至雙平台)
.\scripts\sync_codex.ps1 -Execute
# 或透過 dev-hub 執行
.\scripts\dev-hub.ps1 -Action AgentSync
# 僅在強制覆蓋目標設定時才使用 Force
.\scripts\sync_codex.ps1 -Execute -Force以下資料不得提交至 GitHub,必須在每台電腦個別設定:
.env、API Key、Token、密碼- Python
.venv node_modules- 瀏覽器登入狀態與 Cookie
- 大型模型快取、pip 快取、應用程式快取
各 Python 專案應依自己的 requirements.txt 或 pyproject.toml 重新建立虛擬環境,不得直接複製其他電腦的 .venv。
- 同步專案前先檢查 Git 狀態;有未提交變更時直接略過。
- 只允許
pull --ff-only,不自動合併、rebase 或 force push。 - 同步中樞將每個版本庫明確分為
Synced、Modified、Ahead、Behind、Diverged、Error或Missing;只有Ahead會進入「推送既有提交」流程,該流程不會執行git add或git commit。 - 產生 JSON 與部署文件時使用 UTF-8 無 BOM,避免 PowerShell 5.1 編碼差異。
- 部署前保留可復原備份,並限制備份數量,避免長期累積。
- 實體開發路徑:
D:\Development\GitHub - 舊工具相容路徑:
C:\Users\<使用者名稱>\Documents\GitHub
Junction 屬於選用的本機相容設定,不儲存在 Git 中。詳細規範請參閱 docs/DEVELOPMENT_ENVIRONMENT.md。