用途:把一个自动运行的站内反馈闭环安装进任意网站仓库。访客点击浮动“提个建议”按钮提交建议,建议变成 GitHub Issue,后续由仓库自己的 GitHub Actions 驱动的 Claude Code 处理、提交并部署,全过程不需要额外服务或后端。
主要能力:安装浮动反馈按钮(预填 GitHub Issue,无需后端、客户端无密钥);提供 .github/workflows/feedback.yml 工作流,流程为白名单校验→Claude Code Action→自动提交→推送 main(自动部署)→更新台账与仪表盘→关闭 Issue;提供 /_feedback 仪表盘,展示每条建议、Claude 的动作、提交与状态,并支持一键回滚;安装 .feedback/ 运行时文件,包括 feedback-lib.mjs、feedback-finalize.mjs、INSTRUCTIONS.md、feedback-ledger.json、config.json。
使用方式:阅读 references/install.md 并在目标仓库中按步骤操作。它会检测站点类型(Hugo / Next.js / Astro / 静态站点),复制资源、注入组件,并只要求用户提供两项信息:GitHub 用户名白名单,以及认证方式(通过 claude setup-token 获取 Pro/Max OAuth token,或使用自己的 ANTHROPIC_API_KEY)。回滚由同一条闭环处理,触发方式为 revert: #N Issue。
部署触发注意事项:工作流用内置 GITHUB_TOKEN 推送到 main。若使用外部 push-deploy 托管(Cloudflare Pages git-connect、Vercel、Netlify),其 webhook 会在每次推送时触发,机器人提交会自动部署,无需额外操作。若部署本身是同一仓库里的 GitHub Actions 工作流(例如通过 Actions 的 GitHub Pages),GitHub 不允许 GITHUB_TOKEN 推送触发另一个工作流,部署工作流的 on: push 不会触发,改动落到 main 但不会上线;需给部署工作流添加 workflow_run 触发器桥接(见 references/install.md 第 4.5 步)。
适用场景与限制:运行在用户自己的仓库中并使用自己的认证;提交者需要 GitHub 账号,只有白名单内的作者会触发处理。它不是托管服务,不提供匿名提交、计费或多租户能力;未来可能的 GitHub-App 打包会复用现有资源。价格与具体效果资料未说明。