dev-memory-cli 0.24.0 → 0.25.0

package/README.md

@@ -1,6 +1,6 @@
 # Dev Memory Skill Suite
 
-Dev Memory Skill Suite 为 Codex、Claude 等 coding agent 提供跨会话开发记忆能力。
+Dev Memory Skill Suite 为 Codex、Claude Code、Trae / Trae CN 等 coding agent 提供跨会话开发记忆能力。
 
 开发知识存储在用户目录，并按 **仓库身份 + Git 分支** 隔离。分支层保存当前工作的目标、约束和上下文，repo 层保存跨分支长期有效的规则与资料入口。Git 负责提交与代码历史，dev-memory 负责对后续开发仍有价值的语义信息。
 
@@ -57,8 +57,10 @@ npm install -g dev-memory-cli
 # 在当前仓库安装生命周期 hook
 dev-memory-cli install-hooks codex
 dev-memory-cli install-hooks claude
+dev-memory-cli install-hooks trae
+dev-memory-cli install-hooks trae-cn
 
-# 或一次安装两套
+# 或一次安装全部支持的客户端
 dev-memory-cli install-hooks --all
 ```
 
@@ -70,6 +72,8 @@ dev-memory-cli install-hooks --all --global
 
 CLI 也可通过 `npx -y dev-memory-cli ...` 按需执行。Skill 与 hook 相互独立，安装 skill 不会修改本地 hook 配置。
 
+Trae 的 Hook 配置按客户端隔离：国际版写入 `.trae/hooks.json`，国内版写入 `.trae-cn/hooks.json`；加 `--global` 时分别写入用户目录下的同名路径。已有 Hook 会保留，重复安装只更新 dev-memory 自己的条目。
+
 Codex Desktop 没有本仓库依赖的项目生命周期 hook。安装每日扫描任务可覆盖 Codex CLI 和 Desktop 共同写入的本机会话文件：
 
 ```bash
@@ -178,18 +182,18 @@ git config --local dev-memory.worktreeWriteback true
 
 ## 生命周期 Hook
 
-| 事件 | Codex CLI | Claude Code CLI | 行为 |
-| --- | :-: | :-: | --- |
-| `SessionStart` | ✓ | ✓ | 刷新 Git 派生索引，注入浓缩记忆和完整文件路径；同一 session 幂等 |
-| `Stop` | ✓ | ✓ | 记录轻量 HEAD marker；Codex 同时登记待扫描会话，不启动模型 |
-| `PreCompact` |  | ✓ | 兼容占位，当前不执行额外刷新 |
-| `SessionEnd` |  | ✓ | 记录最终 HEAD，并把 transcript 总结任务放入后台队列 |
+| 事件 | Codex CLI | Claude Code CLI | Trae | Trae CN | 行为 |
+| --- | :-: | :-: | :-: | :-: | --- |
+| `SessionStart` | ✓ | ✓ | ✓ | ✓ | 刷新 Git 派生索引，注入浓缩记忆和完整文件路径；同一 session 幂等 |
+| `Stop` | ✓ | ✓ | ✓ | ✓ | 记录轻量 HEAD marker；有可识别会话信息时登记扫描候选，不启动模型 |
+| `PreCompact` |  | ✓ |  |  | 兼容占位，当前不执行额外刷新 |
+| `SessionEnd` |  | ✓ |  |  | 记录最终 HEAD，并把 transcript 总结任务放入后台队列 |
 
 ### 会话总结
 
-Claude Code CLI 通过 `SessionEnd` 创建后台总结任务。Codex CLI 没有 `SessionEnd`，其 `Stop` hook 只登记候选；Codex Desktop 不依赖 hook。Codex 两种入口统一由每日扫描器读取 `~/.codex/sessions` 和 `~/.codex/archived_sessions`。
+Claude Code CLI 通过 `SessionEnd` 创建后台总结任务。Codex、Trae 和 Trae CN 当前没有该事件：它们的 `Stop` hook 只做轻量记录，并在 payload 带有可识别会话信息时登记扫描候选，不会在每轮回复后启动总结模型。现有定时扫描器只解析 Codex CLI / Desktop 写入的 `~/.codex/sessions` 和 `~/.codex/archived_sessions`；Trae Hook 支持当前覆盖 SessionStart 恢复与轻量 HEAD 刷新，不宣称扫描其私有会话存储。
 
-任务触发端与总结执行端相互独立。Claude 的即时 worker 和 Codex 定时扫描器都可以使用 `coco`、`codex` 或 `claude` CLI。扫描器在 `~/.dev-memory/config.json` 的 `session_scan` 中内置三个可配置 preset，默认按 `coco → codex → claude` 选择第一个可用命令；每个 preset 可指定模型、profile、额外参数和环境变量。
+任务触发端与总结执行端相互独立。Claude 的即时 worker 和 Codex 定时扫描器都可以使用 `coco`、`codex` 或 `claude` CLI。扫描器在 `~/.dev-memory/config.json` 的 `session_scan` 中内置三个可配置 preset，默认按 `claude → codex` 选择第一个可用命令；`coco` preset 继续保留，可显式启用或加入顺序。每个 preset 可指定模型、profile、额外参数和环境变量。
 
 总结输入包含全部尚未处理的 user/assistant 语义消息和现有 dev-memory，不按“最近几条”截尾，也不截断单条消息。长会话按顺序分块并最终归并；工具调用流水账、system 消息和 reasoning 不参与语义总结。输出限定为结构化 JSON，用于新增或修正 decisions、risks、glossary、file map 和 repo 共享记忆；时效性的“当前进展”“下一步”“当前阶段”不会写入。
 
@@ -332,7 +336,7 @@ dev-memory-cli summary <extract-core>
 dev-memory-cli session-scan <run|replay|install|status|stats|history|show|uninstall|config>
 dev-memory-cli hook <session-start|pre-compact|stop|session-end>
 dev-memory-cli ui
-dev-memory-cli install-hooks <codex|claude|--all>
+dev-memory-cli install-hooks <codex|claude|trae|trae-cn|--all>
 ```
 
 具体参数以各子命令的 `--help` 为准。
@@ -358,7 +362,7 @@ lib/maintenance/               # 按需注入独立维护 Agent 的 prompt
 lib/ui-server.js               # 本地管理面板服务
 lib/ui-app.html                # 管理面板前端
 scripts/hooks/                 # 生命周期 hook 实现
-hooks/                         # Codex / Claude hook 模板
+hooks/                         # Codex / Claude Code / Trae hook 模板
 skills/dev-memory-read/        # 唯一常驻 Skill
 tests/                         # Python 测试
 docs/diagrams/                 # README 图表及源文件

package/bin/dev-memory.js

@@ -9,6 +9,7 @@ const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const DEFAULT_STORAGE_ROOT = path.join(os.homedir(), ".dev-memory", "repos");
 const DEFAULT_CONFIG_PATH = process.env.DEV_MEMORY_CONFIG_PATH || path.join(os.homedir(), ".dev-memory", "config.json");
 const WORKSPACE_CONFIG_NAME = ".dev-memory-workspace.json";
+const SUPPORTED_HOOK_AGENTS = ["codex", "claude", "trae", "trae-cn"];
 
 function fail(message) {
   process.stderr.write(`ERROR: ${message}\n`);
@@ -191,32 +192,54 @@ function ensureSessionSummaryConfig() {
 function templatePathForAgent(agent) {
   if (agent === "codex") return packageScript("hooks", "codex-hooks.json");
   if (agent === "claude") return packageScript("hooks", "hooks.json");
+  if (agent === "trae" || agent === "trae-cn") return packageScript("hooks", "trae-hooks.json");
   fail(`unsupported agent: ${agent}`);
 }
 
 function targetPathForAgent(agent, repoRoot) {
   if (agent === "codex") return path.join(repoRoot, ".codex", "hooks.json");
   if (agent === "claude") return path.join(repoRoot, ".claude", "settings.local.json");
+  if (agent === "trae") return path.join(repoRoot, ".trae", "hooks.json");
+  if (agent === "trae-cn") return path.join(repoRoot, ".trae-cn", "hooks.json");
   fail(`unsupported agent: ${agent}`);
 }
 
 function globalTargetPathForAgent(agent) {
   if (agent === "codex") return path.join(os.homedir(), ".codex", "hooks.json");
   if (agent === "claude") return path.join(os.homedir(), ".claude", "settings.json");
+  if (agent === "trae") return path.join(os.homedir(), ".trae", "hooks.json");
+  if (agent === "trae-cn") return path.join(os.homedir(), ".trae-cn", "hooks.json");
   fail(`unsupported agent: ${agent}`);
 }
 
+function hookListIdentity(item) {
+  if (!item || typeof item !== "object") return null;
+  if (typeof item.id === "string" && item.id) {
+    return `id:${item.id}\u0000${item.matcher || ""}`;
+  }
+  const nestedHooks = Array.isArray(item.hooks) ? item.hooks : [];
+  for (const hook of nestedHooks) {
+    const command = hook && typeof hook.command === "string" ? hook.command.trim() : "";
+    const match = command.match(/(?:^|\s)dev-memory-cli\s+hook\s+(session-start|pre-compact|stop|session-end)(?:\s|$)/);
+    if (match) return `dev-memory-command:${match[1]}`;
+  }
+  return null;
+}
+
 function mergeHookLists(existingItems, incomingItems) {
   const merged = existingItems.map((item) => ({ ...item }));
   const index = new Map();
-  merged.forEach((item, i) => index.set(`${item.id || ""}\u0000${item.matcher || ""}`, i));
+  merged.forEach((item, i) => {
+    const key = hookListIdentity(item);
+    if (key) index.set(key, i);
+  });
   for (const item of incomingItems) {
     const copied = { ...item };
-    const key = `${copied.id || ""}\u0000${copied.matcher || ""}`;
-    if (index.has(key)) {
+    const key = hookListIdentity(copied);
+    if (key && index.has(key)) {
       merged[index.get(key)] = copied;
     } else {
-      index.set(key, merged.length);
+      if (key) index.set(key, merged.length);
       merged.push(copied);
     }
   }
@@ -224,7 +247,7 @@ function mergeHookLists(existingItems, incomingItems) {
 }
 
 function mergeConfig(existingConfig, templateConfig) {
-  const result = { ...existingConfig };
+  const result = { ...templateConfig, ...existingConfig };
   const existingHooks = existingConfig.hooks || {};
   const templateHooks = templateConfig.hooks || {};
   const mergedHooks = {};
@@ -272,7 +295,7 @@ function installHooksForAgent(agent, options) {
 
 function commandInstallHooks(positional, options) {
   const isAll = Boolean(options.all);
-  const agents = isAll ? ["codex", "claude"] : [positional[0] || options.agent || "codex"];
+  const agents = isAll ? SUPPORTED_HOOK_AGENTS : [positional[0] || options.agent || "codex"];
   const reports = agents.map((agent) => installHooksForAgent(agent, options));
   process.stdout.write(`${JSON.stringify(isAll ? reports : reports[0], null, 2)}\n`);
 }
@@ -794,7 +817,7 @@ function commandBranch(rawArgs) {
 function printHelp() {
   process.stdout.write(`Usage:
   dev-memory-cli hook <session-start|pre-compact|stop|session-end> [--repo PATH]
-  dev-memory-cli install-hooks <codex|claude> [--repo PATH] [--global]
+  dev-memory-cli install-hooks <codex|claude|trae|trae-cn> [--repo PATH] [--global]
   dev-memory-cli install-hooks --all [--repo PATH] [--global]
   dev-memory-cli ui [--port N] [--host HOST] [--no-open] [--read-only]
   dev-memory-cli workspace <show|primary> [...]

package/hooks/README.md

@@ -1,16 +1,24 @@
 # Lifecycle Hooks
 
-本项目使用 agent 生命周期 hook，不使用 Git hook。Claude Code 与 Codex 的可用事件不同，模板分别维护。
+本项目使用 agent 生命周期 hook，不使用 Git hook。Claude Code、Codex、Trae 与 Trae CN 的可用事件和配置目录不同，模板分别维护。
 
 ## 当前仓库里的接入方式
 
 - repo-local 配置位置：
   - Claude: `.claude/settings.local.json`
   - Codex: `.codex/hooks.json`
+  - Trae: `.trae/hooks.json`
+  - Trae CN: `.trae-cn/hooks.json`
+- user-level 配置位置：
+  - Claude: `~/.claude/settings.json`
+  - Codex: `~/.codex/hooks.json`
+  - Trae: `~/.trae/hooks.json`
+  - Trae CN: `~/.trae-cn/hooks.json`
 - 可复用模板：
   - Claude: [hooks/hooks.json](hooks.json)
   - Codex: [hooks/codex-hooks.json](codex-hooks.json)
-- `dev-memory-cli` 是这两套配置共用的稳定执行入口
+  - Trae / Trae CN: [hooks/trae-hooks.json](trae-hooks.json)
+- `dev-memory-cli` 是所有配置共用的稳定执行入口
 - hook 仅在模板内容合并到对应 agent 配置后生效
 
 ### Codex 快速安装
@@ -34,18 +42,21 @@ sh -c "$(curl -fsSL https://raw.githubusercontent.com/xluos/dev-memory-skill-sui
 ```bash
 dev-memory-cli install-hooks codex
 dev-memory-cli install-hooks claude
+dev-memory-cli install-hooks trae
+dev-memory-cli install-hooks trae-cn
+dev-memory-cli install-hooks --all
 ```
 
 已有旧配置如果还写着 `dev-memory hook ...` 或 `npx dev-memory hook ...`，重新执行安装命令会按 hook id 覆盖为 `dev-memory-cli hook ...`。
 
 ## Hook 行为
 
-| 事件 | Codex CLI | Claude Code CLI | 行为 |
-| --- | :-: | :-: | --- |
-| `SessionStart` | ✓ | ✓ | 读取当前 repo+branch 记忆并注入会话；同一 session 的重复触发幂等跳过 |
-| `Stop` | ✓ | ✓ | 每次回复后记录轻量 HEAD marker；Codex 同时登记定时扫描候选 |
-| `PreCompact` |  | ✓ | 兼容占位；当前不执行额外刷新 |
-| `SessionEnd` |  | ✓ | 记录最终 HEAD，创建 transcript 总结任务并启动后台 worker |
+| 事件 | Codex CLI | Claude Code CLI | Trae | Trae CN | 行为 |
+| --- | :-: | :-: | :-: | :-: | --- |
+| `SessionStart` | ✓ | ✓ | ✓ | ✓ | 读取当前 repo+branch 记忆并注入会话；同一 session 的重复触发幂等跳过 |
+| `Stop` | ✓ | ✓ | ✓ | ✓ | 每次回复后记录轻量 HEAD marker；payload 有会话信息时登记扫描候选 |
+| `PreCompact` |  | ✓ |  |  | 兼容占位；当前不执行额外刷新 |
+| `SessionEnd` |  | ✓ |  |  | 记录最终 HEAD，创建 transcript 总结任务并启动后台 worker |
 
 `SessionStart` 的幂等记录位于 `<repo-memory>/jobs/session-start/injected/*.json`。重复触发只记录 skip 日志，不重复注入上下文。
 
@@ -53,7 +64,7 @@ dev-memory-cli install-hooks claude
 
 ### 生效范围
 
-`SessionEnd` 自动总结仅由 **Claude Code CLI** 的生命周期事件触发。Codex CLI hook 模板没有 `SessionEnd`；它的 `Stop` 只登记候选，不在每轮回答后启动模型。Codex Desktop 不使用这组项目 hook。
+`SessionEnd` 自动总结仅由 **Claude Code CLI** 的生命周期事件触发。Codex、Trae 和 Trae CN 模板都不注册 `SessionEnd`；它们的 `Stop` 只做轻量记录，不在每轮回答后启动模型。Codex Desktop 不使用这组项目 hook。
 
 总结任务的触发端与执行端是两个独立概念：
 
@@ -138,13 +149,13 @@ dev-memory-cli session-scan status
 
 ### 执行器配置
 
-`~/.dev-memory/config.json` 中的 `session_scan` 独立配置扫描执行器。默认提供 `coco`、`codex`、`claude` 三个 preset，并按顺序选择第一个已安装且启用的命令：
+`~/.dev-memory/config.json` 中的 `session_scan` 独立配置扫描执行器。默认提供 `coco`、`codex`、`claude` 三个 preset，并按 `claude → codex` 选择第一个已安装且启用的命令；`coco` preset 为兼容保留，可显式加入 `order`：
 
 ```json
 {
   "session_scan": {
     "executor": "auto",
-    "order": ["coco", "codex", "claude"],
+    "order": ["claude", "codex"],
     "schedule_times": ["03:00", "13:00"],
     "skip_when_computer_active": true,
     "active_within_minutes": 10,
@@ -214,6 +225,8 @@ dev-memory-cli session-scan uninstall
 
 - Claude 把 [hooks/hooks.json](hooks.json) 合并到 `.claude/settings.local.json`。
 - Codex CLI 把 [hooks/codex-hooks.json](codex-hooks.json) 合并到 `.codex/hooks.json`。
+- Trae 把 [hooks/trae-hooks.json](trae-hooks.json) 合并到 `.trae/hooks.json`。
+- Trae CN 把同一模板合并到 `.trae-cn/hooks.json`；模板声明 Trae 要求的 `version: 1`。
 - Codex Desktop 通过本地 rollout 定时扫描覆盖，不依赖项目 hook。
 - 其他仓库需要先安装 CLI，再安装对应 hook；hook 运行时统一调用 `dev-memory-cli hook ...`。
 

package/hooks/trae-hooks.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dev-memory-cli hook session-start",
+            "timeout": 20,
+            "statusMessage": "Loading dev-memory context"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dev-memory-cli hook stop",
+            "timeout": 15,
+            "statusMessage": "Updating dev-memory session marker"
+          }
+        ]
+      }
+    ]
+  }
+}

package/lib/dev_memory_session_scan.py

@@ -126,7 +126,7 @@ def _deep_merge(base, override):
 def default_scan_config():
     return {
         "executor": "auto",
-        "order": ["coco", "codex", "claude"],
+        "order": ["claude", "codex"],
         "executors": json.loads(json.dumps(DEFAULT_EXECUTORS)),
         "schedule_times": ["03:00", "13:00"],
         "skip_when_computer_active": True,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-memory-cli",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "CLI for dev-memory hooks and repo-local setup (formerly @xluos/dev-assets-cli)",
   "license": "MIT",
   "repository": {