Tesserae v0.12.1 — 每个端点都在舰队服务中路由

<!-- translations:start -->

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

<!-- translations:end -->

发布于 2026-06-29 · PyPI · GitHub release · pip install --upgrade tesserae==0.12.1

一个补丁发布，完成了 v0.12.0 中的多项目 serve 故事。可直接升级替换 v0.12.0。

每个 /api/* 都在裸服务器中路由到正确的项目

在 v0.12.0 中，裸 tesserae serve（为每个已注册的项目提供服务）仅路由 /api/ask — /api/clip 和 /api/transcript-search 返回 404，因此 Chrome 剪切器无法剪切到多项目服务器，每个项目的会话搜索也无法工作。现在每个端点都路由：

• /api/ask、/api/ask/health、/api/transcript-search — 由页面的 /<alias>/ Referer 路由到该项目。
• /api/clip — 剪切来自*外部*网页，因此没有 Tesserae Referer 来路由。服务器从以下方式解析目标项目：(1) 剪切正文中的 project 别名，(2) 如果只有一个已注册的项目则使用该项目，否则 (3) 返回 400 列出可用的别名。Chrome 扩展获得了*目标项目*设置，用于填充 project。

单项目 tesserae serve --project X 保持不变 — 其安全性（扩展/本地回环 CORS 网关、剪切令牌和 5 MB 正文上限）完全相同，因为两种模式现在共享一个实现。

转录搜索以 409 方式失败当两个已注册的项目共享一个目录名称时（memex 按基名为转录命名空间，所以无法区分它们） — 而不是将一个项目的会话历史混合到另一个项目中。

还有

• 文档 — docs/ingest.md 获得了一个"构建概念层（--extractor）"指南，用于 v0.12.0 LLM 提取器；Cognee 后端的 GRAPH_COMPLETION 默认值和舰队实时询问现已记录在案。

从 v0.12.0 升级

可直接升级。要从裸 tesserae serve 中剪切到特定项目，请在扩展选项中设置目标项目为该项目的别名。