OneLedger

自托管的 Agent 记忆总账：本机收集、安全扫描、蒸馏队列、MCP 供给其他 Code Agent 调用，并可与远端节点同步。版本 0.4.2。

服务器地址和存储后端不写死，在管理界面里配置。默认本机 SQLite；中心节点可改接 Postgres。

要求

• Node.js 22+

默认只在本机跑，不依赖任何远程代码托管。数据在 ~/.oneledger（可用 ONELEDGER_HOME 改）。

Related MCP server: heropen

启动

npm install
npm run check
npm run build
npm run desktop
npm run pack

浏览器打开 http://127.0.0.1:7443/，用 ~/.oneledger/config.json 里的 adminToken 登录管理台（Windows 上通常是 C:\Users\<you>\.oneledger\config.json）。数据目录可用 ONELEDGER_HOME 覆盖。

给其他 Agent 用的 MCP

本机 stdio：

{
  "mcpServers": {
    "oneledger": {
      "command": "npx",
      "args": ["tsx", "src/index.ts", "mcp"],
      "env": {
        "ONELEDGER_HOME": "C:/Users/you/.oneledger"
      }
    }
  }
}

远端 / 本机 HTTP：管理台签发一把 Agent 密钥后：

{
  "mcpServers": {
    "oneledger": {
      "url": "http://127.0.0.1:7443/mcp",
      "headers": {
        "Authorization": "Bearer ol_..."
      }
    }
  }
}

工具：memory.search / memory.remember / memory.forget / memory.list。secret 级内容不会进入可检索记忆，也不会同步到远端。

运行模式

命令：oneledger serve · oneledger mcp · oneledger collect · oneledger version

版本与热更新

• 程序版本：package.json / APP_VERSION

• 通道文件：app_update.json（累计 history）

• 检查更新：顶栏或「服务器与存储 → 关于与更新」

• 便携版：下载 OneLedger-Portable.exe，校验固定仓库域名与 .sha256 后替换正在运行的 exe 并重启

• 安装版：下载 OneLedger-Setup.exe，同样校验后退出并打开安装程序覆盖安装

• 两套互不混用。数据在 ~/.oneledger，热更新不碰用户数据。不要求代码签名证书

• 配置 schema：config.schemaVersion；数据 schema 启动时迁移；同步协议：X-OneLedger-Protocol

发版前把新说明插到 app_update.json 的 history 最前面，再打 v* tag。Release 正文用当前这条的 title / body。

安全边界

• 入库扫描密钥、连接串、高熵串；出库不再返回 secret

• 管理台 token 与 Agent MCP key 分离

• 蒸馏默认规则摘要；若配置了兼容 OpenAI 的接口，只发送已脱敏文本