用途:Docforge Dashboard 是 docforge 技能的一个薄入口,本身没有独立运行时,需先安装 docforge 技能并加载其共享 cartridge(../docforge/_shared/README.md)。它把已写好的文档预览为本地可浏览站点,只重建发生变化的部分,且不会触碰仓库自身的 package 文件。
主要能力:提供 scan(只读诊断:缺失元数据、不完整或缺失文档、过期来源、断链、未跟踪的 docs/ 文件)、start(按需构建→启动服务→打开浏览器)、export(按需构建→静态 HTML 导出,每页生成 index.html,如 /docs 对应 out/docs/index.html,适合 GitHub Pages、S3 等静态托管)、status(只读状态)、stop(关闭后台开发服务器)。支持 --force、--plan-only、--auto-accept、--no-open、--port N、--help 等标志。
使用方式:先锁定会话引擎(python3 或 node),再从 cartridge 根目录运行,例如 python3 runtime/cli/python/dashboard.py scan --repo <repo> [--json]、start --repo <repo> [--force] [--plan-only] [--no-open]、export --repo <repo>;node 版本为 node runtime/cli/js/dashboard.js 加相同子命令。
适用场景:本地预览与静态导出文档站点。
限制:dashboard 范围基于 manifest 分组,agent-context 记录不会成为页面;无面向人的文档时直接返回;start 前有三项预检,阻断性发现会阻止构建;旧版 manifest 会自动迁移且始终打印;仓库内容视为不可信输入,仅作诊断,不直接执行;--auto-accept 不会抑制扫描或构建失败提示,也不授权安装 Node.js、修改 package 文件或删除 dashboard 目录。其余细节暂未提供。