TypeScript SDK

TypeScript SDK 适合 Node.js 服务端、API Route、Agent Runtime 和自动化工作流。

安装

pnpm add memaster

配置 API Key

MEMASTER_API_KEY=msk_xxx

写入记忆

import { MemoryClient } from "memaster";
 
const client = new MemoryClient({
  apiKey: process.env.MEMASTER_API_KEY!,
});
 
await client.add({
  user_id: "user_123",
  messages: [
    { role: "user", content: "我希望产品方案优先考虑私有数据安全" },
    { role: "assistant", content: "我会在后续方案中优先考虑数据安全。" },
  ],
  metadata: { project: "demo", source: "chat" },
  infer: true,
});

检索记忆

const results = await client.search({
  query: "用户对产品方案有什么偏好？",
  user_id: "user_123",
  top_k: 5,
});
 
for (const item of results.results) {
  console.log(item.memory);
}

接入建议

API Key 只放在服务端，不要暴露到浏览器。
用 user_id 区分终端用户。
用 metadata 保存业务域、来源和标签。
在 Agent 回复前检索，在回复后异步写入。
设置 infer: true 时，服务端会先用 LLM 从消息中抽取稳定记忆并去重。

下一步

Python SDK