@yxzpro/agent-acta 2.14.4

package/page/dialog-compare.js

@@ -0,0 +1,238 @@
+// 两轮对比弹层（候选池 I9）：选中主列表里两条轮，并排对比模型 / token / 工具链 / 耗时，
+// 回答「同一个 prompt 为什么这次慢」。入口 = 每张卡片顶行的「对比」按钮（选两条自动弹开）。
+// 契约见 page/shared.js 头部的「R25 组件文件契约」；Vue / Element Plus 的 API 一律写全名。
+//
+// 数据进出：
+//   · visible ← 根（卡片「对比」选满两条 / 弹层关闭时回写）
+//   · req     ← 根：{ a, b } —— 两条条目本体（快照 / 搜索命中集里现有的对象，带模型 / token / 耗时等统计字段）
+//   · getJSON ← 根 provide（接口 404 要点亮版本红条）
+//   · 正文（用户输入 / AI 输出 / 工具链）仍走 /api/entry 懒加载：点开对比才取，两条各自独立缓存。
+//
+// 对比口径：统计行用的是条目**本体**（快照就带，不必等详情），正文与工具链用的是 /api/entry 详情。
+// 每条指标行给一个「谁大」的标记 —— 这一条是 diff 的意义所在，光把两列摆一起不标出差值不算对比。
+// qoder 不落盘 token（tin/tout/total 恒 0，只有最后一次调用的 context_usage_ratio）：
+//   它的格子一律走「积分」与「占比」两行，绝不在 Token 行印 0（印了会被读成「这轮没花钱」），
+//   两侧单位不同（一积分一 token）时不做差 —— 与卡片 page/log-card.js 的 isQoder 分支同一口径。
+window.AACTA = window.AACTA || {};
+AACTA.DialogCompare = {
+  name: 'aa-dialog-compare',
+  template: `
+  <el-dialog :model-value="visible" @update:model-value="v => $emit('update:visible', v)" title="两轮对比" width="min(1100px, 96vw)" append-to-body class="cmp-dialog" top="4vh">
+    <div v-if="!reqA || !reqB" class="empty">还没有选够两条轮，先回列表里点卡片顶行的「对比」。</div>
+    <div v-else>
+      <!-- 概览：两列头部（agent / 模型 / 时间 / 状态）+ 耗时条相对比例 -->
+      <div class="cmp-head">
+        <div class="cmp-col cmp-col-b">
+          <div class="cmp-hdr">
+            <span class="cmp-agent"><b>{{ titleOf(reqA) }}</b></span>
+            <span class="mini-tag">{{ reqA.agent }}</span>
+            <span :class="'tag ' + (reqA.status==='ok' ? 'tag-ok' : 'tag-err')">{{ reqA.status==='ok' ? 'OK' : 'ERR ⚠' }}</span>
+          </div>
+          <div class="cmp-meta">{{ fmtTime(reqA.time) }} · {{ reqA.project }}</div>
+        </div>
+        <div class="cmp-vs">VS</div>
+        <div class="cmp-col">
+          <div class="cmp-hdr">
+            <span class="cmp-agent"><b>{{ titleOf(reqB) }}</b></span>
+            <span class="mini-tag">{{ reqB.agent }}</span>
+            <span :class="'tag ' + (reqB.status==='ok' ? 'tag-ok' : 'tag-err')">{{ reqB.status==='ok' ? 'OK' : 'ERR ⚠' }}</span>
+          </div>
+          <div class="cmp-meta">{{ fmtTime(reqB.time) }} · {{ reqB.project }}</div>
+        </div>
+      </div>
+
+      <div class="cmp-table">
+        <!-- 耗时：并排进度条，一眼看出谁慢 -->
+        <div class="cmp-row cmp-dur">
+          <span class="cmp-label">耗时<b v-if="durDiffOn" class="cmp-hot">差 {{ cmpDurText }}</b></span>
+          <div class="cmp-barwrap">
+            <div class="cmp-bar" :style="{width: durPctOf(reqA) + '%'}"><span>{{ fmtDur(reqA.dur) }}</span></div>
+          </div>
+          <div class="cmp-barwrap">
+            <div class="cmp-bar bar-b" :style="{width: durPctOf(reqB) + '%'}"><span>{{ fmtDur(reqB.dur) }}</span></div>
+          </div>
+        </div>
+        <!-- 指标行全在 setup 的 cmpRows 里算：显示文本、「谁大」、「差多少」用同一份数，不在模板里各算一遍 -->
+        <div class="cmp-row" v-for="r in cmpRows" :key="r.label">
+          <span class="cmp-label">{{ r.label }}<b v-if="r.hot" class="cmp-hot">{{ r.hot }}</b></span>
+          <span class="cmp-val" :class="{big: r.big === 'a'}" :title="r.at">{{ r.a }}</span>
+          <span class="cmp-val" :class="{big: r.big === 'b'}" :title="r.bt">{{ r.b }}</span>
+        </div>
+      </div>
+
+      <div class="cmp-loading" v-if="loading">正在读取两条正文…</div>
+      <div v-else-if="err" class="cmp-err">{{ err }} <el-button size="small" @click="load">重试</el-button></div>
+      <!-- 正文对比 -->
+      <div v-else class="cmp-body">
+        <div class="cmp-sec">
+          <div class="cmp-sec-head"><h4>用户输入</h4></div>
+          <div class="cmp-cols">
+            <div class="cmp-col"><pre class="cmp-pre">{{ detA && detA.user ? detA.user : '(空)' }}</pre></div>
+            <div class="cmp-col"><pre class="cmp-pre">{{ detB && detB.user ? detB.user : '(空)' }}</pre></div>
+          </div>
+        </div>
+        <div class="cmp-sec" v-if="(detA && detA.assistant) || (detB && detB.assistant)">
+          <div class="cmp-sec-head"><h4>AI 输出</h4></div>
+          <div class="cmp-cols">
+            <div class="cmp-col"><div v-if="detA && detA.assistant" class="md-body" v-html="detA._assistantMd"></div><span v-else class="cmp-none">(无)</span></div>
+            <div class="cmp-col"><div v-if="detB && detB.assistant" class="md-body" v-html="detB._assistantMd"></div><span v-else class="cmp-none">(无)</span></div>
+          </div>
+        </div>
+        <div class="cmp-sec" v-if="(detA && detA.tools && detA.tools.length) || (detB && detB.tools && detB.tools.length)">
+          <div class="cmp-sec-head"><h4>工具调用</h4></div>
+          <!-- 入参/返回一律先读 prepDetail 缓存的 _inPretty / _outPretty（缓存缺失才现算）：
+               一对长会话能并到 90 多个工具项，每条重渲染都全量 prettyJson 就是把卡片当年踩过的坑再踩一遍。 -->
+          <div class="cmp-cols">
+            <div class="cmp-col">
+              <div v-for="(t, i) in (detA ? detA.tools : [])" :key="i" class="tool-item cmp-tool">
+                <div class="tool-head"><span class="tname">{{ t.name }}</span><span v-if="t.error" class="terr">✗ {{ t.error }}</span><span v-if="t.dur!=null" class="tdur">{{ fmtDur(t.dur) }}</span></div>
+                <pre v-if="t.input" class="cmp-pre">{{ t._inPretty || prettyJson(t.input) }}</pre>
+                <pre v-if="t.output" class="cmp-pre">{{ t._outPretty || prettyJson(t.output) }}</pre>
+              </div>
+              <span v-if="!detA || !detA.tools || !detA.tools.length" class="cmp-none">(没有工具调用)</span>
+            </div>
+            <div class="cmp-col">
+              <div v-for="(t, i) in (detB ? detB.tools : [])" :key="i" class="tool-item cmp-tool">
+                <div class="tool-head"><span class="tname">{{ t.name }}</span><span v-if="t.error" class="terr">✗ {{ t.error }}</span><span v-if="t.dur!=null" class="tdur">{{ fmtDur(t.dur) }}</span></div>
+                <pre v-if="t.input" class="cmp-pre">{{ t._inPretty || prettyJson(t.input) }}</pre>
+                <pre v-if="t.output" class="cmp-pre">{{ t._outPretty || prettyJson(t.output) }}</pre>
+              </div>
+              <span v-if="!detB || !detB.tools || !detB.tools.length" class="cmp-none">(没有工具调用)</span>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <template #footer>
+      <span class="cmp-foot">两条轮对比的是「同一件事这次为什么慢」—— 先看耗时条，再比对模型 / token / 工具链。</span>
+      <el-button @click="$emit('update:visible', false)">关闭</el-button>
+    </template>
+  </el-dialog>`,
+  props: {
+    visible: Boolean,
+    // 被对比的两条轮：{ a, b }，条目本体（快照 / 搜索命中集中的对象）。
+    req: { type: Object, default: null },
+  },
+  emits: ['update:visible'],
+  setup(props) {
+    const getJSON = Vue.inject('getJSON');
+    const detA = Vue.ref(null), detB = Vue.ref(null);   // /api/entry 的详情（含正文 / 工具）
+    const loading = Vue.ref(false), err = Vue.ref('');
+    let loadedKey = '';   // 'a.id + "_" + b.id'：别拿旧条目的缓存去配新条目
+
+    async function load() {
+      const a = props.req && props.req.a, b = props.req && props.req.b;
+      if (!a || !b) { detA.value = detB.value = null; return; }
+      const key = a.id + '_' + b.id;
+      loading.value = true; err.value = '';
+      try {
+        const [ja, jb] = await Promise.all([
+          getJSON('/api/entry?id=' + encodeURIComponent(a.id)),
+          getJSON('/api/entry?id=' + encodeURIComponent(b.id)),
+        ]);
+        if (key !== loadedKey) return;   // 打开期间换代了，丢弃旧响应
+        detA.value = prepDetail(ja); detB.value = prepDetail(jb);
+      } catch (e) {
+        if (key === loadedKey) err.value = '读取详情失败：' + e.message;
+      } finally { if (key === loadedKey) loading.value = false; }
+    }
+    // labels 复用 set 前后序：loadedKey 要跟当前对比对一致才复用 / 触发加载
+    Vue.watch(() => props.req, r => {
+      err.value = '';
+      const k = (r && r.a && r.b) ? r.a.id + '_' + r.b.id : '';
+      if (k === loadedKey) return;        // 同两条：已有的详情直接可看，不重拉
+      loadedKey = k;
+      detA.value = detB.value = null;
+      if (k) load();
+    });
+
+    const reqA = Vue.computed(() => (props.req && props.req.a) || null);
+    const reqB = Vue.computed(() => (props.req && props.req.b) || null);
+    // 指标行：两侧同单位才作差、才标「谁大」；一侧没这个单位（qoder 无 token / 别家无积分）就给 '—'。
+    const cmpRows = Vue.computed(() => {
+      const a = reqA.value, b = reqB.value;
+      if (!a || !b) return [];
+      const DASH = '—';
+      const qa = isQoder(a), qb = isQoder(b);
+      const nOf = v => (typeof v === 'number' && isFinite(v) ? v : null);
+      const rows = [];
+      // ka/kb 是两格各自要挂的 title：'—' 有两种意思（这条根本没数据 / 这一行对它压根不适用），
+      // 不分开写清就会让人以为「另一条没花 token」也是缺数据。
+      const push = (label, ta, tb, na, nb, fmtDiff, ka, kb) => {
+        let hot = '', big = '';
+        if (na != null && nb != null && na !== nb) {
+          big = na > nb ? 'a' : 'b';
+          hot = '差 ' + (fmtDiff ? fmtDiff(Math.abs(na - nb)) : fmtN(Math.abs(na - nb)));
+        }
+        rows.push({ label, a: ta, b: tb, hot, big, at: ka || '', bt: kb || '' });
+      };
+      const NO_CREDIT = '这条不按积分计费（按 token），见下面 Token 行';
+      const NO_TOKEN = 'qoder 不落盘 token（恒 0），它的花费在「积分」行';
+      const NO_CTX = '日志没给这轮的占用与窗口容量';
+      push('模型', modelText(a.models) || '(无模型信息)', modelText(b.models) || '(无模型信息)');
+      push('LLM 调用', a.calls != null ? String(a.calls) : DASH, b.calls != null ? String(b.calls) : DASH, nOf(a.calls), nOf(b.calls));
+      push('工具', a.tools != null ? String(a.tools) : DASH, b.tools != null ? String(b.tools) : DASH, nOf(a.tools), nOf(b.tools));
+      // 积分：只要有一条是 qoder 就出这一行，非 qoder 那侧给 '—'（单位不同，不作差）
+      if (qa || qb) {
+        const cr = e => (isQoder(e) && e.credits != null ? fmtCredits(e.credits) : DASH);
+        const crn = e => (isQoder(e) && e.credits != null ? nOf(e.credits) : null);
+        push('积分', cr(a), cr(b), crn(a), crn(b), v => v.toFixed(2),
+          isQoder(a) ? '' : NO_CREDIT, isQoder(b) ? '' : NO_CREDIT);
+      }
+      // Token 四行：qoder 那侧一律 '—' —— 它的 tin/tout/total 恒 0，印 0 会被读成「这轮没花钱」
+      if (!qa || !qb) {
+        const tk = (label, f) => push(label,
+          isQoder(a) ? DASH : fmtN(f(a)), isQoder(b) ? DASH : fmtN(f(b)),
+          isQoder(a) ? null : nOf(f(a)), isQoder(b) ? null : nOf(f(b)), null,
+          isQoder(a) ? NO_TOKEN : '', isQoder(b) ? NO_TOKEN : '');
+        tk('Token 输入', e => e.tin);
+        tk('Token 输出', e => e.tout);
+        tk('缓存命中', e => e.tcache);
+        tk('Token 合计', sumTok);
+      }
+      // 上下文占用：qoder 只有占比（日志不落窗口容量），别家给「占用 / 容量（百分比）」；
+      // 作差用的是同一把尺（0–1 占用率），所以两侧单位不同也能比。
+      const ctxText = e => isQoder(e) ? (e.ctxRatio > 0 ? fmtPct(e.ctxRatio) : DASH)
+        : (e.ctxUsed != null || e.ctx)
+          ? fmtN(ctxUsed(e)) + (e.ctx ? ' / ' + fmtN(e.ctx) + '（' + ctxPct(e) + '%）' : '')
+          : DASH;
+      const ctxNum = e => isQoder(e) ? (e.ctxRatio > 0 ? Math.min(1, e.ctxRatio > 1 ? e.ctxRatio / 100 : e.ctxRatio) : null)
+        : (e.ctx ? ctxPct(e) / 100 : null);
+      push('上下文占用', ctxText(a), ctxText(b), ctxNum(a), ctxNum(b), v => Math.round(v * 100) + '%',
+        ctxNum(a) == null ? NO_CTX : '', ctxNum(b) == null ? NO_CTX : '');
+      if (a.compacts || b.compacts) {
+        // I12：压缩对比也带上「自动/手动」「丢多少」「等多久」——两侧各自缺哪一位就不说哪一位。
+        const cp = e => {
+          if (!e.compacts) return DASH;
+          let s = e.compacts + ' 次';
+          if (e.compAuto || e.compManual) s += '（自动' + (e.compAuto || 0) + ' / 手动' + (e.compManual || 0) + '）';
+          if (e.compPre) s += '（' + fmtN(e.compPre) + '→' + fmtN(e.compPost) + '）';
+          if (e.compDrop) s += ' 丢 ' + fmtN(e.compDrop);
+          if (e.compMs) s += ' 等 ' + fmtDur(e.compMs);
+          return s;
+        };
+        push('压缩', cp(a), cp(b));
+      }
+      return rows;
+    });
+    // 耗时条：以两条里较大者为满刻度，谁慢谁就顶满
+    const durMax = Vue.computed(() => Math.max((reqA.value && reqA.value.dur) || 0, (reqB.value && reqB.value.dur) || 0));
+    const durPctOf = e => durMax.value ? Math.max(2, Math.round(((e && e.dur) || 0) / durMax.value * 100)) : 0;
+    const durDiffOn = Vue.computed(() => durMax.value > 0 && reqA.value && reqB.value && reqA.value.dur !== reqB.value.dur);
+    const cmpDurText = Vue.computed(() => {
+      if (!durDiffOn.value) return '';
+      const a = (reqA.value && reqA.value.dur) || 0, b = (reqB.value && reqB.value.dur) || 0;
+      const abs = Math.abs(a - b);
+      const fast = a < b ? 'A 快' : 'B 快';
+      return fast + ' ' + fmtDur(abs);
+    });
+    const titleOf = e => {
+      const mt = modelText(e && e.models);
+      if (mt) return mt;
+      if (e && e.name) return e.name;
+      return '(无模型信息)';
+    };
+    return { reqA, reqB, detA, detB, loading, err, load, cmpRows,
+      durPctOf, durDiffOn, cmpDurText, titleOf, fmtDur, fmtTime, prettyJson };
+  }
+};

package/page/dialog-ctxw.js

@@ -0,0 +1,101 @@
+// 上下文窗口弹层（R25 批 1 第三个组件）。
+// 契约见 page/shared.js 头部；顶层只许有那一处 AACTA 赋值，Vue / Element Plus 的 API 一律写全名。
+//
+// 数据进出 —— 这个弹层与别处不同：**表数据不属于它**。
+//   改前 ctxw.rows/unknown 就是根里的一个 reactive，侧栏那枚「待填 N」徽章（ctxUnfilled）吃的是
+//   同一份 unknown.length。搬的时候如果把表整个端进组件，根就得在徽章和服务之间来回同步两份状态。
+//   所以定成：**弹层自己拉、自己改（编辑态是它的），拉回来的结论上报给根**（emit('unfilled', n)），
+//   根只留一个数字给徽章。保存成功后同样上报 —— 服务端重算了卡片，徽章要跟着变。
+//   · visible ← 根（侧栏「上下文窗口」项点开、弹层自己关闭时回写）
+//   · getJSON ← 根 provide（404 要点亮版本红条）
+window.AACTA = window.AACTA || {};
+AACTA.DialogCtxw = {
+  name: 'aa-dialog-ctxw',
+  template: `
+  <el-dialog :model-value="visible" @update:model-value="v => $emit('update:visible', v)" title="上下文窗口" width="640px" append-to-body>
+    <div class="diag-hint">
+      卡片上「上下文」那根进度条需要两个数：<b>分子</b>是这一轮的占用（从日志里的 usage 算，已经有了），
+      <b>分母</b>是模型窗口容量。分母**只有 claude 和 kimi 拿不到** —— 其余 agent 自带这个字段；
+      claude 的请求体不落盘、kimi 的 wire.jsonl 只记用量，都只能按模型名查这张表。
+      查不到的模型就只显示占用、不画条：宁可少一根条，也不拿一个假分母凑出一根看着像真的。
+      <div style="margin-top:6px">表里的名字是**日志里的模型名**（网关转发后的名字，如 deepseek-flash / kimi-k3）。可以写全名，也可以写前缀（按最长命中）。填 <b>0</b> 表示停用这一条。</div>
+    </div>
+    <el-skeleton v-if="ctxw.loading" :rows="4" animated></el-skeleton>
+    <template v-else>
+      <div class="ctxw-t">已配置</div>
+      <div v-for="(r, i) in ctxw.rows" :key="i" class="ctxw-row" :class="{off: !(r.value > 0)}">
+        <el-input v-model="r.name" size="small" placeholder="模型名或前缀" class="ctxw-name"></el-input>
+        <el-input-number v-model="r.value" size="small" :min="0" :step="1024" :controls="false" class="ctxw-val"></el-input-number>
+        <span class="ctxw-src">{{ r.builtin ? '内置' : '自定义' }}{{ !(r.value > 0) ? ' · 停用' : '' }}</span>
+        <el-icon class="del-btn" title="删掉这一行（保存后生效）" @click="ctxw.rows.splice(i, 1)"><Close></Close></el-icon>
+      </div>
+      <el-button size="small" style="margin-top:6px" @click="ctxw.rows.push({ name: '', value: 200000, builtin: false })">加一行</el-button>
+
+      <template v-if="ctxw.unknown.length">
+        <div class="ctxw-t" style="margin-top:14px">日志里出现过、表里没有的模型（点一下加进上表）</div>
+        <div class="ctxw-chips">
+          <span v-for="u in ctxw.unknown" :key="u.model" class="ctxw-chip" @click="addCtxRow(u.model)">
+            {{ u.model }} <small>{{ u.n }} 轮</small>
+          </span>
+        </div>
+      </template>
+      <div v-else class="ctxw-t" style="margin-top:14px;font-weight:400;color:var(--placeholder)">
+        日志里的模型都有窗口值了。
+      </div>
+    </template>
+    <template #footer>
+      <el-button @click="$emit('update:visible', false)">关闭</el-button>
+      <el-button type="primary" :loading="ctxw.saving" @click="saveCtxWindows">保存</el-button>
+    </template>
+  </el-dialog>`,
+  props: {
+    visible: Boolean,
+  },
+  emits: ['update:visible', 'unfilled'],
+  setup(props, { emit }) {
+    const getJSON = Vue.inject('getJSON');
+    // visible 不在这个对象里：开关归根（与别的弹层一致），放这儿会有两份真相
+    const ctxw = Vue.reactive({ loading: false, saving: false, rows: [], unknown: [] });
+    // 服务端每次都整表回吐（含刚刚保存后的重算结果），落地与上报只有这一处
+    function apply(j) {
+      ctxw.rows = (j.windows || []).map(r => ({ name: r.name, value: r.value, builtin: !!r.builtin }));
+      ctxw.unknown = j.unknown || [];
+      emit('unfilled', ctxw.unknown.length);   // 侧栏徽章在根上，只有它需要知道这个数
+    }
+    async function load() {
+      ctxw.loading = true;
+      try {
+        const j = await getJSON('/api/ctxwindows');
+        if (!j.ok) throw new Error(j.error || '读取失败');
+        apply(j);
+      } catch (e) {
+        ElementPlus.ElMessage.error('读取上下文窗口表失败：' + e.message);
+      } finally { ctxw.loading = false; }
+    }
+    function addCtxRow(model) {
+      if (ctxw.rows.some(r => r.name === model)) { ElementPlus.ElMessage.info('这个模型已经在表里了'); return; }
+      ctxw.rows.push({ name: model, value: 200000, builtin: false });
+      ctxw.unknown = ctxw.unknown.filter(u => u.model !== model);
+    }
+    async function saveCtxWindows() {
+      ctxw.saving = true;
+      try {
+        // 整表提交：空名字的行丢掉，0/空 = 停用（照常提交，否则内置那条默认删不掉）
+        const windows = ctxw.rows
+          .map(r => ({ name: String(r.name || '').trim(), value: Number(r.value) > 0 ? Math.round(Number(r.value)) : 0 }))
+          .filter(r => r.name);
+        const j = await getJSON('/api/ctxwindows', {
+          method: 'POST', headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ windows }),
+        });
+        if (!j.ok) throw new Error(j.error || '保存失败');
+        apply(j);
+        ElementPlus.ElMessage.success(j.changed ? '已保存，重算了 ' + j.changed + ' 张卡片' : '已保存');
+      } catch (e) {
+        ElementPlus.ElMessage.error('保存失败：' + e.message);
+      } finally { ctxw.saving = false; }
+    }
+    Vue.watch(() => props.visible, v => { if (v) load(); });
+    return { ctxw, addCtxRow, saveCtxWindows };
+  }
+};

package/page/dialog-diag.js

@@ -0,0 +1,72 @@
+// 环境诊断弹层（R25 批 1 从 agent-acta-page.html 搬出的第一个组件）。
+// 契约见 page/shared.js 头部的「R25 组件文件契约」；本文件顶层只许有那一处 AACTA 赋值 ——
+// Vue 的 API 一律写全名（Vue.reactive / Vue.watch / Vue.inject），**不要解构**：
+// 顶层 const 与根内联 script 共享同一个全局词法作用域，重名就是整页 SyntaxError。
+//
+// 数据进出（搬的时候逐个对过）：
+//   · visible   ← 根（侧栏「环境诊断」项点开、弹层关掉时回写）—— 开关状态留根，与改前一样
+//   · pageBuild ← 根（底部那行「服务自报指纹 ≠ 页面注入指纹」的比对基准）
+//   · getJSON   ← 根 provide：接口 404 要点亮顶部版本红条，那段逻辑只有根里一份，别在这儿重写
+//   · 自己拉 /api/diagnose（改前就是独立 fetch，不依赖根的任何状态）
+window.AACTA = window.AACTA || {};
+AACTA.DialogDiag = {
+  name: 'aa-dialog-diag',
+  template: `
+  <el-dialog :model-value="visible" @update:model-value="v => $emit('update:visible', v)" title="环境诊断" width="720px" append-to-body>
+    <div class="diag-hint">
+      下面逐个列出候选 agent 的探测结果：<b>已接入</b>是正常在扫；<b>目录在但未识别</b>说明这个 agent
+      的日志目录就在本机、但格式还没写过解析器（顺着给出的路径补一个即可）；
+      <b>已由 xxx 接入</b>是同一份目录被另一个 agent 接走了（避免重复扫描，不是故障）。
+    </div>
+    <el-skeleton v-if="diag.loading" :rows="5" animated></el-skeleton>
+    <el-alert v-else-if="diag.error" :title="diag.error" type="error" :closable="false" show-icon></el-alert>
+    <div v-else>
+      <div v-for="a in diag.rows" :key="a.name" class="diag-row">
+        <span class="dn">{{ a.name }}</span>
+        <span class="ds" :class="a.state==='ok' ? 'ok' : (a.state==='absent' ? 'off' : 'warn')">{{ a.stateText }}</span>
+        <div class="db">
+          <div class="dnote">{{ a.note }}</div>
+          <div v-for="c in a.candidates" :key="c.path">
+            <div class="dpath">{{ c.exists ? '✓' : '·' }} {{ c.path }}<template v-if="c.reason"> —— {{ c.reason }}</template></div>
+            <div v-if="c.hint" class="dhint">　{{ c.hint }}</div>
+          </div>
+        </div>
+      </div>
+      <div class="diag-hint" style="margin-top:10px">
+        平台：{{ diag.platform || '？' }} ｜ 数据目录：{{ diag.dataDir }} ｜ 端口：{{ diag.port }} ｜ 服务版本：{{ diag.version || '？' }}（指纹 {{ diag.build ? diag.build.slice(0, 12) : '无' }}）
+        <!-- 指纹是「正在跑的服务」自报的代码指纹，与页面顶部注入的那份比对不上就是新旧错配。
+             「我装的是新版、怎么没有新功能」这类问题，第一步就看这一行。 -->
+        <span v-if="diag.build && diag.build !== pageBuild" style="color:var(--red)">　⚠ 与页面不一致，请重启服务</span>
+      </div>
+    </div>
+    <template #footer>
+      <el-button @click="$emit('update:visible', false)">关闭</el-button>
+      <el-button type="primary" :loading="diag.loading" @click="run">重新探测</el-button>
+    </template>
+  </el-dialog>`,
+  props: {
+    visible: Boolean,
+    pageBuild: { type: String, default: '' },
+  },
+  emits: ['update:visible'],
+  setup(props) {
+    const getJSON = Vue.inject('getJSON');
+    // 改前这个对象还带 visible 字段（弹层开关），现在开关归根 —— 放这儿会有两份真相
+    const diag = Vue.reactive({ loading: false, error: '', rows: [], platform: '', dataDir: '', port: '', version: '', build: '' });
+    async function run() {
+      diag.loading = true; diag.error = '';
+      try {
+        const j = await getJSON('/api/diagnose');
+        if (!j.ok) throw new Error(j.error || '诊断失败');
+        diag.rows = j.agents || [];
+        diag.platform = j.platform || '';   // 截图发回来时能自证是哪台机器（四平台验证靠它）
+        diag.dataDir = j.dataDir || ''; diag.port = j.port || '';
+        diag.version = j.version || ''; diag.build = j.build || '';
+      } catch (e) { diag.error = '诊断失败：' + e.message; }
+      finally { diag.loading = false; }
+    }
+    // 侧栏点开就探一次（改前是 openDiagnose 顺手把 visible 置 true；现在根只置 visible，探测挂在这儿）
+    Vue.watch(() => props.visible, v => { if (v) run(); });
+    return { diag, run };
+  }
+};

package/page/dialog-heatmap.js

@@ -0,0 +1,215 @@
+// R27 活跃热力图弹层：全年活跃热力（GitHub contributions 风格）+ 当月月历热力。
+// 契约见 page/shared.js 头部「R25 组件文件契约」；Vue / Element Plus 的 API 写全名。
+//
+// 数据进出：
+//   · visible ← 根（侧栏「活跃热力」项 / 弹层自己关闭时回写）
+//   · getJSON ← 根 provide
+//   · 天桶 ← /api/daily?range=all（不带任何筛选）——口径是需求书 R27 定死的：
+//     **任一 agent 当天有日志记录即算活跃**，颜色深浅按当天记录条数分五档。
+//     所以这张图**刻意不跟随**左侧栏的 agent/项目/时间范围筛选：它回答的是「这一年我出没出现过」，
+//     跟「用量统计」那种「筛出来的这一段烧了多少 token」是两个问题，别接 req。
+//   · 聚合全在前端做（天桶只有 day+count 两个字段要，服务端不新开端点）。
+//
+// 分档：取当年全部活跃日的条数，按**去重后的值**均匀映射到 1..5 档（不是按最大值线性切——
+// 一个爆量的日子会把其余全压成最浅档）。档位在全年与月历之间共用，两块的深浅才可比。
+// 周连登：从当周（周日为首，与月历同口径）往前回溯连续活跃周数，需求书 R27 定义。
+//
+// 悬浮提示（2026-09-22 按用户补发的 Qoder 新任务面板截图对齐「内容系统」）：
+// 第一行「M月D日周X」+ 右对齐「N 个任务」，第二行灰字「单日活跃任务」。
+// 原生 title 排不出这个两行版式，所以是一块全局单例的自绘提示（事件委托在两块网格上，
+// 不给 400 个格子各挂监听）。无记录/未到/非本月三种日子给各自的第二行文案，不冒充「0 个任务」。
+window.AACTA = window.AACTA || {};
+AACTA.DialogHeatmap = {
+  name: 'aa-dialog-heatmap',
+  template: `
+  <el-dialog :model-value="visible" @update:model-value="v => $emit('update:visible', v)" title="活跃热力图" width="min(1080px, 94vw)" append-to-body class="hm-dialog">
+    <el-skeleton v-if="hm.loading && !hm.days.length" :rows="8" animated></el-skeleton>
+    <el-alert v-else-if="hm.error" :title="hm.error" type="error" :closable="false" show-icon></el-alert>
+    <div v-else-if="!hm.days.length" class="empty">暂无日志数据</div>
+    <template v-else>
+      <div class="hm-sec">
+        <div class="hm-head">
+          <span class="hm-h1">全年活跃记录</span>
+          <span class="hm-stat"><b>{{ hmActive }}</b> 天活跃 · <b class="rate">{{ hmRate }}%</b> 活跃率 · <b>{{ hmStreak }}</b> 周连登</span>
+          <span class="hm-legend">未活跃<i v-for="lv in hmLvs" :key="lv" class="hm-chip" :class="'lv' + lv"></i>活跃</span>
+        </div>
+        <div class="hm-year" @mouseover="onHover" @mouseleave="hideTip">
+          <div v-for="mo in yearMonths" :key="mo.label" class="hm-month">
+            <div class="hm-m-label">{{ mo.label }}</div>
+            <div class="hm-grid">
+              <template v-for="c in mo.cells" :key="c.k">
+                <i v-if="c.pad" class="hm-cell hm-pad"></i>
+                <i v-else class="hm-cell" :class="['lv' + c.lv, {fut: c.future}]" :data-d="c.k" :data-n="c.n" :data-f="c.future ? '1' : ''"></i>
+              </template>
+            </div>
+          </div>
+        </div>
+        <div class="hm-foot">{{ hmFoot }}</div>
+      </div>
+      <div class="hm-sec">
+        <div class="hm-head">
+          <span class="hm-h1">{{ monthTitle }}</span>
+          <span class="hm-stat"><b>{{ monthActive }}</b> 天活跃 · 色阶与上方全年热力同一档位</span>
+        </div>
+        <div class="hm-cal" @mouseover="onHover" @mouseleave="hideTip">
+          <span v-for="w in weekLabels" :key="w" class="hm-wd">{{ w }}</span>
+          <div v-for="c in monthCal" :key="c.k" class="hm-day" :class="['lv' + c.lv, {out: c.out, today: c.today}]" :data-d="c.k" :data-n="c.n" :data-out="c.out ? '1' : ''">{{ c.today ? '今日' : c.d }}</div>
+        </div>
+      </div>
+      <!-- 全局单例悬浮提示：position:fixed 按格子 rect 落位（见文件头注释） -->
+      <div v-if="tip.show" class="hm-tip" :class="{below: tip.below}" :style="{left:tip.x+'px', top:tip.y+'px'}">
+        <div class="hm-tip-1"><b>{{ tip.date }}</b><span v-if="!tip.fut && !tip.out">{{ tip.n }} 个任务</span></div>
+        <div class="hm-tip-2">{{ tip.sub }}</div>
+      </div>
+    </template>
+    <template #footer>
+      <el-button @click="$emit('update:visible', false)">关闭</el-button>
+      <el-button type="primary" :loading="hm.loading" @click="load">刷新</el-button>
+    </template>
+  </el-dialog>`,
+  props: { visible: Boolean },
+  emits: ['update:visible'],
+  setup(props) {
+    const getJSON = Vue.inject('getJSON');
+    const hm = Vue.reactive({ loading: false, error: '', days: [] });
+    // 打开时重新取数、也重新认「今天」（挂着的服务跨了午夜再开弹层，今日格不能留在昨天）
+    const now = Vue.ref(new Date());
+
+    async function load() {
+      if (hm.loading) return;
+      hm.loading = true;
+      hm.error = '';
+      now.value = new Date();
+      try {
+        const j = await getJSON('/api/daily?range=all');
+        if (!j.ok) throw new Error(j.error || '聚合失败');
+        hm.days = j.days || [];
+      } catch (e) { hm.error = '活跃热力图加载失败：' + e.message; }
+      finally { hm.loading = false; }
+    }
+    Vue.watch(() => props.visible, v => { if (v) load(); });
+
+    const pad2 = n => (n < 10 ? '0' : '') + n;
+    const dk = d => d.getFullYear() + '-' + pad2(d.getMonth() + 1) + '-' + pad2(d.getDate());
+    const todayKey = Vue.computed(() => dk(now.value));
+    const year = Vue.computed(() => now.value.getFullYear());
+    // 只收有记录的天：热力图只问「有没有、多少条」，token/耗时一概不用
+    const cnt = Vue.computed(() => {
+      const m = new Map();
+      for (const d of hm.days) if (d.count) m.set(d.day, d.count);
+      return m;
+    });
+    // 五档：当年活跃日条数去重后均匀铺到 1..5（见文件头注释）。只有一个档位时给中间档，
+    // 不至于「全年就一天有记录」反而画成最深绿。
+    const levelMap = Vue.computed(() => {
+      const ys = String(year.value);
+      const uniq = [...new Set([...cnt.value].filter(([k]) => k.slice(0, 4) === ys).map(([, n]) => n))].sort((a, b) => a - b);
+      const m = new Map();
+      uniq.forEach((v, i) => m.set(v, uniq.length === 1 ? 3 : 1 + Math.round(i / (uniq.length - 1) * 4)));
+      return m;
+    });
+    const lvOf = (n) => !n ? 0 : (levelMap.value.get(n) || 1);
+
+    // ---- 悬浮提示（内容系统对齐 Qoder 新任务面板，见文件头）----
+    const WD = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
+    const tip = Vue.reactive({ show: false, below: false, x: 0, y: 0, date: '', n: 0, fut: false, out: false, sub: '' });
+    // 事件委托：监听挂在两块网格容器上，格子只带 data-*
+    function onHover(ev) {
+      const el = ev.target && ev.target.closest ? ev.target.closest('.hm-cell, .hm-day') : null;
+      const d = el && el.dataset.d;
+      if (!d) { tip.show = false; return; }
+      const n = +el.dataset.n || 0;
+      const dt = new Date(+d.slice(0, 4), +d.slice(5, 7) - 1, +d.slice(8, 10));
+      tip.date = (dt.getMonth() + 1) + '月' + dt.getDate() + '日' + WD[dt.getDay()];
+      tip.n = n;
+      tip.fut = el.dataset.f === '1';
+      tip.out = el.dataset.out === '1';
+      tip.sub = tip.fut ? '未到' : tip.out ? '非本月' : n ? '单日活跃任务' : '无活跃记录';
+      const r = el.getBoundingClientRect();
+      tip.below = r.top < 76;                       // 第一行格子的提示放不下头顶，翻到下方
+      tip.x = Math.round(r.left + r.width / 2);
+      tip.y = Math.round(tip.below ? r.bottom + 8 : r.top - 8);
+      tip.show = true;
+    }
+    function hideTip() { tip.show = false; }
+
+    const yearMonths = Vue.computed(() => {
+      const Y = year.value, tk = todayKey.value, out = [];
+      for (let m = 0; m < 12; m++) {
+        const off = new Date(Y, m, 1).getDay();          // 周日为首（与月历同一口径）
+        const dim = new Date(Y, m + 1, 0).getDate();
+        const cells = [];
+        for (let i = 0; i < off; i++) cells.push({ pad: true, k: Y + '-' + m + '-p' + i });
+        for (let d = 1; d <= dim; d++) {
+          const key = Y + '-' + pad2(m + 1) + '-' + pad2(d);
+          const n = cnt.value.get(key) || 0;
+          cells.push({ pad: false, k: key, n, lv: lvOf(n), future: key > tk });
+        }
+        out.push({ label: (m + 1) + '月', cells });
+      }
+      return out;
+    });
+    // 活跃率 = 活跃天数 / 当年已过天数（需求书 R27 口径；1 月 1 日当天算已过 1 天）
+    const hmActive = Vue.computed(() => {
+      const ys = String(year.value);
+      let n = 0;
+      for (const [k] of cnt.value) if (k.slice(0, 4) === ys) n++;
+      return n;
+    });
+    const hmRate = Vue.computed(() => {
+      const elapsed = Math.floor((now.value - new Date(year.value, 0, 1)) / 86400000) + 1;
+      return elapsed > 0 ? Math.round(hmActive.value / elapsed * 100) : 0;
+    });
+    const hmStreak = Vue.computed(() => {
+      const cur = new Date(now.value);
+      cur.setHours(0, 0, 0, 0);
+      cur.setDate(cur.getDate() - cur.getDay());         // 本周日
+      let s = 0;
+      for (let g = 0; g < 110; g++) {                     // 上限只是防病态回溯（数据最老也就 400 天）
+        let hit = false;
+        for (let i = 0; i < 7 && !hit; i++) {
+          const d = new Date(cur);
+          d.setDate(d.getDate() + i);
+          if (cnt.value.has(dk(d))) hit = true;
+        }
+        if (!hit) break;
+        s++;
+        cur.setDate(cur.getDate() - 7);
+      }
+      return s;
+    });
+
+    const monthTitle = Vue.computed(() => year.value + '年' + (now.value.getMonth() + 1) + '月');
+    const monthActive = Vue.computed(() => {
+      const p = year.value + '-' + pad2(now.value.getMonth() + 1);
+      let n = 0;
+      for (const [k] of cnt.value) if (k.slice(0, 7) === p) n++;
+      return n;
+    });
+    const monthCal = Vue.computed(() => {
+      const Y = year.value, M = now.value.getMonth(), tk = todayKey.value;
+      const off = new Date(Y, M, 1).getDay();
+      const dim = new Date(Y, M + 1, 0).getDate();
+      const cells = [];
+      for (let i = 0; i < Math.ceil((off + dim) / 7) * 7; i++) {
+        const dt = new Date(Y, M, 1 - off + i);
+        const key = dk(dt);
+        const inM = dt.getMonth() === M;
+        const n = inM ? (cnt.value.get(key) || 0) : 0;
+        cells.push({
+          k: key, d: dt.getDate(), n, out: !inM, today: key === tk, lv: lvOf(n),
+        });
+      }
+      return cells;
+    });
+
+    const hmLvs = [0, 1, 2, 3, 4, 5];
+    const weekLabels = ['日', '一', '二', '三', '四', '五', '六'];
+    // 参考截图底部那行写的是「数据更新于每日 02:00」——本服务没有每日定点任务，
+    // 数据随扫描实时进桶，照抄那句就是假话，改成如实的口径说明。
+    const hmFoot = '活跃口径：任一 agent 当天有日志记录即算活跃 · 色阶 = 当天条数按全年活跃日分五档 · 数据随日志扫描实时更新';
+
+    // 模板只认 props ∪ setup return（page-check.mjs 盯住），用到的名字必须全列出来
+    return { hm, load, yearMonths, monthCal, hmLvs, weekLabels, hmActive, hmRate, hmStreak, monthTitle, monthActive, hmFoot, tip, onHover, hideTip };
+  }
+};