分类导航
发现更多优质 AI 工具
Docusaurus
Docusaurus 全指南官网： https://docusaurus.io/zh-CN/定义： Meta（原 Facebook）开源、基于 React 的静态文档站点生成器，主打内容建站、快速搭建文档/博客官网。一、平台介绍Docusaurus 是 Meta 开源、MIT 开源协议的现代化静态站点生成工具。2017 年首发，当前主流为 V3 版本。核心设计： 文档即代码，只用 Markdown/MDX 写内容，自动生成 SPA（单页应用）静态网站。底层技术： 基于 React + Webpack，构建后输出纯静态 HTML/CSS/JS，可部署至任意静态服务器。设计初衷： 解决开源项目重复搭建文档站、重复造轮子的问题。Redux、React Native、Testing Library、IOTA、Temporal 等知名项目官方文档均使用本框架。定位： 不止用于技术文档，还能制作产品官网、知识库、个人博客、教程站点。二、主要核心功能1. MDX 文档引擎（核心）内容支持： 原生支持 Markdown 和 MDX。MDX 可在文档内嵌入 React 组件、交互式代码块。渲染体验： 普通 md 文档直接渲染网页，无需手写 HTML。扩展语法： 内置文档提示块、代码高亮、Mermaid 流程图、目录锚点（右侧 TOC）等。2. 文档版本化功能： 一键生成多版本文档，适配软件迭代。操作： 执行 docusaurus docs:version 2.0，用户可在顶部下拉菜单切换 V1/V2/V3 历史文档，文档发版与产品版本一一对应。3. 多语言国际化（i18n）功能： 开箱即用本地化，支持 Crowdin/Git 批量翻译。实现： 文档按语种存放，网站一键切换中英文或多语言，支持独立部署不同语言站点。4. 内置全文搜索（Algolia）搜索： 原生集成 Algolia DocSearch，开源项目免费申请搜索索引，实现全站内容秒搜。私有化： 私有项目可付费升级 Algolia 商业版。5. 博客 + 官网一体化博客模块： classic 模板自带博客功能，/blog 目录写 md 自动生成博文列表。独立页面： src/pages 可自定义独立页面，快速制作产品首页、关于页。6. 主题与暗黑模式外观： 默认主题自带亮色/暗黑一键切换，支持自定义 CSS。深度定制： 通过 Swizzle 机制修改 React 组件，深度定制页面布局、导航、侧边栏。7. 插件扩展生态插件架构： 评论、统计、图片优化、API 文档生成、RSS 订阅等均可通过第三方插件接入。数据复用： 支持复用已有插件数据。8. 自动化部署产物： 构建产物为 build 纯静态文件夹。部署： 支持一键部署至 GitHub Pages、Vercel、Netlify 或 Nginx 服务器。三、适用人群开源项目开发者： 开源库、组件、框架维护者，快速搭建开源官方文档（如 Redux、React 生态通用选型）。企业产品/研发团队： 产品帮助文档、API 手册、内部知识库、运维手册。个人博主/技术作者： 技术博客、读书笔记、个人知识库站点。内容运营/培训机构： 在线教程、课程文档、产品官网。⚠️ 不适合人群： 需要纯在线协作编辑文档的用户（如石墨/飞书文档模式）。Docusaurus 采用源码 +Markdown 离线编写、静态部署模式。四、免费与付费详情✅ Docusaurus 框架本体：永久 100% 免费协议： MIT 开源协议，无任何软件授权费。限制： 无项目数量限制，无商用收费。个人/企业/商业项目可随便商用、二次修改源码。自带功能： 基础主题、文档/博客/版本/多语言/搜索（开源版）全功能免费。搜索： 开源项目可申请 Algolia DocSearch 免费索引；私有商业站点 Algolia 按需付费升级。⚠️ 潜在自费项（非框架收费）服务器与域名：免费部署： GitHub Pages（公开仓库）、Vercel 免费套餐、Netlify 免费套餐。付费： 自有云服务器、独立域名、Vercel/Netlify 企业套餐（针对大流量站点）。定制开发： 深度定制页面、自研插件需前端人力成本。第三方增值服务： Algolia 商业搜索、付费主题、评论服务（Giscus 免费，Disqus 付费）。五、完整使用步骤（快速上手，5 分钟建站）前置环境安装 Node.js ≥ 16.14（建议官网下载 LTS 版本）。1. 初始化新项目（终端执行）bash# 经典模板（含文档 + 博客，推荐） npx create-docusaurus@latest my-doc-site classic # TS 版本项目（可选） npx create-docusaurus@latest my-doc-site classic --typescript # 经典模板（含文档 + 博客，推荐） npx create-docusaurus@latest my-doc-site classic # TS 版本项目（可选） npx create-docusaurus@latest my-doc-site classic --typescript 注：my-doc-site 为项目文件夹名，可自定义。2. 本地预览调试bashcd my-doc-site npm start # 启动本地服务，访问 http://localhost:3000，修改 md 实时刷新 cd my-doc-site npm start # 启动本地服务，访问 http://localhost:3000，修改 md 实时刷新 3. 核心目录结构（写文档只需关注 2 个文件夹）├── docs/ # 存放所有技术文档（新建 xxx.md 自动生成页面） ├── blog/ # 博客文章目录，md 文件自动生成博文 ├── src/ │ ├── css/ │ │ └── custom.css # 全局自定义样式 │ └── pages/ # 自定义独立页面 ├── docusaurus.config.js # 网站全局配置（标题、导航、logo、域名） ├── sidebars.js # 侧边栏目录配置 ├── static/ # 图片、图标等静态资源 ├── docs/ # 存放所有技术文档（新建 xxx.md 自动生成页面） ├── blog/ # 博客文章目录，md 文件自动生成博文 ├── src/ │ ├── css/ │ │ └── custom.css # 全局自定义样式 │ └── pages/ # 自定义独立页面 ├── docusaurus.config.js # 网站全局配置（标题、导航、logo、域名） ├── sidebars.js # 侧边栏目录配置 ├── static/ # 图片、图标等静态资源 新增文档： 在 docs 新建 安装指南.md，重启服务自动生成页面。修改导航： 在 docusaurus.config.js → themeConfig.navbar 配置菜单。4. 打包静态文件bashnpm run build # 生成 build 文件夹（最终上线文件） npm run build # 生成 build 文件夹（最终上线文件） 5. 部署上线（3 种主流方案）GitHub Pages（免费）： 配置 config 后执行 npm run deploy 一键推送部署。Vercel/Netlify（免费）： 绑定 GitHub 仓库，提交代码自动打包部署。自建 Nginx 服务器： 将 build 内所有文件上传至网站根目录，配置 Nginx 静态站点。6. 进阶配置开启版本： npm run docs:version 1.0.0 生成 V1 文档。多语言： 使用官方 i18n 命令提取翻译模板，翻译后切换语言。搜索： 前往 Algolia 官网申请 DocSearch，将 key 填入 config。六、高频避坑指南（新手必看）1. 环境相关坑Node 版本过低： 必须 ≥ 16.14，Node 14 及以下会出现依赖报错、启动失败。建议用 nvm/fnm 切换 Node 版本。依赖错乱： 遇到依赖报错，先执行 rm -rf node_modules package-lock.json && npm install 重装依赖。2. MDX 语法坑（V3 采用 MDX3）大括号报错： {} 在文档中被识别为 JS 表达式。写 {key:value} 代码示例时，改用反引号代码块，或转义 {。旧版本不兼容： 从 V2 升级 V3 时，用 npx docusaurus-mdx-checker 一键检查所有文档语法错误。3. 侧边栏&链接报错侧边栏 undefined： 文件夹缺少 _category_.json 分类配置文件，或文件名、路径拼写和 sidebars 配置不一致。链接失效警告： 构建提示 brokenLinks 时，config 中 onBrokenLinks 临时改为 warn，修正文档内失效链接后改回 error 校验。4. 部署&访问坑本地访问限制： 默认只能 localhost 访问。需要局域网 IP 访问执行 npm start -- --host 0.0.0.0。部署后页面空白： 检查 config 的 baseUrl，子域名部署需配置对应路径（如 baseUrl:"/doc/"）。国内访问问题： 国内 Vercel 域名可能被墙，建议绑定自有备案域名，或改用 Cloudflare/国内静态托管。5. 定制开发坑不要修改 node_modules： 自定义组件用 swizzle 命令弹出源码修改，升级版本不会覆盖自定义代码。暗黑模式样式： 自定义 CSS 写在 src/css/custom.css，避免覆盖框架原生变量。6. 搜索相关坑审核周期： Algolia 免费索引审核周期 1~3 天，上线前先关闭搜索，审核通过再填入配置。私有站点： 私有站点无法免费申请 Algolia，建议改用本地 lunr 离线搜索插件。七、补充：同类选型对比GitBook： 以 SaaS 付费为主，支持在线编辑；Docusaurus 为源码本地编写、全免费。VitePress： 基于 Vue 技术栈；Docusaurus 基于 React，自定义组件更灵活，版本/国际化功能更强。MkDocs： 基于 Python 栈，定制能力较弱；Docusaurus 前端生态丰富、插件更多。
BookStack
BookStack 全解指南一、平台介绍1.1 基本定位性质：MIT 开源免费、自托管式 Web 知识库/维基文档系统。对标产品：Confluence、GitBook。技术栈：基于 PHP+Laravel 框架开发，使用 MySQL/MariaDB 存储数据。源码托管：已从 GitHub 迁移至 Codeberg 托管。核心架构：采用三层经典架构逻辑，即 书架 (Shelves) → 书籍 (Books) → 章节 (Chapters) → 页面 (Pages)，完全贴合图书式内容管理。1.2 相关链接官网地址：https://www.bookstackapp.com在线演示站：https://demo.bookstackapp.com注：演示站数据每 30 分钟自动重置，限制删除用户及修改系统配置。定位总结：轻量化私有化部署知识库，适用于企业内网文档、个人知识库、产品手册、团队 Wiki 首选。二、核心主要功能2.1 双编辑器写作WYSIWYG 富文本编辑器：所见即所得，支持标题、表格、代码块、折叠区块、图片插入。Markdown 编辑器：支持实时预览，原生支持 MD 语法，可一键切换编辑模式。亮点：内置 draw.io（diagrams.net）在线绘图，页面内直接画流程图、架构图，无需跳转第三方工具。2.2 内容管理能力全文全域检索：支持全书/全站搜索，可进行标签筛选、时间筛选、创建人筛选及内容类型过滤（页/章/书/书架）。版本历史：每页自动保存修订记录，可回溯历史、对比修改、回滚内容。多格式导出：支持单页/整书导出 PDF、Markdown、Word、纯文本、HTML。图片集中管理：内置图库，支持分类上传、批量选择图片；可开启图片防盗随机 URL 加密。跨书排序/内容移动：页面可在书籍、章节间自由拖拽移动，支持批量排序。2.3 权限与安全（企业级）基于角色 RBAC 权限：提供全局/单本书籍/单页面三级权限，精细化控制「查看/编辑/创建/删除」。多登录认证：支持默认账号密码 + LDAP/OIDC/SAML2 单点登录 + 第三方社交登录。MFA 多因素认证：支持 TOTP（谷歌/微软验证器）+ 静态备用验证码，可按角色强制开启。全局开关：支持整站公开访问开关、全局评论启停、高安全图片上传加密。2.4 基础配套多语言支持：内置中、英、日、德、法、俄、西等十余国语言，用户可自定义界面语种。主题设置：提供深浅双主题，用户可独立设置浅色或暗黑模式。自定义站点：支持自定义网站名称、Logo、注册开关、首页展示内容。三、适用人群3.1 企业与技术团队（主力用户）研发团队：用于管理接口文档、技术架构手册、运维 SOP。行政人事：用于管理制度手册、员工培训文档。产品团队：用于管理需求文档、产品使用手册，可替代高价 Confluence。3.2 个人用户程序员：建立个人知识库、读书笔记、项目笔记。站长/开发者：建站私有化笔记，替代 Notion 付费空间。3.3 小组织/社团/培训机构用途：管理社团规章制度、课程讲义、培训资料归档。优势：低成本搭建内部文档站。局限性（不适合）：不适用于重度实时多人在线协同文档（无在线协同编辑，偏静态知识库）。不适用于超大附件在线预览（附件仅支持下载）。四、免费与付费情况4.1 软件本体永久免费开源：遵循 MIT 协议，源码完全免费。无功能阉割：无用户数上限、无文档数量限制。无官方 SaaS：BookStack 不提供官方云托管订阅服务，仅能自建部署。授权费：下载部署无任何授权费，自建实例永久免费使用全部官方功能。4.2 潜在自费项（按需自选）服务器成本：自建需要 VPS/云服务器，最低 2.5 英镑低配 VPS 即可流畅运行（唯一硬性花费）。商业技术支持：官方无付费客服，如需定制二开、部署代装，需找第三方服务商付费。域名与 SSL 证书：对外公网访问需自行购买域名，证书可免费申请 Let’s Encrypt。4.3 特别区分注意：国内「书栈网 bookstack.cn」是同名独立项目，非本官网 BookStack，收费规则不通用。五、详细使用指南5.1 阶段一：快速部署（3 种方案）新手建议首选 Docker 方案方案 1：Docker Compose 一键部署环境准备：服务器装好 Docker+Docker-Compose。配置 Docker Compose：新建 docker-compose.yml 配置（最简模板如下）。yamlversion: "3.3" services: bookstack: image: linuxserver/bookstack ports: ["6875:80"] environment: - APP_URL=http://你的 IP:6875 - DB_HOST=mysql - DB_USER=root - DB_PASS=自定义数据库密码 - DB_DATABASE=bookstack volumes: ["./bookdata:/config"] depends_on: [mysql] mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码 MYSQL_DATABASE: bookstack version: "3.3" services: bookstack: image: linuxserver/bookstack ports: ["6875:80"] environment: - APP_URL=http://你的 IP:6875 - DB_HOST=mysql - DB_USER=root - DB_PASS=自定义数据库密码 - DB_DATABASE=bookstack volumes: ["./bookdata:/config"] depends_on: [mysql] mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码 MYSQL_DATABASE: bookstack 启动服务：执行 docker-compose up -d。访问登录：访问 http://服务器 IP:6875，默认管理员账号：admin@example.com，密码：password（首次登录立刻改密）。方案 2：原生 PHP 手动部署环境：安装 PHP 7.4+、MySQL 5.7~8.0、Nginx/Apache。步骤：拉取源码配置 .env 数据库参数，配置站点伪静态。方案 3：先试用演示站地址：https://demo.bookstackapp.com限制：用内置 admin 账号体验全部功能（无法删用户、改系统设置）。5.2 阶段二：日常基础使用步骤建立顶层分类：首页 → Shelves → 新建书架（例：研发文档、行政制度），用于归类多本书籍。创建书籍：进入书架 → New Book（新建书籍，对应一套完整手册，如《Java 开发规范》）。新建章节：打开书籍 → New Chapter（分大目录，如环境搭建、语法规范）。新建页面（正文）：章节内 → New Page，选择富文本或 Markdown 编辑，支持插入图片、draw.io 图表、代码块。权限配置：书籍/页面右上角 → Permissions，新增角色并配置读写权限。导出分享：页面/书籍 → Export，导出 PDF 分享。用户管理：后台 Settings → Users/Roles，新增成员、分配角色权限。六、部署与使用避坑点（高频踩坑汇总）6.1 部署避坑数据库版本问题：原生兼容 MySQL 5.7~8.0，MySQL 5.6 及以下、MariaDB 新版本易出现连接失败。Docker 优先使用官方配套 mysql:8.0 镜像，不要混用高版本数据库。APP_URL 配置：.env 或 docker 环境变量 APP_URL 必须填写 最终访问域名/IP（带 http/https）。配置错误会导致图片打不开、附件链接失效、跳转异常。端口冲突：默认映射 6875:80，若服务器 80 端口被 Nginx 占用，需更换宿主机端口（如 8080:80）。PDF 导出乱码：原生 Dompdf 缺少中文字体，导出 PDF 中文会出现方框乱码。解决：替换 wkhtmltopdf 渲染引擎或手动导入中文字体包。数据备份：定期备份 /config 挂载目录 + MySQL 数据库。容器删除易丢失数据，建议配置定时自动备份。6.2 日常使用避坑图片公开泄露：默认上传图片 URL 可被外网遍历，敏感文档务必开启「Higher Security Image Uploads（高安全图片加密）」（后台设置 → Features & Security），自动给图片路径加随机密钥串防爬取。注册开关管控：公网部署务必关闭「用户开放注册」，否则爬虫批量注册账号。需要成员加入时由管理员手动创建账号。权限层级误区：书架权限≠书籍权限，书籍单独配置权限会覆盖书架继承权限，涉密文档建议单本书独立锁权限。编辑器切换：单页面选定富文本/Markdown 后不要反复切换，格式易错乱，建议长期固定一种编辑格式。系统升级：版本升级前先全量备份数据库。新版会变更数据表结构，直接升级大概率丢字段报错。附件预览限制：不支持 Office 在线预览，Word/Excel/PDF 附件仅支持上传下载，如需预览需额外集成第三方预览服务。6.3 运维避坑内存要求：服务器内存最低 1G，512M 内存易出现 PHP 内存溢出、打开页面超时。MFA 管理：开启 MFA 后务必妥善保存备用验证码，管理员丢失验证码将无法登录后台。七、补充拓展7.1 二次开发可定制：开源可自定义 LOGO、首页、新增插件。社区资源：社区有汉化优化版可供参考。7.2 替代选型建议想要云端免部署：选 Notion 或石墨。想要在线实时协同：选 OnlyOffice 知识库。
PandaWiki
PandaWiki 全维度使用手册一、平台介绍1. 基础概况PandaWiki 是由长亭科技研发、百智云运营的 AI 原生开源知识库系统。开源协议：遵循 AGPL-3.0 开源协议。部署形式：支持 GitHub 开源项目（chaitin/PandaWiki）及私有化部署。核心优势：主打一站式搭建，支持产品文档、技术 Wiki、客服 FAQ、独立博客四类站点。官方文档：https://pandawiki.docs.baizhi.cloud/node/0197160c-782c-74ad-a4b7-857dae148f842. 开源协议核心规则（AGPLv3）用户在使用本系统时需严格遵守以下规则：免费使用：免费使用、修改代码、商用均无软件授权费。源码开源义务：若修改源码并对外部署（无论是公网还是内网服务），修改后的代码必须同步开源。二次分发：若将程序进行二次分发，必须沿用 AGPL-3.0 协议进行开源。3. 产品定位PandaWiki 与传统知识库软件（如 Confluence、Wiki.js）相比，具有显著差异化优势：轻量部署：支持 Docker 一键部署。原生智能：内置 AI 能力，无需额外配置大模型即可启动基础对话。成本优势：无强制年费，支持私有化存储数据，解决传统系统收费昂贵及数据上云不安全痛点。二、核心主要功能（一）AI 智能化模块（产品核心）这是区别于传统 Wiki 的最大亮点，支持接入多种大模型：AI 辅助创作：支持文档续写、润色、生成 API 文档/FAQ/目录，并允许自定义提示词。AI 语义问答：基于站内知识库内容智能答疑，可嵌入 IM 机器人对外提供问答服务。AI 智能检索：采用语义搜索算法而非简单的关键词匹配，实现跨文档精准定位。模型接入支持：支持接入 OpenAI、DeepSeek、通义千问、Kimi 或 Ollama 本地私有化大模型。（二）文档编辑与导出双格式编辑器：支持富文本、Markdown、HTML 混合编辑，具备实时预览功能。多格式导出：支持 Word、PDF、Markdown、HTML 全格式离线导出。版本管控：提供文档全量历史记录、版本回滚、修改留痕及多人协同编辑功能。（三）内容批量导入（低成本迁移）提供 4 种低成本导入旧文档的方式：文件导入：支持单个或多个离线文件（PDF、MD、Word）。网页抓取：支持单页网页 URL 抓取。整站爬取：支持全站 Sitemap 批量爬取。订阅同步：支持 RSS 订阅自动同步内容。（四）第三方集成能力网页挂件：生成嵌入代码，可挂载至官网或产品页，充当在线帮助中心。IM 机器人：对接钉钉、飞书、企业微信，群内@机器人自动查询知识库并回复。单点登录 SSO：支持对接企业内部 OA 或 LDAP 实现统一账号登录。（五）权限管理（企业合规必备）RBAC 细粒度权限：支持管理员、编辑、只读、访客等多级分级。资源隔离：可按知识库、单文档设置访问权限，支持部门文档隔离。合规场景：满足金融、医疗等行业对数据隔离和访问控制的合规要求。三、适用人群与落地场景1. 企业团队（主力用户）研发/技术团队：用于编写 API 手册、开发规范、故障方案及技术 Wiki，替代 Confluence 以降低部署成本。产品团队：用于管理需求文档、版本说明书及产品手册。客服团队：维护产品 FAQ 与故障排查库，对接企微机器人实现自动答疑。运营/行政：用于沉淀 SOP 流程、规章制度及活动方案库。2. 个人/自由职业者程序员：用于整理个人技术笔记或搭建独立博客。学习者：用于课程资料与读书笔记的结构化归档，利用 AI 快速检索知识点。3. 机构与组织培训机构：构建课件知识库。自媒体：结合独立博客与素材库管理。中小政务单位：构建内部公文库或通知发布平台。四、免费与付费详情1. 开源私有化部署版（永久免费，推荐）此版本遵循 AGPL 协议，适合有运维能力的团队或个人。软件成本：100% 免费，无功能阉割，无用户数限制。允许商用：遵循 AGPL 协议即可商用。自费成本：大模型 API 费用：若使用云端大模型（如 GPT、DeepSeek）按量计费；若使用 Ollama 本地模型则无 API 费。服务器成本：需自备服务器/NAS。个人可用闲置电脑或 NAS 实现零成本部署。2. 百智云 SaaS 托管版（按需付费）适合无运维团队或不想自建服务器的企业。免费试用：提供有限的名额，包含知识库数量及存储空间限制。付费套餐：按团队人数、存储空间及 AI 调用量阶梯订阅。选型建议：有运维能力选私有化免费版；零技术团队选 SaaS 付费版。3. 定制服务收费项目：官方提供私有化定制部署、企业专属二开、等保适配（针对金融/医疗行业）。性质：按项目报价，为可选服务，非强制。五、详细使用指南（从部署到落地 5 步）步骤 1：环境准备硬件最低要求：2G 内存服务器、NAS 或闲置电脑。系统兼容性：支持 Linux、Windows、群晖/极空间 NAS 等环境。环境依赖：建议安装 Docker（一键部署必备）；若无 Docker，可使用官方 shell 脚本安装。步骤 2：一键部署（2 种方式）方式 A：Docker 极简部署（推荐）复制以下命令并在服务器终端执行：bashdocker run -d --name pandawiki -p 8080:80 chaitin/pandawiki docker run -d --name pandawiki -p 8080:80 chaitin/pandawiki 访问地址：服务器 IP:8080注意：系统生成初始管理员账号密码后，请立即登录修改。方式 B：官方一键脚本（NAS/Linux通用）复制以下命令执行交互式安装：bashbash -c "$(curl -fsSL https://pandawiki.docs.baizhi.cloud/install.sh)" bash -c "$(curl -fsSL https://pandawiki.docs.baizhi.cloud/install.sh)" 流程：交互式选择安装目录，自动拉取组件，安装完成后记录内网地址和管理员账号。步骤 3：后台初始化配置配置大模型（必填）：路径：后台 → 系统设置 → 模型配置。操作：填入 API 密钥（云端模型）或 Ollama 本地地址（如 http://ollama:11434）。验证：测试连通性并保存。创建知识库：操作：新建分类（如产品库、技术库、FAQ 库）。权限：设置对应成员组的权限。基础参数设置：修改站点名称、域名及前台主题（前台供用户访问，后台供编辑使用）。步骤 4：文档导入与内容创作存量文档处理：使用 URL、Sitemap 或批量文件导入历史资料。新建文档：利用编辑器书写，或使用 AI 一键生成初稿。对 AI 生成内容进行优化和审核。分类管理：按目录树结构对文档进行归档。步骤 5：对外落地使用对内协作：添加团队成员，分配读写权限。对外服务：发布公网域名作为官网帮助中心。生成网页挂件嵌入官网。配置钉钉/飞书机器人，实现群内智能问答。六、实操避坑清单高频踩坑点与解决方案，请务必收藏查阅1. 部署类风险❌ 坑 1：默认 80 端口被占用现象：Nginx 或 Apache 占用 80 端口，导致 PandaWiki 页面无法打开。✅ 方案：部署时修改映射端口，例如 -p 8090:80，并使用新端口访问。❌ 坑 2：服务器内存不足现象：服务器内存小于 2G，启动后频繁崩溃。✅ 方案：扩容内存；个人 NAS 优先使用 4G 以上闲置设备，并关闭多余容器以释放资源。❌ 坑 3：忘记初始管理员密码✅ 方案：进入 Docker 容器，通过环境变量重置 ADMIN_PASSWORD 密码。2. AI 配置风险❌ 坑 1：AI 无响应现象：配置大模型后 AI 无法调用，问答无反应。排查：检查 API 密钥是否正确、接口地址是否写错、模型余额是否耗尽；本地 Ollama 需提前拉取对应模型（如 ollama pull qwen）。❌ 坑 2：回答内容无关✅ 方案：开启“知识库绑定向量检索”，限制 AI 仅基于站内文档作答，关闭全局大模型自由生成模式。3. 内容与迁移风险❌ 坑 1：批量导入乱码现象：大批量 Sitemap 导入导致文档乱码或丢失。✅ 方案：分批导入（单次建议不超过 50 页），导入前备份原文档，并确保站点编码设置为 UTF-8。❌ 坑 2：AI 内容错误现象：过度依赖 AI 自动生成导致内容错误。✅ 规范：AI 生成初稿后必须人工校验、修改后再发布上线。4. 开源合规与商用风险（AGPL 协议红线）❌ 坑 1：商用不开源源码现象：修改源码后私有化对外提供服务（内网/公网），但不公开源码。✅ 方案：必须将修改后的源码托管至 GitHub 或 Gitee 进行开源；仅本地单机自用且不对外提供服务，无需开源。5. 权限与安全风险❌ 坑 1：权限过大导致泄露现象：全团队开放管理员权限，导致敏感技术文档泄露。✅ 方案：实施精细化 RBAC，编辑仅可修改对应知识库，普通成员设为只读，核心资料单独设置白名单。❌ 坑 2：公网部署无防护现象：部署公网未修改默认密码，被恶意入侵。✅ 必做：首次登录即修改为高强度密码；公网部署添加反向代理和防火墙，限制后台 IP 访问。6. 运维风险❌ 坑 1：数据丢失现象：从不备份数据库，容器误删后文档全丢。✅ 方案：每周定时备份容器内 PostgreSQL 数据库，备份文件存放至异地（云盘/NAS）。七、补充资源官方文档：https://pandawiki.docs.baizhi.cloudGitHub 开源地址：https://github.com/chaitin/PandaWiki社区交流：百智云论坛 https://baizhi.cloud/discussion交流群：官方微信交流群
Open WebUI
Open WebUI 全指南一、平台介绍1. 基础数据开源协议：遵循 Apache2.0 开源协议，开源免费。社区规模：GitHub 拥有 140K+ Star，41.9 万社区成员，全球下载量 2.9 亿+。版本迭代：当前为最新 v0.8+ 版本（注：资料提及 2026 年更新），社区活跃，持续迭代。技术架构：前端：Svelte后端：Python系统支持：Windows / macOS / Linux部署方式：Docker / K8s 容器部署 / GPU 硬件加速核心定位：自主可控 AI 操作台。不租用云端 AI，数据全部留存本地。支持离线单机运行或云端服务器部署，统一管理本地、Ollama、OpenAI、Anthropic、OpenRouter 等全兼容 API 模型。官网地址：openwebui.com2. 核心优势隐私安全：数据私有化，不上传云端。全兼容：统一接口对接各类模型。灵活部署：单机或服务器均可运行。二、核心主要功能1. 多模型统一接入（核心功能）单界面统一对接所有主流大模型，支持一键切换与配置：本地模型类：支持 Ollama、LM Studio、vLLM、HuggingFace 本地部署模型。云端 API 类：支持 OpenAI、DeepSeek、Anthropic、Groq、OpenRouter 等所有 OpenAI 兼容接口。配置方式：右上角头像进入管理员面板，直接配置 API 密钥与接口地址。2. 内置 RAG 私有知识库（王牌功能）文档支持：支持 PDF、Word、TXT、Excel 等多种格式上传。向量库对接：支持 Chroma、PGVector、Qdrant 等 9 种向量数据库。功能亮点：聊天时自动检索私有文档。提供引用来源标注。适合搭建企业内部知识库问答系统。3. AI 增强工具集联网搜索：内置 15+ 搜索源（如 DuckDuckGo、Bing），支持自建 SearXNG 免费本地搜索，AI 可实时查询外网信息。多模态能力：支持语音输入输出、图片识图、AI 绘图。内容渲染：支持 Markdown 排版、LaTeX 公式渲染、代码高亮、代码运行沙箱。自定义扩展：支持 Python 自定义函数/工作流、加载社区共享提示词、插件及工具脚本。4. 企业级用户与权限管控权限管理：RBAC 细粒度权限控制，管理员可新建分组。功能限制：可限制用户可用模型、知识库、搜索功能。安全登录：支持 SSO 单点登录、OAuth 第三方登录、聊天审计日志、注册白名单，适合金融/政企等合规行业。5. 社区生态 & 配套内置社区 Hub：免费下载社区分享的提示词、模型配置、自定义工具、角色人设。模型竞技场：支持多模型同台对比回答效果。移动端访问：支持 PWA 移动端访问，手机离线使用。三、适用人群1. 推荐用户个人 AI 爱好者/程序员：本地免费跑开源大模型（如 Llama3、Qwen、Mistral），自建私有 ChatGPT，保护对话隐私。职场/科研人员：上传行业资料构建知识库，AI 辅助论文、文档、资料检索。中小企业/创业团队：私有化部署团队 AI 中台，内部文档问答，避免企业数据外流至第三方 AI 平台。AI 服务商/运维：统一管理多渠道 API 模型（OpenAI+ 本地开源混合部署），管控员工调用权限、统计 Token 消耗。教育/实验室：构建课堂私有化 AI 环境，支持离线教学大模型实训。2. 不适合人群零硬件条件用户：无法自备服务器或电脑的普通用户。不想部署用户：只想开箱即用云端 AI 服务的用户。无模型资源用户：无法下载本地模型资源，完全依赖外部网络的用户。四、免费&付费详情1. 全功能永久免费（99% 用户适用）软件本体：100% 开源免费。功能范围：所有核心功能（聊天、RAG、多模型接入、权限、搜索、自定义插件）无功能阉割、无试用期限、无广告。商用权利：个人/商用完全免费，可二次修改源码。社区资源：社区提示词、工具、配置全部免费下载。2. 唯一隐性成本：模型本身费用本地 Ollama 开源模型：完全免费，仅消耗本机硬件（CPU/GPU）资源。对接云端 API：按平台官方 Token 计费（如 OpenAI、DeepSeek 等），Open WebUI 平台本身不抽成。3. 付费项目说明（企业增值服务）官方无软件订阅费：不存在软件收费订阅。付费内容：仅为企业商业技术支持。服务项目：包括定制部署、安全加固、7×24 运维、合规审计服务、私有化定制开发等（按需采购，个人用户完全不需要）。五、详细使用教程（2 种主流安装方式，新手优先 Docker）1. 环境最低配置内存：≥4GB（推荐 8GB+）磁盘：≥20GBGPU 建议：跑 7B 以上大模型建议 8G+ 独立显存 GPU系统：Windows / macOS / Ubuntu / CentOS前置准备：如需本地跑模型，建议提前安装 Ollama。 安装命令：curl -fsSL https://ollama.com/install.sh | sh2. 方式 1：Docker 一键部署（推荐，全平台通用）bashdocker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main docker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main 参数详解：3000：访问端口（可自行修改）。open-webui：本地数据持久化挂载目录。main：镜像版本标签。启动后：浏览器访问 http://localhost:3000。首次注册：注册账号后自动成为超级管理员。3. 方式 2：Python pip 原生安装（无 Docker 环境）bash# 1. 安装 Python 3.10~3.11，创建虚拟环境 pip install open-webui # 2. 启动服务 open-webui serve # 访问：http://localhost:8080 # 1. 安装 Python 3.10~3.11，创建虚拟环境 pip install open-webui # 2. 启动服务 open-webui serve # 访问：http://localhost:8080 升级服务：pip install -U open-webui 一键更新版本。4. 初次配置三步对接 Ollama 本地模型路径：右上角头像 → 管理员面板 → 设置 → 模型Ollama 地址：默认填写 http://host.docker.internal:11434操作：提前在 Ollama 运行 ollama pull qwen:7b 下载模型。对接云端 API同页面添加 OpenAI 密钥（API Key）及接口地址。新建知识库（RAG）路径：侧边栏“知识库” → 新建 → 上传文档 → 创建向量库。聊天时：在聊天页选择对应知识库即可实现 RAG 问答。六、部署&使用避坑清单（高频踩坑汇总）1. 网络&连接坑（最高发）Docker 容器连不上宿主机 Ollama原因：容器无法访问宿主机 127.0.0.1。解决：Ollama 启动前配置 OLLAMA_HOST=0.0.0.0 并运行 ollama serve；或 Docker 使用 --network host 宿主机网络模式启动容器。HuggingFace 模型下载失败解决：Docker 启动添加镜像环境变量 -e HF_ENDPOINT=https://hf-mirror.com，走国内 HF 镜像加速下载。远程服务器无法访问 WebUI 页面解决：服务器防火墙放行端口（如 3000/8080）：ufw allow 3000/tcp，云服务器安全组放行对应端口。2. 端口&存储坑端口被占用启动报错 Address already in use解决：修改 docker 参数 -p 自定义端口:8080（如 -p3001:8080）；使用 lsof -i:端口号 查询占用进程并关闭。Docker 数据丢失警示：不要删除挂载目录 open-webui。重装容器时，保留挂载卷（Volume）即可保留聊天记录与知识库。3. 硬件&性能坑低配置电脑卡顿、模型加载失败建议：4G 内存仅推荐 1.5B 小模型；7B 及以上模型必须 8G+ 显存 GPU；无 GPU 仅 CPU 跑模型速度极慢。RAG 文档过大报错限制：单文件不建议超 500MB；超大文档建议拆分上传。优化：关闭「全文直传」，开启分块向量化。4. 配置&使用坑API 调用报错密钥无效排查：核对接口地址/密钥；OpenRouter 等第三方 API 地址不要写错。AI 回答乱码/非中文解决：全局系统提示词添加：你全程使用中文回复用户问题。升级后功能异常建议：升级前备份挂载目录数据；大版本跨代升级建议重建容器。5. 安全避坑公网直接裸奔 8080 端口风险：外网部署直接暴露端口存在安全风险。加固：务必使用 Nginx 反向代理 + HTTPS 证书，设置高强度管理员密码，关闭公开注册，开启注册白名单。Ollama 默认全外网开放风险：内网使用限制 IP 访问，避免公网随意调用本地模型。七、补充小贴士国内模型推荐：优先搭配 Ollama + 通义千问/Qwen/DeepSeek 开源本地模型，实现零 API 费用。免费联网搜索：需部署 SearXNG 对接 Open WebUI，无需购买付费搜索 API。移动端体验：浏览器打开网页添加到桌面，开启 PWA，实现类 APP 使用体验。模型选择建议：入门体验：Qwen-7B / Llama3-8B。企业知识库：建议使用 Qwen-14B 或更大模型以获得更好的中文理解能力。
AnythingLLM
AnythingLLM 全解指南一、平台介绍1.1 核心背景与定位开发团队：美国 Mintplex Labs 开发。开源协议：MIT 开源免费协议，GitHub 星数 61K+，完全开源。核心定位：本地私有 ChatGPT + 全能知识库系统。主要目标：一站式 RAG 智能 AI 应用，主打全本地私有化、任意大模型接入、全文档知识库问答。底层原理：整合「大模型 + 嵌入模型 + 向量库 + AI Agent」，无需代码即可搭建私有知识库。1.2 核心工作原理RAG 技术：检索增强生成（Retrieval-Augmented Generation）。数据存储：所有数据默认本机存储，不上传第三方服务器。处理流程：将 PDF/文档/网页转为向量存入本地向量库 → 提问时检索文档 → 大模型作答。部署形态：支持桌面客户端（Windows/Mac/Linux）、Docker 自托管、官方云托管三种方案。二、核心主要功能2.1 全模型兼容支持本地模型：完美对接 Ollama、LM Studio、LocalAI（支持通义千问、DeepSeek、Llama、Qwen 全系列开源模型）。云端 API：支持 OpenAI、Azure、AWS、Claude、智谱等国内外商用大模型 API。多模态支持：单界面混用文本/图文/音频大模型，支持图片解析、音频转写及文档分析。2.2 全格式文档知识库（RAG 核心）支持格式：PDF、Word、TXT、CSV、Excel、代码项目、Markdown、网页 URL、音视频。入库方式：本地上传文件。网页抓取 URL。Github 项目批量导入。工作区隔离：支持独立多工作区，不同项目/部门建独立知识库，文档、模型、聊天数据完全隔离互不干扰。对话模式：聊天模式：长上下文闲聊 + 文档参考。查询模式：精准检索知识库，精简答案，适合资料查阅。2.3 隐私与部署能力默认全本地化：模型、文档、聊天记录、向量数据全部本机存储，无强制云端上传，无需注册账号即可使用桌面版。向量数据库：默认内置 LanceDB（本地轻量向量库，免费），可外接 Pinecone、Weaviate 等云端向量库。2.4 团队与企业能力多用户租户：自托管/Docker 版支持多人登录，管理员可精细化管控权限（限制查看/上传）。白标定制：企业可替换 LOGO、品牌名称，支持私有化贴牌。开放接口：内置开发者 API，可嵌入自有网站、小程序或业务系统。AI Agent：支持安装社区插件、自定义系统提示词、设置 Slash 快捷指令（如 /optimize、/explain）。2.5 扩展生态社区 Hub：支持一键安装自定义 Agent、系统 Prompt 模板、插件（如联网搜索、代码解析等）。三、适用人群1. 个人用户（免费首选）职场办公：整理合同、报表、读书笔记、行业资料，搭建私人文档 AI。学生/科研：建立论文、文献、课本知识库，进行精准答疑和文献总结。技术爱好者：本地部署开源大模型，打造无隐私泄露的私人 AI。2. 中小企业/团队（Docker 自托管）行政/法务：公司规章制度、合同库智能问答。技术团队：项目代码库、接口文档、运维手册智能检索。销售客服：产品手册、FAQ 知识库，用于内部培训或售前问答。3. 开发者与服务商AI 开发：通过 API 快速集成 RAG 能力到自有产品。外包服务商：利用白标贴牌功能，为客户搭建私有化知识库系统。4. 涉密与隐私敏感行业适用领域：律所、医院、金融、军工等。核心需求：数据禁止外流，必须本地部署 AI。四、免费与付费详情1. Desktop 桌面版（推荐个人使用）资费：永久免费，开源无功能阉割（MIT 协议）。限制：单设备单机使用，不支持多用户协作。成本：本地模型：仅耗电脑硬件，无任何软件费用。云端 API：仅在使用 GPT4/DeepSeek 等付费模型时按 Token 计费，AnythingLLM 本身不抽成。无文档数量、人数限制，无订阅费。2. Docker 自托管版（企业自建）资费：软件本体永久免费开源。成本：需自费云服务器（4 核 8G 起步，国内轻量云约 60~120 元/月），可选付费向量库。优势：无限多用户、白标、全企业功能、无官方订阅费。3. 官方云托管版（官方云）资费：起售价 25 美元/月起（约 180 元人民币），按用户数/资源档位阶梯涨价。内容：包含服务器运维、版本更新、技术售后。适用：不想运维、快速上线 AI 知识库的小微企业。五、详细使用教程（新手最简流程）阶段一：环境准备与安装下载安装：访问官网 https://www.anythingllm.com/desktop 下载对应系统安装包（Windows/Mac/Linux）。注意：一键安装，无需注册账号。配套模型（推荐）：下载并安装 Ollama（https://ollama.com/download）。终端执行：ollama pull qwen2.5:7b（下载通义千问 7B 本地模型）。建议下载嵌入模型：ollama pull nomic-embed-text。阶段二：初始化配置启动软件：打开 AnythingLLM → 进入 Get Started 向导。配置模型：LLM 提供商选择【Ollama】，软件会自动识别已下载的模型。Embedding 模型建议选择中文嵌入模型（避免默认英文模型中文效果差）。创建工作区：点击新建工作区（Workspace），命名（如「合同知识库」）。一个工作区对应一套独立的文档与数据。阶段三：导入与搭建知识库进入工作区：点击【导入数据】。选择导入方式：本地上传：拖入 PDF/DOCX/TXT 等文件。网页抓取：粘贴 URL 自动抓取全文。项目导入：输入 Github 链接导入代码库。处理与索引：勾选文件 → 点击 Move to Workspace。软件自动切片、向量化并存入本地向量库。技巧：可勾选文档置顶（图钉图标），强制开启知识库引用。阶段四：日常使用与进阶提问：在聊天框直接输入（如「总结这份合同的违约责任」），AI 自动调取文档作答。快捷指令：输入 /explain 一键解析内容。输入 /format 一键排版。Docker 多用户部署（进阶）：安装 Docker。拉取镜像：docker pull mintplexlabs/anythingllm。映射端口 3001 并启动。浏览器访问 localhost:3001 即可开启多用户管理。六、避坑指南（高频问题与解决方案）1. 文档问答不准、AI 瞎编❌ 坑点：使用默认内置英文嵌入模型，中文文档向量化效果差。✅ 方案：替换为 nomic-embed-text 或 bge-small-zh 中文嵌入模型（Ollama 一键下载）。❌ 坑点：PDF 为扫描件（图片型），直接上传无法识别文字。✅ 方案：先用 OCR 工具将扫描件转文字版再上传。❌ 坑点：文档过大或过长，切片检索失效。✅ 方案：单文档超过 200 页建议手动拆分，或开启自动分段功能。2. 本地模型下载慢、硬盘爆满❌ 坑点：Ollama 默认在 C 盘存模型，空间不足。✅ 方案：设置系统环境变量 OLLAMA_MODELS 将模型存储路径指向 D/E 盘。❌ 坑点：盲目下载超大模型（32B/70B），低配电脑跑不动。✅ 方案：16G 内存优先选 7B 量化版，24G 以上内存再考虑 14B 或更大模型。3. 硬件性能瓶颈❌ 坑点：仅用 CPU 跑 32B 大模型，卡顿严重。✅ 方案：N 卡（NVIDIA）开启 GPU 加速；若无独显，改用云端 API（按量付费）。4. 部署与版本兼容❌ 坑点：使用了老旧版本安装包，不兼容最新模型。✅ 方案：务必从官网下载最新桌面安装包。❌ 坑点：Docker 部署直接映射 C 盘存储。✅ 方案：自定义映射文件夹路径，避免占用系统盘空间。5. 隐私与付费隐性坑❌ 坑点：误绑定 OpenAI 密钥，导致大量提问产生高额 API 扣费。✅ 方案：新手先用 Ollama 本地免费模型测试，稳定后再接 API。❌ 坑点：误开云端向量库 Pinecone 并开启自动计费。✅ 方案：个人用户默认使用 LanceDB 本地向量库，无需外接付费库。6. 工作区管理混乱❌ 坑点：所有文档丢进一个工作区，文档混杂导致检索错乱。✅ 方案：按项目或分类新建独立工作区（如「财务」、「人事」分开建库）。七、官方 FAQ 关键信息数据安全性：桌面版存储文件全在本机文件夹，不会上传官方服务器。离线支持：本地 Ollama 模型 + 本地文档 + 本地向量库，断网环境下完全可用。商用权限：遵循 MIT 协议，可商用、可二次修改、支持白标贴牌，无版权限制。
MaxKB
MaxKB 全维度使用手册一、平台介绍1. 产品基础信息MaxKB（Max Knowledge Brain）是由飞致云（FIT2CLOUD）自研的开源企业级智能体（Agent）平台，主打“开箱即用、伴随成长”的产品理念。核心定位：解决企业 AI 落地门槛高、部署贵、迭代慢、数据不可控的痛点。技术底座：基于 PostgreSQL + pgvector 向量库，原生集成 RAG 知识库、可视化工作流 Workflow、Agent 智能体、多模型接入、第三方系统嵌入五大核心架构，支持私有化本地部署，确保全数据自主可控。成长路线：从基础 RAG 知识库问答 → 流程自动化工作流 → 全功能智能体，三级渐进升级，适配企业不同阶段 AI 需求。开源数据：GitHub 20K+ Star、500+ 开源贡献者，全球累计 100 万 + 安装量、1000+ 付费企业客户，覆盖 20+ 国家/地区，用户好评率 98%。2. 落地核心逻辑（三步落地 AI）接入大模型：私有环境对接通义千问、DeepSeek、OpenAI、Claude、Llama 等 20+ 主流大模型（云端 API/本地私有化模型均可）。搭建专属知识库：批量导入企业文档，自动拆分、向量化构建私有知识库。能力迭代升级：从简单问答逐步升级业务自动化、全场景智能体应用。二、主要功能（一）核心五大模块（后台主界面）1. 模型管理（模型接入）兼容性：兼容公有云 API 模型、本地 Ollama 私有化部署模型、国产开源大模型。灵活性：支持多模型自由切换，无厂商锁定；可单独配置 Embedding 向量模型、对话大模型。成本优化：支持拆分计费，优化使用成本。2. 知识库管理（RAG 核心）多格式导入：支持 PDF/Word/TXT/Markdown/Excel/网页 URL/飞书文档等 10+ 格式，支持单文件上传、批量模板导入（CSV/Excel）。智能处理：自动文本拆分、向量化入库；支持自定义高级分段（正则配置标题/目录拆分规则，适配说明书、规章制度）。知识库权限：分目录管理、用户读写权限隔离，支持多知识库独立隔离调用。RAG 检索优化：精准召回文档片段，大幅降低大模型“幻觉”，问答结果绑定原文来源。3. 工作流 Workflow（零代码业务自动化）可视化编排：支持 BPMN2.0 标准，非开发人员通过拖拽配置业务逻辑（知识库查询→接口调用→数据筛选→自动回复全链路自动化）。工具库集成：内置 MCP 工具库（数据库查询、HTTP 接口、文件解析、数据计算），可自定义函数对接企业 CRM/ERP 系统。4. 智能体 Agent（高阶 AI 应用）预制模板：内置客服、校园助手、政务咨询等预制模板，一键生成专属 AI 智能体。组合能力：组合知识库 + 工作流 + 工具，实现自主思考、主动调用系统数据、完成复杂业务操作。5. 应用&嵌入（对外输出 AI 能力）前端对话组件：一键生成悬浮聊天窗口，零代码嵌入官网、企业微信、钉钉、飞书、H5、小程序。开放 API：全量 AI 能力对外开放，业务系统通过 API 调用 MaxKB 实现智能审核、自动决策、知识库问答。多端适配：支持网页端、移动端 H5、企业 IM 一站式接入。（二）落地应用场景智能客服：如华莱士、深圳通落地案例，实现 7×24 小时自动答疑，降低人工客服成本、提升自助解决率。智慧办公：用于企业内部制度、产品手册、员工培训知识库，实现员工自助查资料。校园服务：如中国农业大学 AI 助手，实现教务、后勤、学术资源智能问答。政企/制造/医疗：应用于政策知识库、设备维保知识库、病历资料智能检索。三、适用人群1. 免费社区版适用个人开发者/AI 爱好者：用于自建本地知识库、私人文档问答机器人。小微团队（≤10 人）：初创公司、个体户搭建产品客服、内部知识库。高校/科研：师生搭建论文资料库、院系咨询助手。技术运维：适配 1Panel、JumpServer 老用户配套内部 AI 知识库。2. 付费专业版适用目标客群：中小型企业（10~500 人），涵盖零售、连锁、教培、中小企业 IT 部门。需求场景：需要正式落地客服 + 内部知识库，需要官方技术支持、单点登录 SSO、LDAP 权限管理。3. 企业版适用目标客群：中大型集团、政府单位。需求场景：多分支机构、多租户隔离、集群部署、7×24 小时技术服务，政务、央企、大型医疗机构定制化 AI 项目。四、免费&付费版本明细官网定价参考：https://www.maxkb.cn/price1. 社区版（开源免费 GPL v3）费用：永久免费。核心权限：全量基础功能（无限制知识库/应用/用户数）。RAG、基础工作流、API、全部嵌入能力。社区论坛答疑。限制说明：无官方一对一技术支持。适用场景：个人、小微团队、测试验证场景。2. 专业版费用：4.8 万元/套（永久授权）。维保政策：首年维保免费，次年维保 9600 元/年。核心权限（包含社区全部功能）：高级权限：SSO/LDAP/细粒度 RBAC 权限。数据管理：单机冷备份、数据审计。技术支持：5×8 小时官方技术支持、专属升级服务。适用场景：中小企业商用落地生产环境。3. 企业版费用：按需报价（联系销售）。核心权限（包含专业版 +）：集群部署、多租户架构。定制开发、7×24 全天候售后。私有化定制部署、现场技术服务。适用场景：大型集团、政府项目。4. 额外成本提醒模型调用费：MaxKB 软件本身免费/付费，但对接第三方大模型 API 会产生 token 计费（如 OpenAI、通义千问按量扣费）。硬件成本：本地部署私有大模型需自备 GPU 硬件成本（Ollama 本地模型无 API 费用）。五、详细使用指南（从零落地三步法）第一步：部署安装（2 种主流方式）方式 1：Docker 一键部署（新手首选）适用范围：Windows/Linux/国产系统通用。操作步骤：执行部署命令：bashdocker run -d --name=maxkb --restart=always -p 8080:8080 registry.cn-guangzhou.aliyuncs.com/maxkb/maxkb:latest docker run -d --name=maxkb --restart=always -p 8080:8080 registry.cn-guangzhou.aliyuncs.com/maxkb/maxkb:latest 访问入口：浏览器访问 http://服务器 IP:8080。首次登录：使用默认管理员账号登录，强制修改密码。注意：云服务器需在安全组开放 8080 端口。方式 2：Linux 离线安装包（生产环境推荐）适用范围：适配麒麟、统信等国产操作系统。操作步骤：从官网下载 Linux 安装包。在服务器进行解压。执行 bash install.sh 脚本安装。第二步：初始化配置（3 步搭建第一个 AI 问答）接入大模型路径：模型→新增模型。新手优选：云端 API（通义千问免费额度、DeepSeek 免费 API），填入 API 地址 + 密钥。隐私优先：本地 Ollama 部署 Qwen/Llama，填写内网 IP 地址对接（禁止填 localhost/127.0.0.1）。创建知识库+导入文档路径：知识库→新建知识库→上传 PDF/产品手册。智能处理：系统自动拆分向量化。高级配置：格式杂乱文档用高级自定义分段（正则）优化切片。创建 AI 应用（智能体）路径：智能体→新建应用。绑定资源：绑定已建知识库 + 已接入大模型。生成测试：一键生成对话机器人，预览测试问答效果。第三步：系统嵌入落地网页嵌入进入应用设置→获取 JS 嵌入代码。粘贴到官网前端，自动生成悬浮客服按钮。企业 IM在企业微信/钉钉应用配置中，填写 MaxKB 域名 +API Key。一键接入内部机器人。系统对接后台 API 页面获取访问密钥。业务系统调用 API 实现问答集成。六、避坑指南（高频踩坑点 + 解决方案）1. 部署访问类坑部署后打不开 8080 页面原因：防火墙/云安全组未放行端口、8080 被其他程序占用。解决：更换端口 -p 9000:8080 重新部署，开放服务器防火墙端口；执行 docker logs maxkb 查看启动日志定位异常。虚拟机对接本机 Ollama 提示 API 无效原因：模型地址填 localhost/127.0.0.1。解决：填写宿主机局域网 IP:11434，开启 OLLAMA_HOST=0.0.0.0 允许外网访问。2. 知识库&问答类坑文档上传成功但不显示/一直在处理中原因：Nginx 反向代理限制文件大小、缺少 OCR 解析组件、文档损坏。解决：修改代理上传限制，PDF 图片文档开启 OCR 识别，拆分超大文件分批上传。AI 回答和知识库内容不符、胡乱编造（幻觉）原因：文档拆分过粗/过细、模型参数不合适、知识库缺相关内容。解决：高级分段优化切片，小参数 7B 模型换更大参数模型，补充缺失文档；开启 RAG 引用原文溯源开关。批量 Excel 导入知识库全报错原因：表格合并单元格、单元格以=开头（被识别公式）、多问题用回车换行。解决：使用官方 CSV 模板，多问题 Alt+Enter 换行，清除特殊公式字符。3. 成本&版本选型坑社区版够用盲目买专业版避坑：小微团队先用社区版跑通业务，生产上线、需要官方售后再升级付费；社区版无功能阉割，仅缺少企业级运维功能。全量用付费云端 API 导致高额账单避坑：高频内部知识库问答搭配本地 Ollama 免费开源模型，对外客服用按量付费云端模型，分流成本。4. 生产环境安全坑公网裸奔 8080 端口无加密避坑：生产环境配置 Nginx 反向代理 +HTTPS 证书，隐藏原生 8080 端口，避免接口被恶意调用；定期修改管理员密码、限制 API 密钥访问 IP。
影刀RPA
影刀 AI Power一、平台介绍1. 产品定位影刀 AI Power（简称影刀 AP）是杭州分叉智能（影刀 RPA 母公司）出品的零代码 AI 智能体搭建平台。其官网为 https://www.yingdao.com/ai-power/。 核心逻辑是：通过拖拽组件进行可视化搭建，将大模型能力、RAG 知识库与影刀 RPA 自动化打通，致力于解决个人与企业落地 AI 门槛高的痛点。2. 底层能力主流大模型接入：持续接入 GPT4、文心一言、智谱 AI、Azure、豆包、通义千问等。集成能力：集成 RAG 知识库、多模态处理、智能搜索、文件解析、表格批量处理等。3. 核心优势独有 RPA 联动：AI 工作流可一键调用影刀 RPA，实现网页 AI 指令远程操控电脑自动办公（如自动填表、爬虫、数据下载）。开箱即用模板：内置上百套现成 AI 业务模板，无需从零搭建。多端分发：做好的 AI 应用可生成网页链接、API 接口、对话助手三种形式对外使用。二、五大核心功能1. 零代码 AI 工作流自定义搭建通过左侧拖拽组件→画布连线→配置参数→调试运行即可完成。输入组件：支持文本输入、文件上传、表格导入、网页抓取。AI 核心组件：包含大语言模型、文生图、语音转文字、OCR 图片提取、智能联网搜索、文本向量化（知识库检索）。输出组件：支持文本输出、表格导出、文件生成。特色组件：影刀 RPA 调用组件（平台唯一差异化功能），AI 输出结果可自动驱动电脑自动化操作。2. RAG 私有知识库支持格式：上传 PDF/Word/Excel/MD/图片/网页链接（单文件≤30MB）。处理方式：自动文本向量化。应用场景：搭建专属企业知识库，AI 可基于私有文档精准问答，适配合同解析、产品知识库、简历筛选等。3. 开箱即用现成 AI 工具无需自建，平台内置成熟模板，覆盖高频办公场景：文案创作：小红书/抖音/朋友圈/淘宝商品文案、PPT 大纲、品牌标语。多媒体生成：AI 商品主图、配图生成。智能表格：批量导入 Excel，AI 自动批量改写文案、数据清洗、商品标题生成。内容分析：简历解析、合同审核、财报/文章总结、音频转写分析。对话助理：定制企业问答机器人（客服/人事问答）。4. 三种落地使用模式对话式链接：生成网页对话链接，发给员工或客户，浏览器直接打开使用。API 集成：生成专属 API 密钥，对接自有系统、企微/钉钉/小程序。RPA 联动调用：本地影刀 RPA 软件一键调用 AP 智能体，桌面端自动执行任务。5. 团队协作与权限管控（企业版）账号管理：管理员创建子账号，划分三种权限：管理员/可编辑开发/仅能运行应用。应用共享：企业内部可自由共享 AI 应用源码，搭建企业内部 AI 应用市场（智能体广场）。三、适用人群1. 个人用户（社区免费版）自媒体运营：小红书/电商文案需求。职场白领：批量文档处理、简历筛选。学生/AI 爱好者：学习搭建 AI 应用、完成毕业设计。个体电商卖家：商品文案 +AI 配图需求。2. 企业/团队（企业付费版）运营部门：批量种草文案、商品图生成、评论自动分析。人事行政：简历智能筛选、招聘问答机器人、制度知识库。财务/法务：合同批量解析、发票数据提取、财报汇总。IT/数字化部门：低成本落地内部 AI 系统，对接 ERP/企微。电商/直播：弹幕自动回复、商品详情批量生成、售后智能客服。四、免费与付费版本详情1. 社区版（免费永久）资费：0 元。使用限制：单账号单人使用。知识库容量有限，大模型调用次数有配额。应用分享受限：外链有有效时长限制，无法跨用户共享源码。无官方一对一技术支持，仅社区答疑。可使用基础组件，部分高级模型/批量功能受限。适用场景：个人学习、非商用、少量自用小工具。费用提示：第三方大模型（如 GPT4）免费版配额用完需自行在对应平台充值 API 费用，也可在影刀内充值统一调用，价格通常低于单独采购官方 API。2. 企业版（付费）资费：定制报价。需联系 400-990-1065 询价，按账号/调用量/部署方式计费（支持公有云/私有本地化部署）。核心权益：多账号分级权限，无限创建应用。超大知识库容量，全量大模型无配额。应用自由分享源码，搭建企业智能体广场。专属顾问 + 一对一技术落地 + 企业 AI 培训。支持定时任务、日志留存、异常告警、私有部署。全组件解锁（含高级 RPA 联动）。适用场景：企业商用落地、多部门协作、商业化 AI 系统。五、分步使用指南（新手 5 步快速上手）步骤 1：账号登录打开官网：https://aipower.yingdao.com。使用影刀 RPA 注册账号登录（已有影刀客户端账号直接通用，新用户免费注册）。若为企业使用，企业管理员登录控制台（console.yingdao.com）→ 账号管理 → 添加员工子账号。步骤 2：二选一（用现成模板/自建 AI 工作流）方式 A：直接用现成模板（最快，新手首选）进入首页→AI 业务工具中心。选择分类（文案/表格/内容分析）。填入参数（如商品名、使用场景）一键生成结果，无需搭建。方式 B：从零搭建自定义 AI 应用首页点【新建 AI 工作流】进入画布。左侧拖拽「输入文本组件」→连线「大模型组件」→配置 Prompt（角色 + 需求，例：小红书文案专家）→连线「文本输出组件」。点击右上角【调试运行】，输入内容测试效果。调试无误后点击【发版】，生成链接/API。步骤 3：知识库配置（需要私有资料时）左侧点击【知识小站】。添加文件/网页/文字，上传后自动解析入库。大模型组件开启「知识库检索」即可调用私有内容。步骤 4：RPA 联动配置（想要 AI 操控电脑）影刀 RPA 控制台创建 API Key。AP 个人设置→我的授权→影刀 RPA 授权，填入密钥。工作流添加「RPA 应用组件」，绑定本地做好的 RPA 自动化流程，AI 输出指令自动触发电脑操作。步骤 5：发版落地使用发版后有三种用法：对话链接：复制网页链接，浏览器打开即用。API 调用：复制 Token，接入自有系统。影刀客户端：本地 RPA 软件直接调用该 AI 应用。六、避坑指南（高频踩坑点 + 解决方案）1. 模型调用费用坑❌ 坑：免费版自带模型配额用完，直接调用 GPT4 等第三方模型产生高额扣费。✅ 避坑：优先用平台免费内置国产模型（文心一言、智谱免费额度），商用再按需充值第三方 API。需区分平台服务费 + 第三方模型费两类扣费。2. 知识库上传坑❌ 坑：上传超大文件（>30MB）、扫描图片 PDF 无法解析，大量乱码；隐私合同/涉密文档上传公有云泄露风险。✅ 避坑：大文件拆分后上传，扫描件先用 OCR 转文字再入库；涉密企业优先选购私有部署企业版，数据本地存储不上云。3. 应用分享 & 安全坑❌ 坑：生成的对话链接随意外发，被恶意刷调用量，造成 API 高额损耗；社区版分享链接有有效期，对方打不开。✅ 避坑：商用优先用 API+ 密钥鉴权，少公开外链；企业版开启访问白名单，限定内部员工访问。4. RPA 联动兼容坑❌ 坑：AP 配置 RPA 后本地不运行，因电脑锁屏、杀毒拦截、分辨率不一致导致 RPA 元素定位失败。✅ 避坑：自动化机器固定 1920*1080 分辨率，关闭拦截软件；企业版开启无人值守定时运行，锁屏仍可执行。5. Prompt 与搭建逻辑坑❌ 坑：提示词写得模糊，AI 输出不稳定；组件连线错乱、缺少异常判断，批量运行报错。✅ 避坑：参考平台「提示词模板」，固定角色 + 格式 + 输出要求；关键步骤（文件读写、数据保存）添加异常重试组件，上线前多轮调试。6. 版本降级坑❌ 坑：企业试用到期未续费，自动降级社区版，知识库被限制、已搭建应用无法运行。✅ 避坑：试用到期前导出知识库文档、备份工作流，确认续费方案后再继续使用。
Hermes Agent
Hermes Agent 使用指南1. 项目概况Hermes Agent 是 Nous Research 于 2026 年 2 月开源发布、基于 MIT 开源协议的自成长型本地自托管 AI 智能体。官网地址：https://hermes-agent.org/zh/核心定位：常驻型持久化个人/团队 AI 智能体。区别于云端聊天机器人或 IDE 代码补全工具，它常驻服务器或个人电脑，能够持续迭代成长，熟悉用户习惯与项目，自主沉淀可复用工作技能。部署系统：支持 Linux、macOS、WSL2（Windows 原生为实验版，优先使用 WSL2）、Termux（安卓手机）。支持本地裸机、Docker 容器、SSH 远程服务器、云端 HPC/Modal 算力部署。隐私规则：遵循零云端数据采集、无遥测上报原则。所有记忆、配置、技能文件默认存储在本机 ~/.hermes/ 目录，数据完全由用户掌控。2. 项目核心特点全开源无捆绑：源代码完全公开可审计，无官方云托管订阅服务。自闭环学习：采用三层记忆架构并自动生成技能，形成自主优化闭环。全模型兼容：不限定大模型厂商，支持本地开源大模型、第三方 API、自研兼容接口。多渠道消息互通：统一网关接入 5+ 主流聊天平台，实现跨端无缝对话。二、核心主要功能（一）五大王牌核心能力1. 三层持久记忆系统（产品最大亮点）短期工作记忆：记录当前对话即时上下文。程序性技能记忆：自动将解决问题的方案保存为 Markdown 技能文档。长期全量记忆：跨会话永久保存用户偏好、项目资料、历史任务，内置 FTS5 全文检索。下次对话自动调取历史信息，无需重复交代背景。存储路径：所有数据本地化存储于 ~/.hermes/memory/ 目录。2. 自动技能生成系统（自进化核心）内置 40+ 开箱即用技能：涵盖 GitHub 运维、MLOps、数据图表、笔记管理、爬虫、代码调试等场景。自主创建新技能：完成复杂任务后自动生成标准化 SKILL.md 技能文件，遵循 agentskills.io 开放标准，支持本地检索、跨用户分享安装及一键复用。技能管理：支持手动增删改查技能，可自定义专属工作流。3. 多平台统一消息网关接入渠道：一键接入 Telegram、Discord、Slack、WhatsApp、Signal、终端 CLI 等。跨端接续：支持语音转文字，实现跨平台无缝接续对话（例如：在 Telegram 发起任务，在终端继续处理）。后台服务：可部署为系统后台服务，支持 7×24 小时在线值守。4. 自动化调度与并行子智能体Cron 定时任务：内置定时调度，支持无人值守自动推送日报、服务器备份、周报审计、晨间简报至任意绑定聊天平台。隔离子 Agent：自动创建多个独立子智能体并行处理多任务，各子 Agent 拥有独立终端与对话空间，通过 RPC 压缩多步骤流水线，降低上下文损耗。5. 全链路工具执行能力多环境运行命令：支持本地终端、Docker 安全沙箱、SSH 远程服务器、云端 Modal/HPC 集群执行脚本与代码。全功能浏览器自动化：支持网页搜索、页面内容提取、自动点击/输入/截图、图像生成、图文 OCR、TTS 文字转语音。MLOps 专项：支持批量生成 AI 训练数据集、RL 强化学习实验、ShareGPT 格式对话导出用于大模型微调及训练数据压缩优化。（二）大模型接入方案共有 4 类大模型接入方案可选：Nous Portal：官方平台，支持 OAuth 一键授权接入。OpenRouter：填入 API Key 一键调用 200+ 国内外大模型。自定义 API：支持任意 OpenAI 兼容格式本地或云端模型接口。vLLM：全本地化部署开源大模型，支持完全脱离外网 API 计费。三、适用人群（适合/不适合明细）✅ 推荐使用人群程序员/后端/运维工程师：适合自动化服务器运维、代码批量处理、GitHub 项目管理、定时脚本执行、MLOps 训练自动化。AI 研发/算法研究者：适合批量生成微调数据集、强化学习实验、Agent 架构调试、本地私有化模型落地。自由职业/内容创作者：适合定时内容选题、全网素材爬虫、周报自动整理、跨平台内容分发。中小企业小团队负责人：适合低成本搭建团队专属内勤 AI，接入 Slack/企业微信做自动化客服、数据报表推送。隐私敏感重度用户：适合不想对话数据上传第三方云端，需要 24h 在线私人智能助理、长期沉淀个人知识库的用户。跨境从业者：适合接入 Telegram/WhatsApp，自动处理海外客户消息、定时业务报表。❌ 不适合人群纯小白/零基础命令行用户：只想网页点开即用、零配置聊天，无法忍受命令行操作。排斥配置用户：不愿自建服务器/本地部署、不想管理 API 密钥、完全排斥前期配置。简单单次问答需求：仅需要简单单次问答、无长期自动化或知识库沉淀需求的用户。四、免费&付费详情（重点避坑：警惕山寨付费）1. Hermes Agent 本体：永久 100% 免费开源无官方收费：软件源码、全部内置功能、40+ 基础技能无任何官方收费、无订阅、无年费。协议支持：MIT 协议可商用、自由二次修改。本地模型：本地部署 vLLM 开源大模型（如 Llama、Qwen）全程零费用，不产生任何 API 开销。2. 可选隐性自费项目（按需自愿付费，非强制）大模型 API 调用费（可选）：若使用 OpenRouter、OpenAI、DeepSeek 等第三方 API，需按 token 消耗付费，部分平台提供免费额度。Nous Portal：提供免费基础套餐（需信用卡注册），高阶商用套餐按需订阅。注：小米 MiMo 等模型曾限时免费接入活动。硬件成本（可选）：本地电脑部署：零额外开销。VPS 云端 7×24 挂机：最低$5/月低配云服务器即可稳定运行（1 核 1G 内存）。本地跑超大模型：需购置高显存显卡硬件成本。3. 重大防坑：山寨收费陷阱官方声明：官方从未授权任何第三方云托管付费服务。警惕山寨网站：hermes-agent.ai 等网站售卖 59 美元/月托管版均为假冒。操作建议：不要付费购买非官方云托管，所有云托管均为第三方私自打包非官方服务。五、分步使用安装指南（5 步快速上手）环境要求：Linux/macOS/WSL2 终端。Windows 用户必须先装 WSL2 再操作。步骤 1：一键自动安装（无 sudo 也可执行）使用官方脚本自动安装 uv、Python3.11、依赖环境并拉取项目源码：bashcurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 步骤 2：交互式配置大模型通过向导式配置模型服务商或单独修改模型源：bash# 向导式配置模型服务商 hermes setup # 单独修改模型源 hermes model # 向导式配置模型服务商 hermes setup # 单独修改模型源 hermes model 按需填入：OpenRouter 密钥/Nous 账号/自定义本地模型接口。配置保存：完成大模型绑定。步骤 3：启动 CLI 交互式对话进入终端聊天界面，即可调用全部内置技能、本地命令、联网搜索：bashhermes hermes 步骤 4（可选）：多聊天平台网关接入若需跨平台消息收发：bash# 网关配置向导 hermes gateway setup # 启动消息网关后台 hermes gateway # 设置开机自启系统服务 hermes gateway install # 网关配置向导 hermes gateway setup # 启动消息网关后台 hermes gateway # 设置开机自启系统服务 hermes gateway install 按需绑定：Telegram/Discord/Slack 等，实现全平台消息收发。步骤 5：版本更新（获取新功能）一键拉取最新代码与依赖升级：bashhermes update hermes update 补充：安装时可在 setup 中选择 Docker 隔离部署或 SSH 远程服务器执行，自带安全容器加固配置。六、高频避坑清单（安装 + 配置 + 使用全阶段踩坑总结）（一）安装阶段坑Windows 原生安装报错：官方 Windows 为实验版，必须 WSL2 环境安装。直接在 CMD/PowerShell 安装大概率异常。旧环境变量冲突：本机曾装 OpenClaw、AutoGPT 并配置OPENAI_API_KEY，Hermes 会自动继承旧密钥导致配置错乱。bash# 彻底清理旧配置 rm -rf ~/.hermes ~/.config/hermes ~/.cache/hermes # 删除环境变量 nano ~/.bashrc # 删掉 OPENAI 相关环境变量 # 彻底清理旧配置 rm -rf ~/.hermes ~/.config/hermes ~/.cache/hermes # 删除环境变量 nano ~/.bashrc # 删掉 OPENAI 相关环境变量 稳妥方案：新建独立 Linux 用户运行 Hermes，环境完全隔离。国内网络安装失败：GitHub 脚本拉取超时，需切换代理或替换国内镜像源执行安装命令。（二）模型配置报错坑API Key 明明配置却提示空密钥：hermes setup配置仅保存到项目.env，未写入系统环境变量，新开终端环境变量失效。bash# 直接命令行写入密钥（永久生效） hermes config set openrouter_api_key "sk-or-xxx" # 查看全量配置 hermes config list # 直接命令行写入密钥（永久生效） hermes config set openrouter_api_key "sk-or-xxx" # 查看全量配置 hermes config list 混用多厂商密钥格式：OpenAI、DeepSeek、OpenRouter 密钥前缀格式不同，粘贴错误直接鉴权失败。需核对对应厂商密钥规范。（三）日常使用逻辑坑自动生成无用技能，干扰后续任务：偶然一次性操作被自动固化为永久技能，导致后续强制套用错误格式。bash# 查看全部技能 hermes skills list # 删除无效技能 hermes skills delete 技能 ID # 查看全部技能 hermes skills list # 删除无效技能 hermes skills delete 技能 ID 建议：连续 3 次相同工作流才允许生成技能，生成后手动检查技能文档。长对话上下文混乱：单会话混合多类不相关任务，记忆错乱。优化：使用 /new 新开空白会话，重置上下文。多任务并发文件冲突：多子 Agent 同时读写同一个本地文件，出现数据错乱。优化：涉及本地文件修改的任务串行执行，避免并行操作同目录文件。文件路径识别错误：智能体自动猜测路径出错，操作错误文件。规范：指令中必须填写完整绝对路径，禁止“那个配置文件”等模糊描述。（四）网关&定时任务坑Gateway 后台频繁卡死：升级到最新版 hermes update，不要同时绑定 5 个以上聊天平台。Cron 定时任务不触发：网关未设置系统自启服务，服务器重启后需要手动 hermes gateway 重启。（五）付费防骗坑拒绝非官方付费：任何非官方站点付费托管、代部署年费服务均为诈骗。警惕低价陷阱：不要轻信“一键云端 Hermes 年费 99 元”，全部为第三方山寨服务。七、补充实用小技巧优化身份理解：在 ~/.hermes/USER.md 写入个人身份、工作领域，优化智能体理解精准度。快速终止进程：任务跑偏时按 Ctrl+C 立刻终止进程，重新下发指令。全隐私零 API 开销：搭配 Ollama+vLLM 本地大模型，全程离线运行 Hermes。
MiniMax Agent
MiniMax Agent一、平台基础介绍平台名称：MiniMax Agent（现已升级更名为 Mavis） 所属厂商：上海稀宇科技 MiniMax（自研通用 AI 智能体平台） 官方网址：https://agent.minimaxi.com1. 使用形态网页端：在线使用，适合对话、轻量级任务。桌面客户端：支持 Windows/Mac 系统，具备本地文件操作与批量处理能力。2. 核心定位区别于普通对话 AI，MiniMax Agent 主打 多智能体协同（Multi-agent），能够自主拆解复杂任务、执行多步骤落地工作。依托自研 M3 大模型 提供百万级超长上下文、原生多模态及强代码能力。3. 核心架构单 Agent：适用于简单问答。Agent Team：多 AI 分工协作处理复杂项目。Expert 专家库：提供 1.6 万+ 现成垂类 AI。MaxClaw：云端 OpenClaw，免自建部署，开箱即用。4. 运行规则云端推理：AI 模型运算在云端完成。本地执行：文件读写、命令执行、网页操作在本地进行。隐私保护：本地文件需用户手动授权，数据本地留存，云端不窃取本地隐私文件。二、平台主要功能（一）平台自带预制垂直助手（开箱即用）可视化助手全品类视觉生成。支持一键生成 PPT、思维导图、流程图、信息图表、时间轴、数据仪表盘。自动排版配图，是办公汇报的首选工具。落地页制作助手生成高端 Landing Page 网页，包含前端页面及简易交互。无需具备前端代码基础即可使用。文件整理助手（桌面端专属）功能：Windows/Mac 文件夹批量整理、分类、改名、去重、归档。机制：清理前自动压缩备份文件，只用移动命令不直接删除原文件，保障数据安全。适用：整理发票、电子书、零散文档并导出分类 Excel。GIF 动图表情包助手图片转 Q 版卡通动态 GIF。一键批量生成 9 款不同动作表情包及配文，支持下载原图。（二）通用全平台核心能力三种任务运行模式Air 高效模式：轻量化对话，适合日常问答、短文撰写、文档总结、简单文案，低消耗快速出结果。Custom 自定义模式：自然语言描述能力，支持零代码创建专属 AI（如财务、招聘、文案等）。Pro 多智能体 Team：适用于复杂研发、深度行业调研、全栈项目开发、长篇报告，多 AI 分工并行完成任务。Expert 2.0 专家库海量现成行业 AI 模型，涵盖金融建模、法律文书、编程开发、短视频脚本等。支持一句话生成专属 Agent，自动拆解工作 SOP 流程。MaxClaw 云端 OpenClaw会员开通后可用，免服务器、免 API 配置。网页端直接使用开源 OpenClaw 全能力，支持批量自动化、爬虫、批量文件处理。多模态全链路生成支持图文/音频/视频生成。支持图片编辑、音视频文案成片（内置 Hailuo 视频、图像、语音生成模型）。全栈代码开发支持小程序、网页、后端项目一键生成完整源码。包含 README 文档、调试报错修复，支持前端 + 云数据库一站式落地。三、适用人群职场办公人群：文员、行政、运营、市场人员。用于制作 PPT、落地页、整理海量文件、批量制作素材、撰写周报/调研报告。产品/程序员：前端、全栈、独立开发者。用于快速生成项目源码、调试 BUG、编写自动化脚本，省去环境部署成本。自媒体创作者：短视频、图文博主。用于表情包制作、脚本撰写、封面图生成、落地页建站。学生/科研人员：用于文献整理、思维导图制作、课题深度调研、数据汇总分析。小微企业/个体户：用于财务发票整理、产品落地页搭建、店铺素材批量制作。四、免费与付费资费详情计费体系：采用 Credits 积分 + Token 双计费模式（2026 最新标准）。 额度互通：Token 计划会员额度在网页端 + 桌面端通用，Credits 全平台互通。1. 免费权益（新注册用户）初始积分：注册即送 1000 免费 Credits 积分。覆盖能力：约可免费执行 3 次完整复杂任务（如 PPT 生成、项目开发、文件整理）。Air 模式：网页端 Air 轻量化模式永久免费额度，不限基础对话次数。专家库：部分免费公用专家可免积分试用。闲聊成本：简单问答（Air 模式）消耗极低，日常闲聊基本免费。2. 订阅付费（Token Plan 会员）Plus 套餐月费：49 元/月Token 额度：6 亿 Token适用场景：个人日常办公、轻度创作、偶尔编程。Max 套餐月费：119 元/月Token 额度：18 亿 Token适用场景：自媒体、中小型开发、高频文件处理。Ultra 套餐月费：469 元/月Token 额度：55 亿 Token适用场景：企业团队、批量项目开发、商用大批量生成。注：早期国际版收费标准（19 美元/月、69 美元/月）现已统一切换为国内人民币 Token 订阅体系。MaxClaw 基础功能需 Plus 及以上会员解锁。3. 按需充值适合偶尔有大额任务的用户，可额外购买 Credits 点数。有效期：每月月底剩余 Token 不清零，可顺延至次月。五、分步使用教程第一步：注册登录访问官网：打开 agent.minimaxi.com。账号注册：使用手机号或邮箱注册 MiniMax 账号（与 MiniMax 开放平台账号互通）。下载安装：登录页面右上角点击 Get Desktop。下载 Windows 或 Mac 客户端（注：涉及文件操作时，网页端无法访问本地磁盘，必须安装桌面端）。第二步：三种任务使用方式调用预制助手（网页端/桌面端）操作：左侧菜单栏点击「预制助手」。选择：可视化、文件整理、GIF 表情包等。输入指令：如“把 D 盘电子书按学科分类，生成目录 Excel"。新建自定义 Agent（Custom 模式）步骤：点击【New Agent】→ Custom。描述需求：自然语言描述，例如“做财务发票整理助手，自动查重、统计金额、生成报表”。生成与保存：AI 自动生成能力流程，保存后即可反复调用。复杂项目启用 Pro（Agent Team 模式）步骤：新建任务选择 Pro。输入需求：如“开发一个带发帖评论的论坛小程序”。执行过程：AI 自动拆分策划、前端、后端等多智能体协同开发，产出完整项目包。第三步：桌面端文件操作关键步骤（避坑前置）指定工作区：打开桌面软件 → 设置 → 通用 → 指定安全工作文件夹（建议不要选 C 盘系统目录）。授权文件：发起文件任务时，系统弹窗权限选择：仅限本次 或 始终允许（未授权目录 AI 无法读写文件）。第四步：MaxClaw 使用前提条件：开通会员。操作路径：左侧入口点击【MaxClaw】→ 一键启用云端 OpenClaw。使用方式：无需配置 API，直接输入自动化需求即可使用。六、使用避坑指南（高频踩坑点 + 解决方案）1. 本地文件安全避坑（重中之重）❌ 禁止授权 C 盘/系统目录：禁止给 AI 授权 C 盘 Windows、Program Files 等系统文件夹读写权限，AI 误操作可能损坏系统文件。✅ 建议方案：自建专用工作文件夹（如 D 盘或桌面新建的 Work 文件夹）。⚠️ 数据备份：文件整理前务必确认开启「自动备份压缩包」。AI 默认是移动不删除，但重要资料建议手动二次备份。2. 计费&额度避坑Pro 模式耗量高：Pro 多智能体模式、MaxClaw 批量任务 Token 消耗极高，大批量项目前请先查看剩余额度。策略建议：新手先用免费积分测试；日常闲聊优先选 Air 模式；复杂任务前评估积分。免费耗尽后果：免费积分用完且未订阅会员，将无法执行复杂任务，仅保留基础免费问答。3. 部署&报错避坑（桌面端）权限不足：提示「无文件访问权限」，请右键目标文件夹→属性→安全→勾选当前用户完全控制权限。文件占用：文件被其他软件占用（如 Excel、压缩软件）会导致读取失败，请关闭占用程序再操作。API Key 无效：网页/桌面端共用账号，无需手动填写 API。报错多为账号未登录或会员过期。自定义部署第三方模型才需要手动配置 API。显存不足：若本地部署自定义模型出现显存不足，请改用 INT4 量化模型，关闭后台大型软件，新手优先使用云端 MaxClaw，避免本地部署。4. 功能使用误区网页端限制：网页端不能读取电脑本地文件，文件整理、批量图片处理等功能必须下载 Desktop 客户端。指令描述：自建 Expert 专家应尽量精准描述能力，描述模糊会导致 AI 执行逻辑混乱。图片上传限制：单次上传图片过多会触发限制（建议单批≤10 张原图）；GIF 表情包单次批量默认生成 9 张，若需要更多需分批提交指令。5. 隐私避坑敏感文件：身份证、银行卡、企业涉密财报等敏感文件不要放入 AI 工作目录。风险提示：虽然本地运行，但建议避免上传涉密资料进行处理，以防数据泄露风险。七、补充小贴士会员权益通用：会员 Token 额度在 Agent、MiniMax 绘图/语音/视频生成、开放平台 API 处全部共用。Token 延续性：每月月底剩余 Token 不清零，可顺延至次月使用。任务优化：遇到任务卡死，可终止任务→切换 Air 模式重试；复杂任务建议拆分多次提交，避免一次性发出超大指令。
QClaw
QClaw官网：https://qclaw.qq.com/简介：腾讯电脑管家基于 OpenClaw 开源框架自研的本地 AI Agent（智能体）工具，俗称“小龙虾 AI"。核心功能是利用微信发消息远程操控电脑本地执行任务，区别于仅能聊天的网页 AI，是本地运行型行动 AI，所有任务在本机执行、数据本地存储不上传云端。支持系统：Windows（Win10/11 64 位）、macOS（Intel/苹果 M 系列芯片）。一、平台介绍1. 产品定位QClaw 是本地运行型行动 AI，依托微信生态实现手机远程控制电脑，开箱即用、零代码配置。它将 AI 从“问答工具”转变为可操作系统文件、软件、浏览器、邮件的生产力助手。2. 核心优势微信直连远程：无需安装额外 APP，直接在微信聊天框发指令，即可异地远程操控电脑。本地隐私优先：所有文件、数据本机留存，内置安全沙箱，高危操作有二次确认。多模型自由切换：自带多款国产大模型（混元、Kimi、GLM 等），支持自定义接入第三方 API 模型。海量 Skills 生态：ClawHub/社区拥有 5000+ 免费技能脚本，按需一键安装。长效记忆学习：自动记录使用习惯、行文风格，越用越贴合个人需求。二、五大核心功能（附实操示例）1. 远程电脑操控（王牌功能）支持手机微信远程启停软件、打开/修改本地文档、控制浏览器、远程开关机等。示例：微信发送「打开桌面 Q3 报告.xlsx，第三列数据求和，结果发我」，系统自动运算并回传数据。2. 批量文档/资料自动化整理自动扫描电脑全磁盘或桌面文件，按项目、日期、格式分类归档，并自动提炼文档摘要生成 PDF。示例：发送指令「整理桌面 86 个文件，按 5 个项目分类，每个项目生成一页摘要 summary.pdf」。3. 日程&智能定时提醒支持自定义定时任务，如每日天气推送、定时发邮件、定时备份文件、整点备忘，附带出行穿衣建议。示例：设置「每天早上 8 点推送本地天气预报」。4. 个性化记忆养成（养龙虾）AI 长期记忆您的行文、办公偏好，包括固定文案格式、邮件模板等，后续自动沿用设置。示例：设置「所有邮件统一正式文风，末尾固定此致敬礼」，后续 AI 写邮件会自动生效并累计保存多项个人规则。5. 开发/学术自动化开发：一键创建 Chrome 插件、本地项目，自动生成 README 并推送 GitHub 仓库。学术：自动检索近 3 年指定主题论文、筛选高引文献、生成 APA 格式综述、导出 PDF/LaTeX 文献稿。三、适用人群职场办公人群：文员、财务、运营等，用于批量处理报表、文档归档、远程居家办公。科研/高校师生：硕博、研究员等，用于自动搜文献、整理综述、批量处理实验数据。程序员/开发者：快速搭建项目、自动提交代码、脚本自动化开发。自媒体/自由职业：素材批量归类、文案批量撰写、定时发布提醒。普通个人用户：日程管理、文件规整、生活定时提醒、家务备忘自动化。四、免费&付费规则（一）免费权益（当前全量公测，无邀请码）软件本体永久免费：官网免费下载安装、微信绑定、基础远程控制、基础文件操作、基础 Skills 全部免费，无广告无强制捆绑。每日免费 Token：内置国产模型，每日 4000 万 Token 免费额度（自然日 0 点刷新，不跨天累积）。日常办公、文件处理完全够用（简单问答≈1000Token/次，长篇文档≈5000Token/份）。基础技能永久免积分：桌面整理、定时提醒、文件打开等基础操作不计费，额度用完仍可使用纯本地简单指令。（二）付费项目（按需选购，非强制）会员订阅（积分制，积分抵扣高级任务/大模型消耗）标准版：月费 50 元，含 1000 积分，权益包括优先技能更新、额外模型额度。高级版：月费 150 元，含 3000 积分，权益包括批量高并发任务、企业级日志。旗舰版：月费 500 元，含 10000 积分，权益包括多设备绑定、专属技术支持。注：积分有效期 1 个月，可额外单独购买积分包（有效期 3 个月）。自定义第三方模型自费想要接入 GPT4、Claude 等非内置模型，QClaw 不收费，需用户自行在对应模型平台充值 API 费用，消耗由第三方厂商收取。未来商业化方向长期采用「基础永久免费 + 高阶订阅 + 按量计费」模式。基础远程、文件功能永久保留免费，高阶批量自动化、企业权限付费开通。五、三步使用教程（3 分钟上手）步骤 1：下载安装浏览器打开官网 https://qclaw.qq.com/。按电脑系统（Windows/macOS）下载对应安装包。一键傻瓜式安装，自动配置运行环境，无需额外装驱动、Python 环境。前置准备：电脑保持联网、安装新版微信；安装时授权 QClaw 文件/系统访问权限。步骤 2：微信扫码绑定打开 QClaw 客户端→左侧【渠道】→【微信连接】，弹出绑定二维码。手机微信扫码，确认授权绑定。微信搜索「ClawBot」进入专属聊天窗口，绑定完成。补充：支持 QQ 绑定，多账号可选其一。步骤 3：发送指令使用支持两种发指令方式：手机微信（远程首选）：ClawBot 对话框直接发文字/语音指令。电脑客户端：软件内置输入框下发任务，实时查看执行日志。常用万能指令模板（直接复制）文件：「整理桌面全部 Excel，按月份拆分汇总」办公：「打开 XX 文档，提取关键数据生成周报」定时：「每周一 9 点自动备份 D 盘工作文件夹」六、避坑指南（高频踩坑点）1. 远程失效坑现象：手机发指令没反应。原因（90%）：电脑休眠/关机、QClaw 被杀毒软件后台查杀退出。✅解决：电脑设置永不自动睡眠，把 QClaw 加入杀毒白名单，开机自启。2. Token 额度耗尽坑现象：大额任务导致 AI 生成类任务暂停。原因：每日 4000 万 Token 自然日 0 点刷新，不跨天累积，大额任务（万字综述、全盘扫描）一次性消耗高。✅解决：大额复杂任务拆分分批执行，或开通会员补充积分。3. 第三方模型扣费坑现象：自定义 API 切换后任务失败。原因：使用 GPT/Claude 等外部模型时，费用不由 QClaw 收取，API 密钥欠费会直接任务失败。✅解决：优先使用官方内置免费国产模型，第三方模型按需充值。4. 权限拦截坑现象：安装时拒绝权限导致功能残缺。原因：安装弹窗请求「文件读写、浏览器、系统控制权限」若点拒绝，无法操作本地文档。✅解决：重装软件，全部勾选授权，Windows 关闭防火墙临时拦截。5. 绑定失败坑现象：微信扫码无响应。原因：微信版本过低、网络异常。✅解决：微信更新至最新版、电脑切换手机热点重连，重启 QClaw 再生成二维码。⚠️注意：一个微信仅能绑定一台电脑客户端，换设备需解绑原机器。6. 安全风险坑现象：随意下发删除指令导致数据丢失。原因：QClaw 可删除本地文件，随意发「全盘清空、删除 D 盘所有文件」有风险。✅解决：开启软件内置高危操作二次弹窗确认功能，删除类指令手动确认后执行。7. Skills 安装坑现象：导入网上陌生第三方脚本导致电脑数据异常。✅解决：只在软件内置 ClawHub 安装技能，不要导入网上陌生第三方脚本，避免恶意文件篡改电脑数据。七、卸载方法Windows：打开控制面板-程序卸载，找到 QClaw 点击卸载。macOS：将应用程序拖入废纸篓，清理残留文件夹即可。
AutoClaw
AutoClaw（澳龙）全使用指南智谱 AI 本地 AI 智能体 官网地址： https://autoglm.zhipuai.cn/autoclaw/一、平台介绍AutoClaw（别名澳龙）是智谱 AutoGLM 团队推出的一键本地部署 OpenClaw 开源 Agent 的桌面工具。基于 GLM-5 大模型开发，旨在解决原版 OpenClaw 部署繁琐、需要代码配置的痛点。1. 核心定位本地运行 + 飞书 IM 对话操控电脑：把 AI 智能体执行入口装进飞书聊天框，无需额外搭建系统或配置页面。聊天即工作台：飞书对话框作为任务下达、进度查看及结果接收的一体化通道。隐私可控：核心底层封装 OpenClaw 开源 AI 框架（GitHub 29W+ 星标），全数据本地留存，不上传云端。2. 系统适配兼容性：Windows 10+ / macOS 12+（Intel/M 系列芯片全兼容）。安装速度：安装 1 分钟即可完成。二、主要功能1. 飞书 IM 一体化远程操控（核心功能）在飞书聊天框@AutoClaw 机器人，直接发送自然语言指令，AI 会自动拆解多步骤任务并在本地电脑真实执行。全流程进度、中间结果及下一步待办均回传至对话，无需切换软件。任务拆解：一句话需求自动拆分为多步执行（例如：整理出海首周市场计划 → 搜行业数据 → 整理竞品 → 生成计划表 → 飞书回文档）。接力执行：上次任务未完成可在原对话继续补充指令，接续推进。2. 预置 50+ 开箱即用技能（免配置）软件内置大量预设技能，涵盖办公、开发、内容创作等场景，无需手动配置。办公自动化：会议纪要生成、Excel 批量处理、文件批量改名、邮件自动撰写发送、飞书日程/多维表格创建、文档汇总排版。浏览器自动化 (AutoGLM)：自动浏览网页、批量爬取行业数据、表单批量填写、登录后台抓取报表、跨网站信息汇总成报告。内容创作：短视频脚本、公众号文案、行业研报、新闻摘要、产品落地页文案生成。投研/营销：财报自动提取指标、竞品监测、行业早晚报、活动策划、SEO 关键词整理。开发辅助：代码生成、BUG 排查、Shell 脚本、接口调试、项目文档编写。3. 多模型自由切换内置免费模型：GLM-4.7-Flash/FlashX、Pony-Alpha-2（智谱自研，适配 Agent 本地执行，无需 API）。外接第三方模型：支持手动填入 API Key 接入 Kimi、DeepSeek、MiniMax、GLM 全系列模型，用户可自主控制调用成本。4. Hermes 智能自我进化（新版本）场景学习：AI 学习用户使用习惯，在 4 种场景下自动沉淀工作流。安全生效：所有规则必须经用户审批后生效，防止模型误操作。规则沉淀：纠正指令错误、固定输出格式、高频重复操作、疑难任务优化，沉淀内容自动存入规则文档（AGENTS.md/SKILL.md），后续同类任务自动沿用优化方案。5. 定时任务与权限管控定时自动化：设置周期任务（如每日 9 点生成行业早报、每周五汇总周报），到点自动执行并推送飞书。安全沙箱：默认限制 AI 跨磁盘/跨目录访问文件，高危操作弹窗人工确认后执行，防止误删数据。三、适用人群职场白领/行政/运营：高频处理文档整理、周报、会议纪要、市场调研、素材整理，希望 AI 自动处理重复办公。跨境/出海从业者：负责海外市场调研、竞品信息抓取、落地页资料整理、海外行业周报自动生成。投研/金融从业者：批量下载财报、行业资讯聚合、舆情监控、数据清洗制表。产品/程序员：需求文档撰写、代码调试、爬虫自动化、测试脚本生成。自媒体/内容创作者：批量产出文案、脚本、选题调研。中小企业团队：小团队共用飞书统一下发自动化任务，一人配置全员在飞书使用 AI 分身。隐私敏感行业（法务/医疗）：要求数据不出本地、禁止文件云端上传，拒绝数据外泄风险。四、免费与付费详情软件本体永久免费，采用积分计价模式（积分用于智谱自研付费模型，第三方模型消耗自备 API 额度）。1. 免费权益客户端权限：客户端永久免费下载使用，无软件订阅费、无强制月租。内置模型免费：内置 GLM-4.7-Flash/FlashX 永久免费，日常文案、简单文档、轻度网页采集完全零成本，不需要充值积分。新手福利：新用户注册赠送 2000~2300 免费积分，可用于 Pony-Alpha-2、GLM-5 高阶模型调用，积分长期不过期。2. 付费积分套餐积分用于购买智谱自研付费模型服务。入门包：售价 29 元，含 5000 积分，适合个人日常高频使用。标准包：售价 109 元，含 20000 积分，适合小型运营/投研团队。进阶包：售价 249 元，含 48000 积分，适合中型企业高频自动化。旗舰开发包：售价 499 元，含 100000 积分，适合研发、批量爬虫、大批量文档生产。补充说明：接入 Kimi、DeepSeek 等第三方模型不消耗 AutoClaw 积分，费用由对应模型服务商收取，按第三方平台计费规则结算。五、分步使用教程步骤 1：下载安装（40s~1 分钟）打开官网 https://autoglm.zhipuai.cn/autoclaw/，根据系统（Windows/macOS）下载对应安装包。Windows 用户：双击 .exe 文件，一路点击“下一步”完成安装。macOS 用户：打开 .dmg 文件，将 AutoClaw 拖入应用程序。提示：首次若打不开，请前往系统设置→隐私与安全性→允许仍要打开。初始化设置：打开软件，使用手机号验证码登录，新用户自动到账免费积分。设置工作文件夹（AI 仅能访问此目录，安全隔离），并开启高危审批开关。步骤 2：一键绑定飞书（新手首选）AutoClaw 首页点击【一键接入飞书】。系统弹出二维码，使用飞书 App 扫码授权。系统自动在您的飞书创建机器人应用、开通消息/文档/表格权限。等待 1 分钟提示配置成功。进阶手动配置：若企业飞书管理员权限不足，可跳转飞书开放平台自建应用，复制 AppID/Secret 填入软件，批量导入权限即可。步骤 3：选择使用模型零成本新手：进入设置→模型选择→勾选 GLM-4.7-Flash（免费），直接使用。高阶需求：进入设置→模型选择→粘贴第三方模型 API Key（如 Kimi、DeepSeek），切换第三方大模型作为 AI 大脑。步骤 4：飞书对话框下达指令（正式使用）在飞书私聊或群聊中@【AutoClaw 澳龙 AI 助手】，直接发送自然语言需求。办公示例：整理今天 3 场会议录音，生成结构化纪要，Excel 存到桌面并发文件。出海示例：搜集东南亚美妆竞品官网，整理定价 + 渠道清单，生成首周调研计划。AI 后台自动执行，实时在对话推送进度、中间文件，全部做完推送最终结果及下一步可执行建议。补充指令：在同对话中直接追加修改要求，AI 接续原有任务迭代优化。步骤 5：进阶：设置定时任务打开 AutoClaw 客户端。点击【定时任务】→【新建】。填写周期（如每日/每周）+ 任务指令，设置完成后 AI 自动按时执行并推送飞书。六、避坑指南（高频踩坑点 + 解决方案）1. 安全风险避坑（最重要）❌ 不要装在主力工作电脑：AI 拥有本地文件读写、浏览器系统权限，建议安装在闲置电脑或虚拟机中，防止模型幻觉误删重要工作文件。✅ 必开 2 项安全设置：限制 AI 文件访问目录（仅指定文件夹可读）。开启 requireApproval 高危审批（删除文件、批量修改系统文件前弹窗确认）。❌ 禁止安装来源不明第三方 Skill：非官方技能库下载的插件存在恶意窃取文件风险，第三方技能安装前需用内置 Skill 检测工具校验。2. 成本失控避坑管理 API 消费：接入第三方 API（Kimi/DeepSeek）务必在对应服务商后台设置月度消费上限，避免 AI 高频调用 API 产生高额账单（行业出现过单日上千 API 扣费案例）。优先使用免费模型：轻度日常优先用免费 GLM-4.7-Flash，减少积分/第三方 API 消耗，复杂任务再切换付费模型。3. 使用配置踩坑macOS 报错：系统隐私设置未放行，需在系统设置中允许应用访问权限。Windows 拦截：部分杀毒软件误判本地自动化程序，需暂时关闭或添加信任。飞书收不到消息：AutoClaw 软件需保持开机运行（关机则 AI 无法执行）。飞书应用权限需完整开启消息回调权限。API Key 粘贴报错：去掉 Key 前后换行、空格，纯单行粘贴（这是新手高频错误）。任务执行缓慢：大文件或批量爬虫任务改用 Pony 付费模型，免费模型适合短文本、轻量任务。4. 任务指令避坑指令边界：尽量写明边界约束，减少 AI 幻觉出错。差示例：帮我整理行业资料（结果可能杂乱无章）。优示例：搜集 2026 东南亚护肤品牌，只整理入驻 Shopee 的品牌，结果保存桌面 Excel，不要多余内容。
FastGPT
FastGPT 全维度使用指南官网链接： https://fastgpt.cn/zh一、平台介绍1. 基本定义FastGPT 是由 Labring 团队开发的开源免费、基于 LLM 大模型的 RAG 知识库构建与 AI 应用零代码搭建平台。协议： 遵循 Apache2.0 开源协议。核心定位： 主打开箱即用知识库 + 可视化 AI 工作流。依托私有文档构建专属问答机器人，解决大模型幻觉、私有数据无法落地的痛点。形态分类： 分为 SaaS 云端版（在线即用）、私有化部署版（Docker/Sealos 一键部署）、商业定制版。接口兼容： 全接口兼容 OpenAI 格式，可无缝对接国内外大模型（GPT、Claude、文心一言、通义千问等）、企微/飞书/公众号/官网等渠道。2. 核心价值低成本快速搭建： 适合企业知识库、AI 客服、内部知识助手、行业专属问答机器人。零代码落地： 无需编写代码即可构建 RAG（检索增强生成）应用。二、核心主要功能1. 全格式知识库自动化处理（核心功能）文档导入： 支持 PDF/Word/Excel/Markdown/TXT、网页链接、整站站点批量同步、自定义问答对批量导入。自动预处理： AI 自动清洗、分段、向量化、QA 拆分，无需手动拆文档。内置 Ada-002、FastAi 等向量模型，支持自定义嵌入模型。混合检索： 语义向量检索 + 关键词全文检索双模式，优化答案召回精准度。权限管理： 支持知识库权限分组、多成员协作管理。2. 可视化 Flow 工作流编排（平台特色）零代码搭建： 拖拽式操作复杂业务逻辑。常用节点： 包含问题分类、知识库检索、HTTP 接口调用、数据库查询、变量赋值、条件分支、第三方应用调用、文本拼接等。落地示例： 用户咨询 → 知识库查产品参数 → 无结果调用通用大模型 → 命中关键词自动转接人工客服/调用库存接口。3. 多渠道发布与 API 集成发布方式：免登对话网页链接（直接发给用户或嵌入官网）。API 接口（兼容 OpenAI，便于对接企微/飞书/公众号/钉钉机器人）。嵌入官网 iframe。API 能力： 全接口对齐 OpenAI 规范，现有 GPT 类程序无需改代码即可接入 FastGPT 知识库能力。4. 配套运维调试工具对话日志全留存。检索来源溯源（回答引用文档页码/片段）。知识库搜索测试。提示词可视化调试。用量统计看板。团队多租户权限管控。5. 模型灵活接入方案一： 填入自己的 API Key（OpenAI/国产大模型），只消耗自身 token。方案二： 选用 FastGPT 官方付费模型额度（FastAi 系列）。三、适用人群与场景1. 个人用户自媒体/撰稿人： 搭建素材知识库，快速检索稿件资料。学生/科研： 整理论文、文献、课件，AI 辅助答疑与文献总结。职场人： 收纳工作文档、规章制度，打造私人知识助手。2. 中小企业&运营电商/教育培训/门店： 搭建 7×24 智能售前/售后客服，产品说明书、售后 FAQ 自动问答。HR/行政： 搭建人事制度问答机器人、行政知识库。3. 企业/政企/法务制造/金融/律所/医疗： 合同库、合规文档、医疗手册、产品技术手册私有化知识库。应用场景： 合同智能审查、合规风险检索、国企内部规章制度智能问答。4. 开发者/技术团队AI 创业者/后端开发： 快速封装知识库能力，嵌入自有 APP/CRM/ERP。二次开发： 基于开源代码二次定制商业化 SaaS 产品。四、免费与付费详情（一）SaaS 在线版（fastgpt.cn 云端）1. 免费额度（个人试用永久可用）知识库： 免费创建 5 个知识库，单库最大上传文档总量有限制。模型： 每月赠送少量 FastAi 测试 token。工作流： 简易应用、基础工作流免费使用。限制： 无法使用企业级多租户、超大批量文档导入、专属技术支持，商用 SaaS 售卖需申请商用授权。2. 付费计费（两种计费模式）自备模型 Key（最省钱）： FastGPT 平台永久免费，无平台服务费，仅消耗你自己大模型账号 token（GPT4/文心一言等按原厂商计价）。平台官方模型（FastAi）： 按 token 计费，FantAi-10k 价格为 0.03 元/千 tokens（输入 + 输出双向计费），充值即用、无月租，超大批量可定制套餐。企业增值服务： 定制私有化部署、专属技术对接、多租户企业版，按需报价。（二）私有化部署（开源版 Docker/Sealos）开源社区版（完全免费）： GitHub 源码免费下载，Apache2.0 协议，非 SaaS 售卖可免费商用。自己承担服务器、模型 API 成本。商业授权规则： 若基于 FastGPT 搭建对外收费 SaaS 平台、去除官方 LOGO 版权，必须向官方申请商业授权并付费；自用内部系统无授权费用。补充： Sealos 云平台可一键部署 FastGPT，按需付云服务器费用，无平台授权费。五、分步使用教程（SaaS 云端新手 5 步上手）步骤 1：注册登录打开 https://fastgpt.cn/zh。手机号注册登录进入工作台。步骤 2：接入大模型（必做）路径：左侧【模型配置】。操作：添加模型渠道。方案 A（推荐省钱）： 填入自己的 OpenAI/DeepSeek/国产大模型 API Key + 接口地址。方案 B： 充值购买 FastGPT 官方 FastAi 额度，直接选用平台内置模型。步骤 3：创建知识库 + 上传文档路径：左侧【知识库】→新建知识库。设置：选择向量模型（默认 Ada-002/FastAi）。上传：PDF/Word/网页，系统自动分段向量化。等待：索引完成后状态显示 Ready 即可检索。进阶： 批量导入 FAQ 问答对，优化客服精准问答。步骤 4：创建 AI 应用（简易/工作流二选一）简易应用（新手首选）：路径：工作台→新建应用-简易应用。配置：绑定建好的知识库、选择 LLM 模型，开启知识库检索。适用：简单问答场景。工作流应用（复杂业务）：路径：新建工作流。配置：拖拽节点配置问题分类→知识库检索→接口调用等逻辑。示例：区分 Sealos/Laf/FastGPT 三类产品咨询自动跳转对应知识库。步骤 5：发布上线使用路径：应用→【发布渠道】。免登网页： 生成独立对话链接，直接发给用户或嵌入官网。API： 获取接口地址 + 密钥，对接企微、自有系统。对接第三方： 通过配置接入飞书/企业微信机器人。补充：私有化快速部署简易： Sealos 云市场一键安装 FastGPT。本地： Docker Compose 拉取镜像部署（2 核 4G 起步服务器配置）。六、新手避坑要点（高频踩坑总结）1. 知识库相关坑文档切片问题： 单文件 > 3000 字易出现检索错乱。解决： 设置单条切片上限 2000~3000 字符，开启切片重叠（10%~15%）保证上下文连贯。向量模型更换问题： 向量模型在创建知识库时绑定。注意： 已建好知识库改模型需要新建库重新导入文档，老库无法自动更新向量模型。索引卡住问题： 检查模型 API Key 是否有效、接口能否连通。注意： 国内使用 OpenAI 注意网络连通问题，优先选用国产大模型规避网络报错。2. 模型与计费坑Token 计算误区： 知识库检索内容 + 用户提问都算输入 token。建议： 上线客服前务必小批量测试用量，避免突然高额扣费。API 配置错误：不要把官网主页地址当成接口 BaseURL。复制 Key 杜绝多余空格。配置后先单独对话测试通不通，再绑定知识库。3. 工作流与发布坑变量引用错误： {x} 格式引用用户提问变量，漏写符号会导致无法获取用户问题、检索失效。免登链接打不开： 检查应用是否保存、知识库是否就绪，新创建应用保存后刷新发布渠道。商用合规坑： 开源版自用免费，对外做付费 SaaS、去除 FastGPT 版权 LOGO 必须购买商业授权，否则侵权。4. 部署避坑（私有化用户）Docker 部署数据库报错： 核对 pg/mongo 账号密码、端口，避免本地端口占用，修改.env 配置后重启容器生效。七、补充常见 FAQ1. Q：知识库回答不准怎么办？A：优化文档切片。补充 FAQ 问答对。开启关键词 + 向量双检索。调整提示词限定优先引用知识库内容。2. Q：可以离线本地完全不用外网吗？A： 私有化接入本地部署大模型（如 Ollama 等），可实现全离线知识库问答。3. Q：免费版能商用吗？A： 云端免费版自用商用可以，对外售卖 AI 服务需要升级付费/拿商业授权。