@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/sync_carriers.py

@@ -1,259 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-sync_carriers.py - 四载体 description 自动同步 (skill -> command)
-
-为什么需要它:
-  check_carriers.py 能发现漂移, 但修复一直靠手工。git status 里
-  sync_templates.py 长期 M 状态就是手工同步的证据。
-  本脚本把权威源 (skill 的 SKILL.md frontmatter) 的 description 自动同步到
-  command 文件, 让"手工对齐"变成"一条命令"。
-
-权威源 = skill (skills/wl-X/SKILL.md):
-  - skill 更新最频繁 (QoderWork 直接读, 迭代快)
-  - skill 的 description 最全 (含中文 + 英文 + 触发词)
-  - command 的 description 往往是旧版/简化版
-
-同步规则:
-  - 只同步 description 字段 (其他字段 name/argument-hint/auto-approve/allowed-tools 保留)
-  - skill description 可能很长 (含触发词), 但 command 的 description 该简洁
-    → 截取到第一个"。用户说"之前的部分 (核心功能描述), 去掉冗长的触发词列举
-  - 幂等: 已一致则跳过
-  - 支持 --dry-run 预览
-
-Usage:
-    python .qoder/scripts/sync_carriers.py             # 同步所有漂移的
-    python .qoder/scripts/sync_carriers.py --dry-run    # 只预览不改
-    python .qoder/scripts/sync_carriers.py wl-search    # 只同步指定命令
-Exit: 0 = 全部同步完成 (或已一致), 1 = 出错
-"""
-import argparse
-import os
-import re
-import sys
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except (AttributeError, IOError):
-        pass
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from common.paths import get_repo_root
-
-BASE = get_repo_root()
-COMMANDS_DIR = BASE / '.qoder' / 'commands'
-SKILLS_DIR = BASE / '.qoder' / 'skills'
-
-
-def _read_frontmatter(path):
-    """读 .md 的 frontmatter, 返回 (fm_dict, body, raw_fm_text)。
-    raw_fm_text 用于精确替换 (保留原始格式)。
-    """
-    text = path.read_text(encoding='utf-8', errors='ignore')
-    if not text.startswith('---'):
-        return {}, text, ''
-    parts = text.split('---', 2)
-    if len(parts) < 3:
-        return {}, text, ''
-    fm_raw = parts[1]
-    body = parts[2]
-    return _parse_fm(fm_raw), body, fm_raw
-
-
-def _parse_fm(fm_text):
-    """解析 YAML frontmatter (简化版, 不引外部库)。返回 dict。
-    处理带引号的值和裸值。
-    """
-    fm = {}
-    for line in fm_text.splitlines():
-        line = line.rstrip()
-        if not line.strip() or line.strip().startswith('#'):
-            continue
-        if ':' not in line:
-            continue
-        key, _, val = line.partition(':')
-        key = key.strip()
-        val = val.strip()
-        # 去引号
-        if (val.startswith('"') and val.endswith('"')) or \
-           (val.startswith("'") and val.endswith("'")):
-            val = val[1:-1]
-        fm[key] = val
-    return fm
-
-
-def _condense_description(desc):
-    """skill 的 description 往往很长 (含触发词列举), command 的该简洁。
-    截取策略: 保留到"用户说"或"触发"或第一个句号之前的核心描述。
-    保留中英双语部分 (英文描述通常是核心)。
-    """
-    if not desc:
-        return desc
-    # 找截断点: "用户说" / "触发" / "时触发"
-    for marker in ['。用户说', '；用户说', ' 用户说', '。触发:', ' 触发:', '；触发', '。时触发', ' 时触发']:
-        idx = desc.find(marker)
-        if idx > 0:
-            return desc[:idx + 1]  # 含句号
-    # 没找到截断点 → 原样返回 (可能本就简洁)
-    return desc
-
-
-def _find_command_file(name):
-    """在 commands/ 和 commands/optional/ 下找命令文件。返回 Path 或 None。"""
-    for cand in [COMMANDS_DIR / (name + '.md'),
-                 COMMANDS_DIR / 'optional' / (name + '.md')]:
-        if cand.is_file():
-            return cand
-    return None
-
-
-def _find_skill_file(name):
-    """skills/wl-X/SKILL.md。"""
-    p = SKILLS_DIR / name / 'SKILL.md'
-    return p if p.is_file() else None
-
-
-def sync_one(name, dry_run=False):
-    """同步一个命令。返回 ('synced'/'skipped'/'error', 详情)。"""
-    skill_path = _find_skill_file(name)
-    cmd_path = _find_command_file(name)
-    if not skill_path:
-        return 'error', 'skill 不存在: %s' % skill_path
-    if not cmd_path:
-        return 'error', 'command 不存在: %s' % cmd_path
-
-    skill_fm, _, _ = _read_frontmatter(skill_path)
-    skill_desc = skill_fm.get('description', '')
-    if not skill_desc:
-        return 'skipped', 'skill 无 description 字段'
-
-    cmd_fm, cmd_body, cmd_fm_raw = _read_frontmatter(cmd_path)
-    cmd_desc = cmd_fm.get('description', '')
-
-    # 精简 skill desc (command 不该塞一堆触发词)
-    condensed = _condense_description(skill_desc)
-
-    if cmd_desc == condensed:
-        return 'skipped', '已一致'
-
-    # dry-run 只预览
-    if dry_run:
-        return 'would-sync', '  旧: %s\n  新: %s' % (cmd_desc[:70], condensed[:70])
-
-    # 精确替换 frontmatter 里的 description 行
-    new_fm = _replace_desc_in_fm(cmd_fm_raw, condensed)
-    if new_fm is None:
-        return 'error', '无法解析 command frontmatter 的 description 行'
-
-    new_text = '---' + new_fm + '---' + cmd_body
-    cmd_path.write_text(new_text, encoding='utf-8')
-    return 'synced', condensed[:70]
-
-
-def _replace_desc_in_fm(fm_raw, new_desc):
-    """在 frontmatter 原文里替换 description 行。保留其他行原样。
-    返回新的 fm_raw 或 None (无法替换)。
-    """
-    # 匹配 description: 开头的行 (可能带引号)
-    # 用 json.dumps 保证引号转义正确 (description 含特殊字符)
-    escaped = _yaml_escape(new_desc)
-    pat = re.compile(r'^(\s*description:\s*)(.*)$', re.MULTILINE)
-    new_fm, n = pat.subn(lambda m: m.group(1) + escaped, fm_raw, count=1)
-    if n == 0:
-        # 没有 description 行 → 插一行 (在 name: 之后)
-        if re.search(r'^\s*name:', fm_raw, re.MULTILINE):
-            new_fm = re.sub(
-                r'^(\s*name:\s*.*)$',
-                r'\1\ndescription: ' + escaped,
-                fm_raw, count=1, flags=re.MULTILINE)
-        else:
-            return None
-    return new_fm
-
-
-def _yaml_escape(s):
-    """YAML 字符串转义: 含特殊字符(: # 等)用双引号包裹, 内部双引号转义。
-    简化: 一律用双引号 + JSON 转义 (最安全)。
-    """
-    import json
-    return json.dumps(s, ensure_ascii=False)
-
-
-def find_drifted_commands():
-    """找出所有 command↔skill 配对且 description 漂移的命令名。
-    (复用 check_carriers 的相似度判断)
-    """
-    from difflib import SequenceMatcher
-    drifted = []
-    if not SKILLS_DIR.is_dir():
-        return drifted
-    for d in sorted(SKILLS_DIR.iterdir()):
-        if not d.is_dir() or not (d / 'SKILL.md').is_file():
-            continue
-        name = d.name
-        cmd = _find_command_file(name)
-        if not cmd:
-            continue
-        skill_fm, _, _ = _read_frontmatter(d / 'SKILL.md')
-        cmd_fm, _, _ = _read_frontmatter(cmd)
-        sd, cd = skill_fm.get('description', ''), cmd_fm.get('description', '')
-        if not sd or not cd:
-            continue
-        sim = SequenceMatcher(None, sd.lower(), cd.lower()).ratio()
-        if sim < 0.85:
-            drifted.append(name)
-    return drifted
-
-
-def main():
-    ap = argparse.ArgumentParser(description='四载体 description 自动同步 (skill -> command)')
-    ap.add_argument('command', nargs='?', default=None,
-                    help='只同步指定命令 (如 wl-search); 不传则同步所有漂移的')
-    ap.add_argument('--dry-run', action='store_true', help='只预览不写文件')
-    args = ap.parse_args()
-
-    print('=' * 56)
-    print('四载体 description 同步 (skill -> command)')
-    print('=' * 56)
-
-    if args.command:
-        names = [args.command]
-    else:
-        names = find_drifted_commands()
-        if not names:
-            print('✅ 无漂移, 所有 command/skill description 已一致。')
-            return 0
-        print('发现 %d 个漂移命令: %s' % (len(names), ', '.join(names)))
-        print()
-
-    synced, skipped, errors = [], [], []
-    for name in names:
-        status, detail = sync_one(name, dry_run=args.dry_run)
-        if status == 'synced':
-            synced.append(name)
-            print('  [✓] %s' % name)
-            print('      %s' % detail)
-        elif status == 'would-sync':
-            synced.append(name)
-            print('  [~] %s (dry-run)' % name)
-            print('%s' % detail)
-        elif status == 'skipped':
-            skipped.append(name)
-        else:
-            errors.append((name, detail))
-            print('  [✗] %s: %s' % (name, detail))
-
-    print()
-    verb = '将同步' if args.dry_run else '已同步'
-    print('%s: %d 同步 / %d 跳过 / %d 错误'
-          % (verb, len(synced), len(skipped), len(errors)))
-    if not args.dry_run and synced:
-        print('提示: 重跑 check_carriers.py 验证一致性。')
-    if errors:
-        return 1
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())