2. Linux.do
  3. [开源推广] /trans新插件：让 Claude Code 拥有跨会话记忆。

[开源推广] /trans新插件：让 Claude Code 拥有跨会话记忆。

绎袅 2026-07-15 06:44 1

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：



  • 我的帖子已经打上 开源推广 标签： 是

  • 我的开源项目完整开源，无未开源部分： 是

  • 我的开源项目已链接认可 LINUX DO 社区： 是

  • 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

  • 以上选择我承诺是永久有效的，接受社区和佬友监督： 是


以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出



项目地址:




为啥要做这个？


ClaudeCode只支持用–resume恢复会话，并且你睡玩个觉回来(就是本人)，你要是直接resume恢复会话，那你的缓存创建费用直接起飞


要么开启一个干净的新会话，此时AI将上下文忘得一干二净



如图，类似问题



这个项目能解决什么问题？


问题一：记忆错乱


现象：“上个月那个Merge 冲突，你是用什么正则解的来着？”就像刚刚说的做这个的原因，除非你把进度和内容扔进记忆库里随时动


解决办法：trans_search（trans skills的一部分）


它给 Claude Code 混合检索（向量+关键词融合 RRF） 的能力。你在当前聊天里随口一问，Claude 自己会调用 MCP Tool (trans_search / trans_scan) 去翻找历史会话，快速定位所在会话及行数，并给你需要的答案


如果想要最好效果（100%触发），建议直接在新会话开始时/trans


效果图：



痛点二：会话续接


现象：会话断掉后，重新开新会话，Claude只能通过当前工作区文件，部分记忆和当前工作区进行理想还原，部分细节全部忘光


解决办法：trans插件全自动hook，如果用户提出一个先前的相关细节，trans会通过UserPromptSubmit Hook给 AI 注入一个提示。


AI 会自己决定是否调用底层的 5 个 MCP Tools（trans_search, trans_scan, trans_expand 等）去翻找记忆，然后给你答案。你只需等待



  • 如果有人对hook敏感，介意勿用





配置 Embedding 详细教程

你需要什么


一个 OpenAI 兼容的 embedding API 端点：



  • Silicon Flow、智谱、阿里云百炼、火山引擎（免费应该 也够用）

  • 自建的 vLLM / LocalAI / Ollama（带 /v1/embeddings 端点）

  • 站内https://router.tumuer.me/



最简单方式：扔给AI，仓库有提示词


或者


cd “$env:USERPROFILE.claude\\skills\\trans” 

node scripts/write-config.mjs

脚本会问你三个问题：


[1] 纯关键词（零 API，只支持 exact 查询）

[2] 远程 API（填端点+key，支持混合/语义/精排）

[3] 本地 ONNX 模型（全离线，需自备模型文件）


如果你选择了远程API：


会要求输入



  • Base URL (以 /v1 结尾)

  • API Key

  • Embedding(嵌入) 模型

  • Rerank（重排） 模型

  • 维度


之后会自动进行连通性测试


当然，如果你选 1 的话什么都不用干，直接能用 --exact 模式



配置完后你可以做的验证：


建索引（以后是增量创建，但是首次会处理所有历史会话）

node scripts/semantic.mjs index


尝试一下

node scripts/semantic.mjs query “你印象最深的那个 bug”


看索引状态

node scripts/semantic.mjs status


首次 index 会把所有历史会话切块+嵌入，700 块大概 50 万 token 输入



不配 embedding 也能用的功能


1, /trans 会话续接（trans_scan）


2, trans_list 列出候选会话


3, trans_expand 展开上下文


4, trans_search --exact 关键词搜索


不配 embedding 你就少了模糊语义搜索，其他功能全部正常。



关于其他：


问"昨天天气"不误触发：



这个由hook完成，当发现有词属于此范围,会提示AI（插入内容）根据上下文分析是否需要启用/trans


最后希望各位佬能点点star！第一次发在L站 ，有啥问题都可以提


最后的感谢


非常感谢佬提供的语义向量模型！@unsafe

以及可能给此项目提各种建议的各位佬！

最新回复 (2)
  • 第五人偶 07-15 07:05
    1楼

    前排支持佬一波，但是没在帖子里看到项目地址或者源码在哪 ^-^

  • 绎袅 楼主 07-15 07:07
    3楼

    额，忘了，现在补上，谢谢提醒 我就说咋没审核

* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐