edukan 0.4.0

終端機優先的 kan.bn 教育工具：學生用 CLI 更新進度並反思，教授監控全班思考參與度。

EduKan

終端機優先的 kan.bn 教育工具。學生用 CLI 更新進度並留下思考痕跡；教授監控全班的思考參與度並做出有證據的形成性回饋與評分。

核心理念：學生在卡片上寫的 comment 與描述修改，組成一份「思考語料」——它既是學生成長的學習產物，也是教授打分的證據。「把卡片拖到 Done」不等於「有思考」。

設計：兩層分開

• Tier 1 參與度（雷達，不算分）：最近活躍、思考活躍天數、進度燈號 🟢🟡🟠🔴⚪，只用來路由教授的注意力。
• Tier 2 思考深度（打分依據）：教授（或 Claude 輔助）親讀思考語料，依公開方向的 rubric 評估。

安裝

uv tool install edukan      # 推薦（或 pipx install edukan / pip install edukan）

學生快速上手

edukan login                       # 貼上 kan.bn API key（kan_xxx）
edukan use-board <你的 board id>   # 設定一次

edukan card update <cid> --list Complete   # 移到完成欄 → 邀請你寫一句反思
edukan comment add <cid> "我發現原本的假設在 X 不成立，所以改成…"
edukan me                          # 私人鏡子：只看自己的思考軌跡（無排名/分數/他人）

詳見 docs/student-sop.md。

教授快速上手

edukan login
edukan admin summary --cohort 2026-spring --roster roster.yaml   # 全班 triage 雷達
edukan admin student 王小明 --cohort 2026-spring --roster roster.yaml   # 讀某生思考語料

roster.yaml（班級名冊，支援 cohort/學期、封存）：

workspace: <workspacePublicId>
cohorts:
  2026-spring:
    done_lists: ["Complete", "Done"]
    students:
      - name: 王小明
        email: [e-mail]
        board: <boardPublicId>      # 在 kan.bn 網頁手動建好後填入

開發

uv sync
uv run pytest                 # 單元 + 契約測試
EDUKAN_LIVE=1 uv run pytest tests/test_smoke_live.py   # 對真實 kan.bn 的唯讀煙霧測試

設計文件見 docs/plans/。授權：MIT。