token-studio 4.8.0

package/src/client/review/markdown-report.js

@@ -0,0 +1,401 @@
+import {
+  buildProjectRoiRows,
+  buildReviewUnattributedSessions,
+  buildRiskDistribution,
+  buildUnattributedSessions,
+  sessionProjectLabel
+} from '../dashboard/attribution.js';
+import { buildRoiEvidence } from './roi-evidence.js';
+
+const PRODUCTIVE_STATUSES = new Set(['已完成', '已发布']);
+
+export function buildMarkdownReviewReport({
+  period,
+  daily = [],
+  sessions = [],
+  workItems = [],
+  roiAdvice = [],
+  savingsSimulation = null,
+  advisorActions = [],
+  insights = [],
+  generatedAt = new Date()
+} = {}) {
+  const totals = aggregateDaily(daily);
+  const projectRows = buildProjectRoiRows(sessions).slice(0, 8);
+  const modelRows = buildModelRows(daily).slice(0, 8);
+  const outputRows = buildOutputRows(sessions).slice(0, 12);
+  const riskRows = buildRiskDistribution(sessions);
+  const attributionGapRows = buildAttributionGapRows(sessions).slice(0, 10);
+  const attributionBreakdown = buildAttributionBreakdown(sessions);
+  const roiEvidence = buildRoiEvidence({ sessions, workItems });
+  const actionItems = buildActionItems({ roiAdvice, sessions, outputRows });
+  const actionStatusRows = buildAdvisorActionRows(advisorActions, period);
+
+  return [
+    '# Token Studio Weekly Review',
+    '',
+    `- 生成时间：${safeText(formatDateTime(generatedAt))}`,
+    `- 复盘周期：${safeText(period?.pretty || `${period?.start || ''} - ${period?.end || ''}` || '当前筛选周期')}`,
+    `- 数据口径：本地结构化用量、人工标注、自动归因和产出链接；不包含对话正文。`,
+    '',
+    '## 1. 本期总览',
+    '',
+    table(
+      ['指标', '数值'],
+      [
+        ['Session 数', formatInt(sessions.length)],
+        ['总 tokens', compactCN(totals.totalTokens)],
+        ['输入 tokens', compactCN(totals.inputTokens)],
+        ['输出 tokens', compactCN(totals.outputTokens)],
+        ['Cache read tokens', compactCN(totals.cacheReadTokens)],
+        ['官方价换算', money(totals.costUSD)],
+        ['未归因 session', formatInt(buildUnattributedSessions(sessions).length)],
+        ['人工确认归因', formatInt(attributionBreakdown.manual)],
+        ['自动高置信归因', formatInt(attributionBreakdown.autoHigh)],
+        ['自动低置信 / 待确认', formatInt(attributionBreakdown.autoLow + attributionBreakdown.missing)],
+        ['ROI 证据完整度', `${roiEvidence.evidenceScore}/100`],
+        ['Work items', formatInt(roiEvidence.workItemCount)]
+      ]
+    ),
+    '',
+    '## 2. 成本最高项目',
+    '',
+    projectRows.length ? table(
+      ['项目', 'Sessions', 'Tokens', '官方价', '完成/发布占比', '风险占比'],
+      projectRows.map(row => [
+        row.project,
+        row.sessionCount,
+        compactCN(row.totalTokens),
+        money(row.costUSD),
+        pct(row.productiveShare),
+        pct(row.riskShare)
+      ])
+    ) : '本期没有项目数据。',
+    '',
+    '## 3. 模型使用分布',
+    '',
+    modelRows.length ? table(
+      ['模型', '来源', 'Tokens', '官方价', '占比'],
+      modelRows.map(row => [
+        row.model,
+        row.source,
+        compactCN(row.totalTokens),
+        row.costUSD > 0 ? money(row.costUSD) : '未定价/无官方价',
+        pct(row.share)
+      ])
+    ) : '本期没有模型数据。',
+    '',
+    '## 4. 已完成 / 已发布产出',
+    '',
+    outputRows.length ? table(
+      ['状态', '类型', '标签', '项目', '链接'],
+      outputRows.map(row => [
+        row.outputStatus,
+        row.outputType || '未分类',
+        row.outputLabel || row.outputUrl || row.sessionId,
+        sessionProjectLabel(row),
+        markdownLink(row.outputLabel || row.outputUrl || '产出链接', row.outputUrl)
+      ])
+    ) : '本期没有已完成/已发布的产出链接。建议先给高价值 session 补 PR、commit、文章、部署、文档或截图链接。',
+    '',
+    '## 5. 风险成本',
+    '',
+    riskRows.length ? table(
+      ['风险类型', 'Sessions', 'Tokens', '官方价', '占比'],
+      riskRows.map(row => [
+        row.label,
+        row.sessionCount,
+        compactCN(row.totalTokens),
+        money(row.costUSD),
+        pct(row.share)
+      ])
+    ) : '本期没有明显风险成本。',
+    '',
+    '### 高成本待补齐归因',
+    '',
+    attributionGapRows.length ? table(
+      ['优先级', '项目', 'Session', '缺失字段', '归因来源', 'Tokens', '官方价', '最后活动'],
+      attributionGapRows.map((row, index) => [
+        index + 1,
+        row.project,
+        row.sessionId,
+        row.missingFields.join('、'),
+        row.attributionLabel,
+        compactCN(row.totalTokens),
+        row.costUSD > 0 ? money(row.costUSD) : '未定价/无官方价',
+        row.lastActivity || ''
+      ])
+    ) : '本期没有待补齐的高成本归因 session。',
+    '',
+    '## 6. 节省模拟',
+    '',
+    savingsSimulation?.suggestions?.length ? [
+      '官方价换算节省模拟只用于比较模型策略，不是供应商账单。',
+      '',
+      table(
+        ['建议', '当前层级', '建议层级', 'Sessions', 'Tokens', '当前官方价', '模拟后官方价', '可节省', '原因'],
+        savingsSimulation.suggestions.slice(0, 5).map(row => [
+          row.title,
+          tierLabel(row.currentTier),
+          tierLabel(row.suggestedTier),
+          row.sessionCount,
+          compactCN(row.totalTokens),
+          money(row.currentCostUSD),
+          money(row.simulatedCostUSD),
+          money(row.savingsUSD),
+          row.why
+        ])
+      )
+    ].join('\n') : '本期没有触发可计算的官方价节省建议。高价值已完成/已发布任务不会被建议降级模型。',
+    '',
+    savingsSimulation?.unpriced?.sessionCount ? `未纳入成本决策：${formatInt(savingsSimulation.unpriced.sessionCount)} 个 session、${compactCN(savingsSimulation.unpriced.totalTokens)} tokens 没有公开官方美元价，模型包括 ${safeText(savingsSimulation.unpriced.models.join('、') || 'unknown')}。` : '',
+    '',
+    '## 7. ROI Advisor 建议',
+    '',
+    roiAdvice.length ? roiAdvice.map((item, index) => [
+      `### ${index + 1}. ${safeText(item.title)}`,
+      '',
+      `- 建议分类：${safeText(item.category || '未分类')}`,
+      `- 影响级别：${safeText(item.impact || '未标注')}`,
+      `- 建议：${safeText(item.recommendation)}`,
+      `- 原因：${safeText(item.reason)}`,
+      `- 证据：${safeText(item.evidence)}`,
+      `- 建议动作：${safeText(item.action)}`
+    ].join('\n')).join('\n\n') : '本期没有触发 ROI Advisor 建议。',
+    '',
+    '## 8. 本周行动状态',
+    '',
+    actionStatusRows.length ? table(
+      ['状态', '分类', '建议', '行动'],
+      actionStatusRows.map(row => [
+        statusLabel(row.status),
+        row.category,
+        row.title,
+        row.action
+      ])
+    ) : '本期还没有加入行动清单的 Advisor / 节省模拟建议。',
+    '',
+    '说明：完成行动只表示复盘流程状态；报告只展示行动前后同类 token / 官方价趋势，不证明真实因果节省。',
+    '',
+    '## 9. 下周行动清单',
+    '',
+    actionItems.length ? actionItems.map(item => `- ${safeText(item)}`).join('\n') : '- 保持当前模型和上下文使用策略，继续补充真实产出链接。',
+    '',
+    '## 10. 口径说明',
+    '',
+    '- 金额为官方公开 token 单价换算，不是供应商账单或财务对账结果。',
+    '- 节省模拟使用当前 token 结构和已配置官方价模型做策略比较，不承诺真实账单节省。',
+    '- ChatGPT 套餐额度、企业折扣、税费、区域价、Batch/Flex/Priority 和特殊长上下文计费不会自动套用。',
+    '- 未公开官方美元价的模型保持“未定价”，不会按 $0 参与成本决策。',
+    '- 自动归因是基于结构化元数据的规则推断，不等同人工确认；高成本自动项建议抽查。',
+    '- 报告只使用本地结构化用量、人工标注、自动归因和产出链接，不读取、不导出对话正文。',
+    '- 产出链接只记录 URL、标签和类型；Token Studio 不抓取链接内容。'
+  ].join('\n');
+}
+
+export function buildReviewReportFilename(period, today = new Date()) {
+  const suffix = period?.end || formatDate(today);
+  return `token-studio-review-${suffix}.md`;
+}
+
+export function buildModelRows(daily = []) {
+  const rows = new Map();
+  const totalTokens = daily.reduce((sum, row) => sum + (row.totalTokens || 0), 0);
+  for (const row of daily) {
+    const model = row.model || '<unknown>';
+    const source = row.source || 'unknown';
+    const key = `${model}::${source}`;
+    if (!rows.has(key)) {
+      rows.set(key, { model, source, totalTokens: 0, costUSD: 0 });
+    }
+    const acc = rows.get(key);
+    acc.totalTokens += row.totalTokens || 0;
+    acc.costUSD += row.costUSD || 0;
+  }
+  return Array.from(rows.values())
+    .map(row => ({
+      ...row,
+      share: totalTokens ? row.totalTokens / totalTokens : 0
+    }))
+    .sort((a, b) => b.totalTokens - a.totalTokens);
+}
+
+function buildOutputRows(sessions = []) {
+  return sessions
+    .filter(session => PRODUCTIVE_STATUSES.has(session.outputStatus) && session.outputUrl)
+    .sort((a, b) => (b.totalTokens || 0) - (a.totalTokens || 0));
+}
+
+function buildAttributionGapRows(sessions = []) {
+  return buildReviewUnattributedSessions(sessions).map(session => ({
+    project: sessionProjectLabel(session),
+    sessionId: session.sessionId || '',
+    missingFields: missingAttributionFields(session),
+    attributionLabel: attributionLabel(session),
+    totalTokens: session.totalTokens || 0,
+    costUSD: session.costUSD || 0,
+    lastActivity: session.lastActivity || session.lastSeenAt || session.updatedAt || ''
+  }));
+}
+
+function buildAttributionBreakdown(sessions = []) {
+  return sessions.reduce((acc, session) => {
+    if (session.annotationSource === 'auto') {
+      if (Number(session.annotationConfidence || 0) >= 80) acc.autoHigh += 1;
+      else acc.autoLow += 1;
+    } else if (session.annotationSource === 'manual' || session.annotationSource === 'imported') {
+      acc.manual += 1;
+    } else {
+      acc.missing += 1;
+    }
+    return acc;
+  }, { manual: 0, autoHigh: 0, autoLow: 0, missing: 0 });
+}
+
+function attributionLabel(session = {}) {
+  if (session.annotationSource === 'auto') return `auto ${Number(session.annotationConfidence || 0)}%`;
+  if (session.annotationSource === 'manual') return 'manual';
+  if (session.annotationSource === 'imported') return 'imported';
+  return 'missing';
+}
+
+function missingAttributionFields(session = {}) {
+  const fields = [];
+  if ((session.taskType || '未分类') === '未分类') fields.push('任务类型');
+  if ((session.outputStatus || '未标注') === '未标注') fields.push('产出状态');
+  if ((session.workPurpose || '未说明') === '未说明') fields.push('工作目的');
+  if ((session.workStage || '未说明') === '未说明') fields.push('工作阶段');
+  if ((session.valueLevel || '未评估') === '未评估') fields.push('产出价值');
+  return fields;
+}
+
+function buildActionItems({ roiAdvice = [], sessions = [], outputRows = [] }) {
+  const items = roiAdvice.slice(0, 3).map(item => item.action).filter(Boolean);
+  const unattributed = buildUnattributedSessions(sessions).slice(0, 3);
+  for (const session of unattributed) {
+    items.push(`补齐 ${sessionProjectLabel(session)} 的 session 标注：任务、目的、阶段、价值和产出状态。`);
+  }
+  if (!outputRows.length) {
+    items.push('给已完成或已发布的高价值 session 补充 PR、commit、文章、部署、文档或截图链接。');
+  }
+  return Array.from(new Set(items)).slice(0, 8);
+}
+
+function buildAdvisorActionRows(actions = [], period = {}) {
+  return actions
+    .filter(action => !period?.start || (
+      action.periodStart === period.start && action.periodEnd === period.end
+    ))
+    .sort((a, b) => statusRank(a.status) - statusRank(b.status) || String(b.updatedAt || '').localeCompare(String(a.updatedAt || '')))
+    .slice(0, 12);
+}
+
+function statusRank(status) {
+  if (status === 'open') return 0;
+  if (status === 'done') return 1;
+  return 2;
+}
+
+function statusLabel(status) {
+  if (status === 'done') return '已完成';
+  if (status === 'dismissed') return '已忽略';
+  return '行动中';
+}
+
+function aggregateDaily(daily = []) {
+  return daily.reduce((acc, row) => {
+    acc.totalTokens += row.totalTokens || 0;
+    acc.inputTokens += row.inputTokens || 0;
+    acc.outputTokens += row.outputTokens || 0;
+    acc.cacheReadTokens += row.cacheReadTokens || 0;
+    acc.cacheCreationTokens += row.cacheCreationTokens || 0;
+    acc.reasoningOutputTokens += row.reasoningOutputTokens || 0;
+    acc.costUSD += row.costUSD || 0;
+    return acc;
+  }, {
+    totalTokens: 0,
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheCreationTokens: 0,
+    reasoningOutputTokens: 0,
+    costUSD: 0
+  });
+}
+
+function table(headers, rows) {
+  return [
+    `| ${headers.map(safeCell).join(' | ')} |`,
+    `| ${headers.map(() => '---').join(' | ')} |`,
+    ...rows.map(row => `| ${row.map(safeCell).join(' | ')} |`)
+  ].join('\n');
+}
+
+function safeCell(value) {
+  const text = safeText(value);
+  const formulaSafe = /^[=+\-@\t\r]/.test(text) ? `'${text}` : text;
+  return formulaSafe.replace(/\|/g, '\\|');
+}
+
+function safeText(value) {
+  return String(value ?? '')
+    .replace(/\r?\n/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function markdownLink(label, url) {
+  const text = safeText(label || url || '链接');
+  const href = safeText(url);
+  if (!/^https?:\/\//i.test(href)) return text || '—';
+  return `[${text.replace(/[[\]]/g, '')}](${href.replace(/[()]/g, encodeURIComponent)})`;
+}
+
+function compactCN(value) {
+  const v = Number(value || 0);
+  const abs = Math.abs(v);
+  if (abs >= 1e8) return `${(v / 1e8).toFixed(2).replace(/\.?0+$/, '')} 亿`;
+  if (abs >= 1e4) return `${(v / 1e4).toFixed(1).replace(/\.0$/, '')} 万`;
+  return formatInt(v);
+}
+
+function formatInt(value) {
+  return new Intl.NumberFormat('zh-CN').format(Math.round(Number(value || 0)));
+}
+
+function money(value) {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2
+  }).format(Number(value || 0));
+}
+
+function pct(value) {
+  return `${(Number(value || 0) * 100).toFixed(1)}%`;
+}
+
+function tierLabel(tier) {
+  if (tier === 'heavy') return '重模型';
+  if (tier === 'mid') return '中模型';
+  if (tier === 'light') return '轻量模型';
+  if (tier === 'unpriced') return '未定价';
+  return '未分层';
+}
+
+function formatDate(value) {
+  const d = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(d.getTime())) return '';
+  return [
+    d.getFullYear(),
+    String(d.getMonth() + 1).padStart(2, '0'),
+    String(d.getDate()).padStart(2, '0')
+  ].join('-');
+}
+
+function formatDateTime(value) {
+  const d = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(d.getTime())) return '';
+  return `${formatDate(d)} ${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+}

package/src/client/review/model-strategy.js

@@ -0,0 +1,273 @@
+import { modelTier } from './roi-advisor.js';
+
+const DEFAULT_TASK_TYPE = '未分类';
+const DEFAULT_WORK_PURPOSE = '未说明';
+const DEFAULT_WORK_STAGE = '未说明';
+const DEFAULT_VALUE_LEVEL = '未评估';
+const PRODUCTIVE_STATUSES = new Set(['已完成', '已发布']);
+const EXPLORATION_TASKS = new Set(['技术调研', '测试验证']);
+const EXPLORATION_PURPOSES = new Set(['需求澄清', '测试验证', '技术调研', '上下文整理']);
+const EXPLORATION_STAGES = new Set(['探索', '验证']);
+const IMPLEMENTATION_TASKS = new Set(['功能开发', '问题修复']);
+const IMPLEMENTATION_PURPOSES = new Set(['功能开发', '调试修复']);
+const IMPLEMENTATION_STAGES = new Set(['实现', '维护']);
+const REVIEW_TASKS = new Set(['代码审查']);
+const REVIEW_PURPOSES = new Set(['代码审查', '部署运维']);
+const REVIEW_STAGES = new Set(['发布']);
+const HIGH_VALUE_LEVELS = new Set(['高', '关键']);
+const LOW_VALUE_LEVELS = new Set(['低']);
+
+export function buildModelStrategy({ sessions = [] } = {}) {
+  const annotated = sessions.filter(hasStrategyAnnotation);
+  const total = aggregateSessions(sessions);
+  const annotatedTotal = aggregateSessions(annotated);
+  const modelRows = buildModelRowsFromSessions(sessions);
+
+  return {
+    coverage: {
+      sessionCount: sessions.length,
+      annotatedSessionCount: annotated.length,
+      annotatedShare: sessions.length ? annotated.length / sessions.length : 0,
+      totalTokens: total.totalTokens,
+      annotatedTokens: annotatedTotal.totalTokens,
+      annotatedTokenShare: total.totalTokens ? annotatedTotal.totalTokens / total.totalTokens : 0
+    },
+    byTaskType: buildDimensionRows(annotated, 'taskType', DEFAULT_TASK_TYPE),
+    byStage: buildDimensionRows(annotated, 'workStage', DEFAULT_WORK_STAGE),
+    byValue: buildDimensionRows(annotated, 'valueLevel', DEFAULT_VALUE_LEVEL),
+    playbook: buildModelPolicyRows(annotated),
+    riskModels: buildRiskModelRows(annotated),
+    modelRows,
+    recommendations: buildStrategyRecommendations({ sessions, annotated, modelRows })
+  };
+}
+
+export function hasStrategyAnnotation(session = {}) {
+  return (session.taskType || DEFAULT_TASK_TYPE) !== DEFAULT_TASK_TYPE
+    || (session.workPurpose || DEFAULT_WORK_PURPOSE) !== DEFAULT_WORK_PURPOSE
+    || (session.workStage || DEFAULT_WORK_STAGE) !== DEFAULT_WORK_STAGE
+    || (session.valueLevel || DEFAULT_VALUE_LEVEL) !== DEFAULT_VALUE_LEVEL;
+}
+
+export function buildModelRowsFromSessions(sessions = []) {
+  const rows = new Map();
+  const totalTokens = sessions.reduce((sum, session) => sum + (session.totalTokens || 0), 0);
+  for (const session of sessions) {
+    const model = session.model || session.pricingModel || '<unknown>';
+    if (!rows.has(model)) {
+      rows.set(model, {
+        model,
+        tier: modelTier(model, session.pricingStatus),
+        sessionCount: 0,
+        totalTokens: 0,
+        costUSD: 0,
+        productiveTokens: 0,
+        riskTokens: 0,
+        discardedTokens: 0,
+        highValueTokens: 0,
+        lowValueTokens: 0
+      });
+    }
+    const row = rows.get(model);
+    const tokens = session.totalTokens || 0;
+    row.sessionCount += 1;
+    row.totalTokens += tokens;
+    row.costUSD += session.costUSD || 0;
+    if (PRODUCTIVE_STATUSES.has(session.outputStatus)) row.productiveTokens += tokens;
+    if (session.outputStatus === '已废弃' || LOW_VALUE_LEVELS.has(session.valueLevel)) row.riskTokens += tokens;
+    if (session.outputStatus === '已废弃') row.discardedTokens += tokens;
+    if (HIGH_VALUE_LEVELS.has(session.valueLevel)) row.highValueTokens += tokens;
+    if (LOW_VALUE_LEVELS.has(session.valueLevel)) row.lowValueTokens += tokens;
+  }
+  return Array.from(rows.values())
+    .map(row => ({
+      ...row,
+      share: totalTokens ? row.totalTokens / totalTokens : 0,
+      productiveShare: row.totalTokens ? row.productiveTokens / row.totalTokens : 0,
+      riskShare: row.totalTokens ? row.riskTokens / row.totalTokens : 0
+    }))
+    .sort((a, b) => b.totalTokens - a.totalTokens);
+}
+
+function buildDimensionRows(sessions, field, defaultValue) {
+  const rows = new Map();
+  for (const session of sessions) {
+    const key = session[field] || defaultValue;
+    if (key === defaultValue) continue;
+    if (!rows.has(key)) {
+      rows.set(key, {
+        key,
+        sessionCount: 0,
+        totalTokens: 0,
+        costUSD: 0,
+        models: new Map()
+      });
+    }
+    const row = rows.get(key);
+    const model = session.model || session.pricingModel || '<unknown>';
+    const tokens = session.totalTokens || 0;
+    row.sessionCount += 1;
+    row.totalTokens += tokens;
+    row.costUSD += session.costUSD || 0;
+    row.models.set(model, (row.models.get(model) || 0) + tokens);
+  }
+  return Array.from(rows.values())
+    .map(row => ({
+      ...row,
+      topModel: topModel(row.models),
+      models: Array.from(row.models.entries()).sort((a, b) => b[1] - a[1])
+    }))
+    .sort((a, b) => b.totalTokens - a.totalTokens);
+}
+
+function buildRiskModelRows(sessions) {
+  return buildModelRowsFromSessions(sessions.filter(session =>
+    session.outputStatus === '已废弃' || LOW_VALUE_LEVELS.has(session.valueLevel)
+  )).slice(0, 5);
+}
+
+function buildModelPolicyRows(sessions) {
+  return [
+    {
+      id: 'light-default',
+      label: '轻量默认',
+      title: '测试验证、探索和上下文整理',
+      targetTier: 'light',
+      action: '默认用 Haiku、DeepSeek 或 MiMo 快速试错，方向确认后再升级。',
+      sessions: sessions.filter(isLightPolicyWork)
+    },
+    {
+      id: 'mid-implementation',
+      label: '中模型实现',
+      title: '功能开发、调试修复和维护实现',
+      targetTier: 'mid',
+      action: '复杂实现和调试默认用 Sonnet 或 Codex 中模型，兼顾上下文理解和成本。',
+      sessions: sessions.filter(isMidPolicyWork)
+    },
+    {
+      id: 'heavy-review',
+      label: '重模型审查',
+      title: '关键价值、代码审查和发布前确认',
+      targetTier: 'heavy',
+      action: '只在关键发布、复杂审查或高价值收口时使用 Opus / GPT 重模型。',
+      sessions: sessions.filter(isHeavyPolicyWork)
+    }
+  ].map(({ sessions: matching, ...row }) => {
+    const aggregate = aggregateSessions(matching);
+    const modelRows = buildModelRowsFromSessions(matching);
+    const top = modelRows[0];
+    return {
+      ...row,
+      sessionCount: aggregate.sessionCount,
+      totalTokens: aggregate.totalTokens,
+      costUSD: aggregate.costUSD,
+      topModel: top?.model || '待标注验证',
+      observedTier: top?.tier || 'unknown',
+      evidenceState: aggregate.sessionCount ? '已观察' : '待标注验证'
+    };
+  });
+}
+
+function isLightPolicyWork(session = {}) {
+  return EXPLORATION_TASKS.has(session.taskType)
+    || EXPLORATION_PURPOSES.has(session.workPurpose)
+    || EXPLORATION_STAGES.has(session.workStage);
+}
+
+function isMidPolicyWork(session = {}) {
+  return IMPLEMENTATION_TASKS.has(session.taskType)
+    || IMPLEMENTATION_PURPOSES.has(session.workPurpose)
+    || IMPLEMENTATION_STAGES.has(session.workStage);
+}
+
+function isHeavyPolicyWork(session = {}) {
+  return REVIEW_TASKS.has(session.taskType)
+    || REVIEW_PURPOSES.has(session.workPurpose)
+    || REVIEW_STAGES.has(session.workStage)
+    || HIGH_VALUE_LEVELS.has(session.valueLevel);
+}
+
+function buildStrategyRecommendations({ sessions, annotated, modelRows }) {
+  const recommendations = [];
+  const coverage = sessions.length ? annotated.length / sessions.length : 0;
+  if (sessions.length && coverage < 0.5) {
+    recommendations.push({
+      id: 'label-before-model-policy',
+      title: '先补齐标注再固化模型策略',
+      detail: `当前只有 ${(coverage * 100).toFixed(0)}% session 有任务、阶段或价值标注，模型策略结论还不够稳。`,
+      action: '优先标注最高成本的 10 个 session，再观察不同任务和阶段的模型表现。'
+    });
+  }
+
+  const heavyExploration = annotated.filter(session => {
+    const tier = modelTier(session.model || session.pricingModel, session.pricingStatus);
+    return tier === 'heavy'
+      && (EXPLORATION_TASKS.has(session.taskType) || EXPLORATION_STAGES.has(session.workStage));
+  });
+  if (heavyExploration.length) {
+    const agg = aggregateSessions(heavyExploration);
+    recommendations.push({
+      id: 'light-model-for-exploration',
+      title: '探索和验证默认用轻量模型',
+      detail: `${heavyExploration.length} 个探索/验证 session 使用了重模型，合计 ${compactCN(agg.totalTokens)} tokens。`,
+      action: '测试验证、上下文整理、技术调研先用 Haiku、DeepSeek 或 MiMo，进入复杂实现再升级。'
+    });
+  }
+
+  const reusable = annotated.filter(session => {
+    const tier = modelTier(session.model || session.pricingModel, session.pricingStatus);
+    return PRODUCTIVE_STATUSES.has(session.outputStatus)
+      && HIGH_VALUE_LEVELS.has(session.valueLevel)
+      && ['light', 'mid'].includes(tier);
+  });
+  if (reusable.length) {
+    const models = Array.from(new Set(reusable.map(session => session.model || session.pricingModel).filter(Boolean))).slice(0, 3);
+    recommendations.push({
+      id: 'keep-high-value-pattern',
+      title: '保留高价值低成本模型组合',
+      detail: `${reusable.length} 个高价值完成/发布 session 使用中轻量模型完成，代表可复用模式。`,
+      action: `相似任务优先复用 ${models.join('、') || '当前中轻量模型'}，重模型留给关键审查和复杂调试。`
+    });
+  }
+
+  const risky = modelRows.filter(row => row.riskShare > 0.2 && row.totalTokens > 0).slice(0, 2);
+  for (const row of risky) {
+    recommendations.push({
+      id: `risk-${row.model}`,
+      title: `${row.model} 的低价值/废弃占比较高`,
+      detail: `${row.model} 有 ${(row.riskShare * 100).toFixed(0)}% tokens 落在低价值或废弃任务上。`,
+      action: '后续同类任务先设 token 止损线，用轻量模型验证方向后再升级。'
+    });
+  }
+
+  return recommendations.slice(0, 5);
+}
+
+function aggregateSessions(sessions = []) {
+  return sessions.reduce((acc, session) => {
+    acc.sessionCount += 1;
+    acc.totalTokens += session.totalTokens || 0;
+    acc.costUSD += session.costUSD || 0;
+    return acc;
+  }, { sessionCount: 0, totalTokens: 0, costUSD: 0 });
+}
+
+function topModel(models) {
+  let best = '—';
+  let bestTokens = -1;
+  for (const [model, tokens] of models) {
+    if (tokens > bestTokens) {
+      best = model;
+      bestTokens = tokens;
+    }
+  }
+  return best;
+}
+
+function compactCN(value) {
+  const v = Number(value || 0);
+  const abs = Math.abs(v);
+  if (abs >= 1e8) return `${(v / 1e8).toFixed(2).replace(/\.?0+$/, '')} 亿`;
+  if (abs >= 1e4) return `${(v / 1e4).toFixed(1).replace(/\.0$/, '')} 万`;
+  return String(Math.round(v));
+}