常见问题#

Dockrev 能管理哪些部署形态？#

主要针对 Docker Compose 项目。系统通过 Compose labels 自动发现服务。

必须使用 GHCR 吗？#

不是。Dockrev 可读取通用 registry 信息；GHCR webhook 是增量触发能力。

为什么我在 Settings 看不到 PAT 明文？#

安全设计：后端只返回掩码（例如 PAT 的 ****** 或部分密钥的圆点掩码），防止凭据回显泄漏。

什么时候需要 DOCKREV_IMAGE_REPO？#

当你希望 UI 正确识别“Dockrev 自身服务”并显示“升级 Dockrev”入口时。

可以把 docs/plan 与 docs/specs 作为用户文档吗？#

不建议。这两类目录是工程内部规格资产，不是稳定用户手册。

是否支持自动发布文档站？#

支持。仓库内 docs-pages workflow 会一起发布 docs 根站、公开 Demo 和 Storybook。

Demo 和 Storybook 有什么区别？#

• 公开 Demo 对应 /demo/，复用真实 app 路由与 seeded mock state，可分享深链、可交互假写。
• Storybook 是 QA / 组件 / 页面状态图库，不替代产品 demo。