@my-life-buddies/cli 0.13.0 → 0.14.1

package/dist/web/diagnostics.js

@@ -0,0 +1,184 @@
+(() => {
+  "use strict";
+  window.createPreviewDiagnostics = ({ node, formatTime, formatDuration, toast, showError }) => {
+    const $ = id => document.getElementById(id);
+    const models = $("model-records"), logs = $("protocol-log");
+    const modelConversation = $("models-conversation"), logConversation = $("logs-conversation");
+    const kind = $("models-kind"), level = $("logs-level");
+    const modelSearch = $("models-search"), logSearch = $("logs-search");
+    let snapshot = {}, conversation = "", visibleLogs = [];
+    const cached = new Map(), expanded = new Map();
+    const object = value => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+    const json = value => typeof value === "string" ? value : JSON.stringify(value, null, 2);
+    const number = value => typeof value === "number" && Number.isFinite(value) && value >= 0;
+    const metricHelp = {
+      "模型响应耗时": "本次模型请求发出至响应结束。",
+      "模型首字耗时": "本次模型请求发出至首段输出。",
+      "结束原因": "模型停止原因；toolUse 表示请求调用工具。",
+      "输入 Token": "本次调用的输入 Token 数。",
+      "输出 Token": "本次调用的输出 Token 数。",
+      "缓存读取": "本次调用读取缓存的 Token 数。",
+      "缓存写入": "本次调用写入缓存的 Token 数。",
+      "总 Token": "本次调用上报的 Token 总数。",
+    };
+    function section(label, value, key) {
+      const details = node("details", { class: "diagnostic-section", "data-detail": key });
+      details.append(node("summary", {}, label));
+      details.append(node("pre", {}, json(value)));
+      return details;
+    }
+    function metrics(pairs) {
+      const list = node("dl", { class: "diagnostic-metrics" });
+      for (const [label, value] of pairs) {
+        const item = node("div");
+        const detail = node("dd", {}, value);
+        if (metricHelp[label]) {
+          detail.append(node("p", { class: "metric-help" }, metricHelp[label]));
+        }
+        item.append(node("dt", {}, label), detail);
+        list.append(item);
+      }
+      return list;
+    }
+    async function copy(text) {
+      try { await navigator.clipboard.writeText(text); toast("日志已复制"); }
+      catch { showError(new Error("浏览器未允许复制，请展开原始日志后手动选择")); }
+    }
+    function describe(record) {
+      const data = object(record.data), payload = object(data.payload);
+      if (record.kind === "request") {
+        const messages = payload.messages || payload.input;
+        const count = Array.isArray(messages) ? `${messages.length} 条上下文` : "请求上下文";
+        return `${typeof payload.model === "string" ? payload.model : "模型未上报"} · ${count}${Array.isArray(payload.tools) ? ` · ${payload.tools.length} 个工具` : ""}`;
+      }
+      const content = Array.isArray(data.content) ? data.content : [];
+      const texts = content.filter(item => item?.type === "text").map(item => item.text).filter(text => typeof text === "string");
+      const tools = content.filter(item => item?.type === "toolCall").map(item => item.name).filter(name => typeof name === "string");
+      return typeof data.error === "string" ? data.error : tools.length ? `请求工具：${tools.join("、")}` : texts.join(" ") || record.title;
+    }
+    function row(record, model) {
+      const data = object(record.data);
+      const details = node("details", { class: "diagnostic-entry", "data-record": record.id, "data-detail": "entry" });
+      details.dataset.level = data.error || data.stopReason === "error" ? "error" : record.level;
+      const summary = node("summary");
+      summary.append(node("span", { class: "diagnostic-badge", "data-kind": record.kind }, model ? record.kind === "request" ? "请求" : "响应" : record.level.toUpperCase()));
+      const heading = node("span", { class: "diagnostic-heading" });
+      heading.append(node("strong", {}, model ? record.kind === "request" ? "模型请求" : "模型响应" : record.title));
+      if (model) heading.append(node("span", { class: "diagnostic-preview" }, describe(record)));
+      summary.append(heading, node("time", { dateTime: record.timestamp, title: record.timestamp }, formatTime(record.timestamp)));
+      details.append(summary);
+      const body = node("div", { class: "diagnostic-body" });
+      const meta = node("div", { class: "diagnostic-meta" });
+      meta.append(node("span", {}, `${record.convoKey || "未标注会话"} · ${record.source}`));
+      const button = node("button", { type: "button", class: "text-button" }, "复制原始日志");
+      button.addEventListener("click", () => void copy(record.raw));
+      meta.append(button); body.append(meta);
+      if (record.truncated || (model && !record.data)) {
+        body.append(node("p", { class: "diagnostic-warning" }, record.truncated
+          ? "日志已截断，无法还原完整数据。请查看原始日志。"
+          : "尚未收到完整数据，或日志格式无法解析。已保留原始日志。"));
+      }
+      if (model && record.data) {
+        if (record.kind === "request") {
+          const payload = object(data.payload);
+          const messages = payload.messages ?? payload.input;
+          const system = payload.system ?? (Array.isArray(messages) ? messages.filter(item => ["system", "developer"].includes(item?.role)) : undefined);
+          if (system != null && (!Array.isArray(system) || system.length)) body.append(section("系统提示词", system, "system"));
+          if (messages != null) body.append(section(`请求上下文${Array.isArray(messages) ? ` · ${messages.length} 条` : ""}`, messages, "messages"));
+          if (payload.tools != null) body.append(section(`可用工具${Array.isArray(payload.tools) ? ` · ${payload.tools.length} 个` : ""}`, payload.tools, "tools"));
+          const { messages: _messages, input: _input, system: _system, tools: _tools, ...parameters } = payload;
+          body.append(section("模型与请求参数", parameters, "parameters"));
+          body.append(section("完整请求体", data.payload ?? data, "payload"));
+        } else {
+          const usage = object(data.usage);
+          body.append(metrics([
+            ["模型响应耗时", number(data.ms) ? formatDuration(data.ms) : "未上报"],
+            ["模型首字耗时", number(data.firstTokenMs) ? formatDuration(data.firstTokenMs) : "未上报"],
+            ["结束原因", typeof data.stopReason === "string" ? data.stopReason : "未上报"],
+          ]));
+          const tokenFields = [["输入 Token", "input"], ["输出 Token", "output"], ["缓存读取", "cacheRead"], ["缓存写入", "cacheWrite"], ["总 Token", "totalTokens"]];
+          body.append(metrics(tokenFields.map(([label, key]) => [label, number(usage[key]) ? String(usage[key]) : "未上报"])));
+          if (typeof data.error === "string" && data.error) body.append(node("p", { class: "diagnostic-warning" }, data.error));
+          const content = Array.isArray(data.content) ? data.content : [];
+          content.forEach((block, index) => {
+            if (!block || typeof block !== "object") return;
+            const label = block.type === "text" ? "响应正文" : block.type === "thinking" ? "思考内容（日志已提供）" : block.type === "toolCall" ? `工具调用请求 · ${block.name || "未命名"}` : `响应片段 · ${block.type || index + 1}`;
+            body.append(section(label, block.type === "text" ? block.text : block, `content-${index}`));
+          });
+          if (data.content != null && !content.length) body.append(section("响应内容", data.content, "content"));
+          if (data.usage != null) body.append(section("完整用量", data.usage, "usage"));
+        }
+      }
+      body.append(section("原始日志", record.raw, "raw"));
+      details.append(body);
+      return details;
+    }
+    function reconcile(container, records, model, emptyText) {
+      const prefix = model ? "model:" : "log:";
+      const wanted = new Set();
+      records.forEach((record, index) => {
+        const key = prefix + record.id;
+        wanted.add(key);
+        const signature = JSON.stringify(record);
+        let entry = cached.get(key);
+        if (!entry || entry.signature !== signature) {
+          if (entry) expanded.set(key, [...entry.node.querySelectorAll("details"), entry.node].filter(item => item.open).map(item => item.dataset.detail));
+          const element = row(record, model);
+          for (const item of [...element.querySelectorAll("details"), element]) item.open = (expanded.get(key) || []).includes(item.dataset.detail);
+          entry?.node.remove();
+          entry = { node: element, signature };
+          cached.set(key, entry);
+        }
+        if (container.children[index] !== entry.node) container.insertBefore(entry.node, container.children[index] || null);
+      });
+      for (const child of [...container.children]) if (!wanted.has(prefix + child.dataset.record)) child.remove();
+      if (!records.length) {
+        const empty = node("div", { class: "diagnostic-empty" });
+        empty.append(node("strong", {}, emptyText[0]), node("p", {}, emptyText[1]));
+        container.append(empty);
+      }
+    }
+    function updateConversations(records) {
+      const keys = [...new Set(records.map(record => record.convoKey).filter(Boolean))].sort();
+      if (conversation && !keys.includes(conversation)) keys.push(conversation);
+      for (const select of [modelConversation, logConversation]) {
+        if (document.activeElement === select) continue;
+        const signature = JSON.stringify(keys);
+        if (select.dataset.options !== signature) {
+          select.replaceChildren(node("option", { value: "" }, "全部会话"), ...keys.map(key => node("option", { value: key }, key)));
+          select.dataset.options = signature;
+        }
+        select.value = conversation;
+      }
+    }
+    function render() {
+      const runtime = snapshot.diagnostics?.records || [];
+      updateConversations(runtime);
+      const matches = (record, search) => (!conversation || record.convoKey === conversation) && (!search || record.raw.toLocaleLowerCase().includes(search.toLocaleLowerCase()));
+      const modelRecords = runtime.filter(record => record.kind === "request" || record.kind === "response");
+      const filteredModels = modelRecords.filter(record => (!kind.value || record.kind === kind.value) && matches(record, modelSearch.value.trim()));
+      reconcile(models, filteredModels, true, modelRecords.length
+        ? ["没有匹配的模型记录", "试试其他会话、类型或关键词。"]
+        : ["等待模型调用", "启动 DEV 并发送消息后，Runtime 提供的模型请求与响应会出现在这里。旧版本或未输出这些日志的 Runtime 可先查看运行日志。"]);
+      $("models-count").textContent = `${filteredModels.length} 条记录${snapshot.diagnostics?.dropped ? ` · 已淘汰 ${snapshot.diagnostics.dropped} 条较早日志` : ""}`;
+      const events = snapshot.events || [];
+      const deltas = events.filter(event => event.type === "run.output.delta").length;
+      const other = events.filter(event => event.type !== "run.output.delta" && (!snapshot.diagnostics || !/^agent\.(stdout|stderr)$/.test(event.type))).map(event => ({
+        id: event.eventId, timestamp: event.timestamp, source: event.channel, level: /failed|error|stderr/.test(event.type) ? "error" : "info", title: event.summary || event.type,
+        kind: "log", raw: `${event.timestamp} ${event.channel} ${event.type}${event.runId ? ` ${event.runId}` : ""}\n${event.summary || ""}`,
+      }));
+      const allLogs = [...runtime, ...other].sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
+      visibleLogs = allLogs.filter(record => (!level.value || record.level === level.value || level.value === "error" && (record.data?.error || record.data?.stopReason === "error")) && matches(record, logSearch.value.trim()));
+      reconcile(logs, visibleLogs, false, allLogs.length ? ["没有匹配的日志", "调整会话、级别或搜索条件后再试。"] : ["等待运行日志", "启动 DEV 后，这里会保留进程输出与连接事件。"]);
+      $("logs-count").textContent = `${visibleLogs.length} 条可见日志${deltas ? ` · 已折叠 ${deltas} 条文字分片事件` : ""}${snapshot.diagnostics?.dropped ? ` · 已淘汰 ${snapshot.diagnostics.dropped} 条较早日志` : ""}`;
+      const retained = new Set([...runtime.map(record => record.id), ...other.map(record => record.id)]);
+      for (const key of cached.keys()) if (!retained.has(key.slice(key.indexOf(":") + 1))) { cached.delete(key); expanded.delete(key); }
+    }
+    for (const select of [modelConversation, logConversation]) {
+      select.addEventListener("change", () => { conversation = select.value; render(); });
+      select.addEventListener("blur", render);
+    }
+    for (const input of [kind, level, modelSearch, logSearch]) input.addEventListener(input.type === "search" ? "input" : "change", render);
+    return { update(next) { snapshot = next; render(); }, copyLogs() { return copy(visibleLogs.map(record => record.raw).join("\n\n")); } };
+  };
+})();

package/dist/web/index.html

@@ -13,6 +13,7 @@
     <link rel="stylesheet" href="/assets/app.css">
     <script src="/assets/iphone-16-max.js" defer></script>
     <script src="/assets/widgets.js" defer></script>
+    <script src="/assets/diagnostics.js" defer></script>
     <script src="/assets/app.js" defer></script>
     <link rel="stylesheet" href="/assets/widgets.css">
   </head>
@@ -30,16 +31,13 @@
           <p class="sidebar-label">开发调试</p>
           <nav class="debug-tabs" role="tablist" aria-label="本地回合调试视图">
             <button id="tab-overview" role="tab" aria-selected="true" aria-controls="panel-overview" tabindex="0">
-              <svg aria-hidden="true" viewBox="0 0 24 24"><rect x="4" y="4" width="7" height="7" rx="1.5"/><rect x="13" y="4" width="7" height="7" rx="1.5"/><rect x="4" y="13" width="7" height="7" rx="1.5"/><rect x="13" y="13" width="7" height="7" rx="1.5"/></svg><span>概览</span>
+              <svg aria-hidden="true" viewBox="0 0 24 24"><rect x="4" y="4" width="7" height="7" rx="1.5"/><rect x="13" y="4" width="7" height="7" rx="1.5"/><rect x="4" y="13" width="7" height="7" rx="1.5"/><rect x="13" y="13" width="7" height="7" rx="1.5"/></svg><span>运行概况</span>
             </button>
-            <button id="tab-timeline" role="tab" aria-selected="false" aria-controls="panel-timeline" tabindex="-1">
-              <svg aria-hidden="true" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8"/><path d="M12 7v5l3.5 2"/></svg><span>执行时间线</span>
-            </button>
-            <button id="tab-context" role="tab" aria-selected="false" aria-controls="panel-context" tabindex="-1">
-              <svg aria-hidden="true" viewBox="0 0 24 24"><path d="M4 5h13v10H9l-4 4v-4H4Z"/><path d="M8 9h5M8 12h3M18 8h2v10h-7"/></svg><span>对话记录</span>
+            <button id="tab-models" role="tab" aria-selected="false" aria-controls="panel-models" tabindex="-1">
+              <svg aria-hidden="true" viewBox="0 0 24 24"><path d="M4 5h16v14H4ZM8 9h8M8 13h5"/></svg><span>模型调用</span>
             </button>
             <button id="tab-protocol" role="tab" aria-selected="false" aria-controls="panel-protocol" tabindex="-1">
-              <svg aria-hidden="true" viewBox="0 0 24 24"><rect x="3.5" y="5" width="17" height="14" rx="2"/><path d="m7.5 9 3 3-3 3M13 15h3.5"/></svg><span>协议日志</span>
+              <svg aria-hidden="true" viewBox="0 0 24 24"><rect x="3.5" y="5" width="17" height="14" rx="2"/><path d="m7.5 9 3 3-3 3M13 15h3.5"/></svg><span>运行日志</span>
             </button>
           </nav>
         </div>
@@ -85,6 +83,18 @@
 
         <main class="workspace" id="debug-content">
       <section class="debugger" aria-label="本地回合调试器">
+        <div class="debug-panels">
+          <section id="panel-models" class="debug-panel" role="tabpanel" aria-labelledby="tab-models" hidden>
+            <div class="section-heading"><div><h3>模型调用</h3></div></div>
+            <div class="diagnostic-filters">
+              <label>会话<select id="models-conversation" aria-label="模型会话"><option value="">全部会话</option></select></label>
+              <label>类型<select id="models-kind"><option value="">请求与响应</option><option value="request">模型请求</option><option value="response">模型响应</option></select></label>
+              <label class="diagnostic-search">搜索<input id="models-search" type="search" placeholder="搜索模型、工具或内容" autocomplete="off"></label>
+            </div>
+            <p class="diagnostic-note" id="models-count"></p>
+            <div id="model-records" class="diagnostic-records"></div>
+          </section>
+          <section id="panel-overview" class="debug-panel" role="tabpanel" aria-labelledby="tab-overview">
         <div class="run-strip">
           <div class="run-heading">
             <div class="run-identity">
@@ -93,10 +103,10 @@
                 <h2 id="run-title">尚无本地回合</h2>
                 <span class="status-pill" id="run-status" data-status="idle">等待消息</span>
               </div>
-              <div class="run-reference" id="run-reference" hidden>
+              <details class="run-reference" id="run-reference" hidden><summary>本地发送回执 ID</summary>
                 <span id="run-id"></span>
                 <button type="button" class="text-button" id="copy-run-id" disabled>复制 ID</button>
-              </div>
+              </details>
             </div>
             <div class="run-controls">
               <label class="run-picker-label" for="run-picker">切换回合</label>
@@ -112,29 +122,25 @@
           </div>
 
           <dl class="run-metrics" aria-label="本地回合指标">
-            <div><dt>接收</dt><dd id="metric-accept">—</dd></div>
-            <div><dt>首段文字</dt><dd id="metric-first">—</dd></div>
-            <div><dt>完整耗时</dt><dd id="metric-response">—</dd></div>
-            <div><dt>消息</dt><dd id="metric-messages">0</dd></div>
+            <div><dt>消息被接收</dt><dd><span id="metric-accept">未记录</span><p class="metric-help">Preview 发起发送至平台确认接收。</p></dd></div>
+            <div><dt>首字耗时</dt><dd><span id="metric-first">未记录</span><p class="metric-help">Preview 发起发送至收到首段文字。</p></dd></div>
+            <div><dt>回复结束</dt><dd><span id="metric-response">未记录</span><p class="metric-help">Preview 发起发送至观察到回复结束。</p></dd></div>
+            <div><dt>会话消息</dt><dd><span id="metric-messages">0</span><p class="metric-help">当前会话的消息总数，包含历史消息。</p></dd></div>
           </dl>
 
         </div>
-
-        <div class="debug-panels">
-          <section id="panel-overview" class="debug-panel" role="tabpanel" aria-labelledby="tab-overview">
             <div class="overview-grid">
               <article class="run-summary">
                 <div class="section-heading">
-                  <div><h3>这一次发生了什么</h3><p>从消息到回复，按真实事件还原。</p></div>
-                  <span class="source-label">本机观测</span>
+                  <div><h3>回复观察</h3></div>
                 </div>
                 <div class="empty-state" id="overview-empty">
-                  <span class="empty-glyph" aria-hidden="true">↗</span>
                   <h4>发一条消息，开始记录</h4>
-                  <p>这里会按本地回合展示真实的接收、首段文字、生成过程和完成状态。</p>
+                  <p>右侧发送消息后，这里显示消息发送与回复的观察结果。</p>
                 </div>
                 <div id="overview-content" hidden>
-                  <div class="waterfall" id="waterfall" aria-label="本地回合耗时分布"></div>
+                  <ol class="run-progress" id="run-progress" aria-label="回合执行进度"></ol>
+                  <div class="waterfall" id="waterfall" aria-label="消息时间节点，均从发起发送计时"></div>
                   <p class="run-summary-copy" id="run-summary-copy"></p>
                 </div>
               </article>
@@ -144,34 +150,26 @@
                 <h3>DEV · 私聊</h3>
                 <dl>
                   <div><dt>Agent</dt><dd id="environment-agent">等待启动</dd></div>
-                  <div><dt>Runtime</dt><dd id="environment-runtime">—</dd></div>
-                  <div><dt>模型</dt><dd id="environment-model">—</dd></div>
+                  <div><dt>Runtime</dt><dd id="environment-runtime">未记录</dd></div>
+                  <div><dt>模型</dt><dd id="environment-model">未记录</dd></div>
                 </dl>
               </article>
             </div>
-          </section>
-
-          <section id="panel-timeline" class="debug-panel" role="tabpanel" aria-labelledby="tab-timeline" hidden>
-            <div class="section-heading">
-              <div><h3>执行时间线</h3><p>按发生顺序查看消息发送、流式输出和会话状态。</p></div>
-              <span class="source-label">真实事件</span>
-            </div>
-            <ol class="timeline" id="timeline-list"></ol>
-          </section>
-
-          <section id="panel-context" class="debug-panel" role="tabpanel" aria-labelledby="tab-context" hidden>
-            <div class="section-heading">
-              <div><h3>当前对话记录</h3><p>展示平台保存的当前对话消息。</p></div>
-              <span class="source-label" id="context-source">平台聊天记录</span>
-            </div>
-            <div class="context-list" id="context-list"></div>
+            <details class="diagnostic-history"><summary>消息与连接事件</summary><ol class="timeline" id="timeline-list"></ol></details>
+            <details class="diagnostic-history"><summary>平台对话记录 <span id="context-source">平台聊天记录</span></summary><div class="context-list" id="context-list"></div></details>
           </section>
 
           <section id="panel-protocol" class="debug-panel" role="tabpanel" aria-labelledby="tab-protocol" hidden>
             <div class="section-heading">
-              <div><h3>协议日志</h3><p>Runtime 输出、错误堆栈与 MLB 通信事件。</p></div>
+              <div><h3>运行日志</h3></div>
               <button class="text-button" id="copy-protocol" type="button">复制可见日志</button>
             </div>
+            <div class="diagnostic-filters">
+              <label>会话<select id="logs-conversation" aria-label="日志会话"><option value="">全部会话</option></select></label>
+              <label>级别<select id="logs-level"><option value="">全部级别</option><option value="error">ERROR</option><option value="warn">WARN</option><option value="info">INFO</option></select></label>
+              <label class="diagnostic-search">搜索<input id="logs-search" type="search" placeholder="搜索日志内容" autocomplete="off"></label>
+            </div>
+            <p class="diagnostic-note" id="logs-count"></p>
             <div class="protocol-log" id="protocol-log" role="log" aria-live="polite"></div>
           </section>
         </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@my-life-buddies/cli",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "type": "module",
   "description": "搭搭 Developer Platform 命令行工具",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "ws": "8.21.3"
   },
   "devDependencies": {
-    "@buddy/cli-core": "0.13.0",
-    "@buddy/preview": "0.13.0"
+    "@buddy/cli-core": "0.14.1",
+    "@buddy/preview": "0.14.1"
   }
 }

package/resources/agent-template/package-lock.json

@@ -8,7 +8,7 @@
       "name": "buddy-agent-project",
       "version": "0.0.0",
       "dependencies": {
-        "@my-life-buddies/buddy-runtime": "0.12.2",
+        "@my-life-buddies/buddy-runtime": "0.16.0",
         "typebox": "1.3.7"
       },
       "engines": {
@@ -981,9 +981,9 @@
       }
     },
     "node_modules/@my-life-buddies/buddy-runtime": {
-      "version": "0.12.2",
-      "resolved": "https://registry.npmjs.org/@my-life-buddies/buddy-runtime/-/buddy-runtime-0.12.2.tgz",
-      "integrity": "sha512-LoPt78FO/h6roKoOjVBREeW5UxsZv1NEE41RkIdhg4ffeHL0rzQvi9yaXel+PNT9W9Ud5JfxDTMF7kpqgs0Y7A==",
+      "version": "0.16.0",
+      "resolved": "https://registry.npmjs.org/@my-life-buddies/buddy-runtime/-/buddy-runtime-0.16.0.tgz",
+      "integrity": "sha512-NkJef6s39Fs/pnxtC5q5ee8dEFMUudPcyO6a4v22xMZmaDIsFBvb/R3D1q1/bVrSCKAvhSaVe0sM9LrhuPn02w==",
       "dependencies": {
         "@earendil-works/pi-agent-core": "0.85.1",
         "@earendil-works/pi-ai": "0.85.1",

package/resources/agent-template/package.json

@@ -4,13 +4,13 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "start": "node start.mjs"
+    "start": "node --env-file-if-exists=.env start.mjs"
   },
   "engines": {
     "node": ">=24"
   },
   "dependencies": {
-    "@my-life-buddies/buddy-runtime": "0.12.2",
+    "@my-life-buddies/buddy-runtime": "0.16.0",
     "typebox": "1.3.7"
   }
 }