模式与语言¶

Claude-Mem 使用灵活的模式系统（Mode System）来调整其行为、观察类型和输出语言。这让你可以在不同工作流（如编码与邮件调查）或语言之间切换，而无需重新安装插件。

什么是模式？¶

“模式”（mode）是一种配置档案，用于定义： 1. 观察者角色（Observer Role）：Claude 应如何分析你的工作（例如，“软件工程师”与“取证分析师”）。 2. 观察类型（Observation Types）：有效的记忆分类（例如，“Bug 修复”、“功能”与“人物”、“组织”）。 3. 概念（Concepts）：用于索引的语义标签（例如，“模式”、“权衡”）。 4. 语言（Language）：用于生成观察和摘要的语言。

配置¶

使用 ~/.claude-mem/settings.json 中的 CLAUDE_MEM_MODE 设置来指定活动模式：

{
  "CLAUDE_MEM_MODE": "code--es"
}

或通过环境变量：

export CLAUDE_MEM_MODE="code--fr"

活动模式会显示在注入每个新会话的启动上下文中，例如：

Mode: Code Development (code)

创建自定义模式¶

运行 /mode-creator，通过交互式访谈来设计领域专属的笔记系统。它会帮助你选择观察类型和概念标签，编写并验证模式，将其安装到 ~/.claude-mem/modes/ 目录下，激活该模式，可选配置 Telegram 提醒，重启 worker，并验证启动上下文中的活动模式。

数据目录中的自定义模式在插件升级后仍然有效。同名的用户文件无法遮蔽内置模式 ID：例如，~/.claude-mem/modes/code.json 会被忽略并记录为错误。要自定义内置的 code 模式，请使用继承内置父级的 code--<name> 覆盖：

~/.claude-mem/modes/code--architecture-practice.json

不与内置模式冲突的自定义 ID 会从用户模式目录中加载。CLAUDE_MEM_MODES_DIR 仍然是用于开发和测试的显式覆盖项，可提供任意 ID。所有加载的模式在应用继承后，必须具有完整的 prompts 以及有效的观察类型和概念。

无效的模式内容会被记录日志并拒绝，同时会记录其文件路径以及缺失或无效的键。如果模式文件缺失，会先记录日志，再回退到经过验证的内置 code 模式；如果内置的回退模式也无效，则会抛出异常。

避免编辑插件缓存内的文件，因为插件更新可能会替换这些文件。

Telegram 提醒与会话总结¶

Telegram 有两条独立的投递路径。会话总结（session wrap-up）会在 Claude Code 会话结束时发送最新存储的会话摘要。逐条观察提醒（per-observation alerts）是针对匹配的观察类型或概念的实时通知；这些提醒现在默认关闭，即使 Telegram 本身已启用。

在 ~/.claude-mem/settings.json 中以字符串形式配置以下新设置：

• CLAUDE_MEM_TELEGRAM_WRAPUPS_ENABLED 默认值为 "true"，但在配置路由之前不会发送任何总结。
• CLAUDE_MEM_TELEGRAM_OBSERVATION_ALERTS_ENABLED 默认值为 "false"；仅当你希望恢复现有的 CLAUDE_MEM_TELEGRAM_TRIGGER_TYPES 或 CLAUDE_MEM_TELEGRAM_TRIGGER_CONCEPTS 提醒时，才将其设置为 "true"。
• CLAUDE_MEM_TELEGRAM_WRAPUP_ROUTES 默认值为 "{}"，包含一个以项目名称为键的 JSON 对象。

例如，将以下路由对象用作 CLAUDE_MEM_TELEGRAM_WRAPUP_ROUTES 的值：

{
  "claude-mem": {
    "chat_id": "-1001234567890",
    "bot_token": "optional override",
    "key": "optional route label"
  }
}

一个路由需要 chat_id；其 bot_token 可以覆盖 CLAUDE_MEM_TELEGRAM_BOT_TOKEN，key 是可选的路径标签。CLAUDE_MEM_TELEGRAM_ENABLED 仍然是这两条路径的总开关。路由查找首先精确匹配项目名称，然后对于 worktree，匹配第一个 / 之前的上层名称。如果两个路由都不存在，claude-mem 会记录 No wrap-up route for project 并且不发送任何内容——总结（wrap-up）绝不会回退到 CLAUDE_MEM_TELEGRAM_CHAT_ID。

可用模式¶

代码模式（默认）¶

软件开发的默认模式。捕获 Bug 修复、功能、重构以及架构决策。

ID： code

代码模式变体¶

改变代码模式运作方式的行为变体：

多语言代码模式¶

继承 Code Mode 的所有行为，但指示 Claude 用目标语言生成所有记忆产物（标题、叙述、事实、摘要）。

邮件调查模式¶

一种专门用于分析邮件转储（例如 FOIA 公开文件、企业档案）的模式。侧重于识别实体、关系、时间线事件和关键主题。

ID: email-investigation

观察类型： - entity：人员、组织或电子邮件地址 - relationship：实体之间的连接关系 - timeline-event：通信序列中带时间戳的事件 - evidence：支持性文档或证明 - anomaly：可疑模式或异常情况 - conclusion：调查发现或结论

模式继承¶

系统支持使用 -- 分隔符进行继承。例如，code--es 表示： 1. 加载 code（父级）配置。 2. 加载 code--es（子级）配置。 3. 将子级合并到父级中（子级覆盖父级）。

这样就能实现轻量级的“混搭”模式，仅更改特定方面（如语言提示词），同时保持核心定义不变。