Claude Subconscious如何实现永不阻塞异步Hook模式完整深度分析【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude Subconscious是一款为 Claude Code 打造的后台记忆代理插件它在后台默默观察你的每一次会话、读取你的代码库、构建跨会话的长期记忆并在你下次提问前低语回有用的上下文。它最打动人的设计承诺是——永不阻塞Never Blocks无论后台代理做多重的记忆整理你敲下的每一个命令、每一次工具调用都零等待。本文将带你完整拆解它背后的异步 Hook 模式看懂主 Hook 秒退 后台 Worker 独立干活这套经典双进程架构。 先搞懂问题为什么 Hook 会卡住你Claude Code 的插件可以在四个关键时机挂接钩子Hook会话开始、提交提示词前、调用工具前、响应结束Stop。如果钩子里直接执行读取完整对话记录 → 调 API → 等待代理返回这种重活你的每次收尾都会干等几十秒甚至更久。Claude Subconscious 的解法是把它注册在hooks/hooks.json中的 Stop 钩子标记为async: true——告诉 Claude Code这个钩子不用等它跑完再配合一套文件交接 独立进程的机制把真正耗时的 SDK 会话彻底甩到后台。四个钩子的职责与耗时预算一目了然Hook脚本超时作用SessionStartsession_start.ts5s通知代理新会话、清理遗留状态UserPromptSubmitsync_letta_memory.ts10s把记忆块与低语消息注入上下文PreToolUsepretool_sync.ts5s工具调用前同步最新提示Stopsend_messages_to_letta.ts120sasync异步派发把对话记录交给后台 Worker 前三个钩子都是轻查询、快注入只有 Stop 钩子涉及繁重的记忆处理也正是异步模式的主战场。️ 核心架构Stop 钩子的两级流水线整个异步链路可以概括为一句话主进程只负责打包和发车后台 Worker 负责长途运输。第一级Stop 钩子——只做秒级准备当 Claude 完成一次响应send_messages_to_letta.ts 被触发它依次完成五件快速的事解析对话记录读取会话的 JSONL 转录文件提取用户消息、助手回复、思考块与工具调用增量判断依据上次处理到的索引lastProcessedIndex只挑出新增消息避免重复发送绑定会话获取或创建该 Claude Code 会话对应的 Letta 对话conversation打包载荷把待发送内容写入临时 payload 文件如payload-{sessionId}-{时间戳}.json点火即走调用spawnSilentWorker启动后台 Worker随即退出。关键就在第 5 步。Worker 以detached: true脱离父进程stdio: ignore方式启动再对子进程句柄执行child.unref()——这意味着主 Hook 不持有对 Worker 的任何等待Node 事件循环不会因它而停留主进程毫秒级退出。第二级后台 Worker——独立进程慢慢干send_worker_sdk.ts 被独立进程拉起后才真正执行重活通过 Letta Code SDK 的resumeSession恢复已有对话见 send_worker_sdk.ts把打包好的转录内容发给 Subconscious 代理代理在后台可以使用 Read / Grep / Glob 工具真实地读你的代码库、更新 8 个记忆块用户偏好、项目上下文、待办事项等流式接收代理响应后把lastProcessedIndex回写到状态文件并删除临时 payload 文件完成收尾。三级交接为什么用文件而不是直接传参两个进程之间的交接全靠一个payload 文件写入逻辑这个设计有三个妙处解耦启动与执行主进程只写文件、传路径Worker 崩溃也不会拖累已退出的主进程天然可恢复状态文件先于 Worker 持久化L181-L182即使 Worker 失败下次 Stop 时增量索引也不会错乱跨平台统一不依赖管道或共享内存Windows、macOS、Linux 行为一致。 Windows 用户特别关心静默执行后台进程在 Windows 上有个经典麻烦——命令行窗口一闪一闪。这个项目给出了完整的工程化答案所有钩子统一经由 silent-npx.cjs 启动它是一个跨平台静默启动器Windows 下它调用 silent-launcher.exe由 SilentLauncher.cs 编译利用PseudoConsoleConPTY CREATE_NO_WINDOW标志彻底消除窗口闪现Worker 还获得了独立的伪控制台即使主启动器的控制台被关闭后台任务依然存活。 状态与可观测性出问题了去哪找所有状态分两层存放方便你排障持久状态项目目录.letta/claude/conversations.json记录会话 ID → 对话 ID映射session-{id}.json记录每个会话的处理进度——这是记账本不是独立代理所有项目共享同一个 Subconscious 大脑临时日志$TMPDIR/letta-claude-sync-$UID/send_messages.log对应主 Hooksend_worker_sdk.log对应后台 Worker。排查钩子是否正常运行盯住这两份日志即可tail -f /tmp/letta-claude-sync-$(id -u)/send_messages.log tail -f /tmp/letta-claude-sync-$(id -u)/send_worker_sdk.log 快速上手三步启用你的潜意识1️⃣ 安装插件在 Claude Code 内执行/plugin marketplace add letta-ai/claude-subconscious /plugin install claude-subconsciousclaude-subconscious2️⃣ 配置 API Key从 app.letta.com 获取export LETTA_API_KEYyour-api-key3️⃣ 按需调整行为LETTA_MODEwhisper默认只注入消息/full注入记忆块消息/off关闭LETTA_SDK_TOOLSread-only默认/full后台可改代码/off纯聆听首次使用时插件会自动导入内置的 Subconscious.af 代理零额外配置。想从源码安装git clone仓库后执行npm install再/plugin enable .即可。✅ 总结这套永不阻塞设计学到了什么Claude Subconscious 的异步 Hook 模式本质是把三个工程原则组合成了一拳原则实现主路径永远快Stop 钩子只做解析、打包、发车毫秒级退出 async: true声明重活交给独立进程detached启动 unref()Worker 生灭与主进程完全解耦用文件做安全交接payload 文件传参、状态文件先行持久化崩溃不丢进度这套秒退主进程 持久化载荷 静默后台 Worker的组合拳是任何需要在交互工具里挂载耗时后台任务的插件开发者的教科书级参考。而它带来的用户体验就是那句承诺Sub 在后台越用越聪明你却永远感觉不到它的存在。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考