跳转至

尚无译文的页面会以英语打开,并标注为英语。

本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.

ClickHouse Loom 文档

Loom 是面向 AI agent 的记忆、文档和代码索引服务器,数据存储在 ClickHouse 中,也可以选择用 Postgres 存放实时记忆和知识状态。agent 和用户可以通过 MCP、HTTP、Python 和 TypeScript SDK 以及控制台访问它。本页按阅读顺序列出了所有页面。

控制台的资料库:搜索退款规则,返回带引用的段落

从这里开始

步骤 阅读
1. 评估 概览 → 评估 Loom
2. 安装 快速开始 → 部署
3. 连接 agent 连接编码 agent → 集成
4. SDK 和 API 你的第一个 agent → Python SDK / HTTP API
5. 命名空间与访问 身份与命名空间 → 令牌与授权
6. 代码索引 代码索引 → 代码仓库 → 代码索引运维
7. 运维 监控 · 故障排查 · 升级 · 备份与恢复

使用场景

每个需求一个页面,说明 Loom 能为此做什么,以及从哪里开始: agent 记忆 · 文档搜索与 RAG · 面向编码 agent 的代码索引 · 按语言划分的代码索引 · 与代码关联的记忆 · 编码 agent 的模型成本 · 多 agent 共享上下文 · 自主 agent:召回、审计、擦除 · 运行、追踪与 PR 历史 · 基于 ClickHouse 的自托管 · 所有使用场景。

1. 快速入门

2. 安装并运行服务器

3. 连接 agent

集成 · MCP 客户端 · Agent 指令 · Claude Code · Codex · Cursor · VS Code · 框架 · Grep 垫片 · Langfuse · ClickStack · OKF

4. SDK 与 API

参考索引 · HTTP API · MCP · Python SDK · TypeScript SDK · 环境变量 · 运维 · 配置 · 工作进程 · CLI · 错误 · 状态 · 数据模式 · 提取器契约。各个版本之间,操作和字段会有变化;未知字段和已移除字段说明了客户端如何处理服务器不再读取的字段。

5. 命名空间、访问与记忆模型

指南

agent 集成 · 无头机器人 · 令牌与授权 · 跟踪并恢复长时间运行 · 优化命名空间 · 调查类 agent 的记忆 · 提取流水线 · 性能调优 · 调试 · 从 Postgres 查询 Loom · 使用 Loom 教学

功能

6. 代码索引

概览 · 仓库 · 新鲜度 · 历史与 PR · 运维 · 代码索引运维手册

架构

系统概览 · 服务器布局 · ClickHouse · 记忆架构 · 存储权威 · 单元 · 存储布局 · 代码索引架构 · 文档提取 · 文档来源 · LLM 与嵌入 · 安全 · 助手设计 · 故障与恢复 · 滚动升级

基准测试

概览 · 覆盖范围 · 方法论 · 运行 · 结果 · 添加用例 · Skill 评测

开发

面向贡献者:仓库指南 · 本地开发 · 测试 · 代码生成 · 迁移 · 发布流程 · 文档风格 · 整理循环设计 · 扩展 Loom · 添加操作 · 添加 worker · 添加表 · 添加语言支持 · 控制台设计。 CONTRIBUTING.md 介绍了 pull request 的工作流程。

另请参阅

术语表:Loom 的术语,每个只定义一次。常见问题:最先会遇到的问题,每个问题一段回答。llms.txt:为 agent 生成的文档索引;llms-full.txt 将说明 Loom 是什么以及如何开始使用的页面合并在一个文件中。