Stuga：自托管文档数据库与知识库，AI Agent 的修改以修订建议形式等待人工审核

核心能力与快速开始

★ 4 · TypeScript

能做什么

文档协作（基于 Tiptap 与 Yjs CRDT 的实时编辑、presence、评论、@提及、版本历史）；数据库（每个数据库独立 SQLite 文件、类型化表格、保存视图、行页面、CSV 导入，Agent/Ask/REST API 对其执行只读 SQL）；检索（关键词 BM25 与 pgvector 语义搜索在同一条 SQL 语句中完成并在语句内校验权限，中英文分词）；Agent 接入（通过 MCP 连接 Claude Code、Claude Desktop、Codex、Cursor、VS Code、Goose、LM Studio 等，支持浏览器作用域登录或受限 API key，Agent 只能改内容，重命名/移动/删除/共享/审核设置保留给人）；Agent 编辑审核（默认等待人工接受或拒绝，可配置为直接应用并记录归属与可回滚，按会话记录 run 及 agent、操作人、客户端与模型，可查询哪些段落由 Agent 撰写及是否被接受）；指令叠加（工作区、文件夹、文档、数据库可各自携带给 Agent 的指令）；内置 AI（协作者与表格助手，编辑同样需审核；Ask 会引用来源，支持 OpenAI、Anthropic、Gemini、DeepSeek、Ollama 等）；共享与登录（工作区、文件夹、按文档共享、群组与访客，邀请链接，密码或 OpenID Connect 登录）；导入导出（导入 Notion 导出、Obsidian vault 或 Markdown 文件夹，导出为 .stuga.zip）；审计（所有 MCP 调用含读取记入审计日志，事件流与签名 webhook）；数据自主（无遥测，除非管理员开启远程访问否则数据不外发，每日默认自动备份并在升级前备份）。

适用场景

团队或组织自建文档与知识库并希望 AI/Agent 参与写作但保留人工审批；让 Claude Code、Codex 等编程助手通过 MCP 读写内部文档与结构化数据；在需要权限隔离的知识库上做关键词与语义混合检索；导入既有 Notion 或 Obsidian 内容作为工作区；为 Agent 写入建立可追溯、可回滚的审计记录。

项目形态

可直接使用的工具

部署方式

自托管。两种官方方式：Apple silicon Mac（macOS 15+）安装 Stuga.pkg，自带 Postgres 与 Node.js；或在 x86-64 / arm64 机器（如 Linux 服务器、NAS）上用 Docker Compose 运行 install.sh，启动 Postgres 与单个 Node.js 进程节点，用户通过浏览器访问。默认每日备份并在升级前备份。

主要依赖

节点为一个 Node.js 进程加带 pgvector 与 pg_search 的 Postgres；Docker 方式需 x86-64 或 arm64 环境；Mac 包需 Apple silicon 与 macOS 15 及以上。各 Agent 自带模型，节点本身无需 AI key。具体 CPU、内存、磁盘等硬件规格未说明。

使用限制

引入 Agent 前需先完成账号与工作区创建并连接 Agent；Agent 仅能修改文档与数据库内容，重命名、移动、删除、共享与审核设置仍由人操作。许可为 AGPL-3.0-only（integrations/ 目录为 MIT），通过网络向他人提供修改版需以相同条款共享改动，名称与标识的使用受商标条款约束。AI 功能默认关闭，需配置。云端托管、SaaS 版本及 API 成本未说明。

许可证

AGPL-3.0

最近推送

2026-10-10 00:03

资料检查：2026-10-10 07:00 · 卡片整理：2026-10-10 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容