dsh-plugin-teamflow 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 > 本插件首次公开发布版本为 **v0.1.0**；发布前的内部迭代（v0.3~v0.13）记录于 `AGENTS.md` §5，对外统一归到 v0.1.0。
 
+## [0.1.7] - 2026-09-11
+
+### 新增
+- **工作台产物一键预览**：任务卡详情里的「任务夹」现在按真实存在的产物列按钮（PRD / DESIGN / TECHNICAL / QA-REPORT / ACCEPTANCE / meta），点一下即在 DSH **右侧栏**打开预览（Markdown 由官方文档预览器接管）。地址由 host 用官方 `fileAddressFor` 生成（`dsh-resource://file/session/<id>/<相对路径>`）——客户端不拼地址、也不引宿主包进 client bundle；只列真实存在的文件（不出死按钮）；右侧栏服务缺失时静默降级
+- **产物交付（`present`）**：prd/tech/qa/acceptance 四个阶段被要求把任务夹产物交给官方 `present` 工具 → 用户在该会话得到「交付文件卡」（预览 / 默认程序打开 / 文件管理器定位）。诚实标注为 `[policy]` 增强项：文件仍是唯一事实源，缺文件依旧是硬失败；卡片渲染在**该子代理会话**的轮次尾部（主会话不显示）
+- **机械阶段推理强度降档（省 token）**：DeepSeek 路由默认 `reasoningEffort: high`，而推理 token **计入 output** 且**推理内容每个带推理回合原样回传**（同时抬高后续 input）。现对两处机械阶段下发 `low`——patch 档的「单点确认」与 `scaffold`（脚手架落地）；判据类阶段（PRD/设计/技术方案/QA/验收）保持宿主默认 `high`，**重试自动回升 `high`**（质量优先）。安全前提：先经 `llm.resolveModelInfo()` 探测该路由的 `reasoning.efforts`，只有声明支持才下发——宿主对不支持的值会 `UNSUPPORTED_REASONING_EFFORT` 硬失败且不降级；探测结果按 provider/model 缓存。阶段日志记录实际下发的档位
+
+### 修复
+- **token 计量改走官方 Session 投影（宿主弃用同步事件读取器）**：dsh 0.1.5-rc.2 起 `Session.eventAt()` / `snapshotEvents()` / `ownEvents()` 标记为 deprecated（存量可留、新调用禁止，宿主方向是不再把完整事件序列常驻内存）。计量来源改为**官方投影优先**——`ctx.sessionProjections.stateOf(session,'tokenUsage')` 取四桶（与宿主 token-meter 同一份 fold，重试替换语义更准）+ `'sessionStats'.steps` 取调用数，**零历史扫描**；投影缺失/无数据/读取异常时静默回退原事件扫描（最小 profile 与存量宿主不受影响，不虚报 0，不中断流水线）。`sessionProjections` 走可选 `ctx.inject`，不进 `static inject`——服务缺失时插件照常加载
+- **护栏适配官方通道（提醒 + 挂死检测）**：轻提醒从手写 `session.append('user/message')` + step/end flush 时序状态机，改为官方 `run.localAgent.inject()`（宿主在协议安全边界整批认领，旧注释声称的「会插进 tool_calls→tool_result 触发 400」不成立）；挂死检测从「多源取最长事件视图」长度启发式改为官方 **`subagentTiming` 投影**的 `active.through`（已提交事件时间，不受视图失明影响——上次 QA 误判 stalled 的根因）。长工具静默执行仍由 agent 活动守卫豁免；投影不可用时回退旧启发式。中止语义未变
+
+### 改进
+- **声明宿主兼容窗口**：`package.json` 新增 `engines.dsh: ">=0.1.5-rc.2 <0.2.0"` 与 `dsh.manifestVersion: 1`（dsh 0.1.5 起支持的公共 manifest 字段；当前宿主不校验，属作者声明）；README「版本锚定」段同步到 v0.1.5-rc.2，并记录本次兼容核对结论与两个待跟进项
+- **清理死注入**：`static inject` 长期硬注入 `tokenMeter` 却全仓从未使用 → 从 static inject / setRuntime / runtime 三处移除（假依赖会拖累插件的加载条件）
+- **工作区 key 文档纠偏**：`workspaceScopeOf` 的「优先用 DSH workspace UUID」分支**当前不可达**（宿主 `resolveByPath` 是异步、我们同步调用），实际生效的是路径派生 `slugPath(cwd)`；注释与 AGENTS.md 改为事实描述，真修（改异步 + 存储 key 迁移）列入 `docs/TODO.md` 待 v0.1.8
+
+### 已知待办
+- **护栏复读检测仍读已弃用的事件读取器**（提醒通道与挂死检测已改官方；复读需要流式文本内容）：官方替代是订阅 `'session/event'` post-commit 投递，需先定等价判据，见 `docs/TODO.md`（当前行为不变，存量调用被宿主明确允许）
+
+## [0.1.6] - 2026-09-07
+
+### 新增
+- **评测层 L1+L2（prompt/注入改动收益评测）**：每次改 prompt/注入后可直接验证收益——L1 行为级契约测试（直接调用 prompt 工厂断言产出锚点，29 条契约分 HOST-ENFORCED/policy/structural 三级，改 prompt 一眼看出断了哪条、丢哪级保障）+ L2 回放语料一致性门禁（冻结真实形状的 QA-REPORT/ACCEPTANCE/dev 回复/蓝图产物，喂宿主真实解析器做 golden corpus 回归，零 LLM 成本）。语料只增不改，防评测过拟合
+- **dev/qaFix 验证证据块**：开发回复末尾强制「[Verification evidence]」块（命令+退出码+断言计数+失败行引用，或显式 N/A），host 提取存证、阶段详情可见、可与命令日志交叉核对——开发阶段从「单方宣称全绿」升级为「可审计的具体自述」
+- **代码级英文化（为 UI i18n 铺路）**：代码判断/命名全英文（阶段键 prd/design/scaffold/tech/dev/qa/acceptance、任务结构化键 taskKey），中文只留展示层；存量数据提供迁移脚本
+
+### 改进
+- **resume 断点续跑状态机化**：两级状态（大阶段 + 子图任务）聚合判定——有 done 尝试的任务即成功（历史失败不算失败），resume 只补跑「聚合后未成功」任务、复用已完成产物；不再读 backlog 子卡（残留失败卡不再污染判定）；dev 部分成功时起点精确回开发补跑未完成，全 done 时正确落在 QA/验收
+- **输出单轨制**：QA/验收的完整报告只写在任务夹文件（QA-REPORT.md/ACCEPTANCE.md），子代理回复仅摘要+路径——host 直接导入文件（缺陷表/核对表），杜绝「回复与文件不一致」的双轨问题
+- **验收结论契约强度**：验收报告结论行必须为字面量模板（✅/⚠️/❌/📝 四档）且为文件最后一行；无结论行/空结论行 → 需人工确认（不再默认通过，防质量门禁漏报）
+- **prompt 约束分级**：区分 [HOST-ENFORCED]（host 真实强制，如单轨产物/结论行）与 [policy]（自律 + 轻提醒），prompt 内不再自称 hard constraint
+- **重试诊断包**：重试时把上次失败详情（outcome/护栏原因/拒绝词命中点/产出尾部）附进 prompt——盲试 → 带因重试；stalled（挂死/空转）不再自动重试
+
+### 修复
+- **token 计量适配宿主 session v2**：宿主新版会话已无 `events` 属性，计量读不到 → 流水线卡与图卡无「TOKEN · 官方口径」。修复：多源回退（snapshotEvents/ownEvents）+ usage 双路径（含 stream 内嵌），新 run 计量恢复
+- **护栏挂死误杀**：QA 子代理正常干活却被判「10 分钟无事件」（宿主事件视图失明）——事件读取多源回退 + agent 活动守卫（非 idle 且已动手即不中止）
+- **任务卡 token 统计**：子卡 usage 按 stage 引用直写（并发下不再错位/超计）
+- **存量迁移脚本 taskKey 误判**：合法中文括号结尾的任务键不再被当作历史残留（幂等无损但计数虚高）
+- **验收空结论行/裸否定词漏报**：四档词白名单校验覆盖 accepted 分支
+
+### 其他
+- AGENTS.md 注入面瘦身 64%；dsh 0.1.3-alpha.1 兼容性核对（依赖包名更新）
+
 ## [0.1.5] - 2026-09-01
 
 ### 新增

package/README.md

@@ -119,6 +119,21 @@ dsh-plugin-teamflow/
 - Node.js ≥ 22.18；
 - 依赖宿主提供的 `@deepseek-ai/dsh-*` 与 `react`（peerDependencies，宿主注入，无需单独安装）。
 
+### 版本锚定（dsh 宿主兼容性）
+
+本插件开发与验证基于 **dsh v0.1.5-rc.2（2026-09-10，tag `dsh-v0.1.5-rc.2`）**；npm 侧 `next`=0.1.5-rc.2、`latest`=0.1.5-rc.1（`latest` 常滞后于 `next`，勿以 latest 判断发布线）。`peerDependencies` 保持 `*`（宿主注入，宽松兼容），并在 `package.json` 声明兼容窗口 **`engines.dsh: ">=0.1.5-rc.2 <0.2.0"`** 与 **`dsh.manifestVersion: 1`**——当前 dsh 不读取/校验这两个字段（源码内仅有类型声明），属作者声明性元数据。
+
+2026-09-10 兼容性核对（dsh 0.1.5-rc.2）：插件面板 Slot（原 `conversation` 根 slot → `main` 下的 `conversation` key）、会话格式 V3 + Session 生命周期（`SessionHandle`、异步 `agentLoop.create()`、会话锁）、`ctx.agent` 移除与 Inbox 类型化、SDK/Headless/ACP 默认工具调整、subprocess handle 去除 pid——**插件全部兼容**（未使用被改动的接口；`conversation.view` / `conversation.input.right` 声明未变，slot 树无删除）。其中一项需要跟进：
+
+- **Session 同步事件读取器已弃用**（`session.eventAt()` / `snapshotEvents()` / `ownEvents()`，宿主 2026-09-09 起「存量可留、新调用禁止」，方向是不再把完整事件序列常驻内存）：**token 计量已改为官方 Session 投影优先**（`ctx.sessionProjections.stateOf(session,'tokenUsage')` 取四桶 + `'sessionStats'.steps` 取调用数），事件扫描降级为无投影宿主的回退；**护栏的提醒通道已改官方 `Agent.inject()`、挂死判据已改用官方 `subagentTiming` 投影的 `active.through`**（长工具静默仍由 agent 活动守卫豁免），只剩**复读检测**仍在读事件（需要流式文本内容，官方替代＝订阅 `'session/event'` post-commit 投递，需先定等价判据，见 `docs/TODO.md`）。
+
+2026-09-04 核对（dsh 0.1.3-alpha.1）：session 持久化 v2（write-lease/JSONL 快照/版本化导出）、attachment/file-upload 收口、Windows 子进程隐藏、workspace 全限定路径硬化——全部兼容，插件无需调整。
+
+插件侧契约约束（dsh 升级后若行为异常先核对本段；锚定版本变更会在此更新）：
+- 插件注入的 session 事件（`tool-workflow/agent-start`、`user/message` 带 `source.kind='plugin'`）均在宿主 `known-event-types` 词表内；**未来新增自定义事件类型须带 `ignorable: true`**，已知类型载荷不加词表外键；
+- `@deepseek-ai/dsh-client-modules` 自 0.1.2-rc.1 起替代 `@deepseek-ai/dsh-client-runtime`（后者已从 monorepo 移除）；
+- 计量读的是**宿主投影 key**（`tokenUsage` / `sessionStats`）而非插件自有格式：宿主若改 key 或 state 版本，此段与 `host/core/metering.ts` 同步更新。
+
 ## 安装（对使用者）
 
 ```bash

package/lib/client.js

@@ -308,15 +308,37 @@ window.__ModuleLoader__.load({
 			interrupted: T.warn,
 			superseded: T.text2
 		};
+		/** 阶段英文键 → 图标/中文展示名（2026-09-06 英文化：journal.phase 为英文键，展示名统一走映射——未来 i18n 换表即换语言）。 */
 		const PHASE_ICON = {
-			"PRD 产品需求": "📋",
-			"UI/UX 设计": "🎨",
-			"架构规划": "🏗️",
-			"技术方案": "📐",
-			开发: "💻",
-			"QA 测试": "🧪",
-			"产品验收": "✅"
+			prd: "📋",
+			design: "🎨",
+			scaffold: "🏗️",
+			tech: "📐",
+			dev: "💻",
+			qa: "🧪",
+			acceptance: "✅"
 		};
+		const PHASE_NAME = {
+			prd: "PRD 产品需求",
+			design: "UI/UX 设计",
+			scaffold: "架构规划",
+			tech: "技术方案",
+			dev: "开发",
+			qa: "QA 测试",
+			acceptance: "产品验收"
+		};
+		const phaseNameOf = (p) => PHASE_NAME[p] || p || "—";
+		const phaseIconOf = (p) => PHASE_ICON[p] || "⚙️";
+		/** phase 归一：英文键直通；存量中文映射（防御性——新数据全英文）。 */
+		const phaseKeyOf = (p) => ({
+			"PRD 产品需求": "prd",
+			"UI/UX 设计": "design",
+			"架构规划": "scaffold",
+			"技术方案": "tech",
+			"开发": "dev",
+			"QA 测试": "qa",
+			"产品验收": "acceptance"
+		})[p] || String(p || "");
 		const RUN_STATUS_TEXT = {
 			pending: "等待中",
 			running: "进行中",
@@ -642,7 +664,20 @@ window.__ModuleLoader__.load({
 					textOverflow: "ellipsis",
 					whiteSpace: "nowrap"
 				}
-			}, s.label), chip(stText(s.status), color, { dot: true }), h("span", { style: {
+			}, s.__taskKey || s.label), s.attempts && s.attempts.length > 1 ? h("span", {
+				title: `重试 ${s.attempts.length - 1} 次（共 ${s.attempts.length} 次尝试）`,
+				style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					fontWeight: 800,
+					color: T.warn,
+					background: `color-mix(in srgb, ${T.warn} 14%, transparent)`,
+					borderRadius: 999,
+					padding: "0 6px",
+					lineHeight: "15px",
+					flex: "0 0 auto"
+				}
+			}, `↻${s.attempts.length - 1}`) : null, chip(stText(s.status), color, { dot: true }), h("span", { style: {
 				color: T.text2,
 				fontSize: 11,
 				opacity: .5
@@ -724,12 +759,12 @@ window.__ModuleLoader__.load({
 				fontWeight: 700,
 				background: `linear-gradient(90deg, color-mix(in srgb, ${g.headColor} 13%, transparent), color-mix(in srgb, ${g.headColor} 5%, transparent))`,
 				border: `1px solid color-mix(in srgb, ${g.headColor} 30%, transparent)`
-			} }, h("span", { style: { fontSize: 13.5 } }, PHASE_ICON[g.phase] || "⚙️"), h("span", { style: {
+			} }, h("span", { style: { fontSize: 13.5 } }, phaseIconOf(g.phase)), h("span", { style: {
 				flex: 1,
 				overflow: "hidden",
 				textOverflow: "ellipsis",
 				whiteSpace: "nowrap"
-			} }, g.phase), g.stages.length > 1 ? h("span", { style: {
+			} }, phaseNameOf(g.phase)), g.stages.length > 1 ? h("span", { style: {
 				fontFamily: MONO,
 				fontSize: 10,
 				fontWeight: 800,
@@ -752,26 +787,32 @@ window.__ModuleLoader__.load({
 				paddingTop: 10
 			} }, g.stages.map((s) => FlowStageCard(s, s.seq, onOpen))));
 		}
-		/** 阶段详情抽屉（卡片点击打开；浮于画布右侧，不参与拖动/缩放）。 */
+		/** 阶段详情抽屉（卡片点击打开；浮于画布右侧，不参与拖动/缩放）。
+		* 2026-09-06 状态机化：同任务多次尝试 → 顶部尝试时间线 + 选中展开（默认最新）；
+		* 单次尝试保持现状（不渲染时间线）。 */
 		function StageDetailDrawer({ det, onClose, sessionId, sessions }) {
+			const [sel, setSel] = react.default.useState(null);
 			const st = det.stage;
 			const d = det.data;
+			const attempts = d && d.attempts && d.attempts.length > 1 ? d.attempts : null;
+			const selIdx = attempts ? sel === null ? attempts.length - 1 : sel : null;
+			const cur = attempts ? attempts[selIdx] || d : d;
 			const color = st && st.status ? stColor(st.status) : T.text2;
 			const ownerSession = d && d.ownerSession ? String(d.ownerSession) : null;
 			const mySession = sessionId ? String(sessionId) : null;
 			const crossSession = !!ownerSession && !!mySession && ownerSession !== mySession;
-			const hasChild = !!(!crossSession && d && d.childId && sessions && typeof sessions.openSubagent === "function");
+			const hasChild = !!(!crossSession && cur && cur.childId && sessions && typeof sessions.openSubagent === "function");
 			const openChild = () => {
 				if (crossSession || !hasChild) return;
 				try {
 					sessions.openSubagent({
 						parentSessionId: ownerSession || sessionId,
-						childSessionId: d.childId,
+						childSessionId: cur.childId,
 						mode: "one-shot"
 					});
 				} catch (e) {}
 			};
-			const outText = d && d.output ? d.output : d && d.summary ? `（该 run 未保存完整正文，展示摘要）\n\n${d.summary}` : det.err ? `⚠ 加载失败：${det.err}` : det.loading ? "加载中…" : "（无产物正文）";
+			const outText = cur && cur.output ? cur.output : cur && cur.summary ? `（该 run 未保存完整正文，展示摘要）\n\n${cur.summary}` : det.err ? `⚠ 加载失败：${det.err}` : det.loading ? "加载中…" : "（无产物正文）";
 			const closeBtn = {
 				font: "inherit",
 				width: 26,
@@ -820,7 +861,7 @@ window.__ModuleLoader__.load({
 				padding: "12px 14px",
 				borderBottom: `1px solid ${T.border}`,
 				background: `linear-gradient(135deg, color-mix(in srgb, ${color} 14%, transparent), transparent 62%)`
-			} }, h("span", { style: { fontSize: 17 } }, PHASE_ICON[st && st.phase] || "⚙️"), h("div", { style: {
+			} }, h("span", { style: { fontSize: 17 } }, phaseIconOf(st && st.phase)), h("div", { style: {
 				flex: 1,
 				minWidth: 0
 			} }, h("div", {
@@ -864,7 +905,66 @@ window.__ModuleLoader__.load({
 				fontFamily: MONO,
 				color: T.text,
 				lineHeight: 1.65
-			} }, usageDetail(d || st || {}))), h("div", { style: {
+			} }, usageDetail(cur || st || {}))), attempts ? h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 5
+			} }, h("span", { style: {
+				fontSize: 10.5,
+				fontWeight: 700,
+				color: T.text2,
+				letterSpacing: .3
+			} }, `↻ 尝试历史（${attempts.length} 次 · 点击查看该次详情）`), h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 4
+			} }, attempts.map((a, idx) => {
+				const aColor = a.status === "done" ? T.success : a.status === "failed" ? T.error : T.warn;
+				const sel = idx === selIdx;
+				return h("div", {
+					key: a.seq,
+					onClick: () => setSel(idx),
+					title: (a.summary || a.outcome || "").slice(0, 200),
+					style: {
+						cursor: "pointer",
+						borderRadius: 9,
+						padding: "6px 9px",
+						display: "flex",
+						gap: 7,
+						alignItems: "center",
+						border: `1px solid ${sel ? color : T.border}`,
+						background: sel ? `color-mix(in srgb, ${color} 10%, transparent)` : T.layer1
+					}
+				}, h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10.5,
+					color: T.text2,
+					flex: "0 0 52px"
+				} }, `#${a.seq}`), h("span", { style: {
+					fontSize: 11,
+					color: aColor,
+					flex: "0 0 64px",
+					fontWeight: 700
+				} }, a.status === "done" ? "✅ 成功" : a.status === "failed" ? `❌ ${a.outcome || "失败"}` : "⏳ 进行中"), h("span", { style: {
+					flex: 1,
+					minWidth: 0,
+					fontSize: 10.5,
+					color: T.text2,
+					overflow: "hidden",
+					textOverflow: "ellipsis",
+					whiteSpace: "nowrap"
+				} }, (a.summary || a.outcome || "（无摘要）").slice(0, 80)), h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					color: T.text2,
+					flex: "0 0 auto"
+				} }, a.startedAt ? fmtDur(a.startedAt, a.endedAt) : "—"), h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					color: T.text2,
+					flex: "0 0 auto"
+				} }, a.usage ? fmtTokens(totalTokens(a.usage)) : ""));
+			}))) : null, h("div", { style: {
 				display: "flex",
 				flexDirection: "column",
 				gap: 5
@@ -898,7 +998,37 @@ window.__ModuleLoader__.load({
 				color: T.text2,
 				textAlign: "center",
 				lineHeight: 1.55
-			} }, "跳转成功后，请切「对话」tab 查看该子代理的完整会话轨迹") : null), h("div", { style: {
+			} }, "跳转成功后，请切「对话」tab 查看该子代理的完整会话轨迹") : null), st && phaseKeyOf(st.phase) === "dev" ? h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 5
+			} }, h("span", { style: {
+				fontSize: 10.5,
+				fontWeight: 700,
+				color: T.text2,
+				letterSpacing: .3
+			} }, "🔬 验证证据"), cur && cur.verifyEvidence ? h("div", { style: {
+				whiteSpace: "pre-wrap",
+				wordBreak: "break-word",
+				fontSize: 11.5,
+				lineHeight: 1.62,
+				color: T.text,
+				background: `color-mix(in srgb, ${T.layer2} 55%, transparent)`,
+				border: `1px solid ${T.border}`,
+				borderRadius: 10,
+				padding: "10px 12px",
+				maxHeight: 180,
+				overflowY: "auto",
+				fontFamily: MONO
+			} }, cur.verifyEvidence) : h("div", { style: {
+				fontSize: 11,
+				color: T.warn,
+				background: `color-mix(in srgb, ${T.warn} 8%, transparent)`,
+				border: `1px dashed color-mix(in srgb, ${T.warn} 45%, transparent)`,
+				borderRadius: 10,
+				padding: "8px 12px",
+				lineHeight: 1.55
+			} }, "（缺失——契约未兑现，host 已记警告；可与 logs/teamflow/<runId>/ 命令输出日志对照）")) : null, h("div", { style: {
 				display: "flex",
 				flexDirection: "column",
 				gap: 5
@@ -932,6 +1062,7 @@ window.__ModuleLoader__.load({
 				marginBottom: 8
 			} }, "🏭"), "暂无运行中的流水线——让模型调用 teamflow_start，或在上方输入需求");
 			const groups = [];
+			const taskKeyOf = (s) => String(s.taskKey || String(s.label || "").replace(/^开发 · /, "").replace(/（(?:第 \d+ 次重试|补跑)）$/, "").trim());
 			for (const st of active.stages || []) {
 				let g = groups.length ? groups[groups.length - 1] : null;
 				if (!g || g.phase !== st.phase) {
@@ -941,7 +1072,31 @@ window.__ModuleLoader__.load({
 					};
 					groups.push(g);
 				}
-				g.stages.push(st);
+				const key = taskKeyOf(st);
+				const prev = g.stages.find((x) => x.__taskKey === key);
+				if (prev) {
+					prev.attempts = prev.attempts || [prev];
+					prev.attempts.push(st);
+					if ((st.seq || 0) > (prev.seq || 0)) {
+						for (const f of [
+							"status",
+							"outcome",
+							"usage",
+							"output",
+							"summary",
+							"childId",
+							"startedAt",
+							"endedAt",
+							"verifyEvidence"
+						]) prev[f] = st[f];
+						prev.seq = st.seq;
+						prev.label = st.label;
+					}
+				} else g.stages.push({
+					...st,
+					__taskKey: key,
+					attempts: [st]
+				});
 			}
 			const wrapRef = react.default.useRef(null);
 			const [vw, setVw] = react.default.useState(900);
@@ -1237,7 +1392,7 @@ window.__ModuleLoader__.load({
 				sessions
 			}) : null);
 		}
-		function BoardPanel({ backlog, api, onRefresh, sessionId, onShowRun }) {
+		function BoardPanel({ backlog, api, onRefresh, sessionId, onShowRun, openArtifact }) {
 			const [drag, setDrag] = react.default.useState(null);
 			const [over, setOver] = react.default.useState(null);
 			const [det, setDet] = react.default.useState(null);
@@ -1527,7 +1682,8 @@ window.__ModuleLoader__.load({
 			}), det ? h(ItemDetailDrawer, {
 				det,
 				onClose: () => setDet(null),
-				onShowRun
+				onShowRun,
+				openArtifact
 			}) : null);
 		}
 		function fmtAt(ts) {
@@ -1536,7 +1692,7 @@ window.__ModuleLoader__.load({
 				minute: "2-digit"
 			}) : "—";
 		}
-		function ItemDetailDrawer({ det, onClose, onShowRun }) {
+		function ItemDetailDrawer({ det, onClose, onShowRun, openArtifact }) {
 			const d = det && det.data;
 			const loading = det && det.loading;
 			const err = det && det.err;
@@ -1795,7 +1951,30 @@ window.__ModuleLoader__.load({
 					borderRadius: 8,
 					padding: "7px 10px",
 					wordBreak: "break-all"
-				} }, d.runDocs + "/")) : null,
+				} }, d.runDocs + "/"), Array.isArray(d.artifacts) && d.artifacts.length > 0 ? h("div", { style: {
+					display: "flex",
+					flexWrap: "wrap",
+					gap: 6,
+					marginTop: 1
+				} }, d.artifacts.map((a) => h("button", {
+					key: a.name,
+					onClick: () => {
+						if (openArtifact) openArtifact(a.address, a.name);
+					},
+					title: `在右侧栏预览 ${d.runDocs}/${a.name}`,
+					style: {
+						fontSize: 10.5,
+						fontWeight: 600,
+						padding: "3px 9px",
+						borderRadius: 6,
+						cursor: "pointer",
+						lineHeight: "16px",
+						border: `1px solid color-mix(in srgb, ${T.brand} 38%, transparent)`,
+						background: `color-mix(in srgb, ${T.brand} 10%, transparent)`,
+						color: T.brand,
+						whiteSpace: "nowrap"
+					}
+				}, `📄 ${String(a.name).replace(/\.md$/, "")}`))) : null) : null,
 				kind === "task" && d.usage ? h("div", { style: {
 					display: "flex",
 					flexDirection: "column",
@@ -2363,6 +2542,7 @@ window.__ModuleLoader__.load({
 				api,
 				onRefresh: refresh,
 				sessionId: props.sessionId,
+				openArtifact: props.openArtifact,
 				onShowRun: (rid) => {
 					setTab("pipeline");
 					setRunId(rid);
@@ -2381,6 +2561,18 @@ window.__ModuleLoader__.load({
 		async function apply(ctx) {
 			await ctx.remote.$mount(TEAMFLOW_REMOTE_CONTRIBUTION);
 			const teamflow = ctx.get("remote.teamflow");
+			const openArtifact = (address, name) => {
+				try {
+					const sidebarRight = ctx.get("sidebarRight");
+					if (!sidebarRight || typeof sidebarRight.openResource !== "function") {
+						console.warn("[teamflow] 右侧栏服务不可用，无法预览产物", name);
+						return;
+					}
+					sidebarRight.openResource(address);
+				} catch (e) {
+					console.warn("[teamflow] 打开产物失败", name, e && e.message);
+				}
+			};
 			ctx.slots.inject("conversation.view", () => ctx.slots.register({
 				name: "conversation.view",
 				id: "teamflow",
@@ -2389,7 +2581,8 @@ window.__ModuleLoader__.load({
 				inject: (sessionId) => ({
 					sessionId,
 					remote: teamflow,
-					sessions: ctx.get("sessions")
+					sessions: ctx.get("sessions"),
+					openArtifact
 				})
 			}, TeamFlowView));
 			ctx.slots.inject("conversation.input.right", () => ctx.slots.register({