Skip to content

Decision:项目默认 Dashboard 与工作台导航 ​

状态:implemented 类型:feature Owner:web/src/views/ProjectDashboardView.vue 日期:2026-09-26 关联 Feature:项目自定义 Dashboard、项目治理

问题 ​

项目没有 Agent 自定义页面时,Dashboard 只显示生成提示,已有的蓝图、治理与执行数据无法在项目入口集中查看。项目工作台能操作这些数据,但入口分散、栏目不易定位。每个项目需要统一的基础信息层级,自定义页面仍需保留既有静态隔离边界。

决策 ​

受信任的 Vue 页面在自定义 Dashboard 状态为 empty 时展示统一默认范式,从已授权的项目督查读视图和蓝图读取接口获取数据。范式固定呈现项目概览、待办计数、蓝图、议题、任务、决策与汇报、执行动态;缺少记录时显示下一步入口。自定义页面状态为 ready 时继续只显示无脚本 iframe,默认范式不向 iframe 传递项目数据。状态为 repair_required 时保留修复警告,并允许用户查看独立的默认概览。

项目工作台继续拥有蓝图、治理和委派操作;默认 Dashboard 仅提供查看与跳转。侧边栏、跨项目督查、Dashboard 和工作台提供明确入口。项目页面的写入授权、审计与冲突语义保持在现有后端用例,不新增浏览器写接口、iframe bridge、调度器或持久化默认 HTML。

替代方案 ​

  • 为所有项目写入相同的 dashboard/index.html:会占用自定义页面 revision,增加文件与元数据对账工作,并使统一范式的数据容易过期。
  • 向 Agent 页面注入项目读视图:任意 HTML 页面不属于受信任的项目数据展示边界。
  • 由前端重算待办或 Run 状态:后端督查读视图已拥有这些状态,前端只展示其字段。

后果 ​

默认范式对所有项目使用相同布局,并随实时读接口更新。蓝图读取失败只影响蓝图卡片;督查读视图失败时显示可重试错误。自定义页面保持其独立设计空间。工作台视觉和导航调整不改变治理操作或状态流转。

验证 ​

前端 lint、unit、build、真实浏览器页面与浅深色及窄屏检查;工程契约与文档构建。浏览器验证默认项目数据、空状态、入口跳转和自定义页面隔离状态。

本项目基于 MIT License 开源,欢迎使用和贡献。