[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-thedotmack--claude-mem":3,"tool-thedotmack--claude-mem":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":78,"owner_location":78,"owner_email":78,"owner_twitter":79,"owner_website":78,"owner_url":80,"languages":81,"stars":101,"forks":102,"last_commit_at":103,"license":104,"difficulty_score":23,"env_os":105,"env_gpu":106,"env_ram":106,"env_deps":107,"category_tags":114,"github_topics":115,"view_count":136,"oss_zip_url":78,"oss_zip_packed_at":78,"status":16,"created_at":137,"updated_at":138,"faqs":139,"releases":140},3928,"thedotmack\u002Fclaude-mem","claude-mem","A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.","claude-mem 是一款专为 Claude Code 设计的智能记忆增强插件，旨在解决 AI 编程助手在长周期开发中“遗忘”上下文的问题。在传统工作流中，每次开启新的对话会话，AI 往往需要重新了解项目背景、之前的决策逻辑以及已完成的进度，导致重复沟通效率低下。\n\n这款工具通过自动捕获用户在编码会话中的所有交互细节，利用 AI 代理（基于 Claude agent-sdk）对海量信息进行智能压缩与提炼，将关键的项目上下文转化为紧凑的记忆存储。当用户开启新的会话时，claude-mem 会自动将这些经过提炼的背景知识注入其中，让 AI 仿佛拥有“长期记忆”，能够无缝衔接之前的工作进度，无需用户反复重申需求或背景。\n\n它特别适合频繁使用 Claude Code 进行复杂项目开发、系统重构或长期维护的开发者。对于需要跨越多个会话保持逻辑连贯性的科研编程人员或技术团队而言，它能显著减少上下文切换带来的认知负荷。其核心技术亮点在于“动态压缩”机制：不是简单记录流水账，而是主动理解并提炼高价值信息，既保证了记忆的准确性，又有效控制了上下文长度，让 AI 始终保持敏锐且专注的状态。","\u003Ch1 align=\"center\">\n  \u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Fclaude-mem-logo-for-dark-mode.webp\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_5293041de32b.webp\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_5293041de32b.webp\" alt=\"Claude-Mem\" width=\"400\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n  \u003Cbr>\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.zh.md\">🇨🇳 中文\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.zh-tw.md\">🇹🇼 繁體中文\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ja.md\">🇯🇵 日本語\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pt.md\">🇵🇹 Português\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pt-br.md\">🇧🇷 Português\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ko.md\">🇰🇷 한국어\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.es.md\">🇪🇸 Español\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.de.md\">🇩🇪 Deutsch\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.fr.md\">🇫🇷 Français\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.he.md\">🇮🇱 עברית\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ar.md\">🇸🇦 العربية\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ru.md\">🇷🇺 Русский\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pl.md\">🇵🇱 Polski\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.cs.md\">🇨🇿 Čeština\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.nl.md\">🇳🇱 Nederlands\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.tr.md\">🇹🇷 Türkçe\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.uk.md\">🇺🇦 Українська\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.vi.md\">🇻🇳 Tiếng Việt\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.tl.md\">🇵🇭 Tagalog\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.id.md\">🇮🇩 Indonesia\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.th.md\">🇹🇭 ไทย\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.hi.md\">🇮🇳 हिन्दी\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.bn.md\">🇧🇩 বাংলা\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ur.md\">🇵🇰 اردو\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ro.md\">🇷🇴 Română\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.sv.md\">🇸🇪 Svenska\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.it.md\">🇮🇹 Italiano\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.el.md\">🇬🇷 Ελληνικά\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.hu.md\">🇭🇺 Magyar\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.fi.md\">🇫🇮 Suomi\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.da.md\">🇩🇰 Dansk\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.no.md\">🇳🇴 Norsk\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch4 align=\"center\">Persistent memory compression system built for \u003Ca href=\"https:\u002F\u002Fclaude.com\u002Fclaude-code\" target=\"_blank\">Claude Code\u003C\u002Fa>.\u003C\u002Fh4>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL%203.0-blue.svg\" alt=\"License\">\n  \u003C\u002Fa>\n  \u003Ca href=\"package.json\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-6.5.0-green.svg\" alt=\"Version\">\n  \u003C\u002Fa>\n  \u003Ca href=\"package.json\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-brightgreen.svg\" alt=\"Node\">\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fawesome-claude-code\">\n    \u003Cimg src=\"https:\u002F\u002Fawesome.re\u002Fmentioned-badge.svg\" alt=\"Mentioned in Awesome Claude Code\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15496\" target=\"_blank\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge-dark.svg\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge.svg\">\n      \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge.svg\" alt=\"thedotmack\u002Fclaude-mem | Trendshift\" width=\"250\" height=\"55\"\u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\">\n        \u003Cpicture>\n          \u003Cimg\n            src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_16e0630dc352.gif\"\n            alt=\"Claude-Mem Preview\"\n            width=\"500\"\n          >\n        \u003C\u002Fpicture>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#thedotmack\u002Fclaude-mem&Date\">\n        \u003Cpicture>\n          \u003Csource\n            media=\"(prefers-color-scheme: dark)\"\n            srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=thedotmack\u002Fclaude-mem&type=date&theme=dark&legend=top-left\"\n          \u002F>\n          \u003Csource\n            media=\"(prefers-color-scheme: light)\"\n            srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_d795fa26358d.png\"\n          \u002F>\n          \u003Cimg\n            alt=\"Star History Chart\"\n            src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_d795fa26358d.png\"\n            width=\"500\"\n          \u002F>\n        \u003C\u002Fpicture>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#quick-start\">Quick Start\u003C\u002Fa> •\n  \u003Ca href=\"#how-it-works\">How It Works\u003C\u002Fa> •\n  \u003Ca href=\"#mcp-search-tools\">Search Tools\u003C\u002Fa> •\n  \u003Ca href=\"#documentation\">Documentation\u003C\u002Fa> •\n  \u003Ca href=\"#configuration\">Configuration\u003C\u002Fa> •\n  \u003Ca href=\"#troubleshooting\">Troubleshooting\u003C\u002Fa> •\n  \u003Ca href=\"#license\">License\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  Claude-Mem seamlessly preserves context across sessions by automatically capturing tool usage observations, generating semantic summaries, and making them available to future sessions. This enables Claude to maintain continuity of knowledge about projects even after sessions end or reconnect.\n\u003C\u002Fp>\n\n---\n\n## Quick Start\n\nInstall with a single command:\n\n```bash\nnpx claude-mem install\n```\n\nOr install for Gemini CLI (auto-detects `~\u002F.gemini`):\n\n```bash\nnpx claude-mem install --ide gemini-cli\n```\n\nOr install from the plugin marketplace inside Claude Code:\n\n```bash\n\u002Fplugin marketplace add thedotmack\u002Fclaude-mem\n\n\u002Fplugin install claude-mem\n```\n\nRestart Claude Code or Gemini CLI. Context from previous sessions will automatically appear in new sessions.\n\n> **Note:** Claude-Mem is also published on npm, but `npm install -g claude-mem` installs the **SDK\u002Flibrary only** — it does not register the plugin hooks or set up the worker service. Always install via `npx claude-mem install` or the `\u002Fplugin` commands above.\n\n### 🦞 OpenClaw Gateway\n\nInstall claude-mem as a persistent memory plugin on [OpenClaw](https:\u002F\u002Fopenclaw.ai) gateways with a single command:\n\n```bash\ncurl -fsSL https:\u002F\u002Finstall.cmem.ai\u002Fopenclaw.sh | bash\n```\n\nThe installer handles dependencies, plugin setup, AI provider configuration, worker startup, and optional real-time observation feeds to Telegram, Discord, Slack, and more. See the [OpenClaw Integration Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fopenclaw-integration) for details.\n\n**Key Features:**\n\n- 🧠 **Persistent Memory** - Context survives across sessions\n- 📊 **Progressive Disclosure** - Layered memory retrieval with token cost visibility\n- 🔍 **Skill-Based Search** - Query your project history with mem-search skill\n- 🖥️ **Web Viewer UI** - Real-time memory stream at http:\u002F\u002Flocalhost:37777\n- 💻 **Claude Desktop Skill** - Search memory from Claude Desktop conversations\n- 🔒 **Privacy Control** - Use `\u003Cprivate>` tags to exclude sensitive content from storage\n- ⚙️ **Context Configuration** - Fine-grained control over what context gets injected\n- 🤖 **Automatic Operation** - No manual intervention required\n- 🔗 **Citations** - Reference past observations with IDs (access via http:\u002F\u002Flocalhost:37777\u002Fapi\u002Fobservation\u002F{id} or view all in the web viewer at http:\u002F\u002Flocalhost:37777)\n- 🧪 **Beta Channel** - Try experimental features like Endless Mode via version switching\n\n---\n\n## Documentation\n\n📚 **[View Full Documentation](https:\u002F\u002Fdocs.claude-mem.ai\u002F)** - Browse on official website\n\n### Getting Started\n\n- **[Installation Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Finstallation)** - Quick start & advanced installation\n- **[Gemini CLI Setup](https:\u002F\u002Fdocs.claude-mem.ai\u002Fgemini-cli\u002Fsetup)** - Dedicated guide for Google's Gemini CLI integration\n- **[Usage Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fgetting-started)** - How Claude-Mem works automatically\n- **[Search Tools](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fsearch-tools)** - Query your project history with natural language\n- **[Beta Features](https:\u002F\u002Fdocs.claude-mem.ai\u002Fbeta-features)** - Try experimental features like Endless Mode\n\n### Best Practices\n\n- **[Context Engineering](https:\u002F\u002Fdocs.claude-mem.ai\u002Fcontext-engineering)** - AI agent context optimization principles\n- **[Progressive Disclosure](https:\u002F\u002Fdocs.claude-mem.ai\u002Fprogressive-disclosure)** - Philosophy behind Claude-Mem's context priming strategy\n\n### Architecture\n\n- **[Overview](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Foverview)** - System components & data flow\n- **[Architecture Evolution](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture-evolution)** - The journey from v3 to v5\n- **[Hooks Architecture](https:\u002F\u002Fdocs.claude-mem.ai\u002Fhooks-architecture)** - How Claude-Mem uses lifecycle hooks\n- **[Hooks Reference](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fhooks)** - 7 hook scripts explained\n- **[Worker Service](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fworker-service)** - HTTP API & Bun management\n- **[Database](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fdatabase)** - SQLite schema & FTS5 search\n- **[Search Architecture](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fsearch-architecture)** - Hybrid search with Chroma vector database\n\n### Configuration & Development\n\n- **[Configuration](https:\u002F\u002Fdocs.claude-mem.ai\u002Fconfiguration)** - Environment variables & settings\n- **[Development](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment)** - Building, testing, contributing\n- **[Troubleshooting](https:\u002F\u002Fdocs.claude-mem.ai\u002Ftroubleshooting)** - Common issues & solutions\n\n---\n\n## How It Works\n\n**Core Components:**\n\n1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)\n2. **Smart Install** - Cached dependency checker (pre-hook script, not a lifecycle hook)\n3. **Worker Service** - HTTP API on port 37777 with web viewer UI and 10 search endpoints, managed by Bun\n4. **SQLite Database** - Stores sessions, observations, summaries\n5. **mem-search Skill** - Natural language queries with progressive disclosure\n6. **Chroma Vector Database** - Hybrid semantic + keyword search for intelligent context retrieval\n\nSee [Architecture Overview](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Foverview) for details.\n\n---\n\n## MCP Search Tools\n\nClaude-Mem provides intelligent memory search through **4 MCP tools** following a token-efficient **3-layer workflow pattern**:\n\n**The 3-Layer Workflow:**\n\n1. **`search`** - Get compact index with IDs (~50-100 tokens\u002Fresult)\n2. **`timeline`** - Get chronological context around interesting results\n3. **`get_observations`** - Fetch full details ONLY for filtered IDs (~500-1,000 tokens\u002Fresult)\n\n**How It Works:**\n- Claude uses MCP tools to search your memory\n- Start with `search` to get an index of results\n- Use `timeline` to see what was happening around specific observations\n- Use `get_observations` to fetch full details for relevant IDs\n- **~10x token savings** by filtering before fetching details\n\n**Available MCP Tools:**\n\n1. **`search`** - Search memory index with full-text queries, filters by type\u002Fdate\u002Fproject\n2. **`timeline`** - Get chronological context around a specific observation or query\n3. **`get_observations`** - Fetch full observation details by IDs (always batch multiple IDs)\n\n**Example Usage:**\n\n```typescript\n\u002F\u002F Step 1: Search for index\nsearch(query=\"authentication bug\", type=\"bugfix\", limit=10)\n\n\u002F\u002F Step 2: Review index, identify relevant IDs (e.g., #123, #456)\n\n\u002F\u002F Step 3: Fetch full details\nget_observations(ids=[123, 456])\n```\n\nSee [Search Tools Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fsearch-tools) for detailed examples.\n\n---\n\n## Beta Features\n\nClaude-Mem offers a **beta channel** with experimental features like **Endless Mode** (biomimetic memory architecture for extended sessions). Switch between stable and beta versions from the web viewer UI at http:\u002F\u002Flocalhost:37777 → Settings.\n\nSee **[Beta Features Documentation](https:\u002F\u002Fdocs.claude-mem.ai\u002Fbeta-features)** for details on Endless Mode and how to try it.\n\n---\n\n## System Requirements\n\n- **Node.js**: 18.0.0 or higher\n- **Claude Code**: Latest version with plugin support\n- **Bun**: JavaScript runtime and process manager (auto-installed if missing)\n- **uv**: Python package manager for vector search (auto-installed if missing)\n- **SQLite 3**: For persistent storage (bundled)\n\n---\n### Windows Setup Notes\n\nIf you see an error like:\n\n```powershell\nnpm : The term 'npm' is not recognized as the name of a cmdlet\n```\n\nMake sure Node.js and npm are installed and added to your PATH. Download the latest Node.js installer from https:\u002F\u002Fnodejs.org and restart your terminal after installation.\n\n---\n\n## Configuration\n\nSettings are managed in `~\u002F.claude-mem\u002Fsettings.json` (auto-created with defaults on first run). Configure AI model, worker port, data directory, log level, and context injection settings.\n\nSee the **[Configuration Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fconfiguration)** for all available settings and examples.\n\n---\n\n## Development\n\nSee the **[Development Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment)** for build instructions, testing, and contribution workflow.\n\n---\n\n## Troubleshooting\n\nIf experiencing issues, describe the problem to Claude and the troubleshoot skill will automatically diagnose and provide fixes.\n\nSee the **[Troubleshooting Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Ftroubleshooting)** for common issues and solutions.\n\n---\n\n## Bug Reports\n\nCreate comprehensive bug reports with the automated generator:\n\n```bash\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fthedotmack\nnpm run bug-report\n```\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes with tests\n4. Update documentation\n5. Submit a Pull Request\n\nSee [Development Guide](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment) for contribution workflow.\n\n---\n\n## License\n\nThis project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0).\n\nCopyright (C) 2025 Alex Newman (@thedotmack). All rights reserved.\n\nSee the [LICENSE](LICENSE) file for full details.\n\n**What This Means:**\n\n- You can use, modify, and distribute this software freely\n- If you modify and deploy on a network server, you must make your source code available\n- Derivative works must also be licensed under AGPL-3.0\n- There is NO WARRANTY for this software\n\n**Note on Ragtime**: The `ragtime\u002F` directory is licensed separately under the **PolyForm Noncommercial License 1.0.0**. See [ragtime\u002FLICENSE](ragtime\u002FLICENSE) for details.\n\n---\n\n## Support\n\n- **Documentation**: [docs\u002F](docs\u002F)\n- **Issues**: [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\u002Fissues)\n- **Repository**: [github.com\u002Fthedotmack\u002Fclaude-mem](https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem)\n- **Official X Account**: [@Claude_Memory](https:\u002F\u002Fx.com\u002FClaude_Memory)\n- **Official Discord**: [Join Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FJ4wttp9vDu)\n- **Author**: Alex Newman ([@thedotmack](https:\u002F\u002Fgithub.com\u002Fthedotmack))\n\n---\n\n**Built with Claude Agent SDK** | **Powered by Claude Code** | **Made with TypeScript**\n\n---\n\n### What About $CMEM?\n\n$CMEM is a solana token created by a 3rd party without Claude-Mem's prior consent, but officially embraced by the creator of Claude-Mem (Alex Newman, @thedotmack). The token acts as a community catalyst for growth and a vehicle for bringing real-time agent data to the developers and knowledge workers that need it most. $CMEM: 2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS\n","\u003Ch1 align=\"center\">\n  \u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Fclaude-mem-logo-for-dark-mode.webp\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_5293041de32b.webp\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_5293041de32b.webp\" alt=\"Claude-Mem\" width=\"400\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n  \u003Cbr>\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.zh.md\">🇨🇳 中文\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.zh-tw.md\">🇹🇼 繁體中文\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ja.md\">🇯🇵 日本語\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pt.md\">🇵🇹 Português\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pt-br.md\">🇧🇷 Português\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ko.md\">🇰🇷 한국어\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.es.md\">🇪🇸 Español\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.de.md\">🇩🇪 Deutsch\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.fr.md\">🇫🇷 Français\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.he.md\">🇮🇱 עברית\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ar.md\">🇸🇦 العربية\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ru.md\">🇷🇺 Русский\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.pl.md\">🇵🇱 Polski\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.cs.md\">🇨🇿 Čeština\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.nl.md\">🇳🇱 Nederlands\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.tr.md\">🇹🇷 Türkçe\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.uk.md\">🇺🇦 Українська\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.vi.md\">🇻🇳 Tiếng Việt\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.tl.md\">🇵🇭 Tagalog\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.id.md\">🇮🇩 Indonesia\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.th.md\">🇹🇭 ไทย\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.hi.md\">🇮🇳 हिन्दी\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.bn.md\">🇧🇩 বাংলা\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ur.md\">🇵🇰 اردو\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.ro.md\">🇷🇴 Română\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.sv.md\">🇸🇪 Svenska\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.it.md\">🇮🇹 Italiano\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.el.md\">🇬🇷 Ελληνικά\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.hu.md\">🇭🇺 Magyar\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.fi.md\">🇫🇮 Suomi\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.da.md\">🇩🇰 Dansk\u003C\u002Fa> •\n  \u003Ca href=\"docs\u002Fi18n\u002FREADME.no.md\">🇳🇴 Norsk\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch4 align=\"center\">专为\u003Ca href=\"https:\u002F\u002Fclaude.com\u002Fclaude-code\" target=\"_blank\">Claude Code\u003C\u002Fa>打造的持久化内存压缩系统。\u003C\u002Fh4>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL%203.0-blue.svg\" alt=\"License\">\n  \u003C\u002Fa>\n  \u003Ca href=\"package.json\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-6.5.0-green.svg\" alt=\"Version\">\n  \u003C\u002Fa>\n  \u003Ca href=\"package.json\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-brightgreen.svg\" alt=\"Node\">\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fawesome-claude-code\">\n    \u003Cimg src=\"https:\u002F\u002Fawesome.re\u002Fmentioned-badge.svg\" alt=\"Mentioned in Awesome Claude Code\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15496\" target=\"_blank\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge-dark.svg\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge.svg\">\n      \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fthedotmack\u002Fclaude-mem\u002Fmain\u002Fdocs\u002Fpublic\u002Ftrendshift-badge.svg\" alt=\"thedotmack\u002Fclaude-mem | Trendshift\" width=\"250\" height=\"55\"\u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n\u003Ctable align=\"center\">\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\">\n        \u003Cpicture>\n          \u003Cimg\n            src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_16e0630dc352.gif\"\n            alt=\"Claude-Mem Preview\"\n            width=\"500\"\n          >\n        \u003C\u002Fpicture>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#thedotmack\u002Fclaude-mem&Date\">\n        \u003Cpicture>\n          \u003Csource\n            media=\"(prefers-color-scheme: dark)\"\n            srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=thedotmack\u002Fclaude-mem&type=date&theme=dark&legend=top-left\"\n          \u002F>\n          \u003Csource\n            media=\"(prefers-color-scheme: light)\"\n            srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_d795fa26358d.png\"\n          \u002F>\n          \u003Cimg\n            alt=\"Star History Chart\"\n            src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_readme_d795fa26358d.png\"\n            width=\"500\"\n          \u002F>\n        \u003C\u002Fpicture>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#quick-start\">快速入门\u003C\u002Fa> •\n  \u003Ca href=\"#how-it-works\">工作原理\u003C\u002Fa> •\n  \u003Ca href=\"#mcp-search-tools\">搜索工具\u003C\u002Fa> •\n  \u003Ca href=\"#documentation\">文档\u003C\u002Fa> •\n  \u003Ca href=\"#configuration\">配置\u003C\u002Fa> •\n  \u003Ca href=\"#troubleshooting\">故障排除\u003C\u002Fa> •\n  \u003Ca href=\"#license\">许可证\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  Claude-Mem 通过自动捕获工具使用记录、生成语义摘要，并将其提供给后续会话，从而在不同会话之间无缝保留上下文。这使得 Claude 即使在会话结束或重新连接后，仍能保持对项目的知识连续性。\n\u003C\u002Fp>\n\n---\n\n## 快速入门\n\n只需一条命令即可安装：\n\n```bash\nnpx claude-mem install\n```\n\n或者为 Gemini CLI 安装（会自动检测 `~\u002F.gemini`）：\n\n```bash\nnpx claude-mem install --ide gemini-cli\n```\n\n也可以从 Claude Code 内的插件市场安装：\n\n```bash\n\u002Fplugin marketplace add thedotmack\u002Fclaude-mem\n\n\u002Fplugin install claude-mem\n```\n\n重启 Claude Code 或 Gemini CLI。之前会话的上下文将自动出现在新会话中。\n\n> **注意：** Claude-Mem 也已发布在 npm 上，但运行 `npm install -g claude-mem` 只会安装 **SDK\u002F库** — 它不会注册插件钩子或设置工作服务。请务必通过 `npx claude-mem install` 或上述 `\u002Fplugin` 命令进行安装。\n\n### 🦞 OpenClaw 网关\n\n只需一条命令，即可在 [OpenClaw](https:\u002F\u002Fopenclaw.ai) 网关上将 claude-mem 作为持久化内存插件安装：\n\n```bash\ncurl -fsSL https:\u002F\u002Finstall.cmem.ai\u002Fopenclaw.sh | bash\n```\n\n安装程序会自动处理依赖项、插件设置、AI 提供商配置、工作进程启动，以及可选的实时观测信息推送至 Telegram、Discord、Slack 等平台。详细信息请参阅 [OpenClaw 集成指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fopenclaw-integration)。\n\n**主要特性：**\n\n- 🧠 **持久化内存** - 上下文可在不同会话间持续保留\n- 📊 **渐进式披露** - 分层内存检索，同时显示 token 费用\n- 🔍 **基于技能的搜索** - 使用 mem-search 技能查询项目历史\n- 🖥️ **Web 查看器界面** - 实时内存流，访问地址为 http:\u002F\u002Flocalhost:37777\n- 💻 **Claude Desktop 技能** - 可从 Claude Desktop 对话中直接搜索内存\n- 🔒 **隐私控制** - 使用 `\u003Cprivate>` 标签排除敏感内容的存储\n- ⚙️ **上下文配置** - 细粒度控制注入哪些上下文\n- 🤖 **自动运行** - 无需手动干预\n- 🔗 **引用** - 通过 ID 引用过往观测记录（可通过 http:\u002F\u002Flocalhost:37777\u002Fapi\u002Fobservation\u002F{id} 访问，或在 Web 查看器 http:\u002F\u002Flocalhost:37777 中查看全部）\n- 🧪 **测试通道** - 通过版本切换尝试实验性功能，如无限模式\n\n---\n\n## 文档\n\n📚 **[查看完整文档](https:\u002F\u002Fdocs.claude-mem.ai\u002F)** - 官方网站浏览\n\n### 入门指南\n\n- **[安装指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Finstallation)** - 快速入门与高级安装\n- **[Gemini CLI 设置](https:\u002F\u002Fdocs.claude-mem.ai\u002Fgemini-cli\u002Fsetup)** - 专门针对 Google Gemini CLI 集成的指南\n- **[使用指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fgetting-started)** - Claude-Mem 的自动化工作原理\n- **[搜索工具](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fsearch-tools)** - 用自然语言查询项目历史\n- **[测试功能](https:\u002F\u002Fdocs.claude-mem.ai\u002Fbeta-features)** - 尝试实验性功能，如无限模式\n\n### 最佳实践\n\n- **[上下文工程](https:\u002F\u002Fdocs.claude-mem.ai\u002Fcontext-engineering)** - AI 代理上下文优化原则\n- **[渐进式披露](https:\u002F\u002Fdocs.claude-mem.ai\u002Fprogressive-disclosure)** - Claude-Mem 上下文预热策略的理念\n\n### 架构\n\n- **[概述](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Foverview)** - 系统组件与数据流\n- **[架构演进](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture-evolution)** - 从 v3 到 v5 的发展历程\n- **[钩子架构](https:\u002F\u002Fdocs.claude-mem.ai\u002Fhooks-architecture)** - Claude-Mem 如何使用生命周期钩子\n- **[钩子参考](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fhooks)** - 7 个钩子脚本详解\n- **[工作进程服务](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fworker-service)** - HTTP API 与 Bun 运维管理\n- **[数据库](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fdatabase)** - SQLite 模式与 FTS5 搜索\n- **[搜索架构](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Fsearch-architecture)** - 结合 Chroma 向量数据库的混合搜索\n\n### 配置与开发\n\n- **[配置](https:\u002F\u002Fdocs.claude-mem.ai\u002Fconfiguration)** - 环境变量与设置\n- **[开发](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment)** - 构建、测试、贡献代码\n- **[故障排除](https:\u002F\u002Fdocs.claude-mem.ai\u002Ftroubleshooting)** - 常见问题及解决方案\n\n---\n\n## 工作原理\n\n**核心组件：**\n\n1. **5 个生命周期钩子** - 会话开始、用户提问提交、工具使用后、停止、会话结束（6 个钩子脚本）\n2. **智能安装** - 缓存依赖检查器（前置钩子脚本，非生命周期钩子）\n3. **工作进程服务** - 在端口 37777 上提供 HTTP API 和 Web 查看器界面，包含 10 个搜索接口，由 Bun 管理\n4. **SQLite 数据库** - 存储会话、观测记录和摘要\n5. **mem-search 技能** - 基于自然语言的渐进式披露查询\n6. **Chroma 向量数据库** - 混合语义与关键词搜索，实现智能化上下文检索\n\n详情请参阅 [架构概述](https:\u002F\u002Fdocs.claude-mem.ai\u002Farchitecture\u002Foverview)。\n\n---\n\n## MCP 搜索工具\n\nClaude-Mem 提供智能记忆搜索功能，通过 **4 种 MCP 工具**，遵循一种节省 token 的 **3 层工作流程**：\n\n**3 层工作流程：**\n\n1. **`search`** - 获取紧凑的索引，包含观测 ID（每次结果约 50–100 个 token）\n2. **`timeline`** - 获取围绕感兴趣结果的时间线上下文\n3. **`get_observations`** - 仅对筛选出的 ID 获取完整细节（每次结果约 500–1,000 个 token）\n\n**工作方式：**\n\n- Claude 使用 MCP 工具搜索您的记忆\n- 首先使用 `search` 获取结果索引\n- 再用 `timeline` 查看特定观测或查询周边发生的情况\n- 最后使用 `get_observations` 获取相关 ID 的完整细节\n- **节省约 10 倍 token**，因为会在获取详细信息前先进行过滤\n\n**可用的 MCP 工具：**\n\n1. **`search`** - 使用全文查询搜索记忆索引，并按类型、日期、项目等条件筛选\n2. **`timeline`** - 获取特定观测或查询周边的时间线上下文\n3. **`get_observations`** - 根据 ID 获取完整的观测记录（始终批量处理多个 ID）\n\n**使用示例：**\n\n```typescript\n\u002F\u002F 第一步：搜索索引\nsearch(query=\"authentication bug\", type=\"bugfix\", limit=10)\n\n\u002F\u002F 第二步：审查索引，确定相关 ID（例如 #123、#456）\n\n\u002F\u002F 第三步：获取详细信息\nget_observations(ids=[123, 456])\n```\n\n更多详细示例请参阅 [搜索工具指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fusage\u002Fsearch-tools)。\n\n---\n\n## 测试功能\n\nClaude-Mem 提供一个 **测试通道**，包含实验性功能，如 **无限模式**（仿生记忆架构，适用于长时间会话）。您可以通过 Web 查看器界面 http:\u002F\u002Flocalhost:37777 → 设置，在稳定版和测试版之间切换。\n\n有关无限模式及其使用方法，请参阅 **[测试功能文档](https:\u002F\u002Fdocs.claude-mem.ai\u002Fbeta-features)**。\n\n---\n\n## 系统要求\n\n- **Node.js**：18.0.0 或更高版本\n- **Claude Code**：最新版本，支持插件\n- **Bun**：JavaScript 运行时与进程管理器（若缺失则自动安装）\n- **uv**：用于向量搜索的 Python 包管理器（若缺失则自动安装）\n- **SQLite 3**：用于持久化存储（已打包附带）\n\n---\n### Windows 设置说明\n\n如果您遇到类似以下错误：\n\n```powershell\nnpm : The term 'npm' is not recognized as the name of a cmdlet\n```\n\n请确保已安装 Node.js 和 npm，并将其添加到系统 PATH 中。请从 https:\u002F\u002Fnodejs.org 下载最新版 Node.js 安装程序，安装完成后重启终端。\n\n---\n\n## 配置\n\n设置文件位于 `~\u002F.claude-mem\u002Fsettings.json`（首次运行时会自动生成默认配置）。您可以在此配置 AI 模型、工作进程端口、数据目录、日志级别以及上下文注入设置。\n\n所有可用设置及示例请参阅 **[配置指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fconfiguration)**。\n\n---\n\n## 开发\n\n有关构建说明、测试和贡献流程，请参阅 **[开发指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment)**。\n\n---\n\n## 故障排除\n\n如果遇到问题，请向 Claude 描述问题，故障排除技能将自动诊断并提供修复方案。\n\n常见问题及解决方案请参阅 **[故障排除指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Ftroubleshooting)**。\n\n---\n\n## Bug 报告\n\n使用自动化生成器创建全面的 bug 报告：\n\n```bash\ncd ~\u002F.claude\u002Fplugins\u002Fmarketplaces\u002Fthedotmack\nnpm run bug-report\n```\n\n## 贡献\n\n欢迎贡献！请按照以下步骤操作：\n\n1. 分支仓库\n2. 创建功能分支\n3. 在进行更改的同时编写测试\n4. 更新文档\n5. 提交拉取请求\n\n有关贡献流程，请参阅 [开发指南](https:\u002F\u002Fdocs.claude-mem.ai\u002Fdevelopment)。\n\n---\n\n## 许可证\n\n本项目采用 **GNU Affero 通用公共许可证 v3.0**（AGPL-3.0）许可。\n\n版权所有 © 2025 Alex Newman (@thedotmack)。保留所有权利。\n\n完整详情请参阅 [LICENSE](LICENSE) 文件。\n\n**这意味着：**\n\n- 您可以自由地使用、修改和分发此软件。\n- 如果您对其进行修改并在网络服务器上部署，则必须公开您的源代码。\n- 衍生作品也必须以 AGPL-3.0 许可证授权。\n- 本软件不提供任何担保。\n\n**关于 Ragtime 的说明**：`ragtime\u002F` 目录单独采用 **PolyForm 非商业许可证 1.0.0** 许可。详细信息请参阅 [ragtime\u002FLICENSE](ragtime\u002FLICENSE)。\n\n---\n\n## 支持\n\n- **文档**：[docs\u002F](docs\u002F)\n- **问题**：[GitHub Issues](https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem\u002Fissues)\n- **仓库**：[github.com\u002Fthedotmack\u002Fclaude-mem](https:\u002F\u002Fgithub.com\u002Fthedotmack\u002Fclaude-mem)\n- **官方 X 账号**：[@Claude_Memory](https:\u002F\u002Fx.com\u002FClaude_Memory)\n- **官方 Discord**：[加入 Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FJ4wttp9vDu)\n- **作者**：Alex Newman ([@thedotmack](https:\u002F\u002Fgithub.com\u002Fthedotmack))\n\n---\n\n**基于 Claude Agent SDK 构建** | **由 Claude Code 提供支持** | **使用 TypeScript 打造**\n\n---\n\n### 关于 $CMEM？\n\n$CMEM 是一种 Solana 代币，由第三方在未经 Claude-Mem 事先同意的情况下创建，但已被 Claude-Mem 的创建者 Alex Newman（@thedotmack）正式认可。该代币旨在作为社区增长的催化剂，并为最需要实时代理数据的开发者和知识工作者提供数据渠道。$CMEM：2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS","# Claude-Mem 快速上手指南\n\nClaude-Mem 是一个专为 **Claude Code** 和 **Gemini CLI** 设计的持久化记忆压缩系统。它能自动捕获工具使用观察、生成语义摘要，并在会话结束后保留上下文，让 AI 在重新连接时依然“记得”之前的项目状态。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**: Linux, macOS 或 Windows (WSL)\n*   **Node.js**: 版本 >= 18.0.0\n*   **目标工具**: 已安装并配置好 `Claude Code` 或 `Gemini CLI`\n*   **网络环境**: 能够访问 npm  registry 及 GitHub（如需加速，请自行配置国内镜像源）\n\n> **注意**: 虽然该工具发布在 npm 上，但**不要**直接使用 `npm install -g` 安装全局包，那样只会安装 SDK 库而不会注册插件钩子或启动工作服务。请务必使用下方的 `npx` 命令进行安装。\n\n## 安装步骤\n\n根据你的使用场景，选择以下任一命令进行一键安装：\n\n### 1. 为 Claude Code 安装（推荐）\n这是最常用的安装方式，会自动检测并配置环境：\n\n```bash\nnpx claude-mem install\n```\n\n### 2. 为 Gemini CLI 安装\n如果你主要使用 Google 的 Gemini CLI，工具会自动检测 `~\u002F.gemini` 目录并进行适配：\n\n```bash\nnpx claude-mem install --ide gemini-cli\n```\n\n### 3. 通过插件市场安装\n如果你已经在运行 Claude Code，也可以直接在交互式界面中执行：\n\n```bash\n\u002Fplugin marketplace add thedotmack\u002Fclaude-mem\n\u002Fplugin install claude-mem\n```\n\n### 4. OpenClaw 网关安装（可选）\n如果你在使用 OpenClaw 网关，可以使用专用脚本安装：\n\n```bash\ncurl -fsSL https:\u002F\u002Finstall.cmem.ai\u002Fopenclaw.sh | bash\n```\n\n**安装完成后**：请重启你的 Claude Code 或 Gemini CLI 终端会话。此前会话的上下文将自动出现在新会话中。\n\n## 基本使用\n\n安装完成后，Claude-Mem 将以**全自动模式**运行，无需手动干预。它会在后台执行以下操作：\n1.  **自动捕获**：记录工具调用和关键对话节点。\n2.  **智能摘要**：生成语义化的记忆摘要。\n3.  **上下文注入**：在新会话开始时，自动将相关历史记忆注入给 AI。\n\n### 核心功能体验\n\n#### 1. 查看实时记忆流\n安装后，本地会启动一个 Web 服务，你可以随时在浏览器中查看当前的记忆流和观察记录：\n\n*   访问地址：`http:\u002F\u002Flocalhost:37777`\n*   功能：查看实时记忆、搜索历史记录、管理配置。\n\n#### 2. 使用自然语言搜索记忆\n在对话中，你可以直接让 Claude 搜索过去的记忆。底层通过 `mem-search` 技能和 MCP 工具实现高效的三层检索：\n\n**示例对话：**\n\n> **用户**: \"帮我查一下上次我们是怎么解决那个认证 bug 的？\"\n>\n> **Claude (自动调用工具)**:\n> 1.  执行 `search(query=\"authentication bug\")` 获取索引。\n> 2.  发现相关 ID (例如 #123, #456)。\n> 3.  执行 `get_observations(ids=[123, 456])` 获取详细上下文。\n> 4.  基于检索到的详细信息回答你的问题。\n\n#### 3. 隐私控制\n如果某些内容不适合存储，你可以在对话中使用 `\u003Cprivate>` 标签，Claude-Mem 会自动排除这些内容：\n\n```text\n\u003Cprivate>\n这里是一些敏感的 API 密钥或个人信息，不会被存入记忆库。\n\u003C\u002Fprivate>\n```\n\n#### 4. 进阶：切换测试版功能\n如果你想尝试“无尽模式 (Endless Mode)\"等实验性功能：\n1.  打开 Web  viewer: `http:\u002F\u002Flocalhost:37777`\n2.  进入 **Settings** (设置)\n3.  在版本通道中切换至 **Beta**。\n\n---\n*更多详细架构说明和高级配置，请访问官方文档：https:\u002F\u002Fdocs.claude-mem.ai\u002F*","资深后端工程师正在维护一个迭代了半年的复杂微服务项目，需要频繁切换任务并在多天后重新接手之前的开发上下文。\n\n### 没有 claude-mem 时\n- **上下文断层严重**：每次开启新会话，Claude 对之前几天讨论过的架构决策、临时补丁和未完成的逻辑一无所知，开发者必须花费大量时间重新粘贴代码片段和复述背景。\n- **重复解释成本高**：对于项目中特有的命名规范、遗留系统的“坑”以及特定的业务约束，开发者不得不像教新人一样反复向 AI 强调，导致对话效率极低。\n- **关键细节遗失**：在多轮调试中产生的重要中间结论（如某个接口为何要特殊处理）随着会话结束而消失，后续再次遇到类似问题时容易重蹈覆辙。\n- **手动整理负担重**：为了保持连续性，开发者被迫手动编写冗长的“项目备忘录”并每次手动投喂，打断了流畅的编码心流。\n\n### 使用 claude-mem 后\n- **智能记忆继承**：claude-mem 自动压缩并存储了过往所有会话的核心逻辑，新会话开始时，Claude 能立即“回忆”起项目的当前状态和历史决策，无需人工干预。\n- **隐性知识沉淀**：工具自动提取并内化了项目的特殊规范和避坑指南，Claude 在生成代码时能主动遵循这些隐性规则，仿佛一位从未离开过项目的资深搭档。\n- **连续推理能力**：之前的调试思路和未决问题被精准保留，Claude 可以基于昨天的分析结果直接继续深入，实现了跨天数的连续逻辑推理。\n- **零摩擦重启**：开发者只需输入简单的指令即可恢复工作，claude-mem 在后台静默注入相关上下文，让每次开工都像刚刚结束上一分钟的工作一样顺畅。\n\nclaude-mem 通过将离散的编程会话转化为持续进化的项目记忆，彻底消除了 AI 辅助开发中的“失忆症”，让长期协作变得真正高效且连贯。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fthedotmack_claude-mem_b3304285.png","thedotmack","Alex Newman","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fthedotmack_fcee3e7e.jpg",null,"Claude_Memory","https:\u002F\u002Fgithub.com\u002Fthedotmack",[82,86,90,93,97],{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",83.2,{"name":87,"color":88,"percentage":89},"JavaScript","#f1e05a",10.9,{"name":91,"color":92,"percentage":10},"Shell","#89e051",{"name":94,"color":95,"percentage":96},"HTML","#e34c26",2.7,{"name":98,"color":99,"percentage":100},"Python","#3572A5",0.2,45426,3451,"2026-04-05T15:31:40","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":108,"python":106,"dependencies":109},"该工具是基于 Node.js 的插件，而非 Python AI 模型。核心运行环境要求为 Node.js 版本 18.0.0 或更高。它使用 Bun 管理后台服务，利用 SQLite 存储会话数据，并使用 Chroma 进行向量搜索。安装需通过 `npx claude-mem install` 命令完成，该命令会自动配置插件钩子并启动工作服务。支持 Claude Code 和 Gemini CLI。",[110,111,112,113],"Node.js >= 18.0.0","Bun","SQLite","Chroma (向量数据库)",[13,14,15,53],[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135],"ai","ai-agents","ai-memory","anthropic","artificial-intelligence","claude","claude-agent-sdk","claude-agents","claude-code","claude-code-plugin","claude-skills","long-term-memory","mem0","openmemory","supermemory","chromadb","sqlite","embeddings","memory-engine","rag",4,"2026-03-27T02:49:30.150509","2026-04-06T05:37:35.894852",[],[141,146,151,156,161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236],{"id":142,"version":143,"summary_zh":144,"released_at":145},108268,"v11.0.0","## claude-mem v11.0.0\n\n**今日发布 4 次** · 21 次提交 · 插入 6,051 行 · 更改 34 个文件\n\n### 功能特性\n\n#### 语义上下文注入 (#1568)\n每个 `UserPromptSubmit` 现在都会查询 ChromaDB，获取与当前提示最相关的前 N 条历史观察，并将其作为上下文注入。这一改进用基于相关性的语义搜索取代了原先仅依赖时间顺序的“最近 N 条观察”。该功能能够应对 `\u002Fclear` 命令，会跳过长度小于 20 个字符的简单提示，并且在 Chroma 不可用时也能优雅降级。\n\n#### 按队列复杂度分级路由\nSDK 代理现在会在选择模型之前检查待处理队列的复杂度。仅包含工具调用的简单队列（如 Read、Glob、Grep）会路由到 Haiku 模型；而混合或复杂的队列则使用默认模型。实际生产效果：在质量与 Sonnet 无差别的前提下，SDK 代理的使用成本降低了约 **52%**。此外，还新增了一个 `observation_feedback` 表，用于未来的汤普森采样优化。\n\n#### 多机器观察同步 (#1570)\n新增了 `claude-mem-sync` CLI 工具，提供 `push`、`pull`、`sync` 和 `status` 四种命令。通过 SSH\u002FSCP 协议实现多台机器之间的观察记录和会话摘要的双向同步，并以 `(created_at, title)` 作为唯一标识进行去重。经测试，该工具成功在两台物理服务器之间同步了超过 3,400 条观察记录——其中一次远程机器上的会话甚至利用传输过来的记忆完成了真实的功能性代码提交。\n\n#### 孤立消息清理 (#1567)\n当 `deleteSession()` 通过 SIGTERM 终止 SDK 代理时，原本会一直停留在 `pending` 状态的待处理消息，现在会被标记为“已废弃”，而不会无限期地滞留在待处理队列中。生产环境证据显示：修复前发现 15 条孤立消息，修复后连续 23 天未再出现孤立消息。\n\n### 错误修复\n\n#### 安装程序回归问题修复 (v10.7.0 → v10.7.1)\n在 v10.7.0 中，安装流程简化过度，直接将整个 `runInstallCommand` 函数替换为两条简单的 `claude` CLI 命令，从而彻底移除了交互式 IDE 多选功能、`--ide` 标志以及所有 13 种针对不同 IDE 的特定设置逻辑。v10.7.1 恢复了适用于所有非 Claude Code IDE 的完整安装流程，同时保留了对 Claude Code 原生插件的委托机制。\n\n#### 3 个上游生产缺陷修复 (#1566)\n通过对两台服务器上 17 天内累计 543,000 行日志的分析发现：\n- **summarize.ts**：当对话记录中没有助手消息时跳过总结生成（此前每天会产生约 30 次错误）\n- **ChromaSync.ts**：当尝试添加文档时因“ID 已存在”而失败时，自动回退至 `chroma_update_documents` 操作\n- **HealthMonitor.ts**：将基于 HTTP 的端口检测替换为原子级的套接字绑定操作（有效避免了并发会话启动时的 TOCTOU 竞争条件）\n\n#### 其他修复\n- 将概念类型清理的日志级别从错误降为调试（减少日志噪音）\n\n### 破坏性变更\n\n**严格的观察者响应规范** — 内存代理不再允许返回类似“跳过——无实质性工具执行”的散文式跳过响应。`buildObservationPrompt` 现在必须返回 `\u003Cobservation>` XML 块或空响应。`ResponseProcessor` 会在收到非 XML 内容时发出警告。此举旨在防止观察者自行决定工具输出不值得记录而导致数据丢失的情况发生。\n\n### 社区\n\n功能","2026-04-05T02:39:55",{"id":147,"version":148,"summary_zh":149,"released_at":150},108269,"v10.7.2","## 错误修复\n\n- **修复**: 将概念类型清理日志的级别从错误降为调试（#1606）——通过将常规的概念类型清理操作记录为调试级别而非错误级别，从而减少日志中的噪声。","2026-04-05T02:23:04",{"id":152,"version":153,"summary_zh":154,"released_at":155},108270,"v10.7.1","## 错误修复\n\n**恢复完整的交互式安装程序** — 在 v10.7.0 中（提交 21b10b46）对作用域的简化处理过度，将整个 `runInstallCommand` 函数替换为仅两条 `claude` CLI 命令。这导致交互式 IDE 多选功能、`--ide` 标志以及所有 13 个 IDE 特定的设置分发器被彻底移除。\n\n### 变更内容\n- **Claude Code**：现在使用原生的 `claude plugin marketplace add` + `claude plugin install` 命令（即原本 intended 的简化方式）\n- **其他所有 IDE**（Gemini CLI、OpenCode、Windsurf、OpenClaw、Codex CLI、Copilot CLI、Antigravity、Goose、Crush、Roo Code、Warp）：完整安装流程已恢复——包括文件复制、插件市场注册、通过 `@clack\u002Fprompts` 进行的交互式多选，以及 IDE 特定的设置步骤。\n- `--ide \u003Cid>` 标志再次生效，可直接指定目标 IDE。","2026-04-05T01:59:18",{"id":157,"version":158,"summary_zh":159,"released_at":160},108271,"v10.7.0","## 新增功能\n\n### 简化安装\n- 安装命令现委托给原生 Claude Code 插件系统：`claude plugin marketplace add thedotmack\u002Fclaude-mem && claude plugin install claude-mem`\n- `install.ts` 文件从 536 行缩减至 36 行\n\n### 多 IDE 支持（NPX CLI）\n- Gemini CLI 将安装程序与生命周期事件映射挂钩\n- Windsurf 将安装程序与项目注册表和上下文注入挂钩\n- OpenCode 插件安装程序支持 `AGENTS.md` 上下文注入\n- OpenClaw 插件安装程序\n- Codex CLI 转录监听集成\n- MCP 工厂模式适用于 Copilot CLI、Antigravity、Goose、Crush、Roo Code 和 Warp\n\n### 卸载改进\n- 工作线程关闭现会等待进程退出后再执行文件删除操作\n- 卸载时会清理 IDE 特定的钩子和配置\n\n### 错误修复\n- 使用 `import.meta.url` 替代 `process.cwd()` 修复了包路径解析问题\n- 修复了同名工作区目录导致 Windsurf 注册表键冲突的问题\n- `AGENTS.md` 注入失败现在会记录日志，而非静默忽略\n- 会话跟踪 `Map` 最大容量限制为 1000 条，以防止内存泄漏\n- 修复了 NPX CLI 包中的双重 shebang 问题\n- 修复了 Gemini CLI 状态命令中对损坏 JSON 的处理问题\n\n### 其他\n- 恢复了用于未来版本发布的版本号递增功能\n- 为 Windsurf、Warp、Copilot 添加了 IDE 上下文文件，并更新了代理规则","2026-04-04T21:58:27",{"id":162,"version":163,"summary_zh":164,"released_at":165},108272,"v10.6.3","## v10.6.3 — 重要补丁版本\n\n### 错误修复\n\n- **修复 MCP 服务器崩溃**：移除了 CJS 文件中导致 Node.js 启动失败的错误 `import.meta.url` ESM 兼容性声明\n- **修复 7 个严重 bug**，影响所有非开发机用户及 Windows 系统：\n  - 修正了插件分发的钩子注册路径\n  - 加强了 Windows 系统下 Worker 服务启动的处理逻辑\n  - 增强了环境变量清理功能以提升跨平台兼容性\n  - 改进了 ProcessManager 在 Windows 上启动进程时的错误捕获逻辑\n  - 在回归测试中豁免了 SessionEnd 内联钩子\n  - `summarize.ts` 中的警告日志现包含 `sessionId`，便于问题排查\n- 处理了来自 PR #1518 的 CodeRabbit 审查反馈\n\n### 功能改进\n\n- **Gemini CLI 集成**：去除时间线显示中的 ANSI 颜色代码，并提供 Markdown 备用格式\n\n### 更改文件\n\n- `plugin\u002Fhooks\u002Fhooks.json`\n- `plugin\u002Fscripts\u002Fmcp-server.cjs`\n- `plugin\u002Fscripts\u002Fworker-service.cjs`\n- `scripts\u002Fbuild-hooks.js`\n- `src\u002Fcli\u002Fhandlers\u002Fsummarize.ts`\n- `src\u002Fservices\u002Finfrastructure\u002FProcessManager.ts`\n- `src\u002Fservices\u002Fworker-service.ts`\n- `src\u002Fsupervisor\u002Fenv-sanitizer.ts`\n- `tests\u002Finfrastructure\u002Fplugin-distribution.test.ts`\n- `tests\u002Fsupervisor\u002Fenv-sanitizer.test.ts`","2026-03-29T02:49:52",{"id":167,"version":168,"summary_zh":169,"released_at":170},108273,"v10.6.2","## 修复：Activity 旋转图标无限旋转\n\n查看器 UI 中的 Activity 旋转图标会无限旋转，原因是 `isAnySessionProcessing()` 方法全局查询了数据库中所有待处理\u002F正在处理的消息——包括来自已失效会话的孤立消息，而这些消息永远不会被任何生成器处理。这些孤立消息导致 `isProcessing` 始终为 `true`。\n\n### 变更\n\n- 将 `isAnySessionProcessing()` 和 `hasPendingMessages()` 的作用域限定为仅检查内存中的活跃会话 Map，从而避免数据库中的孤立消息影响旋转图标。\n- 添加了 `terminateSession()` 方法，强制执行“重启或终止”的不变性——每个生成器退出时必须要么重启，要么彻底清理资源。\n- 修复了 `.finally()` 处理程序中的 3 条僵尸路径，这些路径曾导致会话在内存中保持存活状态，但没有运行任何生成器。\n- 修复了空闲超时竞争条件：在空闲中止和清理之间到达的新消息可能会被静默丢弃。\n- 移除了冗余的裸 `isProcessing: true` 广播，并消除了 `broadcastProcessingStatus()` 中的双重遍历。\n- 将内联的 `require()` 替换为通过 `sessionManager.getPendingMessageStore()` 的正确访问器。\n- 添加了 8 个用于验证会话终止不变性的回归测试。","2026-03-21T21:14:30",{"id":172,"version":173,"summary_zh":174,"released_at":175},108274,"v10.6.1","### 新功能\n- **时间线报告技能** — 新的 `\u002Ftimeline-report` 技能可根据 claude-mem 的开发历史，结合基于令牌的经济机制，生成叙事性的“进入[项目]之旅”报告。\n- **Git 工作树检测** — 时间线报告会自动检测 Git 工作树，并以父项目作为数据源。\n- **压缩上下文输出** — Markdown 上下文注入内容压缩约 53%（表格 → 紧凑的扁平化行），从而减少会话启动时的令牌开销。\n- **完整观测获取** — 在 `\u002Fapi\u002Fcontext\u002Finject` 中新增 `full=true` 参数，用于获取所有观测记录。\n\n### 改进\n- 将 `TimelineRenderer` 拆分为独立的 Markdown 渲染路径和颜色渲染路径。\n- 修复了时间戳重复标记跨会话摘要边界泄漏的问题。\n\n### 安全性\n- 移除了任意文件写入漏洞（`dump_to_file` 参数）。","2026-03-18T21:36:46",{"id":177,"version":178,"summary_zh":179,"released_at":180},108275,"v10.6.0","## OpenClaw：系统提示词上下文注入\n\nOpenClaw 插件不再向 `MEMORY.md` 文件写入内容。取而代之的是，它通过 `before_prompt_build` 钩子，利用 `appendSystemContext` 将观测时间线注入到每个智能体的系统提示词中。这样可以将 `MEMORY.md` 保持在智能体的控制之下，用于管理经过精心整理的长期记忆。每个项目的上下文会缓存 60 秒。\n\n## 新增 `syncMemoryFileExclude` 配置项\n\n允许将特定智能体 ID 排除在自动上下文注入之外（例如：`[\"snarf\", \"debugger\"]`）。被排除的智能体会继续记录观测信息，只是不会进行上下文注入。\n\n## 修复：UI 设置现可保留假值\n\n查看器设置钩子曾使用 `||` 而非 `??`，这会导致后台值如 `'0'`、`'false'` 和 `''` 被静默替换为 UI 默认值。现已通过空值合并运算符修复此问题。前端默认值现已与后端的 `SettingsDefaultsManager` 保持一致。\n\n## 文档更新\n\n- 更新了 `openclaw-integration.mdx` 和 `openclaw\u002FSKILL.md`，以反映系统提示词注入的行为。\n- 将“提示词注入”术语修正为“上下文注入”，以避免与 OWASP 的安全术语混淆。","2026-03-18T00:16:54",{"id":182,"version":183,"summary_zh":184,"released_at":185},108276,"v10.5.6","## 补丁：进程监视器加固与日志清理\n\n### 修复内容\n- **将 HTTP 请求\u002F响应日志级别从 INFO 降级至 DEBUG** — 消除查看器 UI 轮询产生的每请求噪音日志\n- **修复 `isPidAlive(0)` 返回 true 的问题** — PID 0 是内核调度器，而非有效子进程\n- **修复信号处理程序的竞态条件** — 添加 `shutdownInitiated` 标志，防止在 `stopPromise` 尚未设置时接收到信号导致重复关闭级联\n- **移除 `ShutdownCascadeOptions` 中未使用的 `dataDir` 参数**\n- **导出并复用环境变量 sanitizier 常量** — `Server.ts` 现在从 `env-sanitizer.ts` 导入 `ENV_PREFIXES`\u002F`ENV_EXACT_MATCHES`，不再重复定义\n- **将 `zombiePidFiles` 重命名为 `deadProcessPids`** — 现在返回真实的 PID 数组，而非布尔值\n- **在 `workerHttpRequest` 中使用 `buildWorkerUrl` 辅助函数**，而非内联构建 URL\n- **移除观测和会话初始化处理器中未使用的 `getWorkerPort` 导入**\n- **将 `reapSession` 失败日志级别由 debug 提升至 warn**\n- **清理 `.gitignore` 文件** — 移除过时的 `~*\u002F`、`http*\u002F`、`https*\u002F` 模式以及重复的 `datasets\u002F` 条目\n\n### 测试\n- 重写了 supervisor 主模块测试，改用临时目录，不再依赖真实的 `~\u002F.claude-mem\u002Fworker.pid`\n- 新增了针对缺失、无效、过期及存活 PID 文件状态的确定性测试用例\n- 从关闭测试 fixture 中移除了未使用的 `dataDir`","2026-03-16T21:54:58",{"id":187,"version":188,"summary_zh":189,"released_at":190},108277,"v10.5.5","### 错误修复\n\n- **修复了模式切换后上下文查询为空的问题**：从非代码模式（例如法律学习）切换回代码模式时，`settings.json` 文件中会残留过时的观测类型\u002F概念过滤器，导致所有上下文查询都返回空结果。现在所有模式都会统一从各自的模式 JSON 定义中读取类型和概念。\n\n### 代码清理\n\n- 移除了已废弃的 `CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES` 和 `CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS` 设置常量\n- 删除了 `src\u002Fconstants\u002Fobservation-metadata.ts` 文件（不再需要）\n- 从查看器的“上下文设置”模态框中移除了观测类型\u002F概念过滤器的 UI 控件","2026-03-09T10:02:21",{"id":192,"version":193,"summary_zh":194,"released_at":195},108278,"v10.5.4","## Bug Fixes\n\n- **fix: restore modes to correct location** — All modes (`code`, code language variants, `email-investigation`) were erroneously moved from `plugin\u002Fmodes\u002F` to `plugin\u002Fhooks\u002Fmodes\u002F` during the v10.5.3 release, breaking mode loading. This patch restores them to `plugin\u002Fmodes\u002F` where they belong.","2026-03-09T04:01:31",{"id":197,"version":198,"summary_zh":199,"released_at":200},108279,"v10.5.3","## What's New\n\n### Law Study Mode\n\nAdds `law-study` — a purpose-built claude-mem mode for law students.\n\n**Observation Types:**\n- **Case Holding** — 2-3 sentence brief with extracted legal rule\n- **Issue Pattern** — exam trigger or fact pattern that signals a legal issue\n- **Prof Framework** — professor's analytical lens and emphasis for a topic\n- **Doctrine \u002F Rule** — legal test or standard synthesized from cases\u002Fstatutes\n- **Argument Structure** — legal argument or counter-argument worked through analytically\n- **Cross-Case Connection** — insight linking cases or doctrines to reveal a deeper principle\n\n**Concepts (cross-cutting tags):**\n`exam-relevant` · `minority-position` · `gotcha` · `unsettled-law` · `policy-rationale` · `course-theme`\n\n**Chill Variant** — `law-study--chill` records only high-signal items: issue patterns, gotchas, and professor frameworks. Skips routine case holdings unless the result is counterintuitive.\n\n**CLAUDE.md Template** — `law-study-CLAUDE.md` is a drop-in template for any law study project directory. It configures Claude as a Socratic legal study partner: precise case briefs, critical document analysis, issue spotting, and doctrine synthesis — without writing exam answers for the student.\n\nActivate with: `\u002Fmode law-study` or `\u002Fmode law-study--chill`","2026-03-09T02:36:13",{"id":202,"version":203,"summary_zh":204,"released_at":205},108280,"v10.5.2","## Smart Explore Benchmark Docs & Skill Update\n\n### Documentation\n- Published smart-explore benchmark report to public docs — full A\u002FB comparison with methodology, raw data tables, quality assessment, and decision framework\n- Added benchmark report to docs.json navigation under Best Practices\n\n### Smart Explore Skill\n- Updated token economics with benchmark-accurate data (11-18x savings on exploration, 4-8x on file understanding)\n- Added \"map first\" core principle as decision heuristic for tool selection\n- Added AST completeness guarantee to smart_unfold documentation (never truncates, unlike Explore agents)\n- Added Explore agent escalation guidance for multi-file synthesis tasks\n- Updated smart_unfold token range from ~1-7k to ~400-2,100 based on measurements\n- Updated Explore agent token range from ~20-40k to ~39-59k based on measurements","2026-02-26T03:23:35",{"id":207,"version":208,"summary_zh":209,"released_at":210},108281,"v10.5.1","### Bug Fix\n\n- Restored hooks.json to pre-smart-explore configuration (re-adds Setup hook, separate worker start command, PostToolUse matcher)","2026-02-26T02:08:25",{"id":212,"version":213,"summary_zh":214,"released_at":215},108282,"v10.5.0","## Smart Explore: AST-Powered Code Navigation\n\nThis release introduces **Smart Explore**, a token-optimized structural code search system built on tree-sitter AST parsing. It applies the same progressive disclosure pattern used in human-readable code outlines — but programmatically, for AI agents.\n\n### Why This Matters\n\nThe standard exploration cycle (Glob → Grep → Read) forces agents to consume entire files to understand code structure. A typical 800-line file costs ~12,000 tokens to read. Smart Explore replaces this with a 3-layer progressive disclosure workflow that delivers the same understanding at **6-12x lower token cost**.\n\n### 3 New MCP Tools\n\n- **`smart_search`** — Walks directories, parses all code files via tree-sitter, and returns ranked symbols with signatures and line numbers. Replaces the Glob → Grep discovery cycle in a single call (~2-6k tokens).\n- **`smart_outline`** — Returns the complete structural skeleton of a file: all functions, classes, methods, properties, imports (~1-2k tokens vs ~12k for a full Read).\n- **`smart_unfold`** — Expands a single symbol to its full source code including JSDoc, decorators, and implementation (~1-7k tokens).\n\n### Token Economics\n\n| Approach | Tokens | Savings |\n|----------|--------|---------|\n| smart_outline + smart_unfold | ~3,100 | 8x vs Read |\n| smart_search (cross-file) | ~2,000-6,000 | 6-12x vs Explore agent |\n| Read (full file) | ~12,000+ | baseline |\n| Explore agent | ~20,000-40,000 | baseline |\n\n### Language Support\n\n10 languages via tree-sitter grammars: TypeScript, JavaScript, Python, Rust, Go, Java, C, C++, Ruby, PHP.\n\n### Other Changes\n\n- Simplified hooks configuration\n- Removed legacy setup.sh script\n- Security fix: replaced `execSync` with `execFileSync` to prevent command injection in file path handling","2026-02-26T02:03:17",{"id":217,"version":218,"summary_zh":219,"released_at":220},108283,"v10.4.4","## Fix\n\n- **Remove `save_observation` from MCP tool surface** — This tool was exposed as an MCP tool available to Claude, but it's an internal API-only feature. Removing it from the MCP server prevents unintended tool invocation and keeps the tool surface clean.","2026-02-26T00:55:55",{"id":222,"version":223,"summary_zh":224,"released_at":225},108284,"v10.4.3","## Bug Fixes\n\n- **Fix PostToolUse hook crashes and 5-second latency (#1220)**: Added missing `break` statements to all 7 switch cases in `worker-service.ts` preventing fall-through execution, added `.catch()` on `main()` to handle unhandled promise rejections, and removed redundant `start` commands from hook groups that triggered the 5-second `collectStdin()` timeout\n- **Fix CLAUDE_PLUGIN_ROOT fallback for Stop hooks (#1215)**: Added POSIX shell-level `CLAUDE_PLUGIN_ROOT` fallback in `hooks.json` for environments where the variable isn't injected, added script-level self-resolution via `import.meta.url` in `bun-runner.js`, and regression test added in `plugin-distribution.test.ts`\n\n## Maintenance\n\n- Synced all version files (plugin.json was stuck at 10.4.0)","2026-02-25T00:34:45",{"id":227,"version":228,"summary_zh":229,"released_at":230},108285,"v10.4.2","## Bug Fixes\n\n- **Fix PostToolUse hook crashes and 5-second latency (#1220)**: Added missing `break` statements to all 7 switch cases in `worker-service.ts` preventing fall-through execution, added `.catch()` on `main()` to handle unhandled promise rejections, and removed redundant `start` commands from hook groups that triggered the 5-second `collectStdin()` timeout\n- **Fix CLAUDE_PLUGIN_ROOT fallback for Stop hooks (#1215)**: Added POSIX shell-level `CLAUDE_PLUGIN_ROOT` fallback in `hooks.json` for environments where the variable isn't injected, added script-level self-resolution via `import.meta.url` in `bun-runner.js`, and regression test added in `plugin-distribution.test.ts`\n- **Sync plugin.json version**: Fixed `plugin.json` being stuck at 10.4.0 while other version files were at 10.4.1","2026-02-25T00:33:07",{"id":232,"version":233,"summary_zh":234,"released_at":235},108286,"v10.4.1","### Refactor\n- **Skills Conversion**: Converted `\u002Fmake-plan` and `\u002Fdo` commands into first-class skills in `plugin\u002Fskills\u002F`.\n- **Organization**: Centralized planning and execution instructions alongside `mem-search`.\n- **Compatibility**: Added symlinks for `openclaw\u002Fskills\u002F` to ensure seamless integration with OpenClaw.\n\n### Chore\n- **Version Bump**: Aligned all package and plugin manifests to v10.4.1.","2026-02-24T03:13:26",{"id":237,"version":238,"summary_zh":239,"released_at":240},108287,"v10.4.0","## v10.4.0 — Stability & Platform Hardening\n\nMassive reliability release: 30+ root-cause bug fixes across 10 triage phases, plus new features for agent attribution, Chroma control, and broader platform support.\n\n### New Features\n\n- **Session custom titles** — Agents can now set `custom_title` on sessions for attribution (migration 23, new endpoint)\n- **Chroma toggle** — `CLAUDE_MEM_CHROMA_ENABLED` setting allows SQLite-only fallback mode (#707)\n- **Plugin disabled state** — Early exit check in all hook entry points when plugin is disabled (#781)\n- **Context re-injection guard** — `contextInjected` session flag prevents re-injecting context on every UserPromptSubmit turn (#1079)\n\n### Bug Fixes\n\n#### Data Integrity\n- SHA-256 content-hash deduplication on observation INSERT (migration 22 with backfill + index)\n- Project name collision fix: `getCurrentProjectName()` now returns `parent\u002Fbasename`\n- Empty project string guard with cwd-derived fallback\n- Stuck `isProcessing` reset: pending work older than 5 minutes auto-clears\n\n#### ChromaDB\n- Python version pinning in uvx args for both local and remote mode (#1196, #1206, #1208)\n- Windows backslash-to-forward-slash path conversion for `--data-dir` (#1199)\n- Metadata sanitization: filter null\u002Fundefined\u002Fempty values in `addDocuments()` (#1183, #1188)\n- Transport error auto-reconnect in `callTool()` (#1162)\n- Stale transport retry with transparent reconnect (#1131)\n\n#### Hook Lifecycle\n- Suppress `process.stderr.write` in `hookCommand()` to prevent diagnostic output showing as error UI (#1181)\n- Route all `console.error()` through logger instead of stderr\n- Verified all 7 handlers return `suppressOutput: true` (#598, #784)\n\n#### Worker Lifecycle\n- PID file mtime guard prevents concurrent restart storms (#1145)\n- `getInstalledPluginVersion()` ENOENT\u002FEBUSY handling (#1042)\n\n#### SQLite Migrations\n- Schema initialization always creates core tables via `CREATE TABLE IF NOT EXISTS`\n- Migrations 5-7 check actual DB state instead of version tracking (fixes version collision between old\u002Fnew migration systems, #979)\n- Crash-safe temp table rebuilds\n\n#### Platform Support\n- **Windows**: `cmd.exe \u002Fc` uvx spawn, PowerShell `$_` elimination with WQL filtering, `windowsHide: true`, FTS5 runtime probe with fallback (#1190, #1192, #1199, #1024, #1062, #1048, #791)\n- **Cursor IDE**: Adapter field fallbacks, tolerant session-init validation (#838, #1049)\n- **Codex CLI**: `session_id` fallbacks, unknown platform tolerance, undefined guard (#744)\n\n#### API & Infrastructure\n- `\u002Fapi\u002Flogs` OOM fix: tail-read replaces full-file `readFileSync` (64KB expanding chunks, 10MB cap, #1203)\n- CORS: explicit methods and allowedHeaders (#1029)\n- MCP type coercion for batch endpoints: string-to-array for `ids` and `memorySessionIds`\n- Defensive observation error handling returns 200 on recoverable errors instead of 500\n- `.git\u002F` directory write guard on all 4 CLAUDE.md\u002FAGENTS.md write sites (#1165)\n\n#### Stale AbortController Fix\n- `lastGeneratorActivity` timestamp tracking with 30s timeout (#1099)\n- Stale generator detection + abort + restart in `ensureGeneratorRunning`\n- `AbortSignal.timeout(30000)` in `deleteSession` prevents indefinite hang\n\n### Installation\n- `resolveRoot()` replaces hardcoded marketplace path using `CLAUDE_PLUGIN_ROOT` env var (#1128, #1166)\n- `installCLI()` path correction and `verifyCriticalModules()` post-install check\n- Build-time distribution verification for skills, hooks, and plugin manifest (#1187)\n\n### Testing\n- 50+ new tests across hook lifecycle, context re-injection, plugin distribution, migration runner, data integrity, stale abort controller, logs tail-read, CORS, MCP type coercion, and smart-install\n- 68 files changed, ~4200 insertions, ~900 deletions","2026-02-24T00:39:48"]