agent-tune-kit 2.3.3__tar.gz → 2.3.4__tar.gz

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-tune-kit",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Local Codex plugin for batch Agent evaluation and session trace tuning with evidence-backed issues, focused changes, verification and offline review.",
   "author": {
     "name": "hustyichi",

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-tune-kit
-Version: 2.3.3
+Version: 2.3.4
 Summary: Local Codex plugin for iterative Agent tuning with guided Skills, reusable runner templates, versioned results, and static validation.
 Project-URL: Homepage, https://github.com/hustyichi/agent-tune-kit
 Project-URL: Repository, https://github.com/hustyichi/agent-tune-kit

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/__init__.py

@@ -1,3 +1,3 @@
 """Agent Tune Kit package."""
 
-__version__ = "2.3.3"
+__version__ = "2.3.4"

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/shared/base.css

@@ -93,3 +93,12 @@ select:hover { border-color: #9baebb }
   .drawer.above-record { inset: 0 0 auto; border-radius: 0 0 12px 12px; border-top: 0; border-bottom: 1px solid var(--line) }
   .drawer-resizer { display: none }
 }
+
+/* Project attribution belongs to issues; the menu is shared by both issue views. */
+.project-choice { position: relative; margin-bottom: 7px; font-size: 13px }
+.project-choice summary { height: 34px; padding: 6px 12px; border: 1px solid #cdd8e1; border-radius: 6px; background: white }
+.project-choice summary:hover { border-color: #9baebb }
+.project-menu { position: absolute; right: 0; z-index: 20; width: min(300px, 80vw); max-height: 320px; overflow: auto; padding: 12px; border: 1px solid var(--line); border-radius: 6px; background: white; box-shadow: 0 6px 20px #0002 }
+.project-menu p { margin: 0 0 8px }
+#project-filter label { display: flex; align-items: center; gap: 8px; padding: 6px 0 }
+#project-filter input { width: 16px; height: 16px; min-width: 16px; padding: 0 }

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/app.js

@@ -29,10 +29,25 @@
     return roots.some(root => { let current = root.id; const seen = new Set(); while (current && !seen.has(current)) { if (current === id) return true; seen.add(current); current = data.projects?.[current]?.parent_id; } return false; });
   });
   const projectText = item => (item.root_projects || []).map(p => p.name + (p.pending ? "（待确认）" : "")).join("、") || "待归因";
-  for (const p of Object.values(data.projects || {})) { const option = el("option", p.abbreviation || p.name); option.value = p.id; $("project-filter").append(option); }
-  for (const option of $("project-filter").options) option.selected = projectSelection.has(option.value);
-  const projectOverview = el("p", `根因项目：${[...new Set(data.issues.map(projectText))].join("、") || "待归因"}`);
-  $("project-filter").parentElement.append(projectOverview);
+  const projectInputs = [];
+  for (const p of [{id: "~unattributed", name: "待归因"}, ...Object.values(data.projects || {})]) {
+    const label = el("label"), input = el("input");
+    input.type = "checkbox"; input.value = p.id;
+    input.checked = projectSelection.has(p.id);
+    label.append(input, document.createTextNode(p.abbreviation || p.name));
+    $("project-filter").append(label); projectInputs.push(input);
+    input.onchange = () => $("project-filter").onchange();
+  }
+  const updateProjectSummary = () => {
+    $("project-summary").textContent = projectSelection.size ? `关联项目：已选 ${projectSelection.size} 项` : "关联项目：全部";
+  };
+  updateProjectSummary();
+  $("project-clear").onclick = () => { projectInputs.forEach(input => { input.checked = false; }); $("project-filter").onchange(); };
+  $("project-choice").onkeydown = event => { if (event.key === "Escape") { $("project-choice").open = false; $("project-summary").focus(); } };
+  document.addEventListener("click", event => {
+    if (!event.target.closest("#project-choice")) $("project-choice").open = false;
+  });
+
   const filters = ["trace-filter", "type-filter", "trace-search", "record-mode"];
   const list = $("trace-list"), scroller = $("trace-scroll");
   const scope = () => $("trace-filter").value === "" ? null : Number($("trace-filter").value);
@@ -291,7 +306,7 @@
       if (snapshot?.project_links) {
         const entries = new Map((snapshot.project_registry?.projects || []).map(p => [p.id, p]));
         const names = snapshot.project_links.filter(p => p.role === "root_cause").map(p => { const entry = entries.get(p.project_id); return (entry?.abbreviation || entry?.name || p.project_id) + (p.evidence_state === "supported" ? "" : "（待确认）"); });
-        body.prepend(el("p", `诊断时的根因项目：${names.join("、") || "待归因"}`));
+        body.prepend(el("p", `诊断时的关联项目：${names.join("、") || "待归因"}`));
       }
       const name = diagnosis.reference.path.split("/").pop();
       details.append(el("summary", `展开原诊断 · ${name}`), body);
@@ -391,7 +406,7 @@
     $("drawer-content").append(tabs);
     if (stage === "issue") {
       const description = section("问题描述");
-      description.append(el("p", `根因项目：${projectText(item)}`), el("p", issue.description || issue.title));
+      description.append(el("p", `关联项目：${projectText(item)}`), el("p", issue.description || issue.title));
       $("drawer-content").append(description);
       if (typeof issue.selection_reason === "string" && issue.selection_reason.trim()) {
         const reason = section("保留理由");
@@ -1013,9 +1028,9 @@
       const head = el("div", undefined, "issue-card-head");
       head.append(el("span", issue.id, "issue-id-text"), el("span", undefined, `progress-dot ${progress.klass}`));
       const body = el("div", undefined, "issue-card-body");
-      const projects = el("p", `根因项目：${projectText(item)}`);
+      const projects = el("p", `关联项目：${projectText(item)}`);
       if (data.dashboard.available) for (const project of item.root_projects || []) {
-        const link = el("a", project.name); link.href = dashboardHash(`view=session&project=${encodeURIComponent(project.id)}`); projects.append(link);
+        const link = el("a", project.name); link.href = dashboardHash(`view=category&project=${encodeURIComponent(project.id)}`); projects.append(link);
       }
       body.append(projects);
       body.append(el("h3", issue.title || "问题"), el("div", progress.label, "issue-progress"));
@@ -1107,7 +1122,7 @@
   $("capture-filter").closest("label").hidden = Boolean(currentCapture?.current);
   options($("capture-filter"), data.captures.map(c => c.id));
   if (currentCapture) $("capture-filter").value = currentCapture.id;
-  $("project-filter").onchange = () => { projectSelection.clear(); for (const option of $("project-filter").selectedOptions) projectSelection.add(option.value); const params = new URLSearchParams(location.hash.slice(1)); params.delete("project"); for (const id of projectSelection) params.append("project", id); history.replaceState(null, "", `#${params}`); renderIssueRail(); };
+  $("project-filter").onchange = () => { projectSelection.clear(); for (const input of projectInputs) if (input.checked) projectSelection.add(input.value); updateProjectSummary(); const params = new URLSearchParams(location.hash.slice(1)); params.delete("project"); for (const id of projectSelection) params.append("project", id); history.replaceState(null, "", `#${params}`); renderIssueRail(); };
   $("capture-filter").onchange = () => { investigation = null; scopeBefore = null; railFilter = null; chooseCapture(); renderIssueRail(); renderTraces(); };
   $("trace-filter").onchange = () => focusTrace(scope());
   for (const id of ["trace-search","type-filter","record-mode"]) $(id).addEventListener(id === "trace-search" ? "input" : "change", () => renderTraces());

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/page.html

@@ -21,7 +21,7 @@
       </div>
       <div class="rail-filters">
         <label class="search-label"><span class="sr-only">搜索问题</span><input id="issue-search" type="search" placeholder="搜索问题"></label>
-        <label>根因项目（含子项目）<select id="project-filter" multiple aria-label="根因项目"><option value="~unattributed">待归因</option></select></label>
+        <details id="project-choice" class="project-choice"><summary id="project-summary">关联项目：全部</summary><div class="project-menu"><p>含子项目</p><button id="project-clear" type="button">清空筛选</button><div id="project-filter" role="group" aria-label="关联项目"></div></div></details>
       <label><span class="sr-only">状态</span><select id="issue-status"></select></label>
       </div>
       <div id="issue-rail-list" class="rail-list"></div>

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/trace/styles.css

@@ -30,6 +30,9 @@ body.rail-collapsed #rail-toggle { transform: rotate(180deg) }
 .rail-filters .search-label { flex: 1; min-width: 0 }
 .rail-filters input, .rail-filters select { width: 100%; height: 32px; font-size: 12px; padding: 0 8px }
 .rail-filters select { width: auto; min-width: 88px }
+.rail-filters .project-choice { margin-bottom: 0; font-size: 12px }
+.rail-filters .project-choice summary { height: 32px; padding: 6px 8px; white-space: nowrap }
+.rail-filters .project-menu { left: 0; right: auto }
 .rail-list { flex: 1; min-height: 0; overflow: auto; padding: 8px; display: flex; flex-direction: column; gap: 8px }
 .issue-card { display: flex; flex-direction: column; gap: 6px; width: 100%; text-align: left; padding: 10px }
 .issue-card-head { justify-content: space-between; gap: 6px; width: 100% }

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/traces/app.js

@@ -11,14 +11,28 @@
   const button = (text, action, className) => { const node = el("button", text, className); node.type = "button"; node.onclick = action; return node; };
 
   const projectSelection = new Set(new URLSearchParams(location.hash.slice(1)).getAll("project"));
-  const projectMatches = item => !projectSelection.size || [...projectSelection].some(id => {
+  const projectMatches = item => state.view === "session" || !projectSelection.size || [...projectSelection].some(id => {
     const roots = item.root_projects || [];
     if (id === "~unattributed") return !roots.length;
     return roots.some(root => { let current = root.id; const seen = new Set(); while (current && !seen.has(current)) { if (current === id) return true; seen.add(current); current = data.projects?.[current]?.parent_id; } return false; });
   });
   const projectText = item => (item.root_projects || []).map(p => p.name + (p.pending ? "（待确认）" : "")).join("、") || "待归因";
-  for (const p of Object.values(data.projects || {})) { const option = el("option", p.abbreviation || p.name); option.value = p.id; $("project-filter").append(option); }
-  for (const option of $("project-filter").options) option.selected = projectSelection.has(option.value);
+  const projectInputs = [];
+  for (const p of [{id: "~unattributed", name: "待归因"}, ...Object.values(data.projects || {})]) {
+    const label = el("label"), input = el("input");
+    input.type = "checkbox"; input.value = p.id;
+    input.checked = projectSelection.has(p.id);
+    label.append(input, document.createTextNode(p.abbreviation || p.name));
+    $("project-filter").append(label); projectInputs.push(input);
+    input.onchange = () => $("project-filter").onchange();
+  }
+  const updateProjectSummary = () => {
+    $("project-summary").textContent = projectSelection.size ? `关联项目：已选 ${projectSelection.size} 项` : "关联项目：全部";
+  };
+  updateProjectSummary();
+  $("project-clear").onclick = () => { projectInputs.forEach(input => { input.checked = false; }); $("project-filter").onchange(); };
+  $("project-choice").onkeydown = event => { if (event.key === "Escape") { $("project-choice").open = false; $("project-summary").focus(); } };
+
 
   const NONE = "~uncategorized"; // cannot collide with a kebab-case category ID
   const ORDER = new Map(data.progress_legend.map((entry, index) => [entry.key, index]));
@@ -37,7 +51,6 @@
     return `${part.month}-${part.day} ${part.hour === "24" ? "00" : part.hour}:${part.minute}`;
   };
   const sourceText = source => [source.type, source.environment].filter(Boolean).join(" · ") || "来源未记录";
-  const scaleText = s => s.traces != null && s.observations != null ? `${s.traces} Trace · ${s.observations} 观测` : `${s.files} 个归档文件`;
   const statusText = value => STATUS[value] || value || "未记录";
 
   // --- derived search text and source scope ---------------------------------------------------------------------
@@ -53,7 +66,7 @@
   const matchIssue = (s, issue) =>
     projectMatches(issue) && (!state.progress || issue.progress === state.progress) && (!state.q || s._text.includes(state.q) || issue._text.includes(state.q));
   const matchSession = s => s.issues.some(issue => matchIssue(s, issue)) ||
-    (!s.issues.length && !projectSelection.size && !state.progress && (!state.q || s._text.includes(state.q)));
+    (!s.issues.length && (state.view === "session" || !projectSelection.size) && !state.progress && (!state.q || s._text.includes(state.q)));
   const byProgress = (a, b) => ORDER.get(a.progress) - ORDER.get(b.progress) || a.id.localeCompare(b.id, undefined, {numeric: true});
 
   // --- small building blocks ------------------------------------------------------------------------------------
@@ -181,7 +194,6 @@
     }
     card.append(el("div", `${sourceText(s.source)} · 更新 ${when(s.updated_ms)}`, "card-meta"));
     const matched = s.issues.filter(issue => matchIssue(s, issue));
-    card.append(el("p", `根因项目：${[...new Set(matched.map(projectText))].join("、") || "待归因"}`));
     if (matched.length) {
       const counts = countBy(matched);
       const row = el("div", undefined, "card-count");
@@ -233,7 +245,7 @@
     const counts = countBy(items.map(item => item.issue));
     const row = el("div", undefined, "card-count");
     row.append(el("strong", `${new Set(items.map(item => item.s.dir)).size} 个会话 · ${items.length} 个问题`), el("span", `最近 ${when(latestOf(items) < 0 ? null : latestOf(items))}`, "muted"));
-    card.append(el("p", `根因项目：${[...new Set(items.map(({issue}) => projectText(issue)))].join("、")}`));
+    card.append(el("p", `关联项目：${[...new Set(items.map(({issue}) => projectText(issue)))].join("、")}`));
     card.append(row, miniBar(counts), el("div", topProgress(counts), "card-meta"));
     return card;
   }
@@ -261,12 +273,12 @@
   function issueRow(s, issue, withCategory) {
     const row = el("div", undefined, "issue-row");
     const dot = el("span", undefined, `progress-dot ${issue.progress}`); dot.title = LABEL.get(issue.progress);
-    const href = `${s.href}#issue=${encodeURIComponent(issue.id)}${[...projectSelection].map(id => `&project=${encodeURIComponent(id)}`).join("")}`;
+    const href = `${s.href}#issue=${encodeURIComponent(issue.id)}${(state.view === "category" ? [...projectSelection] : []).map(id => `&project=${encodeURIComponent(id)}`).join("")}`;
     const title = el("a", issue.title || issue.id, "row-title"); title.href = href; title.title = `${issue.id} ${issue.title}`;
     const jump = el("a", "↗", "row-jump"); jump.href = href; jump.setAttribute("aria-label", `在会话页打开 ${issue.id}`);
     // Title gets the full first line and may wrap; category and progress sit on their own line beneath it.
     const meta = el("div", undefined, "row-meta");
-    meta.append(el("span", `根因项目：${projectText(issue)}`, "project-tag"));
+    meta.append(el("span", `关联项目：${projectText(issue)}`, "project-tag"));
     if (withCategory) meta.append(categoryChip(issue.category));
     meta.append(el("span", LABEL.get(issue.progress), "row-progress"));
     row.append(dot, el("span", shortIssue(issue.id), "issue-id-text"), title, jump, meta);
@@ -275,7 +287,7 @@
   function issueList(box, s, issues, withCategory) {
     const rows = issues.filter(issue => matchIssue(s, issue)).sort(byProgress);
     const list = el("div", undefined, "issue-list");
-    if (!rows.length) list.append(el("div", issues.length ? "没有符合筛选条件的问题。" : "无保留问题。", "empty"));
+    if (!rows.length) list.append(el("div", issues.length ? "没有符合筛选条件的问题。" : "无保留问题（不代表会话正确）。", "empty"));
     for (const issue of rows) list.append(issueRow(s, issue, withCategory));
     box.append(list);
     return {shown: rows.length, total: issues.length};
@@ -283,40 +295,35 @@
   const textDetails = (title, build) => { const node = el("details", undefined, "detail-section"); node.append(el("summary", title)); build(node); return node; };
   const bullets = (node, items) => { const list = el("ul"); for (const item of items) list.append(el("li", item)); node.append(list); };
 
-  function sessionDrawer(s, box) {
-    $("drawer-title").textContent = s.session_id;
-    const actions = el("div", undefined, "drawer-actions");
-    actions.append(copyButton(s.session_id, "复制 Session ID", "复制 Session ID"));
-    if (!s.error) { const open = el("a", "打开会话页 ↗", "link-button"); open.href = s.href; actions.append(open); }
-    box.append(actions);
-    if (s.error) { box.append(el("p", `会话记录不可读取：${s.error}`, "warning")); return; }
-    const meta = el("div", undefined, "drawer-meta");
-    for (const text of [sourceText(s.source), scaleText(s), `归档 ${when(s.archived_ms)}`, `更新 ${when(s.updated_ms)}`]) meta.append(el("span", text));
-    box.append(meta);
-    const origin = [s.source.instance, s.source.project].filter(Boolean).join(" / ");
-    if (origin) box.append(el("p", origin, "mono muted"));
-    if (!s.preview.exists || s.preview.stale) {
-      const note = el("p", s.preview.exists ? "会话页早于最近一次记录写入。刷新命令：" : "会话页尚未生成。生成命令：", "warning");
-      note.append(el("code", `atk visualize trace --session-id ${s.session_id} --overwrite --no-open`));
-      box.append(note);
+  // The session drawer is a preview: the header carries identity and the way in; below it at most a few one-line
+  // notes appear, and only when something makes the issue list untrustworthy or needs an action. Source, scale and
+  // full detection coverage live on the session page (「会话信息」).
+  function sessionNotes(s, box) {
+    if (!s.detection) box.append(el("p", "尚未检测，问题列表为空不代表会话没有问题。", "warning"));
+    else if (s.detection.status !== "completed") {
+      box.append(el("p", `最近一次检测${statusText(s.detection.status)}，问题可能不全；检测缺口见会话页「会话信息」。`, "warning"));
     }
     if (s.problem_count) {
-      box.append(textDetails(`记录读取失败 ${s.problem_count}`, node => {
-        bullets(node, s.problems);
-        if (s.problem_count > s.problems.length) node.append(el("p", `另有 ${s.problem_count - s.problems.length} 条未显示。`, "muted"));
-      }));
+      const node = textDetails(`${s.problem_count} 条记录读取失败`, inner => {
+        bullets(inner, s.problems);
+        if (s.problem_count > s.problems.length) inner.append(el("p", `另有 ${s.problem_count - s.problems.length} 条未显示。`, "muted"));
+      });
+      node.classList.add("warning"); box.append(node);
+    }
+    if (!s.preview.exists || s.preview.stale) {
+      const command = `atk visualize trace --session-id ${s.session_id} --overwrite --no-open`;
+      const note = el("p", s.preview.exists ? "会话页已过期，不含最近的记录。" : "会话页尚未生成。", "warning note-row");
+      const copy = copyButton(command, s.preview.exists ? "复制刷新命令" : "复制生成命令", s.preview.exists ? "复制刷新命令" : "复制生成命令");
+      copy.title = command; note.append(copy); box.append(note);
     }
-    box.append(textDetails("检测范围与缺口", node => {
-      if (s.detection) {
-        node.append(el("p", `检测状态：${statusText(s.detection.status)}`));
-        if (s.detection.focus) node.append(el("p", `关注点：${s.detection.focus}`));
-        if (s.detection.gaps.length) { node.append(el("p", "检测缺口：")); bullets(node, s.detection.gaps); }
-      } else node.append(el("p", "尚未记录检测。", "muted"));
-      const coverage = {complete: "完整", partial: "部分", unknown: "未确定"}[s.capture.completeness] || s.capture.completeness || "未记录";
-      node.append(el("p", `采集状态：${statusText(s.capture.status)} · 完整性：${coverage}`));
-      if (s.capture.gaps.length) { node.append(el("p", "采集缺口：")); bullets(node, s.capture.gaps); }
-      if (!s.issues.length) node.append(el("p", "没有保留问题不代表会话正确，请结合检测范围与缺口判断。", "muted"));
-    }));
+  }
+  function sessionDrawer(s, box) {
+    $("drawer-title").textContent = s.session_id;
+    $("drawer-title-tools").append(copyButton(s.session_id, "复制 Session ID"));
+    if (s.error) { box.append(el("p", `会话记录不可读取：${s.error}`, "warning")); return; }
+    const open = el("a", "打开会话页 ↗", "link-button primary"); open.href = s.href;
+    $("drawer-tools").append(open);
+    sessionNotes(s, box);
     const heading = el("div", undefined, "list-heading");
     const label = el("span", "问题"); heading.append(label); box.append(heading);
     const counts = issueList(box, s, s.issues, true);
@@ -356,7 +363,7 @@
     if (state.view === "session" && !session) { state.drawer = null; drawer.hidden = true; shown = null; return; }
     const id = `${state.view}:${state.drawer}`, fresh = shown !== id;
     const box = $("drawer-content"), keep = fresh ? 0 : box.scrollTop;
-    box.replaceChildren();
+    box.replaceChildren(); $("drawer-title-tools").replaceChildren(); $("drawer-tools").replaceChildren();
     if (session) sessionDrawer(session, box); else categoryDrawer(state.drawer, box);
     drawer.hidden = false; box.scrollTop = keep; shown = id;
     if (fresh) $("drawer-close").focus({preventScroll: true});
@@ -371,7 +378,7 @@
 
   // --- navigation -----------------------------------------------------------------------------------------------
   function syncHash() {
-    const parts = [`view=${state.view}`, ...[...projectSelection].map(id => `project=${encodeURIComponent(id)}`)];
+    const parts = [`view=${state.view}`, ...(state.view === "category" ? [...projectSelection].map(id => `project=${encodeURIComponent(id)}`) : [])];
     if (state.drawer !== null) parts.push(`${state.view}=${encodeURIComponent(state.drawer)}`);
     const next = `#${parts.join("&")}`;
     if (location.hash !== next) history.replaceState(null, "", next);
@@ -383,8 +390,8 @@
   function applyHash() {
     const params = new URLSearchParams(location.hash.slice(1));
     projectSelection.clear(); params.getAll("project").forEach(id => projectSelection.add(id));
-    for (const option of $("project-filter").options) option.selected = projectSelection.has(option.value);
-    const view = params.get("view") === "category" ? "category" : "session";
+    for (const input of projectInputs) input.checked = projectSelection.has(input.value); updateProjectSummary();
+    const view = params.get("view") === "category" || (projectSelection.size && !params.get("session")) ? "category" : "session";
     let drawer = null;
     if (view === "session") {
       const key = params.get("session");
@@ -398,6 +405,7 @@
   }
 
   function render() {
+    $("project-choice").hidden = state.view === "session";
     renderTabs(); renderProgress(); renderNote();
     const grid = $("dash-grid"), strip = $("dash-strip");
     grid.replaceChildren(); strip.replaceChildren();
@@ -430,7 +438,7 @@
     $(id).onclick = () => setView(view);
     $(id).onkeydown = onTabKey;
   }
-  $("project-filter").onchange = () => { projectSelection.clear(); for (const option of $("project-filter").selectedOptions) projectSelection.add(option.value); syncHash(); render(); };
+  $("project-filter").onchange = () => { projectSelection.clear(); for (const input of projectInputs) if (input.checked) projectSelection.add(input.value); updateProjectSummary(); syncHash(); render(); };
   $("dash-search").oninput = event => { state.q = event.target.value.trim().toLowerCase(); render(); };
   $("drawer-close").onclick = closeDrawer;
   document.addEventListener("keydown", event => {
@@ -445,6 +453,7 @@
   let pressedOutside = false;
   document.addEventListener("pointerdown", event => { pressedOutside = state.drawer !== null && dismissable(event.target); });
   document.addEventListener("click", event => {
+    if (!event.target.closest("#project-choice")) $("project-choice").open = false;
     const close = pressedOutside && state.drawer !== null && dismissable(event.target);
     pressedOutside = false;
     if (close) closeDrawer();

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/traces/page.html

@@ -20,7 +20,7 @@
         <button id="tab-category" type="button" role="tab" aria-controls="dash-panel">异常</button>
       </div>
       <label class="search-label"><span class="sr-only">搜索</span><input id="dash-search" type="search" placeholder="搜索 Session ID、问题编号、标题、分类"></label>
-      <label>根因项目（含子项目）<select id="project-filter" multiple aria-label="根因项目"><option value="~unattributed">待归因</option></select></label>
+      <details id="project-choice" class="project-choice"><summary id="project-summary">关联项目：全部</summary><div class="project-menu"><p>含子项目</p><button id="project-clear" type="button">清空筛选</button><div id="project-filter" role="group" aria-label="关联项目"></div></div></details>
       <label id="source-choice" hidden><span class="sr-only">来源</span><select id="source-filter"></select></label>
     </div>
     <div id="dash-panel" class="dash-panel" role="tabpanel" aria-labelledby="tab-session">
@@ -35,7 +35,10 @@
   </main>
   <aside id="drawer" class="drawer" role="dialog" aria-modal="false" aria-labelledby="drawer-title" hidden tabindex="-1">
     <div class="drawer-resizer" id="drawer-resizer" aria-hidden="true"></div>
-    <div class="drawer-header"><h2 id="drawer-title"></h2><button id="drawer-close" type="button" aria-label="关闭详情">关闭 ×</button></div>
+    <div class="drawer-header">
+      <div class="drawer-heading"><h2 id="drawer-title"></h2><span id="drawer-title-tools"></span></div>
+      <div class="drawer-tools"><span id="drawer-tools"></span><button id="drawer-close" type="button" aria-label="关闭详情">关闭 ×</button></div>
+    </div>
     <div id="drawer-content" class="drawer-content"></div>
   </aside>
   <script id="dashboard-data" type="application/json">__DATA__</script>

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/assets/traces/styles.css

@@ -12,6 +12,8 @@
 .dash-controls { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 10px; border-bottom: 1px solid var(--line) }
 .dash-controls .search-label { flex: 1 1 260px; max-width: 440px; min-width: 0; margin-left: auto }
 .dash-controls .search-label, #source-choice { margin-bottom: 7px }
+/* Keep the toolbar geometry when the issue-only project filter is hidden. */
+.dash-controls #project-choice[hidden] { display: block !important; visibility: hidden }
 .view-tabs { display: flex; gap: 4px }
 .view-tabs [role=tab] { height: 40px; margin-bottom: -1px; padding: 0 16px; border: 0; border-bottom: 2px solid transparent; border-radius: 6px 6px 0 0; background: transparent; color: var(--muted); font-weight: 600 }
 .view-tabs [role=tab]:hover { color: var(--ink); background: #edf1f4 }
@@ -40,7 +42,7 @@
 .filter-note { display: flex; align-items: center; gap: 8px; font-size: 12px; color: var(--muted) }
 .filter-note button { font-size: 12px; padding: 2px 8px }
 
-.dash-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 12px; align-items: start }
+.dash-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 12px; align-items: stretch }
 .dash-card { position: relative; display: flex; flex-direction: column; gap: 8px; min-width: 0; padding: 12px 14px }
 .card-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; min-width: 0 }
 .card-head .card-open { flex: 1 1 0 }
@@ -70,7 +72,19 @@ button.category-tag:hover { background: #ffe8d2 }
 .empty-dash { padding: 28px; text-align: center; color: var(--muted); border: 1px dashed var(--line); border-radius: 8px; background: white }
 
 .drawer-meta { font-size: 12px; color: var(--muted); display: flex; flex-wrap: wrap; gap: 2px 12px; margin-bottom: 10px }
-.drawer-actions { display: flex; flex-wrap: wrap; gap: 8px; margin-bottom: 10px }
+/* Header: Session ID with its copy icon on the left; the way into the session page and close on the right. */
+.drawer-heading { display: flex; align-items: center; gap: 4px; min-width: 0 }
+.drawer-heading h2 { min-width: 0 }
+.drawer-tools { display: flex; align-items: center; gap: 8px; flex-shrink: 0 }
+.drawer-tools:has(> span:empty) { gap: 0 }
+.link-button.primary { font-weight: 600; background: var(--tint); border-color: #eabda0; white-space: nowrap }
+.link-button.primary:hover { background: #ffe9d6 }
+/* Notes only appear when something is off; each stays one compact line. */
+.drawer-content > .warning { font-size: 12px; margin: 0 0 8px; padding: 6px 10px }
+.drawer-content > details.warning { background: #fff9e8; border-color: #eed79d }
+.drawer-content > details.warning summary { font-size: 12px; color: #804810 }
+.note-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 6px 10px }
+.note-row button { font-size: 12px; padding: 1px 8px }
 .link-button { display: inline-block; border: 1px solid var(--line); border-radius: 6px; background: white; padding: 4px 10px; font-size: 12px; color: var(--accent); text-decoration: none }
 .link-button:hover { background: var(--tint); border-color: #eabda0 }
 .drawer-content details.detail-section { padding: 8px 12px }
@@ -100,10 +114,15 @@ button.category-tag:hover { background: #ffe8d2 }
 @media (max-width: 800px) {
   /* The drawer is a bottom sheet here, so it rises instead (reduced motion still zeroes the duration). */
   .drawer:not([hidden]) { animation-name: sheet-in }
+  /* A full Session ID needs the whole sheet width: the buttons drop onto their own row instead of squeezing it. */
+  .drawer-header { flex-wrap: wrap; row-gap: 8px }
+  .drawer-heading { flex: 1 1 100% }
+  .drawer-heading h2 { font-size: 14px }
+  .drawer-tools { margin-left: auto }
   .dash-grid { grid-template-columns: 1fr }
   /* Search wraps under the tabs here, so the tab line moves onto the tab row itself. */
   .dash-controls { border-bottom: 0 }
   .view-tabs { flex-basis: 100%; border-bottom: 1px solid var(--line) }
   .dash-controls .search-label { max-width: none; margin-left: 0 }
-  .dash-controls .search-label, #source-choice { margin-bottom: 0 }
+  .dash-controls .search-label, .dash-controls .project-choice, #source-choice { margin-bottom: 0 }
 }

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/agent_tune_kit/visualize/traces.py

@@ -1,6 +1,6 @@
 """Project-wide dashboard over every archived session, written to ``.atk/traces/index.html``.
 
-The page only summarizes: identity, scale, actual progress and category per issue, plus a link into each session's own
+The page only summarizes: identity, actual progress and category per issue, whether the latest detection finished, plus a link into each session's own
 preview. It reads saved records through ``records.status`` (which already verifies evidence digests) and never opens
 raw trace bodies, so it stays small and fast. A damaged session or issue is reported on its own entry and cannot hide
 the healthy ones.
@@ -45,12 +45,6 @@ def _text(value, limit=TEXT_LIMIT):
     return value if len(value) <= limit else value[: limit - 1] + "…"
 
 
-def _texts(value):
-    if not isinstance(value, list):
-        return []
-    return [text for text in (_text(item, ITEM_LIMIT) for item in value[:LIST_LIMIT]) if text]
-
-
 def _ms(seconds):
     return None if seconds is None else int(seconds * 1000)
 
@@ -143,8 +137,6 @@ def _session_entry(session_dir):
         )
         return entry
     session = status["session"]
-    archive = session.get("archive") if isinstance(session.get("archive"), dict) else {}
-    completeness = archive.get("completeness") if isinstance(archive.get("completeness"), dict) else {}
     detections = [item for item in session.get("detections", []) if isinstance(item, dict)]
     issues, issue_stamps = _issue_entries(session_dir, status)
     archived = parse_instant(session.get("created_at"))
@@ -153,31 +145,14 @@ def _session_entry(session_dir):
     registry = session_dir.parent / "projects.json"
     if registry.is_file():
         updated = max(updated or 0, registry.stat().st_mtime)
+    # The drawer is a preview: it only needs to say whether the issue list can be trusted. Scale, capture coverage,
+    # focus and gap details stay on the session page, which shows every detection in full.
     last = detections[-1] if detections else None
-    scope = last.get("scope") if last and isinstance(last.get("scope"), dict) else {}
-    traces, observations = completeness.get("trace_count"), completeness.get("observation_count")
     entry.update(
         session_id=session["session_id"],
         source={key: _text(session.get("source", {}).get(key), ITEM_LIMIT) for key in SAFE_SOURCE_FIELDS},
-        archived_ms=_ms(archived),
         updated_ms=_ms(updated),
-        traces=traces if type(traces) is int else None,
-        observations=observations if type(observations) is int else None,
-        files=len(archive["files"]) if isinstance(archive.get("files"), list) else len(session.get("captures", [])),
-        capture={
-            "status": _text(archive.get("status"), 40),
-            "completeness": _text(completeness.get("status"), 40),
-            "gaps": _texts(completeness.get("gaps")),
-        },
-        detection=(
-            {
-                "status": _text(last.get("status"), 40),
-                "focus": _text(scope.get("focus")),
-                "gaps": _texts(last.get("gaps")),
-            }
-            if last
-            else None
-        ),
+        detection={"status": _text(last.get("status"), 40)} if last else None,
         issues=issues,
         problems=[_problem(item) for item in status["warnings"][:LIST_LIMIT]],
         problem_count=len(status["warnings"]),

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/docs/trace-dashboard-design.md

@@ -51,7 +51,7 @@
 | `3a735b2`：`records.py` 新增 `change_summary`、`verification_summary` 校验 | 大盘只在 `prepare_issue()` 增加 `category` 校验，不在同一函数 | 无冲突 |
 | `3a735b2`：`styles.css` 新增 `.stage-record`、`.change-item`、`.source-file` | 属于单会话页专用样式 | 抽取共享样式时留在 `trace/styles.css`，不进入 `base.css` |
 | `records.status()` 读取全部 Issue、改动和验证，并校验引用哈希；在 Magic 6 个会话上逐个调用，合计约 0.3 秒 | 大盘可以直接复用，不必另写读取逻辑 | 大盘数据构建基于 `status()` |
-| Magic 本地导入的 `archive.completeness` 有 `trace_count`、`observation_count`；其他来源不一定有 | 抽屉中的 Trace/观测数可能缺失 | 有就显示，没有时只显示归档文件数 |
+| Magic 本地导入的 `archive.completeness` 有 `trace_count`、`observation_count`；其他来源不一定有。本地导入的完整性固定为“部分” | 规模和完整性在会话之间没有区分度，对预览没有帮助 | 大盘不展示，也不输出这些字段（2026-11-10 起）；完整内容在会话页「会话信息」中 |
 | 全量测试 `uv run --frozen pytest`：407 通过。不加 `--frozen` 时，本机 uv 会把 `uv.lock` 的 registry 改写为带末尾斜杠，导致 `test_release_scripts.py` 的地址比对失败 | 开发中跑测试可能顺带改动 `uv.lock` | 开发与验收一律使用 `uv run --frozen`，不提交 `uv.lock` |
 
 ## 4. 数据契约
@@ -201,16 +201,26 @@
 点击卡片打开**会话抽屉**：
 
 ```text
-┃ SES_2118585447553830912  ⧉                     [打开会话页 ↗] ┃
-┃ local · onl · 3 Trace · 1513 观测 · 归档 11-09 17:26          ┃
-┃ ▸ 检测范围与缺口（折叠：focus、gaps、采集完整性）              ┃
-┃ ─ 问题 11 ──────────────────────────────────────────────────── ┃
+┃ SES_2118585447553830912  ⧉           [打开会话页 ↗]  [关闭 ×] ┃
+┃ ⚠ 最近一次检测部分完成，问题可能不全；检测缺口见会话页「会话信息」 ┃
+┃ ─ 问题 9 ───────────────────────────────────────────────────── ┃
 ┃ ● 002  交付回复把列表项内边距误报为统一 16     未分类  待诊断 ↗ ┃
 ┃ ● 001  订单详情空态提示点击选单，但页面没有…   未分类  已诊断 ↗ ┃
 ```
 
-- 头部：完整 Session ID、来源、Trace/观测数（缺失时显示归档文件数）、归档时间，以及“打开会话页”。
-- 检测范围与缺口默认折叠。
+抽屉是进入会话页之前的预览，只回答两件事：这份问题列表能不能信，以及下一步要做什么（2026-11-10 起）。
+
+- 头部只有完整 Session ID、复制图标、主按钮“打开会话页”和关闭。会话记录不可读取时没有“打开会话页”。
+- 标题下方的提醒只在需要时出现，每条一行；全部正常时不显示，标题下方直接是问题列表：
+
+  | 条件 | 提醒 |
+  |---|---|
+  | 最近一次检测不是“已完成” | 最近一次检测{状态}，问题可能不全；检测缺口见会话页「会话信息」 |
+  | 没有检测记录 | 尚未检测，问题列表为空不代表会话没有问题 |
+  | 有记录读取失败 | N 条记录读取失败（可展开明细） |
+  | 会话页缺失或过期 | 会话页尚未生成或已过期，附“复制生成命令 / 复制刷新命令”按钮 |
+
+- 不展示来源、实例和项目 ID、Trace/观测数、归档和更新时间、关注点、检测与采集缺口：卡片上已有来源和更新时间，其余内容在会话页「会话信息」中完整展示。数据层只输出最近一次检测的 `status`。
 - 问题列表每行：进度点、编号、单行标题（悬停显示全文）、分类、进度、↗ 跳转。按进度排序，待处理的在前，同一进度内按编号。
 
 ### 7.3 异常维度

{agent_tune_kit-2.3.3 → agent_tune_kit-2.3.4}/docs/trace-project-attribution-design.md

@@ -4,6 +4,8 @@
 
 ## 1. 结论与已确认决策
 
+会话包含异常，具体异常关联项目。会话和异常分类均不保存独立项目归属，也不保存异常项目的并集。`source.project` 是轨迹来源命名空间，保持原义。项目多选使用可展开的复选菜单，提供清空、已选数量与键盘操作。
+
 在现有 Trace 流程内增加工程目录、Issue 的多工程归因，以及大盘和会话页的根因项目展示与筛选。初始化建立可复用的工程边界，诊断按证据决定归因；项目发现本身不产生归因。页面首先回答“问题出在哪个项目”，修复详情再说明“在哪里修改、为什么这样改”。
 
 | 决策 | 约定 | 来源 |
@@ -85,7 +87,7 @@ atk trace project --data <entry.json> --project-root <workspace> --json
 
 | 信息 | 表达的事实 | 呈现位置 |
 | --- | --- | --- |
-| 根因项目 | 根因实现／规则属于哪个工程；未证实的判断标为待确认 | 大盘、问题列表、会话概览及诊断详情 |
+| 根因项目 | 根因实现／规则属于哪个工程；未证实的判断标为待确认 | 异常视图、问题列表及诊断详情 |
 | 修改位置与范围 | 计划或实际在哪个工程、哪些文件／行为上修复；与根因项目不同时说明原因 | 修复方案、实际改动与验证详情 |
 
 一条异常可以有多个根因项目，不强制选一个“主责任项目”。通常在根因项目内修改，不需要额外展示一组相同的“改进项目”标签。若权衡后选择其他项目修改，修复详情用一句话说明目标和理由；不能因为修复落在其他项目就改变根因归属。根因未知但已有可行防护方案时，可以记录该方案，根因仍保持未确定。
@@ -150,7 +152,7 @@ $atk-trace-diagnose 调查 <session-id>，优先检查 APE 和 OT，
 
 ### 大盘
 
-继续提供“会话／异常分类”两个视图，只增加“根因项目”多选。卡片和问题行的项目标签都表示根因归属；不出现“角色”“改进项目”控件，不新增按修改项目筛选或统计的入口。新增的工程名称／别名搜索索引也只取根因关联，通用标题等文本搜索沿用现有行为。沿用现有组件、样式与离线页面，不新增 UI 依赖。
+继续提供“会话／异常分类”两个视图，只增加“根因项目”多选。异常分类汇总和问题行的项目标签都来自具体异常的根因归属；不出现“角色”“改进项目”控件，不新增按修改项目筛选或统计的入口。新增的工程名称／别名搜索索引也只取根因关联，通用标题等文本搜索沿用现有行为。沿用现有组件、样式与离线页面，不新增 UI 依赖。
 
 ```text
 根因项目：[APE ×] [OT ×]   来源：[全部 ▾]
@@ -161,17 +163,17 @@ ISSUE-001  ……异常标题……
 ```
 
 - 异常抽屉中的每条问题只显示根因项目标签；项目较多时展示前几个和 `+N`，展开可看全。已获支持的根因直接显示项目名，候选根因附“待确认”，不额外排列内部类型与证据状态标签。
-- 分类卡片显示命中问题的主要根因项目及去重问题数；会话卡片显示其问题根因项目的并集。拟修改或实际修改的其他项目不混入这些标签与统计。
+- 分类卡片显示“该类异常涉及的根因项目”及去重问题数；会话卡片仅显示会话事实、异常数量与进度，不展示项目归属。拟修改或实际修改的其他项目不混入这些标签与统计。
 - 多选根因项目使用 OR，与来源、搜索和进度使用 AND。候选根因也可被其项目筛选命中，但始终标明待确认。仅有“APE 根因、OT 修改”的问题只能被 APE 项目筛选命中；选 OT 不能因为修改位置在 OT 就命中。
 - 层级筛选默认包含所选工程及其子工程，并显示“含子项目”。父级用于筛选分组，不向 Issue 自动补写父级归因。
 - 保留“待归因”入口，涵盖尚未记录根因项目的问题，包括已有修复建议但根因仍未知的问题。已证实原因在登记工程以外时，在详情明确说明，不能以修改项目补齐归属。没有问题的会话在未筛选视图继续可见，不推断其根因工程。
 - 当前筛选的问题数、会话数和列表保持一致。进度图例按当前根因项目／来源／搜索范围计算各进度数量，点击图例再过滤列表，避免选中一档后其他档消失。
 - 计数以当前归档内的会话身份加 Issue ID 去重。一条异常命中多个根因项目也只计一次；各工程分项之和可以大于总问题数，不能直接相加为总计。内部存在改进关联不影响项目统计。
-- 根因项目选择与现有抽屉定位写入 URL hash，例如 `#view=category&project=asset-protocol-engine`；多个根因项目用重复参数。切换视图保留筛选，已有会话／分类深链继续可用，不引入角色参数。
+- 根因项目选择与现有抽屉定位写入 URL hash，例如 `#view=category&project=asset-protocol-engine`；多个根因项目用重复参数。异常视图保留项目筛选，切回会话总览不受项目条件影响；旧的会话项目筛选链接转入异常视图，明确指定会话的链接保留会话定位，不引入角色参数。
 
 ### 会话页
 
-- 顶部显示“根因项目”，从本会话 Issue 的根因归属派生，避免新增一份可独立编辑的会话关联表；没有记录根因项目时显示“待归因”。
+- 会话概览只显示会话事实；根因项目标签与筛选仅位于内部异常列表，不影响原始轨迹与证据。
 - 左侧问题卡片与问题详情摘要使用同一套根因项目标签，详情可查看归因依据和源码入口，不并列展示一份“改进项目”清单。
 - 修复方案及实际改动沿用已有阶段摘要，按项目说明拟修改／实际修改的位置和范围。修改就在根因项目内时正常展示文件与改动，不重复强调两种项目身份；修改在其他项目时写清“在 OT 的某个 Skill 修改，因为……”，同时说明该方案的作用与限制。提议与已执行改动保持区分。
 - 诊断记录展示自己的历史项目快照，明确区别于 Issue 当前关联，不把旧诊断显示成最新判断。
@@ -218,12 +220,12 @@ ISSUE-001  ……异常标题……
 | --- | --- | --- |
 | 1. 工程目录和关联记录 | 新增 `traces/projects.py`；修改 `cli/trace.py`、`traces/records.py`、`traces/archive.py` | 复用现有路径／锁／原子写／revision 工具；增加 `projects.json` 保留文件名，防止 Session ID 与其冲突；诊断快照及并发核对、修复／验证摘要的项目引用同步覆盖新字段 |
 | 2. Skill 流程与契约 | init、detect、diagnose、optimize、verify、visualize-trace；`docs/trace-tuning.md` 及中英文 README | 初始化阅读既有规则与名称、按项目优先诊断、按项目明确调查／修改范围、记录更新、跨仓候选与加载证据、页面刷新；capture 的来源身份与采集逻辑无须扩张 |
-| 3. 展示与回归 | `visualize/trace.py`、`visualize/traces.py`、两套页面 assets 和相关 tests | 共享根因项目读取／校验及命名结果；根因标签、筛选、去重、深链、历史快照、修复详情中的修改范围与取舍、过期提示与可访问性一起验收，不增加角色或修改项目筛选 |
+| 3. 展示与回归 | `visualize/trace.py`、`visualize/traces.py`、两套页面 assets 和相关 tests | 共享根因项目读取／校验及命名结果；异常根因标签、筛选、去重、深链、历史快照、修复详情中的修改范围与取舍、过期提示与可访问性一起验收，不增加角色或修改项目筛选 |
 
 关键验收场景：
 
 1. 普通单仓、显式普通目录、多 submodule 和嵌套 submodule 均可登记；缺失 checkout 仍可展示边界。重跑保留人工字段，路径／别名歧义可见，父级循环及越界路径拒绝。
-2. 同一 Issue 根因在 APE、可在 APE 或 OT 修改：大盘和会话概览只显示 APE 根因标签，APE 项目筛选命中、OT 项目筛选不命中。只有 OT 也有独立的归因依据时才增加其根因标签，待确认者必须明确标注；命中多个根因或父级时不重复计数。只有修改建议而无根因归属时仍显示待归因。
+2. 同一 Issue 根因在 APE、可在 APE 或 OT 修改：大盘异常视图和会话内异常列表只显示 APE 根因标签，APE 项目筛选命中、OT 项目筛选不命中。只有 OT 也有独立的归因依据时才增加其根因标签，待确认者必须明确标注；命中多个根因或父级时不重复计数。只有修改建议而无根因归属时仍显示待归因。
 3. 指定 APE／OT 后，若证据指向其他登记工程，调查继续并保存依据；仅出现工程名、调用传播或当前源码缺陷不足以确认历史根因。
 4. 修订关联保留 history；省略保留、空数组清空；已保存诊断和采用的哈希不变；并发 revision 冲突不能错配正文与关联。
 5. 未关联、停用／改名／移动工程、目录损坏、零问题会话及旧归档仍可浏览。新保留文件名不会与新会话目录冲突，旧同名会话仍可读取并报告迁移缺口；源码链接维持边界检查。