TIMPS — AI 编码代理的持久记忆

状态： 个人项目，早期阶段。MCP 服务器和 CLI 是我每天实际使用并信赖的部分。此仓库中的其他内容（桌面应用、移动端、JetBrains、插件市场）都较新且测试较少——已在下方标注。我真心希望你先试用核心功能并告诉我哪里有问题，而不是阅读营销文案。

30 秒快速试用

npx timps-code "what does this codebase do?"

无需安装、无需配置、无需 API 密钥。将其指向任何仓库即可。如果你本地运行着 Ollama，这 100% 免费且数据不会离开你的机器。如果没有，它会引导你选择提供商。

要在 Claude Code、Cursor 或任何 MCP 客户端中获得真正的持久记忆，请添加 MCP 服务器：

npm install -g @timps-ai/timps-mcp

然后将其指向你的 MCP 客户端（配置说明见 MCP 设置）。

Related MCP server: Lockstep Core

它实际做什么

今天让 Claude Code 修复一个 bug。关闭会话。明天问它相关的问题——它对你昨天做了什么决定、你已经尝试过什么、或者你为什么以某种方式构建代码一无所知。你最终不得不在每次会话中重新解释相同的上下文。

TIMPS 作为 MCP 服务器位于你和你的代理之间，为每个项目维护一个记忆存储：

• 它记住什么 — 你做出的架构决策、特定于你代码库的模式和约定、你已经遇到过的 bug 及其修复方式，以及它写了什么和为什么写的纯审计日志。

• 它存储在哪里 — 默认使用本地 JSON/SQLite 文件，按项目键控，这样不同的仓库不会互相干扰。如果你希望团队共享，可选 Postgres/Qdrant。

• 它花费多少 — 如果你本地运行 Ollama 则免费。如果你想要更好的推理质量，可选付费提供商（Claude、GPT、Gemini）。

这就是全部卖点。它是一个记忆层，而不是一个新的代理——它与你已经在使用的任何编码代理协同工作。

工作原理（简版）

在底层，记忆按几个真实的层级组织：

1. 工作记忆 — 当前会话：活动文件、最近的错误、实时目标。退出时清除。

2. 情景记忆 — 过去会话及其结果的日志。

3. 语义记忆 — 持久的内容：模式、约定、从情景记忆中提升出来的决策，因为它们持续重要。

4. 审计追踪 — 一个仅追加、哈希链式的每次记忆写入日志，让你能准确看到系统学到了什么以及何时学到的。

在此之上还有一套更深的子系统（时间模式检测、矛盾检测、置信度评分、基于重要性的剪枝），供想进一步探索的人使用——完整分解见 ARCHITECTURE.md 而不是在这里，因为大多数人不需要了解内部原理就能使用它。

MCP 设置

Claude Code

添加到 ~/.claude.json：

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

Windsurf

添加到 ~/.config/windsurf/config.json：

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

任何其他 MCP 客户端

通过 stdio 运行 timps-mcp。这就是协议所需的全部。

诚实的测量结果

自行运行：npx tsx benchmark/index.ts --quick

这些是我构建的合成数据集上的自运行基准——未经独立验证，也不代表它在你的实际代码库上的表现。请将其视为"核心逻辑按设计工作"，而非竞争性声明。

此仓库中的其他内容（早期/实验性）

这个 monorepo 包含一个 VS Code 扩展、一个桌面应用（Tauri）、一个移动应用、一个 JetBrains 插件，以及一个用于任务分解的多代理"群"模式。这些功能存在且大多可用，但它们经受的真实世界使用远少于 CLI/MCP 核心——请将它们视为"好奇就试试"，而非"生产就绪"。我宁愿坦诚相告，也不愿让你在踩坑时才发现。

试用它，然后告诉我哪里有问题

这对我现在确实有用：在你一个真实仓库上运行上面的 30 秒命令，然后告诉我什么坏了、什么令人困惑、或者它哪里做错了。这些反馈对这个项目的价值超过一颗星。

• 问题反馈：github.com/Sandeeprdy1729/timps/issues

• Discord：discord.gg/MmsTNm8WF6

许可证

MIT