diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..573e585
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,20 @@
+# 更新日志
+
+## Unreleased
+
+## v0.0.1
+
+首个版本。
+
+### 新增
+
+- 学习方式配置：快速学习（只调 `period/study/log` 接口）/ 常规学习（开浏览器真播视频，1–5 路并发）
+- 常规学习：每路独立无头浏览器，可见性补丁防暂停；平台按课节顺序放行时自动降为 1 路，并把被指定的课时提到队首
+- 抓包模式：`POST /api/capture` 记录所有 XHR/fetch（不限域名），`window.open` 新开的标签页同样挂监听，结果落 `data/capture-*.json`
+- 界面：系统设置新增「学习方式」（模式 + 并发数），卡片「更多」菜单新增「抓包 / 停止抓包」
+
+### 修复
+
+- 视频完成上报补齐学时台账 `study/log/detail/save`（stime/etime），完成包不再带 `lastProgressTime`
+- 培训里的「课程」容器节点（periodType 10/13）不会自动完成：补一发 `isComplete`，并用 `PUT /course/front/calFinalScore` 重算课程完成计数
+- 并发上报导致课程完成计数丢失（实测 14 个课时只记 11 个），现在每门课跑完自动重算
diff --git a/metadata.yaml b/metadata.yaml
new file mode 100644
index 0000000..c50c86f
--- /dev/null
+++ b/metadata.yaml
@@ -0,0 +1,3 @@
+name: study-tool
+version: 0.0.1
+description: 东莞市教师培训平台（jspx.dgjy.net / study.dgjy.net）多账号学习控制台