mingdao-harness 0.2.3 → 0.2.5

package/src/ui.js

@@ -26,6 +26,10 @@ export const C = {
 
 const stdoutTTY = () => Boolean(process.stdout.isTTY);
 
+/**
+ * @param {any} text
+ * @param {any} code
+ */
 export function style(text, code) {
   if (!stdoutTTY()) {
     // 非 TTY（管道/重定向）：剥离所有内嵌 ANSI 码，保证输出干净可解析
@@ -35,10 +39,11 @@ export function style(text, code) {
 }
 
 // ---------- 终端显示宽度（CJK 占 2 列） ----------
+/** @param {any} s */
 function displayWidth(s) {
   let w = 0;
   for (const ch of String(s)) {
-    const c = ch.codePointAt(0);
+    const c = /** @type {any} */ (ch.codePointAt(0));
     const wide =
       c >= 0x1100 &&
       (c <= 0x115f ||
@@ -57,10 +62,18 @@ function displayWidth(s) {
   return w;
 }
 
+/**
+ * @param {any} s
+ * @param {any} w
+ */
 function padTo(s, w) {
   return String(s) + ' '.repeat(Math.max(0, w - displayWidth(s)));
 }
 
+/**
+ * @param {any} s
+ * @param {any} prefix
+ */
 function indent(s, prefix) {
   return String(s)
     .split('\n')
@@ -70,6 +83,7 @@ function indent(s, prefix) {
 
 // ---------- 轻量代码高亮 ----------
 const HASH_LANGS = new Set(['py', 'python', 'sh', 'bash', 'yaml', 'yml', 'toml', 'markdown', 'md']);
+/** @type {Record<string, string[]>} */
 const LANG_KEYWORDS = {
   js: ['const', 'let', 'var', 'function', 'return', 'if', 'else', 'for', 'while', 'import', 'from', 'export', 'default', 'class', 'extends', 'new', 'await', 'async', 'try', 'catch', 'finally', 'throw', 'typeof', 'instanceof', 'null', 'undefined', 'true', 'false', 'this', 'super', 'switch', 'case', 'break', 'continue', 'do', 'of', 'in', 'static', 'get', 'set', 'delete', 'void', 'yield'],
   ts: ['interface', 'type', 'enum', 'implements', 'readonly', 'private', 'public', 'protected', 'namespace', 'declare', 'as', 'any', 'unknown', 'never', 'string', 'number', 'boolean'],
@@ -83,6 +97,10 @@ const LANG_KEYWORDS = {
   yaml: [],
 };
 
+/**
+ * @param {any} code
+ * @param {any} lang
+ */
 export function highlightCode(code, lang = '') {
   if (!stdoutTTY()) return code;
   const kws = new Set([...(LANG_KEYWORDS[lang] || []), ...(LANG_KEYWORDS[lang.replace(/-.*/, '')] || [])]);
@@ -117,6 +135,7 @@ export function highlightCode(code, lang = '') {
 }
 
 // ---------- Markdown 行内样式 ----------
+/** @param {any} s */
 function inline(s) {
   const parts = [];
   const re = /(`[^`]+`|\*\*[^*]+\*\*|\*[^*\s][^*]*\*)/g;
@@ -134,6 +153,7 @@ function inline(s) {
   return parts.join('');
 }
 
+/** @param {any} line */
 function renderInline(line) {
   const trimmed = line.trim();
   if (/^#{1,6}\s/.test(trimmed)) return style(inline(line), C.bold + C.cyan);
@@ -145,13 +165,16 @@ function renderInline(line) {
 }
 
 // ---------- 流式渲染器 ----------
+/** @param {any} io */
 function createStreamRenderer(io) {
   let buf = '';
   let inCode = false;
   let lang = '';
+  /** @type {any[]} */
   let codeLines = [];
   let streamed = false;
 
+  /** @param {any} line */
   function renderLine(line) {
     const trimmed = line.trim();
     if (trimmed.startsWith('```')) {
@@ -174,6 +197,7 @@ function createStreamRenderer(io) {
   }
 
   return {
+    /** @param {any} text */
     push(text) {
       streamed = true;
       buf += String(text);
@@ -202,6 +226,10 @@ function createStreamRenderer(io) {
 }
 
 // ---------- 行级 diff（编辑预览用，仅小区域） ----------
+/**
+ * @param {any} a
+ * @param {any} b
+ */
 function diffLines(a, b) {
   const n = a.length;
   const m = b.length;
@@ -253,6 +281,7 @@ const COMMANDS = [
   '/quit',
 ];
 
+/** @param {any} line */
 function completeLine(line) {
   if (line.startsWith('/model ') && line.length >= 7) {
     const pre = line.slice(7);
@@ -261,6 +290,10 @@ function completeLine(line) {
   return [COMMANDS.filter((c) => c.startsWith(line)), line];
 }
 
+/**
+ * @param {any} name
+ * @param {any} args
+ */
 function summarizeArgs(name, args) {
   try {
     if (name === 'bash') return ` ${args.command ?? ''}`;
@@ -274,12 +307,19 @@ function summarizeArgs(name, args) {
 
 // ---------- io 工厂 ----------
 export function createIO({ quiet = false } = {}) {
+  /** @type {any} */
   let rl = null;
+  /** @type {any} */
   let spinnerTimer = null;
+  /** @type {any} */
   let renderer = null;
+  /** @type {any[]} */
   let askQueue = []; // 非 TTY：挂起的输入请求
+  /** @type {any[]} */
   let lineQueue = []; // 非 TTY：已缓冲但未被消费的行
+  /** @type {any} */
   let sigintHandler = null; // TTY 下 rl 'SIGINT' 事件转发目标
+  /** @type {any} */
   let ttyPending = null;
   let closed = false;
 
@@ -291,6 +331,7 @@ export function createIO({ quiet = false } = {}) {
     isTTY: Boolean(process.stdin.isTTY),
     showReasoning: true,
 
+    /** @param {any} v */
     setShowReasoning(v) {
       io.showReasoning = !!v;
     },
@@ -304,7 +345,7 @@ export function createIO({ quiet = false } = {}) {
           output: process.stdout,
           terminal,
           historySize: 200,
-          completer: (line) => completeLine(line),
+          completer: (/** @type {any} */ line) => completeLine(line),
         });
         if (terminal) {
           // 关键：TTY 下 Ctrl+C 由 readline 捕获（raw 模式），需要在这里转发给中断处理器；
@@ -321,7 +362,7 @@ export function createIO({ quiet = false } = {}) {
         }
         if (!terminal) {
           // 非 TTY（管道输入）：持久 line 监听 + 队列，避免 rl.question 丢弃首行之后的输入
-          rl.on('line', (line) => {
+          rl.on('line', (/** @type {any} */ line) => {
             const trimmed = line.trim();
             const pending = askQueue.shift();
             if (pending) pending.resolve(trimmed);
@@ -344,6 +385,7 @@ export function createIO({ quiet = false } = {}) {
       return rl;
     },
 
+    /** @param {any} lines */
     setHistory(lines) {
       try {
         const r = io.ensureRl();
@@ -357,6 +399,10 @@ export function createIO({ quiet = false } = {}) {
       if (!quiet) console.log(text);
     },
 
+    /**
+     * @param {any} title
+     * @param {any} lines
+     */
     box(title, lines) {
       if (quiet) return;
       if (!stdoutTTY()) {
@@ -389,6 +435,7 @@ export function createIO({ quiet = false } = {}) {
       io.stopSpinner();
     },
 
+    /** @param {any} label */
     startSpinner(label) {
       if (quiet || !stdoutTTY()) return;
       io.stopSpinner();
@@ -408,6 +455,7 @@ export function createIO({ quiet = false } = {}) {
       }
     },
 
+    /** @param {any} text */
     writeText(text) {
       if (quiet) return;
       if (io._reasoningStarted && !io._answerStarted && stdoutTTY()) {
@@ -417,6 +465,7 @@ export function createIO({ quiet = false } = {}) {
       renderer?.push(String(text));
     },
 
+    /** @param {any} text */
     writeReasoning(text) {
       if (quiet || !io.showReasoning) return;
       if (!io._reasoningStarted) {
@@ -426,6 +475,7 @@ export function createIO({ quiet = false } = {}) {
       process.stdout.write(style(String(text), C.dim));
     },
 
+    /** @param {any} todos */
     renderTodo(todos) {
       if (quiet || !todos?.length) return;
       io.print(style('  ☑ 任务清单', C.bold));
@@ -436,6 +486,10 @@ export function createIO({ quiet = false } = {}) {
       }
     },
 
+    /**
+     * @param {any} code
+     * @param {any} lang
+     */
     printCodeBlock(code, lang) {
       if (quiet) return;
       const label = lang || 'code';
@@ -446,6 +500,12 @@ export function createIO({ quiet = false } = {}) {
     },
 
     // —— 工具执行可视化 ——
+    /**
+     * @param {any} name
+     * @param {any} args
+     * @param {any} result
+     * @param {any} durationMs
+     */
     renderTool(name, args, result, durationMs) {
       if (quiet) return;
       const r = result && typeof result === 'object' ? result : { ok: false, error: String(result ?? '') };
@@ -525,6 +585,11 @@ export function createIO({ quiet = false } = {}) {
       io.print(style(`  ✓ 输出 ${out.length} 字符${ms}`, C.green));
     },
 
+    /**
+     * @param {any} name
+     * @param {any} args
+     * @param {any} reason
+     */
     renderToolDenied(name, args, reason) {
       if (quiet) return;
       const label = reason === '未授权' || !reason ? '未授权，已跳过' : reason;
@@ -532,11 +597,12 @@ export function createIO({ quiet = false } = {}) {
     },
 
     // —— 用量与费用状态行 ——
+    /** @param {{ modelName: any, usage: any, durationMs: any }} param0 */
     printUsageLine({ modelName, usage, durationMs }) {
       if (quiet) return;
       const p = usage?.prompt_tokens ?? 0;
       const c = usage?.completion_tokens ?? 0;
-      const fmt = (n) => (n >= 1000 ? (n / 1000).toFixed(1) + 'k' : String(n));
+      const fmt = (/** @type {any} */ n) => (n >= 1000 ? (n / 1000).toFixed(1) + 'k' : String(n));
       const secs = ((durationMs ?? 0) / 1000).toFixed(1) + 's';
       const costPart = estimateCostLabel(modelName, p, c, usage);
       io.print(
@@ -550,6 +616,7 @@ export function createIO({ quiet = false } = {}) {
     // —— SIGINT（Ctrl+C 中断生成，不退出程序） ——
     // TTY 下 readline raw 模式会把 Ctrl+C 转成 rl 的 'SIGINT' 事件（ensureRl 转发到 sigintHandler），
     // 非 TTY/其他来源走 process 级 SIGINT；两层都注册，保证任何路径都能中断
+    /** @param {any} fn */
     onSigint(fn) {
       const h = () => {
         try {
@@ -564,6 +631,10 @@ export function createIO({ quiet = false } = {}) {
       };
     },
 
+    /**
+     * @param {any} question
+     * @param {any} opts
+     */
     ask(question, opts = {}) {
       if (!process.stdin.isTTY) {
         // 非 TTY：优先消费已缓冲的行（接口关闭后仍可能有剩余行），不打印提示符
@@ -592,7 +663,7 @@ export function createIO({ quiet = false } = {}) {
         }
         const entry = { resolve, restore };
         ttyPending = entry;
-        r.question(question, (answer) => {
+        r.question(question, (/** @type {any} */ answer) => {
           restore();
           if (ttyPending === entry) ttyPending = null;
           resolve(answer.trim());
@@ -601,6 +672,7 @@ export function createIO({ quiet = false } = {}) {
     },
 
     // 行尾反斜杠续行，支持多行输入
+    /** @param {any} prompt */
     async askMultiline(prompt, continuation = '…> ') {
       const lines = [];
       for (;;) {
@@ -615,14 +687,19 @@ export function createIO({ quiet = false } = {}) {
       }
     },
 
+    /** @param {any} question */
     async confirm(question) {
       const a = await io.ask(question + ' ');
       return /^y(es)?$/i.test(a);
     },
 
+    /**
+     * @param {any} label
+     * @param {any} options
+     */
     async choose(label, options) {
       io.print(style(label, C.bold));
-      options.forEach((o, i) => io.print(`  ${style(String(i + 1), C.cyan)}. ${o.label}`));
+      options.forEach((/** @type {any} */ o, /** @type {any} */ i) => io.print(`  ${style(String(i + 1), C.cyan)}. ${o.label}`));
       for (;;) {
         const ans = await io.ask('请输入序号：');
         const n = Number(ans);

package/src/update.js

@@ -12,7 +12,7 @@ import { fileURLToPath } from 'node:url';
 import { mingdaoHome, ensureHome } from './config.js';
 import { atomicWriteFileSync } from './atomic-write.js';
 
-function git(args, cwd) {
+function git(/** @type {any} */ args, /** @type {any} */ cwd) {
   const r = spawnSync('git', args, { cwd, encoding: 'utf8', timeout: 120000 });
   return {
     ok: r.status === 0 && !r.error,
@@ -36,11 +36,11 @@ export function findRepoRoot() {
   return null;
 }
 
-function resolveRepo(override) {
+function resolveRepo(/** @type {any} */ override) {
   return override || findRepoRoot();
 }
 
-function versionAt(repo, ref = 'HEAD') {
+function versionAt(/** @type {any} */ repo, ref = 'HEAD') {
   const r = git(['show', `${ref}:package.json`], repo);
   if (!r.ok) return null;
   try {
@@ -50,7 +50,7 @@ function versionAt(repo, ref = 'HEAD') {
   }
 }
 
-function compareVersions(a, b) {
+function compareVersions(/** @type {any} */ a, /** @type {any} */ b) {
   const pa = String(a).split('.').map((n) => parseInt(n, 10) || 0);
   const pb = String(b).split('.').map((n) => parseInt(n, 10) || 0);
   for (let i = 0; i < 3; i++) {
@@ -71,7 +71,7 @@ function readState() {
     return null;
   }
 }
-function writeState(s) {
+function writeState(/** @type {any} */ s) {
   ensureHome();
   atomicWriteFileSync(stateFile(), JSON.stringify(s, null, 2) + '\n', { mode: 0o600 }); // 质检 H4：更新状态原子写
 }
@@ -79,20 +79,20 @@ function writeState(s) {
 // 直接向远端指定分支要版本（评估 D6）：fetch 到 FETCH_HEAD 再读 package.json，
 // 不依赖本地 refs 落盘——部分 Windows git 环境存在「fetch 成功但 refs 不更新」的异常，
 // 按本地 refs 判断会误报「已是最新」。ls-remote 思路的等价实现。
-function remoteVersion(repo, remote, branch) {
+function remoteVersion(/** @type {any} */ repo, /** @type {any} */ remote, /** @type {any} */ branch) {
   const r = git(['fetch', '--quiet', remote, branch], repo);
   if (!r.ok) return null;
   return versionAt(repo, 'FETCH_HEAD');
 }
 
-function listRemotes(repo) {
+function listRemotes(/** @type {any} */ repo) {
   const r = git(['remote'], repo);
   if (!r.ok) return [];
   return r.out.split('\n').filter(Boolean);
 }
 
 // 各远端（main/master 任一存在）中版本号最大的（多镜像部署：github/gitee/gitcode 谁新跟谁）
-function newestRemote(repo) {
+function newestRemote(/** @type {any} */ repo) {
   let latest = '';
   let ref = '';
   for (const remote of listRemotes(repo)) {

package/src/web/app.js

@@ -763,12 +763,55 @@ $('#memDedupe').onclick=async ()=>{
 };
 // —— 缓存命中率仪表盘 ——
 function fmtT(n){ n=Number(n||0); return n>=1000?(n/1000).toFixed(1)+'k':String(n); }
+// 省钱 B3：费用二级分账面板（模型/工具 Top5 + 近 14 天折线，零依赖 SVG）
+function renderCostBreakdown(bd){
+  const models=$('#costTopModels'); models.innerHTML='';
+  for(const m of ((bd.byModel||[]).slice(0,5))){
+    const bar=document.createElement('div'); bar.style.cssText='height:3px;border-radius:2px;background:var(--bg3);margin:1px 0;overflow:hidden';
+    const max=bd.byModel&&bd.byModel[0]?bd.byModel[0].cost:1;
+    bar.innerHTML='<div style="height:100%;width:'+Math.max(2,Math.round((m.cost||0)/Math.max(max,1e-9)*100))+'%;background:var(--accent2)"></div>';
+    const row=document.createElement('div'); row.style.cssText='display:flex;justify-content:space-between;font-size:11.5px;padding:1px 0';
+    row.innerHTML='<span>'+esc(m.model||'—')+'</span><span>¥'+(m.cost||0).toFixed(4)+' · '+m.turns+' 轮</span>';
+    const w=document.createElement('div'); w.appendChild(row); w.appendChild(bar); models.appendChild(w);
+  }
+  if(!(bd.byModel||[]).length) models.innerHTML='<div style="color:var(--faint);font-size:11.5px">暂无记录</div>';
+  const tools=$('#costTopTools'); tools.innerHTML='';
+  for(const t of ((bd.byTool||[]).slice(0,5))){
+    const bar=document.createElement('div'); bar.style.cssText='height:3px;border-radius:2px;background:var(--bg3);margin:1px 0;overflow:hidden';
+    const max=bd.byTool&&bd.byTool[0]?bd.byTool[0].ms:1;
+    bar.innerHTML='<div style="height:100%;width:'+Math.max(2,Math.round((t.ms||0)/Math.max(max,1e-9)*100))+'%;background:var(--cyan)"></div>';
+    const row=document.createElement('div'); row.style.cssText='display:flex;justify-content:space-between;font-size:11.5px;padding:1px 0';
+    row.innerHTML='<span>'+esc(t.tool||'—')+'</span><span>'+t.calls+' 次 · '+fmtDur(t.ms)+'</span>';
+    const w=document.createElement('div'); w.appendChild(row); w.appendChild(bar); tools.appendChild(w);
+  }
+  if(!(bd.byTool||[]).length) tools.innerHTML='<div style="color:var(--faint);font-size:11.5px">暂无记录</div>';
+  const line=$('#costLine');
+  const days=(bd.byDay||[]).slice(-14);
+  if(!days.length){ line.innerHTML=''; return; }
+  const W=320, H=56, P=4;
+  const maxC=Math.max(...days.map(d=>d.cost), 1e-9);
+  const pts=days.map((d,i)=>{
+    const x=P+i*(W-2*P)/Math.max(days.length-1,1);
+    const y=H-4-(d.cost/maxC)*(H-10);
+    return [x.toFixed(1), y.toFixed(1)];
+  });
+  const poly=pts.map(p=>p.join(',')).join(' ');
+  const last=pts[pts.length-1];
+  line.innerHTML='<div style="font-size:11.5px;color:var(--faint);margin-bottom:2px">近 14 天费用折线（¥，最高 ¥'+maxC.toFixed(4)+'）</div>'
+    +'<svg viewBox="0 0 '+W+' '+H+'" style="width:100%;height:auto;background:var(--bg3);border-radius:8px">'
+    +'<polyline points="'+poly+'" fill="none" style="stroke:var(--accent2);stroke-width:1.6;stroke-linejoin:round;stroke-linecap:round"/>'
+    +'<circle cx="'+last[0]+'" cy="'+last[1]+'" r="2.6" style="fill:var(--accent)"/>'
+    +'<text x="4" y="10" font-size="8" style="fill:var(--faint)">'+days[0].day+'</text>'
+    +'<text x="'+(W-52)+'" y="10" font-size="8" style="fill:var(--faint)">'+days[days.length-1].day+'</text>'
+    +'</svg>';
+}
 async function refreshCache(){
   const r=await fetch('/api/cache-stats',{cache:'no-store'}).catch(()=>null); if(!r) return;
   const j=await r.json(); if(!j.ok) return;
   const s=j.summary||{};
   const rate=s.rate!=null?(s.rate*100).toFixed(0)+'%':'暂无缓存数据';
   $('#cacheSummary').innerHTML='轮次 '+s.turns+' · ↑'+fmtT(s.prompt)+' ↓'+fmtT(s.completion)+' tokens · 命中率 <b style="color:var(--accent)">'+rate+'</b> · 累计 ≈¥'+Number(s.cost||0).toFixed(5)+'（比全未命中省 ≈¥'+Number(s.saved||0).toFixed(5)+'）';
+  renderCostBreakdown(j.breakdown||{});
   const list=$('#cacheRecent'); list.innerHTML='';
   if(!(j.recent||[]).length){ list.innerHTML='<div style="color:var(--faint);font-size:12px;padding:6px 2px">暂无记录（每次对话后自动统计）</div>'; return; }
   for(const e of j.recent){

package/src/web/attachments.js

@@ -7,7 +7,7 @@
 const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍，对应约 5MB 原图
 const MAX_TEXT = 200 * 1024;
 
-export function buildUserContent(message, attachments, visionSupported) {
+export function buildUserContent(/** @type {any} */ message, /** @type {any} */ attachments, /** @type {any} */ visionSupported) {
   const text = String(message ?? '').trim();
   const list = Array.isArray(attachments) ? attachments.slice(0, 4) : [];
   const imageParts = [];

package/src/web/index.html

@@ -372,6 +372,18 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
     <h4 style="margin:4px 0;color:var(--accent2)">缓存命中率仪表盘（最近 10 次）</h4>
     <div id="cacheSummary" style="font-size:12.5px;color:var(--dim);padding:2px"></div>
     <div id="cacheRecent" style="max-height:130px;overflow-y:auto"></div>
+    <h4 style="margin:10px 0 4px;color:var(--accent2)">费用二级分账（模型 / 工具 Top5 · 近 14 天）</h4>
+    <div style="display:flex;gap:10px;flex-wrap:wrap">
+      <div style="flex:1;min-width:170px">
+        <div style="font-size:11.5px;color:var(--faint)">模型 Top5（费用）</div>
+        <div id="costTopModels" style="font-size:12px;color:var(--dim)"></div>
+      </div>
+      <div style="flex:1;min-width:170px">
+        <div style="font-size:11.5px;color:var(--faint)">工具 Top5（耗时）</div>
+        <div id="costTopTools" style="font-size:12px;color:var(--dim)"></div>
+      </div>
+    </div>
+    <div id="costLine" style="margin-top:8px"></div>
       </section>
     <section class="cfg-panel" data-panel="mcp">
     <hr style="border:none;border-top:1px solid var(--border);margin:14px 0 8px">