agentworkshop 0.7.44 → 0.7.47

package/app/pages/workshop/composables/useAgentHarnessOptions.ts

@@ -0,0 +1,59 @@
+import { computed, ref } from 'vue'
+import { useWorkshopApi, type HarnessMetaDto } from '@/app/composables/workshop/useWorkshopApi'
+
+/** harness 下拉项(未安装 = label 标注 + 禁用) */
+export interface HarnessOption {
+  value: string
+  label: string
+  disabled: boolean
+}
+
+/**
+ * harness 注册表(引擎注册表动态拉取,含环境可用性探测;失败回退静态表)——
+ * 页面唯一副本:能力矩阵徽标 capBadges、可用性 isUnavailable、元信息 harnessMeta、
+ * 下拉项 harnessOptions 都在这里派生一次,由页面分发给模板表格与编辑弹窗。
+ * 两个子组件不得各自再算一遍(同一条"引擎未安装"判据要处处一致),拉取也只注册一次。
+ */
+export function useAgentHarnessOptions() {
+  const api = useWorkshopApi()
+  const { t: tt } = useI18n()
+
+  const harnesses = ref<HarnessMetaDto[]>([])
+  const harnessById = computed(() => new Map(harnesses.value.map(h => [h.id, h])))
+  /** 按 id 取注册表元信息(页面/子组件共用的唯一取数口) */
+  const harnessMeta = (id: string): HarnessMetaDto | undefined => harnessById.value.get(id)
+  const isUnavailable = (id: string): boolean => harnessById.value.get(id)?.available === false
+  const harnessOptions = computed<HarnessOption[]>(() =>
+    (harnesses.value.length > 0
+      ? harnesses.value
+      : [
+          { id: 'mock', label: tt('agents.hMock'), description: '', capabilities: { steer: true, supervise: false, hitl: false, terminal: false, contextStats: false, compact: false } },
+          { id: 'omp', label: tt('agents.hOmp'), description: '', capabilities: { steer: true, supervise: true, hitl: true, terminal: true, contextStats: true, compact: true } },
+          { id: 'claude', label: 'claude', description: '', capabilities: { steer: false, supervise: false, hitl: false, terminal: false, contextStats: false, compact: false } },
+        ] as HarnessMetaDto[]).map((h) => {
+      const unavailable = h.available === false
+      return { value: h.id, label: unavailable ? `${h.label}(${tt('agents.notInstalled')})` : h.label, disabled: unavailable }
+    }),
+  )
+  const capBadges = (id: string): string[] => {
+    const caps = harnesses.value.find(h => h.id === id)?.capabilities
+    if (!caps) return []
+    const out: string[] = []
+    if (caps.steer) out.push('steer')
+    if (caps.supervise) out.push('lead')
+    if (caps.hitl) out.push('HITL')
+    if (caps.compact) out.push('compact')
+    return out
+  }
+  const loadHarnesses = async (): Promise<void> => {
+    try {
+      const res = await api.listHarnesses()
+      const list = (res as unknown as { data?: { harnesses?: HarnessMetaDto[] } })?.data?.harnesses
+      if (Array.isArray(list) && list.length > 0) harnesses.value = list
+    }
+    catch { /* 回退静态表 */ }
+  }
+  if (import.meta.client) void loadHarnesses()
+
+  return { harnesses, harnessMeta, isUnavailable, harnessOptions, capBadges }
+}

package/app/pages/workshop/composables/useAgentTemplateActions.ts

@@ -0,0 +1,42 @@
+import { message } from 'ant-design-vue'
+import { useWorkshopApi, type AgentTemplateDto } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 行级写操作依赖:刷新回调 = 页面的 load(成功后 void reload(),与拆分前 void load() 一致) */
+export interface AgentTemplateActionsOptions {
+  reload: () => void | Promise<void>
+}
+
+/**
+ * Agent 模板的行级即时写操作:删除 / 启停 / 一键切换可见性。
+ * 校验与弹窗提交(新建·编辑)不在这里:见 useAgentTemplateForm。
+ */
+export function useAgentTemplateActions(options: AgentTemplateActionsOptions) {
+  const api = useWorkshopApi()
+  const { t: tt } = useI18n()
+
+  const remove = async (t: AgentTemplateDto): Promise<void> => {
+    await api.deleteTemplate(t.id)
+    message.success(tt('agents.k3n5sd7022'))
+    void options.reload()
+  }
+
+  const toggleEnabled = async (t: AgentTemplateDto): Promise<void> => {
+    await api.updateTemplate(t.id, { enabled: t.enabled === 1 ? 0 : 1 })
+    void options.reload()
+  }
+
+  /** 一键切换可见性(属主/admin;行内 switch) */
+  const toggleVisibility = async (t: AgentTemplateDto, pub: boolean): Promise<void> => {
+    try {
+      await api.updateTemplate(t.id, { visibility: pub ? 'public' : 'private' })
+      message.success(pub ? tt('agents.kxa6cxx023') : tt('agents.k1xxabaf024'))
+      void options.reload()
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+  }
+
+  return { remove, toggleEnabled, toggleVisibility }
+}

package/app/pages/workshop/composables/useAgentTemplateDialogState.ts

@@ -0,0 +1,24 @@
+import { ref } from 'vue'
+import type { AgentTemplateDto } from '@/app/composables/workshop/useWorkshopApi'
+
+/**
+ * 编辑弹窗的开关 + "打开时携带的模板"(页面级编排状态)。
+ * 这里只留一个开关 + 一个 payload ref:表单回填与提交在 useAgentTemplateForm
+ * (由弹窗组件调用,回填挂在弹窗 open 的 watcher 上,同一帧渲染前完成)。
+ * 关闭时不清 payload(与拆分前的 editing 一样,留着上一次的值)。
+ */
+export function useAgentTemplateDialogState() {
+  const editOpen = ref(false)
+  const editing = ref<AgentTemplateDto | null>(null)
+
+  const openCreate = (): void => {
+    editing.value = null
+    editOpen.value = true
+  }
+  const openEdit = (t: AgentTemplateDto): void => {
+    editing.value = t
+    editOpen.value = true
+  }
+
+  return { editOpen, editing, openCreate, openEdit }
+}

package/app/pages/workshop/composables/useAgentTemplateForm.ts

@@ -0,0 +1,88 @@
+import { message } from 'ant-design-vue'
+import { reactive, watch, type Ref } from 'vue'
+import { useWorkshopApi, type AgentTemplateDto, type HarnessMetaDto } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 弹窗表单视图态(字段与拆分前 agents.vue 的 form 一致;harness 默认 mock) */
+export interface AgentTemplateFormState {
+  name: string
+  harness: string
+  configJson: string
+  visibility: 'private' | 'public'
+}
+
+/**
+ * 弹窗依赖:开关(与组件 v-model:open 是同一个 ref)+ 打开时携带的模板
+ * + 页面算好的 harness 派生数据(可用性/元信息,不在这里二次派生)+ 保存成功回调。
+ */
+export interface AgentTemplateFormOptions {
+  open: Ref<boolean>
+  editing: () => AgentTemplateDto | null
+  isUnavailable: (id: string) => boolean
+  harnessMeta: (id: string) => HarnessMetaDto | undefined
+  onSaved: () => void | Promise<void>
+}
+
+/**
+ * 「新建 / 编辑 Agent 模板」弹窗的表单与提交。
+ * 打开时的回填/重置挂在这个 composable 的 watcher 上(flush 默认是 pre:同一帧渲染前完成,
+ * 用户看到的时序与拆分前页面里 openCreate/openEdit 的同步赋值一致):
+ * 新建(editing = null)= 回默认;编辑 = 从模板回填 name/harness/configJson/visibility。
+ */
+export function useAgentTemplateForm(options: AgentTemplateFormOptions) {
+  const api = useWorkshopApi()
+  const { t: tt } = useI18n()
+
+  const form = reactive<AgentTemplateFormState>({ name: '', harness: 'mock', configJson: '{}', visibility: 'private' })
+
+  watch([() => options.open.value, () => options.editing()], () => {
+    if (!options.open.value) return
+    const tpl = options.editing()
+    if (!tpl) {
+      form.name = ''
+      form.harness = 'mock'
+      form.configJson = '{}'
+      form.visibility = 'private'
+      return
+    }
+    form.name = tpl.name
+    form.harness = tpl.harness
+    form.configJson = JSON.stringify(tpl.config ?? {}, null, 2)
+    form.visibility = tpl.visibility
+  })
+
+  const save = async (): Promise<void> => {
+    // 与拆分前一致:解析失败就 error + return;这里的初值 {} 在两条路径上都读不到,故不写
+    let config: Record<string, unknown>
+    try {
+      config = JSON.parse(form.configJson || '{}')
+    }
+    catch {
+      message.error(tt('agents.badConfigJson'))
+      return
+    }
+    // 前端兜底:引擎未安装禁止保存(与后端 assertHarnessUsable 同判据)
+    if (options.isUnavailable(form.harness)) {
+      message.error(options.harnessMeta(form.harness)?.error ?? tt('agents.notInstalled'))
+      return
+    }
+    try {
+      const tpl = options.editing()
+      if (tpl) {
+        await api.updateTemplate(tpl.id, { name: form.name, harness: form.harness, config, visibility: form.visibility })
+        message.success(tt('agents.k3n9aij020'))
+      }
+      else {
+        await api.createTemplate({ name: form.name, harness: form.harness, config, visibility: form.visibility })
+        message.success(tt('agents.k3n5hak021'))
+      }
+      options.open.value = false
+      void options.onSaved()
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+  }
+
+  return { form, save }
+}

package/app/pages/workshop/composables/useAgentTemplatesCatalog.ts

@@ -0,0 +1,92 @@
+import { computed, ref } from 'vue'
+import { useWorkshopApi, type AgentTemplateDto } from '@/app/composables/workshop/useWorkshopApi'
+import { useUserStore } from '@/app/stores/workshop/user'
+import { seedName } from '@/app/utils/builtin-catalog'
+
+/** 模板库筛选项:全部 / 我的 / 公开 / 内置(admin 另有"他人私有") */
+export type AgentTemplateFilter = 'all' | 'mine' | 'public' | 'builtin' | 'others'
+
+/** 筛选项(带计数的 label) */
+export interface AgentTemplateFilterOption {
+  value: AgentTemplateFilter
+  label: string
+}
+
+/** 可见性徽标(内置 = 锁 + 灰;公开 = 绿;私有 = 灰) */
+export interface AgentTemplateVisTag {
+  text: string
+  color: string
+  icon?: string
+}
+
+/**
+ * Agent 模板库目录 + 派生视图态(页面唯一副本):
+ *  · 模板清单(SSR 安全:仅客户端发请求)+ 载入态
+ *  · 筛选(全部/我的/公开/内置;admin 另有"他人私有")、计数、可写判定、可见性徽标
+ *  · 内置种子模板显示名(tplName)
+ * 行级写操作不在这里:见 useAgentTemplateActions;弹窗表单/提交见 useAgentTemplateForm。
+ */
+export function useAgentTemplatesCatalog() {
+  const api = useWorkshopApi()
+  const userStore = useUserStore()
+  const { t: tt } = useI18n()
+
+  /** 内置种子模板按稳定 id 翻译(服务端种子名是中文数据);自建/改名回退原名 */
+  const tplName = (r: { id: string, name: string }): string => seedName(tt, r)
+
+  const templates = ref<AgentTemplateDto[]>([])
+  const loading = ref(false)
+  const load = async (): Promise<void> => {
+    loading.value = true
+    try {
+      const res = await api.listTemplates()
+      templates.value = (res as unknown as { data?: AgentTemplateDto[] })?.data ?? []
+    }
+    finally {
+      loading.value = false
+    }
+  }
+  // SSR 安全:setup 期 $http(axios)无法在服务端发相对地址请求,拒绝会变成未处理
+  // rejection 直杀渲染进程;页面数据一律客户端装载
+  if (import.meta.client) void load()
+
+  // ===== 过滤(全部/我的/公开/内置;admin 另有"他人私有") =====
+  const filter = ref<AgentTemplateFilter>('all')
+  const filterOptions = computed<AgentTemplateFilterOption[]>(() => {
+    const opts: AgentTemplateFilterOption[] = [
+      { value: 'all', label: tt('chips.chipAll', { n: templates.value.length }) },
+      { value: 'mine', label: tt('chips.chipMine', { n: templates.value.filter(t => t.ownerUserId === userStore.user?.id).length }) },
+      { value: 'public', label: tt('chips.chipPublic', { n: templates.value.filter(t => t.visibility === 'public').length }) },
+      { value: 'builtin', label: tt('chips.chipBuiltin', { n: templates.value.filter(t => t.isBuiltin).length }) },
+    ]
+    if (userStore.isAdmin) {
+      opts.push({ value: 'others', label: tt('chips.chipOthers', { n: templates.value.filter(t => t.ownerUserId !== null && t.ownerUserId !== userStore.user?.id && t.visibility === 'private').length }) })
+    }
+    return opts
+  })
+  const shown = computed(() => {
+    const uid = userStore.user?.id
+    switch (filter.value) {
+      case 'mine': return templates.value.filter(t => t.ownerUserId === uid)
+      case 'public': return templates.value.filter(t => t.visibility === 'public')
+      case 'builtin': return templates.value.filter(t => t.isBuiltin)
+      case 'others': return templates.value.filter(t => t.ownerUserId !== null && t.ownerUserId !== uid && t.visibility === 'private')
+      default: return templates.value
+    }
+  })
+
+  // 写权限:属主或 admin;内置/他人公开模板只读
+  const canWrite = (t: AgentTemplateDto): boolean =>
+    !t.isBuiltin && (t.ownerUserId === userStore.user?.id || userStore.isAdmin)
+
+  const visTag = (t: AgentTemplateDto): AgentTemplateVisTag => {
+    if (t.isBuiltin) return { text: tt('agents.k3x23c017'), color: 'default', icon: 'i-tabler-lock' }
+    if (t.visibility === 'public') return { text: tt('agents.k3wv1t018'), color: 'green' }
+    return { text: tt('agents.k447jj019'), color: 'default' }
+  }
+
+  /** admin 全量视图提示条(页面工具栏右侧) */
+  const isAdmin = computed(() => userStore.isAdmin)
+
+  return { loading, load, tplName, filter, filterOptions, shown, canWrite, visTag, isAdmin }
+}

package/app/pages/workshop/composables/useTeamActions.ts

@@ -0,0 +1,44 @@
+import { message } from 'ant-design-vue'
+import { useWorkshopApi, type TeamDto } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 卡片即时写操作依赖:刷新编组目录(页面把 useTeamsCatalog().load 传进来) */
+export interface TeamActionsOptions {
+  reload: () => void | Promise<void>
+}
+
+/**
+ * 编组卡片上的即时写操作(不需要弹窗的三个):一键切换可见性 / 删除编组 / 移除成员。
+ * 成功后统一 reload 目录(与拆分前 void load() 同一条链路)。
+ * removeMember / removeTeam 拆分前就没有 catch —— 保持原样(统一由调用链路上层兜底),
+ * 只有 toggleVisibility 自带 message.error 分支。
+ */
+export function useTeamActions(options: TeamActionsOptions) {
+  const api = useWorkshopApi()
+  const { t } = useI18n()
+
+  /** 一键切换可见性(属主/admin) */
+  const toggleVisibility = async (team: TeamDto, pub: boolean): Promise<void> => {
+    try {
+      await api.updateTeam(team.id, { visibility: pub ? 'public' : 'private' })
+      message.success(pub ? t('teams.k1globhp023') : t('teams.k1xxabaf024'))
+      void options.reload()
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+  }
+
+  const removeMember = async (team: TeamDto, templateId: string): Promise<void> => {
+    await api.removeTeamMember(team.id, templateId)
+    void options.reload()
+  }
+
+  const removeTeam = async (team: TeamDto): Promise<void> => {
+    await api.deleteTeam(team.id)
+    message.success(t('teams.k1oxjrxx027'))
+    void options.reload()
+  }
+
+  return { toggleVisibility, removeMember, removeTeam }
+}

package/app/pages/workshop/composables/useTeamAddMemberDialog.ts

@@ -0,0 +1,49 @@
+import { ref, watch, type Ref } from 'vue'
+import { message } from 'ant-design-vue'
+import { useWorkshopApi } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 加入成员弹窗依赖:开关 + 当前编组 id(提交时才读)+ 成功后的刷新回调 */
+export interface TeamAddMemberDialogOptions {
+  open: Ref<boolean>
+  teamId: () => string | undefined
+  onAdded: () => void | Promise<void>
+}
+
+/**
+ * 「加入成员」弹窗状态:选成员模板 + 选角色(lead/worker)。
+ * 打开即回到初始态 —— 拆分前由页面 openAdd 同步重置,时序等价(watcher 在渲染前 flush,
+ * 弹窗可见时表单一定已是空的)。
+ */
+export function useTeamAddMemberDialog(options: TeamAddMemberDialogOptions) {
+  const api = useWorkshopApi()
+  const { t } = useI18n()
+
+  const addTemplateId = ref<string>('')
+  const addRole = ref<'lead' | 'worker'>('worker')
+
+  watch(options.open, (v) => {
+    if (!v) return
+    addTemplateId.value = ''
+    addRole.value = 'worker'
+  })
+
+  const submit = async (): Promise<void> => {
+    const teamId = options.teamId()
+    if (!teamId || !addTemplateId.value) {
+      message.warning(t('teams.k1kw4rtj025'))
+      return
+    }
+    try {
+      await api.addTeamMember(teamId, { agentId: addTemplateId.value, role: addRole.value })
+      message.success(t('teams.k3n5hzw026'))
+      options.open.value = false
+      void options.onAdded()
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+  }
+
+  return { addTemplateId, addRole, submit }
+}

package/app/pages/workshop/composables/useTeamCreateDialog.ts

@@ -0,0 +1,67 @@
+import { computed, reactive, ref, type Ref } from 'vue'
+import { message } from 'ant-design-vue'
+import { useWorkshopApi, type WorkshopPluginDto } from '@/app/composables/workshop/useWorkshopApi'
+
+/** 创建弹窗依赖:开关(与组件 v-model:open 是同一个 ref)+ 创建成功后的刷新回调 */
+export interface TeamCreateDialogOptions {
+  open: Ref<boolean>
+  onCreated: () => void | Promise<void>
+}
+
+/**
+ * 「新建 AgentTeam」弹窗状态:名称/描述/可见性 + 创建时勾选的插件开关。
+ * 表单不随打开重置 —— 拆分前只有创建成功才清空(失败留着让用户改),这里保持一致。
+ */
+export function useTeamCreateDialog(options: TeamCreateDialogOptions) {
+  const api = useWorkshopApi()
+  const { t } = useI18n()
+
+  const createForm = reactive({ name: '', description: '', visibility: 'private' as 'private' | 'public' })
+
+  // ===== 插件(创建时勾选启用哪些;平台清单中 enabled 的插件,默认全选) =====
+  const platformPlugins = ref<WorkshopPluginDto[]>([])
+  const createPluginSel = ref<Record<string, boolean>>({})
+  const loadPlatformPlugins = async (): Promise<void> => {
+    try {
+      const res = await api.listPlugins()
+      // 顶层 plugins key(非信封);兼容 {code,data} 信封;只取平台已启用的插件
+      const list = res?.plugins ?? (res as { data?: { plugins?: WorkshopPluginDto[] } })?.data?.plugins ?? []
+      const enabled = (Array.isArray(list) ? list : []).filter(p => p.enabled !== false)
+      platformPlugins.value = enabled
+      const sel: Record<string, boolean> = {}
+      for (const p of enabled) sel[p.name] = true
+      createPluginSel.value = sel
+    }
+    catch { /* 清单不可得时隐藏插件多选(创建仍可走默认) */ }
+  }
+  if (import.meta.client) void loadPlatformPlugins()
+
+  /** checkbox-group 双向绑定(勾选集 ↔ plugins 开关视图) */
+  const pluginChecked = computed({
+    get: () => Object.entries(createPluginSel.value).filter(([, v]) => v).map(([k]) => k),
+    set: (vals: Array<string>) => {
+      const next: Record<string, boolean> = {}
+      for (const p of platformPlugins.value) next[p.name] = vals.includes(p.name)
+      createPluginSel.value = next
+    },
+  })
+
+  const submit = async (): Promise<void> => {
+    if (!createForm.name.trim()) {
+      message.warning(t('teams.k1bvcdo2021'))
+      return
+    }
+    // 勾选结果作为 plugins:[{name,enabled}] 附加(后端创建时写入该团队的插件开关)
+    const plugins = Object.entries(createPluginSel.value).map(([name, enabled]) => ({ name, enabled }))
+    await api.createTeam({ name: createForm.name.trim(), description: createForm.description || undefined, visibility: createForm.visibility, plugins })
+    message.success(t('teams.k3n5hak022'))
+    options.open.value = false
+    createForm.name = ''
+    createForm.description = ''
+    createForm.visibility = 'private'
+    createPluginSel.value = Object.fromEntries(Object.entries(createPluginSel.value).map(([k]) => [k, true]))
+    void options.onCreated()
+  }
+
+  return { createForm, platformPlugins, pluginChecked, submit }
+}

package/app/pages/workshop/composables/useTeamDeployDialog.ts

@@ -0,0 +1,49 @@
+import { ref, watch, type Ref } from 'vue'
+import { message } from 'ant-design-vue'
+import { useWorkshopApi } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 部署弹窗依赖:开关 + 当前编组 id(提交时才读) */
+export interface TeamDeployDialogOptions {
+  open: Ref<boolean>
+  teamId: () => string | undefined
+}
+
+/**
+ * 「部署到 Channel」弹窗状态:目标 Channel + confirm-loading。
+ * 打开即清空目标选择;成功后关闭且**不刷新编组目录** —— 拆分前的 deploy 也不 reload。
+ */
+export function useTeamDeployDialog(options: TeamDeployDialogOptions) {
+  const api = useWorkshopApi()
+  const { t } = useI18n()
+
+  const deployChannelId = ref<string>('')
+  const deploying = ref(false)
+
+  watch(options.open, (v) => {
+    if (v) deployChannelId.value = ''
+  })
+
+  const submit = async (): Promise<void> => {
+    const teamId = options.teamId()
+    if (!teamId || !deployChannelId.value) {
+      message.warning(t('teams.selectChannel'))
+      return
+    }
+    deploying.value = true
+    try {
+      const res = await api.deployTeam(teamId, deployChannelId.value)
+      const agents = (res as unknown as { data?: { agents?: unknown[] } })?.data?.agents?.length ?? 0
+      message.success(t('teams.kh90glh031', { p0: agents }))
+      options.open.value = false
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+    finally {
+      deploying.value = false
+    }
+  }
+
+  return { deployChannelId, deploying, submit }
+}

package/app/pages/workshop/composables/useTeamDialogState.ts

@@ -0,0 +1,46 @@
+import { ref } from 'vue'
+import type { TeamDto } from '@/app/composables/workshop/useWorkshopApi'
+
+/**
+ * 四个弹窗的开关 + "打开时携带的编组"(页面级编排状态)。
+ * 载入/提交逻辑在各自的 useTeam*Dialog;这里只留一个开关 + 一个 payload ref,
+ * 点击卡片到弹窗出现的时序与拆分前一致(同步写入,不经过 watcher)。
+ * 关闭时不清 payload(与拆分前的 addTeam/addTeamRef/plugTeamRef 一样,留着上一次的值)。
+ */
+export function useTeamDialogState() {
+  const createOpen = ref(false)
+
+  const addOpen = ref(false)
+  const addTeam = ref<TeamDto | null>(null)
+  const openAdd = (team: TeamDto): void => {
+    addTeam.value = team
+    addOpen.value = true
+  }
+
+  const deployOpen = ref(false)
+  const deployTeam = ref<TeamDto | null>(null)
+  const openDeploy = (team: TeamDto): void => {
+    deployTeam.value = team
+    deployOpen.value = true
+  }
+
+  const plugOpen = ref(false)
+  const plugTeam = ref<TeamDto | null>(null)
+  const openPlugins = (team: TeamDto): void => {
+    plugTeam.value = team
+    plugOpen.value = true
+  }
+
+  return {
+    createOpen,
+    addOpen,
+    addTeam,
+    openAdd,
+    deployOpen,
+    deployTeam,
+    openDeploy,
+    plugOpen,
+    plugTeam,
+    openPlugins,
+  }
+}

package/app/pages/workshop/composables/useTeamPluginDialog.ts

@@ -0,0 +1,72 @@
+import { ref, watch, type Ref } from 'vue'
+import { message } from 'ant-design-vue'
+import { useWorkshopApi, type ChannelPluginStateDto } from '@/app/composables/workshop/useWorkshopApi'
+import { apiErrorMessage } from '@/app/utils/api-error'
+
+/** 团队插件弹层依赖:开关 + 当前编组 id(打开时才读) */
+export interface TeamPluginDialogOptions {
+  open: Ref<boolean>
+  teamId: () => string | undefined
+}
+
+/**
+ * 团队级插件开关(GET → 展示各插件开关;切换即 PUT)。
+ * 打开即清空为"未加载"并拉取该编组的开关视图(source=default 表示未显式配置,默认全启用);
+ * 重置同样发生在渲染前(拆分前由页面 openPlugins 同步重置)。
+ */
+export function useTeamPluginDialog(options: TeamPluginDialogOptions) {
+  const api = useWorkshopApi()
+  const { t } = useI18n()
+
+  const rows = ref<ChannelPluginStateDto[]>([])
+  const source = ref<'explicit' | 'default'>('default')
+  const loading = ref(false)
+  const saving = ref<string | null>(null)
+
+  const load = async (teamId: string): Promise<void> => {
+    loading.value = true
+    try {
+      const res = await api.listTeamPlugins(teamId)
+      const data = res?.data ?? {}
+      rows.value = data.plugins ?? []
+      source.value = data.source === 'explicit' ? 'explicit' : 'default'
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  watch(options.open, (v) => {
+    if (!v) return
+    rows.value = []
+    source.value = 'default'
+    const teamId = options.teamId()
+    if (teamId) void load(teamId)
+  })
+
+  const toggle = async (row: ChannelPluginStateDto, next: boolean): Promise<void> => {
+    const teamId = options.teamId()
+    if (!teamId || saving.value) return
+    saving.value = row.name
+    try {
+      // PUT 全量提交当前开关视图(仅翻转目标行)
+      const payload = rows.value.map(r => ({ name: r.name, enabled: r.name === row.name ? next : r.enabled }))
+      const res = await api.putTeamPlugins(teamId, { plugins: payload })
+      const data = res?.data ?? {}
+      rows.value = data.plugins ?? payload.map(p => ({ ...p }))
+      source.value = data.source === 'explicit' ? 'explicit' : 'default'
+      message.success(t('teams.k1plugon043'))
+    }
+    catch (e) {
+      message.error(apiErrorMessage(e))
+    }
+    finally {
+      saving.value = null
+    }
+  }
+
+  return { rows, source, loading, saving, toggle }
+}