hanhan/study-tool
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
29 Commits 1 Branch 1 Tag
master
Commit Graph

22 Commits

Author SHA1 Message Date
study-tool 48e72ab1e7 docs: 发版流程拆成通用与项目两层 
现象：AGENTS.md「发版本流程」里写死了本项目的文件名和命令（metadata.yaml、uv tool run
bump-my-version、uv.lock），换项目没法直接复用；手写那一行还出现了 `runm` 和 `etadata.yaml`
两处笔误。

根因：通用规则和项目实现细节混在同一节，规则文件承担了本该属于架构文档的内容。

边界：
- AGENTS.md「发版本流程」改成通用表述：确认后触发、CHANGELOG 整理、锁文件自检、发版工具一次
  完成改版本 + 提交 + 打 tag、tag 查重、发版不构建；不再出现具体文件名和命令
- docs/architecture.md 新增「发版」一节，放本项目的三处版本文件、bump-my-version 命令、
  CRLF + regex 的配置坑、改配置后先 dry-run
- docs/agent_workflow.md「项目契约和 Agent 行为规则分开」补上这次的证据，Seen 升到 2×
- 不改代码、不改版本号、不打 tag

运行了什么：git status 自查（只提交这 3 个文档文件）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑 bump-my-version 真实发版；没跑测试、没构建（本次无代码改动）
 2026-11-01 21:22:56 +08:00
study-tool d8808e64d9 docs: AGENTS.md 增加收尾提交规则，发版流程改为工具驱动一条线 
现象：发版流程里「手动提交 + 手动打 tag」与 bump-my-version 的 commit = true / tag = true
冲突，真用工具会撞同名 tag；另外没有写清「何时提交、何时必须先提交」，导致为 1 行 uv.lock
单开了提交（4784ac0）。

根因：发版步骤是按手动流程写的，后来才配了自动提交 + 打 tag 的工具，两边没有对齐；提交时机
只散落在发版一节里。

边界：
- 新增「收尾（Commit）」：任务完成后自动提交，一个任务一个 commit；附带产物（如 uv.lock）
  跟着产生它的任务走；重大变更（改依赖 / 表结构 / 规则文档 / 发版）开始前工作区必须干净；
  发版本只在用户确认后触发
- 「发版本流程」改为：整理 CHANGELOG 并普通提交 → uv lock 自检 → 工作区干净后
  uv tool run bump-my-version bump patch 一次完成改三处版本 + 提交 + 打 tag；不再手动 commit / tag
- docs/agent_workflow.md 记入三条：发版配置要 dry-run、发版只留一条线、附带产物不单开提交
- 不改代码、不改版本号、不打 tag

运行了什么：git status 自查（只提交这 2 个文档文件）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑 bump-my-version 真实发版；没跑测试、没构建（本次无代码改动）
 2026-11-01 21:17:42 +08:00
study-tool 106818cfc2 docs: 消解 AGENTS.md 规则冲突，项目契约迁入架构文档 
现象：AGENTS.md 里 5 处规则互相打架——逐次询问 vs 认领/提交/升版本；不构建 vs 前端必须
build；全部提交 vs 禁 add -A；每次提交 bump 版本号，而实际 24 次提交版本仍是 0.0.8。
docs/agent_board.md 没有 Agent 列，认领规则无法落地；docs/agent_workflow.md 是 0 字节；
docs/todo.md 与 docs/progress/todo.md 双账本漂移，旧文件还写 platforms/gdgxk.py。

根因：规则按「想防的事」逐条追加，没有回头消解冲突；项目契约和 Agent 行为混在同一个入口文件里。

边界：
- AGENTS.md 只留行为规则；日志 / 目录 / 插件契约指向 docs/architecture.md（两节内容已并入，未丢失）
- 版本号改为只在发版提交时 bump，普通提交不动
- 看板改四列表头，状态带时间戳「进行中 (MM-DD HH:mm)」，超 24h 可接管
- 删除 docs/todo.md；其中 2 条仍未修的代码问题已迁入 docs/progress/todo.md，待办按 待做 / 已知偏差 / 未验证 重排
- 不改代码、不改版本号、不打 tag

运行了什么：git status 自查（只提交这 6 个文档文件，uv.lock 是原有改动未提交）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑测试、没构建、没跑 pnpm build（本次无代码改动）
 2026-11-01 20:06:23 +08:00
study-tool aa48145557 feat: 故障推送 / 公需课自动重学 / 插件解耦，发版 v0.0.8 
体检修复：启动日志不再打印 AUTH_TOKEN、密钥可清空、推送失败不占整段冷却、目录名与文案统一成 plugins/。
 2026-11-01 17:47:22 +08:00
study-tool 491fd08c1e refactor(plugins): 莞易学迁到 pugins/guanyixue 
- platforms/guanyixue.py → pugins/guanyixue/main.py
- jspx.py / study.py / detect.py 一并搬进插件目录，插件自包含：
  热重载会把实现模块一起重新 import，不再是半截插件
- 导入路径改成 study_tool.pugins.guanyixue.*；quiz.py 两处引用同步更新
- platforms/__init__.py 只剩运行时，load_builtin() 只调 load_plugins()
- 新增 pugins/guanyixue/pugin.json（id / title / name）
- 同步 AGENTS.md、docs/architecture.md、docs/pugin.md、docs/OPTIMIZATION.md
 2026-10-31 16:18:45 +08:00
study-tool 8e8d6b83f1 fix(env): 本机启动读取根目录 .env，监听地址兼容 BIND_ADDR 
- study_tool/__init__.py 用 python-dotenv 加载根目录 .env，位置早于
  store / config 读环境变量；已有环境变量优先，Docker 注入的不受影响
- app.py 监听地址改为 HOST -> BIND_ADDR -> 127.0.0.1 依次回退
- 新增依赖 python-dotenv>=1.0（pyproject.toml / requirements.txt / uv.lock）
- README 环境变量表补充 .env 说明与 BIND_ADDR / TZ 两行
- CHANGELOG / docs/OPTIMIZATION.md 记录本次修复，版本号 0.0.6 -> 0.0.7
 2026-10-31 16:12:52 +08:00
study-tool cfa960221e feat(web): 插件管理弹窗（启停 / 重载） 
- 顶栏新增「插件管理」图标按钮，打开 PluginsDialog
- 弹窗列出 pugins/ 下的插件：标题 / 目录名 / 是否启用与已加载 / 平台 label / 能力清单
- 每个插件可启用、停用、重载，底部有「全部重载」
- 启停成功后重新拉 /api/platforms，「添加账号」的平台下拉同步刷新
- types.ts 新增 PluginInfo；App.tsx 把平台列表加载提成 loadPlatforms 复用
- static/ 重新构建（pnpm typecheck + pnpm build 均通过）
- 顺带把 .vscode/ 纳入跟踪
 2026-10-31 16:01:44 +08:00
study-tool f8458cff51 feat(plugins): 插件支持热加载与启用/停用清单 
- pugins/__init__.py 重写：load_plugins / discover / set_enabled / reload
- 热加载：把 study_tool.pugins.<名字> 的模块从 sys.modules 摘掉后重新 import；
  重载前先 registry.unregister 旧 id，平台 id 改了也不会留残影
- 启用清单存设置项 plugins（{"disabled": [...]}）：未列出的默认启用，新插件自动生效；
  停用即从注册表摘掉，/api/platforms 与账号平台下拉同步消失
- platforms/registry.py 新增 unregister(pid)
- 新接口：GET /api/plugins、POST /api/plugins/{name}/enable|disable、
  POST /api/plugins/reload、POST /api/plugins/{name}/reload；失败返回 ok=false
- 同步 docs/pugin.md（新增「加载与启停」）、docs/architecture.md、docs/OPTIMIZATION.md、AGENTS.md
 2026-10-31 15:50:06 +08:00
study-tool f1a57853f4 refactor(plugins): gdgxk 迁到 pugins/gdgxk，插件由目录扫描加载 
- platforms/gdgxk.py → pugins/gdgxk/main.py（实现不变，仍是 class Gdgxk(Platform)）
- pugins/gdgxk/pugin.json 只放注册信息 id / title / name，不声明任何能力绑定
- pugins/__init__.py：load_plugins() 扫 pugins/*/pugin.json、import 各自的 main.py，
  再用 pugin.json 的 id 校验注册结果；要换加载方式只改这一个函数
- platforms/__init__.py::load_builtin() 调 load_plugins()；guanyixue 依赖 jspx/study，
  暂留 platforms/
- engine / routes / quiz / contract / 前端未改动
- 同步 AGENTS.md、docs/architecture.md、docs/OPTIMIZATION.md
 2026-10-31 15:41:22 +08:00
study-tool bdd0bdf073 refactor(platforms): 平台插件改为 Platform 子类形态 
Platform 由 dataclass 改为普通基类（类属性 + 方法槽位），禁止逐项传函数注册；gdgxk 与 guanyixue 完成迁移；AGENTS.md、architecture.md 同步新契约；新增 docs/pugin.md（骨架 / 槽位契约 / 开发与迁移流程 / 常见坑），OPTIMIZATION.md 补待测条目。
 2026-10-31 15:07:25 +08:00
study-tool f999e4fa4d refactor(platforms): 平台能力改为子类实现，注册不再逐项绑定函数 
- Platform 由 dataclass 字段绑定改为基类：id / label / entries 是类属性，能力是子类方法，
  未实现的阶段保持基类 None，capabilities() 与 /api/platforms 输出不变
- gdgxk：session（原 new_session）/ login / list_courses / discover / study / _relogin
  收进 class Gdgxk(Platform)，解析与上报 helper 仍是模块级函数
- guanyixue：改成 class Guanyixue(Platform)，方法转调 jspx / study
- 删除 src/study_tool/pugins/ 草稿目录（内容与 platforms/gdgxk.py 重复，
  pugin.json 里按名字声明 study / entries 的绑定方式作废，元数据改由类属性承载）
- 引擎 / 路由 / quiz / contract / 前端未改动
- 同步 docs/architecture.md、AGENTS.md、docs/OPTIMIZATION.md
 2026-10-31 15:02:21 +08:00
study-tool b1ccfe89f6 docs: 插件改为 Platform 子类形态，更新 pugin.md 契约与迁移步骤 2026-10-31 14:56:10 +08:00
study-tool 53bddbabaa docs: 按 json 驱动的插件方案更新 pugin.md 
确定 pugin.json 为唯一权威：加载器读 json 注册，main.py 只提供函数；补加载器流程、schema 校验规则、迁移待办。
 2026-10-31 14:51:42 +08:00
study-tool a6aa6a88f9 docs: 沉淀插件目录方案与开发流程（docs/pugin.md） 2026-10-31 14:43:15 +08:00
study-tool 7259ab8d96 refactor(platforms): 学习流程下沉到平台层，engine 只保留编排 
SessionExpired 移到 platforms/errors.py；旧版流程（_study_builtin）搬到 jspx.py，新版 SPA 流程（run_study_course + 视频）搬到 study.py；engine.py 只剩账号级编排，不再 import 具体平台；routes/quiz 去掉平台 star import，session/dump_cookies 缺失时明确报错。顺带修复学习链路三处未定义全局名（jspx/study/quiz）。
 2026-10-31 14:21:36 +08:00
study-tool d702830470 feat(platforms): 增加能力推导与 /api/platforms capabilities 字段 
新增 platforms/contract.py：生命周期 ↔ 槽位 ↔ 能力名映射，capabilities_of 按非空槽位推导；Platform.capabilities() 供 /api/platforms 返回 capabilities。行为不变，现有流程与前端未改。同步 architecture.md（生命周期与能力、广东公需课）、todo 第二/三步、OPTIMIZATION 平台列表。
 2026-10-31 13:54:28 +08:00
study-tool e6515fe278 fix: 运行状态与日志三处修复；依赖改用 uv 锁 + 国内镜像 
- 重启标记不再污染新一轮运行：hydrate_runs() 标记「已中断」后立即落库，runtime.set_state() 在切入 discovering/studying 时清掉上一轮的 error/progress/finished_at
- 服务重启后卡片「课程日志」能读到 SQLite 历史：前端兜底条件不再拿 status 是否为空做判断（重启后 status 恒为 interrupted）
- 删除账号连带清日志：account_delete() 按账号 id + 用户名清 run_state/run_log/login_log，删除接口同时清内存里两个 key
- 新增 uv.lock 依赖锁定；pyproject 走阿里云 PyPI 镜像，Dockerfile 支持 PIP_INDEX_URL 构建参数
- 文档移入 docs/，.gitignore 忽略 *.egg-info/（uv run 可编辑安装产物）
 2026-10-31 00:53:40 +08:00
study-tool c4bc97dd70 feat(gdgxk): 课程卡片显示培训年度 / 学时 / 完成状态 
- list_courses 解析 showCourse 卡片里的「培训年度」「课程学时」「未完成/已完成」，
  返回 section / info / status_label，前端拼成「2026年公需课 · 未完成 · 30 学时」
- 修正完成判定：以平台状态为准（需所有教学活动 100% + 试卷考核 ≥60），
  不再用视频秒数够不够来推断，避免把未完成的课当已学完跳过
 2026-10-30 22:33:46 +08:00
study-tool 31f7020190 fix(gdgxk): 打通登录全链路（图形验证码 OCR + 正确换票入口） 
- 登录要过 4 位图形验证码：readCaptcha 返回 data:image/png;base64，用 ddddocr 识别，
  失败按登录页 #errorText 判断原因并最多重试 5 次
- 换票入口纠正：票按 ITLMS-xxx||ticketId 两段 GET /nts/loginToStoreByAccount，
  之前直接带 ?ticket= 访问 courseRegister 是无效的
- requirements / pyproject 增加 ddddocr；文档同步实测结论
 2026-10-30 22:30:32 +08:00
study-tool 16346159c2 feat: 接入广东公需课平台（jsglpt 登录 + jsxx 进度心跳） 
- 新增 platforms/gdgxk.py：base64 登录 → ssoItlmsGxkTicket 换票进 jsxx →
  /uc/store/courseRegister 取课程 → updateViewTime1 心跳上报进度（无需真播）
- platforms/__init__.py 注册；配套抓包脚本与自测脚本
- CHANGELOG / OPTIMIZATION / todo 同步，版本升到 0.0.2
 2026-10-30 22:17:47 +08:00
study-tool 1a3347f7f9 feat: 添加账号支持选择学习平台 
账号新增 platform 字段，登录/刷新课程/发现课程按平台分发；同时把 JS 脚本收进 script/（目录规范调整）。
 2026-10-30 01:13:47 +08:00
study-tool e8634a6317 refactor: React 前端重构，新旧平台合并为莞易学 2026-10-29 23:53:17 +08:00