4.3 KiB
交互与状态质量优化
Workflow Gate Report：P10，当前代码与实际流程具备输入/API 契约，允许优化。范围：请求取消、搜索防抖、配置编辑草稿保护、页面间状态隔离；验收：构建、浏览器回归以及多行输入/离开草稿验证。
Maintainability Gate Report：扫描 useQuery、Settings、App 与 Findings；风险 medium（跨页面状态，但模块规模适中）；允许 narrow_fix 与共享 hook 提取。不扩大现有模块职责，使用可复用 hook；不更改扫描行为。
发现：列表 textarea 每次输入都会移除空行，导致用户无法自然连续输入多行；扫描/系统页共用组件状态；加载请求未取消；刷新与页面切换缺少草稿保护。修复以上可复现交互问题，并保留敏感输入仅存在页面内存。
弹窗与审计切片
Workflow Gate：P10；现有 API 与页面齐全，允许窄范围扩展。统一使用原生 dialog（焦点限制、背景不可交互、Esc、关闭后恢复焦点），审计增加服务端搜索与操作类型过滤、准确总数及中文动作名称。验收包含键盘弹窗流程和审计过滤测试。
配置并发与数据库迁移
Workflow Gate：后端安全与维护迭代，配置契约新增 revision，前后端同时更新；保存需要读取页面版本，过期版本返回 409，保留草稿并给出显式重新加载入口。Maintainability Gate：store.go 混合 schema、配置与查询；先抽出 migrations.go/settings.go，采用 feature_after_refactor。验收：旧 schema 升级、较新 schema 拒绝、两份配置并发冲突、UI 回归。
管理页视觉重构
用户截图指出长表单、大片空白与缺少层级。实施范围：扫描/系统设置的分组卡片、侧边说明、固定保存区；成员统计与列表、新增成员弹窗。依赖已有设置/用户 API，保留字段标签、敏感输入规则、草稿保护与权限逻辑。验收须检查桌面及手机实际渲染截图，不以构建代替视觉验证。
证据按需加载
Workflow Gate：结果/概览数据量优化；明确新增 GET /api/findings/:id，保持会话鉴权。列表从 SQLite 投影摘要，不读取请求/响应正文；详情单独读取完整脱敏证据，导出保留完整内容。共享查询 hook 支持关闭查询并按路径隔离结果。验收：摘要不含正文、详情可读取、分页与复核浏览器回归。
工作台导航持久化
Workflow Gate Report：P10；用户授权最佳实践优化，现有六页与权限契约齐全；当前内存导航导致刷新丢失页面、返回按钮无法工作。允许实现同源 hash 路由（#/overview 等），无需后端重写规则；未知页面回概览，只读用户不能呈现管理员页面。未保存草稿的侧栏、历史导航和退出均保留确认。 Maintainability Gate Report：App 混合认证与导航编排，约 130 行、medium；先把导航机制抽出共享 hook，再接入 App，允许 adapter_extraction。验收：刷新保留页面、浏览器返回/前进、拒绝离开保留草稿、只读直接地址回概览、正常登录与原流程回归。结果筛选仍为页内状态，此切片不扩大 API。
样式维护边界
Workflow Gate：P9/P10，已实现 UI 的维护整理，视觉/API 契约不变，允许实施。 Maintainability Gate Report：style.css 1590 行，混合全局、登录、布局、组件、各页与迭代覆写；high。需要先拆分再继续添加样式；允许 zero_behavior_refactor。按连续完整规则区段抽取，入口用 @import 严格保留原先顺序（含响应式覆盖），不重排选择器或改变值。验收：构建前后输出 CSS 字节一致、TypeScript/Vite 构建和完整浏览器流程。后续页面样式放对应文件，避免入口继续增长。
可触达依赖漏洞修复
Workflow Gate：P9，最终依赖扫描发现 x/text v0.25.0 的 GO-2026-5970、x/net v0.40.0 的 GO-2026-5026 与 GO-2026-4918，扫描报告有模型 HTTP 客户端调用链。依赖更新属于用户最佳实践优化范围，允许实施。Maintainability Gate：仅 go.mod/go.sum 依赖调整，low，允许 narrow_fix；先升级到官方修复版本 x/text v0.39.0、x/net v0.55.0 并按要求调整 Go 工具链，再验证竞态测试、构建、漏洞扫描和浏览器全流程。若有兼容问题，以真实结果继续修复。