#41 課程學員 Token 環境設定方案

📅 2026-04-09 🏷️ Starter Kit Token 課程

📌 問題背景

主公提問:在課程實施時,每位學生的電腦都有各自獨立的 Cloudflare 帳號與 Token。如何提供方便的方法解決環境設定與 Token 使用場景的設置,且必須打包進 Starter Kit?

參考文件:#37-starter-kit-flow、#16-starter-kit-structure、aiworkforme-deploy/index.html

🔍 現況分析

維度現況課程需求
Token 來源由貞電腦的個人 Token每位學生有自己的 Cloudflare 帳號
設定方式env-setup 寫死路徑(`2f2795bc...`)學員自行輸入 Token + Account ID
重裝後env-setup 可恢復每位學員的環境皆需能恢復
應用場景單人使用多學員、多電腦

🛠️ 三層次解決方案

🟢 第一層:修改 env-setup 為「學員向」
將 env-setup 改為引導式設定,學員輸入 Token,自動儲存到 `.workbuddy/` 本地設定檔。
🟡 第二層:建立 .starter-config.json 範本
Starter Kit 附帶範本設定檔,學員照著填入自己的 Token 和 Account ID,env-setup 自動讀取。
(優先實作,馬上可用)
🔴 第三層:新增 course-first-run Skill
一鍵初始化技能,引導學員完成所有環境設定(Token + 驗證 + 首次部署),適合課程第一天 M1 模組。

📁 建議的 Starter Kit 結構(含 Token 設定)

aiworkforme-starter-kit/├── README-學員必讀.html      ← 指引:先跑 course-first-run
│
├── .starter-config.json       ← ⭐ 學員填入自己的 Token
│
├── SETUP-環境設定指南.html  ← 圖文並茂的 Token 申請教學
│
├── .workbuddy/└── skills/├── env-setup/            ← 修改:支援讀取本地設定
│         ├── course-first-run/     ← ⭐ 新增:課程首日初始化
│         ├── upload-html/└── ...(其餘 Skills)├── 📁 00-課程大綱/
├── 📁 01-8堂課教學計劃/
└── 📁 03-範例練習專案/

✅ 最終結論

  1. 優先實作第二層:建立 `.starter-config.json` 範本 + 修改 `env-setup` 支援讀取本地設定,可立即打包進 Starter Kit
  2. 其次實作第三層:建立 `course-first-run` Skill,專門服務課程第一天 M1 模組
  3. 待主公確認方向後,由貞即可開始實作

📋 待辦行動

🔗 相關備忘