weflow-cli 1.8.1 → 1.9.0

package/scripts/chat_stats.py

@@ -83,13 +83,14 @@ def get_biz_keys(config):
     contact_salt = config.get('contactSalt', '')
     contact_key = decrypt_lock(contact_key_enc) if contact_key_enc else ''
 
-    biz_db = os.path.join(msg_dir, 'biz_message_0.db')
-    biz_key_enc = config.get('bizKey', '')
-    biz_salt = config.get('bizSalt', '')
-    if biz_key_enc and biz_salt:
-        biz_key = decrypt_lock(biz_key_enc)
-    else:
-        print('[ERROR] 缺少 biz_message_0.db 密钥，请运行: python scripts/nt_decrypt.py scan --json')
+    # 钥匙派生统一到 `_utils.biz_message_db()`：原来这里只认配置里的 bizKey/bizSalt，
+    # 而那两个键在本机根本不存在（微信 4.x 的钥匙由全库 passphrase 派生）——
+    # 照这条提示去 `config set bizKey` 还会撞上"该键不在 CLI 可写白名单里"。
+    from _utils import biz_message_db
+    try:
+        biz_db, biz_key, biz_salt = biz_message_db(config)
+    except RuntimeError as exc:
+        print('[ERROR] %s' % exc)
         sys.exit(1)
 
     return {

package/scripts/compile_wiki.py

@@ -681,11 +681,20 @@ def build_pages_from_cards(pages_dir: str, card_dirs=None, dry_run: bool = False
     existing = {p.stem.casefold() for p in Path(pages_dir).glob('*.md')}
     out_dir = Path(pages_dir)
     today = time.strftime('%Y-%m-%d')
-    built, skipped, unwritable, no_material, bad_source = [], 0, 0, 0, 0
+    # **只差大小写的两个概念名，在 Windows 上是同一个文件。** 原来的实现让后一个覆盖前一个：
+    # 一页**没了**，而 `built` 把两个都算了（实测 49,953 页里丢 53：AI 那批 44、这批 9）。
+    # 按"文件名（大小写折叠后）"分组 —— 一个文件一张页，其余写法进 `aliases`。这不是新规矩：
+    # `--merge-duplicates` 对"同一个概念的不同写法"做的就是这件事，`wiki_lint` 也一直认别名。
+    groups: dict = {}
     for name, refs in merged.items():
+        groups.setdefault(re.sub(r'[\/:*?"<>|]', '_', name)[:60].casefold(), []).append((name, refs))
+
+    built, skipped, unwritable, no_material, bad_source = [], 0, 0, 0, 0
+    for members in groups.values():
+        name, refs = members[0]                     # 组里第一个当正式名，其余进 aliases
         safe = re.sub(r'[\/:*?"<>|]', '_', name)[:60]
         if safe.casefold() in existing:
-            skipped += 1
+            skipped += len(members)
             continue
         if '[' in name or ']' in name or name.endswith('.md'):
             # 同 `--refresh-sources`：这两类名字体检会报断链（`wiki_lint.resolve` 见到 `.md`
@@ -723,6 +732,19 @@ def build_pages_from_cards(pages_dir: str, card_dirs=None, dry_run: bool = False
             'sources': [ref['file']],
             'summary_by': 'card',
         }
+        # 别名有两类来源，都是**指向这一页的名字**：
+        #   1. 需要净化/截断时保留的原名 —— 否则 Obsidian 里 `[[Qwen3.5:9B]]` 点不开
+        #      `Qwen3.5_9B.md`，`wiki_lint` 也会把这页报成孤儿（2026-10-01 实测 28 张）；
+        #   2. 同一批里只差大小写的另一种写法 —— 它们本来指向同一张页。
+        # 组里的写法也要过"写不得"那关：带方括号或以 `.md` 结尾的名字进了 aliases
+        # 只会给体检添一批假断链（与上面概念名那条同一个理由）。
+        aliases = [name] if safe != name else []
+        for other, _ in members[1:]:
+            if other in aliases or '[' in other or ']' in other or other.endswith('.md'):
+                continue
+            aliases.append(other)
+        if aliases:
+            fm['aliases'] = aliases
         if not dry_run:
             out_dir.mkdir(parents=True, exist_ok=True)
             write_with_frontmatter(str(out_dir / ('%s.md' % safe)), fm, body)

package/scripts/export_chat_html.py

@@ -2379,7 +2379,9 @@ def main():
     # Voice: load the payloads so a cached transcript can be shown. Anything
     # not yet transcribed simply renders as `[语音 N″]`.
     if _WECHAT_VOICE:
-        VOICE_STATE['cache'] = wechat_voice.TranscriptCache(os.path.join(args.out, '.voice-cache'))
+        # 缓存的家由 `wechat_voice` 定义：以前这里按 `--out` 拼，于是同一段音频在不同
+        # 输出目录下会被各转写一遍，而卡片那条线读的又是另一处（2026-10-01）。
+        VOICE_STATE['cache'] = wechat_voice.TranscriptCache(wechat_voice.DEFAULT_CACHE_DIR)
         try:
             VOICE_STATE['map'] = wechat_voice.load_voice_map(
                 args.db, args.key, args.salt, args.passphrase, args.talker)

package/scripts/mcp_bridge.py

@@ -69,13 +69,12 @@ def get_biz_keys(config):
     contact_key_enc = config.get('contactKey', '')
     contact_salt = config.get('contactSalt', '')
     contact_key = decrypt_lock(contact_key_enc) if contact_key_enc else ''
-    biz_db = os.path.join(msg_dir, 'biz_message_0.db')
-    biz_key_enc = config.get('bizKey', '')
-    biz_salt = config.get('bizSalt', '')
-    if biz_key_enc and biz_salt:
-        biz_key = decrypt_lock(biz_key_enc)
-    else:
-        return {'error': '缺少 biz_message_0.db 密钥，请运行 python scripts/nt_decrypt.py scan --json'}
+    # 钥匙派生统一到 `_utils.biz_message_db()`（原来只认 bizKey/bizSalt，见那个函数的注释）
+    from _utils import biz_message_db
+    try:
+        biz_db, biz_key, biz_salt = biz_message_db(config)
+    except RuntimeError as exc:
+        return {'error': str(exc)}
     return {
         'biz_db': biz_db, 'biz_key': biz_key, 'biz_salt': biz_salt,
         'contact_db': contact_db, 'contact_key': contact_key, 'contact_salt': contact_salt,

package/scripts/wechat_voice.py

@@ -33,6 +33,15 @@ EMPTY_MARKER = '\x00empty'
 
 DEFAULT_MODEL = 'small'
 
+# **转写缓存的家**，由这个模块定义，别处一律引用它。
+#
+# 2026-10-01 踩过一次：`chat_notes` 拿自己的输出目录（`output/chat-notes`）去拼缓存路径，于是
+# 它读到的是 `output/chat-notes/.voice-cache` —— 一个刚被它自己建出来的空目录，而真正的缓存
+# 在 `output/.voice-cache`（1,788 条）。它「命中 16 条」那个数字是自洽的，只是与真缓存不相通，
+# 报告看不出来。位置只要有两份定义就会漂，所以从这里定一份。
+# 可用 `WEFLOW_VOICE_CACHE` 覆盖（测试与自定义布局用）。
+DEFAULT_CACHE_DIR = os.environ.get('WEFLOW_VOICE_CACHE') or os.path.join('output', '.voice-cache')
+
 # A Cantonese-tuned model, fetched separately (see the README note in
 # OPERATIONS.md). Worth preferring automatically when present: stock Whisper
 # answers Cantonese speech with fluent-looking Mandarin nonsense - text that

package/scripts/wiki_lint.py

@@ -144,15 +144,28 @@ def inspect(pages: list, exists, card_links=()) -> dict:
     """
     stems = {page['stem'] for page in pages}
     inbound = {stem: 0 for stem in stems}
+    # **别名要归位到它那一页，否则那张页永远被报成孤儿。** 文件名是概念名的一个有损变换
+    # （`:` `/ ? * " < > |` 换成 `_`，再截到 60 字符），而指向它的链接用的是**原名**：
+    # `resolvable_names` 早就把别名算进"存在"了（所以断链是 0），但**入链计数**这里原来只认页码
+    # —— 名字对不上，卡片那条链接既不计入链也不报断链，那一页于是在图里是孤岛。
+    # （2026-10-01 实测：`[[Qwen3.5:9B]]` → `Qwen3.5_9B.md`，49,953 页里有 28 张。）
+    alias_to_stem = {str(alias): page['stem']
+                     for page in pages
+                     for alias in (page.get('aliases') or [])
+                     if str(alias) not in stems}
+
+    def stem_of(name: str) -> str:
+        return alias_to_stem.get(name, name)
+
     for name in card_links:                       # 卡片 → 概念，这是主要入链
-        if not (name.endswith('.md') or '/' in name) and name in inbound:
-            inbound[name] += 1
+        if not (name.endswith('.md') or '/' in name) and stem_of(name) in inbound:
+            inbound[stem_of(name)] += 1
     broken, aspirational, empty = [], [], []
     for page in pages:
         for section, name in links_by_section(page['body']):
             if exists(name):
-                if not (name.endswith('.md') or '/' in name) and name in inbound:
-                    inbound[name] += 1
+                if not (name.endswith('.md') or '/' in name) and stem_of(name) in inbound:
+                    inbound[stem_of(name)] += 1
                 continue
             entry = {'page': page['stem'], 'target': name, 'section': section}
             if any(section.startswith(prefix) for prefix in RELATED_SECTIONS):
@@ -326,12 +339,16 @@ def collect(pages_dir: str, card_dirs) -> list:
                       # 判重按目录分开比（两个目录是两个知识库），所以要记住这张页住哪儿
                       'dir': str(pages_dir),
                       'topic': compile_frontmatter_topic(frontmatter),
-                      'title': str(frontmatter.get('title') or '').strip('"'),
+                      # `parse_frontmatter` 已经把外层引号拆掉了，**这里不能再剥一次**：
+                      # `strip('"')` 会连名字**自己末尾**的引号一起吃掉，`AI 长出"手脚"` 变成
+                      # `AI 长出"手脚` —— 然后它与卡片里那条链接差一个字符，永远匹配不上，
+                      # 那页就被报成孤儿（2026-10-01 实测，49,953 页里 1 张）。
+                      'title': str(frontmatter.get('title') or ''),
                       # **别名也算"指向这一页的名字"**：`--merge-duplicates` 把
                       # `GPT-5.6` 并进 `GPT 5.6` 时就是靠 aliases 让旧链接不断的，
                       # Obsidian 认它。体检不认的话，会把这些名字报成"还没建页、
                       # 建议再跑 compile" —— 而它们已经有页了。
-                      'aliases': [str(a).strip().strip('"').strip("'") for a in raw_aliases],
+                      'aliases': [str(a).strip() for a in raw_aliases],
                       'links': extract_links(body),
                       'body': body})
     return pages
@@ -364,8 +381,14 @@ def main():
     # 只查卡片目录会把这类全报成断链——实测 1,950 条，而它们在 Obsidian 里都是好的
     # （两边文件名本来就不同：卡片保留完整标题，阅读笔记截到 50 字）。
     card_stems = collect_card_stems(tuple(CARD_DIRS) + MATERIAL_DIRS)
+    resolvable = resolvable_names(pages)   # 只算一次（见下面那条注释）
     report = inspect(pages,
-                     lambda name: resolve(name, resolvable_names(pages), CARD_DIRS, card_stems),
+
+                     # **注意别把它写回 lambda 里**：闭包体是**调用时**求值的，
+                     # 写在里面等于每条链接都重建一次全部页名的集合 —— 实测文章线
+                     # （3,623 页）因此要 9 分 29 秒，聊天线（1,527 页）只要 3.2 秒。
+                     # 提出来算一次之后是同一条线的秒级。
+                     lambda name: resolve(name, resolvable, CARD_DIRS, card_stems),
                      card_links)
     report['success'] = True
     report['pagesDir'] = existing

package/src/panel/server.ts

@@ -34,6 +34,7 @@ import {
   writeEndpoint, type PanelChannelMode, type PanelEndpoint,
 } from './endpoint.js'
 import type { AssistantService, TurnOutcome } from '../services/assistantService.js'
+import { describeForPanel } from '../services/assistantTrace.js'
 import { privacyGate } from '../services/assistantPrivacy.js'
 import { configService } from '../services/configService.js'
 import { resolvePackageRoot } from '../utils/packageRoot.js'
@@ -66,6 +67,16 @@ const STATIC_FILES: Record<string, string> = {
   '/panel/mascot-thinking.png': 'mascot-thinking.png',
   '/panel/mascot-sorry.png': 'mascot-sorry.png',
   '/panel/mascot-tired.png': 'mascot-tired.png',
+  // 眼球跟随鼠标用的两层（2026-09-30）：`mascot-base.png` 是**把虹膜挖掉**的球面、
+  // `mascot-iris.png` 是可以单独平移的虹膜层（含瞳孔与高光）。零偏移叠回去与原图**逐像素相同**
+  // （脚本验过），所以换上去不会看出任何差别，只是眼睛能动了。
+  // 同上：**漏一张，球在那个瞬间闪成空图**，而 PANEL_ASSET_MISSING 只写在响应里、页面上看不到。
+  '/panel/mascot-base.png': 'mascot-base.png',
+  '/panel/mascot-iris.png': 'mascot-iris.png',
+  // 半隐时那张脸（2026-09-30）：身子藏在屏幕边后面、只把脑袋探出来。
+  // 它的左边**必须是一条笔直的切边**（内容贴着画布 x=0），贴上去才跟屏幕边严丝合缝——
+  // 所以半隐时球的 `border-radius` 也要去掉（圆会把那条切边剪成弧）。
+  '/panel/mascot-peek.png': 'mascot-peek.png',
 }
 const CONTENT_TYPES: Record<string, string> = {
   '.html': 'text/html; charset=utf-8',
@@ -346,7 +357,20 @@ export async function startPanelServer(options: PanelServerOptions): Promise<Pan
         }
         const outcome = raced.value
         if (outcome.status === 'replied' || outcome.status === 'quota-exceeded') {
-          json(res, 200, { ok: true, status: outcome.status, reply: outcome.text, memoryBucket })
+          // 顺带把这一轮的**轨迹**给页面：它折叠着显示成"思考过程"（默认收起）。
+          // 与微信里发「轨迹」看到的**是同一份**（都来自 `traces`，同一个 `describeForChat` 格式，
+          // 同样不含 userId）。没有轨迹就给空对象——页面据此不显示那一块。
+          //
+          // **它出错不许把答复弄丢**：轨迹是附加物，答复才是这一轮的结果。所以这里 catch 住——
+          // 顶多少一块"思考过程"，不能因为附加物把 200 变成 500（第一版没包，测试立刻抓到：
+          // 桩服务没有 `recentTrace`，于是每条 ask 都成了 500）。
+          let trace = { lines: [] as string[], reasoning: '' }
+          try {
+            trace = describeForPanel(service.recentTrace(memoryBucket))
+          } catch { /* 附加物失败不影响答复 */ }
+          json(res, 200, {
+            ok: true, status: outcome.status, reply: outcome.text, memoryBucket, trace,
+          })
           return
         }
         if (outcome.status === 'not-running') {