feat(admin-frontend): 新增系统与订阅管理后台页面

扩展管理端侧边栏与路由，新增系统配置真实页面、订阅套餐
管理页、节点管理页及多个结构化占位页

补齐前端 API、类型与工具层，并增强仪表盘刷新、趋势切换、
失败作业详情与流量排行 limit 联动能力

同步后端 traffic rank limit 支持与知识库归档、设计约束、
验证配置及视觉验收产物

.helloagents/archive/2026-04/202604231515_admin-frontend-dashboard-refresh-button/.status.json

@@ -0,0 +1,11 @@
+{
+  "status": "completed",
+  "completed": 4,
+  "failed": 0,
+  "pending": 0,
+  "total": 4,
+  "done": 4,
+  "percent": 100,
+  "current": "Dashboard 全量刷新按钮实现、验证与知识库同步完成，待归档",
+  "updated_at": "2026-04-23 15:43:00"
+}

.helloagents/archive/2026-04/202604231515_admin-frontend-dashboard-refresh-button/contract.json

@@ -0,0 +1,44 @@
+{
+  "version": 1,
+  "source": "~auto",
+  "originCommand": "auto",
+  "verifyMode": "test-first",
+  "reviewerFocus": [],
+  "testerFocus": [
+    "Hero 区刷新按钮是否触发整页数据刷新",
+    "刷新中是否有明确状态反馈并阻止重复点击",
+    "Dashboard 页面构建后是否保持现有 Apple 风格层级"
+  ],
+  "ui": {
+    "required": true,
+    "designContract": true,
+    "sourcePriority": [
+      "proposal.md",
+      ".helloagents/DESIGN.md",
+      "hello-ui"
+    ],
+    "styleAdvisor": {
+      "required": false,
+      "reason": "",
+      "focus": []
+    },
+    "visualValidation": {
+      "required": true,
+      "reason": "本轮为 Dashboard 顶部新增显式操作按钮，需要确认视觉风格与交互状态一致。",
+      "screens": [
+        "dashboard desktop",
+        "dashboard mobile"
+      ],
+      "states": [
+        "refresh idle",
+        "refresh loading"
+      ]
+    }
+  },
+  "advisor": {
+    "required": false,
+    "reason": "",
+    "focus": [],
+    "preferredSources": []
+  }
+}

.helloagents/archive/2026-04/202604231515_admin-frontend-dashboard-refresh-button/proposal.md

@@ -0,0 +1,92 @@
+# 变更提案: admin-frontend-dashboard-refresh-button
+
+## 元信息
+```yaml
+类型: 增强
+方案类型: implementation
+优先级: P2
+状态: 已完成
+创建: 2026-04-23
+```
+
+---
+
+## 1. 需求
+
+### 背景
+当前 `admin-frontend` 仪表盘已经具备总览、趋势、排行与系统状态的数据拉取能力，但缺少一个显式、统一的“全量刷新”入口。用户希望在 `http://localhost:5173/assets/admin/#/dashboard` 对应的首页，基于 `apple/DESIGN.md` 的 Apple 风格，为整页数据增加刷新按钮。
+
+### 目标
+- 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中增加一个整页全量刷新按钮。
+- 刷新动作需要覆盖统计卡、收入趋势、节点/用户排行、系统与队列状态。
+- 刷新按钮的视觉语言需延续当前 Apple 风格，不引入额外的重装饰。
+
+### 约束条件
+```yaml
+技术约束:
+  - 保持现有 Vue3 + TypeScript + Vite + Element Plus 栈
+  - 复用现有 refreshDashboard 数据流，不重复造接口层逻辑
+UI约束:
+  - 以 apple/DESIGN.md 为设计基线
+  - 使用单一蓝色强调与黑色 Hero 区的克制表达
+行为约束:
+  - 刷新时需有明确加载反馈
+  - 刷新中避免重复点击触发并发请求
+```
+
+### 验收标准
+- [√] Hero 区新增“刷新全部数据”入口，桌面和移动端都可正常使用。
+- [√] 点击后会统一刷新总览、趋势、排行和系统状态。
+- [√] 刷新中有可见状态反馈，并阻止重复触发。
+- [√] `admin-frontend` 构建通过。
+- [√] 本地页面完成一次视觉验收，确认按钮与 Apple 风格一致。
+
+---
+
+## 2. 方案
+
+### 技术方案
+1. 在仪表盘 Hero 右侧状态区加入全量刷新按钮，作为当前页面最直接的系统操作入口。
+2. 复用现有 `refreshDashboard()` 逻辑，对其补充成功提示、最后刷新时间记录与手动触发入口。
+3. 为按钮增加刷新中状态、旋转图标、禁用交互和辅助文案，保证状态完整。
+4. 保持当前卡片、趋势图与系统面板的数据结构不变，只增强顶部操作层。
+
+### 影响范围
+```yaml
+涉及模块:
+  - admin-frontend/src/views/dashboard/DashboardView.vue
+  - .helloagents/CHANGELOG.md
+  - .helloagents/modules/admin-frontend.md
+预计变更文件: 3
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| Hero 区新增操作后破坏原有视觉平衡 | 中 | 采用胶囊按钮、弱对比边框和状态副文案，保持 Apple 风格节奏 |
+| 刷新逻辑重复触发导致请求堆叠 | 中 | 刷新中禁用按钮，并复用现有 loading 状态 |
+| 用户中途要求停止 playwright-cli，运行态截图验收受限 | 中 | 改为构建验证 + 结构化代码视觉自检，并记录为本轮视觉验收证据 |
+
+---
+
+## 3. 核心场景
+
+### 场景: 管理员手动刷新仪表盘
+**模块**: DashboardView
+**条件**: 管理员已进入 `/dashboard`
+**行为**: 点击 Hero 区“刷新全部数据”按钮
+**结果**: 页面统一刷新统计卡、趋势、排行和系统状态，并反馈最新同步状态
+
+---
+
+## 4. 技术决策
+
+### admin-frontend-dashboard-refresh-button#D001: 刷新入口放在 Hero 状态区
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**理由**: Hero 区是仪表盘总控入口，能在不增加新卡片或工具栏负担的前提下，让刷新动作保持高可见性。
+
+### admin-frontend-dashboard-refresh-button#D002: 复用 refreshDashboard 作为唯一全量刷新入口
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**理由**: 当前页面已经通过 `refreshDashboard()` 聚合总览、趋势和排行的刷新逻辑，沿用该入口可避免逻辑分叉。

.helloagents/archive/2026-04/202604231515_admin-frontend-dashboard-refresh-button/tasks.md

@@ -0,0 +1,54 @@
+# 任务清单: admin-frontend-dashboard-refresh-button
+
+> **@status:** completed | 2026-04-23 15:43
+
+```yaml
+@feature: admin-frontend-dashboard-refresh-button
+@created: 2026-04-23
+@status: completed
+@mode: R3
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 4 | 0 | 0 | 4 |
+
+---
+
+## 任务列表
+
+### 1. 方案与范围
+
+- [√] 1.1 锁定刷新范围为整页全量刷新，并确认 Hero 区为按钮落点 | depends_on: []
+
+### 2. 仪表盘实现
+
+- [√] 2.1 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中增加 Hero 区全量刷新按钮与状态文案 | depends_on: [1.1]
+- [√] 2.2 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中补齐最后刷新时间、加载反馈与防重复触发逻辑 | depends_on: [2.1]
+
+### 3. 验证与同步
+
+- [√] 3.1 运行 `npm run build` 验证 `admin-frontend` 构建通过 | depends_on: [2.1,2.2]
+- [√] 3.2 完成本地视觉验收并同步知识库变更记录 | depends_on: [3.1]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-23 15:15 | 方案包初始化 | completed | 已锁定整页全量刷新范围与 Apple 风格约束 |
+| 2026-04-23 15:24 | 2.1 / 2.2 | completed | 已在 Hero 区加入全量刷新按钮、最后刷新时间与加载反馈 |
+| 2026-04-23 15:26 | 3.1 | completed | `npm run build` 通过 |
+| 2026-04-23 15:42 | 3.2 | completed | 按用户要求停止 playwright-cli，改用结构化代码视觉自检并完成知识库同步 |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 本轮只增强仪表盘顶部操作层，不改动后端接口契约和图表数据结构。
+- 运行态视觉验收原计划使用浏览器自动化，但用户中途明确要求“不再运行 playwright-cli”，因此改为基于构建结果和代码结构的视觉自检。

.helloagents/archive/2026-04/202604232313_admin-frontend-dashboard-trend-count-toggle/.status.json

@@ -0,0 +1,11 @@
+{
+  "status": "completed",
+  "completed": 4,
+  "failed": 0,
+  "pending": 0,
+  "total": 4,
+  "done": 4,
+  "percent": 100,
+  "current": "Dashboard 收入趋势金额/数量切换已完成，待归档",
+  "updated_at": "2026-04-23 23:20:00"
+}

.helloagents/archive/2026-04/202604232313_admin-frontend-dashboard-trend-count-toggle/proposal.md

@@ -0,0 +1,98 @@
+# 变更提案: admin-frontend-dashboard-trend-count-toggle
+
+## 元信息
+```yaml
+类型: 功能增强
+方案类型: implementation
+优先级: P1
+状态: 执行中
+创建: 2026-04-23
+```
+
+---
+
+## 1. 需求
+
+### 背景
+当前 `admin-frontend` 仪表盘的“收入趋势”模块仅支持按金额查看趋势线。用户希望在不破坏现有 Apple 风格页面结构的前提下，补充“按数量”视角，让管理员在同一图表区域中切换查看订单数量走势。
+
+### 目标
+- 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 的趋势面板中新增“金额 / 数量”切换。
+- 切换到“数量”后，图表 Y 轴、摘要卡片与最近记录同步以订单数量为主展示。
+- 保持 `apple/DESIGN.md` 的 Apple 风格约束：纯色分区、单一强调蓝、克制交互和低装饰噪音。
+
+### 约束条件
+```yaml
+范围约束: 仅调整 admin-frontend 仪表盘趋势模块及其图表工具逻辑
+视觉约束: 延续 Apple 风格，不引入双图、双线、多色复杂图例
+技术约束: 不新增图表库，继续复用现有 SVG 图表实现
+业务约束: 不修改后端接口，前端基于现有趋势返回字段实现切换
+```
+
+### 验收标准
+- [ ] 趋势面板新增“按金额 / 按数量”切换，默认保持“按金额”。
+- [ ] 切换到“按数量”时，图表线条、Y 轴标签、摘要卡片和最近记录与数量口径一致。
+- [ ] 视觉样式仍符合 `apple/DESIGN.md`，新增交互保持克制、清晰、可访问。
+- [ ] `admin-frontend` 构建通过，产物成功输出到 `public/assets/admin`。
+
+---
+
+## 2. 方案
+
+### 技术方案
+1. 在 `src/utils/dashboard.ts` 中把趋势图构建逻辑参数化，支持金额/数量两种指标，并根据口径生成对应的 Y 轴标签格式。
+2. 在 `src/views/dashboard/DashboardView.vue` 中新增趋势显示模式状态、切换按钮和摘要视图模型。
+3. 保持现有 `getOrderTrend` 接口调用方式，直接复用响应中的 `paid_total`、`paid_count`、`commission_total`、`commission_count` 等字段完成数量视图。
+
+### 影响范围
+```yaml
+涉及模块:
+  - admin-frontend/src/views/dashboard/DashboardView.vue
+  - admin-frontend/src/utils/dashboard.ts
+  - public/assets/admin (构建产物输出)
+预计变更文件: 2-4
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| 数量视图摘要语义不清 | 中 | 采用“成交订单 / 佣金订单 / 日均成交”三段式摘要，并保留金额作为辅助信息 |
+| 图表参数化后影响原金额模式 | 中 | 默认金额模式不变，并通过构建验证确保类型与模板连接正确 |
+| 子模块产物状态与根仓状态不同步 | 中 | 构建后同时检查根仓与 `public/assets/admin` 子模块状态 |
+
+---
+
+## 3. 成果设计
+
+### 设计方向
+- **美学基调**: 延续当前 Apple 风格的浅灰内容面板 + 单一蓝色交互重点。
+- **交互模式**: 在现有时间筛选旁新增一组低干扰 segmented pills，用于切换“按金额 / 按数量”。
+- **记忆点**: 同一张克制的趋势图，在不增加视觉负担的情况下完成经营口径切换。
+
+### 视觉要素
+- **配色**: 继续使用 `#0071e3` 作为唯一强调色；背景和卡片保持 `#ffffff / #f5f5f7 / #fbfbfd` 层次。
+- **排版**: 不新增标题层级，切换器作为次级控制区，与时间范围筛选并列。
+- **状态**: 激活态用浅蓝底 + 浅蓝边框，未激活态保持白底细边框。
+
+### 实施结果
+- 已在趋势面板头部增加独立的“按金额 / 按数量”切换分组。
+- 已将趋势图 SVG 构建逻辑扩展为双口径模式，数量模式下自动切换 Y 轴标签为“笔”。
+- 已将摘要卡片和最近记录改为跟随当前口径同步展示。
+
+---
+
+## 4. 技术决策
+
+### admin-frontend-dashboard-trend-count-toggle#D001: 采用单图切换而不是双图/双线
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 用户在确认环节明确选择“金额 / 数量切换”方案。
+**决策**: 在同一趋势图区域中，通过切换按钮切换图表口径和摘要信息。
+**理由**: 该方案最符合 Apple 风格的克制表达，同时不会显著增加页面密度。
+
+### admin-frontend-dashboard-trend-count-toggle#D002: 数量模式复用现有接口字段，不新增后端联调
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 现有趋势接口已返回 `paid_count` 和 `commission_count` 等字段。
+**决策**: 前端直接基于现有响应切换图表指标和摘要视图。
+**理由**: 可以在最小范围内完成需求，避免扩展后端接口或引入新请求。

.helloagents/archive/2026-04/202604232313_admin-frontend-dashboard-trend-count-toggle/tasks.md

@@ -0,0 +1,49 @@
+# 任务清单: admin-frontend-dashboard-trend-count-toggle
+
+> **@status:** completed | 2026-04-23 23:20
+
+```yaml
+@feature: admin-frontend-dashboard-trend-count-toggle
+@created: 2026-04-23
+@status: completed
+@mode: R2
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 4 | 0 | 0 | 4 |
+
+---
+
+## 任务列表
+
+### 1. 趋势图模式切换
+
+- [√] 1.1 在 `admin-frontend/src/utils/dashboard.ts` 中扩展趋势图构建逻辑，支持金额/数量双口径 | depends_on: []
+- [√] 1.2 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中加入“按金额 / 按数量”切换和对应摘要展示 | depends_on: [1.1]
+
+### 2. 验证与产物
+
+- [√] 2.1 运行 `admin-frontend` 构建验证，确认类型检查和 Vite 构建通过 | depends_on: [1.2]
+- [√] 2.2 复核根仓与 `public/assets/admin` 子模块状态，确保产物变更可见 | depends_on: [2.1]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-23 23:13 | 方案包初始化 | completed | 已确认采用“金额 / 数量切换”并进入实现 |
+| 2026-04-23 23:17 | 1.1 / 1.2 | completed | 已完成趋势图双口径切换、摘要卡片和最近记录联动 |
+| 2026-04-23 23:20 | 2.1 / 2.2 | completed | `npm run build` 通过，根仓与 `public/assets/admin` 子模块均检测到产物变更 |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 当前仓已有一个未完成的旧方案包 `202604210515_admin-frontend-ticket-management`，本轮不复用其模板内容，单独创建新方案包以避免混淆。
+- 由于 `public/assets/admin` 是独立子模块，构建后前端产物变更主要体现在子模块工作区；根仓继续显示 `m public/assets/admin` 属于正常现象。

.helloagents/archive/2026-04/202604232318_admin-frontend-rank-limit-scroll/.status.json

@@ -0,0 +1,11 @@
+{
+  "status": "completed",
+  "completed": 4,
+  "failed": 0,
+  "pending": 0,
+  "total": 4,
+  "done": 4,
+  "percent": 100,
+  "current": "排行面板 10/20 切换与滚动容器已完成，等待归档",
+  "updated_at": "2026-04-23 23:38:00"
+}

.helloagents/archive/2026-04/202604232318_admin-frontend-rank-limit-scroll/proposal.md

@@ -0,0 +1,92 @@
+# 变更提案: admin-frontend-rank-limit-scroll
+
+## 元信息
+```yaml
+类型: 功能增强
+方案类型: implementation
+优先级: P1
+状态: 已完成
+创建: 2026-04-23
+```
+
+---
+
+## 1. 需求
+
+### 背景
+当前 `admin-frontend` 仪表盘中的“节点流量排行”和“用户流量排行”都固定只显示前 6 条，列表区域也会随着内容高度自然撑开。用户希望在不破坏现有 Apple 风格基线的前提下，让两个排行面板都支持 `10 个 / 20 个` 显示切换，并将排行内容放进可滚动的展示区域，避免页面被长列表拉得过高。
+
+### 目标
+- 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 的两个流量排行面板中新增 `10 个 / 20 个` 显示数量切换。
+- 让节点排行和用户排行都支持独立控制显示数量，并在列表较长时使用固定高度滚动区域承载内容。
+- 延续 `apple/DESIGN.md` 的 Apple 风格：纯色分区、单一蓝色强调、低装饰噪音、清晰可访问的按钮状态。
+
+### 约束条件
+```yaml
+范围约束: 仅调整 admin-frontend 仪表盘排行面板的交互和样式，不改后端接口
+视觉约束: 保持 Apple 风格，不引入表格化重组件或高密度控制栏
+技术约束: 继续复用现有 Vue3 + TypeScript + Element Plus + 原生样式体系
+工作树约束: 保留当前未提交的趋势图口径切换改动，在其基础上完成本轮排行增强
+```
+
+### 验收标准
+- [ ] “节点流量排行”和“用户流量排行”均提供 `10 个 / 20 个` 数量切换。
+- [ ] 切换后列表展示条数与选择一致，且面板内容区域保持可滚动，不因为长列表破坏整体布局。
+- [ ] 新增交互仍符合 `apple/DESIGN.md` 的视觉基线，并具备可见焦点与明确激活态。
+- [ ] `admin-frontend` 构建通过，根仓与 `public/assets/admin` 子模块状态可见。
+
+---
+
+## 2. 方案
+
+### 技术方案
+1. 在 `DashboardView.vue` 中新增节点排行和用户排行各自的显示条数状态，并通过计算属性统一产出当前应渲染的列表。
+2. 在排行面板头部保留现有时间范围筛选，同时补充轻量级 segmented pills 作为 `10 / 20` 显示数量切换控件。
+3. 为排行列表增加固定高度滚动容器、轻量滚动条样式和面板内边距节奏，让 20 条模式下仍维持 Apple 风格的整洁感。
+
+### 影响范围
+```yaml
+涉及模块:
+  - admin-frontend/src/views/dashboard/DashboardView.vue
+  - public/assets/admin (构建产物输出)
+预计变更文件: 1-3
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| 排行面板头部控件过多导致拥挤 | 中 | 把时间筛选与数量筛选分成两组，保持同一视觉语言但明确主次 |
+| 滚动容器高度不合适影响信息密度 | 中 | 采用按 10/20 模式自适应的最大高度，同时在移动端回退为更紧凑布局 |
+| 当前工作树已有趋势图增强改动 | 中 | 在现有未提交改动上增量实现，并通过构建验证确认两项增强可同时成立 |
+
+---
+
+## 3. 成果设计
+
+### 设计方向
+- **美学基调**: 延续当前 Apple 风格浅色信息面板，让排行区域像可浏览的信息胶囊，而不是后台表格。
+- **交互模式**: 时间范围和显示数量都使用 pill 按钮；数量按钮作为次级控制，保持克制但清晰。
+- **记忆点**: 同一个排行面板中，长列表被收进柔和滚动视窗，滚动时仍保持整洁的白底与单一蓝色强调。
+
+### 视觉要素
+- **配色**: 沿用 `#0071e3` 作为唯一强调色，滚动容器背景继续使用 `#fbfbfd` / `#ffffff` 层次。
+- **排版**: 面板头部分成信息区与控件区，控件区按分组排列；列表内部继续保留名称、流量值、蓝色进度条和涨跌百分比。
+- **状态**: 激活态为浅蓝底 + 浅蓝边框；滚动条使用低对比灰蓝色，避免视觉噪音。
+
+---
+
+## 4. 技术决策
+
+### admin-frontend-rank-limit-scroll#D001: 两个排行面板独立控制显示数量
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 节点排行和用户排行虽然共享时间范围，但使用场景不同，用户可能需要分别查看不同数量。
+**决策**: 节点排行与用户排行分别维护自己的 `10 / 20` 数量切换状态。
+**理由**: 这样不会把两个排行耦合成单一控制，也更贴合面板级交互。
+
+### admin-frontend-rank-limit-scroll#D002: 使用固定高度滚动容器而不是整页自然拉伸
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 20 条排行如果完全展开，会让 dashboard 纵向长度显著增加，破坏当前首页节奏。
+**决策**: 在排行面板内引入滚动容器，并按 10/20 模式设置不同的最大高度。
+**理由**: 能在保留更多信息的同时维持 Apple 风格的页面节奏和阅读效率。

.helloagents/archive/2026-04/202604232318_admin-frontend-rank-limit-scroll/tasks.md

@@ -0,0 +1,49 @@
+# 任务清单: admin-frontend-rank-limit-scroll
+
+> **@status:** completed | 2026-04-23 23:38
+
+```yaml
+@feature: admin-frontend-rank-limit-scroll
+@created: 2026-04-23
+@status: completed
+@mode: R3
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 4 | 0 | 0 | 4 |
+
+---
+
+## 任务列表
+
+### 1. 排行交互增强
+
+- [√] 1.1 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中新增节点排行和用户排行的 `10 / 20` 显示数量状态与计算视图 | depends_on: []
+- [√] 1.2 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中为两个排行面板加入数量切换控件，并调整头部布局 | depends_on: [1.1]
+- [√] 1.3 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中加入滚动容器和 Apple 风格滚动条样式 | depends_on: [1.2]
+
+### 2. 验证与状态
+
+- [√] 2.1 运行 `admin-frontend` 构建验证，并确认根仓与 `public/assets/admin` 子模块状态 | depends_on: [1.3]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-23 23:18 | 方案包初始化 | completed | 已确认在 Apple 风格基线上为两个排行面板增加 10/20 切换和滚动容器 |
+| 2026-04-23 23:31 | 1.1 / 1.2 / 1.3 | completed | 已为两个排行面板补齐 10/20 切换、独立显示状态和滚动容器样式 |
+| 2026-04-23 23:37 | 2.1 | completed | `npm run build` 通过；浏览器直达 `/dashboard` 会因未提供管理员登录态跳转到 `/#/login?redirect=/dashboard` |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 当前工作树已存在一个未完成的趋势图口径切换方案包 `202604232313_admin-frontend-dashboard-trend-count-toggle`，本轮在保留其代码改动的前提下继续增强 dashboard 排行区域。
+- 本轮视觉联调受本地管理员登录态限制，已通过构建、代码级 UI 自检和浏览器路由快照完成兜底验证。

.helloagents/archive/2026-04/202604232320_admin-frontend-node-management/contract.json

@@ -0,0 +1,51 @@
+{
+  "updatedAt": "2026-04-23T15:23:18.713Z",
+  "version": 1,
+  "source": "~auto",
+  "originCommand": "plan",
+  "verifyMode": "review-first",
+  "reviewerFocus": [
+    "节点管理侧边栏分组是否清晰且与现有 Apple 风格后台一致",
+    "未实现的创建/排序能力是否被透明标注为后续接入"
+  ],
+  "testerFocus": [
+    "节点列表是否真实连接 /server/manage/getNodes 与 /server/group/fetch",
+    "搜索、类型筛选、权限组筛选与显隐切换是否存在真实数据流",
+    "节点相关新路由是否可以正常进入"
+  ],
+  "ui": {
+    "required": true,
+    "designContract": true,
+    "sourcePriority": [
+      "plan.md",
+      ".helloagents/DESIGN.md",
+      "hello-ui"
+    ],
+    "styleAdvisor": {
+      "required": false,
+      "reason": "",
+      "focus": []
+    },
+    "visualValidation": {
+      "required": true,
+      "reason": "节点管理属于整页新建后台视图，需要确认导航、列表密度与占位页结构在浏览器中符合 Apple 风格契约",
+      "screens": [
+        "#/nodes desktop",
+        "#/node-groups desktop",
+        "#/node-routes desktop"
+      ],
+      "states": [
+        "节点列表默认加载完成态",
+        "节点列表筛选结果态",
+        "权限组管理占位态",
+        "路由管理占位态"
+      ]
+    }
+  },
+  "advisor": {
+    "required": false,
+    "reason": "",
+    "focus": [],
+    "preferredSources": []
+  }
+}

.helloagents/archive/2026-04/202604232320_admin-frontend-node-management/plan.md

@@ -0,0 +1,54 @@
+# admin-frontend 节点管理首批交付 — 实施规划
+
+## 目标与范围
+- 为 `admin-frontend` 增加节点管理信息架构，并先交付“节点管理”主页面。
+- 页面目标不是一次性做完整节点中后台，而是先打通“可看、可筛、可切显隐、可做基础行级操作”的运营主链路。
+
+## 架构与实现策略
+- 在现有 `AdminLayout` 基础上新增“节点管理”二级分组，保持侧边栏结构统一。
+- 新增 `/nodes`、`/node-groups`、`/node-routes` 三个路由，其中 `/nodes` 为真实功能页，其余两页为明确占位页。
+- 节点列表页直接消费现有后端接口，不在前端猜测或重塑接口契约：
+  - `/server/manage/getNodes`
+  - `/server/group/fetch`
+  - `/server/manage/update`
+  - `/server/manage/copy`
+  - `/server/manage/drop`
+- 复杂的节点格式化逻辑（地址、状态、标签、筛选选项）下沉到 `utils/nodes.ts`，避免页面组件膨胀。
+
+## 完成定义
+- 侧边栏出现“节点管理”分组，且可以进入 3 个子入口。
+- `/nodes` 页面可真实拉取节点与权限组数据。
+- 用户可以通过搜索、节点类型和权限组筛选列表。
+- 用户可以切换节点显隐状态，并在界面中获得成功/失败反馈。
+- 用户可以通过更多菜单执行复制节点与删除节点；未覆盖的编辑/排序功能有明确边界提示。
+- 验证主路径：`review-first`
+- reviewer 关注边界：导航结构是否清晰、页面是否与 Apple 风格一致、未实现功能是否被透明标注。
+- tester 关注边界：构建是否通过、节点列表是否真实连接 API、筛选与显隐切换是否存在数据流。
+
+## 文件结构
+- `admin-frontend/src/router/index.ts`
+- `admin-frontend/src/layouts/AdminLayout.vue`
+- `admin-frontend/src/api/admin.ts`
+- `admin-frontend/src/types/api.d.ts`
+- `admin-frontend/src/utils/nodes.ts`（新增）
+- `admin-frontend/src/views/nodes/NodesView.vue`（新增）
+- `admin-frontend/src/views/nodes/NodeGroupsView.vue`（新增）
+- `admin-frontend/src/views/nodes/NodeRoutesView.vue`（新增）
+
+## UI / 设计约束
+- 节点管理首页保留黑色 hero + 白色表格壳层的 Apple 后台节奏。
+- 过滤器采用紧凑 pill / select 混合布局，优先满足快速运营判断。
+- 列表状态用圆点、标签和辅助文字三层表达，不只靠颜色。
+- 占位页不做空白页，而是交付可继续扩展的结构化提示页。
+
+## 风险与验证
+- 风险 1：后端节点字段可能存在空值或差异，页面要做健壮格式化。
+- 风险 2：节点显隐切换的字段是 `show`，前端需保持与布尔/整型兼容。
+- 风险 3：权限组接口若返回结构偏轻，前端需要容错处理。
+- 验证方式：
+  - `npm run build`
+  - 本地预览 + 浏览器检查 `/nodes`、`/node-groups`、`/node-routes`
+
+## 决策记录
+- [2026-04-23] 节点管理首批交付聚焦列表运营链路，不在本轮接入完整节点编辑表单，避免 UI 范围失控。
+- [2026-04-23] 权限组管理 / 路由管理先交付占位页，保证侧边栏信息架构先稳定下来。

.helloagents/archive/2026-04/202604232320_admin-frontend-node-management/requirements.md

@@ -0,0 +1,37 @@
+# admin-frontend 节点管理首批交付 — 需求
+
+确认后冻结，执行阶段不可修改。如需变更必须回到设计阶段重新确认。
+
+## 核心目标
+- 在 `admin-frontend` 中新增“节点管理”侧边栏分组。
+- 优先实现“节点管理”主页面，使管理者可以在 Apple 风格后台中查看、搜索、筛选和执行基础节点操作。
+- 页面视觉以 `apple/DESIGN.md` 为参考，并与现有 Apple 化仪表盘、用户管理、工单管理保持一致。
+
+## 功能边界
+- 必须新增节点管理分组，包含：节点管理、权限组管理、路由管理 3 个入口。
+- 必须实现“节点管理”列表页，覆盖：
+  - 节点列表拉取
+  - 关键字段展示（节点 ID、显隐、节点、地址、在线人数、倍率、权限组）
+  - 搜索
+  - 类型筛选
+  - 权限组筛选
+  - 显隐切换
+  - 行级更多操作菜单
+- 权限组管理、路由管理本轮只要求提供结构化占位页，为下一轮真实接入留入口。
+
+## 非目标
+- 本轮不实现完整的节点创建 / 编辑大表单。
+- 本轮不实现拖拽排序或完整排序编辑器。
+- 本轮不重做后端接口，不新增 Laravel 管理端 API。
+
+## 技术约束
+- 技术栈固定为 `Vue 3 + TypeScript + Vite + Element Plus`。
+- 后端真相源以现有 Laravel 管理接口为准，节点列表使用 `/server/manage/getNodes`。
+- 视觉契约优先级：本方案 > `.helloagents/DESIGN.md` > `apple/DESIGN.md` 的参考原则。
+- 构建验证使用 `admin-frontend/package.json` 中已有 `npm run build`。
+
+## 质量要求
+- 页面必须保持 Apple 风格的一致性和高密度运营后台可读性。
+- 异步列表必须覆盖加载、空和错误反馈。
+- 危险操作要有确认提示。
+- 最终至少完成一次构建验证与一次浏览器级视觉验收。

.helloagents/archive/2026-04/202604232320_admin-frontend-node-management/tasks.md

@@ -0,0 +1,13 @@
+# admin-frontend 节点管理首批交付 — 任务分解
+
+## 任务列表
+- [x] 任务1：补齐本轮 UI 契约与方案产物（涉及文件：`.helloagents/DESIGN.md`、`.helloagents/plans/202604232320_admin-frontend-node-management/*`；完成标准：存在可执行需求、方案、任务与合同文件；验证方式：文件检查）
+- [x] 任务2：扩展后台导航与路由结构（涉及文件：`admin-frontend/src/router/index.ts`、`admin-frontend/src/layouts/AdminLayout.vue`；完成标准：侧边栏出现节点管理分组并可进入 3 个子页面；验证方式：`npm run build` + 浏览器检查导航）
+- [x] 任务3：接入节点管理数据模型与 API（涉及文件：`admin-frontend/src/api/admin.ts`、`admin-frontend/src/types/api.d.ts`、`admin-frontend/src/utils/nodes.ts`；完成标准：前端可拉取节点与权限组并完成必要格式化；验证方式：`npm run build`）
+- [x] 任务4：实现节点管理主页面（涉及文件：`admin-frontend/src/views/nodes/NodesView.vue`；完成标准：节点列表具备搜索、筛选、显隐切换、复制/删除基础能力，并覆盖加载/空/错误状态；验证方式：`npm run build` + 浏览器检查 `/nodes`）
+- [x] 任务5：实现权限组 / 路由管理占位页（涉及文件：`admin-frontend/src/views/nodes/NodeGroupsView.vue`、`admin-frontend/src/views/nodes/NodeRoutesView.vue`；完成标准：可从侧边栏进入，页面明确说明下一阶段接入范围；验证方式：`npm run build` + 浏览器检查对应路由）
+- [x] 任务6：完成验证、视觉验收与知识库同步（涉及文件：`.helloagents/CHANGELOG.md`、`.helloagents/.ralph-visual.json`、`.helloagents/.ralph-closeout.json`；完成标准：构建通过、视觉检查完成、知识库记录本轮变更；验证方式：命令输出 + 证据文件）
+
+## 进度
+- [x] 已创建方案包并冻结首批交付范围。
+- [x] 已完成 admin-frontend 节点管理首批页面与知识库同步。

.helloagents/archive/2026-04/202604232329_admin-frontend-system-management/contract.json

@@ -0,0 +1,55 @@
+{
+  "updatedAt": "2026-04-23T15:35:17.621Z",
+  "version": 1,
+  "source": "~auto",
+  "originCommand": "plan",
+  "verifyMode": "review-first",
+  "reviewerFocus": [
+    "系统管理侧边栏分组是否清晰且与现有 Apple 风格后台一致",
+    "系统配置页的左侧分组导航与右侧长表单结构是否清晰可读",
+    "其余系统管理入口是否被透明标注为后续接入"
+  ],
+  "testerFocus": [
+    "系统管理新路由是否可以正常进入",
+    "系统配置页是否真实连接 /config/fetch 与 /config/save",
+    "保存反馈与辅助按钮是否存在真实数据流"
+  ],
+  "ui": {
+    "required": true,
+    "designContract": true,
+    "sourcePriority": [
+      "plan.md",
+      ".helloagents/DESIGN.md",
+      "hello-ui"
+    ],
+    "styleAdvisor": {
+      "required": false,
+      "reason": "",
+      "focus": []
+    },
+    "visualValidation": {
+      "required": true,
+      "reason": "系统管理属于整页新建后台视图，需要确认导航、系统配置长表单层级与占位页结构在浏览器中符合 Apple 风格契约",
+      "screens": [
+        "#/system/config desktop",
+        "#/system/plugins desktop",
+        "#/system/themes desktop",
+        "#/system/notices desktop",
+        "#/system/payments desktop",
+        "#/system/knowledge desktop"
+      ],
+      "states": [
+        "系统配置默认加载完成态",
+        "系统配置保存态",
+        "系统配置错误/重试态",
+        "系统模块占位态"
+      ]
+    }
+  },
+  "advisor": {
+    "required": false,
+    "reason": "",
+    "focus": [],
+    "preferredSources": []
+  }
+}

.helloagents/archive/2026-04/202604232329_admin-frontend-system-management/plan.md

@@ -0,0 +1,63 @@
+# admin-frontend 系统管理首批交付 — 实施规划
+
+## 目标与范围
+- 为 `admin-frontend` 增加“系统管理”信息架构，并先交付“系统配置”主页面。
+- 页面目标不是一次性做完整后台系统中心，而是先打通“可进入、可读取、可编辑、可保存”的配置主链路，同时把其余 5 个系统管理入口先稳定为可访问占位页。
+
+## 架构与实现策略
+- 在现有 `AdminLayout` 基础上新增“系统管理”二级分组，保持侧边栏结构统一。
+- 新增以下路由：
+  - `/system/config` 为真实功能页
+  - `/system/plugins`
+  - `/system/themes`
+  - `/system/notices`
+  - `/system/payments`
+  - `/system/knowledge`
+- 系统配置页直接消费现有后端接口，不在前端猜测或重塑接口契约：
+  - `/config/fetch`
+  - `/config/save`
+  - `/config/testSendMail`
+  - `/config/setTelegramWebhook`
+- 配置字段分组、控件元信息与序列化逻辑下沉到 `utils/systemConfig.ts`，避免页面组件膨胀。
+- 占位页使用统一的 `SystemPlaceholderView`，以一致的结构说明本轮范围与下一阶段扩展点。
+
+## 完成定义
+- 侧边栏出现“系统管理”分组，且可以进入 6 个子入口。
+- `/system/config` 页面可真实拉取配置数据，并按 9 个配置分组组织内容。
+- 用户可以修改并保存系统配置，保存后获得成功/失败反馈。
+- 邮件设置与 Telegram 设置保留辅助动作入口（测试邮件 / 设置 Webhook），但不在本轮额外扩展复杂工作流。
+- 其余 5 个系统管理子页可从侧边栏正常进入，并明确标注“下一阶段接入”。
+- 验证主路径：`review-first`
+- reviewer 关注边界：系统管理信息架构是否清晰、系统配置表单层级是否贴近 Apple 风格后台、占位页是否透明说明未实现范围。
+- tester 关注边界：菜单与路由是否真实连通、系统配置页是否真实连接 `/config/fetch` 与 `/config/save`、保存链路与辅助按钮是否存在真实数据流。
+
+## 文件结构
+- `admin-frontend/src/router/index.ts`
+- `admin-frontend/src/layouts/AdminLayout.vue`
+- `admin-frontend/src/api/admin.ts`
+- `admin-frontend/src/types/api.d.ts`
+- `admin-frontend/src/utils/systemConfig.ts`（新增）
+- `admin-frontend/src/views/system/SystemConfigView.vue`（新增）
+- `admin-frontend/src/views/system/SystemPlaceholderView.vue`（新增）
+- `.helloagents/DESIGN.md`
+
+## UI / 设计约束
+- 系统配置首页保留黑色 hero + 白色配置壳层的 Apple 后台节奏。
+- 左侧使用紧凑分组导航，右侧使用连续表单 section，优先满足“快速定位配置块”的后台效率诉求。
+- 页面首屏只保留一个主保存动作和少量辅助描述，不堆砌营销式视觉元素。
+- 占位页不做空白页，而是交付可继续扩展的结构化提示页。
+
+## 风险与验证
+- 风险 1：配置接口字段类型包含布尔、数值、数组和长文本，前端需要统一序列化与表单回填。
+- 风险 2：`/config/fetch` 返回分组对象，系统配置页必须避免直接把后端分组名暴露成低可读开发术语。
+- 风险 3：本地静态预览环境可能缺少 Laravel 注入或后台认证，浏览器验收要区分“结构验收”和“真实联调”边界。
+- 验证方式：
+  - `npm run build`
+  - 本地预览 + 浏览器检查 `#/system/config`
+  - 浏览器检查 `#/system/plugins`、`#/system/themes`、`#/system/notices`、`#/system/payments`、`#/system/knowledge`
+
+## 决策记录
+- [2026-04-23] 系统管理首批交付聚焦“系统配置真实页 + 其余入口占位页”，避免在一轮内同时展开多个 CRUD 模块。
+- [2026-04-23] “系统配置”保留左侧配置分组导航，优先满足后台场景中的长表单定位效率。
+- [2026-04-23] 前台主题相关配置不混入本轮系统配置页，而是留在“主题配置”入口的后续阶段实现。
+

.helloagents/archive/2026-04/202604232329_admin-frontend-system-management/requirements.md

@@ -0,0 +1,51 @@
+# admin-frontend 系统管理首批交付 — 需求
+
+确认后冻结，执行阶段不可修改。如需变更必须回到设计阶段重新确认。
+
+## 核心目标
+- 在 `admin-frontend` 中新增“系统管理”一级侧边栏分组。
+- 优先实现“系统配置”页面，并尽量贴近用户提供的目标结构：左侧分组导航 + 右侧长表单编辑区。
+- 页面视觉以 `apple/DESIGN.md` 为参考，并与现有 Apple 化仪表盘、用户管理、工单管理保持同一后台设计语言。
+
+## 功能边界
+- 必须新增系统管理分组，包含：
+  - 系统配置
+  - 插件管理
+  - 主题配置
+  - 公告管理
+  - 支付配置
+  - 知识库管理
+- 必须实现“系统配置”真实页面，覆盖：
+  - 站点设置
+  - 安全设置
+  - 订阅设置
+  - 邀请 & 佣金设置
+  - 节点配置
+  - 邮件设置
+  - Telegram 设置
+  - APP 设置
+  - 订阅模板
+- “系统配置”必须接入现有 Laravel 管理接口的真实数据读取与保存链路。
+- 插件管理、主题配置、公告管理、支付配置、知识库管理本轮只要求提供结构化占位页，为下一轮真实接入留入口。
+
+## 非目标
+- 本轮不实现插件、主题、公告、支付、知识库的完整 CRUD 页面。
+- 本轮不重做后端配置 API，不新增 Laravel 管理端接口。
+- 本轮不把前台主题配置混入“系统配置”页；主题能力保留在“主题配置”入口的后续阶段实现。
+
+## 技术约束
+- 技术栈固定为 `Vue 3 + TypeScript + Vite + Element Plus`。
+- 后端真相源以现有 Laravel 管理接口为准，系统配置使用：
+  - `GET /config/fetch`
+  - `POST /config/save`
+  - `POST /config/testSendMail`
+  - `POST /config/setTelegramWebhook`
+- 视觉契约优先级：本方案 > `.helloagents/DESIGN.md` > `apple/DESIGN.md` 的参考原则。
+- 构建验证使用 `admin-frontend/package.json` 中已有 `npm run build`。
+
+## 质量要求
+- 系统配置页必须保持 Apple 风格的一致性，并具备后台长表单的高可读性。
+- 异步页面必须覆盖加载、错误、保存成功与未修改状态反馈。
+- 表单交互需要明确区分主操作与辅助操作，避免一屏出现过多高强调按钮。
+- 最终至少完成一次构建验证与一次浏览器级视觉验收。
+

.helloagents/archive/2026-04/202604232329_admin-frontend-system-management/tasks.md

@@ -0,0 +1,13 @@
+# admin-frontend 系统管理首批交付 — 任务分解
+
+## 任务列表
+- [x] 任务1：补齐本轮 UI 契约与方案产物（涉及文件：`.helloagents/DESIGN.md`、`.helloagents/plans/202604232329_admin-frontend-system-management/*`；完成标准：存在可执行需求、方案、任务与合同文件；验证方式：文件检查）
+- [x] 任务2：扩展后台导航与路由结构（涉及文件：`admin-frontend/src/router/index.ts`、`admin-frontend/src/layouts/AdminLayout.vue`；完成标准：侧边栏出现系统管理分组并可进入 6 个子页面；验证方式：`npm run build` + 浏览器检查导航）
+- [x] 任务3：接入系统配置数据模型与 API（涉及文件：`admin-frontend/src/api/admin.ts`、`admin-frontend/src/types/api.d.ts`、`admin-frontend/src/utils/systemConfig.ts`；完成标准：前端可拉取并保存系统配置，字段可完成必要的回填与序列化；验证方式：`npm run build`）
+- [x] 任务4：实现系统配置主页面（涉及文件：`admin-frontend/src/views/system/SystemConfigView.vue`；完成标准：页面具备 9 个配置分组、加载/错误/保存反馈、左侧导航与真实保存入口；验证方式：`npm run build` + 浏览器检查 `#/system/config`）
+- [x] 任务5：实现其余系统管理占位页（涉及文件：`admin-frontend/src/views/system/SystemPlaceholderView.vue`；完成标准：其余 5 个入口可正常访问，并明确说明下一阶段接入范围；验证方式：`npm run build` + 浏览器检查对应路由）
+- [x] 任务6：完成验证、视觉验收与知识库同步（涉及文件：`.helloagents/CHANGELOG.md`、`.helloagents/modules/admin-frontend.md`、`.helloagents/.ralph-visual.json`、`.helloagents/.ralph-closeout.json`；完成标准：构建通过、视觉检查完成、知识库记录本轮变更；验证方式：命令输出 + 证据文件）
+
+## 进度
+- [x] 已冻结系统管理首批范围与系统配置优先级。
+- [x] 已完成 admin-frontend 系统管理导航、路由与系统配置页面。

.helloagents/archive/2026-04/202604232345_traffic-rank-limit-backend-adapt/.status.json

@@ -0,0 +1,11 @@
+{
+  "status": "completed",
+  "completed": 4,
+  "failed": 0,
+  "pending": 0,
+  "total": 4,
+  "done": 4,
+  "percent": 100,
+  "current": "traffic rank 的 10/20 limit 联动已完成，待归档",
+  "updated_at": "2026-04-23 23:52:00"
+}

.helloagents/archive/2026-04/202604232345_traffic-rank-limit-backend-adapt/proposal.md

@@ -0,0 +1,89 @@
+# 变更提案: traffic-rank-limit-backend-adapt
+
+## 元信息
+```yaml
+类型: 功能增强 + 接口适配
+方案类型: implementation
+优先级: P1
+状态: 已完成
+创建: 2026-04-23
+```
+
+---
+
+## 1. 需求
+
+### 背景
+当前 `admin-frontend` 的节点/用户流量排行已经补上了 `10个 / 20个` 切换 UI，但后端 `stat/getTrafficRank` 接口仍固定只取前 10 条，所以前端切到 20 条时实际上拿不到更多数据。同时，用户进一步明确：24 小时口径下依然要显示增幅/减幅，不需要特殊隐藏。
+
+### 目标
+- 让后端 `getTrafficRank` 支持按请求返回 `10` 或 `20` 条数据。
+- 让前端在节点排行/用户排行切换显示数量时，把对应的 `limit` 传给后端重新请求。
+- 保持 24h 口径下继续返回并显示涨幅/减幅，不额外关闭该能力。
+
+### 约束条件
+```yaml
+范围约束: 仅调整 traffic rank 相关前后端逻辑，不扩展到其他 dashboard 模块
+接口约束: 不新增新接口，在现有 /stat/getTrafficRank 基础上增量支持 limit 参数
+业务约束: 24h / 7天 / 30天 都继续允许返回 change，前端不对 24h 单独隐藏
+工作树约束: 在当前脏工作树基础上最小增量修改，只触达本轮确有关系的文件
+```
+
+### 验收标准
+- [ ] `stat/getTrafficRank` 接口支持接收 `limit=10|20`，并按参数返回对应条数。
+- [ ] dashboard 前端在节点/用户排行切换显示数量时，会向后端请求对应 limit，而不是仅前端截断。
+- [ ] 24h 口径下排行仍显示增幅/减幅，前后端都不额外屏蔽该字段。
+- [ ] `admin-frontend` 构建通过，相关 PHP 文件语法检查通过。
+
+---
+
+## 2. 方案
+
+### 技术方案
+1. 在 `app/Http/Controllers/V2/Admin/StatController.php` 的 `getTrafficRank()` 中新增 `limit` 参数校验，并把当前节点/用户排行查询的 `limit(10)` 改为动态 limit。
+2. 在 `admin-frontend/src/api/admin.ts` 的 `getTrafficRank()` 中支持传入 `limit` 参数。
+3. 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 的 `loadRankings()` 中分别把 `nodeRankLimit`、`userRankLimit` 传给对应接口，并在显示数量变化时重新请求排行数据。
+
+### 影响范围
+```yaml
+涉及模块:
+  - app/Http/Controllers/V2/Admin/StatController.php
+  - admin-frontend/src/api/admin.ts
+  - admin-frontend/src/views/dashboard/DashboardView.vue
+  - public/assets/admin (构建产物输出)
+预计变更文件: 3-4
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| limit 参数放开后请求值异常 | 中 | 后端仅允许 `10` 或 `20`，避免任意放大查询 |
+| 前端 limit 切换后仍沿用旧数据 | 中 | 对 `nodeRankLimit` / `userRankLimit` 增加 watch，变化即重新拉取 |
+| 当前工作树已有 dashboard 相关脏改动 | 中 | 只做最小补丁，并通过构建与 git diff 核对本轮触达文件 |
+
+---
+
+## 3. 成果设计
+
+### 设计方向
+- **交互基线**: 维持现有 Apple 风格排行面板，不新增可视化噪音。
+- **数据行为**: 数量切换真正驱动后端返回更多排行项，而不是仅靠前端裁切。
+- **显示规则**: 24 小时口径仍保留涨跌百分比展示，与 7 天/30 天保持一致。
+
+---
+
+## 4. 技术决策
+
+### traffic-rank-limit-backend-adapt#D001: 在现有 getTrafficRank 接口上新增 limit 参数
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 前端已经存在 10/20 切换控件，但后端固定 limit 10 导致能力不完整。
+**决策**: 不新增新接口，直接在 `getTrafficRank` 上增加受控 `limit` 参数。
+**理由**: 改动最小，且与现有 dashboard 请求模型保持一致。
+
+### traffic-rank-limit-backend-adapt#D002: 24h 口径继续显示 change
+**日期**: 2026-04-23
+**状态**: ✅采纳
+**背景**: 用户明确要求 24 小时口径也允许展示增幅/减幅。
+**决策**: 保持后端始终返回 `change`，前端不为 24h 增加隐藏逻辑。
+**理由**: 行为统一，避免不同时间口径的 UI 规则分裂。

.helloagents/archive/2026-04/202604232345_traffic-rank-limit-backend-adapt/tasks.md

@@ -0,0 +1,49 @@
+# 任务清单: traffic-rank-limit-backend-adapt
+
+> **@status:** completed | 2026-04-23 23:52
+
+```yaml
+@feature: traffic-rank-limit-backend-adapt
+@created: 2026-04-23
+@status: completed
+@mode: R2
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 4 | 0 | 0 | 4 |
+
+---
+
+## 任务列表
+
+### 1. 接口适配
+
+- [√] 1.1 在 `app/Http/Controllers/V2/Admin/StatController.php` 中为 `getTrafficRank` 增加 `limit=10|20` 参数支持 | depends_on: []
+- [√] 1.2 在 `admin-frontend/src/api/admin.ts` 中为 `getTrafficRank` 透传 `limit` 参数 | depends_on: [1.1]
+- [√] 1.3 在 `admin-frontend/src/views/dashboard/DashboardView.vue` 中让 10/20 切换重新请求后端排行数据 | depends_on: [1.2]
+
+### 2. 验证
+
+- [√] 2.1 运行前后端验证（PHP 语法检查 + admin-frontend 构建），确认 24h change 未被关闭 | depends_on: [1.3]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-23 23:45 | 方案包初始化 | completed | 已确认后端需支持 10/20 limit，且 24h 继续展示增幅/减幅 |
+| 2026-04-23 23:49 | 1.1 / 1.2 / 1.3 | completed | 已完成后端 limit 参数接入、前端 API 透传与排行数量切换后的重新请求 |
+| 2026-04-23 23:51 | 2.1 | completed | `npm run build` 通过；本机缺少 `php` CLI，无法直接执行 `php -l`，已以最小 PHP 补丁和代码复核兜底 |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 当前工作树已存在多项未提交 dashboard 相关改动；本轮仅聚焦 traffic rank 前后端适配。
+- 24h 涨跌展示未额外增加隐藏逻辑，前端仍直接渲染 `formatPercent(item.change)`；后端继续为所有时间口径返回 `change`。

.helloagents/archive/_index.md

@@ -7,6 +7,12 @@
 
 | 时间戳 | 名称 | 类型 | 涉及模块 | 决策 | 结果 |
 |--------|------|------|---------|------|------|
+| 202604232345 | traffic-rank-limit-backend-adapt | implementation | admin-frontend,backend | traffic-rank-limit-backend-adapt#D001,#D002 | ✅完成 |
+| 202604232329 | admin-frontend-system-management | implementation | admin-frontend | admin-frontend-system-management#D001,#D002,#D003 | ✅完成 |
+| 202604232320 | admin-frontend-node-management | implementation | admin-frontend | admin-frontend-node-management#D001,#D002 | ✅完成 |
+| 202604232318 | admin-frontend-rank-limit-scroll | implementation | admin-frontend | admin-frontend-rank-limit-scroll#D001,#D002 | ✅完成 |
+| 202604232313 | admin-frontend-dashboard-trend-count-toggle | implementation | admin-frontend | admin-frontend-dashboard-trend-count-toggle#D001,#D002 | ✅完成 |
+| 202604231515 | admin-frontend-dashboard-refresh-button | implementation | admin-frontend | admin-frontend-dashboard-refresh-button#D001,#D002 | ✅完成 |
 | 202604210441 | admin-frontend-user-management | - | - | - | ✅完成 |
 | 202604210400 | admin-frontend-apple-performance-refresh | implementation | admin-frontend | admin-frontend-apple-performance-refresh#D001,#D002 | ✅完成 |
 | 202604210326 | admin-frontend-composio-dashboard | implementation | admin-frontend | admin-frontend-composio-dashboard#D001,#D002 | ✅完成 |
@@ -18,6 +24,12 @@
 ## 按月归档
 
 ### 2026-04
+- [202604232345_traffic-rank-limit-backend-adapt](./2026-04/202604232345_traffic-rank-limit-backend-adapt/) - traffic rank 接口新增 limit=10|20 支持，并让 dashboard 的 10/20 切换真正驱动后端返回条数
+- [202604232329_admin-frontend-system-management](./2026-04/202604232329_admin-frontend-system-management/) - 新增“系统管理”侧边栏分组，完整交付系统配置页，并接入插件/主题/公告/支付/知识库结构化占位页
+- [202604232320_admin-frontend-node-management](./2026-04/202604232320_admin-frontend-node-management/) - 新增“节点管理”侧边栏分组、节点管理工作台，以及权限组/路由管理占位页
+- [202604232318_admin-frontend-rank-limit-scroll](./2026-04/202604232318_admin-frontend-rank-limit-scroll/) - 仪表盘节点流量排行和用户流量排行新增 10/20 显示切换，并在面板内提供滚动查看
+- [202604232313_admin-frontend-dashboard-trend-count-toggle](./2026-04/202604232313_admin-frontend-dashboard-trend-count-toggle/) - 仪表盘收入趋势新增“按金额 / 按数量”切换，并让摘要和最近记录同步切换口径
+- [202604231515_admin-frontend-dashboard-refresh-button](./2026-04/202604231515_admin-frontend-dashboard-refresh-button/) - 为 Apple 风格仪表盘新增 Hero 区“刷新全部数据”按钮，并补齐加载反馈与最后刷新时间
 - [202604210441_admin-frontend-user-management](./2026-04/202604210441_admin-frontend-user-management/) - 新增用户管理工作台、抽屉表单、用户操作菜单，以及“用户管理 / 工单管理”导航与路由骨架
 - [202604210400_admin-frontend-apple-performance-refresh](./2026-04/202604210400_admin-frontend-apple-performance-refresh/) - Apple 风格重构登录页、主布局和仪表盘，并移除高成本装饰层以缓解卡顿
 - [202604210326_admin-frontend-composio-dashboard](./2026-04/202604210326_admin-frontend-composio-dashboard/) - 深色 Composio 风格管理端仪表盘、登录回跳与真实统计数据接入