Pinvou Agent 共享知识库部署指南在 Linux 单台机器上自建团队知识托管服务【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agentPinvou Agent 是一款开源的桌面 AI 智能体应用内置共享知识库能力在任意一台 Linux 机器上点几下就能为团队自建一套持续运行的知识托管服务支持全文 语义混合检索、多知识集管理、成员权限审批和 30 天回收站——全程不需要终端、SSH、浏览器后台或初始化密钥。为什么需要自建共享知识库团队里散落在个人电脑上的产品文档、会议纪要、SOP 手册往往成了只有一两个人看得到的孤岛。Pinvou Agent 的共享知识库把这件事变简单了一台 Linux 机器就是全部服务采用单机自包含架构一个服务程序内置 API、元数据、全文/向量检索和源文档托管持久状态集中在一个数据目录里零外部依赖底层是 SQLite FTS5 BGE-M3 模型无需另行部署 PostgreSQL、Qdrant、Redis原生界面管理一切创建、成员、分享、模型、备份、升级全部在 Pinvou 界面内完成浏览器管理页和密码登录已退出产品容量面向个人与小团队工程目标约 20 台授权设备、1 万份源文档、100 万个文档分段详见 docs/adr/0018-首期容量面向个人与小团队单服务器.md部署前准备系统与硬件要求项目要求操作系统能运行 Pinvou 图形界面的 Linux 桌面systemd 系统外部依赖无数据库、检索、模型全部内置可选解析器pdftotextPDF、pandoc/ LibreOfficeOffice、tesseract图片 OCR网络局域网或 Tailscale 私有网首期不支持公网直接暴露 解析器按需调用缺少某个命令时对应文档会显示明确的解析失败原因不影响其他文档入库。纯文本、代码和电子表格由进程内解析支持 UTF-8 / UTF-16 / GB18030。BGE-M3 模型由服务首次启动时按需下载走固定 revision 逐文件 SHA-256 校验面向中国大陆网络时默认先尝试国内镜像、失败自动回退官方源详见 docs/knowledge-model.md。一键创建共享知识库最快部署方法普通用户的主流程只需三步全程在 Pinvou 内完成打开共享知识库页面未创建时页面只显示创建共享知识库和加入共享知识库两个入口选择在本机创建确认一次系统管理员授权后Pinvou 会安装与当前客户端匹配版本的持久 systemd 服务、创建受保护的数据目录权限0700并自动把你登记为所有者自动连接此设备共享创建完成后无需任何配置本机直接可用服务默认监听0.0.0.0:3210开机自启、崩溃自动重启。整个流程的设计目标也是发布门禁从全新 Linux 安装到团队成员读取知识不需要终端、浏览器后台、IP、端口或初始化密码。完整实现拆解见 docs/shared-knowledge-host-implementation.md产品行为说明见 docs/remote-knowledge.md。服务程序本身由 Rust 编写源码位于 pinvou-knowledge/src/服务模板见 pinvou-knowledge/deploy/pinvou-knowledge.service——其中启用了NoNewPrivileges、ProtectSystemstrict等 systemd 安全加固。贡献者手动部署独立安装 systemd 服务如果你是开发者或高级运维想跳过桌面应用单独部署服务端仓库保留了独立安装脚本需要 Rust 1.89 工具链bash pinvou-knowledge/deploy/install.shinstall.sh 会自动完成编译 release 二进制 → 创建专用系统用户pinvou-knowledge→ 安装到/usr/local/bin→ 写入数据目录/var/lib/pinvou-knowledge0700→ 注册并启用 systemd 服务 → 执行https://127.0.0.1:3210健康检查。服务状态可随时用systemctl status pinvou-knowledge查看日志用journalctl -u pinvou-knowledge排查。生产环境可通过 systemd override 修改监听地址或模型来源环境变量PINVOU_KNOWLEDGE_HF_BASE_URL。邀请团队成员加入分享、审批与权限服务建好后团队怎么连进来Pinvou 提供两种安全入口分享连接推荐所有者在分享抽屉生成默认 24 小时有效、可多人申请、可直接携带服务器身份与 CA 的连接可复制、可查剩余时间、可随时停止附近发现 / 手动地址打开加入弹窗时自动发现局域网内的共享主机也接受手动输入IP:端口、Tailnet100.64.0.0/10地址或.ts.net名称。但这类入口只产生待核对的候选——客户端会先在不携带任何凭据的前提下探测服务显示由稳定 CA 派生的身份码你与宿主界面核对一致后才固定身份并提交申请。审批与权限模型很清晰角色能力只读成员检索、查看来源、下载文档内容管理员上述能力 创建知识集、上传文件/文件夹、更新、移入回收站所有者设备上述能力 管理分享、申请与成员仅本机控制面可提升/取消每台获批设备拥有独立凭据分享链接泄露不会直接获得知识访问权停止分享只影响新申请不影响已批准成员。发布本地知识到共享知识库创建主机不会自动公开任何本地知识——这是刻意的设计。你需要显式操作发布到共享知识库选择本地知识集和原始文件确认后生成一份独立共享副本之后两份内容互不同步。几个值得了解的内容管理细节自动去重同一知识集内再次添加内容完全相同的文档时复用已有记录不重复存储和索引30 天回收站删除的内容先进入回收站集中展示、支持恢复或在二次确认后永久删除同时清理数据库记录、索引和托管源文件安全拒导私钥等敏感密钥材料会被拒绝导入。发布后可在会话中把共享知识集挂载给 AI实现基于团队文档的检索问答检索采用全文 语义混合超长文本分块优先在句号、问号等句子边界切断。备份、升级与日常运维这三件事都在 Pinvou 所有者控制台完成无需接触命令行备份由 Pinvou 请求服务创建一致性快照输出带版本、清单和摘要的加密备份包含数据库与源文档不含可重新下载的模型。同机恢复读取系统凭据库中的本地密钥保留服务身份与成员跨主机恢复需要单独保存的恢复码只迁移知识内容并生成新身份升级客户端升级不会静默替换正在运行的共享服务。主机用户在 Pinvou 中明确触发服务升级升级前自动形成恢复点健康检查失败自动回滚上一版二进制卸载保护关闭或卸载 Pinvou 默认保留服务和数据移除共享知识库是独立的高风险操作需分别二次确认保留数据或永久删除。常见问题QWindows / macOS 可以当主机吗首期不可以。创建共享知识库仅面向能运行 Pinvou 图形界面的 Linux 主机Windows 与 macOS 可以加入已有主机。Q必须挂到公网吗不需要也不支持。首期只面向局域网和 Tailnet 私网所有访问走由稳定服务身份保护的 HTTPS。Q一台机器能跑多个共享知识库服务吗首期不支持一台主机只持有一个共享知识库服务服务内可建多个知识集。Q文档支持哪些格式纯文本 / 代码 / 电子表格内置解析PDF 用pdftotextOffice 优先pandoc并回退 LibreOffice演示文稿先转 PDF 再提取图片可用tesseractOCR。写在最后从一台闲置的 Linux 机器到团队共享的知识托管服务Pinvou Agent 把部署路径压缩到了几次点击一键创建主机、分享邀请成员、显式发布知识、自动加密备份。相关设计决策可在 docs/adr/ 中按编号查阅如 ADR-0022服务端完整文档见 pinvou-knowledge/README.md。【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Pinvou Agent 共享知识库部署指南：在 Linux 单台机器上自建团队知识托管服务
Pinvou Agent 共享知识库部署指南在 Linux 单台机器上自建团队知识托管服务【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agentPinvou Agent 是一款开源的桌面 AI 智能体应用内置共享知识库能力在任意一台 Linux 机器上点几下就能为团队自建一套持续运行的知识托管服务支持全文 语义混合检索、多知识集管理、成员权限审批和 30 天回收站——全程不需要终端、SSH、浏览器后台或初始化密钥。为什么需要自建共享知识库团队里散落在个人电脑上的产品文档、会议纪要、SOP 手册往往成了只有一两个人看得到的孤岛。Pinvou Agent 的共享知识库把这件事变简单了一台 Linux 机器就是全部服务采用单机自包含架构一个服务程序内置 API、元数据、全文/向量检索和源文档托管持久状态集中在一个数据目录里零外部依赖底层是 SQLite FTS5 BGE-M3 模型无需另行部署 PostgreSQL、Qdrant、Redis原生界面管理一切创建、成员、分享、模型、备份、升级全部在 Pinvou 界面内完成浏览器管理页和密码登录已退出产品容量面向个人与小团队工程目标约 20 台授权设备、1 万份源文档、100 万个文档分段详见 docs/adr/0018-首期容量面向个人与小团队单服务器.md部署前准备系统与硬件要求项目要求操作系统能运行 Pinvou 图形界面的 Linux 桌面systemd 系统外部依赖无数据库、检索、模型全部内置可选解析器pdftotextPDF、pandoc/ LibreOfficeOffice、tesseract图片 OCR网络局域网或 Tailscale 私有网首期不支持公网直接暴露 解析器按需调用缺少某个命令时对应文档会显示明确的解析失败原因不影响其他文档入库。纯文本、代码和电子表格由进程内解析支持 UTF-8 / UTF-16 / GB18030。BGE-M3 模型由服务首次启动时按需下载走固定 revision 逐文件 SHA-256 校验面向中国大陆网络时默认先尝试国内镜像、失败自动回退官方源详见 docs/knowledge-model.md。一键创建共享知识库最快部署方法普通用户的主流程只需三步全程在 Pinvou 内完成打开共享知识库页面未创建时页面只显示创建共享知识库和加入共享知识库两个入口选择在本机创建确认一次系统管理员授权后Pinvou 会安装与当前客户端匹配版本的持久 systemd 服务、创建受保护的数据目录权限0700并自动把你登记为所有者自动连接此设备共享创建完成后无需任何配置本机直接可用服务默认监听0.0.0.0:3210开机自启、崩溃自动重启。整个流程的设计目标也是发布门禁从全新 Linux 安装到团队成员读取知识不需要终端、浏览器后台、IP、端口或初始化密码。完整实现拆解见 docs/shared-knowledge-host-implementation.md产品行为说明见 docs/remote-knowledge.md。服务程序本身由 Rust 编写源码位于 pinvou-knowledge/src/服务模板见 pinvou-knowledge/deploy/pinvou-knowledge.service——其中启用了NoNewPrivileges、ProtectSystemstrict等 systemd 安全加固。贡献者手动部署独立安装 systemd 服务如果你是开发者或高级运维想跳过桌面应用单独部署服务端仓库保留了独立安装脚本需要 Rust 1.89 工具链bash pinvou-knowledge/deploy/install.shinstall.sh 会自动完成编译 release 二进制 → 创建专用系统用户pinvou-knowledge→ 安装到/usr/local/bin→ 写入数据目录/var/lib/pinvou-knowledge0700→ 注册并启用 systemd 服务 → 执行https://127.0.0.1:3210健康检查。服务状态可随时用systemctl status pinvou-knowledge查看日志用journalctl -u pinvou-knowledge排查。生产环境可通过 systemd override 修改监听地址或模型来源环境变量PINVOU_KNOWLEDGE_HF_BASE_URL。邀请团队成员加入分享、审批与权限服务建好后团队怎么连进来Pinvou 提供两种安全入口分享连接推荐所有者在分享抽屉生成默认 24 小时有效、可多人申请、可直接携带服务器身份与 CA 的连接可复制、可查剩余时间、可随时停止附近发现 / 手动地址打开加入弹窗时自动发现局域网内的共享主机也接受手动输入IP:端口、Tailnet100.64.0.0/10地址或.ts.net名称。但这类入口只产生待核对的候选——客户端会先在不携带任何凭据的前提下探测服务显示由稳定 CA 派生的身份码你与宿主界面核对一致后才固定身份并提交申请。审批与权限模型很清晰角色能力只读成员检索、查看来源、下载文档内容管理员上述能力 创建知识集、上传文件/文件夹、更新、移入回收站所有者设备上述能力 管理分享、申请与成员仅本机控制面可提升/取消每台获批设备拥有独立凭据分享链接泄露不会直接获得知识访问权停止分享只影响新申请不影响已批准成员。发布本地知识到共享知识库创建主机不会自动公开任何本地知识——这是刻意的设计。你需要显式操作发布到共享知识库选择本地知识集和原始文件确认后生成一份独立共享副本之后两份内容互不同步。几个值得了解的内容管理细节自动去重同一知识集内再次添加内容完全相同的文档时复用已有记录不重复存储和索引30 天回收站删除的内容先进入回收站集中展示、支持恢复或在二次确认后永久删除同时清理数据库记录、索引和托管源文件安全拒导私钥等敏感密钥材料会被拒绝导入。发布后可在会话中把共享知识集挂载给 AI实现基于团队文档的检索问答检索采用全文 语义混合超长文本分块优先在句号、问号等句子边界切断。备份、升级与日常运维这三件事都在 Pinvou 所有者控制台完成无需接触命令行备份由 Pinvou 请求服务创建一致性快照输出带版本、清单和摘要的加密备份包含数据库与源文档不含可重新下载的模型。同机恢复读取系统凭据库中的本地密钥保留服务身份与成员跨主机恢复需要单独保存的恢复码只迁移知识内容并生成新身份升级客户端升级不会静默替换正在运行的共享服务。主机用户在 Pinvou 中明确触发服务升级升级前自动形成恢复点健康检查失败自动回滚上一版二进制卸载保护关闭或卸载 Pinvou 默认保留服务和数据移除共享知识库是独立的高风险操作需分别二次确认保留数据或永久删除。常见问题QWindows / macOS 可以当主机吗首期不可以。创建共享知识库仅面向能运行 Pinvou 图形界面的 Linux 主机Windows 与 macOS 可以加入已有主机。Q必须挂到公网吗不需要也不支持。首期只面向局域网和 Tailnet 私网所有访问走由稳定服务身份保护的 HTTPS。Q一台机器能跑多个共享知识库服务吗首期不支持一台主机只持有一个共享知识库服务服务内可建多个知识集。Q文档支持哪些格式纯文本 / 代码 / 电子表格内置解析PDF 用pdftotextOffice 优先pandoc并回退 LibreOffice演示文稿先转 PDF 再提取图片可用tesseractOCR。写在最后从一台闲置的 Linux 机器到团队共享的知识托管服务Pinvou Agent 把部署路径压缩到了几次点击一键创建主机、分享邀请成员、显式发布知识、自动加密备份。相关设计决策可在 docs/adr/ 中按编号查阅如 ADR-0022服务端完整文档见 pinvou-knowledge/README.md。【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考