TokST Persistent memory for people and AI agents

知识库

知识库是一个命名的知识集合,保存一组相关记忆。可以将其视为特定领域的文件夹或数据库。知识库分组在工作区内。

概念

属性描述
名称人类可读的标签(例如:"Project Alpha"、"Personal Notes")
关键词用于自动路由的逗号分隔术语
工作区包含该知识库的父级工作区
记忆存储在该知识库中的所有记忆
tokst atlas init --name "Project Alpha"

创建知识库

tokst atlas init --name "MyKnowledge"

每个知识库初始为空。新创建的知识库将成为您的当前知识库。

列出知识库

tokst atlas list

显示当前工作区中的所有知识库,包括其记忆计数和关键词配置。

重命名知识库

tokst atlas rename --atlas-id <id> --name "New Atlas Name"

重命名指定的知识库。

设置自动路由关键词

关键词启用自动路由——当您存储记忆而未指定知识库时,TokST 会检查记忆内容是否匹配任何知识库的关键词,并自动路由。

tokst atlas profile --atlas-id <id> --keywords architecture,backend,api,typescript

当您运行 tokst remember "The API uses TypeScript with Express" 时,TokST 会将内容与知识库关键词进行匹配,并路由到最匹配的知识库。

删除知识库

tokst atlas delete --atlas-id <id>

警告: 这会先清理知识库中所有记忆对应的 R2 文件对象,再永久删除记忆和知识库。此操作无法撤销。

自动路由详解

自动路由帮助您存储记忆而无需每次都手动指定知识库。工作原理如下:

  1. 您运行 tokst remember "Some content"(无 --atlas 标志)
  2. TokST 对照当前工作区中所有知识库的关键词配置评估内容
  3. 关键词匹配得分最高的知识库接收该记忆
  4. 如果没有知识库匹配超过阈值,记忆将进入当前知识库

这对于智能体驱动的工作流特别有用——智能体不知道使用哪个知识库,它只管记住,TokST 会确定存放位置。

最佳实践

  • 每个领域创建一个知识库 — 不要将个人笔记与项目架构混在一起
  • 设置关键词配置 — 它们使自动路由可靠地工作
  • 描述性地命名知识库 — 像"Frontend"或"Backend"这样的名称比"Atlas 1"更清晰