Feedbacks

反馈

免费、采用 Apache-2.0 许可的可视化反馈、会话回放和调试上下文。

通过截图、精确的文本建议或视频 + 会话录制展示问题。将讨论、事件时间线、浏览器诊断信息和已批准的项目上下文放在一起。您的团队和编码 Agent 可以调查证据、实施商定的更改并记录验证结果。完整产品可免费自托管；基础设施和您使用的任何 AI 工具均由您提供。

请先设置团队服务。 顺序如下：服务 → 安装并连接 Chrome 扩展 → 项目上下文、可选的 GitHub App 和成员 → 每位开发者各自的 MCP 设置。一次安装即可服务整个团队；扩展不会托管服务。请参阅完整设置流程，或单独的 DevOps 安装指南。

网站 · 为什么选择 Feedbacks · 自托管 · 扩展 · 编码助手和插件 · API 和 MCP · 路线图 · 参与贡献

功能介绍

• 准确展示更改内容： 截图标注、批注、整页截图和选中文本替换建议。
• 回放问题： 视频或仅录制会话，活动、控制台、网络和性能信息汇聚在同一时间线上。保存并批注画面。
• 获取证据： 完整的问题线程包，包含讨论、媒体、录制内容、诊断信息和校验和；按范围读取的 Agent 数据以及录制导出。
• 为 Agent 提供上下文： 通过 MCP、API 和 CLI 提供已批准的项目指引、审核者指南和职责。
• 推动工作进展： 分配任务、分类、添加标签、保存视图并跟踪点数进度；还可选择跨仓库和安装实例使用 GitHub Issues，配置多个 App，并为每个项目选择一个所有者指定的 App。
• 在扩展之外进行审核： 按范围生成访客链接、审核 PDF/图片、可选的文本小组件、问卷/NPS、定期执行公开页面 QA、原生移动客户端和签名 Webhook。
• 掌控整个服务： 采用 Apache-2.0 许可的服务端和客户端、PostgreSQL 及私有 S3 兼容存储。一次安装服务于一个组织。

录制指南 · 调试包 · 文本建议 · 更多审核工作流

Feedbacks 是一个早期 0.x 版本。每个应用部署服务于一个组织。公开注册、计费、SSO 和共享数据库客户租户功能尚未实现。请参阅架构和部署边界。

使用 Docker 试用

curl -fsSL https://feedbacks.softinator.ai/install.sh | bash

使用生成的所有者登录信息打开 http://localhost:3000。PostgreSQL 数据和截图保存在 Docker 卷中；无需 S3 账户或构建源代码。安装程序需要 Docker Compose、Bash、curl 和 OpenSSL，并会保留已有的安装目录。请参阅快速入门和生产环境指南。

从源代码开发

要求：Node.js 22 或 24、npm，以及用于 PostgreSQL 的 Docker Compose。

git clone https://github.com/Softinator-TechLabs/feedbacks-oss.git
cd feedbacks-oss
npm ci
cp .env.example .env
docker compose -f compose.dev.yaml up -d --wait
npm run bootstrap
npm run build
npm run dev:server

初始化前，请在本地 .env 中添加 BOOTSTRAP_EMAIL、BOOTSTRAP_NAME 和唯一的 BOOTSTRAP_PASSWORD。初始化只会创建一次首位所有者。之后请移除初始化密码。打开 localhost:3000。示例数据库密码仅用于仅监听回环地址的开发数据库。

如需实时编辑客户端，请在另一个终端运行 npm run dev:web，并在重启服务前于 .env 中设置 APP_ORIGIN=http://localhost:5173。在浏览器中使用该来源地址。对于独立的公共网站，请使用 npm run dev:site。

生产环境需要 HTTPS、PostgreSQL 和私有的 S3 兼容存储。请按照部署指南进行配置、首次所有者设置和恢复。

如需通过镜像仓库部署，请使用公开的 Docker Hub 镜像和镜像仓库 Compose 文件；图解存储指南将五项前提条件对应到各个环境字段。开发者只需两条命令即可安装打包的 Claude Code 和 Codex 插件，然后连接自己的限定范围密钥。

插件目录状态

截至 2026 年 10 月 21 日。Claude Code 和 Codex 的直接安装已可通过我们的公共市场获取。

官方目录	当前状态
Claude Code	版本 0.2.2 已通过安全扫描。已申请发布，正在等待 Anthropic 审核；目前尚未出现在官方目录中。
OpenAI	本地命令/stdio MCP 提交权限正在等待 OpenAI 审核。该软件包目前尚无法提交至官方目录或在其中发布。

这些审核尚无已确认的发布日期。现在即可使用直接安装说明；目录状态不会改变可自托管的 Apache-2.0 产品。请参阅 Agent 设置和分发边界。

浏览器扩展

使用 npm run build:extension 构建。通过 Chrome 的 Load unpacked 加载 dist/extension/unpacked/ 目录，或使用 dist/extension/ 中的 ZIP 文件。输入你自己的 Feedbacks 服务地址，并在 Web 应用中批准配对。授予全网站权限是单独的可选操作。现有的已保存服务连接仍可使用。

仓库目录结构

路径	职责
src/server/	身份验证、项目访问、业务操作、持久化和传输
src/shared/	类型化的操作输入、输出和说明
src/web/	经过身份验证的 React 应用
src/cli/	引导、JSON 命令行和 stdio MCP 适配器
plugins/	Codex 和 Claude Code 插件包与评审技能；MCP 捆绑包在构建时生成
extension/	Chrome Manifest V3 捕获与评审扩展
site/	可独立部署的公开网站
tests/	隔离的授权、传输和数据库测试
ops/	通用部署配置
docs/	面向公众的贡献者与运维人员文档

Agent 开发

请从 AGENTS.md 和文档目录开始。Claude Code 和 Gemini CLI 使用轻量适配器来遵循相同的说明。请参阅支持的技能与客户端设置。如需使用合成数据且不需要部署凭据的隔离应用：

npm ci
npm run harness:dev

该命令会构建应用，并输出其环回 URL 和私有本地访问文件的路径。每次运行都会使用一次性数据库和独立端口。

开发

npm run check
# Optional native PostgreSQL concurrency tests (initdb and pg_ctl on PATH):
npm run test:postgres

check 会运行格式检查、架构与文档检查、类型检查、测试、所有构建、隔离应用冒烟检查和发布内容检查。CI 还会运行原生 PostgreSQL 测试、依赖项审计和密钥扫描。构建通过并不代表已部署到生产环境，也不代表具备相应容量。

许可证与社区

应用、扩展和网站源代码采用 Apache-2.0 许可证。依赖项保留各自的许可证。请阅读贡献指南、社区准则、安全问题报告说明和商标指南。