# feedlog

**Repository Path**: chanalbert/feedlog

## Basic Information

- **Project Name**: feedlog
- **Description**: FeedLog 是一款开源工具，帮助 SaaS 团队收集用户反馈、管理功能需求、公开产品路线图并发布更新日志，在产品和用户之间建立持续的反馈闭环。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://github.com/linkcraftstudio/feedlog
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-21
- **Last Updated**: 2026-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/banner.png" alt="FeedLog — 开源 AI 客服与用户反馈平台" width="100%" />

# FeedLog

**开源 AI 客服与用户反馈平台**

AI 驱动的客户支持，通过 Widget、反馈看板和自动迭代的知识库，减少 90% 的人工客服时间，节省团队人力和精力。开源，支持自建部署。

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![Discussions](https://img.shields.io/github/discussions/linkcraftstudio/feedlog)](https://github.com/linkcraftstudio/feedlog/discussions)
[![Stars](https://img.shields.io/github/stars/linkcraftstudio/feedlog?style=social)](https://github.com/linkcraftstudio/feedlog)
[![Discord](https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord&logoColor=white)](https://discord.gg/9rj64WXESn)
[![X](https://img.shields.io/badge/X-@feedlog__ai-000000?logo=x&logoColor=white)](https://x.com/feedlog_ai)

[English](./README.md) | 简体中文

🌟 [官网](https://feedlog.ai) | [帮助文档](https://help.feedlog.ai/) | [在线体验](https://feedback.feedlog.ai/) | [社区讨论](https://github.com/linkcraftstudio/feedlog/discussions)

</div>

---

## 痛点

- **客服需求在不知不觉中变多。** 早期由团队亲自回复用户问题，重复咨询持续增加，人力成本与运营负担随之上升。
- **产品知识容易滞后。** 产品更新后，文档和 AI 回答往往无法及时同步。
- **核心团队难以保持专注。** 产品、研发频繁被客服事务打断，拖累产品迭代进度。
- **转人工时，上下文容易丢失。** 用户需要复述问题，处理效率和体验双双下降。
- **用户反馈缺少结构化沉淀。** 需求和 Bug 分散在各类对话中，团队难以梳理规律、确定优先级、评估支持效果。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/pain-points.png" alt="从消息井然到反馈迷失" width="100%" />

## 我们的愿景

**你或许认为暂时不需要客服。但只要创始人、产品或开发人员在回复用户，就已经在承担客服工作。**

FeedLog 无需你搭建昂贵的专职客服团队，也能留住客户支持的价值：AI 根据最新的产品知识应答重复问题，仅在必要时交给人工处理。

每一个 SaaS 团队都应当持续倾听、服务用户，无需在时间和人力成本的压力下，牺牲客户支持的价值。FeedLog 依靠 Widget 和 Inbox 承接咨询，通过反馈看板和路线图打通用户声音与产品规划，再通过更新日志向提需求的用户同步迭代进展，让客户支持持续为你的产品创造价值。

## FeedLog 实际演示

<https://github.com/user-attachments/assets/3e5e5f6d-eb07-4139-823f-564b1fd4f462>

## 为什么选择 FeedLog？

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/product-loop.png" alt="FeedLog 从客户支持到产品反馈的三步闭环" width="100%" />

*FeedLog 把客户支持和产品工作连成一个持续的闭环。*

### 核心功能

#### 1. 集成 AI 支持、帮助文档与反馈收集的客服组件

一站式承载 AI 答疑与用户反馈，减少大量重复工单，高效捕获产品侧的有效信号。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/feature-widget.gif" alt="嵌入产品中的 FeedLog Widget" width="100%" />

#### 2. 一体化客服会话工作台

AI 和人工客服共用一套收件箱，团队统一管理，接手复杂问题时可获取完整的对话上下文，更快完成处理。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/feature-inbox.gif" alt="FeedLog Inbox" width="100%" />

#### 3. 依托知识库、持续自我迭代的 AI 智能助手

让 Agent 基于最新的产品知识和上下文，可靠地回答重复性问题，减少人工客服工作，并从每次对话中持续改进。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/feature-help-center.gif" alt="Agent 使用的 FeedLog 帮助中心" width="100%" />

#### 4. 打通反馈、路线图与更新日志

对话自动沉淀为可排序的需求，帮团队找准开发重心；用户也能直观看到自己的反馈落地上线。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/feature-feedback-roadmap-changelog.gif" alt="FeedLog 反馈看板、路线图与更新日志" width="100%" />

### 在线体验

**体验真实运行中的 FeedLog：[feedback.feedlog.ai](https://feedback.feedlog.ai)**

我们也在使用 FeedLog 为自己的用户提供支持、收集产品反馈，并管理产品路线图。

通过真实的产品使用场景，了解 FeedLog 如何帮助 SaaS 团队利用 AI 客服快速解答用户问题、减少人工客服工作量，并将客户反馈转化为持续优化产品的依据。

### 面向以下 SaaS 团队设计：

- 长期重复处理同类客户咨询；
- 需要从 AI 支持到人工介入的顺畅通道；
- 希望从客户对话中获取产品决策依据。

## 快速开始

只需要三个阶段即可开始使用 FeedLog：

1. 启动 FeedLog。
2. 配置 AI 客服。
3. 将 Widget 接入产品并完成测试。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/quick-start-steps.png" alt="FeedLog 三步快速开始" width="100%" />

如果你不确定选择哪种部署方式，建议先使用 Hosted 云端版。

### 1. 启动 FeedLog

#### Hosted 云端版

这是最简单的开始方式。FeedLog 负责运行服务，你不需要自己准备服务器或数据库。

**[创建 FeedLog 工作区 →](https://auth.feedlog.ai/)**

#### Self-Hosted 自托管

如果你希望在自己的基础设施上运行 FeedLog，可以选择自托管。FeedLog 需要带有 [`vector`](https://github.com/pgvector/pgvector) 扩展的 PostgreSQL 17+ 数据库。

<details open>
<summary><b>部署到云平台</b></summary>

两个平台都会把仓库 fork 到你的账号下，并提示填写必需的环境变量，之后自动完成构建和部署。

| 部署到 Cloudflare Workers | 部署到 Vercel |
| :---: | :---: |
| [![][cf-deploy-img]][cf-deploy-link] | [![][vercel-deploy-img]][vercel-deploy-link] |

详见 [Cloudflare Workers 部署指南](./docs/deploy/cloudflare-workers.md)和 [Vercel 部署指南](./docs/deploy/vercel.md)。

</details>

<details open>
<summary><b>使用 Docker 部署</b></summary>

```bash
git clone https://github.com/linkcraftstudio/feedlog.git
cd feedlog
echo "BETTER_AUTH_SECRET=$(openssl rand -hex 32)" > .env
echo "SYSTEM_ADMIN_EMAILS=you@example.com" >> .env
docker compose up -d
```

启动后，通过 `http://localhost:3000` 访问 FeedLog。详见 [Docker 部署指南](./docs/deploy/docker.md)。

</details>

> [!IMPORTANT]
> 请在创建账号之前设置 `SYSTEM_ADMIN_EMAILS`。列在其中的邮箱注册后会成为工作区所有者；在加入列表之前就已注册的账号，之后不会再被提升。没有所有者，就没有人能管理控制台。全部环境变量见[配置说明](./docs/configuration.md)。

自托管还需要配置模型服务才能使用 AI 功能。具体的部署方式和配置要求，请查看[自托管文档](https://help.feedlog.ai/self-hosting/overview)。

### 2. 配置 AI 客服

#### 添加产品知识

进入 FeedLog 工作区的帮助中心，为以下内容创建文章：

- 常见产品操作流程
- 用户权限和功能限制
- 常见问题和解决方法
- 需要人工支持的情况

为希望 FeedLog Agent 使用的文章打开 **允许 AI 使用**。

建议先从客服团队最常遇到的问题开始，不需要在试用前整理完所有文档。

#### 配置 Agent 行为

启用 Agent 前：

1. 检查反馈看板，区分 Bug、功能需求和产品改进。
2. 打开 **工作区设置 → 反馈组件**。
3. 添加客服邮箱。
4. 设置哪些情况需要向客户提供人工支持指引。
5. 决定客户如何登录：在 **工作区 → 访客权限** 中允许访客访问，或通过 SSO 接入产品已有的用户账号。

FeedLog Agent 和 Widget 使用同一个接入方式，不需要单独安装 Agent。

详见 [Agent 配置文档](https://help.feedlog.ai/agent/setup)。

### 3. 将 Widget 接入产品

安装 Widget：

```bash
npm install @feedlog/widget
```

在应用中初始化：

```ts
import { createWidget } from '@feedlog/widget'

createWidget({
  baseUrl: 'https://your-workspace.feedlog.ai',
  theme: 'auto',
})
```

在 **工作区设置 → 反馈组件** 中复制工作区地址，填写到 `baseUrl`。如果你的产品已有用户账号，请参考 [Widget 与 SSO 接入文档](https://help.feedlog.ai/developers/widget)。

#### 上线前测试

在测试页面打开 Widget，检查以下场景：

- 提出一个帮助中心中已有答案的问题。
- 继续追问一个相关问题。
- 提交一个 Bug 或功能需求。
- 针对账号问题请求人工支持。
- 检查反馈是否被正确保存。

确认一切正常后，再向客户开放 Widget。

## 功能列表

| 功能 | 说明 |
| --- | --- |
| FeedLog Agent | 基于帮助中心回答产品问题，并通过自然对话管理客户反馈。 |
| 产品 Widget | 让客户直接在产品内提问、查看帮助文章和提交反馈。 |
| 帮助中心 | 创建可搜索的分区和文章，并选择 Agent 可以作为产品知识使用的内容。 |
| Inbox | 在一个地方管理 Widget 对话、人工转接和邮件回复通知。 |
| 反馈看板 | 通过帖子、投票、评论和状态流程，统一管理 Bug、功能需求和产品改进。 |
| 相似反馈检测 | 发现相关反馈，在重复需求分散之前将其合并。 |
| 路线图 | 通过公开路线图展示计划中、进行中和已完成的工作。 |
| 更新日志 | 发布产品更新，并根据更新要点和相关反馈用 AI 起草更新说明。 |
| 人工支持指引 | 针对账单、账号、隐私等需要人工处理的问题，配置客服邮箱和处理规则。 |
| 认证与 SSO | 支持邮箱密码、Google、GitHub、访客访问和产品已有账号。 |

## 关注我们

⭐ 在 GitHub 上为 FeedLog 点亮 Star，第一时间了解最新版本和改进！

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/star-guide.gif" alt="在 GitHub 上为 FeedLog 点亮 Star" width="100%" />

## 技术栈

| 层级 | 选型 |
| --- | --- |
| 框架 | Nuxt 4、Vue 3、Nitro 和 TypeScript |
| 数据库 | PostgreSQL 17+，使用 `pgvector` 存储向量 |
| ORM / 驱动 | Drizzle ORM 和 `postgres-js` |
| 认证 | better-auth，支持邮箱密码、Google OAuth、GitHub OAuth 和管理员角色 |
| AI | 兼容 OpenAI 的 API，包括 OpenAI、Azure OpenAI、LiteLLM 和 Ollama |
| 文件存储 | Cloudflare R2、Vercel Blob 或任意 S3 兼容存储 |
| 状态管理 | Pinia |
| UI | Tailwind CSS v4、shadcn-vue 和 Lucide Icons |
| 编辑器 | Tiptap 3 和 CodeMirror 6 |
| 部署目标 | Cloudflare Workers、Vercel 和 Node.js Docker |
| 包管理器 | pnpm |

## AI 集成

FeedLog 通过 MCP 和 Skills 与 AI 应用和编程 Agent 协作。

- **FeedLog MCP**：将 Claude、ChatGPT、Claude Code、Codex、Cursor 等兼容 MCP 的客户端连接到已授权的 FeedLog 组织，用自然语言查询和管理反馈、看板、重复需求、帮助中心文章和更新日志。
- **FeedLog Skills**：为编程 Agent 提供 FeedLog 的产品知识、接入说明和任务指引。可以用 Skills 接入 Widget 和 SSO、根据代码库起草帮助中心文章，以及处理日常 FeedLog 任务。

在项目中安装 FeedLog Skills：

```bash
npx skills add linkcraftstudio/feedlog-skills
```

MCP 用于访问你的 FeedLog 组织数据；Skills 帮助编程 Agent 理解 FeedLog 并处理你的项目代码。两者可以一起使用，也可以单独使用。

详见 [MCP 与 Skills 指南](https://help.feedlog.ai/mcp)。

## 路线图

FeedLog 在公开的开发过程中持续改进，并根据使用团队的反馈完善产品。接下来的规划会重点放在让客户支持对 SaaS 团队更有用，以及让客户支持、产品反馈和产品开发之间的衔接更容易管理。

<img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/roadmap-board.png" alt="FeedLog 产品路线图看板" width="100%" />

你可以查看[公开路线图](https://feedback.feedlog.ai/roadmap)，了解哪些功能正在规划、开发和已经完成。

## 参与贡献

欢迎提交代码、文档和测试的 Pull Request。报告 Bug、提出改进建议，或者不确定从哪里开始，都可以通过[社区与联系方式](#社区与联系方式)中的渠道找到我们。

### 本地开发

你需要 Node.js、pnpm，以及带有 [`vector`](https://github.com/pgvector/pgvector) 扩展的 PostgreSQL 17+ 数据库。

```bash
git clone https://github.com/linkcraftstudio/feedlog.git
cd feedlog
pnpm install
cp .env.example .env  # 填写 DATABASE_URL、BETTER_AUTH_SECRET、SYSTEM_ADMIN_EMAILS
pnpm migrate          # 初始化数据库结构
pnpm dev              # http://localhost:3000
```

完整的开发环境配置和 Pull Request 流程，请查看 [`CONTRIBUTING.md`](./CONTRIBUTING.md)。

- 所有提交都需要按 [DCO](https://developercertificate.org/) 签名（`git commit -s`）。
- 请遵守 [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md)。

## 社区与联系方式

如需了解更多信息，请联系 [feedlog.oss@outlook.com](mailto:feedlog.oss@outlook.com)。

- **GitHub Issues：** 报告 Bug、提出功能需求并跟踪项目开发。[提交 Issue](https://github.com/linkcraftstudio/feedlog/issues)
- **Discord：** 获取实时支持、加入社区交流并了解最新动态。[加入 Discord](https://discord.gg/9rj64WXESn)
- **GitHub Discussions：** 分享想法、提出问题并讨论产品使用场景。[参与讨论](https://github.com/linkcraftstudio/feedlog/discussions)
- **帮助文档：** 了解 FeedLog 的部署、配置和使用方式。[查看文档](https://help.feedlog.ai/)
- **微信群：** 扫描下方二维码，加入 FeedLog 共创讨论群。

  <img src="https://cdn.feedlog.ai/se/feedlog/oss/readme/contact-us-wechat.png" alt="FeedLog 微信群二维码" width="200" />

- **安全问题：** 如果发现安全漏洞，请通过邮件私下报告。详见[安全策略](./SECURITY.md)。

## 许可证

[MIT](./LICENSE) © 2026 LinkCraft Studio

[cf-deploy-img]: https://deploy.workers.cloudflare.com/button
[cf-deploy-link]: https://deploy.workers.cloudflare.com/?url=https://github.com/linkcraftstudio/feedlog
[vercel-deploy-img]: https://vercel.com/button
[vercel-deploy-link]: https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Flinkcraftstudio%2Ffeedlog&project-name=feedlog&repository-name=feedlog&env=DATABASE_URL,BETTER_AUTH_SECRET,SYSTEM_ADMIN_EMAILS&envDescription=DATABASE_URL%3A%20Postgres%20connection%20string%20with%20pgvector%20enabled%20(Neon%20or%20Supabase%20from%20the%20Vercel%20Marketplace%20works%20out%20of%20the%20box).%20BETTER_AUTH_SECRET%3A%2032%2B%20char%20random%20string%20(run%20%60openssl%20rand%20-hex%2032%60).%20SYSTEM_ADMIN_EMAILS%3A%20your%20email%2C%20granted%20admin%20role%20on%20first%20sign-up.&envLink=https%3A%2F%2Fgithub.com%2Flinkcraftstudio%2Ffeedlog%2Fblob%2Fmain%2Fdocs%2Fdeploy%2Fvercel.md