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