slivingdoc

测试覆盖率：83.7% 😍👌

特性

• 类 Git 语义：slivingdoc 使用我们（和智能体）都熟悉的术语，设计简单易用

• 自动冲突解决：放心提交，所有冲突必须解决后才能被接受

• 高速处理：解决方案概念上非常简洁，支持极高规模和并行处理

• 即插即用：设置存储桶，指向它，然后开始同步笔记！

docs/slivingdoc-v1.md 是这些保证背后的完整已接受合约。

Related MCP server: Cellar

快速开始

将其添加到您的智能体框架中：

{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc",
        "serve",
        "--bucket",
        "my-notes",
        "--workspace-root",
        "/srv/notes"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<your-access-key-id>",
        "AWS_SECRET_ACCESS_KEY": "<your-secret-access-key>",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

存储桶必须存在，凭证来自标准的 AWS 链。 还没有 S3 账户？examples/seaweedfs/ 提供了一个分步指南，运行本地 SeaweedFS 容器。您也可以直接从 GitHub release 下载原生二进制文件（slivingdoc-v<semver>-<os>-<arch>）并就地运行。

支持的平台：Linux（amd64、32-bit ARMv7、arm64）、macOS（amd64、arm64）和 Windows（amd64）。32 位 Linux ARM 构件支持 Raspberry Pi OS armhf。

工作原理

服务器通过 stdio 暴露两个 MCP 工具：

notes_pull 将当前笔记本写入您的目录。notes_commit 发布您的更改并合并并发的非冲突更改。两次调用之间没有任何协议 —— 智能体使用已有的工具编辑文件，人类可以使用任何编辑器在同一目录中编写。下一次提交也会带上他们的更改。

人类也可以直接驱动这两个操作，无需 MCP 主机。相对路径相对于工作目录解析：

slivingdoc pull notes
# edit UTF-8 text files under notes/
slivingdoc commit notes -m "meeting summary"

成功后打印统一的结果报告：OK 状态、接受的远程世代、每个文件的插入和删除计数，以及总计尾部。域错误以非零退出并打印一个坦诚的报告：错误类别、可重试性判定，以及每个冲突文件及其行范围。颜色仅在实际终端上显示，任何非空的 NO_COLOR 都会禁用颜色。

Git 部分

如果让所有智能体同时写入，虽然可以工作，但会被竞态条件淹没。因此 slivingdoc 内置了通过 libgit2 实现的 git，它实际上执行以下操作：

1. git pull

2. （本地潜在冲突解决）

3. git add .

4. git commit -m "<agent message>"

5. git push

6. （本地潜在冲突解决）

所有这些 git 操作都在笔记目录的私有镜像中本地处理，形成一条“精简的” git 序列。这基于两个妥协：首先，本地笔记目录在 notes_pull 时容易被更改，远程状态优先，留下冲突标记。其次，系统仅适用于文本（干净的 UTF-8）。

配置

serve、pull 和 commit 读取相同的标志和环境变量。--bucket 是必需的。最常用的标志：

slivingdoc serve -h 打印完整的参考信息，docs/running.md 涵盖了操作员所需的一切：所有标志、确切的 S3 权限、日志记录（stderr 上的 LOG_LEVEL）、笔记本规则、冲突恢复和检查点保留。位于 terraform/ 的 Terraform 模块为单个笔记本提供了一个存储桶和一个最小权限的 IAM 用户。

开发

• AGENTS.md — 开发者和智能体指南：包结构、操作流程、约定和质量检查关卡。

• docs/slivingdoc-v1.md — 已接受的架构合约。

• docs/build.md — 原生构建，从固定的 libgit2 源代码到依赖检查。

• docs/testing.md — 测试命令、测试层次结构和不使用真实 AWS 的规则。

• docs/releasing.md — 发布构件、npm 受信任发布和 make release。

make qa #lint plus the full Go and npm test suites

许可证

MIT — 参见 LICENSE。静态链接的 libgit2 的第三方通知在 NOTICE 中。

与帕丽斯·希尔顿无关。