agentworkshop 0.7.60 → 0.7.62

package/app/pages/analysis/composables/useAnalysisFeed.ts

@@ -1,85 +1,85 @@
-/**
- * 数据分析页的数据面:REST 快照为底 + WS 实时帧触发节流刷新。
- *
- * 权威查询走 GET /api/workshop/analysis(lineId/category/q/from/to);
- * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',由 analysis_save 的 recordOps 广播)——
- * 收到新留痕帧后去抖拉一次快照,避免自己维护两套行形状的合并去重。
- */
-import { computed, onScopeDispose, reactive, ref } from 'vue'
-import { apiFetch } from '@/app/composables/workshop/apiClient'
-import { useTownBus } from '@/app/composables/workshop/useTownBus'
-import { ANALYSIS_WINDOW_PRESETS, type AnalysisReportView, type AnalysisWindowPreset } from '../types'
-
-/** 统一客户端:信封 {code,message,data} 解析取 .data(与 aml 页请求写法同源) */
-function analysisApi<T>(path: string, init?: RequestInit): Promise<T> {
-  return apiFetch<T>({ base: '/api/workshop/analysis', path, init })
-}
-
-export function useAnalysisFeed() {
-  const bus = useTownBus()
-
-  const q = reactive<{ lineId: string, category: string, preset: AnalysisWindowPreset, text: string }>({
-    lineId: '',
-    category: '',
-    preset: 'all',
-    text: '',
-  })
-  const hasFilter = computed(() => Boolean(q.lineId || q.category || q.preset !== 'all' || q.text.trim()))
-
-  const rows = ref<AnalysisReportView[]>([])
-  const loading = ref(false)
-  const error = ref('')
-  /** 实时轨计数(本会话收到的 analysis 留痕帧数,页头脉冲用) */
-  const liveCount = ref(0)
-
-  async function doQuery(): Promise<void> {
-    loading.value = true
-    error.value = ''
-    try {
-      const preset = ANALYSIS_WINDOW_PRESETS.find(p => p.key === q.preset)
-      const params = new URLSearchParams()
-      if (q.lineId) params.set('lineId', q.lineId)
-      if (q.category) params.set('category', q.category)
-      if (q.text.trim()) params.set('q', q.text.trim())
-      if (preset?.ms) params.set('from', new Date(Date.now() - preset.ms).toISOString())
-      params.set('limit', '200')
-      const data = await analysisApi<{ reports: AnalysisReportView[], count: number }>(`/?${params.toString()}`)
-      rows.value = data.reports ?? []
-    }
-    catch (err) {
-      error.value = err instanceof Error ? err.message : String(err)
-    }
-    finally {
-      loading.value = false
-    }
-  }
-
-  function resetFilters(): void {
-    q.lineId = ''
-    q.category = ''
-    q.preset = 'all'
-    q.text = ''
-    void doQuery()
-  }
-
-  // WS 实时面:analysis 留痕帧 → 计数 + 去抖刷新快照(连发多份报告只拉一次)。
-  // TownBus 信封 type 是宽化联合,kind 按字段读取收窄。
-  let refreshTimer: ReturnType<typeof setTimeout> | null = null
-  const unsubscribe = bus.subscribe((e) => {
-    if (e.type !== 'ops.log') return
-    const p = e.payload as { kind?: string, action?: string }
-    if (p.kind !== 'analysis' || p.action === 'analysis.delete') return
-    liveCount.value++
-    if (refreshTimer) return
-    refreshTimer = setTimeout(() => {
-      refreshTimer = null
-      void doQuery()
-    }, 800)
-  })
-  onScopeDispose(() => {
-    unsubscribe()
-    if (refreshTimer) clearTimeout(refreshTimer)
-  })
-
-  return { q, hasFilter, rows, loading, error, liveCount, doQuery, resetFilters }
-}
+/**
+ * 数据分析页的数据面:REST 快照为底 + WS 实时帧触发节流刷新。
+ *
+ * 权威查询走 GET /api/workshop/analysis(lineId/category/q/from/to);
+ * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',由 analysis_save 的 recordOps 广播)——
+ * 收到新留痕帧后去抖拉一次快照,避免自己维护两套行形状的合并去重。
+ */
+import { computed, onScopeDispose, reactive, ref } from 'vue'
+import { apiFetch } from '@/app/composables/workshop/apiClient'
+import { useTownBus } from '@/app/composables/workshop/useTownBus'
+import { ANALYSIS_WINDOW_PRESETS, type AnalysisReportView, type AnalysisWindowPreset } from '../types'
+
+/** 统一客户端:信封 {code,message,data} 解析取 .data(与 aml 页请求写法同源) */
+function analysisApi<T>(path: string, init?: RequestInit): Promise<T> {
+  return apiFetch<T>({ base: '/api/workshop/analysis', path, init })
+}
+
+export function useAnalysisFeed() {
+  const bus = useTownBus()
+
+  const q = reactive<{ lineId: string, category: string, preset: AnalysisWindowPreset, text: string }>({
+    lineId: '',
+    category: '',
+    preset: 'all',
+    text: '',
+  })
+  const hasFilter = computed(() => Boolean(q.lineId || q.category || q.preset !== 'all' || q.text.trim()))
+
+  const rows = ref<AnalysisReportView[]>([])
+  const loading = ref(false)
+  const error = ref('')
+  /** 实时轨计数(本会话收到的 analysis 留痕帧数,页头脉冲用) */
+  const liveCount = ref(0)
+
+  async function doQuery(): Promise<void> {
+    loading.value = true
+    error.value = ''
+    try {
+      const preset = ANALYSIS_WINDOW_PRESETS.find(p => p.key === q.preset)
+      const params = new URLSearchParams()
+      if (q.lineId) params.set('lineId', q.lineId)
+      if (q.category) params.set('category', q.category)
+      if (q.text.trim()) params.set('q', q.text.trim())
+      if (preset?.ms) params.set('from', new Date(Date.now() - preset.ms).toISOString())
+      params.set('limit', '200')
+      const data = await analysisApi<{ reports: AnalysisReportView[], count: number }>(`/?${params.toString()}`)
+      rows.value = data.reports ?? []
+    }
+    catch (err) {
+      error.value = err instanceof Error ? err.message : String(err)
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  function resetFilters(): void {
+    q.lineId = ''
+    q.category = ''
+    q.preset = 'all'
+    q.text = ''
+    void doQuery()
+  }
+
+  // WS 实时面:analysis 留痕帧 → 计数 + 去抖刷新快照(连发多份报告只拉一次)。
+  // TownBus 信封 type 是宽化联合,kind 按字段读取收窄。
+  let refreshTimer: ReturnType<typeof setTimeout> | null = null
+  const unsubscribe = bus.subscribe((e) => {
+    if (e.type !== 'ops.log') return
+    const p = e.payload as { kind?: string, action?: string }
+    if (p.kind !== 'analysis' || p.action === 'analysis.delete') return
+    liveCount.value++
+    if (refreshTimer) return
+    refreshTimer = setTimeout(() => {
+      refreshTimer = null
+      void doQuery()
+    }, 800)
+  })
+  onScopeDispose(() => {
+    unsubscribe()
+    if (refreshTimer) clearTimeout(refreshTimer)
+  })
+
+  return { q, hasFilter, rows, loading, error, liveCount, doQuery, resetFilters }
+}

package/app/pages/analysis/index.vue

@@ -1,92 +1,128 @@
-<template>
-  <div class="page">
-    <!-- 页头(aw-page-head 规范)+ 实时轨计数 -->
-    <AnalysisPageHead :live-count="feed.liveCount.value" />
-
-    <!-- 筛选:产线 / 类别 / 时间窗 / 关键词 -->
-    <AnalysisFilterCard
-      v-model:line-id="feed.q.lineId"
-      v-model:category="feed.q.category"
-      v-model:preset="feed.q.preset"
-      v-model:text="feed.q.text"
-      :has-filter="feed.hasFilter.value"
-      :loading="feed.loading.value"
-      @query="feed.doQuery"
-      @reset="feed.resetFilters"
-    />
-
-    <!-- 分析报告台账:REST 快照为底,analysis 留痕 WS 帧去抖刷新;admin 可删(清污数据) -->
-    <AnalysisTable
-      v-model:expanded-id="expandedId"
-      :rows="feed.rows.value"
-      :loading="feed.loading.value"
-      :error="feed.error.value"
-      :admin="userStore.isAdmin"
-      @toggle="toggleRow"
-      @remove="removeReport"
-    />
-  </div>
-</template>
-
-<script setup lang="ts">
-/**
- * 数据分析页 —— Agent Channel 分析产出的持久留痕台账(append-only)。
- *
- * 数据权威在 server analysis_reports 表:GET /api/workshop/analysis 按维度查询;
- * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',analysis_save 的 recordOps 广播),
- * 收到帧后去抖拉快照。留痕由 Agent 经 analysis_save 原生工具写入,页面纯只读
- * (清污数据走 admin 的 DELETE /api/workshop/analysis/:id)。
- * 数据面在 composables/useAnalysisFeed,展示在 components/analysis/*
- * (app/pages 下任何 .vue 都会成为路由,页面私有子组件不放这里)。
- */
-import { onMounted, ref } from 'vue'
-import { useUserStore } from '~/stores/workshop/user'
-import { useWorkshopWs } from '@/app/composables/workshop/useWorkshopWs'
-import { apiFetch } from '@/app/composables/workshop/apiClient'
-import { apiErrorMessage } from '@/app/utils/api-error'
-import { useAnalysisFeed } from './composables/useAnalysisFeed'
-import type { AnalysisReportView } from './types'
-import AnalysisPageHead from '~/components/analysis/AnalysisPageHead.vue'
-import AnalysisFilterCard from '~/components/analysis/AnalysisFilterCard.vue'
-import AnalysisTable from '~/components/analysis/AnalysisTable.vue'
-
-const ws = useWorkshopWs()
-const feed = useAnalysisFeed()
-const userStore = useUserStore()
-const expandedId = ref('')
-
-function toggleRow(row: AnalysisReportView): void {
-  expandedId.value = expandedId.value === row.id ? '' : row.id
-}
-
-/** 管理面删除(仅 admin;REST 侧 requireRole 兜底) */
-const removing = ref(false)
-async function removeReport(row: AnalysisReportView): Promise<void> {
-  if (removing.value) return
-  removing.value = true
-  try {
-    await apiFetch({ base: '/api/workshop/analysis', path: `/${row.id}`, init: { method: 'DELETE' } })
-    if (expandedId.value === row.id) expandedId.value = ''
-    await feed.doQuery()
-  }
-  catch (err) {
-    feed.error.value = apiErrorMessage(err)
-  }
-  finally {
-    removing.value = false
-  }
-}
-
-onMounted(() => {
-  ws.ensureConnected()
-  void feed.doQuery()
-})
-</script>
-
-<script lang="ts">
-export default { name: 'AnalysisPage' }
-</script>
-
-<style scoped>
-.page { display: flex; flex-direction: column; gap: 12px; }
-</style>
+<template>
+  <div class="page">
+    <!-- 页头(aw-page-head 规范)+ 实时轨计数 -->
+    <AnalysisPageHead :live-count="feed.liveCount.value" />
+
+    <!-- 筛选:产线 / 类别 / 时间窗 / 关键词 -->
+    <AnalysisFilterCard
+      v-model:line-id="feed.q.lineId"
+      v-model:category="feed.q.category"
+      v-model:preset="feed.q.preset"
+      v-model:text="feed.q.text"
+      :has-filter="feed.hasFilter.value"
+      :loading="feed.loading.value"
+      @query="feed.doQuery"
+      @reset="feed.resetFilters"
+    />
+
+    <!-- 分析报告台账:REST 快照为底,analysis 留痕 WS 帧去抖刷新;admin 可删,canEdit 可修订 -->
+    <AnalysisTable
+      v-model:expanded-id="expandedId"
+      :rows="feed.rows.value"
+      :loading="feed.loading.value"
+      :error="feed.error.value"
+      :admin="userStore.isAdmin"
+      @toggle="toggleRow"
+      @remove="removeReport"
+      @edit="openEdit"
+    />
+
+    <!-- 人工修订弹窗(v27 编辑面;canEdit 行可见) -->
+    <AnalysisEditModal
+      :report="editing"
+      :saving="savingEdit"
+      @close="editing = null"
+      @save="saveEdit"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * 数据分析页 —— Agent Channel 分析产出的持久留痕台账(append-only)。
+ *
+ * 数据权威在 server analysis_reports 表:GET /api/workshop/analysis 按维度查询;
+ * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',analysis_save 的 recordOps 广播),
+ * 收到帧后去抖拉快照。留痕由 Agent 经 analysis_save 原生工具写入,页面纯只读
+ * (清污数据走 admin 的 DELETE /api/workshop/analysis/:id)。
+ * 数据面在 composables/useAnalysisFeed,展示在 components/analysis/*
+ * (app/pages 下任何 .vue 都会成为路由,页面私有子组件不放这里)。
+ */
+import { onMounted, ref } from 'vue'
+import { useUserStore } from '~/stores/workshop/user'
+import { useWorkshopWs } from '@/app/composables/workshop/useWorkshopWs'
+import { apiFetch } from '@/app/composables/workshop/apiClient'
+import { apiErrorMessage } from '@/app/utils/api-error'
+import { useAnalysisFeed } from './composables/useAnalysisFeed'
+import type { AnalysisReportView } from './types'
+import AnalysisPageHead from '~/components/analysis/AnalysisPageHead.vue'
+import AnalysisFilterCard from '~/components/analysis/AnalysisFilterCard.vue'
+import AnalysisTable from '~/components/analysis/AnalysisTable.vue'
+import AnalysisEditModal from '~/components/analysis/AnalysisEditModal.vue'
+
+const ws = useWorkshopWs()
+const feed = useAnalysisFeed()
+const userStore = useUserStore()
+const expandedId = ref('')
+
+function toggleRow(row: AnalysisReportView): void {
+  expandedId.value = expandedId.value === row.id ? '' : row.id
+}
+
+/** 管理面删除(仅 admin;REST 侧 requireRole 兜底) */
+const removing = ref(false)
+async function removeReport(row: AnalysisReportView): Promise<void> {
+  if (removing.value) return
+  removing.value = true
+  try {
+    await apiFetch({ base: '/api/workshop/analysis', path: `/${row.id}`, init: { method: 'DELETE' } })
+    if (expandedId.value === row.id) expandedId.value = ''
+    await feed.doQuery()
+  }
+  catch (err) {
+    feed.error.value = apiErrorMessage(err)
+  }
+  finally {
+    removing.value = false
+  }
+}
+
+/** 人工修订(v27 编辑面):弹窗预填 → PATCH → 刷新(服务端按 canEdit 同口径鉴权) */
+const editing = ref<AnalysisReportView | null>(null)
+const savingEdit = ref(false)
+function openEdit(row: AnalysisReportView): void {
+  editing.value = row
+}
+async function saveEdit(patch: Record<string, unknown>): Promise<void> {
+  if (!editing.value || savingEdit.value) return
+  savingEdit.value = true
+  try {
+    await apiFetch({
+      base: '/api/workshop/analysis',
+      path: `/${editing.value.id}`,
+      init: { method: 'PATCH', body: JSON.stringify(patch) },
+    })
+    editing.value = null
+    await feed.doQuery()
+  }
+  catch (err) {
+    feed.error.value = apiErrorMessage(err)
+  }
+  finally {
+    savingEdit.value = false
+  }
+}
+
+onMounted(() => {
+  ws.ensureConnected()
+  void feed.doQuery()
+})
+</script>
+
+<script lang="ts">
+export default { name: 'AnalysisPage' }
+</script>
+
+<style scoped>
+.page { display: flex; flex-direction: column; gap: 12px; }
+</style>

package/app/pages/analysis/types.ts

@@ -1,44 +1,50 @@
-/**
- * 数据分析页的类型面(与 server/services/workshop/analysis/analysis.repo.ts 的
- * AnalysisReportRow 驼峰投影一致;JSON 列已在服务端解析)。
- */
-
-/** 分析类别(与 analysis_save 工具描述的建议档一致;自由面,未知类别按原文展示) */
-export type AnalysisCategory = 'quality' | 'oee' | 'alarm' | 'trend' | 'optimization' | 'general'
-
-export const ANALYSIS_CATEGORIES: AnalysisCategory[] = ['quality', 'oee', 'alarm', 'trend', 'optimization', 'general']
-
-/** 时间窗预设(前端算 fromMs;all = 不限) */
-export type AnalysisWindowPreset = '1h' | '24h' | '7d' | '30d' | 'all'
-
-export const ANALYSIS_WINDOW_PRESETS: { key: AnalysisWindowPreset, ms: number | null }[] = [
-  { key: '1h', ms: 3_600_000 },
-  { key: '24h', ms: 86_400_000 },
-  { key: '7d', ms: 7 * 86_400_000 },
-  { key: '30d', ms: 30 * 86_400_000 },
-  { key: 'all', ms: null },
-]
-
-export interface AnalysisReportView {
-  id: string
-  lineId: string
-  lineName: string
-  title: string
-  category: string
-  /** 一句话关键结论 */
-  summary: string
-  conclusions: string[]
-  report: string
-  metrics: Record<string, unknown>
-  recipeId: string
-  recipeVersion: string
-  windowFrom: string | null
-  windowTo: string | null
-  dataSources: string
-  context: Record<string, unknown>
-  channelId: string
-  channelName: string
-  actor: string
-  actorName: string
-  createdAt: string
-}
+/**
+ * 数据分析页的类型面(与 server/services/workshop/analysis/analysis.repo.ts 的
+ * AnalysisReportRow 驼峰投影一致;JSON 列已在服务端解析)。
+ */
+
+/** 分析类别(与 analysis_save 工具描述的建议档一致;自由面,未知类别按原文展示) */
+export type AnalysisCategory = 'quality' | 'oee' | 'alarm' | 'trend' | 'optimization' | 'general'
+
+export const ANALYSIS_CATEGORIES: AnalysisCategory[] = ['quality', 'oee', 'alarm', 'trend', 'optimization', 'general']
+
+/** 时间窗预设(前端算 fromMs;all = 不限) */
+export type AnalysisWindowPreset = '1h' | '24h' | '7d' | '30d' | 'all'
+
+export const ANALYSIS_WINDOW_PRESETS: { key: AnalysisWindowPreset, ms: number | null }[] = [
+  { key: '1h', ms: 3_600_000 },
+  { key: '24h', ms: 86_400_000 },
+  { key: '7d', ms: 7 * 86_400_000 },
+  { key: '30d', ms: 30 * 86_400_000 },
+  { key: 'all', ms: null },
+]
+
+export interface AnalysisReportView {
+  id: string
+  lineId: string
+  lineName: string
+  title: string
+  category: string
+  /** 一句话关键结论 */
+  summary: string
+  conclusions: string[]
+  report: string
+  metrics: Record<string, unknown>
+  recipeId: string
+  recipeVersion: string
+  windowFrom: string | null
+  windowTo: string | null
+  dataSources: string
+  context: Record<string, unknown>
+  channelId: string
+  channelName: string
+  actor: string
+  actorName: string
+  createdAt: string
+  /** v27 人工修订归因(未修订 = null/空) */
+  updatedAt: string | null
+  updatedBy: string
+  updatedByName: string
+  /** 编辑能力位(服务端按 admin/产线 operate 判定) */
+  canEdit?: boolean
+}

package/i18n/locales/en.ts

@@ -881,6 +881,14 @@ export default {
     remove: 'Delete',
     removeConfirm: 'Delete analysis report "{p0}"? This cannot be undone',
     cancel: 'Cancel',
+    editTitle: 'Revise analysis report',
+    save: 'Save revision',
+    kRecipe: 'Recipe ID',
+    kVersion: 'Recipe version',
+    kWindowFrom: 'Data window from',
+    kWindowTo: 'Data window to',
+    conclusionsHint: 'one per line',
+    kRevised: 'Revised',
     thTime: 'Analyzed At',
     thLine: 'Line',
     thTitle: 'Title',

package/i18n/locales/zh-CN.ts

@@ -881,6 +881,14 @@ export default {
     remove: '删除',
     removeConfirm: '删除分析报告「{p0}」?删除后不可恢复',
     cancel: '取消',
+    editTitle: '修订分析报告',
+    save: '保存修订',
+    kRecipe: '配方 id',
+    kVersion: '配方版本',
+    kWindowFrom: '数据窗起点',
+    kWindowTo: '数据窗终点',
+    conclusionsHint: '每行一条',
+    kRevised: '修订记录',
     thTime: '分析时间',
     thLine: '产线',
     thTitle: '标题',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.60",
+  "version": "0.7.62",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "Apache-2.0",

package/server/api/workshop/analysis/[id].delete.ts

@@ -1,30 +1,30 @@
-/**
- * DELETE /api/workshop/analysis/:id —— 删除分析报告(仅 admin;台账 Agent 面无删,清污数据走此口)。
- */
-import { getRouterParam } from 'h3'
-import { requireRole } from '@/server/api/workshop/caller'
-import { defineApiHandler } from '@/server/utils/response'
-import { AppError } from '@/server/utils/errors'
-import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
-import { recordOps } from '@/server/services/workshop/ops/ops'
-
-export default defineApiHandler(async (event) => {
-  const user = requireRole(event)
-  const id = getRouterParam(event, 'id')!
-  const report = getAnalysisRepo().get(id)
-  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
-  getAnalysisRepo().remove(id)
-  recordOps({
-    actor: user.id,
-    actorName: user.name,
-    actorKind: 'user',
-    action: 'analysis.delete',
-    kind: 'analysis',
-    targetKind: 'analysis',
-    targetId: id,
-    lineId: report.lineId,
-    recipeId: report.recipeId,
-    summary: `删除分析报告「${report.title}」(产线「${report.lineName || report.lineId || '-'}」)`,
-  })
-  return { ok: true }
-})
+/**
+ * DELETE /api/workshop/analysis/:id —— 删除分析报告(仅 admin;台账 Agent 面无删,清污数据走此口)。
+ */
+import { getRouterParam } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  const id = getRouterParam(event, 'id')!
+  const report = getAnalysisRepo().get(id)
+  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
+  getAnalysisRepo().remove(id)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'analysis.delete',
+    kind: 'analysis',
+    targetKind: 'analysis',
+    targetId: id,
+    lineId: report.lineId,
+    recipeId: report.recipeId,
+    summary: `删除分析报告「${report.title}」(产线「${report.lineName || report.lineId || '-'}」)`,
+  })
+  return { ok: true }
+})

package/server/api/workshop/analysis/[id].get.ts

@@ -1,23 +1,25 @@
-/**
- * GET /api/workshop/analysis/:id —— 分析报告详情(含完整正文;产线可见性校验)。
- */
-import { getRouterParam } from 'h3'
-import { defineApiHandler } from '@/server/utils/response'
-import { AppError } from '@/server/utils/errors'
-import { resolveUser } from '@/server/api/workshop/caller'
-import { visibleLineIds } from '@/server/services/workshop/permissions'
-import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
-
-export default defineApiHandler(async (event) => {
-  const user = resolveUser(event)
-  const id = getRouterParam(event, 'id')!
-  const report = getAnalysisRepo().get(id)
-  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
-  if (report.lineId) {
-    const visible = visibleLineIds(user)
-    if (visible && !visible.has(report.lineId)) {
-      throw new AppError(403, 'LINE_FORBIDDEN', `无权查看产线「${report.lineName || report.lineId}」的分析报告`)
-    }
-  }
-  return { report }
-})
+/**
+ * GET /api/workshop/analysis/:id —— 分析报告详情(含完整正文;产线可见性校验)。
+ */
+import { getRouterParam } from 'h3'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError } from '@/server/utils/errors'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { visibleLineIds, lineMode } from '@/server/services/workshop/permissions'
+import { getAnalysisRepo } from '@/server/services/workshop/analysis/analysis.repo'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id')!
+  const report = getAnalysisRepo().get(id)
+  if (!report) throw new AppError(404, 'NOT_FOUND', `分析报告不存在: ${id}`)
+  if (report.lineId) {
+    const visible = visibleLineIds(user)
+    if (visible && !visible.has(report.lineId)) {
+      throw new AppError(403, 'LINE_FORBIDDEN', `无权查看产线「${report.lineName || report.lineId}」的分析报告`)
+    }
+  }
+  // v27 编辑能力位(与列表端点同口径:admin 或产线 operate)
+  const canEdit = user.role === 'admin' || (Boolean(report.lineId) && lineMode(user, report.lineId) === 'operate')
+  return { report: { ...report, canEdit } }
+})