Skip to content

同步框架至 v2:課程搬進 courses/、文案改用 **粗體**、補上 frameworkVersion - #2

Merged
htlin222 merged 1 commit into
mainfrom
sync/framework-v2
Aug 2, 2026
Merged

htlin222 merged 1 commit into
mainfrom
sync/framework-v2

Conversation

@htlin222

@htlin222 htlin222 commented Aug 2, 2026

Copy link
Copy Markdown
Owner

落後 27 個 commit,中間跨了一次破壞性變更(文案契約)。照 docs/MIGRATION.md 的 v1 → v2 逐項做——這也是那份遷移指南的第一次真實測試

遷移

項目 做了什麼
目錄 course/courses/gym/。框架已改成 courses/<名字>examples/<名字>course/ 這個位置在新版根本不會被解析到
文案 6 個 <strong>**粗體**。v2 一律先逸出,寫標籤只會原樣印出來
欄位 ui.filterAllui.filterAllLabel
版號 加上 "frameworkVersion": "2.0.0"最後才加
圖示 COURSE=courses/gym make icons 重打包(48 個,含 12 個課程專屬)

版號最後才加是 MIGRATION.md 明寫的:遷移沒做完就宣告版號,稽核會以為已經遷移完,然後把真正的問題混在一般品質警告裡。

同步過程中回頭修好的兩個框架 bug

  1. ui.filterAll 被 v2 弄丟了——「全部」被寫死在 app.js。順著查發現前端有四十幾個中文字串沒有設定檔路徑,框架其實做不了非中文的課(curate-course#60)。
  2. 脫鉤測試斷言「examples/ 底下至少要有一門範例課」——那是框架 repo 才成立的假設,課程 repo 的課在 courses/,於是 make check 必定失敗(curate-course#61)。

兩個都是只有真的同步一次才會撞到的東西。

清掉從骨架帶過來、卻屬於別的專案的東西

  • LICENSECopyright (c) 2026 body-course contributorsgym-course
  • docs/plans/2026-07-25-body-course-design.mdbody-course 的設計文件,躺在 gym-course 裡

這兩項正是框架 quality.md「換主題時最容易漏掉的」新補的兩列所預測的,而它們真的都在。

一併帶進來的框架能力

frameworkVersion 契約、文案 AI 痕跡檢查、選片品質指標、實證分級要有研究設計撐著、撤稿偵測、PR 上的增量引用驗證、介面字串可從 ui.text 覆寫。


make check:88 個測試通過、稽核零錯誤、5 個警告。

🤖 Generated with Claude Code

https://claude.ai/code/session_0123CebVavLfrSrtxGD3SnvU

落後 27 個 commit,中間跨了一次破壞性變更(文案契約)。照 docs/MIGRATION.md
的 v1 → v2 逐項做,這也是那份遷移指南的第一次真實測試。

## 遷移

- course/ → courses/gym/(框架已改成 courses/<名字> 或 examples/<名字>,
  course/ 這個位置在新版根本不會被解析到)
- 文案的 6 個 <strong> 改成 **粗體**:v2 一律先逸出,寫標籤只會原樣印出來
- ui.filterAll → ui.filterAllLabel(框架這一版才把「全部」接回設定檔;
  v2 一度把這個欄位弄丟,是同步時才發現的,已回頭修好框架)
- 加上 "frameworkVersion": "2.0.0",最後才加——遷移沒做完就宣告版號,
  稽核會以為已經遷移完,然後把真正的問題混在一般警告裡
- COURSE=courses/gym make icons 重打包 sprite(48 個圖示,含 12 個課程專屬)

## 清掉從骨架帶過來、卻屬於別的專案的東西

- LICENSE 的 "Copyright (c) 2026 body-course contributors" → gym-course
- docs/plans/2026-07-25-body-course-design.md:body-course 的設計文件,
  躺在 gym-course 裡

這兩項正是框架 quality.md 的「換主題時最容易漏掉的」新補的兩列所預測的,
而它們真的都在。

## 一併帶進來的框架能力

frameworkVersion 契約、文案 AI 痕跡檢查、選片品質指標、實證分級要有研究
設計撐著、撤稿偵測、PR 上的增量引用驗證、介面字串可從 ui.text 覆寫。

make check:88 個測試通過、稽核零錯誤、5 個警告。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0123CebVavLfrSrtxGD3SnvU
@htlin222
htlin222 merged commit 0c327f7 into main Aug 2, 2026
3 of 5 checks passed
@htlin222
htlin222 deleted the sync/framework-v2 branch August 2, 2026 23:48
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