Dashboard
Dashboard 是 Anyy 的可视化使用界面。你可以在这里聊天、检查运行状态，并操作当前 Profile 已经配置的各项能力。
本页只讲 Dashboard 本身怎么启动和使用。功能原理、参数与限制统一放在功能概览及消息平台中。
启动 Dashboard
anyy dashboard
Dashboard 依赖常驻 Gateway。如果交互式终端中暂时没有可连接的 Gateway，Anyy 会显示 Gateway required 并询问是否启动。确认后，它会在需要时安装并启动后台服务，等待运行时就绪，再继续打开 Dashboard。
默认会打印两类地址：
- This machine：当前机器使用；
- Local network：可用网卡对应的局域网地址。
交互式运行会自动打开 This machine 地址。只打印地址、不打开浏览器时：
anyy dashboard --no-open
只监听一个明确地址：
anyy dashboard --listen 127.0.0.1:8767
每次启动打印的地址都包含临时 Token。不要把它发到聊天、日志或 Issue，也不要让完整地址出现在截图里。只在自己控制的浏览器中打开。
URL Token 与浏览器 Session 有效期
启动时打印的 URL Token 是一次性 Claim Token，有效期为 10 分钟，首次成功领取后立即失效。浏览器随后得到 HttpOnly Dashboard Session Cookie，有效期为 24 小时；Dashboard 进程停止后，这个 Session 也不能继续使用。
已经领取或超时的 URL 不能再给另一个浏览器创建 Session。需要新入口时重新运行 anyy dashboard。Cookie 只作用于 /dashboard/，不会获得任意 Gateway RPC 或另一套 Dashboard 进程的访问权。
Dashboard 与 Gateway 的关系
Dashboard 是按需运行的网页 sidecar；Gateway 才是常驻助手运行时。
| 操作 | Dashboard | Gateway 服务 |
|---|---|---|
在启动 Dashboard 的终端按 Ctrl+C | 停止网页监听 | 继续运行 |
| 关闭浏览器标签页 | 终端进程仍在时继续监听 | 继续运行 |
anyy dashboard --stop | 停止 Dashboard 进程 | 继续运行 |
anyy gateway stop | 失去运行时连接 | 停止 |
从另一个终端查看状态或停止 Dashboard：
anyy dashboard --status
anyy dashboard --stop
左侧导航怎么用
| 页面 | 适合完成什么 | 对应说明 |
|---|---|---|
| Chat | 新建、恢复、Steer 和观察会话 | 对话与会话 |
| Overview | 快速确认设置、健康状态、活动与用量 | 本页下文 |
| Roles | 创建和选择不同助手身份 | 角色与个性 |
| Memory | 查看并维护长期个人上下文 | 持久记忆 |
| Models | 配置服务商、主模型和媒体路由 | 模型与服务商 |
| Channel | 连接消息账号并检查健康状态 | 消息平台 |
| MCP | 接入外部 MCP Server，限定可用工具 | MCP 集成 |
| Skills | 查看和管理可复用工作说明 | Skills 系统 |
| Tools | 检查工具治理和能力 Backend | 工具与 Toolset |
| Cron | 创建和查看定时工作 | 定时自动化 |
| Profile | 创建或切换相互隔离的 Anyy Home | Profiles |
| Approvals | 处理待授权操作并回看决定 | 审批与 ChangePlan |
| About | 核对版本、Commit、Profile、Home 和默认 Role | 确认当前运行环境 |
侧栏的语言选择器只改变 Dashboard 自身语言，不会翻译聊天内容，也不会切换文档语言。
Overview 页面看什么
打开 Overview，可以快速确认当前环境是否符合预期：
- 当前 Profile、默认 Role、已配置 Channel 和主模型；
- 下一条 Cron 计划；
- 活动会话数、计划任务数、状态数据库大小和 Heartbeat 新鲜度；
- 7 天或 30 天的输入/输出 Token 与轮次；
- 最近会话；
- 已配置的 MCP Server 与 Skills。
切换 Profile、模型、Channel、Skill、MCP 或 Cron 后，回到 Overview 看一次。这里反映的是常驻运行时实际加载到的状态。
确认当前运行环境
需要回答“现在运行的是哪个版本？”或“这个浏览器连的是哪套数据？”时，打开 About。
| 字段 | 用途 |
|---|---|
| Product Name | 确认当前产品为 Anyy |
| Version | 与 Release Notes 或 anyy --version 对照 |
| Commit | Build 注入 Commit 元数据时，用于精确定位 |
| Profile ID 与 Home | 确认当前数据和配置边界 |
| Default Role | 确认新会话默认使用的身份 |
About 还会列出 Dashboard、终端、CLI 和消息 Channel 等使用界面。它们共享当前 Profile 的 Runtime 与数据；真正的边界是 Profile，不是某一个界面。
Dashboard 与 CLI 展示内容不一致时，用下面的命令交叉检查：
anyy --version
anyy config
anyy status
报告可复现问题时可以提供 Version 和 Commit；公开前务必移除 Token、凭据和私人 Home 路径。
指定 Profile 或 Home
Dashboard 启动时会绑定到选定的 Profile/Home：
anyy --profile work dashboard
anyy dashboard --home /path/to/anyy-home
会话或设置看起来“消失”时，先核对 About → Profile，再比较：
anyy config
anyy profile list
通常只是打开了另一套 Profile，并不是数据被删除。
局域网访问
默认命令会提供本机与局域网地址，实际能否连接还取决于网卡、路由和主机防火墙。
只在当前电脑使用时，优先绑定回环地址：
anyy dashboard --listen 127.0.0.1:8767
只有另一台可信设备确实需要访问时才使用 LAN 地址。临时 Token 不等于公网部署防护，不要把 Dashboard 直接暴露到互联网。
常见问题
| 现象 | 处理方法 |
|---|---|
| 显示 Gateway required | 接受启动提示，或先运行 anyy gateway start |
8767 端口被占用 | 用 --status 找到旧进程、--stop 停止，或选择其他端口 |
| 浏览器没有自动打开 | 复制 This machine 地址；确认没有使用 --no-open |
| Token 无效、超过 10 分钟或已经使用 | 重新运行 anyy dashboard，打开新打印的地址 |
| 页面能打开但数据加载失败 | 运行 anyy status 和 anyy doctor 检查 Gateway/Profile |
| CLI 与 Dashboard 内容不同 | 对照 About 中的 Profile ID、Home 与 anyy config |
Version 与 anyy --version 不同 | Dashboard 或 Gateway 可能仍由旧 Binary 提供；检查状态，并按更新流程提示重启 |
| Commit 为空 | 当前 Build 没有注入 Commit 元数据；使用 Version 和安装来源定位 |
| 其他设备无法访问 | 核对 LAN 地址、监听地址和防火墙；不要改成公网直连 |