[Feature] 自动刷新页面导致审查时的键入内容和框内进度滑动位置丢失

[KiWinger]

Problem Statement

正常于“审查”页面操作时，自动更新页面：
会刷掉刚刚输入的内容（例如黑话编辑框）
也会刷掉滑动进度条的位置到最上（例如人格审查对比框）

Proposed Solution

当前聚焦位置的内容不更新，其他位置可更新。
或者编辑、查看时异步不更新，等待用户操作完成后执行一次更新。
ps：其实如果单独做个审查页面就好了，这部分等我白天仔细讲讲。

Alternatives Considered

No response

Feature Scope

WebUI (管理后台)

Additional Context

No response

[github-actions]

🤖 Issue 审查报告

优先级: 🟡 medium

📋 用户处理意见

问题摘要: WebUI 的“审查”相关页面存在自动刷新机制，导致用户正在输入/滚动查看时页面数据被重新渲染，从而清空输入框内容并把滚动位置重置到顶部。

问题分类: 代码问题

该问题需要开发者修复，请等待后续版本更新。

---

🔧 开发者修复建议（点击展开）

技术摘要: 当前 WebUI 审查页面采用周期性刷新/重载式更新，前端缺少“编辑中/聚焦中保护”与“滚动位置保持”，导致刷新时丢失未提交的 DOM 状态（textarea 值、scrollTop）。

相关模块: WebUI (管理后台), persona review, learning review

相关文件: webui/blueprints/persona_reviews.py, webui/services/persona_review_service.py, webui/services/learning_service.py, services/database/facades/learning_facade.py, services/database/sqlalchemy_database_manager.py, models/orm/learning.py

根因分析: 仓库中审查功能主要由 WebUI 后端接口提供（例如 webui/blueprints/persona_reviews.py 与 webui/services/persona_review_service.py），但前端模板/JS 不在本仓库文件树内；因此无法在现有代码里直接定位到具体的 setInterval/fetch+重绘实现。可以确定的是：后端接口返回的是整块 review 数据，前端若采用整体替换 HTML 或重新渲染列表，会天然导致输入框与滚动位置重置；且当前后端未提供 ETag/last_modified/版本号等增量更新辅助字段，前端只能“全量刷新”，更易触发该问题。

修复建议: 后端与前端需要配合实现“编辑保护 + 增量刷新”。

1. 后端：在审查列表/详情 API（位于 webui/blueprints/persona_reviews.py 调用 webui/services/persona_review_service.py 的相关接口）返回结构中加入稳定的版本字段（例如 review.updated_at / revision_id / content_hash），并支持 query 参数 since_version 或 If-None-Match(Etag) 以便前端轮询时仅在数据变化时更新；同时为列表接口提供“只返回变更项”的能力（按 updated_at 分页或 since）。
2. 前端：实现刷新抑制策略——当用户焦点位于黑话编辑框/审查编辑框（document.activeElement 为 input/textarea 或标记 data-no-refresh 区域）时暂停自动刷新；或将自动刷新改为仅更新非编辑区域（例如左侧列表数字、状态标签），避免替换编辑区域 DOM。
3. 前端：在必要的局部重绘前，缓存并恢复 scrollTop（人格审查对比框容器元素），以及 textarea/value（未提交草稿）；更推荐以状态管理方式保存草稿（localStorage/sessionStorage 或内存 store）。
4. 若目前的实现是“整页 reload”，建议改为 fetch JSON + patch DOM（Diff 更新）或 WebSocket/SSE 推送更新，彻底避免重载。

需要修改的后端位置（用于支持增量/缓存语义）：

• webui/blueprints/persona_reviews.py：对应审查数据获取路由处，增加 etag/last_modified 响应头或 since 参数处理。
• webui/services/persona_review_service.py：生成审查预览/列表数据时，补充 updated_at/hash 字段，并提供按时间/版本过滤的查询方法（如果当前通过 learning_facade/persona_facade 拉取数据，则把过滤下推到 facade/仓储层）。
• （可能涉及）services/database/facades/learning_facade.py：若审查数据来自 learning 表记录，可添加按 updated_at 查询接口，避免每次全量扫描。

---

_{🤖 此报告由 AI 自动生成，已分析仓库源码，仅供参考。开发者会尽快审阅您的 issue。}

[EterUltimate]

已在 Dev 分支 commit 65e4405 做最小稳健修复。

证据：

• web_res/static/html/dashboard.html 新增 shouldDeferAutoRefresh() / autoRefreshDashboard() / scheduleAutoRefresh()。
• 自动刷新在审查页、黑话页、输入/textarea/select/contenteditable 聚焦、确认弹窗打开、文本选中时会延后，不会全量重绘打断当前编辑或查看。
• 手动刷新仍可立即触发。
• tests/integration/test_webui_static_assets.py::test_dashboard_auto_refresh_defers_during_review_editing 覆盖该保护。

验证：相关 WebUI 静态测试和独立 WebUI 脚本语法检查通过。