Tesserae

English · 한국어 · 日本語 · Русский · Español · Français · Deutsch

一款上下文引擎，为你的项目维护自我改进的知识库，并按需编译智能体可直接使用的上下文。

在线演示 · 文档 · 版本说明 · MCP 配置 · Obsidian 导出

是什么

将 Tesserae 指向一个包含 Markdown、源代码以及可选 PDF/Office 文档/图片的目录，它会重建该项目的类型化知识图谱并保持其最新状态，让智能体始终能获得有据可查、来源清晰的上下文。三大支柱：

1. 会话监控 —— 你与 Claude Code / Codex 关于项目的对话，在产生的那一刻就成为一级图谱节点（决策、洞见、问题、TODO）。
2. 自主摄入 —— 一个受监督的引擎监视源文件和会话，合并突发变更并重新编译；自我改进的边车（sidecar）强化反复出现的发现，同时取代（supersede）过时内容。
3. 按需上下文 —— 上下文编译器为任意查询或种子节点组装一份带引用的定制上下文文档（在字符预算内做 Personalized PageRank 扩展），可直接粘贴到任何智能体中。

类型化图谱、Obsidian vault 和静态站点都是同一知识库的*投影*。所有内容本地运行；这是一个构建步骤加实时引擎，而非托管服务。

快速开始

需要 Python 3.10+。

pip install tesserae          # 加上 [semantic] 可启用真正的向量嵌入
# 或: pipx install tesserae   # 最简洁的 PATH 安全安装方式
# 或: npx @jokerized/tesserae # 同一 CLI 的 Node 包装器

cd /path/to/my-project
tesserae init --yes           # 向导；--yes 接受检测到的默认值
tesserae compile              # 构建知识图谱
tesserae ask "Mermaid 渲染是在哪里实现的？"

# 为查询编译定制的带引用上下文文档：
tesserae context "解析器如何处理 arXiv ID？" --budget 32000 -o context.md

tesserae serve --port 8765    # 在本地浏览图谱 + wiki

LLM 支持的功能默认通过 OAuth 使用 codex / claude CLI —— 常规路径无需 API 密钥。详见 docs/quickstart.md 和 docs/installation.md。

操作演示 GIF —— 基于内置 135 个文档演示语料库，演示每个快速开始步骤

1. 初始化 —— 指向研究目录，生成项目 wiki 脚手架

2. 编译 + 构建站点 —— 确定性，无需 LLM 调用

3. Ask —— 从 CLI 查询已编译的 wiki

使用 `vhs docs/screencasts/<name>.tape` 可重新生成任意 GIF。