Skip to content

整理 repository 結構、加入雙語安裝網站與 Pages 更新流程 - #3

Merged
lee98064 merged 4 commits into
mainfrom
chore/repo-structure-and-pages
Nov 12, 2026
Merged

lee98064 merged 4 commits into
mainfrom
chore/repo-structure-and-pages

Conversation

@lee98064

Copy link
Copy Markdown
Owner

摘要

把 repository 整理成常見的開源專案結構,加入雙語安裝網站,並讓 Pages 部署與線上更新索引合併成同一個流程。

結構

  • 文件分成 docs/guide、docs/install、docs/development、docs/reports,新增 docs/README.md 索引;所有相對連結已更新(39 份 Markdown、204 個連結/錨點,0 失效)
  • 新增 LICENSE(MIT,只涵蓋本專案撰寫的程式與文件;原廠與第三方內容排除,見 README 與 third_party/README.md)、CHANGELOG.md、CONTRIBUTING.md、SECURITY.md、issue/PR 範本、README.en.md
  • 移除工作階段紀錄(scope/timeline)、已被取代的舊稽核 JSON 與舊 UI 截圖(歷史 tag 仍可查)
  • reverse/decompiled、reverse/symbols(4,792 檔)移出 Git,改為 v0.3.0-preview 的 Release 附件 reverse-research-archive.zip(SHA-256 f1d4dc59…dce6);check_public 不再把本機保留的副本算進公開檔案

安裝網站(site/)

  • 繁中說明書風格+英文白話,共用樣式;安全警告、六章安裝/使用說明、常見問題、下載
  • 頁面讀取同網域的 updates/index.json 顯示最新韌體並產生 Release 連結

Workflows

  • ota.yml 拆成 ci.yml(PR/main,可重用)與 release.yml(tag;Release 說明取自 CHANGELOG)
  • pages.yml 取代 update-feed.yml:每次部署都複製 site/ 並重新放入已驗證的 updates/matter.ota 與 index.json;拒絕降版;部署後檢查線上索引 bytes、OTA SHA-256、CORS *、/ 與 /en/
  • 插座讀取的 catalog_url 與檔名、格式完全不變

驗證

  • 本機依 pages.yml 步驟實際組出 _site(選到 v0.3.0-preview、簽章驗證、validate_catalog_upgrade 13→14、索引與 Release index.json 完全相同),以專案路徑+CORS 模擬 Pages 後 smoke 通過,兩個語言頁都讀到 v0.3.0
  • 以 v0.2.11 管理頁原本的篩選程式碼讀新索引:v0.2.11 插座會看到 0.3.0-preview
  • 原生/node 測試、新增的 Pages 17 項與 CHANGELOG 測試、test_deployment、check_public、actionlint 全數通過
  • GitHub Actions 目前因帳號帳單鎖定無法執行;恢復後需手動觸發一次 pages.yml

🤖 Generated with Claude Code

lee98064 and others added 4 commits November 12, 2026 17:47
Group docs into guide/, install/, development/ and reports/, drop
per-session scope/timeline notes, superseded audits and old UI
screenshots, and add LICENSE (MIT for project-authored code only),
CHANGELOG, CONTRIBUTING, SECURITY, issue/PR templates and bilingual
READMEs with the v0.3.0 screenshots.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
reverse/decompiled and reverse/symbols are now published as
reverse-research-archive.zip on the v0.3.0-preview release and ignored
locally. The public audit skips them so local copies never reach a
public package.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Traditional Chinese manual-style guide and plain-English page sharing
one stylesheet. The pages read updates/index.json to show the newest
firmware and link its release assets.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ci.yml runs the test suite on PRs and main and is reused by release.yml,
which takes release notes from CHANGELOG.md. pages.yml replaces
update-feed.yml: every deploy copies site/ and re-adds the verified
release OTA and catalog under updates/, refuses downgrades, and
smoke-tests the live catalog, OTA hash, CORS header and both pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@lee98064
lee98064 merged commit ffa2cd1 into main Nov 12, 2026
1 check failed
@lee98064
lee98064 deleted the chore/repo-structure-and-pages branch November 12, 2026 10:03
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