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(本次无代码改动)
This commit is contained in:
study-tool
2026-11-01 20:04:52 +08:00
parent aa48145557
commit 106818cfc2
6 changed files with 205 additions and 118 deletions
+12 -12
View File
@@ -1,14 +1,14 @@
# Agent 任务看板
| 路径 | 任务 | 状态 |
| --- | --- | --- |
| src/study_tool/plugins/gdgxk/main.py、utils/learn.py | 广东公需课:进度页重取任务点状态 + 未完成自动重学 | 已完成,待实测 |
| src/study_tool/plugins/gdgxk/utils/exam.py、main.py | 广东公需课:课程考核解析 + 题库/AI 答题 + 交卷(finishTest2) | 已完成,待实测 |
| web/src/App.tsx、src/study_tool/routes/accounts.py、src/study_tool/plugins/gdgxk/main.py、src/study_tool/database/__init__.py | 修复刷新课程空平台报错 + 旧会话 cookie 回写导致的反复重登 | 已完成,待实测 |
| src/study_tool/platforms/base.py、contract.py、plugins/gdgxk/main.py、plugins/gdgxk/utils/exam.py、plugins/guanyixue/quiz.py、main.py、web/src/components/QuizDialog.tsx | 公需课接入交互式测验:quiz / quiz_submit 槽位 + 按平台分发交卷 | 已完成,待实测 |
| web/src/components/PluginsDialog.tsx、src/study_tool/plugins/__init__.py、src/study_tool/platforms/contract.py | 插件管理卡片:能力名改中文 + 显示适配网站 | 已完成,待实测 |
| src/study_tool/notify.py、plugins/daidai_push/、plugins/__init__.py、config/settings.py、models.py、routes/settings.py、routes/accounts.py、engine.py、plugins/gdgxk/main.py、plugins/guanyixue/utils/spa.py、web/src/components/SettingsDialog.tsx、PluginsDialog.tsx | 故障推送:呆呆面板推送渠道插件 + `notify` 设置项 + 进度异常 / 多次重试 / 登录与运行异常埋点 | 已完成,待实测 |
| web/src/components/SettingsDialog.tsx、web/src/components/ui/Modal.tsx | 系统设置改成左侧分类 + 右侧内容的两栏弹窗(大模型 / 学习模式 / 故障推送) | 已完成,已截图核对 |
| web/src/components/AccountEditDialog.tsx、ui/ConfirmDialog.tsx、ui/Modal.tsx、ui/Button.tsx、AccountCard.tsx、QuizDialog.tsx、App.tsx | 账号卡片加「修改账号信息」弹窗(账号 / 密码 / 备注 / 平台,保存后自动重登)+ 自绘确认弹窗替换 window.confirm | 已完成,待实测 |
| src/study_tool/plugins/gdgxk/main.py、utils/learn.py、web/src/components/ui/LogLines.tsx、AccountCard.tsx、SystemLogDialog.tsx | 卡片标题显示学员姓名(profile 解析个人中心 name)+ 进度上报日志改清楚 + 日志面板改明亮模式并按级别配色 | 已完成,待实测 |
| src/study_tool/app.py、routes/settings.py、notify.py、web/src/components/SettingsDialog.tsx、docs/plugin.md | 发版体检:启动日志不再打印 AUTH_TOKEN、密钥可清空、推送失败不占整段冷却、目录名文案统一 | 已完成,待实测 |
| 路径 | 任务 | Agent | 状态 |
| --- | --- | --- | --- |
| src/study_tool/plugins/gdgxk/main.py、utils/learn.py | 广东公需课:进度页重取任务点状态 + 未完成自动重学 | | 已完成,待实测 |
| src/study_tool/plugins/gdgxk/utils/exam.py、main.py | 广东公需课:课程考核解析 + 题库/AI 答题 + 交卷(finishTest2) | | 已完成,待实测 |
| web/src/App.tsx、src/study_tool/routes/accounts.py、src/study_tool/plugins/gdgxk/main.py、src/study_tool/database/__init__.py | 修复刷新课程空平台报错 + 旧会话 cookie 回写导致的反复重登 | | 已完成,待实测 |
| src/study_tool/platforms/base.py、contract.py、plugins/gdgxk/main.py、plugins/gdgxk/utils/exam.py、plugins/guanyixue/quiz.py、main.py、web/src/components/QuizDialog.tsx | 公需课接入交互式测验:quiz / quiz_submit 槽位 + 按平台分发交卷 | | 已完成,待实测 |
| web/src/components/PluginsDialog.tsx、src/study_tool/plugins/__init__.py、src/study_tool/platforms/contract.py | 插件管理卡片:能力名改中文 + 显示适配网站 | | 已完成,待实测 |
| src/study_tool/notify.py、plugins/daidai_push/、plugins/__init__.py、config/settings.py、models.py、routes/settings.py、routes/accounts.py、engine.py、plugins/gdgxk/main.py、plugins/guanyixue/utils/spa.py、web/src/components/SettingsDialog.tsx、PluginsDialog.tsx | 故障推送:呆呆面板推送渠道插件 + `notify` 设置项 + 进度异常 / 多次重试 / 登录与运行异常埋点 | | 已完成,待实测 |
| web/src/components/SettingsDialog.tsx、web/src/components/ui/Modal.tsx | 系统设置改成左侧分类 + 右侧内容的两栏弹窗(大模型 / 学习模式 / 故障推送) | | 已完成,已截图核对 |
| web/src/components/AccountEditDialog.tsx、ui/ConfirmDialog.tsx、ui/Modal.tsx、ui/Button.tsx、AccountCard.tsx、QuizDialog.tsx、App.tsx | 账号卡片加「修改账号信息」弹窗(账号 / 密码 / 备注 / 平台,保存后自动重登)+ 自绘确认弹窗替换 window.confirm | | 已完成,待实测 |
| src/study_tool/plugins/gdgxk/main.py、utils/learn.py、web/src/components/ui/LogLines.tsx、AccountCard.tsx、SystemLogDialog.tsx | 卡片标题显示学员姓名(profile 解析个人中心 name)+ 进度上报日志改清楚 + 日志面板改明亮模式并按级别配色 | | 已完成,待实测 |
| src/study_tool/app.py、routes/settings.py、notify.py、web/src/components/SettingsDialog.tsx、docs/plugin.md | 发版体检:启动日志不再打印 AUTH_TOKEN、密钥可清空、推送失败不占整段冷却、目录名文案统一 | | 已完成,待实测 |