evolcore 0.0.39 → 0.0.40

package/kits/{rules/07-memory-and-thread.md → templates/system-fragments/thread.md}

@@ -1,59 +1,13 @@
-# 记忆与话题：持久化上下文的两套机制
+[thread] 话题系统（ec thread）
+触发词：话题/thread/summary/摘要/ec thread/话题名/工作报告
 
-触发词：记忆/memory/话题/thread/summary/摘要/ec memory/ec thread/话题名/工作报告
+话题摘要是**话题级**的进展快照：这条任务线做了什么、结果如何，供下次激活时快速恢复。
+对端的长期事实（偏好、角色、背景）不写这里，写记忆（见 `[memory]` 段）。
 
-这两套机制共同解决"跨会话上下文丢失"的问题，但定位不同：
+`ec thread` 的 `<peer>` 参数是对端**裸 AID**（取 `peerId`，如 `alice.agentid.cn`），
+不是 `aun#…` 形态的 peerKey；传 peerKey 会静默返回 0 条。
 
-| 机制 | 粒度 | 作用 | 写入时机 |
-|------|------|------|----------|
-| 记忆（memory） | 对端级 / agent 级 / owner 级 | 跨所有话题持久化的长期事实 | 每轮对话中识别到值得保留的事实时 |
-| 话题摘要（summary） | 话题级 | 这个话题的进展快照，供下次激活时快速恢复 | 阶段完成时、离开话题前 |
-
-两者不冲突，按粒度分工：对端的基本信息（偏好、角色、背景）写进记忆；这个任务线做了什么、结果如何写进话题摘要。
-
----
-
-## 一、记忆系统（ec memory）
-
-记忆是写给自己、跨会话持久的事实。不要依赖会话上下文来记住用户说过的事，用记忆系统写下来。
-
-### 什么时候写记忆
-
-**必须写的情况**：
-- 用户告知了关于自己的事实（姓名、职业、偏好、背景）
-- 用户明确要求"记住"某件事
-- 发现了跨会话有用的规律（用户的工作方式、反馈模式）
-
-**不要写的情况**：
-- 当前话题的具体进展（写话题摘要，不写记忆）
-- 只在本会话有意义的临时状态
-- 代码结构、文件路径、git 历史（代码库本身就记录了）
-
-### 记忆命令
-
-```bash
-# 写入新 note
-ec memory note --slug <slug> [--tags '<tag1>,<tag2>'] '<正文>'
-
-# 修改已有 note
-ec memory note update <slug> '<新正文>'
-
-# 查看待整理 notes
-ec memory note list
-
-# 触发整理会话（将 notes 归档为正式记忆）
-ec memory consolidate
-```
-
-### 默认行为
-
-记忆写入动作默认**静默**，不打断对话。用户明确要求记住某事时，给一句简短确认（"已记下"），然后继续。
-
----
-
-## 二、话题系统（ec thread）
-
-### 标准工作流
+## 标准工作流
 
 ```bash
 # 1. 列出本机所有 agent
@@ -71,11 +25,11 @@ ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
 # 5. 查看某话题的历史消息
 ec thread history <peer>/<threadId> --self <selfAid> --limit 20
 
-# 6. 查看/更新话题摘要
+# 6. 查看话题摘要（写摘要见下文「话题摘要维护」）
 ec thread summary show <peer>/<threadId> --self <selfAid>
 ```
 
-### 跨话题发送（联系当前对端以外的对象）
+## 跨话题发送（联系当前对端以外的对象）
 
 一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端；要联系**其他**对象，必须换到与该对象的话题上发送：
 
@@ -95,7 +49,7 @@ ec group send '<text>' --thread <threadId> --check-every 5m     # 群对端
 - `--check-every` 会创建周期复查 Trigger（每次发送各新建一个，名称 `check-<目标>-from-<来源>-<唯一后缀>`），
   需显式 `ec trigger delete <trigger_id>` 结束（不要用 `cancel`，那只是 disable，会留下挂起的死 Trigger）；定位用返回的 `trigger_id`（`trig_…`），**不是名称**
 
-### 话题名称维护
+## 话题名称维护
 
 **何时更新名称**（主动触发，不等对端问）：
 
@@ -115,7 +69,7 @@ ec thread rename current '<新名称>'                              # 托管会
 ec thread rename <peer>/<threadId> '<新名称>' --self <selfAid>  # 宿主终端
 ```
 
-### 话题摘要维护
+## 话题摘要维护
 
 摘要是话题的进展快照，**daemon 不自动总结**，需要主动写入。
 
@@ -134,8 +88,7 @@ ec thread summary set current '<摘要内容>' --name '<新标题>'   # 2. 写
 ec thread summary show <peer>/<threadId>                              # 1. 拿 coveredThroughTs
 ec thread history <peer>/<threadId> --after <coveredThroughTs> --limit 50   # 2. 读增量
 ec thread history <peer>/<threadId> --before <最早ts-1> --limit 50    # 3. 增量多则往回翻页
-ec thread summary set <peer>/<threadId> '<摘要内容>'                   # 4. 读完再写（游标自动推进）
-ec thread rename <peer>/<threadId> '<新名称>'                           # 5. 必要时改名
+ec thread summary set <peer>/<threadId> '<摘要内容>' --name '<新标题>'   # 4. 读完再写（游标自动推进）
 ```
 
 **关键约束**：`summary set` 把游标设为**当时话题的最新一条**，所以跨话题总结**必须先把增量读完再写**——
@@ -164,22 +117,15 @@ ec thread rename <peer>/<threadId> '<新名称>'                           # 5.
 - summary 是本端私有的（keyed by 本地 sessionId），只写"我下次该知道什么"，不写给对端的话
 
 ```bash
-# 查看当前摘要和版本号
-ec thread summary show current
-
-# 写入摘要（单 agent）
-ec thread summary set current '<摘要内容>'
-
-# 写入摘要（多 agent 协作，用 CAS 防覆盖）
-ec thread summary set current '<摘要内容>' --if-rev <当前rev>
-
-# 查看摘要历史
-ec thread summary log current
+ec thread summary set current '<摘要内容>' --name - --if-rev <当前rev>   # 多 agent 协作，CAS 防覆盖
+ec thread summary log current                                            # 查看摘要历史
 ```
 
 `ec thread list` 输出里摘要显示"未总结"就是行动信号。
 
-### 话题状态管理
+**不要**：每条消息后都更新摘要（只在阶段完成时）；把摘要写成会议纪要；因为对端没问就不更新。
+
+## 话题状态管理
 
 ```bash
 ec thread status current in_progress    # 开始处理
@@ -188,12 +134,3 @@ ec thread status current completed      # 任务完成
 ```
 
 状态改为 `completed` 前，先写入最终摘要。
-
----
-
-## 三、不需要做的事
-
-- 不要在每条消息后都更新摘要——只在阶段完成时
-- 不要把话题摘要当成会议纪要——简短的进展摘记即可
-- 不要把当前话题的进展写进记忆——那是话题摘要的工作
-- 不要因为对端没问就不更新——摘要和记忆都是给自己的

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -54,14 +54,14 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "0.5.23",
+    "@agentunion/fastaun": "0.5.25",
     "@anthropic-ai/claude-agent-sdk": "0.3.300",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.20.0",
     "chokidar": "^5.0.0",
     "cron-parser": "^5.5.0",
     "dotenv": "^17.4.2",
-    "ec-web": "0.0.39",
+    "ec-web": "0.0.40",
     "ignore": "7.0.5",
     "image-type": "^6.0.0",
     "partial-json": "0.1.7",