astrbot_plugin_private_comp.../docs/Q8前端改造与验收记录.md

3.1 KiB

Q8 前端改造与验收记录

  • 日期:2026-07-25
  • 分支:ops-main
  • 范围:运维版陪伴插件前端,不修改普通陪伴分支。

本轮目标

Q8 把 Q7 已冻结的只读接口接入页面,重点解决三件事:

  1. 现实时间、当前时间段和下一项日程要能直接看懂。
  2. 计划、实际活动和对账数量分开显示,不能把计划当成事实。
  3. Bot 自有空间、用户记忆和记忆插件边界必须在页面上明确分开。

已完成

  • 新增“运维”页签和“运维中枢”页面。
  • 接入只读接口:/bot-self/summary、/bot-self/timeline、/agenda/reconciliation、/bot-self/persona、/memory-boundary/status。
  • 新增现实时间、时区、当前活动、下一项日程、计划/实际/已对账指标。
  • 新增计划状态标签:计划中、进行中、已完成、部分完成、已延期、已取消、待确认。
  • 新增 Bot 自有空间只读摘要和自我时间线。
  • 新增记忆边界卡片,明确“用户记忆仅保存用户数据”和“Bot 数据不会外写”。
  • 总览页移除新闻、主动搜索卡片,改为关系/运行记录和数据边界卡片。
  • 页面不再加载每日穿搭预览脚本;每日穿搭配置在 OPS 前端能力列表中隐藏,但后端旧字段保留兼容。
  • 新增独立样式文件 pages/陪伴面板/css/q8-ops.css,包含响应式布局、状态色和只读信息层级。

设计边界

  • 页面只读展示 Bot 自有数据,不提供任意修改底层 JSON/SQLite 的入口。
  • 记忆边界使用白话文,不把 bot_self_store 当作用户记忆。
  • 旧娱乐功能不恢复,不在 Q8 前端新增 QQ 空间、B 站、新闻、网页搜索、饭点娱乐入口。
  • 接口单项失败时页面显示“部分可用”,不会把失败误报为数据为空。

验证

  • node --check pages/陪伴面板/app.js:通过。
  • git diff --check:通过。
  • 页面结构包含 data-tab=ops、panel-ops 和 Q8 样式入口。
  • 旧新闻/搜索 DOM 卡片和每日穿搭脚本入口已移除。
  • 尚未进行浏览器实机截图验收;下一步应在 AstrBot 拓展页打开页面,检查真实桥接接口返回和移动端折叠效果。

VM 部署验收

  • 本地验收日期:2026-07-25。
  • VM 日志时间:2026-07-26 02:59(VM 与工作站存在日期/时钟差异,按日志原样记录)。
  • Git 提交:a4af895 feat: add ops companion frontend center。
  • 活动插件:/var/lib/astrbot/data/plugins/astrbot_plugin_private_companion_ops。
  • 部署备份:/var/backups/astrbot-plugin-private-companion/20260725T185936Z。
  • AstrBot 服务:active (running)。
  • NRestarts:0。
  • 运维陪伴插件 5.10.4-ops.1 正常加载。
  • 运维记忆插件 1.6.2-ops.2 正常加载,数据目录未改动。
  • Q8 页面 index.html、app.js、q8-ops.css 均存在,插件目录权限为 root:root,目录 0755,文件 0644。
  • 日志未发现新的 Traceback、ModuleNotFoundError、ImportError 或 previous-* 备份目录导入错误。
  • 前端真实拓展页点击和截图验收仍建议由用户打开 AstrBot 页面后执行;本次已完成服务级和资源级验收。