管理后台微调

Author: SugarMGP

.gitignore

@@ -55,3 +55,5 @@ mcp.json
 /.codex-temp
 /node_modules
 /internal/web/assets/dist/
+/.superpowers
+/docs

README.md

@@ -26,7 +26,7 @@
 - 📖 **持续学习** — 主动学习群内黑话/梗和独特的表达方式，融入群文化
 - ⏰ **时段策略** — 可配置不同时间段的发言活跃度
 - 🔌 **MCP 扩展** — 支持通过 MCP 协议接入外部工具，无限扩展能力
-- 🖥️ **管理后台** — 提供登录保护的后台界面，可查看总览、审核学习结果、管理表情包与记忆、浏览消息和群友画像
+- 🖥️ **管理后台** — 提供登录保护的后台界面，可查看总览、审核学习结果、管理记忆与表情包、浏览群友画像和系统摘要
 - 📊 **监控接口** — 提供健康检查与状态接口，方便接入部署和运维流程
 
 ## 🚀 快速开始

docs/superpowers/specs/2026-04-02-admin-summary-refresh-design.md

@@ -0,0 +1,210 @@
+# 后台摘要化改版设计
+
+## 背景
+
+当前后台存在以下问题：
+
+- 首页承担了过多跳转和审核入口职责，不符合“监视数据 + 清理少量垃圾数据”的主要使用目的。
+- 首页运行概览区域留白过大，信息密度失衡。
+- “消息”页面不适合后台管理场景，数据量大且噪声高。
+- 风格卡片页面存在重复字段和折叠结构，阅读成本高。
+- 系统页中的长文本字段挤压严重，尤其是“说话风格”。
+- 多个列表页缺少显式排序入口，用户难以理解当前呈现顺序。
+- 全站字号偏大，卡片与文字比例不协调。
+
+## 目标
+
+- 将首页重构为“摘要优先”的静态监视页，不再承担审核入口职责。
+- 从后台中移除“消息”页面相关的展示入口，但保留底层数据采集与存储。
+- 为五个核心列表页提供统一、明确的排序切换能力。
+- 重整风格卡片的信息层级，移除重复和折叠。
+- 修复系统页长文本显示问题，并整体下调后台字号层级。
+
+## 非目标
+
+- 不改动消息日志的数据表、写入逻辑和业务采集流程。
+- 不新增新的审核流程或首页快捷处理能力。
+- 不进行大规模组件抽象或视觉风格重做。
+- 不调整后台整体导航结构，继续以侧边栏为唯一主要导航方式。
+
+## 方案概览
+
+本次采用“**一致性重整**”路线：
+
+- 保留现有后台页面框架和视觉语言。
+- 统一整理首页摘要、列表页工具条、风格卡片信息层级和系统页文本展示。
+- 以最少的结构性改动解决用户感知最强的问题，避免演变为重构项目。
+
+## 设计细节
+
+### 1. 首页改为摘要优先
+
+首页不再放四个大跳转卡片，也不突出审核任务。页面结构调整为：
+
+1. 页头：保留标题和一句简短说明，字号较现状下调一档。
+2. 第一组摘要：运行状态
+   - 连接状态
+   - 学习状态
+   - 启用群数
+   - 扩展工具数
+3. 第二组摘要：数据规模
+   - 记忆数
+   - 成员数
+   - 表情包数
+   - 风格卡片数
+4. 可选的辅助统计：如果保留待审黑话或候选风格卡片，也仅作为弱化的小统计块出现，不进入首页主视觉区。
+5. 移除首页中的“消息数”展示，与消息页移除策略保持一致。
+
+结果是首页更像监视面板，而不是任务分发页。
+
+### 2. 消息页按 B 级移除
+
+“消息”页面按用户选定的 B 方案处理：
+
+- 从侧边栏导航中移除“消息”入口。
+- 从后台路由中移除消息页展示入口。
+- 从首页和其他后台概览中移除消息相关展示。
+- 保留底层消息日志数据表、写入逻辑和业务采集，不改数据库模型，不改采集流程。
+
+### 3. 五个列表页统一排序工具条
+
+排序功能只补到以下页面：
+
+- 记忆
+- 表情包
+- 风格卡片
+- 黑话
+- 成员
+
+交互统一规则：
+
+- 排序入口位于“筛选条件”下方、列表内容上方。
+- 工具条拆分为两个维度：
+  - 排序方式
+  - 顺序（正序 / 倒序）
+- 当前排序方式必须高亮，明确告诉用户当前顺序不是随机的。
+
+默认排序按页面语义设置：
+
+- 记忆：最近更新倒序
+- 黑话：最近更新倒序
+- 风格卡片：最近更新倒序
+- 表情包：使用次数倒序
+- 成员：发言数或活跃度倒序
+
+实现层面不做过度抽象，采用各列表页明确接收 `sort` / `order` 参数的方式，便于维护和后续扩展。
+
+### 4. 风格卡片改为完整平铺
+
+风格卡片页不再保留折叠区，信息直接平铺展示。
+
+结构调整如下：
+
+- 去掉卡片左上角独立的“示例回复”文字标题。
+- 删除“查看更多”折叠区。
+- 删除折叠区中的重复“示例”字段。
+- 调整信息顺序为：
+  1. 主示例内容
+  2. 触发场景
+  3. 避免规则
+  4. 来源片段
+  5. 辅助标签（意图、语气、证据、使用次数、上次使用）
+- 来源片段和长文本直接换行展示，不再通过折叠隐藏。
+- 操作区缩小一档，作为辅助区域，不与主内容争夺视觉中心。
+
+这样用户无需展开即可判断一张风格卡片是否值得处理。
+
+### 5. 系统页长文本优化
+
+系统页继续保留当前的分组结构，但统一优化长文本显示规则：
+
+- 所有字段值都支持自然换行。
+- “人格设定”中的“说话风格”按换行符展示，并使用正常字重、较高行高。
+- `别名`、`启用群列表`、`来源片段` 等长文本字段统一采用同一规则，避免显示不一致。
+- 长文本字段不再采用过重字重，以减少压迫感。
+
+### 6. 全站字号微调
+
+不是简单全局缩放，而是按层级收一档：
+
+- 页面主标题缩小。
+- 卡片标题缩小。
+- 正文和标签同步缩小。
+- 大数字指标保留醒目，但不再夸张。
+- 保持原有圆角、间距和玻璃质感风格，只微调文字与卡片比例。
+
+目标是让后台更协调，不出现“文字压过布局”的问题。
+
+## 受影响模块
+
+### 视图模板
+
+- `internal/web/views/dashboard.templ`
+- `internal/web/views/layout.templ`
+- `internal/web/views/data.templ`
+- `internal/web/views/review.templ`
+- `internal/web/views/system.templ`
+- `internal/web/views/helpers.go`
+- `internal/web/views/models.go`
+
+### 路由与页面装配
+
+- `internal/web/app/app.go`
+
+### 后台查询服务
+
+- `internal/web/services/admin_service.go`
+
+### 前端样式与交互
+
+- `internal/web/assets/src/admin.css`
+- `internal/web/assets/src/admin.js`
+
+## 数据与接口变化
+
+- 后台列表页新增查询参数：
+  - `sort`
+  - `order`
+- 消息页展示路由会从后台移除，但不影响后端消息存储。
+- 现有删除、审核等操作接口保持不变。
+
+## 验证策略
+
+### 模板与构建
+
+- 修改 `.templ` 后运行 `templ generate ./internal/web/views`
+- 修改前端资源或 Tailwind 类后运行 `npm run build`
+
+### 自动化验证
+
+- 为列表页排序和布局约束补充视图层或服务层测试。
+- 确保消息页移除后后台路由与导航不再暴露入口。
+
+### 页面验证
+
+按 AGENTS 约束，涉及后台 UI 的改动交付前必须做真实页面验证，优先使用 Chrome DevTools MCP 检查：
+
+- 首页摘要结构和留白
+- 五个列表页排序工具条的显示和切换
+- 风格卡片平铺信息后的阅读顺序
+- 系统页“说话风格”等长文本换行效果
+- 控制台错误与异常网络请求
+
+## 风险与应对
+
+- 排序参数增加后，若不同页面可选字段不一致，容易出现文案与真实排序不匹配。
+  - 应对：每个页面明确定义允许的排序字段，不做隐式通配。
+- 首页删除跳转卡片后，若摘要层级处理不好，可能变得过于平。
+  - 应对：通过两组摘要卡的层级和数字权重保留信息主次。
+- 风格卡片平铺后，长来源片段可能拉高卡片高度。
+  - 应对：通过更浅的文本层级、行高和容器背景降低视觉噪声，但不折叠。
+
+## 结论
+
+本次改版的核心是让后台回到“监视数据 + 处理少量异常内容”的角色定位：
+
+- 首页负责摘要，不负责分发任务。
+- 审核留在具体列表页中完成。
+- 列表页通过统一排序工具条建立清晰顺序感。
+- 风格卡片和系统页优先解决阅读负担。
+- 整体字号和层级做轻量修正，提升长期使用体验。