diff --git a/README.md b/README.md index 3a3c1b3..e9b823a 100644 --- a/README.md +++ b/README.md @@ -62,6 +62,12 @@ 服务默认仅监听 `127.0.0.1`,拒绝非本机 Host 和跨来源写入。代理池设置页使用现有 `manage.ps1` 控制本机服务;工作台停止脚本只结束自己管理且进程身份匹配的服务,不停止代理池。 +代理池页分别显示 API、抓取与检测、Redis 的状态。重复启动会复用已运行的服务;检查状态不改变当前代理或隔离列表。工作台优先使用已安装的 PowerShell 7.3+ 运行代理池脚本,并统一输出为 UTF-8。后台启动的输出通过文件收集,避免等待服务关闭才能返回。原代理池文件保持不变。 + +如果现有 API 和调度器由管理员启动,普通权限工作台仍可使用代理、查询状态和复用服务,页面会显示「管理员权限运行」及停止命令,并禁用普通权限下的停止按钮。如需改为网页直接管理:在管理员 PowerShell 中执行页面显示的停止命令,然后回到普通权限工作台点击「启动」。外部 Redis 服务会继续保留。PID 无效或进程入口不匹配时,工作台显示具体原因,禁止操作该进程。 + +Python 命令引号的版本兼容性参见 [PowerShell 官方参数解析说明](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_parsing?view=powershell-7.5#passing-arguments-that-contain-quote-characters)。 + ```powershell # 后端行为测试 .\.venv\Scripts\python.exe -m pytest -q diff --git a/docs/verification.md b/docs/verification.md index 44aa1f0..5aa914d 100644 --- a/docs/verification.md +++ b/docs/verification.md @@ -2,7 +2,7 @@ 2026-10-11,Windows、本地独立虚拟环境,Python 3.12.13 / Node 24.16。 -- 后端:`python -m pytest -q`,35 passed。Starlette TestClient 提示一条 httpx 迁移 warning,测试退出 0,生产服务不使用 TestClient。 +- 后端:`python -m pytest -q`,49 passed。Starlette TestClient 提示一条 httpx 迁移 warning,测试退出 0,生产服务不使用 TestClient。 - 前端:`npm test`,3 passed;`npm run build`,TypeScript 检查与 Vite 生产构建退出 0。 - Edge 实际浏览器:独立端口 8766、独立 `.runtime/qa/db`,验证导入→科目筛选→收藏→对比→历史趋势→Excel 下载;任务/代理/设置页面;设置保存;390px 手机宽度无页面溢出;无 pageerror。测试数据均标明「自动验收样例」,没有写入正式数据库。 - 启动脚本:Windows PowerShell 首启、重复启动、停止、重新启动均退出 0;正式服务在 127.0.0.1:8765,健康检查应用身份和项目路径匹配。 @@ -20,3 +20,11 @@ ``` 正式服务不会自动开始采集,需要用户在网页创建任务。 + +代理池服务控制修复(2026-10-11): + +- 复现原因:代理池 API / 调度器以管理员权限运行,普通权限的 CIM 读取不到命令行;旧调用误判为其他进程,且把 PowerShell 本地编码按 UTF-8 解码。新适配层分别显示状态、权限和外部 Redis,不改写原代理池项目。 +- 14 项新增回归覆盖受限状态、重复启动、无权停止、中文输出、错误/过期 PID、停止权限、操作超时、Python 引号、真正的脚本入口、并发配置快照和后台输出管道。后端合计 49 passed。 +- `tools/proxy_service_qa.py`:复制管理脚本到临时测试目录,启动无抓取行为的假 API / 调度器;实际验证普通权限 start → 重复 start → status → stop → API 关闭,PASS。仅只读检查现有 Redis,正式代理池未停止。 +- 独立代码审查确认真实脚本入口校验和一次操作使用同一配置快照;最终无 Critical / Important。 +- 正式界面 Edge 验收:显示 API 正常、两个进程的管理员权限、外部 Redis;点击检查状态成功,点击启动复用现有进程,无乱码或原错误堆栈,状态检查与复用保留当前路由,停止按钮给出权限限制说明。390px 代理页无溢出,无浏览器错误;截图保存为「代理池修复预览.png」。完整独立测试库浏览器流程亦再次通过。 diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index dd8c2be..8ed71b0 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -46,6 +46,8 @@ import type { Log, Config, Proxy, + PoolServiceStatus, + PoolManageResult, Auth, History, Filters, @@ -954,11 +956,17 @@ function ImportDialog({ if (year) body.set("year", year); setBusy(true); try { - const result = await api<{ records: number; scores: number; indexed_schools: number }>("/import", { + const result = await api<{ + records: number; + scores: number; + indexed_schools: number; + }>("/import", { method: "POST", body, }); - notify(`已导入 ${result.records} 条目录/计划、${result.scores} 条分数线${result.indexed_schools ? `,${result.indexed_schools} 所院校索引` : ""}`); + notify( + `已导入 ${result.records} 条目录/计划、${result.scores} 条分数线${result.indexed_schools ? `,${result.indexed_schools} 所院校索引` : ""}`, + ); done(); close(); } catch (e) { @@ -996,8 +1004,8 @@ function ImportDialog({
通过现有项目的 manage.ps1 控制 Redis、API 与抓取调度器。
查看 API、代理抓取与检测、Redis 的运行状态,管理本机服务。
{output}
{services.warning}
{services.admin_command}