@sleep2agi/agent-network-dashboard 0.4.3-preview.1 → 0.4.4-preview.0

package/DASHBOARD_OPTIMIZATION_PLAN.md

@@ -1,414 +0,0 @@
-# Agent Network Dashboard 后台优化方案
-
-## 1. 当前现状
-
-### 1.1 当前页面
-
-基于当前代码，前台实际只有 3 个页面：
-
-1. `/login`
-   - 密码登录页
-   - 使用 `anet_dashboard_session` Cookie 做简单会话鉴权
-   - 密码来源于环境变量或 `~/.anet/config.json`
-
-2. `/`
-   - Dashboard 总览页
-   - 展示在线节点、工作中节点、总节点数、CommHub 版本、运行时长
-   - 展示 `anet` 配置状态
-   - 支持广播消息
-   - 支持查看拓扑图
-   - 展示 Agent 卡片列表
-   - 展示 Dashboard 自己的 inbox 消息
-
-3. `/node?alias=xxx`
-   - 单个节点详情页
-   - 展示节点基础信息、当前任务、最近输出
-   - 展示发给该节点的 inbox 消息
-   - 支持向单个节点发送任务
-
-### 1.2 当前已接入的后端能力
-
-当前 Dashboard 并不是纯静态页面，已经通过 Next API route 代理了 CommHub 的若干接口：
-
-- `/api/hub/status`
-  - 读取全部 session 状态
-- `/api/hub/health`
-  - 读取 hub 健康状态、SSE 连接情况、版本、运行时长
-- `/api/hub/messages`
-  - 读取最近消息流
-- `/api/hub/session`
-  - 读取单个节点详情、节点 inbox、SSE 状态
-- `/api/hub/send`
-  - 给单个节点派发任务
-- `/api/hub/broadcast`
-  - 对全体节点广播
-- `/api/hub/inbox`
-  - 读取 Dashboard 自己的 inbox
-- `/api/hub/register`
-  - 将 Dashboard 自身注册为一个节点
-- `/api/anet/config`
-  - 读取本地或运行时配置
-- `/api/auth/login`、`/api/auth/logout`
-  - 简单登录退出
-
-### 1.3 当前产品定位判断
-
-当前系统更接近“实时监控看板 + 运维控制台原型”，还不是完整后台系统。
-
-它已经具备这些优点：
-
-- 实时感强，5 秒刷新
-- 拓扑图有辨识度，适合演示
-- 已有单节点派单和广播能力
-- 已做最基础的登录保护
-
-但它也有明显边界：
-
-- 页面层级很浅，只有总览和节点详情
-- 缺少后台常见的信息架构和导航体系
-- 缺少用户、权限、审计、检索、筛选、批量处理等后台基础能力
-- 大量信息仍是“直接把 CommHub 数据展示出来”，没有形成管理闭环
-
-## 2. 当前缺什么功能
-
-下面按“后台系统”角度拆分缺口。
-
-### 2.1 后台基础能力缺口
-
-1. 用户管理
-   - 目前只有单密码登录，没有用户体系
-   - 没有账号、角色、权限组
-   - 没有谁执行了什么操作的责任归属
-
-2. 权限控制
-   - 现在所有登录者权限相同
-   - 没有只读、运维、管理员等权限分层
-   - 没有敏感操作确认机制
-
-3. 审计日志
-   - 没有记录谁在什么时间广播了什么、给哪个 agent 发了什么任务
-   - 无法回溯误操作
-
-4. 导航与信息架构
-   - 目前没有真正的后台导航
-   - 缺少二级页面与模块组织
-
-### 2.2 Agent 管理能力缺口
-
-1. Agent 列表页能力不足
-   - 现在首页卡片即列表，但没有筛选、搜索、排序、分组
-   - 无法按在线状态、工作状态、服务器、Agent 类型查看
-
-2. Agent 生命周期管理不足
-   - 看得到状态，但不能执行“暂停/恢复/重试/下线/标记异常/批量操作”
-
-3. Agent 详情不够完整
-   - 没有历史任务轨迹
-   - 没有性能曲线
-   - 没有最近错误和失败原因聚合
-   - 没有消息往来视角的时间线
-
-4. Agent 分组能力缺失
-   - 没有标签、分组、环境维度
-   - 不能快速对“生产/测试”“某项目组”“某地区节点”操作
-
-### 2.3 消息与任务管理缺口
-
-1. 消息查看能力不足
-   - 现在只有拓扑图 recent signal 和局部 inbox
-   - 没有统一消息中心
-   - 不能按来源、目标、时间、优先级、类型搜索
-
-2. 任务管理缺失
-   - 能发送任务，但没有任务列表
-   - 看不到任务状态流转
-   - 没有重试、取消、重新派发
-   - 没有失败任务聚合
-
-3. 广播能力过于轻量
-   - 没有广播历史
-   - 没有广播模板
-   - 没有发送前确认、影响范围预估、目标筛选
-
-### 2.4 日志与可观测性缺口
-
-1. 日志中心缺失
-   - 节点详情里只有“Last Output”
-   - 没有完整日志流、日志级别、日志过滤、关键字搜索
-
-2. 指标体系不足
-   - 只有在线数、工作数、总数、版本、运行时长
-   - 缺少任务成功率、平均响应时长、消息吞吐、失败率、异常率
-
-3. 告警与异常处理缺失
-   - 没有离线告警、长时间 working 告警、消息堆积告警
-   - 没有异常节点列表和待处理队列
-
-### 2.5 运营和“吸引人用”相关缺口
-
-1. 缺少演示型页面
-   - 当前很像内部工具，不像能打动新用户的产品后台
-
-2. 缺少新手引导
-   - 没有解释“这个系统能做什么”“第一步怎么接入”
-
-3. 缺少可分享视图
-   - 没有适合老板、运营、合作方看的汇总视图
-
-4. 缺少配置管理页
-   - 当前只展示 config，不支持管理和校验
-
-## 3. 优先级建议
-
-### P0：优先补齐“能管理”的最小后台闭环
-
-这是最应该先做的，因为它直接决定这个系统是不是后台。
-
-1. 后台导航重构
-   - 增加左侧导航或顶部导航
-   - 拆出核心模块：总览、Agents、任务、消息、日志、系统配置
-
-2. Agents 列表页升级
-   - 支持搜索、筛选、排序、分组
-   - 支持按在线/离线、working/idle、server、agent 类型筛选
-
-3. 消息中心
-   - 建统一消息页
-   - 支持查看所有消息流和按条件过滤
-
-4. 任务中心
-   - 展示最近任务、执行中任务、失败任务
-   - 把“发送任务”从散落操作升级成可追踪对象
-
-5. 审计日志
-   - 至少先记录广播、单节点发送、登录、退出等关键操作
-
-原因：
-
-- 这些能力能把当前“监控看板”升级为“可运营后台”
-- 对日常使用价值最大
-- 也最容易让后续功能有落点
-
-### P1：补齐运维和可观测性
-
-1. 日志中心
-   - 统一日志页面
-   - 支持关键字、节点、时间范围、级别筛选
-
-2. 异常与告警页
-   - 离线节点
-   - 超时任务
-   - 长时间无心跳节点
-   - 消息积压
-
-3. Agent 详情增强
-   - 任务时间线
-   - 消息时间线
-   - 最近错误
-   - 运行指标摘要
-
-原因：
-
-- 这部分能显著提高留存，因为它解决“真问题”
-- 日常维护、排障、协作价值会明显提升
-
-### P2：补齐权限、配置、协作
-
-1. 用户管理和角色权限
-2. 系统配置页
-3. 广播模板和批量操作
-4. 收藏视图、标签视图、团队视图
-
-原因：
-
-- 这是“多人长期使用”必需品
-- 对吸引团队协作和扩大使用范围很重要
-
-### P3：增强产品吸引力和展示力
-
-1. 面向老板/客户的高级概览页
-2. 更完整的数据故事化展示
-3. Onboarding 引导
-4. Demo 模式或只读分享模式
-
-原因：
-
-- 这部分最有利于对外展示和拉新
-- 但应建立在后台基础能力已经稳定的前提下
-
-## 4. 推荐的信息架构
-
-建议后台升级为以下结构：
-
-1. 总览 Dashboard
-   - 核心指标卡
-   - 今日异常
-   - 在线率趋势
-   - 最近任务与消息
-   - 快捷操作
-
-2. Agents
-   - Agent 列表
-   - Agent 分组
-   - Agent 详情
-
-3. 任务
-   - 任务列表
-   - 任务详情
-   - 失败任务
-
-4. 消息
-   - 消息流
-   - 广播历史
-   - Inbox 查看
-
-5. 日志
-   - 全局日志检索
-   - 节点日志
-   - 异常日志
-
-6. 系统
-   - CommHub 状态
-   - 配置管理
-   - 审计日志
-   - 用户与权限
-
-## 5. 怎么让后台系统更吸引人用
-
-“吸引人用”不能只靠视觉，要靠“上手快 + 信息清楚 + 操作有安全感 + 有成就感”。
-
-### 5.1 提升第一眼吸引力
-
-1. 把首页从“节点堆叠”升级为“业务概览”
-   - 首页第一屏应该先回答：
-   - 系统现在是否健康
-   - 有多少 Agent 正在工作
-   - 今天完成了多少任务
-   - 有多少异常需要处理
-
-2. 保留当前拓扑图，但降级为“亮点模块”
-   - 当前拓扑图很有记忆点，适合作为亮点
-   - 但不应该继续占据首页主叙事
-   - 应该服务于“网络态势感知”，而不是替代后台导航
-
-3. 提升数据的解释性
-   - 不只显示数字，还要显示趋势、对比和异常原因
-
-### 5.2 提升日常使用价值
-
-1. 让用户 30 秒内完成核心动作
-   - 找到异常 Agent
-   - 查看最近消息
-   - 派发任务
-   - 查失败日志
-
-2. 增加常用快捷入口
-   - 最近查看 Agent
-   - 最近广播
-   - 收藏分组
-   - 待处理异常
-
-3. 给关键操作增加反馈闭环
-   - 发送任务后能看到已发送、已接收、执行中、完成/失败
-   - 这样用户会更信任系统
-
-### 5.3 提升多人协作意愿
-
-1. 引入用户和角色
-2. 引入审计日志
-3. 引入备注、标签、状态标记
-4. 支持共享视图和团队过滤器
-
-这样系统才能从“一个人操作的看板”升级为“团队一起使用的后台”。
-
-### 5.4 提升对外展示能力
-
-1. 增加只读总览模式
-   - 给老板、客户、合作方看
-
-2. 增加运营视角指标
-   - 活跃节点数
-   - 平均响应时长
-   - 今日完成任务数
-   - 异常恢复率
-
-3. 增加 onboarding 区块
-   - 如何接入 Agent
-   - 如何发送任务
-   - 如何排查异常
-
-## 6. 建议的实施顺序
-
-### 第一阶段：把原型升级为后台
-
-目标：补齐后台骨架
-
-- 重构导航和布局
-- 新增 Agents 列表页
-- 新增任务页
-- 新增消息页
-- 把首页调整为概览页
-
-### 第二阶段：把后台升级为可运维系统
-
-目标：提升日常使用频率
-
-- 新增日志中心
-- 新增异常与告警
-- 增强 Agent 详情页
-- 增加任务状态追踪
-
-### 第三阶段：把系统升级为可协作产品
-
-目标：让多人愿意长期使用
-
-- 用户管理
-- 角色权限
-- 审计日志
-- 标签和分组
-- 批量操作
-
-### 第四阶段：把系统升级为可展示产品
-
-目标：帮助吸引更多用户和团队
-
-- 老板视图 / 运营视图
-- 只读分享模式
-- onboarding 与空状态设计
-- 更有产品感的数据故事呈现
-
-## 7. 建议先落地的具体页面
-
-如果只选第一批最值得做的页面，我建议是：
-
-1. 新首页：运营化 Dashboard
-   - 替换当前“以卡片为主”的首页结构
-
-2. Agents 页
-   - 当前首页中的 Agent 卡片沉淀到独立页面
-
-3. Messages 页
-   - 把消息流和 inbox 能力做成统一页面
-
-4. Tasks 页
-   - 把派单、状态追踪、失败重试形成闭环
-
-5. Logs 页
-   - 补齐排障入口
-
-## 8. 结论
-
-当前项目已经有一个不错的基础：
-
-- 已有实时状态
-- 已有节点详情
-- 已有消息与派单接口
-- 已有可视化亮点
-
-但如果目标是“做好后台系统，吸引大家来使用”，重点不是继续堆一个更炫的总览页，而是尽快把它从展示型面板升级成：
-
-- 有导航的信息系统
-- 有任务和消息闭环的操作系统
-- 有日志、异常、审计、权限的协作系统
-
-建议先按 P0 和 P1 推进，这样最能快速提升产品可用性和团队使用意愿。

package/docs/iteration-plan.md

@@ -1,62 +0,0 @@
-# Dashboard 迭代计划
-
-> 更新：2026-04-10 | N站马
-
-## 当前进度
-
-| 任务 | 状态 | 负责 |
-|------|------|------|
-| Tasks 任务列表页 | done | N站马 |
-| 首页任务状态统计 | done | N站马 |
-| 节点详情补新字段 | done | N站马 |
-| API 代理层(兼容降级) | done | N站马 |
-| CommHub /api/tasks | **阻塞** | 通信龙 server |
-| CommHub /api/status 补字段 | **阻塞** | 通信龙 server |
-| 联调验证 | 待 server 就绪 | N站马+N站牛 |
-
-## 迭代路线
-
-### Sprint 1: 当前（基础功能）
-
-- [x] Tasks 页（已降级对接 /api/completions）
-- [x] 首页 Task 统计面板
-- [x] 节点详情补字段（前端就绪，等后端数据）
-- [x] API 代理层自动降级
-- [ ] 联调 + 部署
-
-### Sprint 2: 导航 + 数据层
-
-- [ ] 侧边栏导航（Overview / Nodes / Tasks / Messages / Logs / Settings）
-- [ ] SWR/React Query 统一数据层，替换分散 setInterval 轮询
-- [ ] Next.js middleware 统一鉴权，干掉各组件分散 401 检测
-
-### Sprint 3: 页面补齐
-
-- [ ] Nodes 列表页（筛选 status/agent/server，批量操作）
-- [ ] Messages 页（按 type/from/to 搜索，调试模式）
-- [ ] Task Timeline 详情页（created→delivered→running→replied 全链路）
-
-### Sprint 4: 运维闭环
-
-- [ ] Logs 页（全局搜索 + 节点过滤 + 错误级别）
-- [ ] 异常高亮（timeout/failed task，offline/stale 节点区分）
-- [ ] SSE 实时推送替代轮询
-
-### Sprint 5: 安全 + 多人
-
-- [ ] 登录限流 + CSRF
-- [ ] 密码和 CommHub token 分离
-- [ ] /api/anet/config 脱敏
-- [ ] 多用户 + 项目隔离 + RBAC
-
-## 建议
-
-1. **Sprint 2 最值得投入** — 导航重构是从"调试页"变"后台系统"的分水岭，SWR 统一数据层能解决当前最大的技术债（每个组件各自轮询）
-
-2. **SSE 优于轮询** — Dashboard 可直接订阅 CommHub /events/Dashboard，省掉所有 5s setInterval，实时性更好、请求量更低
-
-3. **空状态设计别拖** — 每个新页面上线时同步做空状态引导，新用户第一印象很重要
-
-4. **拓扑图保持但降级** — 放 Overview 显眼位置作为产品记忆点，但不再主导首页布局
-
-5. **Server 接口升级是最大阻塞** — Sprint 1 联调和 Sprint 3 的 Messages/Task Timeline 都依赖通信龙 server 侧升级，建议推动优先级

package/docs/v4-plan.md

@@ -1,38 +0,0 @@
-# Dashboard V4 优化方案
-
-## 上一阶段成果
-- 51 commits，8+ 页面，preview.8→27 全对接
-- V3 Auth 完整：登录/注册/token管理/网络管理/成员查看
-- SSE 实时 + SWR 数据层 + network_id 隔离
-- Docker 测试环境自动化
-
-## preview.27 新发现
-- 注册返回 `utok_`（用户 token）+ `ntok_`（网络 token）
-- 首个注册用户自动成为 `admin` 角色
-- `/api/task_events` 端点可用
-- `/api/auth/tokens` 返回多种 token
-
-## V4 优化清单
-
-### 产品
-1. 注册流程：展示 utok_ 和 ntok_ 双 token（用户 token + 网络 token）
-2. Network 多租户：完整的网络→成员→邀请→角色 流程
-3. 任务事件时间线：/api/task_events 接入 Task 详情页
-
-### 设计
-4. 统一色彩系统：定义 design tokens（primary/success/warning/error）
-5. 首页信息层次优化：减少视觉噪音
-6. 空状态设计统一
-
-### 前端
-7. 注册响应支持 utok_/ntok_ 双 token
-8. 新增 /api/hub/task-events 代理
-9. Task 详情页接入 task_events 时间线
-
-### 运维
-10. Docker 测试自动化脚本
-11. 健康检查监控
-
-### 运营
-12. Demo 数据丰富化
-13. Onboarding 引导