# 代码审查开发日志(2026-09-25 起) > 用途:记录本轮"全仓库 Bug / 优化点审查"的进度与关键信息,防止上下文压缩或沙盒重启后丢失。 > 最终汇总报告:`docs/review/CODE_REVIEW_REPORT.md`(已完成)。 ## 0. 恢复指引(上下文丢失 / 沙盒重启后先看这里) 1. `cd /home/user/universal-web-api && git pull && git log -1` 确认最新提交点。 2. 阅读本文件的「3. 进度清单」与「4. 发现列表」,从第一个未勾选的模块继续。 3. 推送凭据只写在 `.git/config`(`http.https://github.com/.extraheader`),**不得写入任何被跟踪的文件或日志**; 若沙盒重启导致 `.git/config` 丢失,需重新向用户确认/使用会话中提供的临时 token 重新配置。 4. 沙盒约束(用户硬性规则): - 每完成一个小项立即 `git add` → `git commit` → `git push origin main`; - 禁止安装 Playwright/Chromium、禁止重度 E2E、禁止保留 png 截图; - 临时文件用完即删;工作区快照上限约 128MB / 10k 文件。 - 用户规则里提到的 `node js/build.js dev`、`node js/tests.js` **在本仓库不存在**(前端位于 `static/js`,无构建脚本), 替代的轻量验证:`node --check `(JS 语法)、`python -m unittest` / `pytest`(纯逻辑测试,跳过 `tests/browser_*.py`)。 ## 1. 仓库概况 - 仓库:`lumingya/universal-web-api`,默认分支 `main`,版本文件 `VERSION=3.0.0`。 - 克隆方式:`git clone --filter=blob:none`(部分克隆,保留完整提交历史,.git ≈ 4MB)。 - 规模:323 个跟踪文件;Python 约 12.8 万行(226 个 .py),前端 JS 约 2.8MB(Vue 3 全局构建 + 自研组件)。 - 技术栈:FastAPI + Uvicorn + Pydantic v2 + DrissionPage(CDP 驱动 Chromium);把已登录的 AI 网页转成 OpenAI / Anthropic 兼容接口。 - 自动更新:`updater.py` 只从 **GitHub Releases** 拉包(`/releases/latest`),往 `main` 推送文档不会被自动分发。 - 超大文件(审查重点,>3000 行):`app/api/tab_routes.py`(5142)、`app/core/tab_pool_parts/manager.py`(4512)、 `app/services/command_engine.py`(3836)、`app/services/config/engine.py`(3341)、`app/core/extractors/media_extractor.py`(3248)、 `app/core/browser/media.py`(3244)、`app/api/chat.py`(3242)、`app/core/network_monitor.py`(3201)、 `app/services/command_engine_actions.py`(3166)。 ## 2. 审查方法 - 静态:`python -m compileall`、pyflakes/ruff(未定义名、未使用变量、可疑比较等)、`node --check`。 - 测试:运行 `tests/test_*.py` 中的纯逻辑测试(不运行 `tests/browser_*.py` 和依赖真实浏览器的用例)。 - 人工:按模块阅读,重点关注 安全(认证/CORS/命令执行/路径穿越/SSRF/解压)、并发(锁/线程/asyncio 混用)、 资源泄漏(无界缓存/后台任务)、错误处理、配置与文档一致性。 ## 3. 进度清单 - [x] 克隆仓库、确认推送权限、建立开发日志 - [x] M1 仓库卫生与配置(.env.example / .gitignore / README / VERSION / requirements) - [x] M2 静态分析 + 现有单元测试运行结果(排除真实浏览器;详情见 §5) - [x] M3 安全:认证与中间件(main.py / app/api/deps.py / CORS / 管理接口)——路由依赖逐项核对,ASGITransport 进程内验证默认跨源读取及启用认证时的 401/200;不代表真实浏览器联调 - [x] M4 安全:命令引擎、updater、媒体落盘/文件路径、SSRF——以 mock 响应+临时目录验证同源 SVG/HTML 落盘与响应头;直接图片请求及 DNS 校验窗口单独记风险,未访问外网/内网目标 - [x] M5 核心请求链路:chat.py / anthropic_routes.py / streaming_response.py / request_manager.py——核查认证委派、流关闭/取消、Responses 状态与请求历史,轻量复现 B2–B4 - [x] M6 标签页池:tab_pool_parts/*(manager / session / recovery / idle_maintenance)——检查锁与取消/恢复路径;用无浏览器桩验证冻结恢复失败和非有限配置值 - [x] M7 浏览器与工作流:core/browser/*、core/workflow/*、stream_monitor、network_monitor——核查控制流边界、流监听与调试持久化;复现 mtime 缓存及布尔字符串误判 - [x] M8 服务层:tool_calling*、config engine、command_engine*——实际主类验证损坏命令配置回退、校验 URL 正则回溯开销并识别未使用存储 mixin - [x] M9 前端:static/js(XSS / v-html / 大文件)——验证完整备份导出敏感项、遗留教程搜索 DOM 注入及无大小限制导入 - [x] M10 汇总报告 `docs/review/CODE_REVIEW_REPORT.md`——独立汇总全部 38 条、验证等级、限制条件与优先修复/验收顺序 ## 4. 发现列表(按发现顺序追加;严重度:P0 严重 / P1 高 / P2 中 / P3 低) | ID | 严重度 | 位置 | 摘要 | 状态 | | --- | --- | --- | --- | --- | | S1 | P1 | `app/core/config_parts/env_config.py:159-188`, `main.py:603-616`, `.env.example:21,59,66-69,134` | 管理认证默认关闭、CORS 默认 `*`;复制模板还绑定 `0.0.0.0` 且布尔占位值实际上为 false。跨源页面/局域网调用控制接口存在高风险;建议默认关闭跨源、管理令牌必选(非本机绑定时 fail-closed)、限制 Host/Origin。浏览器本地网络策略会影响可利用性。 | 进程内跨来源请求确认 200 且 `Access-Control-Allow-Origin: *`;仅启用后台认证时无令牌 401、带测试令牌 200;未运行真实浏览器 | | S2 | P1 | `app/services/command_engine_actions.py:2427-2590,3054-3106`, `app/services/config/engine.py:3312`, `app/services/parser_manager.py:162-227`, `app/core/parsers/registry.py:101-106` | Python 命令的 AST 名单只拦截直接危险调用;别名和传入的高权限对象可绕开,解析器安装会写入并 import 用户源码。此“沙箱”不能作为不可信代码边界;隔离进程/容器并移除危险对象,或只允许可信管理者使用。JS 命令也能访问浏览器上下文。 | 静态确认;未执行攻击代码 | | S3 | P2 | `app/services/parser_manager.py:162-227,331-345` | 解析器安装功能仅校验语法/类名,不约束代码行为,会立即 import 执行;目前未找到直接对外安装路由,是 S2 传入对象间接暴露的代码安装原语。 | 静态确认;未执行 | | S4 | P2 | `app/api/browser_routes.py:119-129`, `start.py:836-844,905-922` | `/api/browser/open-profile-url` 不要求令牌,仅检查 `request.client.host` 回环;经本机反代/隧道/重启代理访问时后端看到的来源可能为回环,可在受控浏览器用户目录打开 URL。须使用认证和来源限制,不能仅依赖 IP。 | 静态确认;未联调 | | S5 | P2 | `start.py:836-892,905-961,1400-1405` | 定时重启开启时的 TCP handoff proxy 无并发上限;每个连接可缓冲 64MB;仅按 Content-Length 读取,chunked/Expect 等请求兼容性不完整,错误被吞。代理后端统一回环地址还影响来源判断。 | 静态确认;仅在重启守护开启时 | | S6 | P2 | `main.py:728-737,804-825,839-841` | `/media/{filename}`、`/download_images/*` 无认证;可读下载目录文件;media 转码由请求触发(60s,无并发/同键去重),有 CPU/存储放大风险。路径边界校验本身正确。 | 静态确认;未压测 | | S7 | P3 | `main.py:376-406,689-698`, `app/api/system.py:789-815` | 无认证的启动引导数据返回站点目录;`/health` 暴露版本、浏览器端口/池状态、运行中的 request/tab ID、认证开关,还可能在健康检查时尝试连接浏览器。考虑仅返回简化健康状态。 | 静态确认 | | H1 | P1 | `.env.example:7-69,100-138`, `app/core/config_parts/env_config.py:111-116,159-171` | 模板重复配置项;`AUTH_ENABLED`/`DASHBOARD_AUTH_ENABLED` 填占位值会解析为 false,且包含 `0.0.0.0`、`APP_DEBUG=true`、CORS `*`、不安全 Python 命令等危险示例;代理、隧道、版本值亦带个人环境痕迹。应重做安全模板与校验。 | 已核对 | | H2 | P3 | `README.md:21`, `README.en.md:21`, `README.zh-CN.md:21`, `VERSION:1` | 三份 README 仍写 2.9.8 并链接不存在的 CHANGELOG_CURRENT.md;实际 VERSION=3.0.0。 | 已核对 | | H3 | P3 | `.gitignore:52,77,102-188`, `config/marketplace_cache.json` | 已跟踪的 marketplace_cache.json 仍被 ignore;tests 白名单含 4 个不存在的用例,且没有覆盖全部已跟踪测试;scripts 忽略规则有重叠。建议清理规则及按需 `git rm --cached` 缓存。 | 已核对 | | H4 | P3 | `main.py`, `app/core/stream_monitor.py`, `static/js/dashboard-schema.js` | 约 40 个文件混用 CRLF/LF,无 `.gitattributes`,增加噪音 diff 与跨平台维护成本;统一 EOL(须先检查各脚本依赖)。 | 已核对 | | H5 | P3 | `assets/*.png`, `static/*.png`, `static/images/logo.svg` | 多组字节相同的图片复制到 assets/static,logo SVG 约 792KB,另有较大截图;可用单一资源引用/压缩资源。 | 已核对 | | H6 | P3 | `requirements.txt:6-7`, `requirements-dev.txt` | FastAPI `<0.110`/Uvicorn `<0.30` 较旧,升级应配合测试与锁定依赖。FastAPI 0.109.2 要求 Starlette `>=0.36.3,<0.37`,不在 CVE-2025-62727 的 0.39–0.49.0 受影响范围,**不将该 CVE 误报于当前约束**;dev 依赖包含 Playwright,本轮禁止安装。 | 已核对 | | B1 | P2 | `app/utils/site_discovery.py:9-18`, `config/site_rules.json:1-22`, `app/services/config/engine.py:1973-1989`, `tests/test_site_discovery.py:18-25,72-76` | 出厂站点规则没有 google.com/bing.com/baidu.com 等 `auto_discovery=false`,默认返回 true;搜索页被当未知聊天站点尝试提取/AI 分析(9 个纯逻辑用例失败),可误用通用工作流。建议补充精确域名阻止规则、保留 gemini.google.com 等子域的可用性。 | 隔离测试复现 | | T1 | P2 | `tests/test_arena_auto_battle_command.py:71-81`, `tests/test_arena_command_persistence.py:1-15`, `tests/test_workflow_js_exec_integration.py:99-123`, `tests/test_media_stream_image_precedence.py:508-515`, `app/services/arena_model_catalog.py:18-22,128-140` | 测试硬依赖被 `.gitignore` 排除的 `config/commands*.json`、`custom_scripts/examples/arena_payload_interceptor.js`、`config/arena_model_catalog.local.json` 或不存在的 `js/arena-conversation-image-window.user.js`;干净克隆中约 64 个失败主要由缺失 fixture 引起,不能当作产品回归。应提供可分发的最小 fixture 或将这类测试标记为本地集成测试。 | 隔离测试复现 | | T2 | P3 | `requirements-dev.txt:1-4`, `tests/test_cancel_storm_regressions.py:340-364` | 纯逻辑测试依赖 `httpx`(ASGITransport),dev requirements 未声明;初轮 1 例报 `ModuleNotFoundError`,仅补装 `httpx` 后该例通过。可拆出不含 Playwright 的 tests extra。 | 隔离测试复现 | | H7 | P3 | `app/utils/model_routing.py:7,213`, `start.py:602,620,678,746` | 延迟注解下 5 处 `Optional` / `Any` 未导入;普通调用未必报错,但 `typing.get_type_hints` 实测分别触发 NameError,静态检查持续报 F821。 | 静态检查 + 轻量复现 | | S8 | P1 | `app/core/browser/media.py:2432-2440,2644-2677,2693-2734,2829-2836`, `app/core/background_image_downloader.py:428-433`, `main.py:839-841` | 后台下载拒绝 SVG,但前台回退将 `image/svg+xml` 响应原样存为可公开访问的 `.svg`(仅要求 `Content-Type` 含 `image`、字节数 >1000,缺安全格式校验)。若上游页面/媒体地址可由攻击者操控,用户**直接导航打开**本地化 SVG 时可能在应用同源执行脚本;作为 `` 加载不应等同于执行。拒绝 SVG 或安全转码为 PNG,媒体与后台统一校验;静态路由另设隔离域/CSP/attachment。 | mock 后台失败、无网络的前台响应成功写 `.svg`;进程内 GET 返回 200 `image/svg+xml`,无 CSP/attachment;未运行真实浏览器 | | S9 | P1 | `app/core/browser/media.py:2101-2215`, `app/core/extractors/media_extractor.py:929-945,1006-1080`, `main.py:728-742,804-825` | 音视频落盘仅检查 Content-Type 包含 `audio`/`video`;未知 MIME 从远程 URL 取后缀,未校验实际内容。可控 `clip.html` 伴随 `video/custom` 响应会原样写入 `.html` 并返回 `/media/*.html`,而 FileResponse 依据后缀以 `text/html` + `inline` 发送。需攻击者控制上游媒体地址和其响应、受害者直接访问该链接;若后台认证启用,应用同源执行脚本可能读取仪表板本地令牌。仅允许已知安全音视频扩展名、实测格式并在独立域/强制下载提供。 | mock 远程响应成功落 `.html`;ASGI 进程内 GET 返回 200 `text/html; charset=utf-8` + `inline`,无 CSP;未执行脚本/真实浏览器 | | S10 | P2 | `app/utils/image_validation.py:37-121,151-175,272-370`, `app/services/arena_gpt_image_command.py:155-175,608,642` | 图片比对/C2PA 读取第三方页面提取的 URL 时直接 `requests.get`:无公网地址/重定向校验且读取 `response.content` 无尺寸上限;data URI 和浏览器 `arrayBuffer()` 回退亦无限制。需媒体 URL 经目标站页面进入比对流程,可能触发盲 SSRF、内网请求或内存放大。统一复用安全获取器并限制响应、data URI、像素解码规模。常规**输入**图片处理 `app/utils/image_handler.py` 已有校验,不能混为一谈。 | mock 证明回环 URL 被直接交给 requests(无实际内网请求);未测真实 SSRF/大响应 | | S11 | P2(条件性) | `app/utils/remote_resource.py:141-185,206-245` | 公共资源抓取先用 DNS 查询验证地址,再将原始主机名传给 `requests.get()`;连接时可能重新解析,攻击者控制 DNS 时可在验证后切到私网地址。重定向逐次校验、凭据跨域剥离已实现,但不消除验证/连接间竞态。应将实际连接 IP 固定为已验证地址(保持 HTTPS SNI/Host),或在可信出网代理上强制拒绝内网段。 | mock 确认验证发生、传给 HTTP 层的仍是域名;未作真实 DNS 重绑定验证,不宣称已利用 | | B2 | P2 | `app/services/request_manager.py:545-573` | 历史读取器试图兼容旧版 JSON **顶层数组**,但先调用 `data.get()`,在 list 上报 AttributeError 后被整体捕获,历史被置空;旧格式升级后监控历史无法恢复。先按 `isinstance(data, list)` 分支取值,再统一校验记录。 | 微型临时文件复现:`{"records":[...]}` 恢复 1 条、等价顶层 `[...]` 恢复 0 条;未触及真实历史 | | B3 | P2 | `app/api/chat.py:93-99,539-608,1030-1076,1950-1955,2420-2425` | Responses API 默认 `store=None` 时存储完整请求历史和助手消息;只有 1h/1024 条**数量**上限,无单条/总字节配额,base64 多模态和连续会话会使内存放大。状态全局只按不可预测 response_id 索引、未按客户端隔离;ID 一旦泄露可跨调用续接历史。建议每项/总量预算、媒体内容剥离/摘要,按认证主体隔离,并在文档说明驻留期。 | 小数据两轮存储字符串长度 137→274;未运行压力测试或尝试跨用户访问 | | B4 | P3 | `app/api/chat.py:469-475,524-528,2514-2517,2804-2813`, `app/core/config_parts/sse_formatter.py:229` | OpenAI `n` 允许 `>=1`,但请求链未据此生成多条选择;非流式统一构造单条 choices,流式将其只当 stop 处理条件。请求 `n=3` 会静默只得一条,建议验证 `n==1` 时明确拒绝其他值或实现多路执行。README 已笼统说明某些网页不支持的字段会忽略,仍应显式声明此行为。 | 构造 `n=3` 请求模型成功,打包器生成 choices 数=1;未接真实浏览器 | | H8 | P3 | `app/api/chat.py:157-193,217-249` | 六个 Arena 错误辅助函数同名定义两次,前者随后被后者覆盖;两套提示词拒绝判断/响应构造实现不完全相同,增加维护漂移和死代码。清理重复定义并保留行为单测。 | 静态确认;无执行回归结论 | | B5 | P2 | `app/core/tab_pool_parts/idle_maintenance.py:346-384`, `app/core/tab_pool_parts/session.py:258-278` | 冻结标签页恢复 CDP 指令报错后,`resume_if_frozen` 返回 false,却在 `finally` 清除 `_uwapi_frozen` 标志;`TabSession.acquire()` 忽略返回值并仍标记 BUSY、返回 true,可能将仍冻结的页面交给请求,后续也不再重试解冻。恢复失败应阻止交付/标为异常并保留待核实状态。 | 假 CDP 抛错的轻量桩复现:acquire=true、status=busy、frozen flag=false;未连接浏览器 | | B6 | P3 | `app/core/tab_pool_parts/idle_maintenance.py:69-103`, `app/core/tab_pool_parts/manager.py:219` | 环境变量 `BROWSER_CDP_RECYCLE_AFTER_REQUESTS=inf` 或 DOM_NODES=inf 可通过 `float()` 后执行 `int(inf)` 抛 OverflowError,使创建标签页池失败。配置解析须检查 `math.isfinite()` 并回退默认。 | patch 进程环境复现 OverflowError;默认配置无此问题 | | H9 | P2(优化) | `app/core/tab_pool_parts/manager.py:151-155,2882-2905,3436-3483`, `app/services/request_manager.py:2282-2335` | 获取标签页的独立线程池限制 32 个**工作线程**,但待执行任务的 `ThreadPoolExecutor` 内部队列和池的等待队列未设置总量上限;大量并发请求可占住线程/排队 Future,活跃请求也不按历史记录条数被驱逐。建议在 API 入口统一设置最大并发与等待数、早返回 429/503,并监控队列深度。 | 静态容量分析;未进行大量并发压力测试,不作为已复现的耗尽故障 | | S12 | P2 | `config/browser_config.json:371-376`, `app/core/config_parts/browser_constants.py:86,219-253`, `app/core/network_monitor.py:1699-1804,1975-1980`, `app/core/config_parts/log_redaction.py:239-311` | 虽然代码/前端默认关闭网络响应调试抓取,**已跟踪的出厂 browser_config.json 却打开** `NETWORK_DEBUG_CAPTURE_ENABLED` 且过滤器为空;命中解析器时会把原始响应正文片段及解析预览写入 `logs/network_parser_debug`(目录上限配置 50MB)。日志净化保护部分令牌/Base64,但正常聊天文本仍可落盘;若配置中填字符串 `"false"`,`bool("false")` 也会错误地启用。应默认禁用调试抓取、要求显式确认隐私及设自动过期/脱敏,严格解析布尔值。 | 实测读取跟踪配置为 true、合成普通聊天文本不会被净化、mock 配置 `"false"` 时启用结果为 true;未使用真实会话或产生调试文件 | | B7 | P3 | `app/core/workflow/script_loader.py:173-194`, `tests/test_workflow_script_loader.py:130-157` | JS 脚本热加载只按浮点 mtime 判断缓存命中;内容替换但 mtime 不变(恢复时间戳/低分辨率文件系统/快速覆盖)时会执行旧脚本,且测试只覆盖 mtime 改变。建议 `st_mtime_ns+size` 并对更新接口显式清缓存;极端同大小同时间需 hash。 | 临时脚本文件复现:盘上内容 `later`、缓存仍返回 `first`;临时目录已自动删除 | | H10 | P3 | `app/core/stream_monitor.py:1706-1732,1768-1779` | `_is_arena_page`、`_arena_native_stop_present` 两次定义,前一版松散子串判断被后一版域名解析与独立检测器覆盖;清理死代码与重复维护面,保留后一版的域名边界。 | 静态确认;运行时以前一版已被覆盖为前提,不宣称当前主机校验失效 | | H11 | P3 | `config/browser_config.json:320-369` | 已跟踪的默认浏览器配置包含多组具体 Arena 会话 URL/标签页编号,不适合作为通用模板,公开仓库中还可能泄露用户曾使用的会话标识。建议用示例占位组与本地不跟踪的覆盖文件替换,必要时清理历史。 | 静态确认 5 组路由数据;未访问这些 URL、未验证是否能读取内容 | | B8 | P2 | `app/services/command_engine.py:1352-1378,1654-1674` | 外部改写 `commands.json` 时,短暂无效 JSON 被解析为 `[]`,热刷新直接将**上一轮有效命令缓存清空**并推进 mtime,还将原有 `run_js_file` 动作认作禁用、生成清理列表;命令临时全失效,浏览器在线时还可能撤销注入。应在错误时保留 last-known-good,区分合法空列表与解析失败,避免据此清理运行态;文件恢复后再刷新。 | 使用真实 `CommandEngine` 与临时 JSON 文件,1 条命令 → 损坏 JSON → 0 条且捕获 1 条待清理动作;**仅 mock 掉清理执行,未运行浏览器或观察在线注入** | | H12 | P2(优化/风险) | `app/services/command_engine_results.py:637-653,655-663` | 网络异常触发器允许配置 regex URL 匹配,直接用标准库 `re.search()` 且无模式复杂度、输入长度或匹配超时限制;嵌套量词会指数回溯,频繁事件可阻塞命令检查线程。建议参考工作流已有 `regex.search(..., timeout=0.025)` 做预编译/超时,限制模式和 URL 长度,并拒绝超时规则。 | 仅 12、16、19 个 `a` 的短 URL 合成输入量测约 0.0005/0.0057/0.046s;未进行长串或压力测试,真实影响依环境/模式而异 | | H13 | P3 | `app/services/command_engine_storage.py:22-335`, `app/services/command_engine.py:60,1340-1380,1654-1674` | `CommandEngineStorageMixin` 在项目内没有被 `CommandEngine` 继承或导入,存储/CRUD 的很多方法却与主类重复,易使后续修复只落在未运行代码中(初次试验也因此需改用生产主类验证)。建议合并、删除或明确弃用该模块并加主类覆盖测试。 | 静态类继承/调用核对,无产品运行错误主张 | | S13 | P1 | `app/api/system.py:79-113,293-315,948-952`, `static/js/dashboard-methods.js:1602-1648`, `app/core/config_parts/env_config.py:159-188` | `GET /api/settings/backup` 原样返回 `.env` 所有键值(可能包含密钥/令牌),默认未启用认证且 CORS `*`;属于 S1 的**具体高价值只读泄露点**。即使启用认证,前端“完整导出”还把浏览器本地仪表板令牌以 `dashboard_token` 和 `api_token` **两份明文**写入下载的 JSON,界面没有敏感数据警告。应为备份接口强制鉴权/禁止跨源,默认剔除密钥并提供单独加密备份选项,不自动导出浏览器本地令牌。 | ASGITransport 模拟 .env 返回**纯合成**密钥,未授权跨源 GET=200/CORS `*` 且响应含合成键值;Node VM 用合成 token 确认 UI 同时写两字段;未读取/输出任何真实令牌 | | S14 | P3(低可利用性) | `static/tutorial/index.html:1534-1540`, `static/js/components/panels/{SelectorPanel,StreamConfigPanel}.js:120-131,252-266` | 遗留教程页仍由设置页入口打开;其搜索无结果提示直接将 `searchInput.value` 插入 `innerHTML`,缺 HTML 转义。输入恶意 HTML 时可形成同源 DOM 注入/自输入 XSS;目前未发现 URL 查询或远程数据自动写入该输入,**不可宣称可远程无交互利用**。使用 `textContent` 或实体编码、清理旧页面。 | Node VM 仅执行这段输入事件回调,合成 `` 字符串原样进入 innerHTML 字符串;无浏览器、未观察脚本执行 | | H14 | P3(优化) | `static/js/dashboard-methods.js:1173-1207,1583-1599`, `static/js/components/panels/PresetTransfer.js:207-211`, `static/js/workflow-studio.js:897-901` | 仪表板的站点/完整备份文件导入无 `file.size` 限制,直接 `FileReader.readAsText` + `JSON.parse`,而预设/工作流导入分别限制 4MiB/1MiB。巨大用户选取文件可使页面卡顿或内存抬升;建议统一上限、流式/分段解析并提示文件过大。 | 静态对照;未加载大文件或压力测试 | ## 5. 工作流水 - 2026-09-25:部分克隆完成;确认 token 具备 push 权限(dry-run 通过);确认 updater 仅走 Releases;建立本日志。 - 2026-09-25 / M1:核对 `.env.example`、三份 README、requirements、ignore 规则、已跟踪缓存与换行;记录 H1–H6。同期初查 149 个 API 路由(AST 粗计,6 个未声明 Depends 的路由需逐项判定),并核实认证/CORS、Python 命令与解析器动态 import、启动代理、媒体/健康路由,记录 S1–S7;M3/M4 尚未完成。PyPI 元数据确认 FastAPI 0.109.2 限制 Starlette `<0.37.0`。本阶段只读审查,未做侵入式验证、未修改业务代码。 - 2026-09-25 / M2:生产依赖及 `ruff`/`pyflakes`/`pytest`/`httpx` 安装到工作区外 `/home/user/.venv`;**未安装 Playwright/Chromium**。Python 226 文件用 `tokenize.open` + AST 语法检查均通过(`text_filter.py` 首字节有 BOM,直接按 UTF-8 文本喂给 AST 的一次假阳性已排除);`node --check` 静态 JS 33 文件通过。Ruff `--target-version py313 --select F821,F822,F823,E9` 报 5 个 F821(H7);pyflakes 全量原始诊断 419 行,多为重导出/未使用变量,不等于 419 个 bug。首轮 `unittest` 57 例:34 通过、6 失败、17 错误;其中失败/错误都指向缺失本地命令和 JS 示例。仅选无私有 fixture 的两组用例 15/15 通过。 - 2026-09-25 / M2(续):排除 3 个真实 Chromium 测试文件和两处浏览器 fixture(未启动浏览器)的 pytest 初轮:**548 passed、74 failed、9 deselected**(10.15s)。归因:64 个缺失/过期本地 fixture(T1)、9 个站点自动发现断言失败(B1)、1 个 dev 依赖缺失(T2)。仅补装 `httpx` 后 T2 对应用例通过;过滤上述已知失效用例的独立干净子集 **544 passed、30 deselected**(8.17s)。所有测试生成的临时目录及忽略的 `config/commands.json`、`config/request_history.json`、`config/app_stats.json` 均已删除;无业务代码变更。 - 2026-09-25 / M3:复核 `app/api/deps.py` 的服务与后台双令牌和路由依赖:149 个 APIRoute 中 12 个无 FastAPI 依赖;其中 6 个模型别名路由在函数内手动验服务令牌,另 6 个是 `/`、`/dashboard`、浏览器引导页、`/media/{filename}`、`/health`、`POST /api/browser/open-profile-url`。`httpx.ASGITransport` 进程内测试:默认关闭后台认证时,外来 Origin 的 CORS 预检和 `GET /api/commands` 均返回 200,后者响应允许 `Access-Control-Allow-Origin: *`;临时仅在进程环境中启用后台认证并提供合成令牌后,同一路由无令牌返回 401、带令牌返回 200。无真实浏览器或外部网络访问,未测试浏览器本地网络策略和反向代理拓扑;检查产生的忽略配置已删除。S1、S4、S6、S7 见上。 - 2026-09-25 / M4:复核命令引擎受限 Python 执行上下文(含浏览器、配置对象和默认可导入 requests)、解析器动态导入及 updater;`updater.py:828-874` 已限制 ZIP 路径/符号链接/条目数/展开大小/压缩比,下载验 SHA-256 digest,失败会从备份恢复,**不将这些保护误报为缺失**。用无网络 mock 响应和自动清理的微型临时目录分别驱动 SVG 图片前台回退与音视频远程下载:获得 `.svg` 和 `.html`,经 `httpx.ASGITransport` 同源路由实际返回 `200 image/svg+xml`(无 attachment/CSP)与 `200 text/html; charset=utf-8`、`Content-Disposition: inline`(无 CSP)。`read_image_bytes` 的回环 URL 以 mock `requests.get` 证明可达调用点,**未实际连接回环/内网**;公共抓取器 mock DNS 后仍把原主机名交给 requests,重绑定仅按条件性风险报告。所有临时产物与导入生成的忽略配置已删除;未安装/运行浏览器或大文件压力测试。S2、S3、S8–S11 见上。 - 2026-09-25 / M5:阅读 OpenAI / Anthropic 接口的认证委派、SSE 响应关闭与请求生命周期:已实现断连时主动关闭异步生成器、线程工作队列限背压及绝对执行超时,未把这些保护误报为缺陷。隔离小文件测试(不运行浏览器)证实历史旧数组读入丢失(B2);Responses 默认启用内存存储且连续两轮重复保留完整会话(B3);构造 `n=3` 可接受但单选择输出(B4)。`chat.py` 六个 Arena 错误辅助函数重复定义(H8)。临时目录及导入生成的忽略配置已清理。 - 2026-09-25 / M6:核对 `TabPoolManager` 的获取/释放条件队列、独立 acquire executor 与取消后回收、Session 状态门禁、隔离恢复服务的超时槽、空闲冻结/CDP 回收逻辑;已存在 0.25s 取消轮询及冻结前检查页面隐藏,不把无真实浏览器实验的状态竞态当成已发生事故。仅用抛错 CDP 桩证明解冻失败仍交付会话(B5),仅用临时 env 值证明配置 inf 可使构造失败(B6)。等待队列未总量限流作为优化风险 H9 记录,不做压力测试;无截图或浏览器下载。 - 2026-09-25 / M7:查阅浏览器媒体/工作流、`flow_runtime.py` 条件与变量解析、`script_loader.py` 路径控制及缓存、DOM/网络流监听。控制流有节点/深度/字节和执行转换预算,正则有 25ms 限时,网络监听有预取容量及调试目录上限,脚本路径解析会限制在指定目录;不能笼统报告缺少这些防护。发现跟踪的 `browser_config.json` 与代码/前端默认开关不一致,默认启用原始响应调试捕获(S12),并携带具体会话 URL(H11);轻量文件实验确认仅 mtime 缓存导致热更新可能陈旧(B7);流监听重复方法只记录为维护问题(H10)。无真实浏览器、网络页面或 PNG 截图。 - 2026-09-25 / M8:查阅工具调用同步/异步修复轮次(默认 2、上限 5)、Schema 本地引用/形状/有限数检查及消息格式;这些已有防护不作为缺失报告。核查配置引擎 JSON 错误时热重载保留旧状态、原子保存与本地覆盖快照。命令引擎另有损坏命令文件导致运行缓存归零(B8),实际主类临时文件复现并在清理动作处用 mock 截断;**最初用未继承的 `CommandEngineStorageMixin` 实验只用于提示死代码,最终证据来自生产主类**。命令网络 URL regex 无超时(H12),短 URL 小样本显示回溯增长;存储 mixin 未使用(H13)。所有临时文件由 TemporaryDirectory 清理,无浏览器/耗内存测试。 - 2026-09-25 / M9:统计前端 HTML 插入点与 `v-html`:Vue 组件里的显式 `v-html` 均为静态 `$icons` SVG,用户/服务端数据多使用模板插值,现代教程和受控浏览器引导页在拼接 `innerHTML` 前已有实体编码,不作全站无防护断言。发现未授权的完整备份 GET 会原样响应 .env(合成环境模拟跨源读取),前端导出还复制浏览器本地令牌明文两次(S13);遗留教程搜索无结果文案直接拼接未经编码的搜索词(S14,自输入风险);站点/完整备份导入缺文件大小限制(H14)。用 Node VM 假对象演示写入点,无 Chromium、浏览器执行或真实密钥采集。 - 2026-09-25 / M10:完成独立的 `docs/review/CODE_REVIEW_REPORT.md`,按 P1/P2/P3 整理 38 条(6/15/17);程序核对报告和本日志的 38 个 ID 一一对应。报告写明模拟验证与条件性结论的界限、已有防护、部署缓解、修复顺序与验收条件。全程只更新报告/日志文档,未修改业务代码;未使用真实凭据做验证。