atlas-mind

Atlas Mind

这是你的思维，而不是别人的。

Notion 以及所有托管式笔记应用，都要求你把思考倾注到它们的结构里、存放在它们的服务器上，并使用它们的格式。你租用空间，而它们掌握密钥。Atlas Mind 则反其道而行：你的知识是存放在你自己的 git 仓库中的纯文件，由一个你可以逐行阅读、即使丢弃也不会丢失任何笔记的引擎提供服务。你的 AI 通过开放协议访问你的知识库；它绝不会把你的大脑拉进自己的系统。

掌控数据。掌控引擎。掌控思维。

🔗 试用在线演示 →（离线构建版，缺少部分功能） · 什么是 Atlas Mind？

Atlas Mind 是一款可自托管的 wiki／知识库引擎，也是一个与你的 AI 共享的外部大脑。它从文档文件夹（一个思维库）提供单页查看器，并将引擎（代码）与你的内容（存放在独立 git 仓库中的笔记）清晰分离。它基于三个理念构建：

• 支持多种格式，不只有 Markdown。 Markdown 是一等格式（可渲染、链接和搜索）。独立的 HTML 演示文稿和仪表板、PDF、Word .docx、图像和 JSON 文件都可以在浏览器中内嵌预览，无需上传到任何地方。
• 原生支持 AI。 它提供一个 MCP 端点（包含三十种用于阅读、写入、分流、映射、回溯和审计思维库的工具），并且 atlas init 会创建约定目录和文件（AGENTS.md、agents/、ai-sessions/），让助手了解如何使用你的思维库。
• 轻量且自包含。 基于标准库的单个 Python HTTP 服务：无数据库，账户和共享链接以纯 JSON 文件的形式保存在磁盘上，前端库和字体均随包提供。运行中的实例绝不会将你的内容发送到任何地方：你的思维库不会离开磁盘，你写下的任何内容也不会用于训练任何人的模型。默认情况下，它唯一的出站请求是在通过 OAuth 连接 MCP 客户端时读取该客户端公开的元数据（可以关闭）。

它不是多租户 SaaS、实时协作编辑器或插件市场。每个实例专注于一个思维库，完全归你所有。

安装

安装后，PATH 中会提供一个自包含的 atlas 命令（查看器资源已包含在软件包中，无需单独下载）。

# Easy way: uv or pipx (isolated env, no virtualenv to manage)
uv tool install atlas-mind        # or: pipx install atlas-mind
atlas serve ~/my-mind

# Run once without installing, straight from PyPI
uvx atlas-mind serve ~/my-mind    # or: pipx run atlas-mind serve ~/my-mind

# With pip (a virtualenv is recommended)
pip install atlas-mind

需要 Python >= 3.11，并且内容必须位于 git 仓库中。

快速开始

atlas init ~/my-mind     # scaffold a mind: atlas.toml, example docs, AGENTS.md, git init
atlas serve ~/my-mind    # build once if needed, then serve on http://127.0.0.1:8765

init 绝不会执行破坏性操作（如果目录非空且未指定 --force，它会拒绝运行，并保留所有已存在的文件）。serve 默认在 127.0.0.1:8765 上监听，且不启用身份验证。要生成静态查看器而不启动服务：atlas build ~/my-mind [--offline]。

查看 atlas --help 了解所有命令（user、token、share、deploy）。

与你的 AI（MCP）配合使用

Atlas Mind 是专为你的助手设计的外部记忆，助手可以读取和写入其中的内容。在已部署的实例上，将助手指向 https://<your-atlas>/mcp，它就会通过 OAuth 连接：登录 Atlas（包括 2FA），查看助手请求的权限（读取、收件箱、写入——取消勾选不想授予的权限），然后授权即可。连接会显示在 设置 → 令牌 中，你可以在那里撤销连接；令牌会在后台自动续期，只有在闲置 30 天后才会再次要求授权。

客户端要么自行注册（动态客户端注册），要么通过公共元数据文档的 URL 标识自己；连接时，Atlas 会获取该文档。在 atlas.toml 中设置 [oauth] client_metadata_fetch = false 可以关闭此获取行为。

你也可以在网页界面中自行创建令牌——进入 设置 → 令牌，令牌将绑定到你的账户，并显示一个包含令牌的 URL。在本地（或通过脚本操作）时，CLI 也能完成相同的操作：

atlas token create ~/my-mind --label claude
# → prints the MCP URL: https://<your-atlas>/mcp/<token>

MCP 端点提供 三十个工具，分为六组：

• 读取：brief（关于某个主题的上下文包：在令牌预算内挑选最佳章节）、search_docs（按排名列出结果，每条结果都包含所属章节，以及可信度信息：最后编辑者、AI 或人工、是否过时、是否存在争议）、grep_docs（精确匹配行）、read_doc（读取整篇文档、指定行范围或单个章节）、list_tree、recent_docs、changes_since（查看自 Agent 保存的游标以来发生的更改）、resume_session（继续已保存的工作会话：包括恢复命令、未解决事项及各事项已持续多久、期间发生的更改）
• 写入：create_doc、edit_doc（返回差异；支持 dry_run，并提供 base_version 保护，避免覆盖并发更改）、move_doc（修复指向它的 [[反向链接]]）、delete_doc（软删除到 .trash/）
• 图谱：get_links、get_backlinks、list_by_tag、get_mind_topology
• 时间回溯（你的思维空间是一个 git 仓库）：doc_history、doc_at、doc_diff、search_history、changelog、doc_blame、doc_revert
• 活动（归属信息层的读取侧）：activity（查看谁更改了什么，并检测 AI 作者）、agent_runs + undo_run（Agent 的工作会话，可作为一次提交整体撤销）、stale（数月未触碰的文档：用于检查是否过时）、contradictions（待审核的同主题文档对）、judge_contradiction（记录对一组文档的判定）
• 收件箱：create_inbox_item（Agent 在你的收件箱中暂存已整理好的条目，供你分拣）

它还提供可按名称启动的 提示词（Claude Code 中的 / 命令）：内置提示词会实时生成，包括 weekly-review（有哪些变动、哪些内容即将过时、需要解决哪些矛盾）、triage-contradictions、new-doc（根据你的某个模板创建）、resume（从中断处继续已保存的工作会话）。你也可以创建自己的提示词：每个提示词对应 content/agents/prompts/ 下的一个 Markdown 文件，可在查看器中编辑，并支持 {{arguments}} 和 {{include path/doc.md}}。此外，每篇文档都是一个资源，地址为 doc://<path>，你可以将其附加到对话中（在 Claude Code 中使用 @atlas:doc://notes/x.md）；搜索结果也会链接到相应资源。

在支持渲染 MCP Apps 的宿主中（Claude 网页版和桌面版、ChatGPT、搭载 Copilot 的 VS Code……），resume_session 还会在对话中以交互视图呈现：显示会话中待勾选的未解决事项、发生变更的文档及其差异、同一工作的其他保存记录、可复制的恢复命令，以及一个按钮，可根据你保留的事项恢复会话。不支持应用的宿主（包括 Claude Code）会收到相同内容的文本版。

在 Claude Code 中

只需添加一次 Atlas，即可用于每个项目，并为其指定一个简短名称：该名称会成为其提示词和资源的前缀。

claude mcp add --transport http --scope user atlas https://<your-atlas>/mcp

然后在 Claude Code 中运行 /mcp，选择 atlas 并完成身份验证：OAuth 登录页面会在浏览器中打开。此后，提示词会显示为 /atlas:weekly-review、/atlas:new-doc decision "Pricing"、/atlas:resume auth，文档则会以 @atlas:doc://notes/x.md 的形式附加。

如果你也在 claude.ai 上连接了 Atlas，Claude Code 也会拾取该连接器，并使用其长名称：在 /mcp 中关闭那个连接器，以免工具列表重复。

atlas init 会搭建 AGENTS.md + content/agents/ + content/ai-sessions/，端点会将你的 AGENTS.md 作为服务器指令发送给每个客户端，因此任何助手连接后都会立即遵循你的约定。工具带有只读 / 破坏性操作提示（客户端可以在不询问的情况下执行读取操作）；令牌可限制为 read、inbox 和／或 write（接收不可信邮件的 Agent 永远不需要编辑权限）；在知识库之外写入的文本（远程镜像、收件箱投递内容）会被标记为不可信数据，供 Agent 使用；端点同时支持无状态 MCP 2026-07-28 修订版和更早的、基于 initialize 的版本。此外还提供 REST API v1（Bearer 令牌，仅允许创建写入）以及已发布的 OpenAPI 3.1 规范。

功能

• 阅读：支持 GitHub 风格的 Markdown（目录、语法高亮、阅读时长、标签栏）、独立 HTML 幻灯片／仪表板的内嵌预览、PDF、.docx（在浏览器中转换，只读）、图像（适配窗格显示，点击可查看完整尺寸）和 .json（美化排版并高亮）。可将任意文件下载为原始文件。
• 导航：可折叠树形结构、全文搜索（在线时由服务器端处理，离线时使用模糊搜索 MiniSearch）、[[wikilinks]] + 反向链接 +“相同主题”、文件夹／frontmatter 标签、整个知识库的任务汇总、命令面板（Ctrl-K）、固定和最近查看的文档。
• 思维空间：一个力导向的思维宫殿，每篇文档和每个标签都是可导航节点，按文件夹分组着色，最近访问的节点发光，孤立节点变暗。
• 编辑：可从查看器中创建／编辑／重命名／移动／删除（移动文档时会重写指向该文档的 wikilinks）、文档模板、可交互的任务复选框、分类待办事项小组件。
• 历史记录：每篇文档均由 Git 管理版本，提供修订列表、清晰的差异对比、历史版本查看／恢复（恢复操作会创建新的提交），并可跟踪重命名和移动。
• 活动：主页卡片展示带作者归属的 Git 历史——记录谁更改了什么（支持 AI 作者检测，并可查看每篇文档的历史记录）；还会展示贡献者星图，以及健康状况视图，突出显示过时文档（内容陈旧）和相同主题的矛盾候选项，供 AI 审核。
• 收件箱：主页上按个人划分的分拣区域，用于处理 Agent 通过 MCP 暂存的条目。每次聚焦一张卡片；可通过点击或键盘（K / X / S / J）保留（归档到建议的文件夹并添加标签）、移入垃圾箱或延后处理。
• 注释：锚定到文本选区的备注，后续访问时会重新锚定，并可一键将所有备注复制为 Markdown。
• 共享：云端模式下可按文档设置访问权限（私有／与个人或群组共享／团队公开），并提供带 HMAC 签名且可选有效期的公开分享链接。
• 离线与 PWA：自包含的 index-offline.html 可通过 file:// 使用；通过 service worker 提供可安装的 PWA；支持基于 SSE 的实时重新加载。
• 国际化：支持法语和英语，采用精心打造的单一深色主题，可通过 CSS 扩展重新换肤。

自托管

• 云模式：账号和登录（管理员 / 成员角色）、按文档设置访问控制、Cookie 会话、可选的 TOTP 双重身份验证（附带恢复码）、按账号锁定和按 IP 限制登录频率，并提供完整的 CSRF 防护。
• 部署：atlas deploy ~/my-mind --target compose|systemd|fly；fly --wizard 可端到端完成部署。
• 配置：简洁的 atlas.toml（品牌前缀、端口、身份验证、内容路径）。
• 更新：引擎和内容可独立更新，升级引擎绝不会影响你的笔记。

文档

文档本身就是一个 Atlas 思维导图——在在线演示中浏览 →（guides/ 和 features/ 部分）。

许可证

AGPL v3，详见 LICENSE。查看器和登录页面中的 “Atlas” + “Mind” 品牌标识是项目固定的一部分。