分类导航
发现更多优质 AI 工具
Chatbase
Chatbase.co 平台使用指南📖 一、平台介绍Chatbase.co 是一个无代码(No-Code)私有知识库 AI 机器人搭建平台。它基于 RAG(检索增强生成) 技术,支持用户上传自有资料或爬取网站内容来绑定 Notion,从而生成专属的问答 Bot。系统仅基于上传素材作答,有效降低 AI 幻觉风险。主要特性:部署灵活: 支持网页嵌入、API 接口对接、多渠道分发(Slack/客服系统等)。模型兼容: 底层兼容 GPT/Claude/Gemini 等大主流语言模型。🛠️ 二、核心功能多源知识库导入支持格式:PDF / TXT / DOCX 等文档文件。网络内容:整站爬虫抓取公开网页信息。其他方式:自定义问答对、Notion 空间授权接入。Bot 自定义配置人设与语气:设置提示词(Prompt)、随机性温度参数。交互管理:调整欢迎语样式,添加人工转接入口。模型选择:可根据需求切换不同的大语言模型版本。测试优化工作台实时调试: Playground 模式支持对话现场测试。溯源引用: AI 回答时自动高亮显示引用的原文依据。纠错机制: 提供手动修正错误回答的功能,并重新训练数据。部署渠道网页嵌入: 复制 iframe/JS 代码粘贴至网站(支持弹窗)。系统集成: Slack / Zendesk 等客服系统集成、API 对接自有程序。品牌定制: 修改聊天框配色,自定义域名(付费版可移除平台水印)。运营能力数据看板:查看对话次数与活跃用户统计。缺口诊断: AI 自动提示知识库中缺失的信息点。自动化: 支持外部工具调用及自动重训练功能(AI Action)。🎯 三、适用人群与建议✅ 推荐使用的场景个体户/独立站长: 用于官网 FAQ 的自动客服机器人,降低人力成本。中小企业售后团队: 沉淀产品文档与售后知识库,实现快速自助答疑。运营/自媒体人员: 利用私域内容生成问答助手,提升粉丝互动效率。内部研发团队: 连接 Notion 或 Confluence,作为团队内部的知识检索工具。开发者: 通过 API 将 Bot 二次集成到自有的业务流程中。❌ 不适合的场景超高并发需求: 大规模在线客服接待(需考虑流量承载与成本)。复杂多轮业务流: 涉及复杂逻辑跳转、需要人工强干预的深层销售流程机器人。💰 四、免费 & 付费方案详解官方定价页面参考:https://www.chatbase.co/pricing 注:以下价格为月付基准,年付通常享受约 20% 折扣🆓 Free(免费版)费用: $0 / 月额度限制: 每月仅支持 50 次对话。Bot 数量: 仅限创建 1 个 Bot。素材容量: 单 Bot 上限 400KB。模型权限: 仅提供基础小模型,不支持 GPT/Claude 高阶版。安全限制: Bot 若闲置 14天 将自动删除;带明显 Chatbase 水印;无 API/自动化功能。🧑🤝🧑 Hobby(入门版) - $32 /月(年付$384)额度: 每月 500 次对话,支持 1 个 Bot。素材容量: 存储上限提升至 10MB。模型权限: 解锁 GPT-4/Claude 等高端高阶模型。协作与功能: 支持 2人 协作编辑;提供简易集成工具、基础数据看板及附件上传能力。🚀 Standard(热门版) - $120 /月(年付$1440)额度: 每月高达 4,000 次对话,支持创建多个 Bot。素材容量: 存储上限提升至 20MB。协作与成员: 允许最多 3名 团队成员共同维护。高级功能:开放 API 接口调用;语音对话支持(Text-to-Speech)及外呼营销能力;深度集成 Stripe/Zendesk 等系统;AI 自动重训练、去除平台水印。💼 Pro / Enterprise(专业 & 企业版) - $400+ /月额度: 每月最高支持 15,000 次对话,素材存储达 40MB。协作规模: 最多 5名 成员;提供高级数据分析报告。定制化服务(Enterprise):专属 SLA 服务协议;私有化部署方案;大客户专属客服通道与定制报价。⚠️ 重要计费规则提示按次扣费: 每一条问答对话都会消耗相应的额度。模型加成: 调用高端模型(如 GPT-4o / Claude-3)会双倍扣除额度,需预留充足预算。支付门槛: 目前仅接受境外信用卡/加密货币等支付方式,不支持微信或支付宝直接充值,续费时需确保账号绑定的卡可用。🚀 五、快速使用步骤注册登录:访问官网 chatbase.co,使用邮箱或 Google 账号进行验证并进入控制台。创建 Bot(Agent):点击新建按钮,选择素材导入方式(上传文件/网址爬虫/Notion同步)。配置训练:填写 Bot 的人设指令、选择 LLM 模型版本、调整温度参数,确认无误后开始训练(通常需 2–5分钟)。测试调试:进入 Playground 界面进行问答对话。重点核对 AI 引用的原文素材是否准确,若有错误请手动修正并点击重训。部署上线:复制生成的 iframe/JS 代码粘贴到您的网站(或获取 API Key 对接系统)。持续优化:后台实时监控对话统计与知识库缺口提示,定期补充缺失资料以提升回答准确率。⚠️ 六、注意事项与避坑指南⌛ 网络环境限制 Chatbase 为海外服务器服务。国内用户直连访问速度较慢,可能出现爬虫抓取失败或嵌入 Bot 无法正常加载的情况(建议使用代理)。👻 免费版致命短板免费 Bot 若未定期使用,闲置超过14天会自动清空内容。每月仅能对话50次,且不可用于商业用途。⚠️ 额度消耗陷阱 高端模型(如 GPT-4o)调用成本高,会双倍扣除额度。月度免费/付费额度用完时机器人会自动停用,需及时续费或购买额外包。🧩 AI 幻觉无法根除 即使基于 RAG,对于模糊文档或多文件复杂推理仍可能出现错误回答。建议设置“人工转接”按钮兜底。💬 会话无记忆性 Bot 没有长期上下文记忆。访客若关闭弹窗再重新进入,之前的对话历史会被清空,需重复提问(这是 RAG 类模型的通病)。📂 存储上限严格 不同套餐有严格的容量限制。一旦超容无法新增文件,建议定期删减旧资料或升级更高价位的 Pro/Enterprise 版。💳 支付渠道单一 付费账户充值主要依赖境外信用卡(Visa/Mastercard)。国内用户若没有此类卡片,续费操作较为繁琐且可能中断服务。
腾讯 IMA
腾讯 IMA一、平台介绍1. 基本信息全称:Information Management Assistant(ima.copilot)官网:https://ima.qq.com上线时间:2024 年 11 月正式上线升级计划:2025 年 10 月升级 2.0 版;2026 年上线 Copilot 智能体定位:个人及小团队专属的「第二大脑」,主打微信生态深度打通。2. 核心架构技术底座:搭载腾讯混元大模型 + DeepSeek-R1 深度推理模型。全端覆盖:支持 Windows/Mac 客户端、安卓 App、微信「IMA 知识库」小程序、网页端。账号体系:支持微信/QQ 一键登录,账号多端云端自动同步。生态优势:依托腾讯生态,可无缝导入微信文件、公众号文章及腾讯文档内容。3. 核心逻辑工作流程:碎片化信息一键入库 → AI 解析沉淀知识库 → 基于私有资料精准问答/创作。数据留存:区别于通用 AI(每次重传),IMA 永久存档资料。AI 回答:仅基于用户上传内容作答,有效减少 AI 幻觉。二、主要核心功能1. 私有知识库(王牌功能)格式支持:支持 19 种格式,包括 PDF、Word、PPT、Excel、TXT、图片、截图、音频、网页链接、公众号文章、腾讯文档等。管理方式:支持拖拽/批量上传,AI 自动进行全文解析、OCR 识图及要点提取。分类存储:可新建多个分类知识库(如工作、学习、项目),区分个人库与共享协作库。永久存储:上传内容永久云端存储,支持基于自建知识库定向提问,AI 可溯源原文出处。2. 双模型 AI 问答 & 联网搜索模型切换:支持一键切换模式:混元:适用于日常写作、总结。DeepSeek-R1:适用于深度推理、数据分析、复杂文稿。提问模式:私有知识库问答:只检索用户已上传的文件。全网联网搜索:结合实时互联网资料进行回答。侧边 AI:选中文本可唤起侧边 AI,支持边写边问、实时修改内容。3. 智能笔记 & 全链路创作功能集成:随手记笔记,AI 一键支持扩写、缩写、翻译、润色、生成大纲、脑图、报告。智能归档:笔记可一键归档入库,自动关联已有知识库内容。批量处理:支持批量将多篇资料整合生成综述文稿或播客文案。4. Copilot 智能任务(2026 重磅)Agent 自主任务:一句话下达指令,AI 自动拆解步骤、调取知识库内容,完成资料整编、数据梳理、方案撰写。开放能力:支持对接 WorkBuddy、开放 API 供第三方工具调用知识库。5. 共享知识库(小团队协作)协作方式:创建共享库,添加成员。权限管理:支持精细化权限设置,包括只读、可编辑、管理员。存储优化:成员微信直接入库文件,统一沉淀团队资料,不占用创建者存储空间。6. 微信生态独家优势无缝导入:微信文件/聊天 PDF/公众号文章,长按选择「用其他应用打开」→ IMA 知识库,1 秒存入。无需转发:无需下载转发,免去中间环节。轻量访问:微信小程序随时查库、快速存碎片内容,免装软件即用。三、适用人群1. 学生 & 备考人群整理资料:课件、真题、讲义、网课笔记。提分辅助:题库汇总、考点提炼、论文辅助查阅、碎片化学习资料统一归档。2. 职场上班族岗位覆盖:产品、运营、文案等。工作场景:周报撰写、会议纪要、行业报告、合同资料存档。内容管理:项目素材库搭建、文案选题、内容复盘。3. 自媒体 & 创作者素材管理:公众号素材归档、稿件素材库管理。内容生产:利用 AI 辅助生成脚本、优化文案。4. 小微团队(5–20 人)内部协作:部门轻量化知识库、项目资料共享。替代方案:替代部分石墨、语雀功能,依托微信实现低成本内部协作。不适用场景:大型企业涉密核心数据存储、百万级超大文件存储、本地离线刚需用户。四、免费&付费资费明细✅ 永久免费套餐(绝大多数个人够用)云存储空间:免费 2GB(全端通用,知识库数量不限)。基础 AI 能力:文档解析、知识库问答、基础写作、全网搜索、无次数上限,全部免费。共享知识库:免费开放,无协作人数硬性收费门槛。生态功能:微信全生态导入、笔记、OCR 识图全部免费。⚡ Copilot 高级智能体(算力消耗制,非包月)新人福利:首次开通一次性送 500 免费算力(有效期 31 天,活动截止至 2026.6.30)。每日白嫖:PC/APP 每日登录领 100 当日有效算力,可免费体验 Copilot 任务执行。充值模式:按需付费(微信直接支付),仅高级 Agent 任务消耗算力,不用不扣费。【重要提示】:常规知识库、文档解读、普通 AI 对话全程永久免费,不耗算力,请勿误用高级功能。📌 商业化规划目前个人会员及团队会员暂未正式上线。扩容存储空间等付费方案待定,当前无强制付费项。五、分步上手使用教程步骤 1:登录注册打开官网 ima.qq.com。点击右上角 微信扫码一键登录(无需单独注册账号)。下载客户端:Windows/Mac 客户端(页面顶部下载)。手机端安装:应用宝搜「IMA」装 App,或微信搜小程序「IMA 知识库」。注意:务必保证三端使用 同一个微信账号登录,否则知识库不互通。步骤 2:搭建个人知识库(核心第一步)进入左侧栏【知识库】,点击【+ 新建知识库】。命名知识库(例如:2026 考研资料库、新媒体素材库)。上传文件:点开知识库右上角「+」。本地上传、粘贴网页链接、导入公众号。拖拽文件直接上传。等待解析:等待 1–3 分钟,确保状态栏显示「解析完毕」才能检索。步骤 3:三大高频用法文档精读:上传 PDF 报告→对话框提问「总结全文要点 + 提炼关键数据」,AI 基于原文作答。微信快速存资料:微信打开公众号→右上角…→用其他应用打开→IMA 知识库,一键入库。AI 写作:左侧【笔记】新建空白→输入 / 唤起 AI,生成文稿,写完一键入库。步骤 4:团队共享新建【共享知识库】。点击右上角分享。通过微信发送给好友。设置成员权限(只读/编辑/管理员)。步骤 5:Copilot 使用对话页切换至 Copilot 模式。输入任务指令(例如:汇总本库所有行业文档,生成 3000 字行业分析)。系统消耗算力执行任务。六、新手避坑重点(高频踩坑汇总)1. 存储空间坑规划建议:免费 2GB 空间需合理规划。清理习惯:不要全量上传多年杂乱文件夹,只留存高频查阅核心文档,定期删除无用附件。大文件处理:大体积视频/压缩包不建议上传,建议改用本地存储 + 文档摘要入库。2. 文件解析&检索坑等待状态:文件上传必须等解析完成(状态栏显示解析完毕)才能搜到。常见错误:刚上传立刻提问大概率查无内容。链接失效:网页链接失效会导致入库失败,需重新粘贴导入。3. 隐私安全红线(重中之重)严禁上传内容:公司核心机密、财务报表、客户隐私、身份证/合同涉密内容、学生隐私成绩单等。风险提示:虽腾讯加密,但不适合存高度敏感数据。重要涉密资料建议本地留存,不上传云端。4. Copilot 算力坑有效期:每日领取 100 算力仅限当天有效,隔夜清零,当日不用作废。新人福利:首次赠送 500 算力,31 天到期自动清空,按需使用高级功能。计费原则:普通问答、文档总结完全不耗算力,切勿误用 Copilot 浪费算力。5. 多端同步坑操作建议:小程序仅适合简易存资料、查内容;批量上传、建库优先在电脑端。移动限制:手机 APP 适合碎片化记录,大批量文件别在移动端操作。账号一致:三端务必 同一个微信账号登录,否则知识库不互通。6. AI 幻觉坑复核义务:即便基于自有文档,AI 数学计算、专业数据仍可能出错。使用原则:关键内容务必对照原文复核,不能直接照搬输出内容。7. 备份坑本地备份:重要文档定期 导出 PDF/Word 本地备份。风险防范:避免平台规则变动或误删导致文件无法找回。七、同类产品对比参考对标 NotionIMA 优势:微信生态深度打通、国内访问零卡顿、免费 2GB 空间。Notion 劣势:海外服务器加载慢、免费版单文件 5MB 限制、国内访问体验差。对标语雀IMA 优势:AI 能力更强、支持文档自动解析、支持私有 RAG。语雀优势:侧重团队文档排版管理。对标 ObsidianIMA 优势:云端自动同步、AI 内置。Obsidian 优势:纯本地无云端、隐私性极高。Obsidian 劣势:本地无原生 RAG(检索增强生成)能力。
Xwiki
XWiki 全攻略一、平台介绍XWiki 是第二代开源企业级 Wiki 知识管理平台,于 2004 年诞生。1. 核心基础开发语言:Java 开发,采用 LGPL 开源协议。协议优势:永久开源,源码全开放,数据自主可控,无厂商锁定。市场定位:对标 Atlassian Confluence,替代传统 MediaWiki,兼顾「文档知识库 + 低代码表单 + 企业内网 + 业务系统搭建」多重能力。2. 官方渠道开源社区版官网:xwiki.org(功能全开源免费)。商业服务站点:xwiki.com(官方商业服务与技术支持)。3. 核心特色能力融合:页面结构化 + 零代码自建应用 + 750+ 官方扩展插件。系统定位:既可以做普通文档 Wiki,也能不用编程搭建 CRM、台账、项目管理系统。部署形态:支持私有化本地部署、服务器自建、Docker 部署、官方云端托管三选一,数据完全存在自己服务器,适合政企数据合规需求。用户规模:全球用户包括亚马逊、EDF、军工、政企、高校、软件研发团队广泛落地,是 Confluence 最主流的开源平替。二、核心主要功能1. 富文档协作编辑(基础 Wiki 能力)编辑器:可视化所见即所得编辑器,兼容 Markdown、标准 Wiki 语法。内容能力:支持分段单独编辑、插入表格/图片/附件/代码块/引用。版本控制:全版本历史回溯、单页回滚、修改日志、评论批注、多人在线协同。文档管理:支持 Word/Excel/PDF/ODF 导入导出,支持批量文档打包导出。2. 精细化空间与权限管控(企业王牌)权限层级:按全局→空间→页面→单文档四级权限管理。配置灵活:单独配置用户或用户组「查看/编辑/删除/上传/管理员」权限,支持只读、评论、可编辑分级,涉密文档单独锁权限。身份认证:对接 LDAP/AD/微软 EntraID/企业微信单点登录(部分为付费 Pro 插件)。3. 结构化数据与零代码自建应用数据能力:无需代码,自定义字段(单选/日期/附件/人员/数字/关联字段)。应用生成:快速生成表单数据库,同一份数据可切换列表/表格/看板视图。业务场景:可自建台账、招聘库、设备管理、项目排期、CRM,对标 Notion 数据库、Confluence 自定义表单。4. 海量扩展生态插件数量:官方扩展库一键安装,含 750+ 插件。常用功能:日历、投票、论坛、任务管理、表单、OnlyOffice 在线预览、全文检索(Solr)、Confluence 一键迁移工具、网盘附件管理、邮件通知。5. 全文检索、多语言与附件管理搜索:全局全文检索,支持附件内文档内容检索。多语言:原生多语言支持,含简体中文界面。附件:附件不限单文件大小(自建部署无容量限制),支持附件预览与分类归档。6. 脚本扩展(高阶开发)开发支持:页面内嵌 Groovy/Velocity/Python 脚本。定制逻辑:支持二次开发定制页面逻辑,IT 团队可深度定制内网系统。三、适用人群✅ 1. 企业/研发团队(最主流)软件公司:研发知识库、接口文档、需求台账、项目 SOP、BUG 归档,替代付费 Confluence。职能管理:行政/人事/生产部门,管理规章制度库、员工档案、设备台账、生产流程手册、供应商管理。集团内网:构建企业内部门户网站,或作为对外帮助中心(外网知识库)。✅ 2. 高校/培训机构教学场景:课程知识库、课件归档、题库管理、在线课程文档、社团资料中心。✅ 3. 政企/事业单位合规需求:私有化知识库,政策文档库,数据本地存放,满足等保与数据不出内网要求。✅ 4. 技术爱好者/小团队个人使用:个人自建知识库、开源项目文档站、个人资料归档。❌ 不适合人群纯小白/零运维:需要一定的服务器运维能力。极简云端需求:不想搭建服务器且仅想要开箱即用云端服务的(可选官方云付费版)。移动端重度用户:追求极简移动端轻量化体验的(原生 APP 体验弱于 Notion)。四、免费与付费明细核心规则:XWiki 软件本体 100% 永久免费开源,无用户数、页面、空间限制。付费仅为「官方技术支持 + Pro 商业插件 + 官方云端托管」。1. 开源免费版(Community Edition)来源渠道:xwiki.org 下载。费用说明:永久免费。功能范围:全核心功能,包括文档编辑、权限管理、结构化自建应用、基础扩展。无用户上限、无存储上限(自建服务器硬盘决定容量)。限制条件:无官方技术售后支持。无法使用 Pro 付费插件(如 AD 单点、Confluence 迁移、OnlyOffice 商业版、流程引擎)。遇到问题只能社区论坛求助。部署方式:自行在服务器或 Docker 安装,数据全归自己。2. 付费三大套餐(XWiki SAS 商业服务)① XWiki Cloud(官方云端托管)适用场景:不用自建服务器,适合不想运维的团队。计费标准:起步 2.5 欧元/用户/月,最低 10 用户起购。服务内容:官方运维服务器、自动备份、基础技术支持、预装全部 Pro 插件、欧洲合规服务器、ISO27001 认证。② 私有化付费技术支持(Self-host 支持包)适用场景:自建服务器,但需要官方服务支持。Basic 基础版:年费起步约 570 欧元,含邮件支持、常规故障答疑、免费小版本升级。Business 商业版:优先工单、远程协助、全 Pro 应用授权。Enterprise 企业版:7×24 小时应急、定制开发、现场技术服务、Confluence 批量迁移服务。③ Pro 付费插件包采购方式:单独采购企业级插件。典型功能:AD 集成、流程审批、Confluence 迁移工具、企业级 OnlyOffice 对接。注意:如果不买 Pro 插件,社区免费版无法使用该类功能。3. 教育优惠政策支持:高校非商用部署,可申请免费 Enterprise 级技术支持。五、分步上手使用教程方式一:本地快速试用(Standalone 便携包)下载:访问官网 xwiki.org→Download 下载 Standalone 独立包(内置 Jetty+HSQL 简易数据库,无需额外装 JDK/MySQL)。运行:Windows 系统运行 start_xwiki.bat。Linux/mac 系统运行 start_xwiki.sh。访问:浏览器打开 http://localhost:8080/xwiki。登录:初始化管理员账号(admin+ 自定义密码)。耗时:5 分钟即可完成试用。方式二:正式生产部署(3 种主流)Docker 一键部署:使用 docker run 拉取官方镜像,一行命令启动,推荐中小企业生产环境。WAR 包部署:安装 JDK8+Tomcat+MySQL/MariaDB,将 WAR 包放入 Tomcat 部署(传统企业选型)。Debian 系统安装:使用 apt 安装官方 deb 安装包。方式三:后台基础使用步骤新建空间:首页创建空间(如研发部/行政部),空间用于分类整类文档。新建页面:在空间内新建文档,使用可视化编辑正文,插入附件/表格。自建数据库表单:点击首页→应用→App Within Minutes,自定义字段生成台账页面。权限配置:在空间/页面右上角设置权限,新建用户组,分配浏览/编辑权限。安装插件:进入后台扩展中心,一键安装日历、在线预览等免费插件。六、新手避坑重点1. 环境部署坑(最大痛点)JDK 版本:仅兼容 JDK 8~JDK 17,不兼容 JDK 20+、Tomcat 10+,装错直接启动报错。数据库配置:生产环境禁用自带 HSQL 嵌入式数据库(性能差、易损坏),必须换 MySQL/MariaDB/PostgreSQL,数据库编码统一设为 utf8mb4。内存配置:单机部署服务器内存≥2G,Tomcat 需配置堆内存,内存过小会导致打开页面卡顿、附件上传失败。2. 中文本地化坑语言包:原生简体中文不全,首次部署后需在扩展中心安装中文语言包,否则部分菜单显示英文。离线环境:离线环境无法在线下载插件,需提前离线下载 XIP 扩展包并本地导入。3. 免费版功能边界坑Pro 插件:AD/企业微信单点、Confluence 一键迁移、高级审批流均为Pro 付费插件,免费开源版无,不要误以为全插件免费。社区插件:社区插件质量参差不齐,小众扩展容易兼容新版本报错,优先选择官方认证扩展。4. 备份坑备份策略:自建私有化必须定期全库备份数据库+XWiki 数据目录。风险:无自动云端备份,虽然版本免费版有全量历史,但硬盘损坏数据无法找回。5. 性能坑附件存储:附件海量存储不要存在数据库内,需配置附件外置磁盘路径,否则数据库膨胀会导致查询卡顿。6. 移动端坑设备体验:无官方原生 APP,手机仅支持浏览器访问页面,复杂表单/数据库编辑体验差,移动端重度使用不推荐 XWiki。7. 升级坑升级操作:跨大版本(如 14→15)不要直接覆盖升级。前置操作:先全量备份,部分自定义插件新版本不兼容,需检查兼容性后再升级。
AppFlowy
AppFlowyAppFlowy 是开源免费、数据自主可控的 Notion 平替 AI 协作工作台,主打本地存储、私有化部署、全平台离线使用。其遵循 AGPL-3.0 开源协议,核心优势在于用户 100% 掌控自有数据、无厂商锁定。一、平台基础介绍1. 产品定位开发背景:由全球社区共建(10000+ 社区成员、215 个国家、400+ 开发者)。技术架构:基于 Flutter 前端 + Rust 后端开发。对标对象:对标 Notion 一站式知识库 + 项目 + 任务 + 团队协作工具。核心卖点:隐私优先、全开源、本地 AI、离线可用、高度自定义。2. 支持终端桌面端:支持 Windows / macOS / Linux。移动端:支持 iOS / Android。网页端:支持浏览器访问。部署方式:支持 Docker 自托管部署,多端数据无缝同步。3. 核心产品理念数据主权:所有数据归用户所有,可本地存、可自建服务器部署。AI 隐私:内置 AI 助手,支持本地部署大模型,不用把文档上传第三方云端即可调用 AI 处理内容。二、核心功能明细(一)文档 & 知识库(Wiki)块级富文本编辑器:支持 Markdown 编辑。支持图片、音视频、表格嵌入。支持分页嵌套、多层级页面搭建个人知识库。页面自定义:自定义主题、字体、页面样式。支持深色 / 浅色模式切换,自由排版布局。全格式导出:支持 Markdown、PDF 等主流格式导出文档。(二)数据库 & 项目任务管理多视图数据库:支持 表格、看板、画廊、日历 4 种视图自由切换。自定义字段(文本、日期、单选、附件),拖拽调整任务/数据。项目拆解:支持拆分项目 → 子任务 → 待办清单。自动统计项目进度,批量管理任务库。AI 自动填表:一键 AI 批量填充数据库。海量数据表自动提炼数据洞察、生成工作总结。(三)AppFlowy AI(核心亮点)云端 API 调用:接入 GPT-5、Gemini2.5、Claude3.7 等主流模型。实现文案润色、头脑风暴、内容总结、问答检索。本地离线 AI:支持本机部署 Mistral7B、Llama3 开源大模型。不上传任何文档到外网,私密内容本地 AI 处理,极致隐私。全局页内 AI:选中任意段落,一键扩写、改写、提炼要点、生成行动项。(四)协作与存储团队实时协作:支持多人同页编辑、权限管控、跨设备同步。异地团队云端协作。三种存储方案:本地离线:100% 离线使用,数据存在本机硬盘。官方云:AppFlowy 云端同步(分免费/付费订阅)。自建私有云:Docker 自托管,部署在个人 VPS/公司服务器,完全自主管控。(五)拓展生态海量官方/社区模板:提供项目管理、读书笔记、日程表、简历、产品需求文档等模板。插件自定义:社区插件市场安装日历、自动化、第三方集成插件。三、适用人群✅ 首选人群个人知识爱好者/学生:考研笔记、读书笔记、个人日程、档案管理,重视隐私不想笔记上传大厂云端。自由职业/创作者:文案素材库、选题库、项目排期,本地 AI 私密生成稿件。中小型创业团队/小公司:产品、研发、行政搭建内部知识库、项目看板,低成本替代 Notion 付费订阅。数据敏感行业(法务/科研/涉密):文档不能外流,需要本地部署、私有化存储,拒绝厂商数据托管。技术爱好者/程序员:开源二开、自建专属协作系统,Docker 私有化部署、二次定制开发。❌ 不适合人群大型集团:上万人大规模协同(企业级权限、复杂审批功能不完善)。重度依赖第三方:重度依赖飞书/钉钉深度集成的用户(目前集成深度不足)。四、免费&付费方案1. 永久免费权益(本地离线版,无任何限制)全功能无阉割:文档、数据库多视图、基础 AI 本地部署、无限页面、无限存储空间。无人数限制:个人/小团队本地文件互通,永远免费,无空间、页面上限。开源代码自由下载、修改、私有化部署。2. 官方云端订阅(需要跨设备云端同步、团队在线协作选付费)免费云版价格:0 元权益:单账号、5GB 云端存储空间、基础云端同步、少量 AI 额度、模板限量。Pro 个人版价格:约 $8/月(年付优惠)权益:无限云空间、全量 AI 调用额度、全部模板、移动端全功能同步、优先客服。Team 团队版价格:$12/人/月权益:团队成员管理、精细化权限、团队共享空间、专属云端同步、团队 AI 套餐、自建域名。3. AI 额外付费说明本地部署开源大模型:如 Llama3/Mistral,完全免费,仅消耗本机硬件资源。调用闭源 API:如需调用 GPT/Claude 等,需自行在对应厂商充值 API Key 填入 AppFlowy,按第三方计费扣费,平台不抽成。五、分步使用指南(新手快速上手)步骤 1:下载安装普通用户:访问官网 appflowy.com→Download,选择对应系统安装包(Windows exe/macOS dmg/Linux AppImage);移动端应用商店搜 AppFlowy。Mac 极简安装:打开终端执行 brew install --cask appflowy 一键安装。技术用户:使用 Docker 部署 (docker run + 挂载命令),自建私有服务。步骤 2:初次启动,选择存储模式个人自用:选Local 本地存储,数据存电脑,全程离线免费。多设备同步:注册 AppFlowy 账号,选择官方云存储。企业私有化:选择 Docker 自托管,对接自有服务器。步骤 3:创建工作区&页面新建 Workspace(工作空间):按场景拆分,如「工作项目」「私人笔记」「考研资料」,一个工作区对应一套独立知识库。新建页面:可创建空白页,或套用模板(项目看板、读书笔记模板一键生成)。步骤 4:数据库搭建&视图切换插入数据库:在页面内插入 Database 数据库块,自定义字段。切换视图:顶部切换表格/看板/日历视图,拖拽卡片调整任务进度。步骤 5:AI 配置二选一云端 AI:设置→AI 设置→填入 OpenAI/Claude API 密钥,直接在线调用。本地 AI:下载 Mistral/Llama 模型文件,软件内选择本地模型路径,离线运行 AI。步骤 6:团队协作团队成员注册账号。主账号邀请加入工作区,分配只读/编辑/管理员权限。开启多人实时协同。六、避坑指南(高频踩坑 + 解决方案)1. 存储坑:选错存储丢数据问题:新手误选官方云,免费云只有 5G,满了无法同步;换设备找不到本地文档。解决:个人优先本地存储,重要文档手动备份文件夹;需要云端同步再开付费 Pro。2. AI 使用坑:云端 API 扣费失控问题:填入 GPT API 后无用量管控,大量 AI 调用超额扣费;国内网络无法直连 OpenAI。解决:私密内容优先本地开源 AI(免费);云端 API 设置用量限额,国内优先使用 Gemini 国内可用模型。3. 性能坑:海量文档卡顿问题:单个数据库上万条数据、百页嵌套文档后低配电脑加载变慢。解决:大项目拆分多个工作区,拆分数据库,不用单页堆砌全量数据;自托管用户升级服务器配置。4. 功能坑:对标 Notion 但功能仍不完善问题:部分高级功能(自动化工作流、复杂表单、第三方深度集成)缺失,不如 Notion 成熟;移动端部分视图适配一般。解决:刚需复杂自动化搭配外部插件,不要指望原生一步到位;重要项目先用桌面端搭建。5. 自托管坑:新手 Docker 部署失败问题:小白无运维基础,自建服务器部署报错、端口/挂载配置出错。解决:新手先用本地版,有运维基础再尝试 Docker,参考官方部署文档。6. 同步坑:多端同步延迟问题:免费云服务器在海外,国内移动端同步缓慢、偶尔断连。解决:国内用户优先本地 + 手动网盘备份;团队刚需选 Pro 付费云,或自建国内服务器私有化。七、优缺点总结优点✅ 本体永久免费开源:客户端本体永久免费,代码可看。✅ 数据完全自主:数据不上传第三方,自主备份。✅ 本地 AI 不上传隐私:支持本地部署模型,保护文档隐私。✅ 全平台 + 离线可用:支持桌面、移动端,支持断网使用。✅ 高度自定义:无厂商锁定,无强制订阅。缺点❌ 高级协作功能少于 Notion:审批流、复杂权限等不如 Notion 完善。❌ 免费官方云国内同步不稳:国内用户需自建或使用 Pro 版。❌ 自托管有技术门槛:需要一定的运维能力。❌ 闭源 AI 需要自备 API:使用云端 API 时需自行准备密钥。
AFFiNE
AFFiNE全平台使用指南一、平台基础介绍1. 核心定义 AFFiNE 是由万有理论科技(杭州)ToEverything 团队研发的国产开源 All-in-One 全能知识工作空间(KnowledgeOS)。它对标的是 Notion、Miro 及多维表格的三合一产品,目前在 GitHub 项目拥有超 59K Star,并曾登顶 Product Hunt 当日最佳产品。2. 核心设计本地优先(Local-First):数据默认优先保存在本机,不强制上公有云,主打隐私自主可控。离线全功能:支持离线编辑与全功能使用,适合网络环境不佳场景。开源协议:采用 MIT 协议,可免费查看源码,支持私有化部署。3. 产品定位 一站式完成文档写作、自由白板手绘、多维数据库、项目任务管理、AI 辅助创作,旨在帮助用户告别多软件来回切换,既适合个人用户,也通用于中小团队。4. 客户端覆盖桌面端:Windows / macOS / Linux移动端:Android / iOS获取方式:访问官网 affine.pro 可直接下载安装包。二、五大核心功能详解1. 模块化富文本文档(对标 Notion)全块式编辑:所有内容均由文本、标题、列表、引用、附件、表格、代码块等基础积木组成。标题层级:支持 H1 到 H6 六级标题。高级功能:支持待办清单、书籍读书笔记模板、双向内链 [[页面名]]。知识库搭建:支持跨文档引用段落,适合构建网状知识库(类似 Roam Research),适用于读书笔记、文稿撰写及知识沉淀。2. 无限画布白板(对标 Miro)无边框模式:文档页面可一键切换白板模式(Edgeless),在文档里随手涂鸦。创作内容:支持手绘流程图、思维导图、头脑风暴。协作与模板:支持多人实时同屏手绘协作,内置行程规划、故事板现成模板。适用场景:旅行清单、选题脑暴、方案草图一站式落地。3. 多维数据库与项目管理(对标 Airtable+Trello)四种视图:单数据库支持表格、看板、画廊、列表 4 种视图一键切换。丰富字段:字段类型含文本、数字、单选/多选、日期、人员、公式、附件。任务追踪:看板视图可设置负责人、优先级、截止日期、进度百分比(Done/Doing/Todo)。管理场景:适配项目排期、书籍章节进度管控、旅行投票统计、打包清单管理等。4. AFFiNE Copilot 内置 AI 助手原生集成:无需额外接入第三方,直接调用 AI 能力。写作辅助:续写文稿、总结摘要、改写润色、翻译全文。智能问答:提供旅行攻略、行程规划、资料答疑(如巴黎出行贴士、卢浮宫游览顺序)。内容生成:清单、大纲、读书笔记、方案文案一键生成。5. 团队协作与模板生态实时协作:支持多人在线编辑、评论、页面权限管控、空间资源共享。预制模板:提供康奈尔笔记、行程表、项目计划表、书单、愿景板、购物清单、知识库首页等,开箱即用,无需从零搭建。三、适用人群✅ 高度适配用户个人用户学生:课堂笔记、论文规划、读书打卡。自由职业者/自媒体:选题脑暴、内容台账。上班族:个人待办、知识归档。宝妈:家庭台账、孩子日程管理。中小创业/项目团队产品、市场、研发小组,统一沉淀项目文档、需求看板、营销方案。替代 Notion+ 飞书文档 + 白板等多工具。研发/运维/技术团队自建私有化知识库,本地部署管控项目数据,支持开源二次开发定制。设计师/策划文案 + 草图 + 项目排期在同一画布完成,无需切换 PS/Miro/Excel。❌ 不太适配超大型集团:千人以上,复杂组织架构及精细化分级权限暂时不完善。ERP 联动需求:强依赖企业级 ERP 联动的用户。四、免费与付费资费详情AFFiNE 采用个人永久免费 + 团队分级付费 + 私有化部署模式。个人全功能永久免费(无文档数量上限)。1. 免费版(个人永久使用)功能范围:全部核心功能,包含文档、白板、多维表格、基础 AI、离线编辑、点对点设备同步。存储限制:本地存储:无上限。云端备用空间:免费 100MB 附件空间,单文件上限 5MB。功能限制:无团队多人云端实时协作(仅支持文件互传)。高级 AI 额度受限。无法自定义域名发布网页。2. 付费版本(团队/商用)Pro 专业个人版适用对象:重度个人创作者。核心权益:扩容云端存储空间。全量 AI Copilot 不限次数。网页发布功能。跨设备云端自动同步。Team 团队版适用对象:5 人及以上中小型团队。核心权益:多人实时云端协作。团队空间管理与精细化成员权限。超大附件存储。专属客服支持。Enterprise 企业定制适用对象:中大型企业。核心权益:私有化本地部署。专属运维与定制开发。数据安全合规服务(报价面议)。补充说明:开源版支持自行 Docker 私有化部署,全程零订阅费,数据全由自建服务器托管,适合技术团队省成本。五、新手分步使用教程方式一:客户端使用(90% 普通用户首选)下载安装:访问官网 https://affine.pro。点击顶部 Download,选择对应系统安装包(Windows/Mac/安卓/iOS)。本地使用:安装打开,无需强制注册账号即可本地新建文档。即可免费本地离线使用。创建页面:新建工作空间→新建 Page 页面。写笔记:默认文档模式,输入内容、插入列表/附件。切白板:页面右上角切换 Edgeless 无边框画布,拖拽手绘。建数据库:输入 /database 快速插入数据表,右上角切换看板视图做任务。AI 使用:选中文字或点击侧边 Copilot,输入指令(如写清单、总结文章)。跨设备同步:免费版开启 P2P 点对点同步。付费版登录账号云端一键同步全数据。方式二:私有化部署(技术用户)源码部署:运行命令 git clone https://github.com/toeverything/AFFiNE.git。安装 Node + pnpm 启动。Docker 一键部署:通过 Sealos 或自建服务器部署私有云端。所有数据存于自有服务器。新手起步 3 个实用场景模板读书管理:新建页面→插入数据库(字段:章节、完成进度、日期)。对应书本章节进行打卡记录。旅行规划:新建白板→拆分行程、打包清单、目的地投票。利用 AI 生成出行贴士。项目管控:使用数据库看板→录入任务、负责人、截止日。筛选「进行中/已完成」任务。六、使用避坑指南(高频踩坑点)1. 同步相关坑问题:免费版没有官方云端自动同步,跨设备靠 P2P 点对点,两台设备需同时在线才能同步。解决方案:重要内容手动导出 PDF/Markdown 备份;重度同步需求建议升级 Pro 版,或自建私有云。问题:本地换电脑重装软件,未提前导出数据会丢失本机内容。解决方案:养成定期导出页面备份的习惯。2. 功能 Bug 与操作坑问题:数据库切换看板视图偶发页面空白、数据消失(官方已知 Bug)。解决方案:切换视图前先保存;避免频繁切换表格/看板;更新软件到最新正式版。问题:导出表格视图文件偶发失败,大尺寸白板画布导出卡顿。解决方案:超大画布拆分多页面再导出,分批次导出附件。3. 存储与文件坑问题:免费云端附件仅 100MB,频繁传大图/视频很快占满空间。解决方案:大文件存在本地,附件改用外链链接,不上传云端。4. AI 使用坑问题:免费 AI 每日有调用次数限额,高频生成文案容易额度用尽。解决方案:拆分提问、精简指令;高频使用建议开通 Pro 版解锁无限 AI。5. 团队协作坑问题:免费版多人无法云端实时协作,只能文件互传。解决方案:小团队短期试用优先 Team 版,或选择自建私有化部署以节省成本。七、补充小技巧快捷键操作:输入 / 快速唤起块菜单,一键插入表格/白板/待办。输入 [[ 快速创建页面内链。导入迁移:支持导入 Notion 文档或 Markdown 文档。可一键批量搬家原有笔记。社区资源:访问 AFFiNE 社区可免费下载用户分享的各类成品模板。直接导入使用,提高效率。
Outline
Outline 全指南Outline 是一个开源、高性能团队知识库与在线协作文档平台。它对标 Confluence 和 Notion,主打轻量化 Wiki、Markdown 编辑与实时多人协作。平台分为云端托管版(官网 getoutline.com)与私有化自部署开源版两种使用模式。一、平台介绍1. 基础概况官网地址:https://www.getoutline.com技术栈:基于 Node.js+PostgreSQL+Redis 开发。核心定位:企业/团队统一知识沉淀中心。旨在解决文档分散、权限混乱、反复查资料及跨群重复提问等痛点,适合搭建内部 Wiki、产品手册、研发文档及运营 SOP 知识库。核心优势:毫秒级极速加载,原生 Markdown 编辑体验好。支持实时在线协同编辑,支持精细化权限管控。提供 20+ 种第三方工具集成,支持多语言(含简体中文)。支持自定义域名与白标私有化部署。两种使用形态:SaaS 云端版:直接在官网注册使用,数据由官方托管。Self-host 自部署版:源码开源,部署在企业自有服务器,数据完全自主可控,永久免费且无文档上限。二、主要核心功能1. 文档编辑能力双格式编辑器:支持原生 Markdown 与富文本切换,内置 > 引用、任务列表、有序/无序列表、图片/附件/表格插入、斜线快捷指令(Slash Command)及网页内嵌预览。多人实时协作:支持同文档多人同时在线编辑,光标实时同步,提供评论@成员、话题留言、版本历史留痕及一键回滚功能。AI 问答检索:基于全库毫秒级全文检索,AI 可直接根据文档内容回答问题,无需手动翻页查找;支持按合集、作者或时间筛选。2. 知识库结构管理合集(Collections)分类:支持自定义多级分类架构(如工程、设计、市场、归档等),可新建合集收纳同类文档,支持跨合集移动、收藏星标及草稿箱管理。Webhooks 接口:提供异步事件回调(如新增用户、文档更新触发通知),便于对接自研系统与自动化流程,配套开放 API 支持二次开发。3. 分享与权限管控多层权限:支持团队分组、成员读写/只读权限区分,支持外部访客模式及单文档私有/公开链接分享。外链公开:可生成公开访问链接,无需注册即可查看,适合发布对外产品说明书或帮助文档。品牌定制:支持自定义品牌域名(如 docs.xxx.com)、替换 LOGO 及配色,实现白标私有化。4. 生态集成与附加能力主流工具打通:集成 Slack、Figma、Loom、Zapier 等 20+ 工具,支持 Slack 指令一键搜索知识库及文档更新自动推送。企业级认证:支持 SSO 单点登录与 SAML 企业认证。基础配套:包含暗黑模式、20 国语言支持、文档归档回收站、版本变更日志及企业审计日志。三、适用人群与使用场景1. 研发团队场景:接口文档、前后端开发手册、故障复盘、技术规范知识库。2. 产品与运营团队场景:PRD 需求文档、活动 SOP、产品帮助中心、运营规范沉淀。3. 初创与中小企业场景:全公司制度、入职手册、项目资料统一 Wiki(用于替代笨重的 Confluence)。4. 远程与跨地域团队场景:异地实时协同写方案、统一信息口径,减少聊天重复答疑。5. 设计与内容团队场景:设计规范、文案素材库、稿件存档、品牌规范文档。6. 个人与自由职业者场景:个人知识库、读书笔记、项目资料归档(免费版完全够用)。2. 局限与不适用不建议场景:重度可视化拖拽搭建页面(这是 Notion 的强项)、复杂表单数据库管理。四、收费标准与套餐选择1. 私有化自部署(开源版)费用:永久全功能免费。权限:无文档数量、成员人数、存储空间限制。条件:需自备服务器及云资源成本(服务器 + 对象存储),数据完全本地掌控。2. 官方 SaaS 云端订阅(getoutline.com)试用政策:注册即送 30 天全功能免费试用,试用结束必须升级付费。套餐类型价格成员上限核心权益Starter(小团队)$10/月1~10 人无限文档、版本历史、评论、AI 问答、基础集成Team(中型企业)$79/月11~100 人含 Starter 权益 + SSO、分组权限、审计日志、Webhook 完整 API、优先客服Business(大企业)$199/月101~250 人含 Team 权益 + SAML2.0、Confluence 迁移、高级安全审计、专属售后注意:百人以上规模建议优先考虑自建,以降低成本。五、分步使用指南方式一:云端 SaaS 快速上手(新手首选)注册创建工作区:打开官网,使用邮箱 Sign up,创建团队空间(自定义团队名称及知识库域名前缀)。搭建知识库分类:点击左侧「COLLECTIONS」→+New collection,按部门(如工程、产品、市场)新建合集。新建文档:选中合集→New doc,使用 Markdown 或富文本编写内容,支持粘贴图片、上传附件、插入表格。成员管理:进入设置→Invite people,输入邮箱邀请成员,并设置成员「编辑」或「只读」权限。文档分享:打开文档右上角 Share,生成私密团队链接或公开外链;可集成 Slack 实现文档更新自动推送。AI 检索:使用顶部搜索框输入关键词,开启 AI 问答直接基于文档内容获取答案。方式二:私有化 Docker 自建部署(企业长期用)环境准备:服务器内存≥2G,安装 Docker+Docker Compose,准备域名、SMTP 发件邮箱及 S3/MinIO 对象存储。拉取部署脚本:运行 git clone outline-docker-compose,复制配置文件并修改(域名、时区、账号)。配置环境变量:编辑 .env 文件,配置数据库地址、Redis 地址、密钥、邮箱配置及 S3 存储参数。一键启动:运行 docker compose up -d,浏览器访问自定义域名完成初始化注册管理员账号。后续配置:对接企业 SSO、配置自动备份任务、自定义 LOGO 及域名白标。六、高频避坑清单1. 自建私有化部署必避坑存储坑(图片附件丢失):Outline 数据分为 PostgreSQL(文档正文)和 S3/本地盘(图片/附件)。只备份数据库会丢失全部素材。规范:需同时备份 pg_dump 数据库 + 打包 uploads 附件目录 + 留存 .env 配置文件。提示:新版本默认推荐 MinIO,需手动创建 S3 存储桶,否则图片上传会报错。实时协作异常:Redis 版本必须≥6.0,容器网络需连通(可 telnet redis 6379 测试),配置错误会导致光标错乱。升级翻车:Outline 迭代快(1~2 个月/次),升级前需在测试环境验证;自定义 CSS 或 LDAP 插件可能不兼容,升级前请备份自定义配置文件。邮箱配置遗漏:SMTP 配置错误会导致无法发送邀请及变更邮件,建议测试优先使用 QQ 或企业邮箱 SMTP,并关闭风控拦截。2. SaaS 云端使用避坑费用陷阱:30 天试用结束若不主动取消支付方式,系统会自动按月扣费。权限泄露:公开分享链接后任何人可查看,重要内部文档禁止生成公开外链,优先使用团队私有分享。中文搜索:云端默认分词对中文检索较弱,自建版需额外配置中文分词插件,否则搜不到中文关键词。3. 日常使用避坑合集规划:初期不规划分类会导致后期文档散乱,上线前应按部门或产品线划分合集,统一存放规范。Webhook 调试:配置异步回调先使用测试地址,避免错误回调频繁触发占用接口额度。七、优缺点总结1. 主要优点速度快:加载速度远优于 Confluence,轻量化无冗余功能。Markdown 友好:原生 Markdown 编辑,对研发人员极度友好。成本可控:开源自建零软件费,数据自主可控,适合长期低成本搭建企业 Wiki。高度定制:集成完善,自定义程度高,白标私有化可做企业内部帮助中心。2. 主要缺点SaaS 成本:云端付费按人数计价,百人以上成本较高,大团队更推荐自建。功能限制:原生无数据库看板、复杂表单功能,不适合低代码业务搭建。运维门槛:自建部署对服务器和运维有一定门槛,无基础的小白建议先用云端试用。
Wiki.js
Wiki.js 完整使用手册一、平台介绍Wiki.js 是基于 Node.js 开发、开源免费的现代化知识库/Wiki 系统,采用AGPL-v3 开源协议。官网地址为 https://js.wiki/,是目前全球主流自建文档知识库工具。GitHub 粉丝超 28400+,累计下载超 1 亿次。1. 基础架构开发架构:后端基于 Node.js,前端采用现代化 UI 设计。部署环境:支持 Windows Server、macOS、Linux、K8s 及 Docker 多环境部署。硬件兼容性:兼容树莓派小主机到云服务器全规格硬件。2. 数据库兼容系统支持五种主流数据库,用户可按需选型:PostgreSQLMySQL/MariaDBSQL ServerSQLiteMicrosoft Access3. 产品定位旨在替代传统 MediaWiki 或 Confluence,适用于:企业知识库项目文档个人笔记产品手册轻量化私有化部署二、核心主要功能1. 多类型文档编辑器(内容创作)Wiki.js 提供多种编辑器以适应不同场景:Markdown 编辑器适用场景:开发技术文档特点:实时预览、快捷键支持、代码高亮,是主流开发者的首选。可视化富文本(WYSIWYG)适用场景:非技术人员文案写作特点:零代码操作,类 Word 拖拽编辑体验。原生 HTML 编辑器适用场景:导入外部网页或存量 HTML 文档特点:直接编写 HTML,适配现有网页内容。WikiText(待上线)适用场景:MediaWiki 系统迁移特点:快速从维基系统迁移存量内容。API/表格编辑器(待上线)适用场景:接口文档、数据表编写特点:类似 Excel 的表格编辑、REST/GraphQL 接口编写。附加内容能力:代码块语法高亮及行号显示。UML、流程图、时序图绘图功能。TeX 数学公式渲染支持。音视频嵌入(支持 Youtube、asciinema 等)。版本全追踪:页面修改留痕、版本对比、回滚历史版本、删除页面恢复、单页导出及基于旧版本新建页面。2. 多渠道登录认证(权限管控)系统提供完善的登录认证体系:本地账号:支持内置注册、找回密码功能。第三方社交登录:支持 GitHub、微软、谷歌、Facebook、Discord、Slack 等 OAuth 登录。企业级登录:支持 LDAP、SAML、CAS、Azure AD、Okta、Auth0、通用 OIDC/OAuth2。安全加固:所有登录方式均支持 2FA 双因素认证。3. 精细化权限&分组管理用户分组:支持批量分组管控权限,避免单用户逐个配置。细粒度权限:控制页面编辑、附件上传、后台管理、页面访问等分级权限。页面规则:通过路径前缀、后缀或正则表达式批量配置页面访问权限。站点模式:支持全站公开、全私密、部分页面公开混合三种模式。4. 多方式内容存储&备份Git 同步(核心):文档自动同步/备份至 GitHub、GitLab、Bitbucket、Azure DevOps,依托 Git 进行版本兜底。企业云盘:支持 AWS S3、Azure Blob、谷歌云存储。个人云盘(待上线):支持 OneDrive、Dropbox、谷歌网盘。本地存储:支持本机磁盘、局域网共享盘、SSH 远程服务器备份。5. 全文检索系统内置数据库检索:开箱即用,适合小型站点。外接搜索引擎:支持 Elasticsearch、Algolia 云搜、Azure 搜索、Solr、Manticore 等(适合中大型知识库)。6. 国际化与页面多语言系统界面:支持全球 40+ 语言,包括阿拉伯语等 RTL 从右向左排版语种。文档多语种:单页面支持做多语言版本,一键切换同文档不同语种内容。7. 自定义美化主题模式:提供深浅两套主题(深色/浅色模式)。自定义样式:后台可直接注入自定义 CSS、JS,自定义页面样式。开发支持:支持开发自定义主题(功能后续完善)、自定义导航样式。8. 资源资产管理内置素材库:文件夹分类管理图片/附件。引用追踪:查看素材被哪些页面引用。编辑器功能:自带图片裁剪、调色编辑器(即将上线)。三、适用人群&使用场景1. 企业团队(最主流)研发团队:编写接口文档、技术规范、运维手册、项目迭代文档。行政/人事:管理公司制度、员工手册、规章制度、培训资料。产品团队:撰写产品需求文档、版本说明、运营 SOP。价值:替代付费 Confluence,低成本搭建内部知识库。2. 开发者/个人用户程序员自建:个人知识库、学习笔记、踩坑文档。开源项目:用于开源项目官方文档站(大量开源项目使用 Wiki.js 做官网文档)。极客玩家:树莓派本地自建私人知识库。3. 社团/培训机构管理机构课件库、社团规章、课程资料、学员手册。服务于小众社群公开知识库。4. 自媒体/内容创作者搭建独立百科站点。创建专栏知识库。四、免费&付费详情1. 开源授权规则(核心)Wiki.js 主体永久免费开源,遵循 AGPL-v3 开源协议:个人/非商用/内部自用:100% 完全免费。无功能阉割、无用户数限制、无页面上限。全部官方内置功能(权限、搜索、Git 备份、多登录、编辑器)免费开放。商用二次修改分发:遵循 AGPLv3 协议。修改源码并对外提供服务时,需要开源修改后的代码。官方无强制付费:无软件订阅费、无授权费。2. 付费仅两种可选(非强制)云托管服务:官方合作云厂商(DigitalOcean 等)提供一键托管部署,费用为云服务器租赁费,非 Wiki.js 软件费用。商业技术支持:如需官方定制开发、7×24 运维服务、企业专属技术顾问,联系开发团队付费购买技术服务(可选,不用可不花钱)。注意:模块、插件、主题全部官方原生免费,无付费功能锁。五、快速使用(安装+上手步骤)方式 1:Docker 一键部署(推荐新手,5 分钟启动)确保服务器预装 Docker 和 Docker Compose。拉取 Wiki.js 镜像 + 配套数据库(SQLite 最简单,无需额外安装数据库)。bashdocker run -d -p 8080:3000 --name=wiki -e "DB_TYPE=sqlite" requarks/wiki:2 docker run -d -p 8080:3000 --name=wiki -e "DB_TYPE=sqlite" requarks/wiki:2 浏览器访问 服务器 IP:8080,按初始化向导设置管理员账号、站点名称,完成安装。方式 2:一键云主机(DigitalOcean marketplace)在 DigitalOcean 云市场一键创建实例,系统自动装好 Wiki.js,开箱即用,仅付云服务器租金。方式 3:原生手动部署(Linux/macOS)安装 Node.js 环境 + 对应数据库。下载 Wiki.js 源码,配置数据库连接配置文件。启动服务,浏览器初始化配置。基础上手使用流程管理员初始化:登录后台→【设置 - 本地化】切换中文界面。配置登录:【模块 - 认证】开启本地/第三方登录(如 GitHub 快捷登录)。创建分组与权限:【用户&分组】新建用户组,配置页面读写权限。新建文档:首页创建页面,选择 Markdown/富文本编辑器编写内容。配置备份:【模块 - 存储】开启 Git 自动备份至 Github 仓库。开启搜索:小型站点用内置搜索,海量文档对接 Elasticsearch。六、部署&日常使用避坑指南(一)部署避坑数据库选型踩坑10 人以内小团队:优先 SQLite,零配置。50 人以上团队禁止 SQLite,并发访问会卡死,改用 PostgreSQL(官方推荐)或 MySQL。MySQL 需开启 InnoDB 引擎,避免 MyISAM 出现版本存储异常。端口&防火墙默认端口 3000,服务器防火墙/安全组需放行对应端口。反向代理 Nginx 后注意配置 websocket,否则后台实时预览失效。Docker 升级坑Docker 部署不要直接删除容器升级。升级前需备份数据库 + Git 同步全量文档,新版本镜像数据库结构可能变动。(二)功能配置避坑Git 自动备份配置使用 Git 存储时,仓库权限需配置成读写权限。只读仓库无法自动提交文档,会导致备份失败。定期核对仓库提交记录。权限配置误区不要直接给普通用户管理员权限,优先分组配置。页面正则规则慎用全匹配 /*,容易误锁全站。第三方登录OAuth/GitHub 登录需在对应平台创建应用。填写正确回调域名,域名错误无法跳转登录。(三)日常运维避坑素材存储大量图片附件不要全存在本地磁盘。开启 S3/Git 附件存储,防止服务器磁盘爆满丢失素材。版本丢失重要知识库务必开启 Git 双备份(本地 + 云端 Git 仓库),避免服务器硬盘损坏文档全丢。搜索引擎文档超万页后停用内置数据库检索,改用 Elasticsearch,否则搜索卡顿超时。升级系统大版本升级前(如 v2.x→v3)先全量备份数据库。官方大版本偶尔存在配置不兼容问题。(四)协议合规避坑企业仅内部部署自用、不对外分发修改后的程序,不受 AGPLv3 开源约束。若修改源码并对外提供 SaaS 服务,必须开源修改代码,避免版权纠纷。七、补充拓展1. 中文支持系统内置简体中文。后台 Locales 一键切换,无需额外汉化包。2. 插件生态原生 50+ 集成模块(登录/存储/搜索/编辑器)。全部免费开关,按需启用。
MrDoc
MrDoc 觅思文档指南一、平台介绍MrDoc 觅思文档(又称觅道文档) 是一款国产开源的私有化部署知识库与在线文档系统。该系统基于 Python + Django + LayUI 技术栈开发,是 Gitee 2020 年度 GVP 开源项目。1. 核心定位数据自主可控:支持本地、内网或公网私有化部署,无平台云端托管。安全隔离:所有文档、素材存储于用户自己的服务器或设备,有效规避 SaaS 平台关停风险及数据泄露隐患。版本迭代:提供开源免费版与商业专业版两大版本,Web 端每月持续更新。部署灵活:支持 Windows/Linux/macOS/NAS/宝塔面板/Docker 等环境,支持内网离线隔离网部署。2. 技术架构开发语言:Python (Django)前端框架:LayUI协议标准:开源项目遵循 GPLv3 协议(需视商用情况开源修改代码)二、核心主要功能1. 文档创作(三大编辑器)Markdown 编辑器:支持思维导图、流程图、ECharts 图表、LaTeX 科学公式、序列图、音视频嵌入、代码高亮及特殊符号(上下标/删除线/表格);内置 Vitor/iceEditor 富文本双编辑器可选。富文本编辑:类 Word 可视化排版,无需代码门槛,适合非技术人员。在线 Office(OnlyOffice):支持在线编辑 Word/Excel/PPT 文件,提供在线预览、修改及保存功能。在线表格:类 Excel 结构化数据管理,适用于台账、清单记录。2. 文集 & 文档管理书籍式树形结构:支持无限层级“文集(书本)+ 子文档(章节)”,支持拖拽排序、上下级绑定。版本控制:支持文档历史版本回溯、回收站恢复、文档复制/移动/转让。辅助功能:支持文档标签、别名设置、目录自动生成、快捷链接及批量管理。导出功能:支持文集整站导出 PDF/电子书,单文档导出多格式。3. 精细化权限管控(核心优势)多级权限:支持浏览/只读/编辑/协作/私密等分级权限设置。灵活控制:支持游客只读、指定成员协作、文档禁止复制、页面水印、全站关闭注册/强制登录。分享机制:可单独设置单篇文档对外分享链接(支持设置访问密码与时效)。4. 全终端多端同步Web 端:主流浏览器网页访问。客户端:支持 Windows/macOS/Linux 桌面客户端。移动端:支持安卓 APP。插件生态:Chrome/Firefox 浏览器插件(网页剪藏、一键保存);Obsidian 插件(双向同步本地笔记与在线文档)。5. 素材 & 存储管理统一素材库:图片/附件集中管理,自定义附件白名单及单文件上传大小限制。存储方案:开源版:仅本地服务器存储文件。专业版:支持对接阿里云/腾讯 OSS 对象存储。预览能力:支持 PDF/Office/主流文本附件在线预览。6. 第三方集成能力单点登录 (SSO):支持企业微信、钉钉、LDAP、OIDC 等第三方登录,企业组织架构一键导入。AI 能力:接入 Dify 大模型框架,内置 RAG 私有知识库;支持文档喂给 AI 进行私有知识库问答、AI 辅助写作、文档总结、语义检索及内容润色/翻译(私有化大模型,不上传原文至第三方)。消息推送:支持 WebHook 消息推送,文档变更可推送至钉钉/企业微信。7. 数据导入迁移批量导入:支持 Joplin、印象笔记、Obsidian 文档批量导入。开放接口:开放 API 与 Token 接口,支持自研系统对接 MrDoc 进行文档读写。三、适用人群 & 使用场景1. 个人用户场景:程序员笔记、自学知识库、读书笔记、个人项目文档、私密随笔。价值:替代本地 Word/零散记事本,实现云端私有化存储笔记。2. 研发/技术团队场景:开发手册、接口文档、运维手册、故障台账、技术沉淀知识库。价值:内网部署杜绝代码/方案外泄。3. 产品/中小企业场景:产品帮助手册、内部制度文档、员工培训教程、客服知识库、对外官网帮助中心。价值:结构化发布,公网部署可开放访客查阅。4. 培训机构/自媒体场景:在线课程文档、教程知识库、付费专栏文档。价值:书籍化结构化发布教程,方便学员查阅。5. 政企涉密单位场景:内网隔离网私有化部署,涉密资料本地留存。价值:满足数据合规要求,不经过公有云。四、免费 & 付费版本详情✅ 开源版(永久免费,GPLv3 开源协议)适用对象:个人用户、5 人以内小型团队。授权方式:免费永久使用,无期限、无用户数限制;源码开放可自行二次修改。标配功能:Markdown/富文本/在线表格、基础权限、Web 端、本地文件存储、基础附件管理。功能限制:无全平台客户端(桌面/APP/插件)。无 OSS 云存储支持。无官方技术支持。AI/Dify 集成受限。无企业级单点登录增强功能。无批量用户导入、无高级水印/防爬配置。💳 专业版(商业付费,永久授权)适用对象:中大型企业、全终端使用需求、需要 AI/OSS/企业集成的团队。授权方式:付费买断制,永久使用权,无年费、无用户上限(具体报价咨询客服)。解锁功能:全平台支持(桌面端 +APP+ 浏览器插件+Obsidian 插件)。OSS 对象存储支持。完整 Dify+ 私有 RAG AI 能力。全量第三方认证(钉钉/企微/LDAP/OIDC 全功能)。高级权限、批量用户导入、专属技术售后、版本优先更新。付费代部署服务(适合 0 基础用户,远程协助 Docker/宝塔一键部署)。重要提示:无官方 SaaS 云端版,所有版本必须自行部署在自己服务器/电脑/NAS,官方不提供云端托管服务。五、详细使用教程方式 1:Docker 一键部署(新手首选,推荐)适用环境:Linux/Windows/Docker 环境。安装环境:确保服务器已安装 Docker。拉取镜像:bashdocker pull zmister/mrdoc:latest docker pull zmister/mrdoc:latest 启动容器(映射端口 10086,可自定义):bashdocker run -d --name mrdoc -p 10086:10086 -v /opt/mrdoc-data:/app/MrDoc zmister/mrdoc:latest docker run -d --name mrdoc -p 10086:10086 -v /opt/mrdoc-data:/app/MrDoc zmister/mrdoc:latest 创建管理员账号:bashdocker exec -it mrdoc python manage.py createsuperuser docker exec -it mrdoc python manage.py createsuperuser 访问系统:浏览器输入 http://服务器 IP:10086,使用管理员账号登录。方式 2:源码手动部署(开发者自定义修改)适用对象:有开发基础,需深度定制系统。克隆源码:bashgit clone https://gitee.com/qizhenghai/MrDoc.git git clone https://gitee.com/qizhenghai/MrDoc.git 安装依赖:bashpip install -r requirements.txt pip install -r requirements.txt 初始化数据库:bashpython manage.py makemigrations && python manage.py migrate python manage.py makemigrations && python manage.py migrate 创建管理员:bashpython manage.py createsuperuser python manage.py createsuperuser 启动服务:bashpython manage.py runserver 0.0.0.0:10086 python manage.py runserver 0.0.0.0:10086 基础入门使用步骤后台配置:管理员登录后台→站点设置,配置站点名称、附件大小/格式白名单;设置是否开启注册;用户管理创建成员账号、设置分组权限。创建文集:首页→新建文集(如「产品手册」「技术文档」),设置文集权限(私密/全员可读/指定协作)。新建文档:进入文集→新建文档,选择 Markdown/富文本/表格/Office,插入图表、附件、图片,保存发布。分享文档:文档右上角点击分享,生成链接 + 访问密码,发给外部人员。多端同步:下载官网对应客户端,登录同账号自动同步全部知识库。六、部署&使用避坑清单一、部署避坑端口占用:默认端口 10086 易被占用,启动 Docker 时务必修改映射端口(如 -p 8080:10086)。云服务器安全组需放行对应端口,否则外网无法访问。数据备份:Docker 部署必须挂载数据卷(-v 本地路径:/app/MrDoc),若未挂载,容器删除后数据全丢。需定期备份挂载目录文件与数据库 SQL。数据库选型:小型部署默认 SQLite 够用;超过 20 人团队建议配置 MySQL。开源版可自行修改配置切换,切勿后期临时迁移数据库。NAS 部署:极空间/群晖 NAS 用 Docker 部署时,优先使用官方镜像,避免使用第三方修改镜像导致兼容性 BUG。二、功能使用避坑开源版存储:开源版文件全存服务器本地磁盘,大量附件会占满硬盘。如需使用 OSS 云存储必须升级专业版,不要自行魔改源码对接 OSS(可能违反 GPL 协议)。OnlyOffice 配置:OnlyOffice 需单独部署服务,新手不要自行配置,极易出现跨域、预览失败。建议优先使用专业版官方配置或付费代部署。AI 接入限制:Dify+ 私有 RAG 需要额外部署 Dify 服务,开源版 AI 功能阉割。若需完整私有知识库问答,建议直接升级专业版,避免浪费时间配置无效功能。权限误区:文集权限优先级>单文档权限。若文集设为私密,单文档单独开放分享链接不生效。需先放开文集浏览权限再设置文档分享。浏览器插件:剪藏插件仅支持 Chromium 内核浏览器(Chrome/Edge),Firefox 部分功能缺失。复杂格式剪藏易乱码,建议复制正文到编辑器。版本升级:Docker 容器升级优先拉取新镜像并保留数据卷,不要直接在容器内升级代码,极易环境崩坏;源码部署升级前务必备份数据库。三、合规避坑GPLv3 协议:开源版遵循 GPLv3 协议。若二次修改源码并对外商用分发,必须开源修改后的代码;仅企业内部自用修改源码无需开源。七、官方资源入口官方网站:https://www.mrdoc.pro官方使用手册:https://doc.mrdoc.pro/p/user-guide/部署文档:https://doc.mrdoc.pro/p/deploy/
Answer
Apache Answer 使用指南一、平台介绍Apache Answer 是 Apache 软件基金会顶级开源项目(TLP),由思否(SegmentFault)团队于 2022 年开源并孵化转正。该项目对标 Stack Overflow,是一款轻量化的私有化问答系统。开源协议:采用 Apache 2.0 开源协议,遵循 Apache 2.0 条款。技术架构:Go 后端 + React 前端开发。核心定位:将零散的聊天记录或文档知识沉淀为结构化、可检索的问答系统,有效替代微信群、飞书群等碎片化答疑场景。部署模式:支持全私有化部署,确保数据自主可控。官方站点:官网 answer.apache.org/zh-CN 提供中文文档、演示环境、源码入口及社区反馈渠道。二、主要功能1. 基础问答核心(用户侧)提问与回答:支持 Markdown 实时预览,可编辑富文本(公式/表格/图片)。系统会自动联想历史问题,避免重复提问。邀请作答:支持站内 @用户,并可定向邀请特定领域的专家进行回答。投票机制:提供点赞与踩功能,提问者可将优质答案标记为最佳答案并置顶。标签订阅:用户可关注技术标签(如 go、mysql),新发布的问答会通过消息推送及时通知。高级检索:支持按标签、作者、点赞数、发布时间等维度筛选内容,同时具备全文检索功能。2. 社区与内容管理(管理员侧)多角色权限:提供超级管理员、版主、普通用户三级权限体系,可自定义版块访问及发帖权限,支持批量导入用户。标签分类体系:支持自定义一级或多级标签,帮助实现内容归类,适配技术分区或产品售后分类。内容协作修订:支持全员协同编辑问答,系统全量留存修订历史,管理员可回溯每一次修改记录。内容审核:支持自定义关键词过滤及人工审核机制,拦截垃圾问答。3. 用户激励体系声望与徽章:回答被采纳、获赞或优质投稿可增加声望,解锁发帖、编辑及管理特权。自动徽章:完成指定任务(如首答、标签达人)可自动发放徽章,提升社区活跃度。4. 插件扩展与基础配套插件扩展:提供官方插件市场及自定义插件,支持第三方登录(微信/GitHub/OAuth)、对象存储(阿里云 OSS/S3)、Elasticsearch 全文检索、数据统计看板、暗黑模式等。多语言支持:内置 40+ 语言,原生适配简体中文。通知系统:提供站内信及邮件通知(回答、评论、点赞、关注更新等)。数据库兼容:支持 SQLite(轻量单机)、MySQL、PostgreSQL 三选一部署。移动端适配:页面自动适配移动端访问。三、适用人群与使用场景1. 适用人群与场景互联网/研发团队:构建技术知识库,内部问题答疑(如 Go/Python 开发排坑、运维故障汇总),替代群聊查问题。产品&客服团队:打造产品帮助中心,沉淀用户售后 FAQ,记录用户高频问题。开源/行业社区:作为开发者社区或垂直领域论坛(编程、硬件、设计)。高校/培训机构:搭建课程答疑平台或师生问答知识库。中小企业行政:建立内部制度、人事问题问答库。2. 不适用场景纯闲聊论坛(主打帖子灌水)。超大体量 UGC 综合门户(此类场景建议推荐 Discuz)。四、免费与付费情况✅ 开源版(主流)状态:永久 100% 免费。源码:完全开源(Github:apache/incubator-answer)。功能:无功能阉割,无用户上限,无站点广告。协议:遵循 Apache 2.0 协议,可商用、可二次修改、可私有化部署,数据全归部署方所有。官方说明:官方无任何收费版,不存在官方云托管付费服务。⚠️ 付费场景(非官方)第三方代部署/云托管:部分云服务商或外包公司提供一键托管运维(服务器 + 运维 + 升级),按需求收费。定制开发:如需定制专属插件或功能改造,需找第三方开发人员付费定制。总结:自己部署等于零成本;找人代运维则按需付费。五、详细使用步骤1. 部署方案选择方式 1:Docker 一键部署(新手首选)前提:服务器提前安装 Docker(Windows/Linux/macOS 均可)。步骤:终端执行一键拉取镜像命令:bashdocker run -d -p 9080:80 -v answer-data:/data --name answer apache/answer:latest docker run -d -p 9080:80 -v answer-data:/data --name answer apache/answer:latest 浏览器访问 http://服务器 IP:9080,进入安装向导。安装配置:选择语言:简体中文。选择数据库:小型团队选 SQLite(无需额外安装数据库);中大型团队选 MySQL 或 PostgreSQL。创建超级管理员账号(用于后台登录)。安装完成自动跳转至前台首页。方式 2:Docker Compose 部署(生产环境推荐)优势:生产环境推荐,带独立数据库管理。命令:bashcurl -fsSL https://raw.githubusercontent.com/apache/answer/main/docker-compose.yaml | docker compose -p answer -f - up curl -fsSL https://raw.githubusercontent.com/apache/answer/main/docker-compose.yaml | docker compose -p answer -f - up 访问:安装初始化访问 localhost:9080 完成。方式 3:二进制包部署(无 Docker 环境)步骤:下载官网对应系统(Windows/Linux)的二进制程序。初始化配置:INSTALL_PORT=80 ./answer init -C ./answer-data/,访问 http://IP:80/install 进行配置。启动服务:./answer run -C ./answer-data/。2. 后台初始化配置(管理员)登录后台:访问 http://IP:端口/admin。站点设置:填写网站名称、域名、邮箱 SMTP(用于开启邮件通知)。标签管理:新建业务标签(如 Go 语法、产品使用、运维故障)。用户配置:开启或关闭注册、设置注册白名单(企业内网建议使用白名单或关闭公开注册)。插件中心:按需安装第三方登录、图片存储插件。3. 普通用户使用流程注册:注册账号后浏览标签或搜索问题。提问:点击【提问】按钮,填写标题、正文及关联标签。互动:浏览问题可回答、评论、点赞,关注标签接收动态。六、避坑指南1. 部署相关注意事项端口占用:默认 80/9080 端口若被占用,需在启动命令中修改映射端口(如 -p 8088:80)。容器日志排查:若页面打不开,查看容器日志 docker logs answer 排查报错。数据卷挂载:Docker 部署必须带 -v answer-data:/data 挂载数据卷,否则重启容器后数据会丢失。镜像拉取:国内用户若拉取失败,需替换 Docker 国内镜像源后再次执行。子目录部署:不建议使用 域名/answer 子目录安装,优先使用根域名部署。若必须使用子目录,需配置反向代理。2. 数据库选型建议小型团队:10 人以内优先使用 SQLite,省去数据库运维成本。中大型团队:50 人以上或业务量大时再切换至 MySQL 或 PostgreSQL。迁移风险:切换数据库需全量备份数据再迁移,直接换库大概率会导致报错(50X)。密码规范:数据库密码尽量避免含特殊符号(如 #、&、@),以防连库失败。3. 文件与图片上传File Cannot be empty 报错:检查后台图片文件大小上限配置。检查服务器磁盘是否已满导致无法写入。安装对象存储插件替代本地存储,避免磁盘溢出。图片访问问题:若使用本地存储,反向代理需放行静态资源路径;建议优先安装 OSS 插件。4. 邮件通知配置收不到邮件:确认 SMTP 服务商是否开通第三方客户端权限(如 QQ 邮箱需使用授权码)。确保后台配置的站点域名与实际访问域名一致,否则邮件会被拦截或进入垃圾箱。5. 版本与插件管理版本安全:0.4.x 早期版本存在安全漏洞,务必使用 1.4+ 最新稳定版,并定期升级镜像。插件兼容:插件版本需与 Answer 主版本匹配,从官方插件市场下载对应版本,勿随意安装非标插件。升级备份:版本更新前务必用数据库备份命令导出 SQL,防止升级损坏数据。6. 企业内网使用建议注册安全:企业内部使用务必关闭公开注册,改用管理员批量导入用户或企业 OAuth 登录,防止外网人员乱注册。域名一致性:后台站点域名配置必须与访问域名保持一致,否则会出现登录或跳转异常。七、官方资源入口中文官网:https://answer.apache.org/zh-CNGithub 源码:https://github.com/apache/incubator-answer
Logseq
Logseq 全维度使用指南一、平台介绍Logseq 是一款基于 AGPL3.0 开源协议、强调本地优先、隐私导向的双链大纲型个人知识管理(PKM)软件。官网地址:https://www.logseq.com/1.1 核心定位主打 块(Block)大纲 + 双向链接 + 本地纯文本存储,是 Roam Research 的开源替代品。数据归属:全部笔记以 Markdown/Org-mode 格式保存在本机文件夹,无强制云端,数据 100% 归用户所有。应用场景:搭建个人第二大脑、文献管理、任务系统、读书笔记库。1.2 运行环境全平台覆盖,适配多种操作系统:桌面端:Windows / macOS / Linux移动端:iOS / AndroidMac 芯片适配:区分 Intel 芯片 Mac 与 2020.11 后 Apple M 系列硅芯片 Mac 专属安装包。1.3 底层优势开源透明:代码托管在 GitHub,无暗箱收集用户数据。离线可用:断网状态下可完全正常编辑,不依赖厂商服务器。文件通用:笔记是标准 MD 文档,可用 Typora、Obsidian 等任意编辑器打开,支持随时迁移。二、核心主要功能2.1 基础大纲笔记(软件基石)所有内容以 独立 Block(文本块) 存在。支持无限缩进嵌套、拖拽排序、单块剪切/复制/跨页面引用。适合场景:头脑风暴、论文提纲、课程笔记分层整理。新手建议:优先掌握缩进分级写法。2.2 双向链接与知识图谱(灵魂功能)页面链接:使用 [[页面名称]] 一键创建正向链接,系统自动生成反向引用,右侧面板可查看所有被引用/引用来源。块引用:使用 ((块 ID)) 精准引用单段文字,实现片段级跨笔记关联。图谱视图:可视化所有笔记连接关系,快速发现知识盲区与隐藏关联。2.3 全链路任务管理(GTD 原生支持)任意文本块输入 / 快速添加任务标记,支持:NOW:当日紧急事项、仅在当日日志展示。TODO:待办事项。DOING:进行中事项。LATER:延后事项。高级功能:支持重复任务、截止日期、优先级标注。搭配 Query 查询 自动汇总全库同类任务,自动生成动态任务清单/数据表格。2.4 PDF 批注(学生/科研刚需)内置 PDF 阅读器,支持文献高亮、批注。批注内容一键生成 Logseq 笔记并建立双链关联原文献。实现 文献 - 笔记 - 知识库闭环,无需切换阅读器与笔记软件。2.5 附加实用功能每日自动日志:打开软件默认显示当日日志页,系统自动按日期新建页面,碎片化记录自动沉淀到时间线。闪卡 (Flashcards):选中内容一键生成记忆卡片,支持艾宾浩斯循环复习(背诵考点、专业名词)。白板 Whiteboard (BETA):无限画布,拖拽知识库已有笔记自由排布,适合思维导图或项目梳理。幻灯片:大纲一键转为演示文稿,适合小型汇报快速出稿。插件&自定义:提供 150+ 社区插件、30+ 自定义主题,支持 CSS 修改界面、拓展思维导图/日历/代码高亮等。三、适用人群3.1 学生群体(最适配)对象:本科生、硕博研究生。场景:课程笔记分层整理、论文大纲撰写、外文文献批注、考点闪卡背诵、考前知识点串联。3.2 职场知识工作者对象:产品、运营、研发、咨询人员。场景:会议纪要归档(如案例记录)、项目任务拆解、行业资料知识库、周报素材汇总。3.3 创作者&终身学习者对象:写书/自媒体作者、读书爱好者。场景:书稿大纲、素材收集;搭建个人藏书笔记库,实践卡片盒笔记法(Zettelkasten)。3.4 隐私敏感用户对象:反感云端笔记、担心平台跑路丢失数据、需要本地永久留存资料的用户(如律师、研究员、涉密资料整理)。注意:不适合只需要简单随手记、零学习意愿、追求开箱即用极简记事本的用户(学习曲线中等)。四、免费与付费详情4.1 个人版(核心功能)状态:永久全功能免费。权益:无功能阉割:双链、PDF 批注、闪卡、白板、查询、全部原生功能永久免费。无存储上限:本地文件占硬盘空间,笔记数量无官方限制。开源自用:可自行修改源码、本地部署,个人使用完全免费,无广告、无强制会员弹窗。4.2 付费项目(增值服务)Logseq Sync(Beta 付费同步服务):官方跨设备加密云同步,支持桌面 + 手机多端实时同步 MD 文件,按月/年订阅。评价:非刚需,不想付费可用 OneDrive/百度网盘/WebDAV/Git 自行本地文件夹同步。企业商用授权:团队协作、企业定制部署收费,个人用户完全用不到。总结:99% 个人用户终身零花费即可完整使用全功能,付费仅为懒于手动同步的用户提供云同步便利。五、分步上手使用指南(新手三步法)5.1 第一步:下载安装 + 创建知识库官网下载:访问 https://logseq.com/downloads,根据系统选择对应安装包(Intel/M1 芯片 Mac、Windows、安卓/iOS)。新建知识库:打开软件 → 点击 Add a graph → 在电脑本地新建一个空白文件夹(如 D:\Logseq 知识库)。选中文件夹:选中该文件夹即创建完成,所有笔记均存储在此处。关键提示:一个文件夹 = 一个知识库,可创建多个独立知识库(如将学习库/工作库分开)。5.2 第二步:新手入门三习惯日常碎碎念:打开默认当日日志页,随手记录会议记录(如 Meeting with Jessica)、读书随笔等。结构化笔记:使用 Tab 键缩进拆分大纲,适配论文提纲、读书笔记分层(Beginner 技巧:分段 + 缩进)。知识关联:书名、人名、项目统一用 [[书籍名]],自动建立知识链接。5.3 第三步:进阶快捷键与常用操作全局搜索:Cmd+K (Mac) 或 Ctrl+K (Windows),可搜索页面/块,中级必备。Query 查询:编写 {{query}} 语句,自动生成任务或读书笔记汇总表格。导入 PDF:拖拽 PDF 进页面,直接开启批注。插件安装:进入设置 → Plugins,一键安装社区插件拓展功能。落地示例:会议记录中输入 Met with [[Jessica Albert]],后续在 [[Intertwingled]] 书本页面可自动反向看到这条会议引用,一键跳转关联笔记。六、避坑指南(新手高频踩坑 + 解决方案)6.1 存储结构坑❌ 错误:知识库文件夹放桌面、系统 C 盘、经常移动文件夹。✅ 正确:固定在 D 盘或非系统盘专属目录,不随意剪切文件夹。💡 备份方案:每周复制知识库文件夹到移动硬盘或网盘,MD 文件复制即全量备份。6.2 性能坑❌ 错误:一个知识库塞几万条笔记、大量内嵌高清 PDF。✅ 正确:按用途拆分知识库(如考研库、工作库分开);PDF 原件单独存硬盘,Logseq 仅存批注;单库笔记建议控制在 8000 条以内,优化流畅度。6.3 同步坑❌ 错误:同时在电脑、手机打开同一个知识库文件夹,两端同时编辑。✅ 正确:免费方案:单设备编辑,修改完成后再网盘同步文件夹。付费方案:需要多端同步再开 Logseq Sync,不要混用多种同步工具。6.4 功能坑❌ 错误:刚上手一次性装几十款插件、大量自定义 CSS,导致软件启动崩溃。✅ 正确:新手只装刚需插件(如日历、闪卡),熟悉基础功能后再逐步加装;默认主题先用 1 个月,熟练再换自定义主题。6.5 语法坑❌ 错误:[[名称]] 符号用全角括号、Query 引号写错。✅ 正确:所有链接符号用英文半角符号,复制现成查询模板修改关键词,避免手写语法出错。6.6 迁移坑❌ 错误:换电脑复制 Logseq 安装程序文件夹。✅ 正确:只复制自己创建的知识库文件夹,新电脑重装软件后选中文件夹即可恢复全部笔记(MD 文件独立于软件)。
思源笔记
思源笔记一、平台介绍思源笔记是一款国产开源、本地优先(Local-first)的个人知识管理系统。它主打数据私有化、隐私安全、块式编辑、双链知识库,秉持「无离线不笔记」的理念,由国内 B3log 团队开发,核心代码采用 Apache2.0 协议开源。核心底层逻辑:本地优先数据所有权归用户 笔记默认保存在本地文件夹。即便软件停运或服务商倒闭,本地文件仍可正常打开使用,不会丢失数据。AES-GCM 端到端加密 开启云同步时全程加密,官方与云服务商均无法解密用户明文数据。全平台覆盖 支持 Windows、macOS、Linux、Android、iOS、鸿蒙系统。支持 Docker 私有服务器部署及浏览器网页端打开。二、主要功能明细(一)核心编辑:块式编辑器(软件标志性功能)所有内容(文字、图片、表格、代码、公式)均为独立内容块,像乐高积木一样自由拖拽排版:Markdown 所见即所得 输入#、**加粗**等即时预览富文本,无需切换源码/预览模式;斜杠/唤起快捷菜单,一键插入 20+ 种块(标题、列表、思维导图、流程图等)。丰富内置块 支持公式块(LaTeX)、Mermaid/Graphviz 流程图、PlantUML/UML、五线谱、图表、代码块、多维数据库(对标 Notion Database)、任务清单、引用块、嵌入块。块级双链 使用[[文档名]]快速双向链接与块引用跳转;支持悬浮预览内容;构建网状知识图谱。超大文档优化 采用动态加载技术,百万字单文档编辑流畅,无卡顿。双结构管理 左侧支持文档树(树形文件夹),右侧支持全局关系图(网状知识)。(二)知识管理进阶功能SQL 查询视图 支持用 SQL 语句筛选、汇总知识库内容,自动生成动态汇总页面(如日记汇总、错题本)。闪卡间隔复习 基于 FSRS 算法制作记忆卡片,适用于考研、考证背诵及单词记忆,自动规划复习周期。模板系统 提供周报、日记、读书笔记等模板一键复用;搭配日期变量自动生成当日文档。全量搜索 毫秒级全文检索,支持标签#分类、自定义属性筛选内容。网页剪藏 +PDF 标注双链 浏览器插件一键保存网页;PDF 划线标注自动生成反向链接。AI 辅助写作 内置 AI 调用接口,支持一键扩写、润色、总结笔记内容。(三)个性化与扩展插件&主题集市 提供海量社区插件(番茄钟、目录、文档转思维导图等);支持自定义暗色/亮色主题;支持 CSS/JS 代码片段 DIY 界面样式。多窗口分屏 支持同屏多文档对照编辑,支持悬浮弹窗查阅资料。多格式导出 支持导出 Markdown、PDF、Word、HTML 等;支持批量导出整库 Markdown 以便迁移。(四)同步与备份本地免费离线 断网情况下全功能可用。两种付费同步方案 官方云端同步、S3/WebDAV 第三方对象存储同步。三、适用人群✅ 最适合人群学生党(考研/公考/留学) 利用闪卡背诵、建立错题数据库、整理课程知识库、绘制思维导图整理教材。职场白领 利用周报模板、构建项目知识库、归档会议纪要、整理资料剪藏。创作者/自媒体 长篇书稿写作、素材库管理、公众号文案排版导出。隐私敏感用户 律师、研究员、涉密资料存储者,重视数据不被平台管控。自建 NAS/极客 拥有 Docker 部署能力的用户,可私有化服务,对接 S3 自建网盘全自主管控数据。⚠️ 不太适合人群重度移动端随手速记用户 手机端插件缺失、大块文档加载相对较慢,主力使用体验弱于桌面端。多人实时协作需求团队 主打个人知识库,原生无在线多人协同功能(非实时协作平台)。四、免费与付费价格明细核心原则:所有本地核心功能永久免费(无功能阉割,可商用),包含块编辑、双链、Markdown、SQL、闪卡、插件、全端本地打开、导出。仅云端同步类增值服务收费。1. 永久免费版价格:0 元权益:全本地功能、全插件/主题、离线使用、本地备份。限制:无官方云空间、无官方同步、无收集箱/图床。2. 年度订阅会员价格:148 元/年(学生教育优惠 96 元/年)权益:官方 8GB 云端存储空间 + 全端一键同步。收集箱(微信/网页快捷收集)、官方资源图床、定时微信提醒。自带 S3/WebDAV 同步权限。3. 终身功能包价格:72 元一次性买断权益:永久解锁 S3+WebDAV 第三方同步(支持阿里云 OSS、七牛、R2 等,需用户自行购买云存储)。说明:不含官方 8G 云盘与收集箱。补充说明:订阅或功能包过期后,本地所有笔记永久保留可用,仅云端同步、会员专属功能(如收集箱、云盘)会停用。五、新手分步使用指南步骤 1:下载安装 + 初始化工作空间(重中之重)下载软件 访问官网 https://b3log.org/siyuan/download.html,下载 Windows、macOS、Linux 或手机应用商店对应安装包。新建工作空间 首次打开软件,务必新建工作空间文件夹(即笔记数据存放目录)。✅ 推荐:D 盘或 E 盘新建独立文件夹(如D:\SiYuan 知识库)。❌ 禁止:C 盘系统目录、iCloud/OneDrive/坚果云同步文件夹、软件安装目录(极易导致丢数据)。备份密钥 进入软件后,点击设置→关于→初始化数据仓库密钥,复制密钥并备份。这是同步必备项,丢失密钥无法解密云端数据。步骤 2:基础操作入门新建笔记 左侧「文档树」右键→新建笔记本(分类:考研/工作/随笔);使用Ctrl+N新建文档。快捷编辑 输入/唤起快捷插入菜单,快速插入标题、表格、脑图;使用#标签给文档打标签分类;使用[[文档名]]生成双向链接。使用右侧面板 右侧面板包括大纲(Alt+2 快速调出)、标签、全局图谱、收集箱(会员可用)。日常备份 定期手动复制工作空间/data 文件夹做本地备份(最稳妥)。步骤 3:进阶玩法日记自动化 新建日记模板,搭配日期变量,一键生成每日笔记;用 SQL 汇总当月日记。配置 S3 同步(72 元终身用户) 设置→云端→S3,填入阿里云、七牛等 AccessKey 及存储桶信息,实现全端增量同步。安装浏览器剪藏 安装思源官方浏览器插件,一键收藏网页至知识库。六、全场景避坑指南(高频踩坑汇总)1. 数据存储&同步大坑(最高危)❌ 不要直接同步整个工作空间 严禁使用百度云、坚果云、OneDrive 直接同步整个工作空间文件夹。软件运行时同步会损坏.sy源文件,导致笔记乱码丢失。正确做法:仅可手动单独同步data文件夹,同步前必须关闭思源软件。❌ 密钥管理 密钥丢失=云端数据报废。初始化密钥后务必复制存记事本,多设备同步必须导入同一密钥。密钥遗失只能重置密钥、本地备份恢复,云端加密数据无法找回。❌ 坚果云兼容性 官方明确不兼容坚果云 WebDAV,建议选 InfiniCLOUD、自建 WebDAV 或 S3 对象存储。✅ 免费用户迁移 免费用户多设备迁移:复制完整data文件夹到新设备工作空间即可。2. 文件&编辑坑超大文档优化 单篇文档内容超 10 万字建议拆分,避免移动端加载卡顿;附件图片过多应及时清理无效资源。导入 Markdown 预处理 导入前请清理文档多余空行,思源无批量删空行功能,导入后无法一键清理。示例文档 不要在默认「用户指南」笔记本写内容,官方示例文档重启会自动重置清空。3. 移动端&插件坑手机端插件限制 iOS/Android 阉割了插件系统,复杂知识库优先桌面端编辑,手机仅做查阅、简短记录。插件兼容性 更换软件版本后少数老旧插件可能失效,更换主题时优先下载官方集市高评分插件。4. 付费避坑按需购买 只需要自建云同步→买72 元终身 S3 包;需要官方一键云同步 + 收集箱→开 148 元年会员,无需重复购买。续费焦虑 会员到期本地数据完全保留,不用担心笔记锁定或强制续费。5. 系统设置坑时间同步 多设备同步时务必统一系统时间(误差<1 分钟),时间不一致会导致同步失败或数据错乱。S3 设置 S3 同步建议关闭 CDN 加速以避免连接异常。七、补充优势兜底即便官方停止运营:本地笔记照常打开:本地文件无需任何额外软件即可读取。数据完全迁移:全量导出标准 Markdown 即可迁移至任意笔记软件。底层可解析:底层解析代码全开源,可自行开发工具解析数据,确保数据永久可控。
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 前端生态丰富、插件更多。