Pond 解决的是“智能体会话散落在各个工具、无法检索”的问题：你运行过的 AI 智能体会话（Claude Code、Codex、任何工具、任何机器）都留在本地磁盘上，里面满是决策、修复与死胡同，却被困在各自无法搜索的工具里。Pond 会自动、无损地把它们全部摄入你拥有的存储（本地目录或你自己的 S3 桶），使整个语料可搜索、可用 SQL 查询，并通过 MCP 把这种召回能力交还给智能体——于是“我们以前是怎么修这个的？”变成一个查询，而不是考古。会话不再被创建它的工具锁定：任何会话都能恢复到任何受支持的客户端并继续。
用途与定位 Pond 是底层存储与检索层。记忆工具存的是它们判定你需要的事实、摘要与分块，会话本身已经消失；Pond 保留的是会话本身：每条消息、每次工具调用与结果，值完整、跨客户端、存在你自己的存储里、永不修剪，可经 MCP 搜索、可恢复到任何客户端。记忆是可以随时从档案重建的派生视图，而档案永远无法从记忆重建。
主要能力
- 自动摄入：从 Claude Code、Claude 桌面应用（本地 agent 模式）、Codex CLI、opencode、pi-coding-agent、oh-my-pi、OpenClaw、NanoClaw、Hermes Agent、letta-code、grok-build、Antigravity CLI（含其 ACP 服务器）和 Devin CLI 等自动拾取会话。Claude.ai 数据导出可用 pond sync claude-ai-export --path <path> 导入（需手动下载，因此不会自动发现）。
- 无损存储：规范化的 Session / Message / Part 中间表示，未知记录形状仍可无损摄入；存储、索引、OCC、模式演进、blob 列、版本与时间旅行都由 Lance 承担。
- 搜索：默认 BM25 全文检索（单词级分词器 + 英文词干提取 + ascii 折叠，任何语言同等索引）；可选语义搜索（intfloat/multilingual-e5-small，FP16 权重，macOS 走 Metal、CUDA 可选、CPU 回退），每次查询只用一个检索臂，无服务端融合。
- SQL：只读 SQL 查询（Same surface 作为 pond_sql MCP 工具），通过 DataFusion 对同一批 Lance 数据集做规划。
- 传输：HTTP+JSON（axum）与 MCP（rmcp）共用同一套处理器；线操作包括 pond_search、pond_get_session、pond_get_message、pond_ingest，MCP 还暴露只读 pond_sql 工具与 schema://pond、schema://pond-sql、stats://pond 资源。
- 多租户：每个租户是集成方提供的命名空间字符串，Pond 不做认证、授权或身份建模，对象存储的 IAM 是存储边界。
使用方式 安装与初始化：pond init 会把 Pond 注册为 Claude Code 的 MCP 服务器并安装自带的 pond 技能；对 Codex 则打印要运行的命令——之后重启客户端以便加载工具。手动方式：claude mcp add -s user pond -- pond mcp、codex mcp add pond -- pond mcp；技能：mkdir -p ~/.claude/skills/pond && pond skill > ~/.claude/skills/pond/SKILL.md（该整行仅限 POSIX；mkdir -p、&& 和 > 在 Windows PowerShell 5.1 中会出错或损坏，请改用 Connect your agents 中的 PowerShell 块）。也可以直接提示智能体：“Please install and set up pond (see github.com/tenequm/pond)”。 同步与搜索：pond init 一次性设置存储、适配器、MCP 注册与可选同步计划（幂等，可随时重跑修复或更新）；之后导入本地适配器会话、更新索引并搜索。pond sync 只摄入已启用的适配器——启用是显式步骤（pond adapters enable / pond adapters discover / pond init），绝不是同步的副作用。 存储：默认本地存于 ~/.local/share/pond（Windows 为 %LOCALAPPDATA%\pond\data）。对象存储可加凭据并切换目标：pond init --storage-path <url> 在设置时配置远端目标并在目标为远端时内联提示凭据；s3+https://host/bucket 形式适用于任何 S3 兼容存储（Hetzner、R2、B2、MinIO），s3://、gs://、az:// 在没有匹配的 [creds.*] 时使用标准云 SDK 凭据链。pond copy --from <local> --to <url> 将现有本地数据带入桶（幂等、绝不删除源，完成后重建目标索引并校验每一行，缺失或重复则退出码 6）。 状态与内省：pond status 打印每表存储表、索引（文本就绪情况，仅在启用嵌入时含语义部分）、已存会话与消息、来源智能体，以及本机视角（每适配器待同步会话、上次同步结果含计划任务的失败暴露、下次计划运行）。pond status --hosts 按摄入主机拆分共享存储；--include-subagents 将每个子智能体计为独立智能体。pond sync --dry-run 预览下次同步会读取什么；pond search --explain 返回每个检索臂的 Lance analyze_plan 输出。 维护：pond sync 每次运行默认折叠索引；pond optimize --only index 按需运行；嵌入积压用 pond optimize --only embed 一次性补齐。定期更新可按平台配置 launchd、systemd 用户定时器或 cron、Windows 任务计划程序（须从普通而非管理员 shell 运行）。
平台与安装渠道 支持 Linux、macOS 与 Windows。macOS/Linux 提供安装方式；Windows 主渠道为 Scoop（同时附带 pondw.exe，即用于计划同步运行的无窗口启动器）；无包管理器时每个 release 附带预编译二进制（Windows 为 pond-x86_64-pc-windows-msvc.zip，解压后约 223 MB），解压并将目录加入 PATH 即可。也可通过 cargo 安装（需 Rust 工具链；仅安装 pond.exe，Windows 计划同步需改用 Scoop 或 zip 安装，或源码构建时加 --features windows-launcher；cargo install 还需 protoc 与 NASM 前置条件），或从源码构建（Windows 需先 git config --global core.longpaths true，且必须显式指定 --target x86_64-pc-windows-msvc）。Linux CUDA 加速需相应特性；macOS 自动选 Metal，其他系统默认 CPU 回退。Windows 源码构建还需 protoc（winget install Google.Protobuf）与 NASM（winget install NASM.NASM，再自行将 C:\Program Files\NASM 加入 PATH）。
适用场景与限制 适合希望跨工具、跨机器统一保留并检索智能体会话历史的开发者与团队；需要把会话归档进自有对象存储、并对历史做结构化 SQL 提问的场景；需要把历史召回交还给智能体、并能把任意会话恢复到任意受支持客户端的场景。 限制与注意事项：状态为 pre-v1，模式、线格式与配置键在 v1 前可能发生破坏性变更；完整文档位于 pond.locker，契约在 docs/spec.md。适配器按尽力维护，格式漂移被设计为安全（未知记录形状仍无损摄入，畸形输入以命名文件的类型化错误呈现）。Pond 本身不做认证、授权或身份建模，也不持有密钥、不添加应用层加密；加密属于运维层面（桶 SSE 与文件系统加密）。语义搜索默认为关闭，关闭时任何 Pond 进程都不会下载或加载嵌入模型。存储后端通过 Lance 的 object_store 集成支持本地 FS / S3 / GCS / Azure。添加新适配器属常规工作，见 Contributing。
