Files
myrzx_bot/ranch_web/FRONTEND_REPORT.md
T

7.4 KiB
Raw Blame History

Web 前端交接

状态:实现与针对性浏览器检查完成,frontend owner freeze。无 commit / push;未修改其他 owner 的 Python 文件。现有桌面 GUI 是结构与语义依据,未导入 Qt,未增加构建或网络字体依赖。

文件

  • static/index.html:菜单、账号页签、玩家工具栏、15 页导航、可调日志与管理登录入口。
  • static/app.js:同源 API 接线、账号隔离、队列任务轮询、debounce 自动保存、修订冲突保留输入、开始/即时停止、菜单与手动操作、导入导出、更新面板、日志懒加载详情。
  • static/api.js:公共 REST 客户端;JSON query 与同源 cookie;无凭据持久化。
  • static/pages.js:原页面顺序和名称、登录/区服/恢复、schema 表单、子页、过滤、地图/牧场分组、统计地区→关卡→难度树、真实 DTO SVG 图表。
  • static/forms.js:原生控件、编号/数量编辑、添加无库存蛋规则;聚焦输入不被轮询重建。
  • static/table.js:稳定行/单元格节点、排序/选择/上下文菜单、逐行 edit path、目标勾选、完整探险三人队伍草稿;地图按展开懒建表格。
  • static/dom.js、static/ui.js:纯文本 DOM、安全 CSV、下载、对话框、浮层和文件选择。
  • static/styles.css:浅色紧凑工作台、1280/1600/窄屏滚动布局、原生焦点/状态、无 inline-style 依赖。
  • PRODUCT.md / DESIGN.md:按 explicit brief 写入,标明技术默认假设。
  • tests/browser/test_workbench_browser.py:13 个可重复运行的 Python Playwright 检查;系统 Edge 或 RANCH_WEB_BROWSER,不下载浏览器。

已对齐的接口

  • 读取实际 views.py / analysis/WEB_V2_PARITY.md,未修改其 schema。逐行以 columns[].edit + rows[].edits 合并定义;{id} 展开后使用同一个 config path。
  • 首次编辑把 row.rule_defaults 按字段作为“仅当缺失时补齐”记录,用户实际修改独立记录;修订冲突重读时默认字段不能覆盖另一个浏览器已有的值。牧场目标写整数优先级,取消删除键,勾选状态只读取配置当前路径,不回退到过期 DTO。蛋 keep_count 显示“牧场保留”。新增规则使用 field.defaults_by_id[typeId] 的完整规则和市场,保留通用 defaults fallback。
  • 探险队员只写 [](自动)或完整三人 ID 数组;1/2 人在浏览器保留草稿,重复或等级不合规则不提交。自动按钮清空手动配置,由原核心选人。
  • set_config 返回 pending/job_id/job 时先轮询任务,再更新 applied revision;保留保存期间新增的输入。409 合并保留本机修改字段,提示手动重试。停止绕过配置等待。
  • 主线默认 category=mainline,state=current。统计使用 stage_id/level/source/metric;chart.series 直接绘制,rate 为 0–1,固定 0–100% 刻度,无样本不补数。
  • 调试摘要只展示 message;有 details_available 的条目点击后 GET /api/accounts/{id}/debug/{entry_id},JSON 用 textContent 展示。兼容同源 detail_url。日志时间显示 Asia/Shanghai 的 HH:mm:ss,原完整时间保留在 title。
  • 扩建先取 quote_expansion,二次确认后只发 {quote_id,confirm:true}。批量派遣/喂养传 monster_ids、target_id 和显式 confirm。
  • 策略导入导出处理 HTTP 202 job。收益导入 filename+content_base64,支持 CSV/XLSX;下载 CSV 使用原导入器识别的“编号 / 派遣金币 / 强化经验 / 孵化秒数”列,可往返导入。
  • 绿色史莱姆预设使用 DTO details.preset.patch/egg_rules,点击即应用并保存,不额外确认、不开启运行。按所属子页展示 details.feed_status/last_draw,赠礼展示 next_ready_at。每体力数量在图表、tooltip 和表格保留六位有效数字,0.001 不显示为 0。
  • 更新弹窗每 3 秒 GET 公开状态,单次请求有超时且不重叠;关闭时清理定时器并取消请求。临时断连会核对 health 并重试;所有状态使用中文,仅服务端回报 succeeded 才显示完成,同时显示安全的宿主机回报。前端不操作 host 目录。

验证

真实临时 WebManager + ASGI + 系统 Edge headless:

python -m unittest ranch_web.tests.browser.test_workbench_browser -v

最终同一次完整运行:Ran 13 tests in 71.863s — OK。服务使用最新 API 进程,13 个用例均通过:

  1. 15 页全载入;切换只 GET,不提交动作/配置;1280、1600、390 宽可操作,页面无额外横向溢出;浏览器 JS / CSP error 为 0。真实 HTTP 的孵蛋三个子页与主线“任务状态 / 推进策略”均验证。
  2. 逐蛋规则补齐默认值并保存;轮询后节点与焦点不变;账号配置隔离;开启/停止成功。
  3. 探险半成品不 PUT,三人完整后才保存;自动清空;恶意 HTML 名称为纯文本。
  4. 统计地区/关卡默认收起,按展开建难度按钮;切换来源请求匹配,50%→25% 文案及柱宽同步。
  5. 调试摘要轮询不取详情,点击后只请求对应脱敏 JSON。
  6. fake 登录返回区服,密码提交后清空,不进 localStorage / sessionStorage / URL。
  7. 策略/收益下载,收益 CSV 被原 Catalog 导入器读回;报价取消无扩建,确认后真实离线扩建。
  8. 喂养、赠礼、突破三个目标取消后立即保持未勾选,配置键删除,过期 DTO 不会复勾。
  9. 新增无库存蛋使用真实 HTTP DTO 的逐 species 默认规则,市场非空且回显匹配。
  10. 两个浏览器页签并发编辑,真实 409 后重试:A 勾选,保留 B 新设的难度2 / 上限5,不回退为默认1 / 3。
  11. 0.001 每点体力收益在 SVG 标签、tooltip、表格与表格 tooltip 均正确显示。
  12. 喂养/抽蛋/下次赠礼状态可见;预设无确认弹窗,保存后运行保持关闭。
  13. fake 更新 pending→applying→服务503→succeeded,弹窗轮询自动恢复并显示中文宿主机状态;关闭后停止 GET。409/503 是用例明确注入的预期 HTTP 报告,不是 JS/CSP 错误。

所有七个 ES modules 经 node --check;无 innerHTML、浏览器持久存储、CDN、inline style attribute。测试全过程只 temporary + fake / 明确 demo,未测试真实游戏登录/API,未读取或修改私人账户。

Main 复核与验证边界

Main 已独立检查离线演示的背包/孵蛋截图及浏览器 JS/CSP 状态。截图写入 %TEMP%/ranch-web-render-*/,不把本机账号路径、临时服务地址或进程号写入公共仓库。后续树懒加载与图表刻度修正以浏览器测试断言为准。

Main 已运行 Impeccable detector。summary-line / dialog 的紧凑间距与 #172a40 阴影提示已对照真实浅色截图审核;前者遵循明确的紧凑工作台需求,dialog 子元素已有 padding,阴影不是暗色发光界面。按 brief 例外保留,不扩大布局。

最终清理:已核验启动命令确属 frontend 的独立临时离线演示,随后停止该进程,并确认进程与监听均已释放。最终源码 freeze,未 commit / push。

验证边界:demo 原数据不包含已建立探险队或实测掉落;对应丰富状态由显式路由 fixture 验证。实际游戏登录/区服/领奖与 Linux host updater 的真实运行留给用户授权后的环境验证;前端不宣称这些已在线成功。收益下载为可往返导入的 CSV,XLSX 沿原功能用于导入。