evolcore 0.0.32 → 0.0.34

package/kits/skills/wechat-article-media-download/scripts/download.py

@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""
+wechat-article-media-download
+Download all videos and images embedded in a WeChat official account article.
+
+Works WITHOUT a WeChat client and WITHOUT mp.weixin.qq.com login:
+video direct links (signed mpvideo.qpic.cn URLs) are extracted from the
+inline JS data blocks of the article HTML itself.
+
+Usage:
+    python3 download.py <article_url> [output_dir]
+
+Requires: Python 3.7+ (stdlib only)
+"""
+
+import html as htmllib
+import json
+import os
+import re
+import sys
+import threading
+import urllib.request
+
+UA = (
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
+    "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36"
+)
+HEADERS = {"User-Agent": UA, "Referer": "https://mp.weixin.qq.com/"}
+
+# preferred video formats, best first (10002 = 超清 H.264)
+FORMAT_PRIORITY = ["10002", "10102", "10004", "10104"]
+
+
+def fetch(url, dest=None):
+    req = urllib.request.Request(url, headers=HEADERS)
+    with urllib.request.urlopen(req, timeout=120) as resp:
+        data = resp.read()
+    if dest:
+        with open(dest, "wb") as f:
+            f.write(data)
+    return data
+
+
+def unescape_js(html_text):
+    """Undo the JS escaping used in article data blocks.
+
+    Video URLs are stored like `url: 'http://mpvideo.qpic.cn/...\\x26amp;dis_t=...'`.
+    Missing this step truncates every URL at its first `&`.
+    """
+    txt = htmllib.unescape(html_text)
+    txt = txt.replace("\\x26amp;", "&").replace("\\x26;", "&").replace("\\x26", "&")
+    return txt
+
+
+def extract_images(html_text):
+    seen, out = set(), []
+    for u in re.findall(r'data-src="(https://mmbiz\.qpic\.cn/[^"]+)"', html_text):
+        if u not in seen:
+            seen.add(u)
+            fmt_m = re.search(r"wx_fmt=(\w+)", u)
+            out.append((u, fmt_m.group(1) if fmt_m else "png"))
+    return out
+
+
+def extract_videos(html_text):
+    """Return an ordered list of (best_format, url) — one entry per article video.
+
+    Each video appears as ~4 format variants sharing the same base path;
+    order of first appearance matches article order.
+    """
+    txt = unescape_js(html_text)
+    blocks = re.findall(
+        r"format_id:\s*'(\d+)'\s*\*[^}]*?url:\s*'(http://mpvideo\.qpic\.cn/[^']+)'",
+        txt,
+        re.S,
+    )
+    groups, order = {}, []
+    for fid, url in blocks:
+        m = re.match(r"(http://mpvideo\.qpic\.cn/[a-z0-9]+)\.f\d+\.mp4", url)
+        if not m:
+            continue
+        base = m.group(1)
+        if base not in groups:
+            groups[base] = {}
+            order.append(base)
+        groups[base][fid] = url
+    plan = []
+    for base in order:
+        for fid in FORMAT_PRIORITY:
+            if fid in groups[base]:
+                plan.append((fid, groups[base][fid]))
+                break
+    return plan
+
+
+def download_all(items, outdir, prefix, ext_default="bin"):
+    """items: list of (name_hint, url, ext). Returns list of (path, size)."""
+    os.makedirs(outdir, exist_ok=True)
+    results, lock = [], threading.Lock()
+
+    def work(i, url, ext):
+        path = os.path.join(outdir, f"{prefix}_{i:02d}.{ext}")
+        try:
+            fetch(url, path)
+            size = os.path.getsize(path)
+        except Exception as e:  # noqa: BLE001
+            size = 0
+            with lock:
+                print(f"  [FAIL] {path}: {e}")
+        with lock:
+            print(f"  [OK] {path} ({size / 1024:.0f} KB)" if size else f"  [FAIL] {path}")
+            results.append((path, size))
+
+    threads = [
+        threading.Thread(target=work, args=(i, url, ext))
+        for i, (url, ext) in enumerate(items, 1)
+    ]
+    for t in threads:
+        t.start()
+    for t in threads:
+        t.join()
+    return sorted(results)
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(__doc__)
+        sys.exit(1)
+    article_url = sys.argv[1]
+    outdir = sys.argv[2] if len(sys.argv) > 2 else "output"
+
+    print(f"[1/4] Fetching article: {article_url}")
+    html_text = fetch(article_url).decode("utf-8", errors="ignore")
+
+    title_m = re.search(r'<meta property="og:title" content="([^"]*)"', html_text)
+    print(f"      Title: {title_m.group(1) if title_m else 'N/A'}")
+
+    print("[2/4] Extracting media links ...")
+    images = extract_images(html_text)
+    videos = extract_videos(html_text)
+    print(f"      Found {len(videos)} videos, {len(images)} images")
+
+    print(f"[3/4] Downloading to {outdir}/ ...")
+    vres = download_all([(u, "mp4") for _, u in videos], os.path.join(outdir, "videos"), "video")
+    ires = download_all([(u, e) for u, e in images], os.path.join(outdir, "images"), "image")
+
+    print("[4/4] Verification")
+    ok_v = sum(1 for _, s in vres if s > 100_000)
+    ok_i = sum(1 for _, s in ires if s > 0)
+    print(f"      videos: {ok_v}/{len(vres)} valid (>100KB)")
+    print(f"      images: {ok_i}/{len(ires)} valid")
+
+    json.dump(
+        {"article": article_url, "videos": [u for _, u in videos], "images": [u for u, _ in images]},
+        open(os.path.join(outdir, "sources.json"), "w"),
+        ensure_ascii=False,
+        indent=1,
+    )
+    print("Done. Link sources saved to sources.json")
+
+
+if __name__ == "__main__":
+    main()

package/kits/skills/wechat-article-reader/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: wechat-article-reader
+description: >-
+  从微信公众号文章链接提取正文、图片、视频,保存为 Markdown 和本地媒体文件。
+  当用户提供 mp.weixin.qq.com/s 格式的链接,并要求"阅读""保存""下载""提取正文"
+  "抓取文章"时使用。输出 Markdown 正文(图片/视频引用本地相对路径)、
+  下载好的图片/视频文件、统计信息。零外部依赖,只需 Node.js ≥22。
+  不适用于需要登录才能查看的付费文章、视频号来源的视频、已删除的文章。
+license: MIT
+---
+
+# 微信公众号文章阅读器
+
+从公众号文章链接提取完整内容并保存到本地,包含正文 Markdown、图片、视频。
+
+## 功能
+
+- 提取文章标题、作者、发布时间、正文
+- 下载所有图片(自动取原图)
+- 下载所有视频(选最高清晰度)
+- 输出 Markdown,图片/视频引用本地相对路径
+- 生成统计信息(文字数、图片数、视频数、成功/失败数)
+- 原始链接存档到 sources.json
+
+## 依赖
+
+- Node.js ≥ 22
+- 零外部依赖(只用 Node 标准库)
+
+## 用法
+
+```bash
+node "<技能目录>/scripts/fetch.mjs" "<文章URL>" [输出目录]
+```
+
+**示例:**
+
+```bash
+node "<技能目录>/scripts/fetch.mjs" \
+  "https://mp.weixin.qq.com/s/xxxxxx"
+```
+
+默认输出到当前目录下的 `wechat-articles/日期_公众号_标题/`。
+
+输出结构:
+
+```
+wechat-articles/
+└── 2026-10-08_机器之心_豆包大模型…/
+    ├── article.md        # 正文 Markdown
+    ├── images/           # 图片文件
+    │   ├── cover.png
+    │   └── 001.jpg
+    ├── videos/           # 视频文件
+    │   └── 001.mp4
+    └── sources.json      # 原始链接存档
+```
+
+## 原理
+
+### 图片
+- 从 `data-src="https://mmbiz.qpic.cn/..."` 提取 URL
+- URL 中的 `/640?` 改成 `/0?` 取原图
+- 无需 Referer,直接下载
+
+### 视频
+- 从页面内嵌 JS 数据块提取签名直链
+- 每个视频有多种清晰度(format_id):优先 10002(超清 H.264),
+  依次回退 10102 → 10004 → 10104
+- 签名 URL 短期有效,必须在提取后立即下载
+- 视频号(Channels)来源无直链,无法下载
+
+### 正文
+- 定位 `#js_content` 容器
+- 转换为 Markdown:保留段落、加粗、图片、视频占位
+- 图片/视频路径改写为本地相对路径
+
+## 统计
+
+文章末尾追加:
+
+```
+---
+📊 统计: 3120 字 | 图片 8/8 | 视频 5/9 (4 个失败: 403 签名失效)
+```
+
+格式:正文字数 | 图片成功/总数 | 视频成功/总数 (失败原因)
+
+## 边界与限制
+
+- **视频限频**:微信 CDN 对同一出口 IP 短时间内重复请求同一视频会返回 403。
+  脚本已加入随机延迟和重试,但无法完全避免。失败的视频会在统计中明确标注。
+- **视频号视频**:无签名直链,跳过并标注。
+- **付费/仅粉丝文章**:页面返回验证页或空内容,脚本报错退出。
+- **已删除文章**:同上。
+- **零依赖**:只用 Node.js 标准库,无需 npm install。
+- **路径规则**:执行时必须用脚本的绝对路径,不依赖 cwd。

package/kits/skills/wechat-article-reader/scripts/fetch.mjs

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+import { writeFile, mkdir } from 'node:fs/promises';
+import { createWriteStream } from 'node:fs';
+import { basename, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+
+const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36';
+const BS = String.fromCharCode(92);
+
+function usage() {
+  console.error('用法: node fetch.mjs <文章URL> [输出根目录]');
+  console.error('示例: node fetch.mjs "https://mp.weixin.qq.com/s/xxxxx" ./my-articles');
+  process.exit(1);
+}
+
+// HTML 实体解码(处理微信视频 URL 里的 \x26amp; \x26)
+function decodeVideoUrl(raw) {
+  return raw.split(BS + 'x26amp;').join('&')
+    .split(BS + 'x26').join('&')
+    .split('&amp;').join('&');
+}
+
+// 微信图片 URL：把路径里的尺寸段换成 0 拿原图，并统一解实体
+function toOriginal(src) {
+  return src.replace(/&amp;/g, '&').replace(/\/\d+\?/, '/0?');
+}
+
+// 安全文件名(跨平台)
+function sanitize(s, maxLen = 80) {
+  if (!s) return '';
+  return s.replace(/[\[\]()/\\:*?"<>|]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/\.$/, '')
+    .slice(0, maxLen)
+    .trim();
+}
+
+// 从 js_content 开标签处切出正文：跳到标签闭合的 '>'，再按 div 深度配对
+function sliceJsContent(html, from) {
+  const openEnd = html.indexOf('>', from);
+  if (openEnd < 0) throw new Error('正文容器标签未闭合');
+  const rest = html.slice(openEnd + 1);
+
+  // 微信正文是 <div id="js_content">…</div>，内部还有大量嵌套 div
+  let depth = 1, pos = 0;
+  const re = /<(\/?)div\b[^>]*>/gi;
+  re.lastIndex = 0;
+  let m;
+  while ((m = re.exec(rest))) {
+    depth += m[1] ? -1 : 1;
+    if (depth === 0) return rest.slice(0, m.index);
+    pos = re.lastIndex;
+  }
+  // 配对失败时退回旧策略：截到第一个 <script>
+  const s = rest.indexOf('<script');
+  return s > 0 ? rest.slice(0, s) : rest;
+}
+
+// 下载文件。403 是签名失效或 CDN 限频，重试无意义，直接失败；
+// 网络抖动与 5xx/429 才退避重试。
+async function download(url, dest) {
+  let lastErr;
+  for (const wait of [0, 1200, 3000]) {
+    if (wait) await new Promise(r => setTimeout(r, wait));
+    try {
+      const r = await fetch(url, { headers: { 'User-Agent': UA } });
+      if (!r.ok) {
+        const err = new Error(`HTTP ${r.status}`);
+        if (r.status === 403) throw Object.assign(err, { fatal: true });
+        throw err;
+      }
+      await pipeline(r.body, createWriteStream(dest));
+      return dest;
+    } catch (e) {
+      if (e.fatal) throw e;
+      lastErr = e;
+    }
+  }
+  throw lastErr;
+}
+
+async function main() {
+  if (process.argv.length < 3) usage();
+  const url = process.argv[2];
+  const outRoot = process.argv[3] || 'wechat-articles';
+
+  console.log('[1/5] 抓取文章页面...');
+  const pageResp = await fetch(url, { headers: { 'User-Agent': UA } });
+  const html = await pageResp.text();
+
+  if (html.includes('secitptpage') || !html.includes('id="js_content"')) {
+    throw new Error('页面异常:可能遇到验证页、付费墙或文章已删除');
+  }
+
+  // 提取元信息
+  const titleMatch = html.match(/<meta property="og:title" content="([^"]*)"/);
+  const title = titleMatch ? titleMatch[1].replace(/&quot;/g, '"').replace(/&amp;/g, '&') : '未命名文章';
+
+  const nicknameMatch = html.match(/var nickname\s*=\s*htmlDecode\("([^"]*)"\)/);
+  const nickname = nicknameMatch ? nicknameMatch[1] : '未知公众号';
+
+  const createTimeMatch = html.match(/var create_time\s*=\s*"(\d+)"/);
+  const timestamp = createTimeMatch ? Number(createTimeMatch[1]) * 1000 : Date.now();
+  const date = new Date(timestamp).toISOString().slice(0, 10);
+
+  console.log(`    标题: ${title}`);
+  console.log(`    公众号: ${nickname}`);
+  console.log(`    日期: ${date}`);
+
+  // 创建输出目录
+  const dirname = `${date}_${sanitize(nickname, 20)}_${sanitize(title, 40)}`;
+  const outDir = join(outRoot, dirname);
+  await mkdir(join(outDir, 'images'), { recursive: true });
+  await mkdir(join(outDir, 'videos'), { recursive: true });
+
+  console.log(`[2/5] 提取媒体链接...`);
+
+  // 定位正文：先跳到 js_content 开标签结束的 >，再按 div 深度配对找收尾
+  const containerStart = html.indexOf('id="js_content"');
+  if (containerStart < 0) throw new Error('未找到正文容器 #js_content');
+  const body = sliceJsContent(html, containerStart);
+
+  // 图片：整页去重，URL 里的尺寸段换成 /0 取原图
+  const imgMatches = [...body.matchAll(/data-src="(https:\/\/mmbiz\.qpic\.cn\/[^"]+)"/g)];
+  const images = [...new Set(imgMatches.map(m => toOriginal(m[1])))];
+
+  // 视频：videoPageInfos 里每个 video_id 自带一组清晰度，
+  // 按 video_id 分块，避免相邻视频的清晰度互相串台。
+  const formatsByVid = new Map();
+  const chunks = html.split(/video_id:\s*'(wxv_\d+)'/);
+  for (let i = 1; i < chunks.length; i += 2) {
+    const vid = chunks[i];
+    const block = chunks[i + 1] || '';
+    if (formatsByVid.has(vid)) continue;
+    // 以 format_id 切段，每段里第一个 mpvideo url 就是该清晰度的直链。
+    // 段长随页面模板变化（实测 format_id 到 url 有 550+ 字符），不能用固定距离。
+    const formats = {};
+    const parts = block.split(/format_id:\s*'(10002|10102|10004|10104)'/);
+    for (let k = 1; k < parts.length; k += 2) {
+      const fid = parts[k];
+      if (formats[fid]) continue;
+      const u = (parts[k + 1] || '').match(/url:\s*\(?'(http:\/\/mpvideo\.qpic\.cn\/[^']+)'/);
+      if (u) formats[fid] = decodeVideoUrl(u[1]);
+    }
+    formatsByVid.set(vid, formats);
+  }
+
+  const pickBestUrl = formats => {
+    for (const fid of ['10002', '10102', '10004', '10104']) {
+      if (formats[fid]) return { format: fid, url: formats[fid] };
+    }
+    return null;
+  };
+
+  // 正文里视频按 iframe 出现顺序，用 data-mpvid 关联；同一视频只算一次
+  const orderedVids = [...new Set([...body.matchAll(/data-mpvid="(wxv_\d+)"/g)].map(m => m[1]))];
+  const videos = [];
+  for (const vid of orderedVids) {
+    const best = pickBestUrl(formatsByVid.get(vid) || {});
+    if (best) videos.push({ vid, ...best });
+    else videos.push({ vid, format: null, url: null, reason: '无直链(视频号或已下架)' });
+  }
+
+  console.log(`    图片: ${images.length} 个`);
+  console.log(`    视频: ${videos.length} 个`);
+
+  console.log('[3/5] 下载图片...');
+  const imageResults = [];
+  for (let i = 0; i < images.length; i++) {
+    const url = images[i];
+    const ext = url.match(/wx_fmt=(\w+)/)?.[1] || (url.includes('_gif') ? 'gif' : 'jpg');
+    const filename = `${String(i + 1).padStart(3, '0')}.${ext}`;
+    const dest = join(outDir, 'images', filename);
+    try {
+      await download(url, dest);
+      imageResults.push({ ok: true, url, path: `images/${filename}` });
+      process.stdout.write(`    ✓ ${filename}\r`);
+    } catch (e) {
+      imageResults.push({ ok: false, url, error: e.message });
+      process.stdout.write(`    ✗ ${filename} (${e.message})\n`);
+    }
+  }
+  console.log(`    完成: ${imageResults.filter(r => r.ok).length}/${images.length}`);
+
+  console.log('[4/5] 下载视频...');
+  const videoResults = [];
+  for (let i = 0; i < videos.length; i++) {
+    const { vid, format, url, reason } = videos[i];
+    const filename = `${String(i + 1).padStart(3, '0')}.mp4`;
+    const dest = join(outDir, 'videos', filename);
+    if (!url) {
+      videoResults.push({ ok: false, vid, format, url: null, error: reason });
+      console.log(`    ✗ ${filename}: ${reason}`);
+      continue;
+    }
+    try {
+      await download(url, dest);
+      videoResults.push({ ok: true, vid, format, url, path: `videos/${filename}` });
+      console.log(`    ✓ ${filename} (f${format})`);
+    } catch (e) {
+      videoResults.push({ ok: false, vid, format, url, error: e.message });
+      console.log(`    ✗ ${filename} (f${format}, ${e.message})`);
+    }
+    if (i < videos.length - 1) await new Promise(r => setTimeout(r, 800 + Math.random() * 400));
+  }
+  console.log(`    完成: ${videoResults.filter(r => r.ok).length}/${videos.length}`);
+
+  // 远端链接 → 本地路径，供正文改写使用
+  const imageMap = new Map(imageResults.filter(r => r.ok).map(r => [r.url, r.path]));
+  const videoMap = new Map(videoResults.filter(r => r.ok).map(r => [r.vid, r.path]));
+
+  console.log('[5/5] 生成 Markdown...');
+
+  // 简化 HTML 转 Markdown
+  let md = body
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    .replace(/<iframe[^>]*data-mpvid="([^"]+)"[^>]*>(?:<\/iframe>)?/g, (_, vid) => {
+      const local = videoMap.get(vid);
+      return local ? `\n\n[▶ 视频](${local})\n\n` : `\n\n[▶ 视频: ${vid}（未能下载）]\n\n`;
+    })
+    .replace(/<img[^>]*data-src="([^"]+)"[^>]*>/g, (full, src) => {
+      const local = imageMap.get(toOriginal(src));
+      return local ? `\n\n![](${local})\n\n` : `\n\n[图片缺失]\n\n`;
+    })
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<\/p>/gi, '\n\n')
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&quot;/g, '"')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&amp;/g, '&')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+
+  const wordCount = md.replace(/[^一-龥a-zA-Z]/g, '').length;
+  const imgOk = imageResults.filter(r => r.ok).length;
+  const vidOk = videoResults.filter(r => r.ok).length;
+  const vidFail = videos.length - vidOk;
+  const failReason = vidFail > 0 ? ` (${vidFail} 个失败: 403 签名失效/限频)` : '';
+
+  const article = `# ${title}\n\n**作者**: ${nickname}  \n**日期**: ${date}  \n**原文**: ${url}\n\n---\n\n${md}\n\n---\n\n📊 统计: ${wordCount} 字 | 图片 ${imgOk}/${images.length} | 视频 ${vidOk}/${videos.length}${failReason}\n`;
+
+  await writeFile(join(outDir, 'article.md'), article, 'utf8');
+  await writeFile(join(outDir, 'sources.json'), JSON.stringify({
+    url, title, nickname, date, timestamp,
+    images: imageResults,
+    videos: videoResults
+  }, null, 2), 'utf8');
+
+  console.log(`\n✅ 完成! 输出目录: ${outDir}/`);
+}
+
+main().catch(e => { console.error('\n❌', e.message); process.exit(1); });

package/kits/templates/bootstrap-welcome.md

@@ -1,17 +1,17 @@
 你好，我是 {{agentName}}。
 
-我刚刚完成连接，需要先和你确认我的基础信息，然后再进入正常工作状态。
+我刚刚完成连接，先补齐基础信息就可以开始工作。创建时已经填写的有效信息会直接沿用，不需要重复提供或确认。
 
-请帮我确认三项内容：
-1. 显示名：你希望我叫什么？
-2. 简介：我主要负责什么？一句到两句话即可。
-3. 标签：给我 3 到 6 个标签，例如 `代码审查`、`客服助手`、`项目管理`。
+如果还有缺失，或你想修改，可以一次补充相应项：
+1. 显示名：希望使用的名称。
+2. 简介：主要职责或定位，一到两句话即可。
+3. 标签：3 到 6 个检索标签，例如 `代码审查`、`客服助手`、`项目管理`。
 
 当前信息：
 - AID: {{agentAid}}
 - 渠道: {{channel}}
 - Baseagent: {{baseagent}}
 
-如果希望沿用已有 agent.md 信息，可以直接回复“沿用现有信息”；我会先读取并回显现有值，请你确认是否保持或修改，不需要重新输入。
+也可以顺便补充人格属性、话术风格、工作流程、任务偏好（persona，支持文本或 `.md`/`.txt` 文件），以及可选头像（HTTPS 图片地址，或放在当前项目目录/本会话临时目录中的图片文件）。这些都不必现在处理，未提供不影响激活，之后也可以修改。
 
-如果希望重新设定，也可以直接按上面的三项回复。
+如果希望沿用现有信息，直接回复“沿用现有信息”即可；我只会追问缺失或有歧义的部分。

package/kits/templates/memory-consolidation/forget.md

@@ -10,6 +10,11 @@
 
 上下文文件里列出的候选：mtime 超过 `memory.forgetAfterDays` 的记忆。**候选只给路径 + 描述。**
 
+| 来源 | 位置 | 说明 |
+|---|---|---|
+| 候选记忆 | 上下文文件里列出的候选清单 | mtime 超过 `forgetAfterDays` 的条目，只给路径+描述 |
+| 对话历史 | 上下文文件里列出的 `threads/` 快照文件（若有，仅 relation 层） | 上次整理以来的增量对话，辅助判断超期记忆是否仍然有效；agent/owner 层无此文件 |
+
 > **打了 `important` / `urgent` / `profile` 的记忆同样会出现在候选里。**
 > 「永不淘汰」指的是索引截断时不会被截掉（只要它在，就保证进索引），
 > **不代表它免于遗忘审查**。审查的是「这条内容还成不成立」，与它在不在索引里是两个维度。
@@ -58,9 +63,9 @@ ec memory archive <路径>
 若干条超期记忆**单独每一条都不值得续期，但合起来值得留一条**时，产出一条合并版：
 
 ```bash
-ec memory create --scope <本次会话的 scope> --slug <slug> --desc "一句话描述" \
+ec memory create --scope <本次会话的 scope> --slug <slug> --desc '一句话描述' \
   --tags <...> [--keywords <...>] \
-  --replaces "<旧文件1>,<旧文件2>,..." \
+  --replaces '<旧文件1>,<旧文件2>,...' \
   "<合并后的完整内容>"
 ```
 

package/kits/templates/memory-consolidation/generalize.md

@@ -10,6 +10,11 @@
 
 上下文文件里列出的候选：关系级记忆里带 `to-generalize` 标签的条目。**候选只给路径 + 描述**，先只读描述判断；某条描述太简、拿不准的，再读那一条正文。
 
+| 来源 | 位置 | 说明 |
+|---|---|---|
+| 候选记忆 | 上下文文件里列出的候选清单 | 关系级 consolidated/ 里带 `to-generalize` 的条目，只给路径+描述 |
+| 对话历史 | 上下文文件里列出的 `threads/` 快照文件（若有） | 上次本模式整理以来的增量对话，辅助判断泛化结论是否成立；无增量时为空，可忽略 |
+
 ## 产出
 
 写到 **agent 作用域**（`--scope agent`）。
@@ -37,7 +42,7 @@
 **评估后认为不该泛化的，用 `update` 把 `to-generalize` 标签去掉。** 否则每次定时检查都会重新扫到它，反复评估同一条。
 
 ```bash
-ec memory update <关系级记忆路径> --tags "<去掉 to-generalize 后的标签>"
+ec memory update <关系级记忆路径> --tags '<去掉 to-generalize 后的标签>'
 ```
 
 ### 已经存在同类 agent 级记忆
@@ -45,9 +50,9 @@ ec memory update <关系级记忆路径> --tags "<去掉 to-generalize 后的标
 如果 agent 级里已经有讲同一件事的记忆，**用 `--replaces` 同时替换两边**，产出合并后的版本：
 
 ```bash
-ec memory create --scope agent --slug commit-chinese --desc "commit 消息用中文" \
-  --tags "rule,long-term" --keywords "commit,git" \
-  --replaces "consolidated/20260901-120000-commit.md,$RELATIONS_DIR/<peerKey>/memory/consolidated/20261002-103100-commit-chinese.md" \
+ec memory create --scope agent --slug commit-chinese --desc 'commit 消息用中文' \
+  --tags 'rule,long-term' --keywords 'commit,git' \
+  --replaces 'consolidated/20260901-120000-commit.md,$RELATIONS_DIR/<peerKey>/memory/consolidated/20261002-103100-commit-chinese.md' \
   "（合并后的完整内容）"
 ```
 

package/kits/templates/memory-consolidation/notes.md

@@ -25,17 +25,17 @@
 ### ① 是新的稳定结论 → create
 
 ```bash
-ec memory create --scope relation --slug commit-chinese --desc "对端要求 commit 消息用中文" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
+ec memory create --scope relation --slug commit-chinese --desc '对端要求 commit 消息用中文' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
   "对端明确要求：commit message 必须用中文，并列出所有功能改动点。"
 ```
 
 ### ② 和已有记忆是同一条，但内容更全或更准 → create --replaces
 
 ```bash
-ec memory create --scope relation --slug commit-chinese --desc "对端要求 commit 用中文，注释不限" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
-  --replaces "consolidated/20261001-103100-commit-chinese.md" \
+ec memory create --scope relation --slug commit-chinese --desc '对端要求 commit 用中文，注释不限' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
+  --replaces 'consolidated/20261001-103100-commit-chinese.md' \
   "对端要求 commit message 用中文；代码注释可以是英文。"
 ```
 
@@ -44,7 +44,7 @@ ec memory create --scope relation --slug commit-chinese --desc "对端要求 com
 ### ③ 已有记忆还成立，只是状态变了 → update
 
 ```bash
-ec memory update consolidated/20261002-090000-refactor-plan.md --tags "rule,done"
+ec memory update consolidated/20261002-090000-refactor-plan.md --tags 'rule,done'
 ```
 
 ### ④ 不值得长期保留 → 丢弃
@@ -70,9 +70,9 @@ ec memory update consolidated/20261002-090000-refactor-plan.md --tags "rule,done
 
 ```bash
 ec memory create --scope relation --slug commit-convention \
-  --desc "对端要求 commit 用中文、按功能列出改动" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
-  --replaces "consolidated/a.md,consolidated/b.md" \
+  --desc '对端要求 commit 用中文、按功能列出改动' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
+  --replaces 'consolidated/a.md,consolidated/b.md' \
   "（合并后的完整内容）"
 ```
 
@@ -92,13 +92,13 @@ note 的 frontmatter 里如果有 `chatType: group`，整理时需要按信息
 ```bash
 # 关于群本身的记忆（默认路由，不加 --peer）
 ec memory create --scope relation --slug group-meeting-schedule \
-  --desc "群每周一开技术会" --tags "rule,verified" \
+  --desc '群每周一开技术会' --tags 'rule,verified' \
   "该群约定每周一 10:00 召开技术同步会。"
 
 # 关于发言人自身的记忆（指定发言人的 relation）
 ec memory create --scope relation --peer aun#alice.agentid.pub \
   --slug alice-ts-preference \
-  --desc "Alice 偏好 TypeScript，不喜欢注释" --tags "preference,verified" \
+  --desc 'Alice 偏好 TypeScript，不喜欢注释' --tags 'preference,verified' \
   "Alice 明确表示偏好 TypeScript，认为代码自解释，不需要额外注释。"
 ```