Files

66 lines
7.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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:
```powershell
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 沿原功能用于导入。