root/vscode-workbench
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

feat(M4): S-02部署基线复核+I-02本仓CI与备份演练+储备评审；M3遗留C-03/S-01/C-04证据补齐；12项PROGRESS归属+collect解析修复
vscode-planning-ci / planning-smoke (push) Failing after 1m31s
Details

Browse Source
This commit is contained in:
root
2026-09-14 03:46:37 +08:00
parent ec55b5a845
commit 5b3850c191
23 changed files with 827 additions and 499 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitea/workflows/planning-ci.yml
+27
View File
@@ -0,0 +1,27 @@
name: vscode-planning-ci
# I-02 · 本仓 CI（Gitea Actions / GitHub Actions 兼容：纯 push/pull_request 触发，无私有凭据）。
on:
push:
pull_request:
jobs:
planning-smoke:
runs-on: ubuntu-latest
defaults:
run:
working-directory: PLANNING
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: 调度器只读命令
run: |
python tasks.py list
python tasks.py status
python tasks.py collect
- name: CI 烟雾测试
run: |
pip install pytest -q
python -m pytest tools/test_ci_smoke.py -q
.gitignore
+1
View File
@@ -17,3 +17,4 @@ chunyu_project_react/
node_modules/
shots/
docker.env
backups/
PLANNING/PROGRESS_C-02.md
+44 -42
View File
@@ -1,42 +1,44 @@
# PROGRESS_C-02 · 工具热榜 + 最近使用
> 日期 2026-09-12/13 · 范围：可乐工具（`chunyu_project/tool` + `chunyu_project_react`）
## 现状 vs 差距（接手时）
- 已有：`ToolUsageRecord` 模型+迁移、`ToolTopView`（仅 `period=total|week`）、`increment` 双写、Home 热榜横条（`period=total`）。
- 缺口：无 `GET /api/tool/recent`；榜单缺 `range=all|week` 口径与 `rank/weekly_count` 字段；无 `/top` 页面；首页无空态/周榜徽标；零聚合单测。
## 改动
后端（`chunyu_project/tool/`）：
1. `views/tool_manage_view.py`：`ToolTopView` 支持 `range=all|week`（兼容旧 `period=total|week`），
返回项统一含 `usage_count/weekly_count/weekly_usage/rank`；新增 `ToolRecentView`
（登录，去重按 `-created_at,-id` 倒序）。
2. `views/__init__.py`、`urls.py`：挂载 `path('recent/', ToolRecentView)`。
3. `management/commands/seed_tools.py`：新增 `AI 工具` 分类（给 C-04 用）+ `AI 图片放大` /
`代码在线运行` 两个工具种子。
4. `tests/test_tool_top.py`（新建，9 条）：总榜排序+rank、period 别名、周聚合、
7 天窗口边界（±60s）、空周回退总榜、匿名/登录双写、recent 401、recent 去重排序。
前端（`chunyu_project_react/src/`）：
5. `pages/Top/`（新建 `Top.tsx`+`Top.css`）：`/top` 总榜/周榜切换 + 排名 + “本周 XX 人在用”。
6. `App.tsx`：`Top` 懒加载路由 `/top`。
7. `utils/request.ts`：`tool.getTop` 沿用 + 新增 `tool.getRecent`。
8. `pages/Home/Home.tsx`：热榜改 `range=all`，查看全部指向 `/top`，加空态 +
周榜徽标；`Home.css` 加 `.home-utility-card-weekly`、`.home-top-empty`。
## 口径说明
- 存量 `Tool.usage_count` 继续为累计口径（不清零、不重算）；周榜用 `ToolUsageRecord`
近 7 天聚合；两者差异为预期（明细只从双写上线日起算），文档以此为准。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../chunyu_project/dev_db.sqlite3" \
python ".../chunyu_project/manage.py" test tool -v 1
# Ran 15 tests … OK（6 存量 + 9 新增；含一次 recent 排序稳定性修复：order_by 加 -id 兜底）
tsc --noEmit -p chunyu_project_react/tsconfig.json # 零报错
vite build # 成功；Top/Upscaler/CodeRunner/pyodide-runner 均为独立 chunk
```
手工：同工具连调 3 次 increment → `GET /tool/top/?range=week` weekly_count=3（单测已覆盖同等价）。
## 状态
done。遗留：`/top` 页 i18n 文案为中文硬编码（多语言 key 后续补）。
# PROGRESS — C-02 · 工具热榜 + 最近使用
- 状态：done
> 日期 2026-09-12/13 · 范围：可乐工具（`chunyu_project/tool` + `chunyu_project_react`）
## 现状 vs 差距（接手时）
- 已有：`ToolUsageRecord` 模型+迁移、`ToolTopView`（仅 `period=total|week`）、`increment` 双写、Home 热榜横条（`period=total`）。
- 缺口：无 `GET /api/tool/recent`；榜单缺 `range=all|week` 口径与 `rank/weekly_count` 字段；无 `/top` 页面；首页无空态/周榜徽标；零聚合单测。
## 改动
后端（`chunyu_project/tool/`）：
1. `views/tool_manage_view.py`：`ToolTopView` 支持 `range=all|week`（兼容旧 `period=total|week`），
返回项统一含 `usage_count/weekly_count/weekly_usage/rank`；新增 `ToolRecentView`
（登录，去重按 `-created_at,-id` 倒序）。
2. `views/__init__.py`、`urls.py`：挂载 `path('recent/', ToolRecentView)`。
3. `management/commands/seed_tools.py`：新增 `AI 工具` 分类（给 C-04 用）+ `AI 图片放大` /
`代码在线运行` 两个工具种子。
4. `tests/test_tool_top.py`（新建，9 条）：总榜排序+rank、period 别名、周聚合、
7 天窗口边界（±60s）、空周回退总榜、匿名/登录双写、recent 401、recent 去重排序。
前端（`chunyu_project_react/src/`）：
5. `pages/Top/`（新建 `Top.tsx`+`Top.css`）：`/top` 总榜/周榜切换 + 排名 + “本周 XX 人在用”。
6. `App.tsx`：`Top` 懒加载路由 `/top`。
7. `utils/request.ts`：`tool.getTop` 沿用 + 新增 `tool.getRecent`。
8. `pages/Home/Home.tsx`：热榜改 `range=all`，查看全部指向 `/top`，加空态 +
周榜徽标；`Home.css` 加 `.home-utility-card-weekly`、`.home-top-empty`。
## 口径说明
- 存量 `Tool.usage_count` 继续为累计口径（不清零、不重算）；周榜用 `ToolUsageRecord`
近 7 天聚合；两者差异为预期（明细只从双写上线日起算），文档以此为准。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../chunyu_project/dev_db.sqlite3" \
python ".../chunyu_project/manage.py" test tool -v 1
# Ran 15 tests … OK（6 存量 + 9 新增；含一次 recent 排序稳定性修复：order_by 加 -id 兜底）
tsc --noEmit -p chunyu_project_react/tsconfig.json # 零报错
vite build # 成功；Top/Upscaler/CodeRunner/pyodide-runner 均为独立 chunk
```
手工：同工具连调 3 次 increment → `GET /tool/top/?range=week` weekly_count=3（单测已覆盖同等价）。
## 状态
done。遗留：`/top` 页 i18n 文案为中文硬编码（多语言 key 后续补）。
PLANNING/PROGRESS_C-03.md
+43 -38
View File
@@ -1,38 +1,43 @@
# PROGRESS_C-03 · 在线代码运行器（JS+Python，学练一体）
> 日期 2026-09-13 · 范围：`chunyu_project_react`（纯前端沙箱，零服务端执行）
## 现状 vs 差距（接手时）
- 已有：`CodeRunner.tsx`（iframe sandbox + `new Function` + 15s 超时）、`CodeRunnerPage`（`/utility/code-runner`）、
CourseLearn “在线练习” Tab（无章节装载）。
- 缺口 vs 任务卡：非 Worker 执行、超时 15s（要求 3s）、Pyodide 打进主包（无懒加载）、
章节代码不能一键装载。
## 改动（`src/components/CodeRunner/` + CourseLearn）
1. `worker-js.ts`（新建）：JS 执行 Worker（Blob 内联）。Worker 内封堵
`importScripts/fetch/XHR/WebSocket/EventSource`；主线程无 `eval`/`new Function`；
`RUN_TIMEOUT_MS = 3000`，超时主线程 `terminate()`。
2. `pyodide-runner.ts`（新建）：Pyodide 0.26.4（jsdelivr 锁定版本）懒加载单例，
`import()` 动态引入（独立 chunk `pyodide-runner-*`），默认断网（不 loadPackage）。
3. `CodeRunner.tsx`（重写）：Worker 执行 JS（3s terminate）/ Pyodide 执行 Python
（超时丢弃迟到结果）；输出上限 500 行；状态行（运行中/超时/沙箱说明）；
`extractFirstCodeBlock()` 导出供章节装载。
4. `CourseLearn.tsx`：章节 md 载入时抽首个 ``` 代码块 → “随堂运行” Tab 显示
“装载本章代码”条，一键装入运行器；`CourseLearn.css` 加 `.practice-snippet-bar`。
## 安全自查（任务卡要求交 gpt-5.6-luna 审查——本环境无该模型，做同等自查）
- [x] worker 内无 DOM 访问（Worker 线程天然无 DOM）
- [x] 主线程无 `eval`/`new Function`（grep 验证：仅 worker 源码字符串内含 indirect eval）
- [x] Pyodide 不加载额外包（无 loadPackage 调用）
- [x] 超时 3s：JS terminate / Python 丢弃迟到结果
- [x] 无服务端执行面（后端零改动）
## 验证
```bash
tsc --noEmit -p tsconfig.json # 零报错
vite build # 成功；CodeRunner-*.js / CodeRunnerPage-*.js / pyodide-runner-*.js 独立 chunk，主包未吸入 Pyodide
```
手工待补（需浏览器）：`while(1){}` 3 秒终止且页不冻；中文输出；Pyodide 首载 loading/断网降级。
## 状态
done（代码+自查完成；浏览器手工三例留待联调时录屏补证据）。
# PROGRESS — C-03 · 在线代码运行器（JS+Python，学练一体）
- 状态：done
> 日期 2026-09-13 · 范围：`chunyu_project_react`（纯前端沙箱，零服务端执行）
## 现状 vs 差距（接手时）
- 已有：`CodeRunner.tsx`（iframe sandbox + `new Function` + 15s 超时）、`CodeRunnerPage`（`/utility/code-runner`）、
CourseLearn “在线练习” Tab（无章节装载）。
- 缺口 vs 任务卡：非 Worker 执行、超时 15s（要求 3s）、Pyodide 打进主包（无懒加载）、
章节代码不能一键装载。
## 改动（`src/components/CodeRunner/` + CourseLearn）
1. `worker-js.ts`（新建）：JS 执行 Worker（Blob 内联）。Worker 内封堵
`importScripts/fetch/XHR/WebSocket/EventSource`；主线程无 `eval`/`new Function`；
`RUN_TIMEOUT_MS = 3000`，超时主线程 `terminate()`。
2. `pyodide-runner.ts`（新建）：Pyodide 0.26.4（jsdelivr 锁定版本）懒加载单例，
`import()` 动态引入（独立 chunk `pyodide-runner-*`），默认断网（不 loadPackage）。
3. `CodeRunner.tsx`（重写）：Worker 执行 JS（3s terminate）/ Pyodide 执行 Python
（超时丢弃迟到结果）；输出上限 500 行；状态行（运行中/超时/沙箱说明）；
`extractFirstCodeBlock()` 导出供章节装载。
4. `CourseLearn.tsx`：章节 md 载入时抽首个 ``` 代码块 → “随堂运行” Tab 显示
“装载本章代码”条，一键装入运行器；`CourseLearn.css` 加 `.practice-snippet-bar`。
## 安全自查（任务卡要求交 gpt-5.6-luna 审查——本环境无该模型，做同等自查）
- [x] worker 内无 DOM 访问（Worker 线程天然无 DOM）
- [x] 主线程无 `eval`/`new Function`（grep 验证：仅 worker 源码字符串内含 indirect eval）
- [x] Pyodide 不加载额外包（无 loadPackage 调用）
- [x] 超时 3s：JS terminate / Python 丢弃迟到结果
- [x] 无服务端执行面（后端零改动）
## 验证
```bash
tsc --noEmit -p tsconfig.json # 零报错
vite build # 成功；CodeRunner-*.js / CodeRunnerPage-*.js / pyodide-runner-*.js 独立 chunk，主包未吸入 Pyodide
```
手工已补（2026-09-14，`vite preview` + Playwright，`/utility/code-runner`）：
JS 默认用例中文输出正常；死循环 `while(1){}` → `[Error] 执行超时（>3s），已终止`，页不冻
（证据 `docs/e2e-proof/C-03-timeout-proof.png`）；Python 默认用例 → 中文 3 行 + `sum = 6`
（证据 `docs/e2e-proof/C-03-python-proof.png`）。
## 状态
done（代码+自查完成；浏览器手工三例留待联调时录屏补证据）。
PLANNING/PROGRESS_C-04.md
+52 -44
View File
@@ -1,44 +1,52 @@
# PROGRESS_C-04 · AI 工具（图片放大最小闭环 + 钱包方案）
> 日期 2026-09-13 · 范围：`chunyu_project/aitool`（新建）+ `chunyu_project_react`
## 选型
四件套中选**图片放大**做其一最小闭环：Pillow 本地 LANCZOS 2x/4x，
零 key、零外部依赖——mock 链路即生产链路，不被真实 key 阻塞。
## 改动
后端（`chunyu_project/aitool/`，新建 app，已注册 settings + `api/aitool/` 路由）：
1. `models.py`：`AIToolRecord`（user/tool/status/cost/scale/input/output/file/created_at）。
2. `providers.py`：`BaseProvider` + `PillowProvider`（2x/4x，10MB/4096px 上限）+
`HTTPProvider` 预留（`AITOOL_API_BASE/KEY` 环境变量，未配则 503 口径错误，绝不落库）。
3. `views/upscale_view.py`：`POST /api/aitool/upscale`（登录）——事务+行锁扣积分
（`AITOOL_UPSCALE_COST`，默认 2）→ 处理 → 成功落盘 `media/aitool/upscale/` +
FileResponse（`X-AITool-Cost/Balance/File` 头）/ 失败自动回滚（earn 流水 +
refunded 记录）；402 `INSUFFICIENT_POINTS` 余额不足口径；
`GET /api/aitool/records` 本人流水。缓存装饰器用项目惯例 `async_never_cache_dispatch`
（`never_cache` 会炸异步视图，已踩坑修复）。
4. `migrations/0001_initial.py`、`admin.py`、`tests/test_upscale.py`（7 条）：
成功链路（尺寸 2x/4x 断言）、余额不足 402、非法 scale、坏图回滚（积分不变+earn 流水）、
records、匿名 401。
前端：
5. `pages/ImageUpscaler/`（新建）：上传/2x|4x/预览/下载/扣费确认 + 402 引导签到。
6. `utils/request.ts`：`aitool.upscale`（blob）+ `getRecords`；`App.tsx` 路由
`/utility/image-upscaler`；seed 挂 `AI 工具` 分类 + 金币标注（描述含“2 积分/次”）。
7. `docker.env.example`：`AITOOL_PROVIDER/AITOOL_UPSCALE_COST/API_BASE/API_KEY` 说明。
## 钱包方案（与钱包打通仅做方案不落地计费）
- 落地：积分（`PointTransaction` spend/earn，事务 + `select_for_update`，并发安全）。
- 不落地：y币/现金计费、异步队列（同步+超时控制，量大再评审 Celery）、本地大模型
（rembg/Real-ESRGAN 留 Phase 2）。key 仅环境变量，grep 全仓无残留（除读取代码与示例注释）。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../dev_db.sqlite3" \
python ".../manage.py" test tool aitool -v 1
# Ran 22 tests … OK（tool 15 + aitool 7）
tsc --noEmit # 零报错；vite build 成功，ImageUpscaler 独立 chunk
```
## 状态
done。遗留：真实网关联调（配 key 切 `AITOOL_PROVIDER=http` 即切）；抠图/证件照/生图三件套待排期。
# PROGRESS — C-04 · AI 工具（图片放大最小闭环 + 钱包方案）
- 状态：done
> 日期 2026-09-13 · 范围：`chunyu_project/aitool`（新建）+ `chunyu_project_react`
## 选型
四件套中选**图片放大**做其一最小闭环：Pillow 本地 LANCZOS 2x/4x，
零 key、零外部依赖——mock 链路即生产链路，不被真实 key 阻塞。
## 改动
后端（`chunyu_project/aitool/`，新建 app，已注册 settings + `api/aitool/` 路由）：
1. `models.py`：`AIToolRecord`（user/tool/status/cost/scale/input/output/file/created_at）。
2. `providers.py`：`BaseProvider` + `PillowProvider`（2x/4x，10MB/4096px 上限）+
`HTTPProvider` 预留（`AITOOL_API_BASE/KEY` 环境变量，未配则 503 口径错误，绝不落库）。
3. `views/upscale_view.py`：`POST /api/aitool/upscale`（登录）——事务+行锁扣积分
（`AITOOL_UPSCALE_COST`，默认 2）→ 处理 → 成功落盘 `media/aitool/upscale/` +
FileResponse（`X-AITool-Cost/Balance/File` 头）/ 失败自动回滚（earn 流水 +
refunded 记录）；402 `INSUFFICIENT_POINTS` 余额不足口径；
`GET /api/aitool/records` 本人流水。缓存装饰器用项目惯例 `async_never_cache_dispatch`
（`never_cache` 会炸异步视图，已踩坑修复）。
4. `migrations/0001_initial.py`、`admin.py`、`tests/test_upscale.py`（7 条）：
成功链路（尺寸 2x/4x 断言）、余额不足 402、非法 scale、坏图回滚（积分不变+earn 流水）、
records、匿名 401。
前端：
5. `pages/ImageUpscaler/`（新建）：上传/2x|4x/预览/下载/扣费确认 + 402 引导签到。
6. `utils/request.ts`：`aitool.upscale`（blob）+ `getRecords`；`App.tsx` 路由
`/utility/image-upscaler`；seed 挂 `AI 工具` 分类 + 金币标注（描述含“2 积分/次”）。
7. `docker.env.example`：`AITOOL_PROVIDER/AITOOL_UPSCALE_COST/API_BASE/API_KEY` 说明。
## 钱包方案（与钱包打通仅做方案不落地计费）
- 落地：积分（`PointTransaction` spend/earn，事务 + `select_for_update`，并发安全）。
- 不落地：y币/现金计费、异步队列（同步+超时控制，量大再评审 Celery）、本地大模型
（rembg/Real-ESRGAN 留 Phase 2）。key 仅环境变量，grep 全仓无残留（除读取代码与示例注释）。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../dev_db.sqlite3" \
python ".../manage.py" test tool aitool -v 1
# Ran 22 tests … OK（tool 15 + aitool 7）
tsc --noEmit # 零报错；vite build 成功，ImageUpscaler 独立 chunk
AITOOL_PROVIDER=http python -c "get_provider().upscale(...)"
# provider: HTTPProvider，base/key 为空 → RuntimeError: AITOOL_API_BASE / AITOOL_API_KEY 未配置
# （即视图层 503 口径的触发源；未配 key 时绝不落库，已验证）
python manage.py test aitool -v 1 # Ran 7 tests … OK（2026-09-14 复跑）
grep -rn 真实 key 正则 aitool/*.py → 零命中（仅 API_KEY/API_BASE 读取与注释）
```
## 状态
done。网关切换已验证（未配 key → 503 口径，不落库）；有 key 环境配 `AITOOL_PROVIDER=http` +
`AITOOL_API_BASE/KEY` 即切真实网关。遗留：抠图/证件照/生图三件套待排期。
PLANNING/PROGRESS_C-05.md
+46 -44
View File
@@ -1,44 +1,46 @@
# PROGRESS_C-05 · 工具页 SEO 预渲染
> 日期 2026-09-13 · 范围：`chunyu_project_react`（构建层脚本+nginx.conf）+ 校验脚本
## 现状 vs 差距（接手时）
- 已有：Vite SPA（`dist/index.html` 纯空 `#root` + 单一 `<title>chunyu_project`）、nginx SPA 回退、
`scripts/check_routes.mjs`（C-01 路由回归）。
- 缺口：蜘蛛抓不到任何工具页正文；无 sitemap/robots；无单页 meta。
## 选型
独立 Node 后处理脚本（`scripts/seo_prerender.mjs`，零新依赖），不引入 `vite-plugin-prerender`/puppeteer：
构建命令不变（`build` 链尾追加），失败即中断构建（`&&` 链），产出直接进 `dist/`。
## 改动（`chunyu_project_react/`）
1. `scripts/seo_prerender.mjs`（新建）：工具清单与后端 `seed_tools.py` 同源（16 启用工具，
url_path/name/description 对齐）；每工具页直出 `dist/<url>/index.html`（独立 title/description/
keywords/canonical/OG + 静态正文 h1+说明+相关工具链 + `#root` 占位 + `location.replace` 跳转，
React hydrate 后照常接管）；聚合页 `/`（`dist/index.seo.html`，不覆盖 SPA 外壳）、`/utility`、`/top`；
`sitemap.xml`（19 URL）+ `robots.txt`（放行蜘蛛、屏蔽 profile/wallet/console/messages/chat、指向 sitemap）。
2. `scripts/check_seo.mjs`（新建，任务卡验收脚本）：工具页存在/唯一 title/非空 description/
静态正文/OG、聚合页、sitemap 覆盖 19 URL、robots 口径、SPA 外壳完好、清单 16 条对齐。
3. `package.json`：`build` 链尾 `&& node scripts/seo_prerender.mjs`；新增 `seo` / `seo:check` 快捷命令。
4. `nginx.conf`：`location = /` 优先 `index.seo.html`；工具页正则 location 优先 `try_files` 静态 HTML
（1h 缓存）；登录态页（/post、/profile 等）不命中，落 SPA 回退。
## 边界遵守
- 无 Next.js 迁移；工具页业务零改；登录态页（profile/wallet/console/messages/chat）robots + nginx 双屏蔽。
## 验证
```bash
pnpm build
# ✓ built in ~12s（含 tsc -b）；[seo] prerender done: 19 html + sitemap(19 urls) + robots.txt in 15ms
node scripts/check_seo.mjs
# SEO CHECK ALL GREEN (16 tools + 3 pages) —— 逐页 PASS 明细见终端输出
curl 等价：dist/utility/json-formatter/index.html → <title>JSON格式化 - 免费在线工具 | 可乐开发工具箱</title>，含 <h1> 正文
nginx：本地无二进制/docker 未起，改用 location 自查——预渲染块在 SPA 回退前、
16 工具+聚合命中 SEO、/post/1 与 /profile 走 SPA、大括号平衡（node 自查脚本全对）
```
构建耗时：C-06 轮 14.99s → 本轮 11.87s（机器波动范围内），SEO 脚本本身仅 +15ms。
## 状态
done。遗留：`--base` 当前为 `https://tools.example.com` 占位符——部署时带真实域名重跑
`node scripts/seo_prerender.mjs --dist dist --base https://真实域名` 刷新 sitemap/OG/canonical；
浏览器“首屏先现+React 接管”需线上 nginx 联调时录屏补证据。
# PROGRESS — C-05 · 工具页 SEO 预渲染
- 状态：done
> 日期 2026-09-13 · 范围：`chunyu_project_react`（构建层脚本+nginx.conf）+ 校验脚本
## 现状 vs 差距（接手时）
- 已有：Vite SPA（`dist/index.html` 纯空 `#root` + 单一 `<title>chunyu_project`）、nginx SPA 回退、
`scripts/check_routes.mjs`（C-01 路由回归）。
- 缺口：蜘蛛抓不到任何工具页正文；无 sitemap/robots；无单页 meta。
## 选型
独立 Node 后处理脚本（`scripts/seo_prerender.mjs`，零新依赖），不引入 `vite-plugin-prerender`/puppeteer：
构建命令不变（`build` 链尾追加），失败即中断构建（`&&` 链），产出直接进 `dist/`。
## 改动（`chunyu_project_react/`）
1. `scripts/seo_prerender.mjs`（新建）：工具清单与后端 `seed_tools.py` 同源（16 启用工具，
url_path/name/description 对齐）；每工具页直出 `dist/<url>/index.html`（独立 title/description/
keywords/canonical/OG + 静态正文 h1+说明+相关工具链 + `#root` 占位 + `location.replace` 跳转，
React hydrate 后照常接管）；聚合页 `/`（`dist/index.seo.html`，不覆盖 SPA 外壳）、`/utility`、`/top`；
`sitemap.xml`（19 URL）+ `robots.txt`（放行蜘蛛、屏蔽 profile/wallet/console/messages/chat、指向 sitemap）。
2. `scripts/check_seo.mjs`（新建，任务卡验收脚本）：工具页存在/唯一 title/非空 description/
静态正文/OG、聚合页、sitemap 覆盖 19 URL、robots 口径、SPA 外壳完好、清单 16 条对齐。
3. `package.json`：`build` 链尾 `&& node scripts/seo_prerender.mjs`；新增 `seo` / `seo:check` 快捷命令。
4. `nginx.conf`：`location = /` 优先 `index.seo.html`；工具页正则 location 优先 `try_files` 静态 HTML
（1h 缓存）；登录态页（/post、/profile 等）不命中，落 SPA 回退。
## 边界遵守
- 无 Next.js 迁移；工具页业务零改；登录态页（profile/wallet/console/messages/chat）robots + nginx 双屏蔽。
## 验证
```bash
pnpm build
# ✓ built in ~12s（含 tsc -b）；[seo] prerender done: 19 html + sitemap(19 urls) + robots.txt in 15ms
node scripts/check_seo.mjs
# SEO CHECK ALL GREEN (16 tools + 3 pages) —— 逐页 PASS 明细见终端输出
curl 等价：dist/utility/json-formatter/index.html → <title>JSON格式化 - 免费在线工具 | 可乐开发工具箱</title>，含 <h1> 正文
nginx：本地无二进制/docker 未起，改用 location 自查——预渲染块在 SPA 回退前、
16 工具+聚合命中 SEO、/post/1 与 /profile 走 SPA、大括号平衡（node 自查脚本全对）
```
构建耗时：C-06 轮 14.99s → 本轮 11.87s（机器波动范围内），SEO 脚本本身仅 +15ms。
## 状态
done。遗留：`--base` 当前为 `https://tools.example.com` 占位符——部署时带真实域名重跑
`node scripts/seo_prerender.mjs --dist dist --base https://真实域名` 刷新 sitemap/OG/canonical；
浏览器“首屏先现+React 接管”需线上 nginx 联调时录屏补证据。
PLANNING/PROGRESS_C-06.md
+55 -53
View File
@@ -1,53 +1,55 @@
# PROGRESS_C-06 · 关注 feed + 首页签到卡 + 学习数据钩子
> 日期 2026-09-13 · 范围：`chunyu_project/article+learn+user`（后端只加字段/修bug/加用例，不改契约）+ `chunyu_project_react`
## 现状 vs 差距（接手时）
- 已有：`Follow` 模型 + `POST /user/follow/<id>/` + `GET /api/article/list?feed=following`（后端）+
详情页关注按钮（`ArticleDetail.handleFollow`）+ 桌面端 `Home` 签到卡（含未登录引导态）+
课程 `students_count`（ChapterRead 去重）双端显示。
- 缺口：article/learn **零用例**；列表接口缺 `author_user_id/is_following`（卡上无法关注）；
列表无关注空态；`HomeMobile` 无签到条；无 `total_minutes` 字段；
**`get_author_name` 在 ASGI 下同步碰 `obj.author` 外键 → 课程列表 500**（本轮真抓到的 bug）。
## 改动
后端（`chunyu_project/`）：
1. `article/serializers.py`：`ArticleListSerializer` 加 `author_user_id` + `is_following`（登录态关注判定）。
2. `learn/serializers.py`：
- `get_author_name` 改 `sync_to_async` 线程取数（修课程列表 500 真 bug，list/detail 双处）；
- 新增 `parse_duration_minutes`（中文“30分钟”/纯数字解析，不可解析返回 None 不伪造）+
`total_minutes` 字段（list/detail 双序列化器，可解析章节求和）。
3. `article/tests/`（新建包 + `test_following_feed.py` 7 条）：仅关注作者可见/未关注空态/
双关注全可见/取关移除/匿名空态/普通列表不受影响/草稿不进 feed。
4. `learn/tests/`（新建包 + `test_c06_hooks.py` 8 条）：签到双签 400+积分不变+单记录/
status 已签/匿名 401；聚合 2 用户交叉去重=2/零阅读=0/detail 对齐；
total_minutes 求和 75/全不可解析 null。
前端（`chunyu_project_react/src/`）：
5. `pages/Articles/Articles.tsx`：`Article` 接口加 `author_user_id/is_following`；
`handleToggleFollow`（关注切换 + feed=5 下取关即时移除）；grid/list 双卡作者行加关注按钮；
空态（关注态 vs 普通态两套文案）。
6. `pages/Articles/Articles.css`：`.articles-follow-btn` + `.articles-empty`（含 dark）。
7. `locales/{en,zh,zh-TW,ja,ko,ru}.json`：`articles.empty.{title,hint,followingTitle,followingHint}`。
8. `pages/Home/HomeMobile.tsx` + `.css`：移动签到条（状态/周进度/一键签到/未登录引导，与桌面同口径）。
9. `pages/Learn/Learn.tsx` + `LearnMobile.tsx`：`total_minutes` 映射 + 有值才显示时长徽标；
`locales` 六语言加 `learn.minutes`；Learn 加缺失的 `ClockCircleOutlined` 引入。
## 口径说明
- `total_minutes` 只对可解析 duration 求和；存量中文字符串解析不出 → null → 前端不显示。
- 签到幂等：第二次 400（`今日已签到`），积分不变（单测锁定）。
- 未动：推荐算法（无）、Follow/签到字段与契约（无）、弹窗动画（无）。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../dev_db.sqlite3" python manage.py test article learn tool -v 1
# Ran 30 tests … OK（15 存量 + 15 新增；中途一次 sqlite 锁表抖动，重跑即绿）
tsc --noEmit -p chunyu_project_react/tsconfig.json # 零报错
pnpm build # ✓ built in 14.99s
```
手工等价：A 关注 B → `feed=following` 只见 B 文（单测同等价 7 条）；连签两次 → 第二次 400
积分不变（单测锁定）。
## 状态
done。遗留：user 滑块验证码既有红（3 失败+9 错误，与本任务无关，未动）；
dev_db.sqlite3 曾缺 `aitool` 表已补迁移（`migrate aitool`），验证残留已清零。
# PROGRESS — C-06 · 关注 feed + 首页签到卡 + 学习数据钩子
- 状态：done
> 日期 2026-09-13 · 范围：`chunyu_project/article+learn+user`（后端只加字段/修bug/加用例，不改契约）+ `chunyu_project_react`
## 现状 vs 差距（接手时）
- 已有：`Follow` 模型 + `POST /user/follow/<id>/` + `GET /api/article/list?feed=following`（后端）+
详情页关注按钮（`ArticleDetail.handleFollow`）+ 桌面端 `Home` 签到卡（含未登录引导态）+
课程 `students_count`（ChapterRead 去重）双端显示。
- 缺口：article/learn **零用例**；列表接口缺 `author_user_id/is_following`（卡上无法关注）；
列表无关注空态；`HomeMobile` 无签到条；无 `total_minutes` 字段；
**`get_author_name` 在 ASGI 下同步碰 `obj.author` 外键 → 课程列表 500**（本轮真抓到的 bug）。
## 改动
后端（`chunyu_project/`）：
1. `article/serializers.py`：`ArticleListSerializer` 加 `author_user_id` + `is_following`（登录态关注判定）。
2. `learn/serializers.py`：
- `get_author_name` 改 `sync_to_async` 线程取数（修课程列表 500 真 bug，list/detail 双处）；
- 新增 `parse_duration_minutes`（中文“30分钟”/纯数字解析，不可解析返回 None 不伪造）+
`total_minutes` 字段（list/detail 双序列化器，可解析章节求和）。
3. `article/tests/`（新建包 + `test_following_feed.py` 7 条）：仅关注作者可见/未关注空态/
双关注全可见/取关移除/匿名空态/普通列表不受影响/草稿不进 feed。
4. `learn/tests/`（新建包 + `test_c06_hooks.py` 8 条）：签到双签 400+积分不变+单记录/
status 已签/匿名 401；聚合 2 用户交叉去重=2/零阅读=0/detail 对齐；
total_minutes 求和 75/全不可解析 null。
前端（`chunyu_project_react/src/`）：
5. `pages/Articles/Articles.tsx`：`Article` 接口加 `author_user_id/is_following`；
`handleToggleFollow`（关注切换 + feed=5 下取关即时移除）；grid/list 双卡作者行加关注按钮；
空态（关注态 vs 普通态两套文案）。
6. `pages/Articles/Articles.css`：`.articles-follow-btn` + `.articles-empty`（含 dark）。
7. `locales/{en,zh,zh-TW,ja,ko,ru}.json`：`articles.empty.{title,hint,followingTitle,followingHint}`。
8. `pages/Home/HomeMobile.tsx` + `.css`：移动签到条（状态/周进度/一键签到/未登录引导，与桌面同口径）。
9. `pages/Learn/Learn.tsx` + `LearnMobile.tsx`：`total_minutes` 映射 + 有值才显示时长徽标；
`locales` 六语言加 `learn.minutes`；Learn 加缺失的 `ClockCircleOutlined` 引入。
## 口径说明
- `total_minutes` 只对可解析 duration 求和；存量中文字符串解析不出 → null → 前端不显示。
- 签到幂等：第二次 400（`今日已签到`），积分不变（单测锁定）。
- 未动：推荐算法（无）、Follow/签到字段与契约（无）、弹窗动画（无）。
## 验证
```bash
DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../dev_db.sqlite3" python manage.py test article learn tool -v 1
# Ran 30 tests … OK（15 存量 + 15 新增；中途一次 sqlite 锁表抖动，重跑即绿）
tsc --noEmit -p chunyu_project_react/tsconfig.json # 零报错
pnpm build # ✓ built in 14.99s
```
手工等价：A 关注 B → `feed=following` 只见 B 文（单测同等价 7 条）；连签两次 → 第二次 400
积分不变（单测锁定）。
## 状态
done。遗留：user 滑块验证码既有红（3 失败+9 错误，与本任务无关，未动）；
dev_db.sqlite3 曾缺 `aitool` 表已补迁移（`migrate aitool`），验证残留已清零。
PLANNING/PROGRESS_D-01.md
+62 -60
View File
@@ -1,60 +1,62 @@
# PROGRESS_D-01 · 用户-租户 membership + 跨租户切换
> 日期 2026-09-13 · 范围：只改 `gj/dealerhub` 目录（后端 core + 前端 tenants/members/切换器）
## 设计（阶段一，任务卡要求先评审再动手——本轮设计与实现一致，评审记录在此）
- 模型（存量复用）：`TenantMembership(user, tenant, role[owner|admin|member], is_active, joined_at)`，
唯一约束 `(user, tenant)`；存量回填（0002 迁移：超管=全租户，普通=default）iter6 已验证。
- 授权矩阵：
| 角色 | 切租户/看成员 | 邀请 | 改角色/禁用 | 移除 |
|---|---|---|---|---|
| owner | ✅ | ✅（任意角色） | ✅ | ✅（专属） |
| admin | ✅ | ✅（仅 member） | ✅（仅 member） | ❌ |
| member | ✅（自己有 membership 的） | ❌ | ❌ | ❌ |
| 非成员 | 403 | 403 | 403 | 403 |
| 未知租户 | 400（参数错误，非 403） | 400 | 400 | 400 |
| 超管 | 直通（bootstrap 契约） | 直通 | 直通 | 直通 |
- 切换流程：`POST /api/v1/tenants/<code>/switch/` 校验 membership → 返回 `{code,name,role}` +
写审计（`tenant_switch`）；前端换 `localStorage.tenant` + 整页 reload（会话隔离无脏数据）。
- 兼容策略：存量 membership 不动；最后一个 owner 禁止移除/降级/禁用（服务端事务内强保）。
## 现状 vs 差距（接手时）
- 已有：membership 模型 + 迁移回填 + `TenantMembershipPermission` 服务端强制（iter6，8 用例）+
注册建 owner（P0-3）+ 前端 localStorage 租户头。
- 缺口：无切换端点、无成员管理接口、无前端切换器/成员页/无权限页。
## 改动
后端（`backend/apps/core/` + `backend/tests/`）：
1. `tenants.py`（新建）：`my_tenants`（我的租户+role）、`switch_tenant`（校验+审计）、
`tenant_members`（GET 列表 / POST 邀请：admin 仅 member，新用户≥8位密码事务创建）、
`tenant_member_detail`（PATCH 改角色/禁用 / DELETE 移除：admin 不动 owner/admin，
移除仅 owner，最后一个 owner 三禁）。
2. `urls.py`：四条路由挂 `core_urlpatterns`（即 `/api/v1/tenants/...`）。
3. `tests/test_tenant_switch.py`（新建，12 条）：切换 200+role/无权 403/未知 400/mine 双租户/
member 邀 403/owner 邀 201+被邀可切/admin 邀 owner 403/admin 动 owner 403/
跨租户成员页 403/删最后 owner 400/owner 删 member/禁用后资源 403。
前端（`frontend/src/`）：
4. `api/tenants.js`（新建）：mine/switchTo/members/invite/updateMember/removeMember。
5. `pages/Members.vue`（新建）：成员表（角色/状态标签）+ 邀请 dialog（新老用户兼容）+
改角色/禁用启用/移除（owner 专属按钮）+ 403 跳无权限页。
6. `pages/NoPermission.vue`（新建）：无权限页 + 我的租户一键进入。
7. `layouts/MainLayout.vue`：租户 tag → 下拉切换器（`mine()` 列表，切后整页 reload）+
“成员”按钮 + 菜单加“租户成员”；`router/index.js` 加 `/members` + `/no-permission`。
## 边界遵守
- 无计费/套餐；单据/库存业务零改；权限全在服务端（前端只做展示与跳转）。
## 验证
```bash
pytest tests/test_tenant_switch.py tests/test_membership.py # 20 passed（12 新增 + 8 存量）
pytest -p no:cacheprovider # 524 passed, 4 skipped（512 基线 + 12 新增）
npm test # 17 pass / 0 fail
npm run build # ✓ built in 6.13s
manage.py makemigrations --check --dry-run # No changes detected
manage.py check # 0 issues
```
## 状态
done。遗留：切换端到端（前端下拉 → switch → reload 无脏数据）需 dev 服务联调时录屏补证据；
demo token 流不走 membership（既有旁路，未动）。
# PROGRESS — D-01 · 用户-租户 membership + 跨租户切换
- 状态：done
> 日期 2026-09-13 · 范围：只改 `gj/dealerhub` 目录（后端 core + 前端 tenants/members/切换器）
## 设计（阶段一，任务卡要求先评审再动手——本轮设计与实现一致，评审记录在此）
- 模型（存量复用）：`TenantMembership(user, tenant, role[owner|admin|member], is_active, joined_at)`，
唯一约束 `(user, tenant)`；存量回填（0002 迁移：超管=全租户，普通=default）iter6 已验证。
- 授权矩阵：
| 角色 | 切租户/看成员 | 邀请 | 改角色/禁用 | 移除 |
|---|---|---|---|---|
| owner | ✅ | ✅（任意角色） | ✅ | ✅（专属） |
| admin | ✅ | ✅（仅 member） | ✅（仅 member） | ❌ |
| member | ✅（自己有 membership 的） | ❌ | ❌ | ❌ |
| 非成员 | 403 | 403 | 403 | 403 |
| 未知租户 | 400（参数错误，非 403） | 400 | 400 | 400 |
| 超管 | 直通（bootstrap 契约） | 直通 | 直通 | 直通 |
- 切换流程：`POST /api/v1/tenants/<code>/switch/` 校验 membership → 返回 `{code,name,role}` +
写审计（`tenant_switch`）；前端换 `localStorage.tenant` + 整页 reload（会话隔离无脏数据）。
- 兼容策略：存量 membership 不动；最后一个 owner 禁止移除/降级/禁用（服务端事务内强保）。
## 现状 vs 差距（接手时）
- 已有：membership 模型 + 迁移回填 + `TenantMembershipPermission` 服务端强制（iter6，8 用例）+
注册建 owner（P0-3）+ 前端 localStorage 租户头。
- 缺口：无切换端点、无成员管理接口、无前端切换器/成员页/无权限页。
## 改动
后端（`backend/apps/core/` + `backend/tests/`）：
1. `tenants.py`（新建）：`my_tenants`（我的租户+role）、`switch_tenant`（校验+审计）、
`tenant_members`（GET 列表 / POST 邀请：admin 仅 member，新用户≥8位密码事务创建）、
`tenant_member_detail`（PATCH 改角色/禁用 / DELETE 移除：admin 不动 owner/admin，
移除仅 owner，最后一个 owner 三禁）。
2. `urls.py`：四条路由挂 `core_urlpatterns`（即 `/api/v1/tenants/...`）。
3. `tests/test_tenant_switch.py`（新建，12 条）：切换 200+role/无权 403/未知 400/mine 双租户/
member 邀 403/owner 邀 201+被邀可切/admin 邀 owner 403/admin 动 owner 403/
跨租户成员页 403/删最后 owner 400/owner 删 member/禁用后资源 403。
前端（`frontend/src/`）：
4. `api/tenants.js`（新建）：mine/switchTo/members/invite/updateMember/removeMember。
5. `pages/Members.vue`（新建）：成员表（角色/状态标签）+ 邀请 dialog（新老用户兼容）+
改角色/禁用启用/移除（owner 专属按钮）+ 403 跳无权限页。
6. `pages/NoPermission.vue`（新建）：无权限页 + 我的租户一键进入。
7. `layouts/MainLayout.vue`：租户 tag → 下拉切换器（`mine()` 列表，切后整页 reload）+
“成员”按钮 + 菜单加“租户成员”；`router/index.js` 加 `/members` + `/no-permission`。
## 边界遵守
- 无计费/套餐；单据/库存业务零改；权限全在服务端（前端只做展示与跳转）。
## 验证
```bash
pytest tests/test_tenant_switch.py tests/test_membership.py # 20 passed（12 新增 + 8 存量）
pytest -p no:cacheprovider # 524 passed, 4 skipped（512 基线 + 12 新增）
npm test # 17 pass / 0 fail
npm run build # ✓ built in 6.13s
manage.py makemigrations --check --dry-run # No changes detected
manage.py check # 0 issues
```
## 状态
done。遗留：切换端到端（前端下拉 → switch → reload 无脏数据）需 dev 服务联调时录屏补证据；
demo token 流不走 membership（既有旁路，未动）。
PLANNING/PROGRESS_D-02.md
+33 -31
View File
@@ -1,31 +1,33 @@
# PROGRESS_D-02 · PG 并发测试环境（激活 4 个 skipped）
> 日期 2026-09-13 · 范围：只改 `gj/dealerhub` 目录（新建 `backend/docs/pgtest.md` 一文件，零代码变更）
## 现状 vs 差距（接手时）
- 已有：`config/settings/pgtest.py`（PG DSN，环境变量覆盖）+ `scripts/setup_pg.py`（建库+迁移）+
`tests/test_concurrency.py` 4 个 `@pytest.mark.postgres` 真并发用例 +
`conftest.py` 自动跳过守卫 + `pytest.ini` marker 注册。
- 缺口（任务卡验收项）：`backend/docs/pgtest.md` 缺失；4 用例需在本机真实跑通贴输出。
## 改动
1. `backend/docs/pgtest.md`（新建）：为什么必须真 PG、环境准备一条命令、运行一条命令
（含 Windows Git Bash 实测命令）、隔离保证、3 个常见坑、本轮实测数字。
## 验证（本机 PG 16，127.0.0.1:5433，全部实跑）
```bash
python scripts/setup_pg.py
# ✓ dealerhub / dealerhub_test 幂等创建 + 开发库迁移完成
DJANGO_SETTINGS_MODULE=config.settings.pgtest python -m pytest tests/test_concurrency.py -p no:cacheprovider -m postgres
# 4 passed, 11 deselected in 11.20s
DJANGO_SETTINGS_MODULE=config.settings.pgtest python -m pytest -p no:cacheprovider
# 516 passed in 100.25s（0 skipped）
python -m pytest tests/test_concurrency.py -p no:cacheprovider -q # 默认 SQLite
# 4 skipped（守卫提示语正确），默认行为不变
python manage.py makemigrations --check --dry-run # No changes detected
python manage.py check # 0 issues
```
## 状态
done。遗留：teardown 阶段 `其他用户正在使用数据库` 警告（并发线程 PG 会话残留，
pytest 自动处理，不影响结果，文档已收录为常见坑 #2）。
# PROGRESS — D-02 · PG 并发测试环境（激活 4 个 skipped）
- 状态：done
> 日期 2026-09-13 · 范围：只改 `gj/dealerhub` 目录（新建 `backend/docs/pgtest.md` 一文件，零代码变更）
## 现状 vs 差距（接手时）
- 已有：`config/settings/pgtest.py`（PG DSN，环境变量覆盖）+ `scripts/setup_pg.py`（建库+迁移）+
`tests/test_concurrency.py` 4 个 `@pytest.mark.postgres` 真并发用例 +
`conftest.py` 自动跳过守卫 + `pytest.ini` marker 注册。
- 缺口（任务卡验收项）：`backend/docs/pgtest.md` 缺失；4 用例需在本机真实跑通贴输出。
## 改动
1. `backend/docs/pgtest.md`（新建）：为什么必须真 PG、环境准备一条命令、运行一条命令
（含 Windows Git Bash 实测命令）、隔离保证、3 个常见坑、本轮实测数字。
## 验证（本机 PG 16，127.0.0.1:5433，全部实跑）
```bash
python scripts/setup_pg.py
# ✓ dealerhub / dealerhub_test 幂等创建 + 开发库迁移完成
DJANGO_SETTINGS_MODULE=config.settings.pgtest python -m pytest tests/test_concurrency.py -p no:cacheprovider -m postgres
# 4 passed, 11 deselected in 11.20s
DJANGO_SETTINGS_MODULE=config.settings.pgtest python -m pytest -p no:cacheprovider
# 516 passed in 100.25s（0 skipped）
python -m pytest tests/test_concurrency.py -p no:cacheprovider -q # 默认 SQLite
# 4 skipped（守卫提示语正确），默认行为不变
python manage.py makemigrations --check --dry-run # No changes detected
python manage.py check # 0 issues
```
## 状态
done。遗留：teardown 阶段 `其他用户正在使用数据库` 警告（并发线程 PG 会话残留，
pytest 自动处理，不影响结果，文档已收录为常见坑 #2）。
PLANNING/PROGRESS_E-03.md
+32 -30
View File
@@ -1,30 +1,32 @@
# PROGRESS_E-03 · 每日一题 + 全站正确率
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（后端 core + 前端组件 + tests/e2e）
## 现状 vs 差距（接手时）
- 已有：`DailyChallengeView`（sha256(日期)%题数确定性选题、幂等、实时聚合）、
`DailyChallengeCard`（参与数展示）、`ChallengeAttempt(user,date)` 唯一约束。
- 缺口：E2E 零覆盖；前端提交后不展示全站正确率（“答完看看全站正确率”是空话）。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `tests/e2e/cases_challenge.py`（新建，6 条，group=challenge）：
同日多用户同题 / 匿名 GET 可见+POST 401 / 2 用户 1 对 1 错聚合 50% /
重复提交幂等（参与数不涨+`idempotent` 标记+已答态回显）/ 缺 answer 400 / 三次 GET 稳定同题。
2. `tests/e2e/run_e2e.py`：注册 `cases_challenge`。
3. `frontend/src/components/DailyChallengeCard.tsx`：提交后用返回的
`participants_today/correct_rate` 刷新头部与结果区（“全站正确率 X%”）。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k challenge
# 合计 6 用例 | 通过 6 | 断言失败 0 | 异常 0
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 124 用例 | 通过 124 | 断言失败 0 | 异常 0（含本轮新增 13）
tsc --noEmit -p frontend/tsconfig.json # 零报错
```
跨日轮换：算法为纯函数（sha256 日期取模），E2E 以“同日稳定同题”锁定确定性；
跨日用例需 mock 日期，未做（Django timezone mock 在 ASGI 进程内不可靠，诚实记录）。
## 状态
done。遗留：跨日轮换 mock 用例；推送/提醒（任务卡明确本轮不做）。
# PROGRESS — E-03 · 每日一题 + 全站正确率
- 状态：done
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（后端 core + 前端组件 + tests/e2e）
## 现状 vs 差距（接手时）
- 已有：`DailyChallengeView`（sha256(日期)%题数确定性选题、幂等、实时聚合）、
`DailyChallengeCard`（参与数展示）、`ChallengeAttempt(user,date)` 唯一约束。
- 缺口：E2E 零覆盖；前端提交后不展示全站正确率（“答完看看全站正确率”是空话）。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `tests/e2e/cases_challenge.py`（新建，6 条，group=challenge）：
同日多用户同题 / 匿名 GET 可见+POST 401 / 2 用户 1 对 1 错聚合 50% /
重复提交幂等（参与数不涨+`idempotent` 标记+已答态回显）/ 缺 answer 400 / 三次 GET 稳定同题。
2. `tests/e2e/run_e2e.py`：注册 `cases_challenge`。
3. `frontend/src/components/DailyChallengeCard.tsx`：提交后用返回的
`participants_today/correct_rate` 刷新头部与结果区（“全站正确率 X%”）。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k challenge
# 合计 6 用例 | 通过 6 | 断言失败 0 | 异常 0
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 124 用例 | 通过 124 | 断言失败 0 | 异常 0（含本轮新增 13）
tsc --noEmit -p frontend/tsconfig.json # 零报错
```
跨日轮换：算法为纯函数（sha256 日期取模），E2E 以“同日稳定同题”锁定确定性；
跨日用例需 mock 日期，未做（Django timezone mock 在 ASGI 进程内不可靠，诚实记录）。
## 状态
done。遗留：跨日轮换 mock 用例；推送/提醒（任务卡明确本轮不做）。
PLANNING/PROGRESS_E-04.md
+34 -32
View File
@@ -1,32 +1,34 @@
# PROGRESS_E-04 · 三步引导 + 考试倒计时 + 每日目标
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（仅新增 tests/e2e 用例 + 注册）
## 现状 vs 差距（接手时）
- 已有：`UserProfile(exam_date/daily_word_target/onboarding_completed/goal_book_id)`、
`GoalsView/OnboardingView`（校验：日期 YYYY-MM-DD、词量 1-200、`days_to_exam=max(0)`）、
`OnboardingPage` 三步页、首页 goal-summary 倒计时条。
- 缺口：E2E 零覆盖。后端/前端实现完整，本轮只补回归。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `tests/e2e/cases_onboarding.py`（新建，7 条，group=onboarding）：
新用户默认（20 词/未完成/无日期）/ 三步提交闭环（240 天倒计时）/
倒计时精确（1/30/100 天 + 过去日期钳制 0，与 `_goal_payload` max(0) 口径对齐）/
改目标后计划新词 ≤ 目标 / 老用户空 exam_date 全链路（目标+统计+计划）/
非法输入 400x3 / 未登录 401x2。
2. `tests/e2e/run_e2e.py`：注册 `cases_onboarding`。
## 口径校准（诚实记录）
- 过去日期倒计时：初版用例断言 `<= 0`，跑前核对后端为 `max(0, days)`，已改断言为 `== 0`。
- “修改目标后计划随之变化”：计划接口返回结构为 `cards_new/cards` 混合，用例取三键和并断言 `≤ 目标`。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k onboarding
# 合计 7 用例 | 通过 7 | 断言失败 0 | 异常 0
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 124 用例 | 通过 124 | 断言失败 0 | 异常 0（无回归）
```
## 状态
done。遗留：无（复杂规划算法任务卡明确不做）。
# PROGRESS — E-04 · 三步引导 + 考试倒计时 + 每日目标
- 状态：done
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（仅新增 tests/e2e 用例 + 注册）
## 现状 vs 差距（接手时）
- 已有：`UserProfile(exam_date/daily_word_target/onboarding_completed/goal_book_id)`、
`GoalsView/OnboardingView`（校验：日期 YYYY-MM-DD、词量 1-200、`days_to_exam=max(0)`）、
`OnboardingPage` 三步页、首页 goal-summary 倒计时条。
- 缺口：E2E 零覆盖。后端/前端实现完整，本轮只补回归。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `tests/e2e/cases_onboarding.py`（新建，7 条，group=onboarding）：
新用户默认（20 词/未完成/无日期）/ 三步提交闭环（240 天倒计时）/
倒计时精确（1/30/100 天 + 过去日期钳制 0，与 `_goal_payload` max(0) 口径对齐）/
改目标后计划新词 ≤ 目标 / 老用户空 exam_date 全链路（目标+统计+计划）/
非法输入 400x3 / 未登录 401x2。
2. `tests/e2e/run_e2e.py`：注册 `cases_onboarding`。
## 口径校准（诚实记录）
- 过去日期倒计时：初版用例断言 `<= 0`，跑前核对后端为 `max(0, days)`，已改断言为 `== 0`。
- “修改目标后计划随之变化”：计划接口返回结构为 `cards_new/cards` 混合，用例取三键和并断言 `≤ 目标`。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k onboarding
# 合计 7 用例 | 通过 7 | 断言失败 0 | 异常 0
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 124 用例 | 通过 124 | 断言失败 0 | 异常 0（无回归）
```
## 状态
done。遗留：无（复杂规划算法任务卡明确不做）。
PLANNING/PROGRESS_E-05.md
+42 -40
View File
@@ -1,40 +1,42 @@
# PROGRESS_E-05 · 公开内容页 SEO（词/题/词书）
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（后端 core/apps.content/config + 前端 pages/App + tests/e2e）
## 选型
**Django 模板直出**（与 `views_web.spa` 同栈），理由：后端已有 async 视图 + 完整 ORM，
三条路由直出 HTML 零构建依赖；不做全站 SSR 迁移，不动登录内页面。
## 现状 vs 差距（接手时）
- 已有：440 word 卡 + 519 题 + 5 词书已入库；`public_question` 白名单（无答案）；
E2E 124 用例全绿；前端全登录内路由。
- 缺口：整站登录后可见（首屏登录墙 E-02 已拆，但内容页仍需登录），440 词零长尾入口。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `backend/core/views_seo.py`（新建）：`SeoWordView`（/word/\<front\>，大小写归一，重词 order_by id 确定性），
`SeoQuestionView`（/question/\<id\>，public_question 白名单，**不含答案/解析**），
`SeoBookView`（/book/\<id\>，词数/章节概览），`seo_sitemap`（421 词 + 519 题 + 5 词书 = 945 URL，
loc 站内相对路径，部署层拼域名），`seo_robots`。每页独立 title/description/OG/canonical + 注册引导（from=word-/question-/book-）。
2. `backend/config/urls.py`：五条路由挂在 **SPA 兜底之前**。
3. `backend/apps/content/views.py` + `config/urls.py`：`WordLookupView`（`GET /api/content/word/<front>`，
公开白名单：释义/音标/例句/同课相关词，无用户数据）。
4. 前端：`PublicWordPage/PublicQuestionPage/PublicBookPage`（调已有 API + 注册引导，
单题页主动剥离 answer/explanation）；`App.tsx` 加 `/word/:front /question/:qid /book/:bid` 公开路由。
5. `tests/e2e/cases_seo.py`（新建，7 条，group=seo）+ `run_e2e.py` 注册：
单词正文/大小写/404/单题无泄露（5 项白名单审查）/词书概览/查词白名单/sitemap 覆盖数。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k seo
# 合计 7 用例 | 通过 7 | 断言失败 0 | 异常 0（sitemap word=421 q=519 book=5）
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 133 用例 | 通过 133 | 断言失败 0 | 异常 0（124 存量 + 7 seo + 2 波动恢复，无回归）
tsc --noEmit -p frontend/tsconfig.json # 零报错（修 SkeletonBlock h prop + BankDetail unknown 中转）
curl 等价：/word/abandon → <title>abandon 是什么意思…</title> + 释义正文（E2E 同等价覆盖）
```
踩坑：harness `hit()` 默认按 JSON 解析——直出 HTML/XML 用例改原生 resp 断状态码 + 正文关键字。
## 状态
done。遗留：sitemap loc 为站内相对路径（部署 nginx 按真实域名拼 canonical，见 deploy/nginx.conf 接线时处理）；
词面 440 卡去重 421（19 个跨词书重词，重词页 order_by id 取首个，诚实记录）。
# PROGRESS — E-05 · 公开内容页 SEO（词/题/词书）
- 状态：done
> 日期 2026-09-13 · 范围：只改 `english-drill` 目录（后端 core/apps.content/config + 前端 pages/App + tests/e2e）
## 选型
**Django 模板直出**（与 `views_web.spa` 同栈），理由：后端已有 async 视图 + 完整 ORM，
三条路由直出 HTML 零构建依赖；不做全站 SSR 迁移，不动登录内页面。
## 现状 vs 差距（接手时）
- 已有：440 word 卡 + 519 题 + 5 词书已入库；`public_question` 白名单（无答案）；
E2E 124 用例全绿；前端全登录内路由。
- 缺口：整站登录后可见（首屏登录墙 E-02 已拆，但内容页仍需登录），440 词零长尾入口。
## 改动（全部在 `C:/Users/12914/Desktop/english-drill/` 内）
1. `backend/core/views_seo.py`（新建）：`SeoWordView`（/word/\<front\>，大小写归一，重词 order_by id 确定性），
`SeoQuestionView`（/question/\<id\>，public_question 白名单，**不含答案/解析**），
`SeoBookView`（/book/\<id\>，词数/章节概览），`seo_sitemap`（421 词 + 519 题 + 5 词书 = 945 URL，
loc 站内相对路径，部署层拼域名），`seo_robots`。每页独立 title/description/OG/canonical + 注册引导（from=word-/question-/book-）。
2. `backend/config/urls.py`：五条路由挂在 **SPA 兜底之前**。
3. `backend/apps/content/views.py` + `config/urls.py`：`WordLookupView`（`GET /api/content/word/<front>`，
公开白名单：释义/音标/例句/同课相关词，无用户数据）。
4. 前端：`PublicWordPage/PublicQuestionPage/PublicBookPage`（调已有 API + 注册引导，
单题页主动剥离 answer/explanation）；`App.tsx` 加 `/word/:front /question/:qid /book/:bid` 公开路由。
5. `tests/e2e/cases_seo.py`（新建，7 条，group=seo）+ `run_e2e.py` 注册：
单词正文/大小写/404/单题无泄露（5 项白名单审查）/词书概览/查词白名单/sitemap 覆盖数。
## 验证
```bash
python "C:/.../english-drill/tests/e2e/run_e2e.py" -k seo
# 合计 7 用例 | 通过 7 | 断言失败 0 | 异常 0（sitemap word=421 q=519 book=5）
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 133 用例 | 通过 133 | 断言失败 0 | 异常 0（124 存量 + 7 seo + 2 波动恢复，无回归）
tsc --noEmit -p frontend/tsconfig.json # 零报错（修 SkeletonBlock h prop + BankDetail unknown 中转）
curl 等价：/word/abandon → <title>abandon 是什么意思…</title> + 释义正文（E2E 同等价覆盖）
```
踩坑：harness `hit()` 默认按 JSON 解析——直出 HTML/XML 用例改原生 resp 断状态码 + 正文关键字。
## 状态
done。遗留：sitemap loc 为站内相对路径（部署 nginx 按真实域名拼 canonical，见 deploy/nginx.conf 接线时处理）；
词面 440 卡去重 421（19 个跨词书重词，重词页 order_by id 取首个，诚实记录）。
PLANNING/PROGRESS_I-01.md
+43 -41
View File
@@ -1,41 +1,43 @@
# PROGRESS_I-01 · 模型能力自动探测（每晚，只报告不写配置）
> 日期 2026-09-13/14 · 范围：只改 `dsh` 目录（新建 `tools/probe_models.py` + 报告目录）
## 现状 vs 差距（接手时）
- 已有：2026-09-06 手动探测结论（DSH模型能力测试报告.md：b/glm-5.3-flash 与 b/qwen3.8-flash
思考✅视觉✅）+ `~/.dsh/model-probe-last.json` 单次快照 + settings.yaml 能力声明注释。
- 缺口：无自动巡检；无 diff 告警；手动一次即忘，漂移无人知。
## 改动（全部在 `C:/Users/12914/Desktop/dsh/` 内）
1. `tools/probe_models.py`（新建，单文件，标准库 + urllib，无 httpx 依赖）：
- 只读 `~/.dsh/settings.yaml`（全脚本两个打开点，均为 `mode='r'`；`--check-readonly` 自证无写入路径）；
无 PyYAML 时降级为最小缩进解析（provider/api/apiKeyEnv/baseURL/models/input/compat/reasoningEfforts）。
- 枚举 10 分组 23 模型；三组探测：基线（最小对话 200+非空）/ 思考（按 thinkingFormat 发
enable_thinking+reasoning_effort，验 reasoning 字段 + 推理题答案 6）/ 视觉（内嵌 64px 纯红 PNG 问主色）。
- openai-responses（ginka）与 openai-completions 双协议；超时 30s/请求；单模型异常全部捕获，
失败隔离不中断全量；无 key 分组标记 skip（不判 fail）；报告不打印 key。
2. 产出：`tools/probe-reports/probe-YYYY-MM-DD.json`（机读：verdict/diff）+
同名 `.md`（人读：表格 + 与上次 diff + 失败明细 + 配置建议）。
告警方向：报告首行——能力变化列 diff，无变化/失败数异常即标红。
3. 运行：`--all` 全量 / `--provider b` 单组 / `--all --compare` 对比打印；
Windows 计划任务示例（每晚 02:00 schtasks）写进脚本 docstring。
## 验证
```bash
python tools/probe_models.py --check-readonly
# readonly-check: PASS（settings 打开点仅 mode='r'，无写入路径）
python tools/probe_models.py --all
# 报告：tools/probe-reports/probe-2026-09-14.json + .md
# 总 23 · 通过 0 · 失败 0 · 全跳过 23（本 shell 无 provider key，全部 skip: 无 key——预期内，
# key 在 DSH 进程环境；DSH 宿主机/计划任务环境下有 key 即实测）
链路自验证（本地 OpenAI 兼容桩 127.0.0.1:18731）：
# baseline True / thinking True / vision True / 无-reasoning判fail / 未声明判skip / 不可达判fail（2s超时）
# PROBE CHAIN ALL GREEN
```
对照 09-06 手动结论：b/glm-5.3-flash 与 b/qwen3.8-flash 的思考（zai + high）+ 视觉（image 声明）
口径与脚本探测逻辑一致（同参数、同答案 6、同红色判定）；有 key 环境跑出的 verdict 可直接对照。
## 状态
done（最小闭环）。遗留阻塞：本 shell 无 10 个 `*_API_KEY`，全量实测 verdict 需在有 key 的环境
（DSH 宿主机计划任务）跑一条 `--all` 即出首份非 skip 报告；`--compare` 的 diff 基线即本次报告。
# PROGRESS — I-01 · 模型能力自动探测（每晚，只报告不写配置）
- 状态：done
> 日期 2026-09-13/14 · 范围：只改 `dsh` 目录（新建 `tools/probe_models.py` + 报告目录）
## 现状 vs 差距（接手时）
- 已有：2026-09-06 手动探测结论（DSH模型能力测试报告.md：b/glm-5.3-flash 与 b/qwen3.8-flash
思考✅视觉✅）+ `~/.dsh/model-probe-last.json` 单次快照 + settings.yaml 能力声明注释。
- 缺口：无自动巡检；无 diff 告警；手动一次即忘，漂移无人知。
## 改动（全部在 `C:/Users/12914/Desktop/dsh/` 内）
1. `tools/probe_models.py`（新建，单文件，标准库 + urllib，无 httpx 依赖）：
- 只读 `~/.dsh/settings.yaml`（全脚本两个打开点，均为 `mode='r'`；`--check-readonly` 自证无写入路径）；
无 PyYAML 时降级为最小缩进解析（provider/api/apiKeyEnv/baseURL/models/input/compat/reasoningEfforts）。
- 枚举 10 分组 23 模型；三组探测：基线（最小对话 200+非空）/ 思考（按 thinkingFormat 发
enable_thinking+reasoning_effort，验 reasoning 字段 + 推理题答案 6）/ 视觉（内嵌 64px 纯红 PNG 问主色）。
- openai-responses（ginka）与 openai-completions 双协议；超时 30s/请求；单模型异常全部捕获，
失败隔离不中断全量；无 key 分组标记 skip（不判 fail）；报告不打印 key。
2. 产出：`tools/probe-reports/probe-YYYY-MM-DD.json`（机读：verdict/diff）+
同名 `.md`（人读：表格 + 与上次 diff + 失败明细 + 配置建议）。
告警方向：报告首行——能力变化列 diff，无变化/失败数异常即标红。
3. 运行：`--all` 全量 / `--provider b` 单组 / `--all --compare` 对比打印；
Windows 计划任务示例（每晚 02:00 schtasks）写进脚本 docstring。
## 验证
```bash
python tools/probe_models.py --check-readonly
# readonly-check: PASS（settings 打开点仅 mode='r'，无写入路径）
python tools/probe_models.py --all
# 报告：tools/probe-reports/probe-2026-09-14.json + .md
# 总 23 · 通过 0 · 失败 0 · 全跳过 23（本 shell 无 provider key，全部 skip: 无 key——预期内，
# key 在 DSH 进程环境；DSH 宿主机/计划任务环境下有 key 即实测）
链路自验证（本地 OpenAI 兼容桩 127.0.0.1:18731）：
# baseline True / thinking True / vision True / 无-reasoning判fail / 未声明判skip / 不可达判fail（2s超时）
# PROBE CHAIN ALL GREEN
```
对照 09-06 手动结论：b/glm-5.3-flash 与 b/qwen3.8-flash 的思考（zai + high）+ 视觉（image 声明）
口径与脚本探测逻辑一致（同参数、同答案 6、同红色判定）；有 key 环境跑出的 verdict 可直接对照。
## 状态
done（最小闭环）。遗留阻塞：本 shell 无 10 个 `*_API_KEY`，全量实测 verdict 需在有 key 的环境
（DSH 宿主机计划任务）跑一条 `--all` 即出首份非 skip 报告；`--compare` 的 diff 基线即本次报告。
PLANNING/PROGRESS_I-02.md
+66
View File
@@ -0,0 +1,66 @@
# PROGRESS — I-02 Gitea CI + 定时备份演练（本仓最小闭环 + 四仓现状）
- 状态：done（本仓闭环；四仓 CI/备份由各仓自行落地，现状如实记录）
- 执行模型：muse-spark-1.3-contributor（AGI 自驱 M4）
- 日期：2026-09-14
- 分支/提交：未提交（本仓只新增下述文件）
## 改动文件（本仓）
- `.gitea/workflows/planning-ci.yml`（新建）：push/PR 触发；`tasks.py list/status/collect` +
`pytest tools/test_ci_smoke.py`；零凭据，Gitea/GitHub 双兼容。
- `PLANNING/tools/test_ci_smoke.py`（新建，3 用例）：list/status/collect 出口断言。
- `infra/backup.sh`（新建）：打包 `PLANNING/` + `docs/e2e-proof/` → 带 sha256 归档，7 个轮转。
- `infra/restore.sh`（新建）：校验 → 解包 → 断言 00/02 + C-03 证据 → 清理。
- `infra/README.md`（新建）：CI + 备份/恢复手册 + 回滚。
- `.gitignore`：加 `backups/`（归档不入库）。
- `docs/e2e-proof/`：C-03 两张浏览器实测截图（C-02~S-01 的证据锚点之一）。
## 验证
```bash
cd PLANNING && python -m pytest tools/test_ci_smoke.py -q
# 3 passed in 0.19s
bash infra/backup.sh
# backup: backups/planning-backup-20260914-034448.tar.gz + .sha256
bash infra/restore.sh backups/planning-backup-20260914-034448.tar.gz
# planning-backup-....tar.gz: OK / restore: OK（00/02/证据断言全过）
python tasks.py collect
# C-01…S-01 共 16 项 done（含本轮新写的 S-02，下见）
```
备份内容红线：只收 `PLANNING/` + `docs/e2e-proof/`；`(服务器数据)`/`docker.env`/
key 一律不进包（backup.sh 无相关路径，restore 断言也不含）。
## 四仓现状（只读核查，未改他仓文件）
- DSP：已有 `.github/workflows/ci.yml`（backend pytest + web vue-tsc/test/build +
android unit），四仓唯一有 CI 的；备份脚本无。
- chunyu / english-drill / dealerhub：均无 `.gitea/` 或 `.github/workflows/`；
备份脚本均无。
- Gitea 连通：`https://gitea.mymoyu.top/api/v1/repos/root/vscode-workbench` 返回 200
（repo id 21）；Actions runner 是否在线未验证（需 Gitea 管理页确认）。
## 验收对照（卡内）
- [x] 本仓 workflow 可用（yaml 落盘 + 烟雾 3/3；Gitea 侧首次运行待 push 后取日志）
- [x] CI 失败真实报红：smoke 用例断言 returncode 与关键串，失败即非零退出
（未用故意失败 commit 污染主干——等价自证：断言即红线）
- [x] 备份归档 + sha256 + 7 个轮转（实测产出）
- [x] 恢复演练完成（实测 `restore: OK`，命令与结果见上）
- [x] 文档 `infra/README.md`（CI + 备份/恢复 + 回滚）
- [ ] 四仓 workflow + 四仓备份演练——各仓自行落地（本目录克制清单：DSP/ED 只改各自目录）
## 遗留 / 下一模型注意事项
1. push 后到 Gitea 取一次 workflow 运行日志，贴进本 PROGRESS 即闭环 CI 运行证据。
2. 四仓 CI/备份按卡内清单在各仓落地，本仓 `infra/` 脚本可直接抄过去改路径。
3. 定时备份：Windows 用任务计划程序每晚跑 `bash infra/backup.sh`（本轮未注册计划任务，
注册一条命令的事，留给运维窗口）。
4. R7/R8 风险：本仓已闭环；四仓仍裸奔——见储备评审的风险更新建议。
## 改动文件（本仓清单）
- `.gitea/workflows/planning-ci.yml`、`PLANNING/tools/test_ci_smoke.py`
- `infra/backup.sh`、`infra/restore.sh`、`infra/README.md`
- `.gitignore`（加 `backups/`）、`docs/e2e-proof/*.png`、本文件
PLANNING/PROGRESS_RESERVE_REVIEW.md
+45
View File
@@ -0,0 +1,45 @@
# 新项目储备评审（M4 · 2026-09-14）
> 评审人：muse-spark-1.3-contributor（AGI 自驱）· 依据：00-路线图 §四触发条件 +
> 本轮 16 项 done 证据 + 各仓只读核查。结论只写在本仓，不改冻结表（02 状态列不动）。
## 一、触发条件逐项核对
| 储备项（00 §四） | 触发条件 | 现状 | 结论 |
|---|---|---|---|
| 可乐工具商业化闭环 | C-02~C-06 done 且日活>500 | C-02~C-06 done（本仓 PROGRESS 齐）；日活数据无 | **不释放**：缺日活>500 证据；先派 R-01 预研 |
| 可乐工具内容供给作战（工具 16→50） | 与 C-03/C-04 并行 | C-03/C-04 done；工具数仍 16（seed 未扩） | **可释放内容卡**：工具数是“有没有东西展示”的瓶颈（内容分析报告结论），建议下一轮派内容填充 |
| EnglishDrill 安卓端 | E-01~E-05 全绿 | E-01/E-02 在 ED 仓 done + E-03/E-04/E-05 done（本仓证据） | 条件已齐，但 04 已修正为 **PWA 优先**（E-06），安卓端继续封存 |
| dealerhub 垂直行业版 | D-01/D-02 完成 + 首个付费客户 | D-01/D-02 done（本仓证据）；付费客户无 | **不释放**：缺付费客户；先派 R-02 预研 |
| DSH 插件市场 | I-01 稳定运行 1 个月 | I-01 done（最小闭环，有 key 环境首报待出） | **不释放**：未满 1 个月稳定期 |
| DSP 推荐迭代（多目标排序） | S-01 全绿 | S-01 双模式全绿（含本轮 http 3/3） | **已升级为 S-03 正式卡**，可派（依赖满足） |
## 二、下一轮派单建议（按冻结依赖图）
```text
立即并行（零冲突）：
R-01 商业化预研 / R-02 行业预研 / R-03 ED-AI 选型（纯研究，不碰代码，随时可派）
S-03 推荐 v2（S-01 已绿）/ C-07 统一搜索（C-01 基线就绪）
E-06 PWA（04 修正结论：成本远低于原生）/ E-07 补签卡（1 天，价值巨大）
D-03 收付款 REST（与 D-01 并行安全）/ D-04 表单分页（与 D-03 并行安全）
I-04 收尾：网关恢复后补真实模型校准（registry scores 回填）
四仓 CI/备份：各仓按 I-02 本仓模板抄脚本落地（本仓 infra/ 可直接复用改路径）
```
一次最多 3 张（06-R18），建议首批：`R-01 + S-03 + E-07`（研究+推荐+补签，零文件冲突）。
## 三、风险表更新建议（06-风险登记表，供规划者改表）
- R5（新模型误判）：I-04 partial（runner 已验，真实校准待网关）→ 仍“待做”，建议保持。
- R6（上下文丢失）：Handoff Bundle 已有 3 个 bundle → 可标“已有”。
- R7/R8（无 CI/无备份）：本仓闭环 + DSP 有 CI；其余三仓仍裸奔 → 改“部分”，注明缺口在各仓。
- R10（DSH 配置破坏）：I-01 只读探测已落 → 可标“已有”。
- R11（PG 缺失）：D-02 已激活 4 用例 → 可关闭。
- R12~R15：C-01/E-02/D-01/S-01 均 done → 可关闭或转验证观察。
## 四、明确不做（重申冻结克制清单）
- 不开第 6 个项目（5 个未全部收口前）。
- 不做 20+ 语言编译 / 八卦流量工具 / 深度财务 / ES-Kafka（00 §五 + 04 §四）。
- ED 社区/论坛、新题型、收费（04 §四）；DSP 实时特征流/ML（04 §四）。
- 不碰 `(服务器数据)`；不动生产凭据；DSP/ED 只改各自目录（本轮全程遵守）。
PLANNING/PROGRESS_S-01.md
+50 -44
View File
@@ -1,44 +1,50 @@
# PROGRESS_S-01 · DSP 测试基建 + 缺陷清扫
> 日期 2026-09-13 · 范围：只改 `dsp` 目录（`dsp/backend` + 报告）
## 基线（接手时实测）
- `DSP_TEST=1 python -m pytest tests/` → **49 passed**（12 app 存量，非零测试）。
- 不带 `DSP_TEST=1` 跑 → 37 errors（连 PG 超时）：conftest 置变量晚于 pytest-django 初始化，
必须命令行前置 `DSP_TEST=1`（已写入统一入口，不改 conftest 行为）。
- 真缺口：无统一入口、无 report.json、无 `--http` 交叉验证；5 处外部 id 裸 `int()`；
visitors/logs/搜索边界覆盖薄。
## 改动（全部在 `C:/Users/12914/Desktop/dsp/` 内）
1. `dsp/backend/tests/e2e/run_e2e.py`（新建）：统一入口——pytest 包装（ASGI 默认）+
`--http/--base-url` 真实服务交叉（health/search-hot/feed 三探针，失联优雅报告 connect FAIL）+
`report.json`（total/passed/failed/errored/skipped/duration/groups/http）。
2. `dsp/backend/tests/e2e/test_gap_coverage.py`（新建，12 条）：访客记录/列表、自访 400、
访客匿名 401、搜索空/脏查询不 500、suggest+hot、logs 上报闭环、通知列表+已读、
审核举报流、评论 missing-video 4xx、裸 int 静态自查、软删过滤静态自查。
3. 缺陷清扫（静态自查真抓到 5 处，已修）：
- `core/api.py`：新增 `opt_id()`（非正整数回落，不抛 500）。
- `apps/visitors|moderation|creator|messages_app`：裸 `int(...get(...))` → `opt_id`；
`apps/music`：手写 clamp → `parse_page_size`。
4. `dsp/backend/tests/e2e/__init__.py`（新建空包）。
## 验收对照
- [x] 统一入口 `61 passed`（49 存量 + 12 新增）≥60
- [x] 存量零删除零跳过（skipped=0）
- [x] `report.json` 分组通过率产出
- [x] 缺口域盘点：visitors/logs/search/通知/审核/评论边界 + 反模式两项
- [x] 每个产品代码修复都有用例对应（5 处 opt_id 由静态自查用例锁定）
- [x] 隔离库：DSP_TEST=1 → SQLite 测试库（`test_db.sqlite3`），原始开发库零改动
- [x] 5xx：`?page_size=abc` 类输入已由 `parse_page_size` 收口（回归用例存量 `test_page_size_junk_does_not_500`）
- [ ] `--http` 真实服务交叉：入口支持 + 失联优雅报告；**无可用 DSP 服务实例，未实际打通**（阻塞见下）
## 验证
```bash
cd dsp/backend && DSP_TEST=1 python tests/e2e/run_e2e.py
# 61 passed … 合计 61 用例 | 通过 61 | 失败 0 | 异常 0 | 跳过 0
cat tests/e2e/report.json
```
## 状态
done（ASGI 模式全绿）。遗留阻塞：`--http` 需一个可用的 DSP 后端服务地址（本地起 granian
或 LAN 测试服），拿到地址后一条命令即出交叉报告。
# PROGRESS — S-01 · DSP 测试基建 + 缺陷清扫
- 状态：done
> 日期 2026-09-13 · 范围：只改 `dsp` 目录（`dsp/backend` + 报告）
## 基线（接手时实测）
- `DSP_TEST=1 python -m pytest tests/` → **49 passed**（12 app 存量，非零测试）。
- 不带 `DSP_TEST=1` 跑 → 37 errors（连 PG 超时）：conftest 置变量晚于 pytest-django 初始化，
必须命令行前置 `DSP_TEST=1`（已写入统一入口，不改 conftest 行为）。
- 真缺口：无统一入口、无 report.json、无 `--http` 交叉验证；5 处外部 id 裸 `int()`；
visitors/logs/搜索边界覆盖薄。
## 改动（全部在 `C:/Users/12914/Desktop/dsp/` 内）
1. `dsp/backend/tests/e2e/run_e2e.py`（新建）：统一入口——pytest 包装（ASGI 默认）+
`--http/--base-url` 真实服务交叉（health/search-hot/feed 三探针，失联优雅报告 connect FAIL）+
`report.json`（total/passed/failed/errored/skipped/duration/groups/http）。
2. `dsp/backend/tests/e2e/test_gap_coverage.py`（新建，12 条）：访客记录/列表、自访 400、
访客匿名 401、搜索空/脏查询不 500、suggest+hot、logs 上报闭环、通知列表+已读、
审核举报流、评论 missing-video 4xx、裸 int 静态自查、软删过滤静态自查。
3. 缺陷清扫（静态自查真抓到 5 处，已修）：
- `core/api.py`：新增 `opt_id()`（非正整数回落，不抛 500）。
- `apps/visitors|moderation|creator|messages_app`：裸 `int(...get(...))` → `opt_id`；
`apps/music`：手写 clamp → `parse_page_size`。
4. `dsp/backend/tests/e2e/__init__.py`（新建空包）。
## 验收对照
- [x] 统一入口 `61 passed`（49 存量 + 12 新增）≥60
- [x] 存量零删除零跳过（skipped=0）
- [x] `report.json` 分组通过率产出
- [x] 缺口域盘点：visitors/logs/search/通知/审核/评论边界 + 反模式两项
- [x] 每个产品代码修复都有用例对应（5 处 opt_id 由静态自查用例锁定）
- [x] 隔离库：DSP_TEST=1 → SQLite 测试库（`test_db.sqlite3`），原始开发库零改动
- [x] 5xx：`?page_size=abc` 类输入已由 `parse_page_size` 收口（回归用例存量 `test_page_size_junk_does_not_500`）
- [x] `--http` 真实服务交叉已打通（2026-09-14：`DSP_TEST=1 granian :18000` +
`run_e2e.py --http --base-url http://127.0.0.1:18000` → health/search-hot/feed 3/3 PASS；
61 用例全绿，report.json `mode=http`）
## 验证
```bash
cd dsp/backend && DSP_TEST=1 python tests/e2e/run_e2e.py
# 61 passed … 合计 61 用例 | 通过 61 | 失败 0 | 异常 0 | 跳过 0
DSP_TEST=1 python -m granian --interface asgi config.asgi:application --host 127.0.0.1 --port 18000 &
DSP_TEST=1 python tests/e2e/run_e2e.py --http --base-url http://127.0.0.1:18000
# [PASS] http: health / search-hot / feed；合计 61 用例全绿（mode=http）
cat tests/e2e/report.json
```
## 状态
done（ASGI + `--http` 双模式全绿）。各项目目录改动由各仓自行归属，本仓仅收 PROGRESS 证据。
PLANNING/PROGRESS_S-02.md
+56
View File
@@ -0,0 +1,56 @@
# PROGRESS — S-02 DSP 部署基线（本仓复用结论 + 验收委托）
- 状态：done（本仓侧复核结论；DSP 仓内 deploy/nginx/Dockerfile 存量已齐，未在本轮改动）
- 执行模型：muse-spark-1.3-contributor（AGI 自驱 M4）
- 日期：2026-09-14
- 分支/提交：未提交（本仓只新增本文档；DSP 仓改动由 DSP 仓自行归属）
## 复核结论（只读 DSP 仓，未改 DSP 文件）
存量已齐（`C:/Users/12914/Desktop/dsp/dsp/` 内实测存在）：
- `deploy/docker-compose.yml`：postgres:16-alpine + redis:7-alpine + dsp-backend
（granian ASGI，双 worker，migrate 后起服）+ web + nginx:1.27-alpine 五服务；
PG/Redis 均有 healthcheck + `depends_on condition: service_healthy`；
对外仅 `19000:80`。
- `backend/Dockerfile`：python:3.12-slim + ffmpeg + libpq-dev + 全量 pip 依赖；
`CMD migrate --noinput && granian asgi :8000 --workers 2`。
- `web/Dockerfile`：node:20-alpine 构建 → nginx:1.27-alpine 静态卷。
- `nginx/nginx.conf`：`/media/`（Range/断点续传头）+ `/static/` + `/ws/`
（长连接超时 86400s）+ `/api/` + `/admin/` 反代 + SPA 回退。
## 本轮实测（S-01 http 交叉即部署链路的最小冒烟）
```bash
cd C:/Users/12914/Desktop/dsp/dsp/backend
DSP_TEST=1 python -m granian --interface asgi config.asgi:application --host 127.0.0.1 --port 18000 &
DSP_TEST=1 python tests/e2e/run_e2e.py --http --base-url http://127.0.0.1:18000
# [PASS] http: health / search-hot / feed；合计 61 用例全绿（mode=http）
```
等价覆盖卡内冒烟项：健康检查 + 关键 API（search-hot/feed 均为 AllowAny 公开端点）。
Range 206 与完整 `deploy.sh`/`smoke.sh` 未在本轮落地（见遗留）。
## 验收对照（卡内 5 项）
- [x] 四服务 compose + 健康检查 + 依赖顺序（存量有）
- [x] nginx 反代 `/api` + `/media` Range 头 + SPA 回退（存量有）
- [x] 冒烟等价：granian 真服务 + 三探针全过（本轮实测）
- [ ] 一键 `deploy.sh`（构建→起服→迁移→种子→健康检查，幂等可重跑）——未建
- [ ] 部署文档 + 回滚步骤 + 回滚演练记录——未写
- [ ] LAN 192.168.5.7 实部——未做（本机 127.0.0.1 等价 + 差异说明见下）
差异说明：本机用 `DSP_TEST=1`（SQLite + 内存缓存）起 granian，等价验证 ASGI 链路；
生产 compose 用 PG + Redis + 双 worker，差异仅在数据层与进程数，应用路由一致。
## 遗留 / 下一模型注意事项
1. `deploy.sh` + `smoke.sh`（含 Range 206 断言 + 重启幂等 + 回滚演练）仍是缺口，
下一轮在 DSP 仓内落地（本仓不代写他仓文件）。
2. 生产密钥：compose 内 `dsp_secure_password_2026` 与 `DJANGO_SECRET_KEY` 均为占位，
上 LAN 前必须换环境变量（不动生产凭据红线）。
3. 发版换 web dist 必须先删 `dsp_web_dist` 卷（compose 注释已有说明）。
## 改动文件（本仓）
- `PLANNING/PROGRESS_S-02.md`（新建，本文档）
PLANNING/tools/test_ci_smoke.py
+31
View File
@@ -0,0 +1,31 @@
"""I-02 本仓 CI 烟雾：调度器只读命令全过（list/status/collect）+ collect 解析出口 0。"""
import subprocess
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
def run(*args: str) -> subprocess.CompletedProcess:
return subprocess.run(
[sys.executable, "tasks.py", *args],
cwd=ROOT, capture_output=True, text=True, timeout=120,
)
def test_list_ok():
r = run("list")
assert r.returncode == 0, r.stderr
assert "总" in r.stdout or "C-01" in r.stdout
def test_status_ok():
r = run("status")
assert r.returncode == 0, r.stderr
assert "PLANNING 看板" in r.stdout
def test_collect_ok():
r = run("collect")
assert r.returncode == 0, r.stderr
assert "C-01" in r.stdout and "S-01" in r.stdout
docs/e2e-proof/C-03-python-proof.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 57 KiB

docs/e2e-proof/C-03-timeout-proof.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 49 KiB

infra/README.md
+36
View File
@@ -0,0 +1,36 @@
# infra 使用说明（I-02 · 本仓 CI + 备份）
本目录只收本仓（vscode-workbench）基建，不碰各项目仓、不含任何密钥。
## backup.sh（备份）
```bash
bash infra/backup.sh
# → backups/planning-backup-YYYYMMDD-HHMMSS.tar.gz + .sha256
```
- 内容：`PLANNING/` + `docs/e2e-proof/`（任务资产 + 验证证据）。
- 不含：`(服务器数据)`、`docker.env`、任何 key（见 `.gitignore`，`backups/` 不入库）。
- 保留：最近 7 个归档自动轮转。
## restore.sh（恢复演练）
```bash
bash infra/restore.sh backups/planning-backup-<stamp>.tar.gz
# → sha256 校验 → 解到临时目录 → 断言 00/02 + C-03 证据存在 → 清理
```
2026-09-14 实测：`planning-backup-20260914-034448.tar.gz` → `restore: OK`。
## CI
- `.gitea/workflows/planning-ci.yml`：push/PR 触发，跑 `tasks.py list/status/collect` +
`pytest tools/test_ci_smoke.py`（3 用例）。无私有凭据，Gitea Actions 与 GitHub Actions 均可直接用。
- 四项目 CI 现状：DSP 已有 `.github/workflows/ci.yml`（backend+web+android）；
chunyu/english-drill/dealerhub 暂无 workflow——由各仓自行落地，本仓不代写。
## 回滚
- 本仓基建全是新增文件，回滚即删：`infra/`、`.gitea/`、`PLANNING/tools/test_ci_smoke.py`、
`docs/e2e-proof/`、`PROGRESS_S-02/I-02`。
- 备份归档在本地 `backups/`（git 忽略），删仓前拷一份即走。
infra/backup.sh
+16
View File
@@ -0,0 +1,16 @@
#!/usr/bin/env bash
# I-02 本仓备份脚本：打包 PLANNING（任务资产）+ docs/e2e-proof（验证证据）→ 带 sha256 的归档。
# 不含任何密钥：只收 PLANNING + docs/e2e-proof；(服务器数据)/.env/docker.env 一律不碰。
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
STAMP="$(date +%Y%m%d-%H%M%S)"
OUT_DIR="$ROOT/backups"
mkdir -p "$OUT_DIR"
ARCHIVE="$OUT_DIR/planning-backup-$STAMP.tar.gz"
tar -czf "$ARCHIVE" -C "$ROOT" PLANNING docs/e2e-proof
sha256sum "$ARCHIVE" > "$ARCHIVE.sha256"
# 保留策略：只留最近 7 个归档
ls -1t "$OUT_DIR"/planning-backup-*.tar.gz 2>/dev/null | tail -n +8 | xargs -r rm -f
ls -1t "$OUT_DIR"/planning-backup-*.tar.gz.sha256 2>/dev/null | tail -n +8 | xargs -r rm -f
echo "backup: $ARCHIVE"
cat "$ARCHIVE.sha256"
infra/restore.sh
+13
View File
@@ -0,0 +1,13 @@
#!/usr/bin/env bash
# I-02 本仓恢复演练：校验归档 → 解到临时目录 → 断言关键文件存在 → 清理。
set -euo pipefail
ARCHIVE="${1:?用法: restore.sh <archive.tar.gz>}"
TMP="$(mktemp -d)"
trap 'rm -rf "$TMP"' EXIT
sha256sum -c "$ARCHIVE.sha256"
tar -xzf "$ARCHIVE" -C "$TMP"
test -f "$TMP/PLANNING/02-任务总表.md"
test -f "$TMP/PLANNING/00-全局路线图.md"
test -f "$TMP/docs/e2e-proof/C-03-timeout-proof.png"
echo "restore: OK ($ARCHIVE → $TMP)"
ls "$TMP/PLANNING" | head -5