# Qingtian Dashboard

> 当用户要求打开、启动或查看擎天大盘、当前项目的 AI 开发体系大盘或跨项目产物大盘时使用；仅讨论大盘设计、修改业务页面或询问体系接入不触发启动。

- Skill: `peiiii/qingtian-dashboard` (Agent Skill)
- Install (CLI): `npx get-skill add peiiii/qingtian-dashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/peiiii/qingtian-dashboard/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: peiiii (https://skillmd.com/u/peiiii)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/peiiii/qingtian-dashboard

---


# 打开擎天大盘

完成结果是当前项目可用的大盘及用户能打开的地址，也可切换其它已接入项目。直接执行已授权的启动请求；不要只返回命令让用户再操作，也不要为查看大盘进入完整开发流程。

1. 在当前项目目录检查 `node --version` 和 `qingtian --version`。已有可用命令直接使用；缺少命令且 Node.js >=22.12 时执行官方安装 `npm install -g @nextclaw/qingtian --ignore-scripts --registry=https://registry.npmjs.org`，再核验版本。Node 版本不足、离线或 npm 权限失败时报告具体缺口，不用 sudo、改权限或猜包名；可用 `npx --yes --package=@nextclaw/qingtian qingtian dashboard` 避免全局写入失败，但不能解决不支持的 Node 或断网。
2. 若当前会话已有大盘完整地址、服务仍可用且显示当前项目，可复用并重新读取；否则从当前项目目录运行 `qingtian dashboard`。默认优先识别当前项目（含从子目录启动），首页展示它的推进、关注与产物；其它接入项目可在侧栏切换。仅用户指定扫描范围时用 `--root <绝对目录>`；可重复指定。当前项目位于其它位置、需要长期加入时用 `qingtian projects add <绝对目录>`。
3. 保持服务运行：使用宿主提供的持久终端/执行会话；不要在普通会被销毁的短进程里启动后立即退出。CLI 默认自动打开浏览器；宿主需要自己展示页面时可用 `--no-open`，取得实际输出的完整 URL 后用宿主的打开浏览器/文件面板工具打开。没有可用页面工具时给用户完整可点击地址。不要猜固定端口或复用已过期的会话凭据。
4. 验证真实可用性：查看页面已加载当前项目/产物或明确的空态；无法看页面时用输出 URL 的 fragment 中 token 作为 Bearer 凭据读取同一地址的 `/api/snapshot`，要求 HTTP 200 和有效项目列表，并核对 `currentProjectId` 对应当前项目。若当前目录尚未接入、或用户指定扫描范围不包含当前项目，明确说明总览需要选择项目；不擅自接入项目。仅进程启动或静态首页 HTTP 200 不足以说明数据可读。输出项目数只是此次快照，不表示所有项目完成。

返回大盘已打开/已启动、实际入口和停止方式（对应终端 Ctrl+C）。说明当前项目不在列表、扫描警告或宿主无浏览器等真实边界；已成功的启动不重装 CLI、不重启其它任务的服务。

完整 URL 的 token 只供当前用户本机使用；不提交到项目文档或外发。大盘只读文档，不承担自动执行、任务状态修改或云端部署。

