@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/scripts/ui-copy-count.mjs

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+/**
+ * ui-copy-count —— 「中文长文案」计数（设置页文案收敛的**可复验**判据，2026-09-30）
+ *
+ * ## 为什么要有它
+ * 「文案从 102 条收敛到 ≤20 条」如果只是人工数，下次没人能复验。这里把判据写成脚本：
+ *
+ *   中文长文案 = 客户端 bundle 里**含中文字符、且字面量总长度 ≥ 阈值**的字符串字面量
+ *                （单引号 / 双引号；默认阈值 18 —— 取这个阈值是因为它复现了用户给的
+ *                 "当前 bundle 有 102 条"基线；夹具随代码演进，只保证**同口径可比**）
+ *
+ * ## 两种口径（都必须打印，不藏）
+ *   · **全部字面量**（缺省）= 与用户给的"基线 102 条"同口径，用于"前后对比"；
+ *   · **仅可见文案**（`--visible-only`）= 排除 `title=` / `title:` 提示行。用户批准的收敛手段
+ *     之一就是"转 title= tooltip"⇒ 验收看这个数（否则 tooltip 也算，收敛永远做不完）。
+ *
+ * ## 三种区间
+ *   · 整文件（缺省）；
+ *   · `--scope <起>-<止>` 行区间；
+ *   · `--section <名>` **语义区间**（见 SECTIONS）：把"某个页面"从 bundle 里切出来数，
+ *     因为整 bundle 混着看板/工作台/引导弹窗，"设置页文案"单独看才是用户要的口径。
+ *
+ * 用法：
+ *   node scripts/ui-copy-count.mjs                     # 全部客户端 bundle
+ *   node scripts/ui-copy-count.mjs --format json       # 机器可读（门禁用）
+ *   node scripts/ui-copy-count.mjs --threshold 18      # 换阈值
+ *   node scripts/ui-copy-count.mjs --lines             # 逐条列出（行号 + 内容前 60 字）
+ *   node scripts/ui-copy-count.mjs --visible-only      # 只数可见文案（排除 title 提示）
+ *   node scripts/ui-copy-count.mjs --scope 1516-2534 plugins/argent-skin/dist/client.js
+ *   node scripts/ui-copy-count.mjs --section argent-settings   # 语义区间（推荐）
+ *   node scripts/ui-copy-count.mjs --section argent-settings --visible-only --lines
+ *   node scripts/ui-copy-count.mjs --compare <另一份 checkout 根>   # 与基线逐文件对比
+ * 退出码：0；`--max N` 时超限退 1（可当门禁）。
+ *
+ * ⚠️ 口径边界：它数的是**字面量**，不含 JSX 文本节点与模板串；只用来做"前后对比"，
+ * 不是"用户看到多少字"的精确度量。
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const REPO = resolve(HERE, '..')
+
+/**
+ * 语义区间：把"某个页面"从 bundle 里切出来数。
+ * 用**组件边界作锚点**（不是裸行号）—— 代码上下移动时锚点跟着走，裸行号会静默错位。
+ * `sections` 里的 `from`/`to` 是正则源码字符串，`to` 命中的行**不含**在区间内。
+ */
+const SECTIONS = {
+  // argent-skin：设置页「Argent」组件（SettingsPage 起 → 组件结束）
+  'argent-settings': {
+    file: 'plugins/argent-skin/dist/client.js',
+    from: '^    function SettingsPage\\(\\) \\{',
+    to: '^    // ── 品牌文本补丁',
+  },
+  // argent-skin：计费概览组件（BillingSummary）。2026-10-01 入口收敛 4 → 2 后它**不再是独立
+  // section**「Argent 计费」，而是「Argent」页状态条下方的「计费概览」折叠块；组件本体与两个锚点
+  // 都没变（`to` 仍是紧随其后的 registerWhenCore 行）⇒ 这个区间继续有效，数字与收敛前可直接比。
+  'argent-billing': {
+    file: 'plugins/argent-skin/dist/client.js',
+    from: '^      function BillingSummary\\(\\) \\{',
+    to: '^      registerWhenCore\\(function \\(\\) \\{$',
+  },
+  // argent-gateway：整个文件就是「Argent 能力」页（概览页签 + 能力包页签 + 角色页签）
+  'gateway-page': {
+    file: 'plugins/argent-gateway/dist/client.js',
+    from: '^',
+    to: '\\u0000never',
+  },
+}
+
+const argv = process.argv.slice(2)
+const flag = (name, def = null) => {
+  const i = argv.indexOf(name)
+  return i >= 0 ? (argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[i + 1] : true) : def
+}
+const THRESHOLD = Number(flag('--threshold', 18))
+const FORMAT = String(flag('--format', 'text'))
+const SHOW_LINES = !!flag('--lines', false)
+// --visible-only：只数**会显示在页面上**的长文案（排除 title= / title: 提示行）。
+// 为什么需要两种口径：用户批准的收敛手段之一就是"改为 title=（tooltip）"⇒ 若把 tooltip 也算进
+// 长文案，收敛永远做不完。所以：**可见文案**是验收口径，**全部字面量**是与历史基线(102 条)
+// 对比的口径 —— 两个数都打印，不藏。
+const VISIBLE_ONLY = !!flag('--visible-only', false)
+const MAX = flag('--max', null)
+const SCOPE = flag('--scope', null)
+const SECTION = flag('--section', null)
+const COMPARE = flag('--compare', null)
+
+/** 默认目标：所有插件的客户端 bundle（手写维护的那几个也在内）。 */
+function defaultTargets() {
+  const out = []
+  for (const d of readdirSync(join(REPO, 'plugins'))) {
+    const p = join(REPO, 'plugins', d, 'dist', 'client.js')
+    if (existsSync(p)) out.push(p)
+  }
+  return out
+}
+const targets = argv.filter((a) => a.endsWith('.js')).map((a) => resolve(a))
+
+/**
+ * 解析语义区间 → 行号区间（含 `from` 命中行，不含 `to` 命中行）。
+ * 锚点找不到就**抛错**，绝不静默退化成"整文件"—— 静默退化会让数字看着变好而其实没测到。
+ */
+function resolveSection(root, name) {
+  const spec = SECTIONS[name]
+  if (!spec) throw new Error(`未知语义区间 ${name}（可选：${Object.keys(SECTIONS).join(' / ')}）`)
+  const file = join(root, spec.file)
+  if (!existsSync(file)) throw new Error(`语义区间 ${name} 的文件不存在：${spec.file}`)
+  const lines = readFileSync(file, 'utf-8').split('\n')
+  const fromRe = new RegExp(spec.from)
+  const toRe = new RegExp(spec.to)
+  const lo = lines.findIndex((l) => fromRe.test(l)) + 1
+  if (!lo) throw new Error(`语义区间 ${name} 找不到起点锚点：${spec.from}（代码结构变了？改脚本里的 SECTIONS）`)
+  let hi = lines.length
+  for (let i = lo; i < lines.length; i += 1) {
+    if (toRe.test(lines[i])) { hi = i; break }
+  }
+  return { file, lo, hi: Math.max(lo, hi) }
+}
+
+const sections = SECTION ? [resolveSection(REPO, String(SECTION))] : []
+const files = sections.length ? sections.map((s) => s.file)
+  : (targets.length ? targets : defaultTargets())
+
+const CJK = /[\u4e00-\u9fff]/
+const LITERAL = /'([^'\\\n]*(?:\\.[^'\\\n]*)*)'|"([^"\\\n]*(?:\\.[^"\\\n]*)*)"/g
+
+/**
+ * 这一行是不是**提示（tooltip）行**？
+ *
+ * ⚠️ 曾经写坏过一次（2026-09-30）：早期正则 `/(^|[\s,{])title\s*[:=]/` 里的 `\s` 会让
+ * `"…（明细见下方「配置状态」）"` 这种**字符串值内部**的 `… title:…` 命中 —— 结果把可见文案
+ * 误判成 tooltip，让"可见文案"这个验收口径**虚低**。所以这里改成：先剥掉字符串字面量，
+ * 再在**代码骨架**上匹配 `title` 这个属性名/变量名（必须真的是赋值位置）。
+ */
+const STRIPPED = (line) => line.replace(LITERAL, '""')
+function isTitleLine(lines, i) {
+  const bare = STRIPPED(lines[i] || '')
+  // ① 代码骨架里出现 title 属性/变量赋值：`title:` / `title=` / `fooTitle =`
+  //    前缀限定为「行首 / { , ( 空白」—— 避开 `subtitle:` 之外的巧合与 `xxx_title:`。
+  if (/(^|[\s,{(])title\s*[:=]/.test(bare)) return true
+  if (/(^|[\s,{(])[A-Za-z_$][\w$]*[Tt]itle\s*=/.test(bare)) return true
+  // ② 多行 JSX 属性值：本行是裸字符串，且前两行的**骨架**刚开了 `title:`
+  const prev = STRIPPED(lines[i - 1] || '')
+  const prev2 = STRIPPED(lines[i - 2] || '')
+  if (/(^|[\s,{(])title\s*[:=]\s*$/.test(prev) || /(^|[\s,{(])title\s*[:=]\s*$/.test(prev2)) return true
+  return false
+}
+
+function countFile(file, range) {
+  const lines = readFileSync(file, 'utf-8').split('\n')
+  const [lo, hi] = range || (SCOPE ? String(SCOPE).split('-').map(Number) : [1, lines.length])
+  const cjk = []
+  const long = []
+  for (let i = 0; i < lines.length; i += 1) {
+    const lineNo = i + 1
+    if (lineNo < lo || lineNo > hi) continue
+    if (VISIBLE_ONLY && isTitleLine(lines, i)) continue
+    LITERAL.lastIndex = 0
+    let m
+    while ((m = LITERAL.exec(lines[i])) !== null) {
+      const v = m[1] !== undefined ? m[1] : m[2]
+      if (!v || !CJK.test(v)) continue
+      cjk.push(lineNo)
+      if (v.length >= THRESHOLD) long.push({ line: lineNo, len: v.length, text: v })
+    }
+  }
+  return { file, cjk: cjk.length, long, range: range || (SCOPE ? [lo, hi] : null) }
+}
+
+const rangeLabel = sections.length
+  ? `${SECTION}（${sections[0].file.replace(`${REPO}/`, '')}:${sections[0].lo}-${sections[0].hi}）`
+  : (SCOPE ? String(SCOPE) : '整文件')
+
+const results = files.map((f, i) => countFile(f, sections[i] ? [sections[i].lo, sections[i].hi] : null))
+
+// ── --compare <另一份 checkout 根>：同口径逐文件对比（"收敛了多少"的可复验证据）──
+if (COMPARE) {
+  const other = resolve(String(COMPARE))
+  const otherFiles = sections.length
+    ? sections.map((s) => resolveSection(other, String(SECTION)).file)
+    : (targets.length ? targets.map((t) => join(other, t.replace(`${REPO}/`, ''))) : defaultTargets().map((t) => join(other, t.replace(`${REPO}/`, ''))))
+  const otherRanges = sections.length ? sections.map((s) => resolveSection(other, String(SECTION))) : []
+  const before = otherFiles.map((f, i) => countFile(f, otherRanges[i] ? [otherRanges[i].lo, otherRanges[i].hi] : null))
+  const sum = (rs) => rs.reduce((a, r) => a + r.long.length, 0)
+  console.log(`\n中文长文案**前后对比**（阈值 ≥ ${THRESHOLD}；口径：${VISIBLE_ONLY ? '仅可见文案' : '全部字面量（含 title）'}；区间：${rangeLabel}）\n`)
+  console.log(`  基线 ${other}`)
+  for (const r of before) console.log(`      ${r.file.replace(`${other}/`, r.file.startsWith(other) ? '' : '')}：长文案 ${r.long.length} 条`)
+  console.log(`    合计 ${sum(before)} 条\n`)
+  console.log(`  现在 ${REPO}`)
+  for (const r of results) console.log(`      ${r.file.replace(`${REPO}/`, '')}：长文案 ${r.long.length} 条`)
+  console.log(`    合计 ${sum(results)} 条`)
+  const delta = sum(results) - sum(before)
+  console.log(`\n  变化：${delta >= 0 ? '+' : ''}${delta} 条（${sum(before)} → ${sum(results)}）\n`)
+} else if (FORMAT === 'json') {
+  console.log(JSON.stringify({
+    threshold: THRESHOLD,
+    visibleOnly: VISIBLE_ONLY,
+    scope: rangeLabel,
+    section: SECTION || null,
+    files: results.map((r) => ({ file: r.file.replace(`${REPO}/`, ''), cjkLiterals: r.cjk, longCopy: r.long.length, range: r.range })),
+    totalLongCopy: results.reduce((a, r) => a + r.long.length, 0),
+  }, null, 2))
+} else {
+  console.log(`\n中文长文案计数（阈值：字面量长度 ≥ ${THRESHOLD}；区间：${rangeLabel}；口径：${VISIBLE_ONLY ? '仅可见文案（排除 title 提示）' : '全部字面量（含 title）'}）\n`)
+  for (const r of results) {
+    console.log(`  ${r.file.replace(`${REPO}/`, '')}：含中文字面量 ${r.cjk} 条，其中长文案 ${r.long.length} 条`)
+    if (SHOW_LINES) for (const l of r.long) console.log(`      :${l.line} (${l.len}) ${l.text.slice(0, 60)}`)
+  }
+  console.log(`\n  合计长文案：${results.reduce((a, r) => a + r.long.length, 0)} 条\n`)
+}
+if (MAX !== null && MAX !== true) {
+  const total = results.reduce((a, r) => a + r.long.length, 0)
+  if (total > Number(MAX)) {
+    console.error(`  ❌ 长文案 ${total} 条 > 上限 ${MAX}（判据：node scripts/ui-copy-count.mjs --max ${MAX}）`)
+    process.exit(1)
+  }
+}

package/engine/scripts/usage-anchor.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# usage-anchor —— 成本锚点定时器（每天跑一次，把真实模型成本逐日累积下来）。
+#
+# 为什么要有它：定价要以**实跑一段时间的成本**为锚，而不是某一次抽样。这个定时器每天
+# ① 拉服务端积分流水（走问述代理的机器，含 costYuan 精确值）
+# ② 增量扫描本机会话日志（走官方直连/自带 key 的机器也能测）
+# ③ 刷新权威费率表 ④ 追加当日快照到 ~/.dsh/argent/usage/daily.jsonl
+#
+# 用法：
+#   bash scripts/usage-anchor.sh install     # 安装/更新 LaunchAgent（每天 03:30 与 15:30）
+#   bash scripts/usage-anchor.sh uninstall   # 卸载
+#   bash scripts/usage-anchor.sh status      # 状态 + 最近快照
+#   bash scripts/usage-anchor.sh run         # 立刻跑一次（前台，肉眼可见）
+#   bash scripts/usage-anchor.sh report      # 打印当月报告
+#
+# 凭据：脚本会依次尝试进程环境、~/.dsh/argent/whyshu.env（600）、fulfillment.env。
+# 缺 key 时**响亮失败**（exit 1），绝不静默把成本算成 0。
+set -uo pipefail
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# 解释器解析（2026-09-22 重启事故：默认值写死 ~/.dsh/argent/venv ⇒ 重启后静默空转）
+pick_py() {
+  local c
+  # 候选（2026-09-22）：ARGENT_PY → DSH_HOME/argent/venv → ~/.dsh/argent/venv → 仓库 .venv → PATH
+  for c in "${ARGENT_PY:-}" "${DSH_HOME:-$HOME/.dsh}/argent/venv/bin/python3" \
+           "$HOME/.dsh/argent/venv/bin/python3" "${REPO:-}/.venv/bin/python3" \
+           "$(command -v python3 2>/dev/null || true)"; do
+    [ -n "$c" ] || continue
+    [ -x "$c" ] || continue
+    "$c" -c 'import openpyxl, yaml' 2>/dev/null || continue   # 硬要求：配置/发票生成必需
+    "$c" -c 'import PIL, playwright' 2>/dev/null || \
+      echo "[$(date '+%F %T')] ⚠️ 解释器 $c 缺 pillow/playwright ⇒ 浏览器流程会失败（修：node install-argent.mjs --venv-only）" >&2
+    printf '%s' "$c"; return 0
+  done
+  return 1
+}
+if ! PY="$(pick_py)"; then
+  echo "❌ 找不到可用解释器（需含 openpyxl + yaml）：ARGENT_PY / ~/.dsh/argent/venv/bin/python3 / <repo>/.venv / PATH 的 python3" >&2
+  echo "   修复: python3 -m venv ~/.dsh/argent/venv && ~/.dsh/argent/venv/bin/pip install openpyxl pyyaml" >&2
+  exit 2
+fi
+LABEL="com.whyshu.usage-anchor"
+AGENTS="$HOME/Library/LaunchAgents"
+PLIST="$AGENTS/$LABEL.plist"
+LOGDIR="${ARGENT_LOG_DIR:-$HOME/Library/Logs/argent}"
+[ -f "$HOME/.dsh/argent/logdir" ] && LOGDIR="$(cat "$HOME/.dsh/argent/logdir")"
+UID_N="$(id -u)"
+
+gen_plist() {
+  cat <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!-- 由 scripts/usage-anchor.sh 生成（勿手改） -->
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>$LABEL</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>$REPO/scripts/usage-anchor.sh</string>
+    <string>run</string>
+  </array>
+  <key>StartCalendarInterval</key>
+  <array>
+    <dict><key>Hour</key><integer>3</integer><key>Minute</key><integer>30</integer></dict>
+    <dict><key>Hour</key><integer>15</integer><key>Minute</key><integer>30</integer></dict>
+  </array>
+  <key>RunAtLoad</key>
+  <false/>
+  <key>AbandonProcessGroup</key>
+  <true/>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>ARGENT_PY</key><string>$PY</string>
+    <key>PATH</key><string>$(dirname "$(command -v node || echo /usr/local/bin/node)"):/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+  </dict>
+  <key>StandardOutPath</key><string>$LOGDIR/usage-anchor.out.log</string>
+  <key>StandardErrorPath</key><string>$LOGDIR/usage-anchor.err.log</string>
+</dict>
+</plist>
+PLIST
+}
+
+cmd_run() {
+  echo "── 成本锚点 $(date '+%Y-%m-%d %H:%M:%S')"
+  "$PY" "$REPO/scripts/usage_report.py" --pull --snapshot || {
+    echo "  ❌ 拉取失败（检查 ~/.dsh/argent/whyshu.env 里的 WHYSHU_API_KEY）" >&2; return 1; }
+}
+
+cmd_report() { "$PY" "$REPO/scripts/usage_report.py"; }
+
+cmd_status() {
+  echo "── 定时器"
+  launchctl list | grep -i "$LABEL" || echo "  （未安装：bash scripts/usage-anchor.sh install）"
+  echo
+  echo "── 最近 7 天快照（~/.dsh/argent/usage/daily.jsonl）"
+  "$PY" - <<'PY'
+import json, pathlib
+f = pathlib.Path.home() / ".dsh" / "argent" / "usage" / "daily.jsonl"
+if not f.exists():
+    print("  （还没有快照）"); raise SystemExit
+for line in f.read_text(encoding="utf-8").splitlines()[-7:]:
+    d = json.loads(line)
+    caps = "｜".join(f"{k} ¥{v['yuanHiPerTicket']:.3f}/票×{v['tickets']}" for k, v in d.get("perCapability", {}).items())
+    print(f"  {d['date']}  总成本 ¥{d['costYuan']:.2f}｜请求 {d['requests']}｜票据窗口内 ¥{d['attributedYuanHi']:.2f}"
+          f"｜窗口外 ¥{d['overheadYuanHi']:.2f}")
+    if caps: print(f"            每票成本：{caps}")
+PY
+  echo
+  echo "── 最近一次运行日志尾部"
+  tail -3 "$LOGDIR/usage-anchor.out.log" 2>/dev/null | sed 's/^/  /' || echo "  （无日志）"
+}
+
+cmd_install() {
+  mkdir -p "$AGENTS" "$LOGDIR"
+  gen_plist > "$PLIST"
+  launchctl bootout "gui/$UID_N/$LABEL" 2>/dev/null || true
+  launchctl bootstrap "gui/$UID_N" "$PLIST" 2>/dev/null || launchctl load -w "$PLIST"
+  echo "  ✅ 已安装 ${LABEL}（每天 03:30 / 15:30 采集成本；日志 $LOGDIR/usage-anchor.out.log）"
+  launchctl list | grep -i "$LABEL" || true
+}
+
+cmd_uninstall() {
+  launchctl bootout "gui/$UID_N/$LABEL" 2>/dev/null || true
+  rm -f "$PLIST"
+  echo "  🗑  已卸载 ${LABEL}（历史快照保留在 ~/.dsh/argent/usage/）"
+}
+
+case "${1:-}" in
+  install) cmd_install ;;
+  uninstall) cmd_uninstall ;;
+  status) cmd_status ;;
+  run) cmd_run ;;
+  report) cmd_report ;;
+  *) sed -n '2,20p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; exit 2 ;;
+esac