Stuga

Stuga

你的 AI 撰写团队维基，同事负责审批。

一套由你在 Mac 或服务器上运行的团队维基，包含页面和表格。对 Claude、Codex 或任何 MCP 客户端说 保存到 Stuga，它就会把每条信息归档到正确的页面或表格行。默认情况下， 维基的更改会等待提出请求的人审批；将文件夹设为 由同事审核，就会由其他人审批。询问 Stuga 会根据已审批的内容作答，并说明哪些内容仍在等待审批。

下载 Mac 版（Apple silicon，macOS 15+）· 使用 Docker 安装

安装后，创建你的账户和工作区 并连接你的 AI。Stuga 用户帮助：stuga.dev/docs。

维基如何保持准确

• 保存到 Stuga。 你的 AI 会找到一条信息所属的页面和章节，或事实对应的表格行， 并修正它所更改的句子，而不是另添一条。它会注明信息来自哪场会议或哪封电子邮件， 并告诉你保存了什么、保存到哪里，以及哪些内容仍在等待审批。没有页面涵盖的信息会在所属文件夹中 新建页面，或保存到你自己的 我的笔记。
• 三级审核。 在 谁审核 AI 的编辑… 中，文件夹、页面或数据库可以设为 由提出请求的人审核 （默认设置）、由同事审核（由其他有权编辑的人审核；如果文件夹指定了审批组，则由组内成员审核， 但绝不会由提出请求的人审核），或 AI 编辑直接生效（会记录、标明作者且可撤销）。 人员自己的编辑会直接生效。
• 每项更改一张卡片。 将一场会议的内容归档到多个页面时，会作为一项更改提交，并在一张适合手机查看的卡片上审核： 每项编辑都显示在其所在段落中，并附上引用来源。你可以选择 全部批准、 要求修改… 或 拒绝…，并附上 AI 会读取的备注。文件夹可以将每项等待同事审核的更改 发布到 Slack 频道。
• 询问 Stuga。 你的 AI 会根据页面和表格作答，并说明每项内容最后由谁在何时更改，以及哪些内容仍在等待审批： “页面上写的是 14 天；一项改为 30 天的更改正在等待同事审核”。
• 检查 Stuga。 每个页面下方的 链接自、引用页面发生更改时显示的 需要检查，以及 维基 → 索引 和 维基 → 日志。说 检查 Stuga，你的 AI 就会找出过时页面、孤立页面和失效链接， 并将修复方案作为一项更改提交。
• 层层叠加的指令。 工作区、文件夹、页面和数据库都可以分别告诉 Agent 内容应放在哪里。这些指令会为模型提供指导；写入操作的效果由权限和审核决定。

包含的内容

• 共同编写页面。 实时编辑（基于 Yjs CRDT 的 Tiptap），支持在线状态、评论、@提及和版本历史。
• 页面旁的表格。 带类型的表格，每个数据库各自使用一个 SQLite 文件，并支持已保存的视图、行页面和 CSV 导入。Agent、Ask 和 REST API 可对其运行只读 SQL。
• 遵循权限的搜索。 通过一条 SQL 语句执行关键词搜索（基于 Postgres 全文搜索的 BM25）和语义搜索（pgvector），并在语句中检查访问权限。中文、日文、韩文和泰文无需配置即可使用。
• 内置 AI，配置前默认关闭。 一位共同作者和一位表格助手，其修改会像 Agent 的修改一样供审核；还有可引用来源的 Ask。支持 OpenAI、Anthropic、Gemini、DeepSeek 等，或 Ollama。
• 共享与登录。 工作区、文件夹、单页共享、群组和访客。用户通过邀请链接加入，并使用密码或你的 OpenID Connect 提供方登录。
• 导入与导出。 Notion 导出文件，或压缩的 Obsidian 库或 Markdown 文件夹，都可以转换为工作区；工作区可导出为一个 .stuga.zip，其中包含 Markdown、JSON Lines 和文件。

连接你的 AI

Agent 通过 MCP 连接。Settings → Your AI agents 会提供 Claude Code、 Claude Desktop、Codex、Antigravity、Cursor、VS Code、Kiro、Goose、LM Studio、DeepSeek Harness 和 Pi 的配置方法，其中会填入你的节点地址，以及其他 MCP 客户端所需的 URL （docs/agents.md）。每个 Agent 都使用自己的模型，因此节点无需 AI 密钥。

• 限定范围的登录。 大多数客户端通过浏览器登录，你可以在其中勾选应用可使用的工作区，并选择 Read only 或 Read and suggest changes。Revoke 可终止其访问权限。
• 受限密钥。 未登录的客户端使用 API 密钥，该密钥可限定到特定文件夹、设为只读或设置过期时间。
• 仅限内容操作。 Agent 可以修改文档和数据库。重命名、移动、删除、共享和审核设置仍由用户管理。
• 完整审计。 每次 MCP 调用（包括读取）都会记录在工作区的审计日志中。事件流和签名 Webhook 会报告发生的更改。

你的数据

Stuga 不会发送遥测数据，除非节点管理员启用远程访问，否则任何信息都不会传到我们这里。节点只会为正在使用的功能发送出站请求，例如请求 AI 提供方；此外，除非节点管理员关闭此功能，否则节点每天会向 GitHub 查询一次发布版本列表。docs/privacy.md 列出了节点发送和存储的内容。

安装

• 搭载 Apple 芯片的 Mac，运行 macOS 15 或更高版本：打开 安装包，或从最新发布版本下载 Stuga-<version>.pkg。安装包自带 Postgres 和 Node.js（docs/install/macos.md）。

• Docker，适用于 x86-64 或 arm64，例如 Linux 服务器或 NAS：install.sh 会通过 Compose 启动 Postgres 和节点（docs/install/docker.md）：

  curl -fsSL https://github.com/stuga-dev/stuga/releases/latest/download/install.sh | bash
  

一个节点由一个 Node.js 进程和启用了 pgvector 的 Postgres 组成；用户通过浏览器访问。默认情况下，节点每天自动备份一次，并在每次升级前备份 （docs/operations.md）。docs/getting-started.md 介绍了使用的第一个小时内需要了解的内容。

问题与反馈

请在 Discussions 中提问或分享想法； 请通过 issue 报告 Bug。

贡献

欢迎提交问题和拉取请求。CONTRIBUTING.md 介绍了如何从源代码运行 Stuga、测试和相关约定；RELEASING.md 介绍了如何发布版本。 贡献须遵守贡献者许可协议（CLA.md）；机器人会在你首次提交拉取请求时询问。请按照 SECURITY.md 中的说明私下报告漏洞。

许可证

AGPL-3.0-only，但 integrations/ 除外，该目录使用 MIT；版权声明见 NOTICE。如果你修改 Stuga 并通过网络向他人提供，则须按相同条款分享你的修改。名称和徽标不受许可证约束： TRADEMARKS.md 说明了你可以如何使用它们。