@whyshu/argent-engine 0.0.0-stage → 0.6.1

package/engine/scripts/sku_translate.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""SKU 主数据英文字段自动翻译（中文 → 英文申报名）。
+
+用法:
+  sku_translate.py            # 扫描并翻译缺失的英文字段（品名英文/材质英文）后回填
+  sku_translate.py --dry-run  # 只预览要翻译的内容，不写入
+  sku_translate.py --text "6寸方形淋浴花洒"   # 单条翻译测试（不查表）
+
+翻译引擎: DeepSeek chat API（凭据读取 ~/.dsh/.credentials.yaml 的 DEEPSEEK_API_KEY）
+回填: lark-cli base +record-batch-update（SKU 主数据表）
+"""
+import sys
+import json
+import time
+import subprocess
+import yaml
+import urllib.request
+
+BASE_TOKEN = "TJrmbxuIyauNqrsJL9FclLfbnhc"
+SKU_TABLE = "tblM4SMAB028VCbb"
+
+# 需要翻译的中→英字段对
+TRANSLATE_PAIRS = [
+    ("品名", "品名英文"),        # 中文品名 → 英文品名
+    ("材质中文", "材质英文"),    # 中文材质 → 英文材质
+]
+
+PROMPT_TMPL = (
+    "你是跨境电商物流申报助手。把下面的中文翻译成出口发票用的英文申报名。"
+    "要求：准确、简洁、行业标准叫法；只输出翻译结果本身，不要解释，不要引号。\n"
+    "中文原文：{text}"
+)
+
+
+def load_api_key():
+    cred = yaml.safe_load(open("/Users/chester/.dsh/.credentials.yaml"))
+    key = cred.get("refs", {}).get("DEEPSEEK_API_KEY") or cred.get("DEEPSEEK_API_KEY")
+    if not key:
+        raise SystemExit("✗ 未找到 DEEPSEEK_API_KEY（~/.dsh/.credentials.yaml）")
+    return key
+
+
+def translate(key, text):
+    req = urllib.request.Request(
+        "https://api.deepseek.com/chat/completions",
+        data=json.dumps({
+            "model": "deepseek-chat",
+            "messages": [{"role": "user", "content": PROMPT_TMPL.format(text=text)}],
+            "max_tokens": 120,
+            "temperature": 0.2,
+        }).encode(),
+        headers={"Content-Type": "application/json", "Authorization": f"Bearer {key}"})
+    for attempt in range(3):
+        try:
+            r = json.load(urllib.request.urlopen(req, timeout=60))
+            return r["choices"][0]["message"]["content"].strip()
+        except Exception as e:
+            if attempt == 2:
+                raise
+            time.sleep(2 * (attempt + 1))
+
+
+def cli(*args):
+    return subprocess.run(["lark-cli"] + list(args), capture_output=True, text=True)
+
+
+def list_sku_records():
+    r = cli("base", "+record-list", "--as", "bot", "--base-token", BASE_TOKEN,
+            "--table-id", SKU_TABLE, "--format", "json")
+    d = json.loads(r.stdout)
+    fields = d["data"]["fields"]
+    out = []
+    for i, row in enumerate(d["data"]["data"]):
+        rec = {k: v for k, v in zip(fields, row)}
+        rid = d["data"]["record_id_list"][i] if i < len(d["data"]["record_id_list"]) else None
+        out.append((rid, rec))
+    return out
+
+
+def norm(v):
+    if v is None:
+        return ""
+    if isinstance(v, list):
+        return "".join(str(x) for x in v)
+    return str(v).strip()
+
+
+def translate_and_backfill(key, dry=False):
+    """扫描 SKU 主数据：中文非空且英文为空 → AI 翻译 → 回填。
+
+    返回: {(sku, dst_field): translated} 供调用方直接使用（invoice_runner 集成）。
+    """
+    records = list_sku_records()
+    print(f"SKU 主数据记录数: {len(records)}")
+
+    jobs = []  # (record_id, sku, src_field, src_value, dst_field)
+    for rid, rec in records:
+        sku = norm(rec.get("SKU"))
+        for src_f, dst_f in TRANSLATE_PAIRS:
+            src = norm(rec.get(src_f))
+            dst = norm(rec.get(dst_f))
+            if src and not dst:
+                jobs.append((rid, sku, src_f, src, dst_f))
+
+    if not jobs:
+        print("✓ 没有需要翻译的字段（英文均已填或中文缺失）")
+        return {}
+
+    print(f"待翻译 {len(jobs)} 项:")
+    updates = {}
+    result = {}
+    for rid, sku, src_f, src, dst_f in jobs:
+        print(f"  - {sku}: {src_f}「{src}」→ {dst_f}", end="")
+        if dry:
+            print("  [预览]")
+            continue
+        translated = translate(key, src)
+        updates.setdefault(rid, {})[dst_f] = translated
+        result[(sku, dst_f)] = translated
+        print(f" → {translated}")
+        time.sleep(0.3)
+
+    if dry:
+        print("\n(dry-run，未写入)")
+        return {}
+
+    for rid, fields in updates.items():
+        body = json.dumps({"update_records": {rid: fields}}, ensure_ascii=False)
+        r = cli("base", "+record-batch-update", "--as", "bot", "--base-token", BASE_TOKEN,
+                "--table-id", SKU_TABLE, "--json", body, "--format", "json")
+        ok = "true" in r.stdout.lower() if r.stdout else False
+        print(f"  ✓ 回填 {rid}: {list(fields.keys())} → {'ok' if ok else r.stderr[:120]}")
+    print("完成。")
+    return result
+
+
+def main():
+    dry = "--dry-run" in sys.argv
+    if "--text" in sys.argv:
+        i = sys.argv.index("--text")
+        key = load_api_key()
+        print(translate(key, sys.argv[i + 1]))
+        return
+    translate_and_backfill(load_api_key(), dry=dry)
+
+
+if __name__ == "__main__":
+    main()

package/engine/scripts/sync-plugins.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# 把仓库里的插件同步到**所有**运行位置（本机安装克隆 + DSH profile 快照），并跑门禁。
+#
+# 为什么需要它：2026-09-14 事故复盘——手工 `cp` 时漏掉了 `~/.argent-dsh`，
+# 导致安装克隆里还是**旧的两段 credentials 逻辑**（会把 records 段写坏 → dsh 启动崩）。
+# 单点同步不可靠，必须一次性覆盖全部目标并校验一致性。
+#
+# 用法：bash scripts/sync-plugins.sh [插件名...]   # 默认全部（argent-core/argent-skin/argent-kanban/...）
+set -euo pipefail
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+INSTALL_HOME="${ARGENT_DISH_HOME:-$HOME/.argent-dsh}"
+PROFILE="${DSH_PROFILE:-web}"
+PROFILE_DIR="$HOME/.dsh/profiles/$PROFILE/node_modules"
+
+plugins=("$@")
+if [ ${#plugins[@]} -eq 0 ]; then
+  plugins=()
+  for d in "$REPO"/plugins/*/; do [ -d "$d" ] && plugins+=("$(basename "$d")"); done
+fi
+
+fail=0
+for name in "${plugins[@]}"; do
+  src="$REPO/plugins/$name"
+  [ -d "$src" ] || { echo "  ✗ 不存在: plugins/$name"; fail=1; continue; }
+  echo "▸ $name"
+  for dest in "$INSTALL_HOME/plugins/$name" "$PROFILE_DIR/$name"; do
+    [ -d "$dest" ] || { echo "  · 跳过（未安装）: ${dest/#$HOME/~}"; continue; }
+    # 同步该插件的**全部**内容（代码 + **数据面**：presets.json / presets/ / 模板 / 目录…），
+    # 只排除 node_modules 与 .git。
+    # ⛔ 2026-10-10 事故：旧版只同步枚举的 `src dist package.json` ⇒ 本机 profile 里
+    #   「新插件代码 + 旧 `presets.json`/`presets/*.patch.yml`」并存 ⇒ harness 里
+    #   **14 个 preset 全部注册失败**（bootcheck `fail=13 total=13`，报 "Unknown agent preset"），
+    #   而脚本自己却打印"全部副本一致"（它只比 `src/index.js`）。
+    #   ⇒ 判据改为"整目录一致"，不再靠枚举子目录（以后新增任何插件资产都自动纳入）。
+    rsync -a --quiet --delete-excluded \
+      --exclude 'node_modules' --exclude '.git' \
+      "$src/" "$dest/"
+    # 一致性校验（**整目录**，不再只看 src/index.js）：逐文件比 sha256，报告数量与首个不一致。
+    _n=0; _bad=""
+    while IFS= read -r rel; do
+      [ -n "$rel" ] || continue
+      _n=$((_n + 1))
+      a=$(shasum -a 256 "$src/$rel" | cut -c1-16)
+      b=$(shasum -a 256 "$dest/$rel" 2>/dev/null | cut -c1-16)
+      [ "$a" = "$b" ] || _bad="${_bad}${_bad:+, }$rel"
+    done < <(cd "$src" && find . -type f -not -path './node_modules/*' -not -path './.git/*' | sed 's|^\./||')
+    if [ -z "$_bad" ]; then
+      echo "  ✅ ${dest/#$HOME/~}  $_n 个文件逐字节一致（含数据面）"
+    else
+      echo "  ✗ ${dest/#$HOME/~}  不一致：$_bad"
+      fail=1
+    fi
+  done
+done
+
+echo
+echo "▸ 门禁"
+# ⚠️ argent-doctor 在有 WARN 时也会返回非零，所以**按输出里的 FAIL 计数**判定，
+# 不能直接拿退出码当门禁，否则同步明明成功却被判失败。
+# ⚠️ argent-doctor 在仅有 WARN 时也返回非零；set -e 下 `var=$(cmd)` 会当场中止，
+# 导致"同步其实成功、脚本却以非零退出且不打结果"（2026-09-15 实测）。故显式吞掉退出码，
+# 真正的判据是下面的 FAIL 计数。
+doctor_out=$(node "$REPO/scripts/argent-doctor.mjs" 2>&1) || true
+echo "$doctor_out" | tail -1
+echo "$doctor_out" | grep -qE "FAIL [1-9]" && fail=1
+
+# 2026-09-15 事故后加的两道门禁（免重启、纯脚本）
+#  ① 角色映射一致性：gateway.json 每个角色在两份 PRESET_BY_ROLE 里都有映射
+#     （历史事故：漏改一处 ⇒ 角色拿不到工具，unknown tool "bash"）
+#  ② 移植函数符号可解析性：目标函数体内"调用位置"的符号必须在文件内可解析
+#     （历史事故：启用 askAgent 但缺 createUserMessage/textOf ⇒ 运行期 ReferenceError）
+rolemap_out=$(node "$REPO/scripts/check-role-mapping.mjs" 2>&1) || true
+echo "$rolemap_out" | tail -1
+echo "$rolemap_out" | grep -q "❌" && fail=1
+symbols_out=$(node "$REPO/scripts/check-portable-symbols.mjs" 2>&1) || true
+echo "$symbols_out" | grep -q "❌" && { echo "$symbols_out" | grep "❌" | head -4; fail=1; } || echo "  ✅ 移植函数符号门禁通过"
+[ -f "$REPO/scripts/tests/creds-records-placement.test.mjs" ] && node "$REPO/scripts/tests/creds-records-placement.test.mjs" | tail -2
+
+# 2026-09-15：**同步 scripts/**（此前只同步 plugins ⇒ 克隆里的 scripts 会落后，
+# 曾导致角色按 SKILL 里的 ~/.argent-dsh/scripts/... 跑到旧脚本、缺口检查静默失败、
+# 把缺字段的票误判为可派发）。用 --no-pull 只做 rsync（避免每次同步都走网络）。
+if ! bash "$REPO/scripts/sync-scripts.sh" --no-pull >/tmp/argent-sync-scripts.log 2>&1; then
+  echo "  ❌ scripts 与安装克隆不一致："; tail -4 /tmp/argent-sync-scripts.log | sed 's/^/     /'; fail=1
+else
+  echo "  ✅ scripts 已同步（关键文件 sha 一致）"
+fi
+
+if [ "$fail" -ne 0 ]; then echo "❌ 有副本未同步一致，请检查"; exit 1; fi
+echo "✅ 全部副本一致"
+echo "提醒：host 端插件改动需**用户手动**重启 dsh web 才生效（客户端 dist 改动浏览器硬刷新即可）"

package/engine/scripts/sync-presets.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# 把仓库 presets/ 同步到已安装的 agent-presets 目录，并校验 sha（防漂移）。
+# 用法：bash scripts/sync-presets.sh [presetId …]（省略则同步全部）
+# 说明：0.1.5 起 preset 挂载失败是**致命**的 ⇒ 同步后请跑 validate-preset-schema --runtime + plugin-bootcheck。
+set -euo pipefail
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DEST="${DSH_HOME:-$HOME/.dsh}/.agent-presets"
+ids=("$@")
+if [ ${#ids[@]} -eq 0 ]; then
+  ids=()
+  for d in "$REPO"/presets/*/; do ids+=("$(basename "$d")"); done
+fi
+fail=0
+for id in "${ids[@]}"; do
+  src="$REPO/presets/$id"; dst="$DEST/$id"
+  [ -d "$src" ] || { echo "  ✗ 仓库无此 preset: $id"; fail=1; continue; }
+  mkdir -p "$dst"
+  rsync -a --quiet "$src/" "$dst/"
+  ok=0
+  for f in preset.yml agent.cordis.yml; do
+    [ -f "$src/$f" ] || continue
+    a=$(shasum -a 256 "$src/$f" | cut -c1-12); b=$(shasum -a 256 "$dst/$f" | cut -c1-12)
+    [ "$a" = "$b" ] && ok=$((ok+1)) || { echo "  ✗ $id/$f 不一致（$a vs ${b}）"; fail=1; }
+  done
+  echo "  ✅ $id 已同步（$ok 个文件 sha 一致）"
+done
+exit $fail