終端機優先的 kan.bn 教育工具：學生用 CLI 更新進度並反思，教授監控全班思考參與度。
Project description
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 # 私人鏡子：只看自己的思考軌跡（無排名/分數/他人）
教授快速上手
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: xiaoming@example.com
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。
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
edukan-0.2.0.tar.gz
(15.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
edukan-0.2.0-py3-none-any.whl
(20.0 kB
view details)
File details
Details for the file edukan-0.2.0.tar.gz.
File metadata
- Download URL: edukan-0.2.0.tar.gz
- Upload date:
- Size: 15.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e205a37001c41fd6a962b81f7ec09088b246dc393c845eb6f61a5a5b95e08f92
|
|
| MD5 |
59682f99f39f5e5d8e033b71a61dc14d
|
|
| BLAKE2b-256 |
8cf9d005c2af5be6104afe2b4724a2e9826da7276b476876d944b8eaae6ced67
|
File details
Details for the file edukan-0.2.0-py3-none-any.whl.
File metadata
- Download URL: edukan-0.2.0-py3-none-any.whl
- Upload date:
- Size: 20.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7466b0d9c77f8cfdad5874c604587c3593c97ff9a628b72cf9479d86d0e44108
|
|
| MD5 |
e200f53faa0dca97fcef13de8a2b40a2
|
|
| BLAKE2b-256 |
9b0d841de8e486b4bcc52dfed41e2aea0bb0fdd8a42c760cab485a2dfd9b4f92
|
