comet dashboard 启动一个本地只读的浏览器仪表盘。它在同一个快照中提供 Classic/OpenSpec 与 Native 数据，并通过左上角的工作流选项互斥显示两个工作区。
它只读，不会修改任何文件，可以随时安全启动。
本页是
comet dashboard
的命令参考。想了解仪表盘的界面布局、产物分组、任务环形图、亮色/暗色主题和截图，请看
Dashboard 总览。快速开始
在含有change的项目根目录运行：http://localhost:4321 启动并自动打开浏览器。终端会显示：
命令选项
—port 被占用时会自动向上找可用端口（最多重试 50 次）。
—port 0 让系统自动分配。端口必须是 0–65535 的整数，否则报错。脚本 / CI 用法
不启动服务器，只打印一次 JSON 快照：仪表盘能看到什么
Classic 工作区依据classic.artifact_layout 读取 docs/openspec/changes/ 或保留旧布局的 openspec/changes/，并从对应的 changes/archive/ 读取归档 change。Native 工作区依据 .comet/config.yaml 读取配置的 Native artifact root。两部分都只读、尽力而为；Native 采集失败不会阻止 Classic 快照返回。浏览器中一次只显示所选工作流，切换不会改变项目状态。
Changes Explorer 先按页加载轻量的 change 列表，选中某一项后才加载完整详情。Classic 和 Native 在详情加载期间都会保留当前详情，加载失败时提供重试；项目较大时继续滚动即可加载下一页。
查看注册的 Git worktree
Dashboard 会发现当前 Git 仓库注册的 worktree，并将每个 worktree 作为独立的变更来源。列表中会显示对应的分支或 worktree 名称，来自其他 worktree 的 Change 不会被误归到当前目录。Native change
Native 工作区通过“活跃 / 已归档 / 全部”筛选显示 change。状态数据直接来自 Native Runtime 的 projection、归档预检和冲突雷达：- phase：Shape / Build / Verify / Archive
- 验证证据新鲜度与归档就绪状态
- continuation 状态与是否需要用户决定
- 结构化 finding code
- 明确冲突与可能重叠的关联 change
- 需求简报、变更 Spec 和验证报告的 Markdown 预览
- 最近 checkpoint、下一步动作与进展时间
- capability 变更范围、Acceptance 覆盖和实现范围汇总
- Repair 状态与项目 Git 摘要
comet native 命令。
使用 --json 时，同一快照会在可用时包含 schema 为 comet.dashboard.native.v1 的 native 字段；项目未启用 Native 时省略该字段。
Classic change
0.4.0-beta.4 对日常查看体验做了以下调整：- 左侧 Changes Explorer 显示时，中间 change 工作区仍限制在浏览器视口内，不会把页面横向撑出屏幕。
- 打开或关闭 artifact preview 会保留原列表的滚动位置，连续检查多个产物时不必反复定位。
- 已归档 change 显示为完成状态，不再建议重新进入 verify。
- 归档 change 引用的 Design Doc、Plan 和验证报告会从项目根的
docs/superpowers/正确解析，归档后仍可预览。
项目级信息
- 项目名称、路径、生成时间
- 汇总：活跃 change 数、归档数、verify 失败数、任务未完成数、脏文件数
- Git 快照：分支、HEAD、脏文件列表、最近提交
每个 change
- 名称、状态（活跃/归档）、路径、更新时间
- 工作流和阶段（open/design/build/verify/archive）——以生命周期步进条展示
- 任务完成度（completed/total、未完成项、各 section）——以环形图展示
- artifact 按来源分组（OpenSpec / Superpowers / Comet），每组内显示存在性状态（已生成/未生成/无需生成）
- artifact 存在性（proposal、design、tasks、plan、verifyReport、cometYaml）+ 内容预览（最大 256 KiB，含文件大小和更新时间元数据）
- verify 结果（pending/pass/fail/unknown）和摘要
- 下一步（仅活跃 change）：推荐的 slash 命令和原因
- 风险项（info/warning/error 级别 + 恢复建议）
风险码
自动刷新与主题
前端每 30 秒自动刷新一次，也有手动刷新按钮、搜索框和标签页（活跃/归档/全部）。artifact 抽屉带一个简易 Markdown 渲染器。 顶部工具栏右侧有亮色/暗色主题切换按钮：首次访问按系统偏好（prefers-color-scheme）选择，手动切换后持久化到 localStorage。详见 Dashboard 总览 · 主题切换。
演示模式
在 URL 加?demo 可以加载演示数据（不读真实 change），方便预览界面：
安全
- 服务器只绑定
127.0.0.1（localhost），不对外暴露。 - 静态文件服务有路径穿越防护。
- artifact 预览有大小限制（256 KiB，超出标记
truncated）。 - artifact 抽屉打开时保留页面滚动位置；关闭后回到打开前的位置。
下一步
- Dashboard 总览 — 仪表盘界面、产物分组、主题切换和截图
- comet status — 命令行版的活跃 change 状态
- comet doctor — 安装和健康诊断