用途:把独立 HTML 设计文档发布到 GitLab Pages,并让评审者选中任意文字后点击浮动 💬 气泡,在新标签页打开预填标题、描述和标签的 GitLab Issue,实现与具体段落绑定的上下文反馈。仅使用 GitLab 免费功能,无外部服务、无页内 API 调用。
主要能力:GitLab Pages 在每次合并到 main 时自动发布 HTML;小型 JS 组件监听文本选择,点击后跳转到 GitLab 新建 Issue 页面,由用户现有会话 Cookie 完成认证;注入脚本为标题、图表、表格添加锚点 id,并注入评论组件资源,且可重复运行不重复注入。
使用方式:将 templates/gitlab-ci-pages.yml 复制进项目 .gitlab-ci.yml 并替换 <VERSION> / <MAIN_HTML>;提交每页配置 comments-issue.json,填写 gitlabHost、projectPath、pageUrl、titlePrefix、issueLabels;发布前运行 python3 scripts/validate-html.py docs/v1.0.0/tech-design.html 校验标签平衡与锚点。合并到 main 后,在 Settings → Pages 查看实际访问地址。
适用场景:团队评审技术设计文档(HTML 或 Markdown);需要公开 URL 查看样式化 HTML;希望针对具体句子留下会议反馈。
限制:不适用于应放入 GitLab Wiki 的文档(Wiki 原生渲染 Markdown 并自带评论);不适用于单人评审(应使用 MR 行评论);不适用于没有 GitLab 账号的外部/公开受众。具体收费、价格、平台支持范围等资料暂未提供。