2026/9/13 23:24:22
FEATURED · 精选文章 
为 Devin Desktop 接入 Hindsight 长期记忆MCP 集成完整指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightDevin Desktop原 Windsurf / Codeium是 Cognition 推出的 AI 编辑器本指南讲解如何通过 Hindsight 的 MCP 服务器为其接入长期记忆一条init命令即可同时配置编辑器自带的 Cascade 与 Devin Local 两个 Agent写入始终生效的 recall/retain 规则让 Agent 在任务开始时自动回忆相关记忆、在工作过程中沉淀持久事实。读完本文你将掌握该集成的安装命令、双 Agent 配置差异、双层银行global project记忆模型、Devin Local 的确定性 Hook 机制以及完整的命令与配置参数。集成概览为什么 Devin Desktop 需要 HindsightHindsight 是一个会学习的 Agent 记忆服务通过 MCPModel Context Protocol向编码 Agent 暴露recall/retain/reflect三个核心工具。Devin DesktopCognition 于 2026 年 6 月将 Windsurf 更名为 Devin Desktop正好支持两类本集成所依赖的能力MCP 服务器Devin Desktop 读取mcpServers配置并运行其中的 MCP 服务器把工具暴露给 Agent。远程服务器通过serverUrl字段可选 headers连接因此 Hindsight 的远程 MCP 端点可以直接接入无需任何桥接进程工作区规则.devin/rules/目录下的规则文件带trigger: always_onfrontmatter 的文件会被包含进该工作区的每一次 Devin 请求中。集成在其中写入一条简短规则指导 Agent 先回忆、后沉淀。需要特别留意更名并不改变 Devin Desktop 的磁盘数据目录——MCP 配置仍然位于~/.codeium/windsurf/下工作区规则则迁移到.devin/rules/.windsurf/rules/保留为旧版回退路径。快速开始一条命令完成接入在项目仓库内执行pip install hindsight-devin-desktop cd your-project hindsight-devin-desktop init --api-token YOUR_HINDSIGHT_API_KEY --bank-id my-memoryinit会完成以下两件事源码见 cli.py把hindsightMCP 服务器写入 Devin Desktop 的全局 MCP 配置~/.codeium/windsurf/mcp_config.json把 recall/retain 规则写入./.devin/rules/hindsight.md。重新加载 Devin Desktop或刷新 MCP 服务器列表后hindsight服务器的工具即对 Agent 可用。认证与服务器选择使用 Hindsight Cloud 的 API Key即--api-token自托管服务器用--api-url http://localhost:8888指定地址开放的本机服务器无需 token。非标准 JSON 配置如果mcp_config.json不是纯 JSON例如带注释init不会冒险改写你的文件而是打印出需要手动粘贴的配置片段——也可以随时运行hindsight-devin-desktop init --print-only只看不写。双 Agent 架构Cascade 与 Devin Local 都要覆盖Devin Desktop 实际内置两个配置相互独立的 Agent仅配置其中一个不会让另一个感知到 MCP 服务器因此init会同时为两者写入配置详见 README.md 与 devin_local.py配置项Cascade旧版 Windsurf AgentDevin Local继任 AgentMCP 服务器~/.codeium/windsurf/mcp_config.jsonserverUrl字段~/.config/devin/config.jsonurltransportheaders字段工具审批自动预置放行规则mcp__hindsight__*工具调用不再弹窗确认项目级规则.devin/rules/hindsight.md仓库根目录AGENTS.md全局规则~/.codeium/windsurf/memories/global_rules.md~/.config/devin/AGENTS.md自动回忆无仅靠规则驱动SessionStartHook确定性注入记忆沉淀提醒无StopHook强制在会话结束前执行一次 retain可见性post_mcp_tool_use横幅hooks.json原生工具卡片 规则叙述路径说明上表为 macOS/Linux 路径Windows 上 Devin Local 配置位于%APPDATA%\devin\Cascade 仍在~/.codeium/windsurf\。所有文件编辑都是外科手术式的要么写入独立文件要么在共享文件中AGENTS.md、global_rules.md、hooks.json维护一段带围栏标记的托管块。共享块由!-- HINDSIGHT:BEGIN --与!-- HINDSIGHT:END --围栏界定见 managed_block.py更新与卸载均可幂等执行绝不触碰你自行编写的内容Cascade 的专属规则文件则以哨兵注释!-- Managed by hindsight-devin-desktop --标记归属见 rules.py。Devin Local 的 Hook确定性的记忆加载与沉淀MCP 工具 规则本质上是模型驱动的——Agent 之所以回忆/沉淀是因为规则告诉它这么做。对于 Devin Localinit额外添加两个 Hook可用--no-hooks同时关掉SessionStart自动回忆在每个会话开始时回忆项目记忆 用户全局记忆并注入 Agent 上下文。即使模型忘记调用recall相关记忆也会被加载它总是报告状态已加载 N 条 / 空 / 不可用记忆的使用永远不会是静默的且绝不会阻塞会话。Stop沉淀提醒在 Agent 停止前强制执行一次 retain由模型判断哪些是持久事实并调用retain。带循环保护每个会话多花费一个回合可用--no-retain-hook单独关闭。从 hook.py 的源码可以看到这两个 Hook 的实现细节recall子命令从 Devin Local 的config.json读取连接信息从DEVIN_PROJECT_DIR环境变量推导项目银行通过标准库urllib直接发起 MCP 调用initialize→tools/call recall把结果以hookSpecificOutput.additionalContext的形式输出由 Devin 注入 Agent 上下文固定查询词为Key architecture, decisions, conventions, and the users preferences and coding style for this work.max_tokens为 1024retain-nudge子命令返回{decision: block, reason: ...}阻止会话直接结束迫使模型先执行 retain并通过stop_hook_active标志防止无限循环两个 Hook 都从不以非零状态退出任何异常超时、网络错误、坏响应都会降级为不可用状态报告绝不破坏会话。为什么不做全自动 retainDevin 的 Hook 无法把会话转录文本交给脚本所以 Hook 无法自行总结并沉淀——nudge 是当前最接近确定性的方案触发有保证内容由模型撰写。Cascade 则两种 Hook 都无法使用其 Hook 不能注入上下文所以 Cascade 的 recall/retain 保持模型驱动但init会添加一个post_mcp_tool_use横幅show_output: true让每次 Hindsight: tool used都清晰可见见 cascade_hooks.py。双层记忆全局银行 项目银行记忆被拆分到两个 Hindsight银行互相隔离的记忆作用域中避免项目之间的记忆互相污染全局银行默认devin-desktop——跨项目的个人记忆偏好、编码风格、你的身份。在所有项目中共享。项目银行devin-desktop-slug——当前仓库的记忆架构、决策、约定。slug由仓库的git remote派生而来见 project.py因此在不同的机器、克隆和检出路径下都保持稳定且对团队成员完全一致——团队自然共享同一个项目银行。slug 派生优先级git remote优先跨机器稳定且团队一致→ git 仓库文件夹名 → 当前文件夹名结果统一为global-slug格式使项目银行归组在全局银行之下且永不与它冲突。MCP 服务器运行在多银行模式单个端点路径以/mcp/结尾见 mcp_config.py 中的mcp_endpoint_urlalways-on 规则告诉 Agent 何时使用哪个bank_id任务开始时同时 recall 两个银行项目事实 retain 到项目银行、用户事实 retain 到全局银行。同时X-Bank-Idheader 把全局银行指定为模型省略bank_id时的默认银行。Cascade 侧生成的 MCP 配置形如{ mcpServers: { hindsight: { serverUrl: https://api.hindsight.vectorize.io/mcp/, headers: { Authorization: Bearer hsk_..., X-Bank-Id: devin-desktop } } } }Devin Local 侧的条目使用urltransport: http字段远程服务器 schema 与 Cascade 的serverUrl不同并在permissions.allow中预置mcp__hindsight__*放行规则使 recall/retain 无需确认即可自动运行。关闭共享层--no-global-bank如果你不希望个人偏好跟随你跨仓库流动传入--no-global-bank进入仅本机模式所有内容——项目事实和你的偏好——都留在该仓库的项目银行中不共享任何内容也不写入全局规则文件。适合隔离工作机与个人机或不需要共享个人画像的场景。命令参考命令说明hindsight-devin-desktop init接入两个 Agent 的 MCP 服务器 记忆规则自动派生项目银行hindsight-devin-desktop status显示已解析的银行 每个 Agent 的配置状态hindsight-devin-desktop uninstall从两个 Agent 中移除 MCP 服务器 记忆规则init完整参数参数作用默认值--api-urlHindsight API 地址https://api.hindsight.vectorize.io云服务--api-tokenAPI token云服务必填无--bank-id覆盖项目银行默认从 git 派生由 git remote 派生--global-bank跨项目全局银行devin-desktop--print-only只打印待手动粘贴的配置不写任何文件关--no-hooks同时跳过 Devin Local 的两个 Hook开Hook 默认启用--no-retain-hook跳过 Stop 沉淀提醒保留自动回忆关--no-global-bank仅本机模式所有记忆留在项目银行关init在仓库内运行时会从 git remote 派生项目银行然后同时写入两个 AgentMCP 服务器条目、项目规则请把./.devin/rules/hindsight.md与./AGENTS.md提交进版本库让团队成员共享项目银行以及全局规则。完成后还需要在所用 Agent 中激活服务器配置不会热重载Cascade——打开 MCP 面板点击RefreshDevin Local——打开Devin MCP Marketplace在Installed下找到hindsight点击Connect。不确定自己在用哪个 Agent看 Devin Desktop 右下角的agent selector。配置文件与环境变量配置按后加载者优先的顺序解析内置默认值 →~/.hindsight/devin-desktop.json用户配置文件 → 环境变量见 config.py。注意用户配置文件只持久化连接信息与全局银行项目银行永远不会写入全局配置——它是每个仓库独立派生的并被烘焙进该仓库已提交的规则文件中。配置项环境变量默认值API 地址HINDSIGHT_API_URLhttps://api.hindsight.vectorize.ioAPI tokenHINDSIGHT_API_TOKEN无云服务必填全局银行HINDSIGHT_DEVIN_DESKTOP_GLOBAL_BANKdevin-desktop项目银行HINDSIGHT_DEVIN_DESKTOP_BANK_ID由 git remote 派生用户配置文件~/.hindsight/devin-desktop.json的键为hindsightApiUrl/hindsightApiToken/globalBank其中旧版的bankId键会被映射为全局银行保证 pre-0.2 时代的单银行配置无缝升级。验证集成是否生效开始一个会话你会看到记忆已开启——没有任何环节是静默的Devin Local——回复会以状态行开头例如 Hindsight preloaded 3 memories for this session或no memory yet、⚠️ memory unavailable this session。每次 Hook 运行还会记录到~/.hindsight/devin-hook.log可据此确认 recall/retain Hook 是否触发Cascade——每次recall/retain显示为工具卡片展开post-tool hooks行可以看到 Hindsight: tool used横幅hindsight-devin-desktop status会逐个列出两个 Agent 的每个组件是否已安装以及解析出的银行。工作原理小结与设计取舍recall 和 retain 通过 Agent 调用的 MCP 工具完成由 always-on 规则引导。这意味着 recall 是查询时刻精确的无滞后——记忆在需要时按真实消息实时检索其代价是它依赖 Agent 遵循先回忆的指令而非编辑器强制执行。Devin Local 的SessionStart/StopHook 正是为弥补这一不确定性而生自动回忆保证基线记忆必然注入沉淀提醒保证会话结束时必然有一次 retain 机会而记忆内容的质量仍由模型判断。仓库中的测试套件覆盖了上述全部行为见 tests/运行方式为uv sync uv run pytest tests -v -m not requires_real_llm # 确定性测试套件 uv run pytest tests -v -m requires_real_llm # 需真实 MCP 端点的门控检查完整的配置选项还可参考集成包的 README.md。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
为 Devin Desktop 接入 Hindsight 长期记忆：MCP 集成完整指南
为 Devin Desktop 接入 Hindsight 长期记忆MCP 集成完整指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightDevin Desktop原 Windsurf / Codeium是 Cognition 推出的 AI 编辑器本指南讲解如何通过 Hindsight 的 MCP 服务器为其接入长期记忆一条init命令即可同时配置编辑器自带的 Cascade 与 Devin Local 两个 Agent写入始终生效的 recall/retain 规则让 Agent 在任务开始时自动回忆相关记忆、在工作过程中沉淀持久事实。读完本文你将掌握该集成的安装命令、双 Agent 配置差异、双层银行global project记忆模型、Devin Local 的确定性 Hook 机制以及完整的命令与配置参数。集成概览为什么 Devin Desktop 需要 HindsightHindsight 是一个会学习的 Agent 记忆服务通过 MCPModel Context Protocol向编码 Agent 暴露recall/retain/reflect三个核心工具。Devin DesktopCognition 于 2026 年 6 月将 Windsurf 更名为 Devin Desktop正好支持两类本集成所依赖的能力MCP 服务器Devin Desktop 读取mcpServers配置并运行其中的 MCP 服务器把工具暴露给 Agent。远程服务器通过serverUrl字段可选 headers连接因此 Hindsight 的远程 MCP 端点可以直接接入无需任何桥接进程工作区规则.devin/rules/目录下的规则文件带trigger: always_onfrontmatter 的文件会被包含进该工作区的每一次 Devin 请求中。集成在其中写入一条简短规则指导 Agent 先回忆、后沉淀。需要特别留意更名并不改变 Devin Desktop 的磁盘数据目录——MCP 配置仍然位于~/.codeium/windsurf/下工作区规则则迁移到.devin/rules/.windsurf/rules/保留为旧版回退路径。快速开始一条命令完成接入在项目仓库内执行pip install hindsight-devin-desktop cd your-project hindsight-devin-desktop init --api-token YOUR_HINDSIGHT_API_KEY --bank-id my-memoryinit会完成以下两件事源码见 cli.py把hindsightMCP 服务器写入 Devin Desktop 的全局 MCP 配置~/.codeium/windsurf/mcp_config.json把 recall/retain 规则写入./.devin/rules/hindsight.md。重新加载 Devin Desktop或刷新 MCP 服务器列表后hindsight服务器的工具即对 Agent 可用。认证与服务器选择使用 Hindsight Cloud 的 API Key即--api-token自托管服务器用--api-url http://localhost:8888指定地址开放的本机服务器无需 token。非标准 JSON 配置如果mcp_config.json不是纯 JSON例如带注释init不会冒险改写你的文件而是打印出需要手动粘贴的配置片段——也可以随时运行hindsight-devin-desktop init --print-only只看不写。双 Agent 架构Cascade 与 Devin Local 都要覆盖Devin Desktop 实际内置两个配置相互独立的 Agent仅配置其中一个不会让另一个感知到 MCP 服务器因此init会同时为两者写入配置详见 README.md 与 devin_local.py配置项Cascade旧版 Windsurf AgentDevin Local继任 AgentMCP 服务器~/.codeium/windsurf/mcp_config.jsonserverUrl字段~/.config/devin/config.jsonurltransportheaders字段工具审批自动预置放行规则mcp__hindsight__*工具调用不再弹窗确认项目级规则.devin/rules/hindsight.md仓库根目录AGENTS.md全局规则~/.codeium/windsurf/memories/global_rules.md~/.config/devin/AGENTS.md自动回忆无仅靠规则驱动SessionStartHook确定性注入记忆沉淀提醒无StopHook强制在会话结束前执行一次 retain可见性post_mcp_tool_use横幅hooks.json原生工具卡片 规则叙述路径说明上表为 macOS/Linux 路径Windows 上 Devin Local 配置位于%APPDATA%\devin\Cascade 仍在~/.codeium/windsurf\。所有文件编辑都是外科手术式的要么写入独立文件要么在共享文件中AGENTS.md、global_rules.md、hooks.json维护一段带围栏标记的托管块。共享块由!-- HINDSIGHT:BEGIN --与!-- HINDSIGHT:END --围栏界定见 managed_block.py更新与卸载均可幂等执行绝不触碰你自行编写的内容Cascade 的专属规则文件则以哨兵注释!-- Managed by hindsight-devin-desktop --标记归属见 rules.py。Devin Local 的 Hook确定性的记忆加载与沉淀MCP 工具 规则本质上是模型驱动的——Agent 之所以回忆/沉淀是因为规则告诉它这么做。对于 Devin Localinit额外添加两个 Hook可用--no-hooks同时关掉SessionStart自动回忆在每个会话开始时回忆项目记忆 用户全局记忆并注入 Agent 上下文。即使模型忘记调用recall相关记忆也会被加载它总是报告状态已加载 N 条 / 空 / 不可用记忆的使用永远不会是静默的且绝不会阻塞会话。Stop沉淀提醒在 Agent 停止前强制执行一次 retain由模型判断哪些是持久事实并调用retain。带循环保护每个会话多花费一个回合可用--no-retain-hook单独关闭。从 hook.py 的源码可以看到这两个 Hook 的实现细节recall子命令从 Devin Local 的config.json读取连接信息从DEVIN_PROJECT_DIR环境变量推导项目银行通过标准库urllib直接发起 MCP 调用initialize→tools/call recall把结果以hookSpecificOutput.additionalContext的形式输出由 Devin 注入 Agent 上下文固定查询词为Key architecture, decisions, conventions, and the users preferences and coding style for this work.max_tokens为 1024retain-nudge子命令返回{decision: block, reason: ...}阻止会话直接结束迫使模型先执行 retain并通过stop_hook_active标志防止无限循环两个 Hook 都从不以非零状态退出任何异常超时、网络错误、坏响应都会降级为不可用状态报告绝不破坏会话。为什么不做全自动 retainDevin 的 Hook 无法把会话转录文本交给脚本所以 Hook 无法自行总结并沉淀——nudge 是当前最接近确定性的方案触发有保证内容由模型撰写。Cascade 则两种 Hook 都无法使用其 Hook 不能注入上下文所以 Cascade 的 recall/retain 保持模型驱动但init会添加一个post_mcp_tool_use横幅show_output: true让每次 Hindsight: tool used都清晰可见见 cascade_hooks.py。双层记忆全局银行 项目银行记忆被拆分到两个 Hindsight银行互相隔离的记忆作用域中避免项目之间的记忆互相污染全局银行默认devin-desktop——跨项目的个人记忆偏好、编码风格、你的身份。在所有项目中共享。项目银行devin-desktop-slug——当前仓库的记忆架构、决策、约定。slug由仓库的git remote派生而来见 project.py因此在不同的机器、克隆和检出路径下都保持稳定且对团队成员完全一致——团队自然共享同一个项目银行。slug 派生优先级git remote优先跨机器稳定且团队一致→ git 仓库文件夹名 → 当前文件夹名结果统一为global-slug格式使项目银行归组在全局银行之下且永不与它冲突。MCP 服务器运行在多银行模式单个端点路径以/mcp/结尾见 mcp_config.py 中的mcp_endpoint_urlalways-on 规则告诉 Agent 何时使用哪个bank_id任务开始时同时 recall 两个银行项目事实 retain 到项目银行、用户事实 retain 到全局银行。同时X-Bank-Idheader 把全局银行指定为模型省略bank_id时的默认银行。Cascade 侧生成的 MCP 配置形如{ mcpServers: { hindsight: { serverUrl: https://api.hindsight.vectorize.io/mcp/, headers: { Authorization: Bearer hsk_..., X-Bank-Id: devin-desktop } } } }Devin Local 侧的条目使用urltransport: http字段远程服务器 schema 与 Cascade 的serverUrl不同并在permissions.allow中预置mcp__hindsight__*放行规则使 recall/retain 无需确认即可自动运行。关闭共享层--no-global-bank如果你不希望个人偏好跟随你跨仓库流动传入--no-global-bank进入仅本机模式所有内容——项目事实和你的偏好——都留在该仓库的项目银行中不共享任何内容也不写入全局规则文件。适合隔离工作机与个人机或不需要共享个人画像的场景。命令参考命令说明hindsight-devin-desktop init接入两个 Agent 的 MCP 服务器 记忆规则自动派生项目银行hindsight-devin-desktop status显示已解析的银行 每个 Agent 的配置状态hindsight-devin-desktop uninstall从两个 Agent 中移除 MCP 服务器 记忆规则init完整参数参数作用默认值--api-urlHindsight API 地址https://api.hindsight.vectorize.io云服务--api-tokenAPI token云服务必填无--bank-id覆盖项目银行默认从 git 派生由 git remote 派生--global-bank跨项目全局银行devin-desktop--print-only只打印待手动粘贴的配置不写任何文件关--no-hooks同时跳过 Devin Local 的两个 Hook开Hook 默认启用--no-retain-hook跳过 Stop 沉淀提醒保留自动回忆关--no-global-bank仅本机模式所有记忆留在项目银行关init在仓库内运行时会从 git remote 派生项目银行然后同时写入两个 AgentMCP 服务器条目、项目规则请把./.devin/rules/hindsight.md与./AGENTS.md提交进版本库让团队成员共享项目银行以及全局规则。完成后还需要在所用 Agent 中激活服务器配置不会热重载Cascade——打开 MCP 面板点击RefreshDevin Local——打开Devin MCP Marketplace在Installed下找到hindsight点击Connect。不确定自己在用哪个 Agent看 Devin Desktop 右下角的agent selector。配置文件与环境变量配置按后加载者优先的顺序解析内置默认值 →~/.hindsight/devin-desktop.json用户配置文件 → 环境变量见 config.py。注意用户配置文件只持久化连接信息与全局银行项目银行永远不会写入全局配置——它是每个仓库独立派生的并被烘焙进该仓库已提交的规则文件中。配置项环境变量默认值API 地址HINDSIGHT_API_URLhttps://api.hindsight.vectorize.ioAPI tokenHINDSIGHT_API_TOKEN无云服务必填全局银行HINDSIGHT_DEVIN_DESKTOP_GLOBAL_BANKdevin-desktop项目银行HINDSIGHT_DEVIN_DESKTOP_BANK_ID由 git remote 派生用户配置文件~/.hindsight/devin-desktop.json的键为hindsightApiUrl/hindsightApiToken/globalBank其中旧版的bankId键会被映射为全局银行保证 pre-0.2 时代的单银行配置无缝升级。验证集成是否生效开始一个会话你会看到记忆已开启——没有任何环节是静默的Devin Local——回复会以状态行开头例如 Hindsight preloaded 3 memories for this session或no memory yet、⚠️ memory unavailable this session。每次 Hook 运行还会记录到~/.hindsight/devin-hook.log可据此确认 recall/retain Hook 是否触发Cascade——每次recall/retain显示为工具卡片展开post-tool hooks行可以看到 Hindsight: tool used横幅hindsight-devin-desktop status会逐个列出两个 Agent 的每个组件是否已安装以及解析出的银行。工作原理小结与设计取舍recall 和 retain 通过 Agent 调用的 MCP 工具完成由 always-on 规则引导。这意味着 recall 是查询时刻精确的无滞后——记忆在需要时按真实消息实时检索其代价是它依赖 Agent 遵循先回忆的指令而非编辑器强制执行。Devin Local 的SessionStart/StopHook 正是为弥补这一不确定性而生自动回忆保证基线记忆必然注入沉淀提醒保证会话结束时必然有一次 retain 机会而记忆内容的质量仍由模型判断。仓库中的测试套件覆盖了上述全部行为见 tests/运行方式为uv sync uv run pytest tests -v -m not requires_real_llm # 确定性测试套件 uv run pytest tests -v -m requires_real_llm # 需真实 MCP 端点的门控检查完整的配置选项还可参考集成包的 README.md。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
