agentworkshop 0.7.51 → 0.7.53

package/app/composables/useCodeCopy.ts

@@ -2,9 +2,23 @@
  * 代码块复制(事件委托单例):mdLite 渲染的 `.code-copy` 按钮点击 →
  * 复制同块 <pre><code> 文本 → 按钮瞬时"已复制"反馈。
  * document 级监听,时间线/lanes/抽屉内任意代码块通用,重复调用幂等。
+ * 注意:本函数可能在组件 setup 之外被调用,不能使用 useI18n() ——
+ * 经全局 i18n 实例在点击时懒取文案(同时保证切换语言后取到新值)。
  */
 let installed = false
 
+type GlobalI18n = { global: { t: (key: string) => string } }
+
+function i18nT(key: string): string {
+  try {
+    const g = useNuxtApp().$i18n as unknown as GlobalI18n | undefined
+    return g?.global.t(key) ?? key
+  }
+  catch {
+    return key
+  }
+}
+
 export function useCodeCopy(): void {
   if (installed || typeof document === 'undefined') return
   installed = true
@@ -15,9 +29,9 @@ export function useCodeCopy(): void {
     const code = block?.querySelector('pre code')?.textContent ?? ''
     const done = (): void => {
       const prev = btn.textContent
-      btn.textContent = '已复制'
+      btn.textContent = i18nT('common.copied')
       setTimeout(() => {
-        btn.textContent = prev ?? '复制'
+        btn.textContent = prev ?? i18nT('common.copy')
       }, 1400)
     }
     if (navigator.clipboard?.writeText) {

package/app/composables/workshop/useWorkshopApi.ts

@@ -19,6 +19,8 @@ export interface ChannelDto {
   ownerUserId?: string | null
   /** v16 定时标志:该 channel 启用的定时计划数(>0 前端显示「定时」标签) */
   scheduledCount?: number
+  /** v18 绑定产线(空/缺省=未绑定;只读扩权:成员可读该线日志/配方/历史/状态) */
+  lineId?: string
   createdAt: string
   updatedAt: string
 }
@@ -130,6 +132,11 @@ export function useWorkshopApi() {
     /** 修改 Channel 实例设置(场景 prompt / 工作目录热更新;成员运行时自动回收重装配) */
     patchChannel: (id: string, body: { name?: string, description?: string, scenarioPrompt?: string, workspace?: string, enabled?: number, llm?: { provider?: string, model?: string, effort?: string } | null }) =>
       http.request<{ data: ChannelDto }>({ method: 'PATCH', url: `/workshop/channels/${id}`, data: body }),
+    /** v18 绑定/解绑产线(lineId=null = 解绑;只读扩权,成员运行时自动回收) */
+    bindChannelLine: (id: string, lineId: string | null) =>
+      http.request<{ data: { ok: boolean, lineId: string } }>({ method: 'PUT', url: `/workshop/channels/${id}/line`, data: { lineId } }),
+    /** 产线清单(绑线选择器数据源) */
+    listDcwLines: () => http.get<{ data: { lines: Array<{ id: string, name: string, state?: string }> } }>('/workshop/dcw/lines?limit=200'),
     // channel agents
     listChannelAgents: (id: string) => http.get<{ data: AgentInfoDto[] }>(`/workshop/channels/${id}/agents`),
     addChannelAgent: (id: string, body: { agentId?: string, name?: string, harness?: string, role?: 'lead' | 'worker', config?: Record<string, unknown> }) =>
@@ -213,8 +220,8 @@ export function useWorkshopApi() {
     updateChannelTemplate: (id: string, body: { name?: string, description?: string, scenarioPrompt?: string, workspace?: string, visibility?: 'private' | 'public' }) =>
       http.request<{ data: ChannelTemplateDto }>({ method: 'PATCH', url: `/workshop/channel-templates/${id}`, data: body }),
     deleteChannelTemplate: (id: string) => http.delete<{ data: unknown }>(`/workshop/channel-templates/${id}`),
-    instantiateChannelTemplate: (id: string, name?: string) =>
-      http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/channel-templates/${id}/instantiate`, { name }),
+    instantiateChannelTemplate: (id: string, name?: string, options?: { enableKnowledgeBase?: boolean }) =>
+      http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/channel-templates/${id}/instantiate`, { name, ...options }),
     /** 从 Channel 模板实例化并挂载到 workspace(替代"挂载已有 Channel") */
     mountChannelTemplate: (wsId: string, tplId: string, name?: string) =>
       http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/workspaces/${wsId}/channel-templates/${tplId}`, { name }),
@@ -329,6 +336,8 @@ export interface ChannelTemplateDto {
   isBuiltin: boolean
   ownerUserId: string | null
   ownerName?: string | null
+  /** 模板支持「知识库集成」选项(实例化时可启停 rag-bridge 插件) */
+  knowledgeBaseCapable?: boolean
   createdAt: string
   updatedAt: string
 }

package/app/pages/workshop/channel-templates.vue

@@ -128,12 +128,28 @@ const toggleVisibility = async (t: ChannelTemplateDto, pub: boolean): Promise<vo
   }
 }
 
-/** 实例化(不挂载;工作区内挂载走会话栏) */
+/** 实例化(不挂载;工作区内挂载走会话栏):KB-capable 模板先弹确认,可启停知识库集成 */
 const instantiating = ref<string | null>(null)
-const instantiate = async (t: ChannelTemplateDto): Promise<void> => {
+const instOpen = ref(false)
+const instTarget = ref<ChannelTemplateDto | null>(null)
+const instKb = ref(true)
+const openInstantiate = (t: ChannelTemplateDto): void => {
+  instTarget.value = t
+  instKb.value = true
+  if (!t.knowledgeBaseCapable) {
+    void confirmInstantiate()
+    return
+  }
+  instOpen.value = true
+}
+const confirmInstantiate = async (): Promise<void> => {
+  const t = instTarget.value
+  if (!t) return
   instantiating.value = t.id
+  instOpen.value = false
   try {
-    const res = await api.instantiateChannelTemplate(t.id)
+    const options = t.knowledgeBaseCapable ? { enableKnowledgeBase: instKb.value } : undefined
+    const res = await api.instantiateChannelTemplate(t.id, undefined, options)
     const data = (res as unknown as { data?: { channelId: string, agentCount: number } })?.data
     message.success(tt('ctpl.kefkfnl030', { p0: t.name, p1: data?.agentCount ?? 0 }))
   }
@@ -277,7 +293,7 @@ useHead({ title: () => tt('titles.ctpl') })
               ghost
               :loading="instantiating === t.id"
               :title="$t('ctpl.knjomku002')"
-              @click="instantiate(t)"
+              @click="openInstantiate(t)"
             >
               {{ $t('ctpl.k3mr1fo017') }}
             </a-button>
@@ -348,11 +364,34 @@ useHead({ title: () => tt('titles.ctpl') })
         </a-form-item>
       </a-form>
     </a-modal>
+
+    <a-modal
+      v-model:open="instOpen"
+      :title="tt('ctpl.kbInstTitle', { p0: instTarget?.name ?? '' })"
+      :ok-text="$t('ctpl.k3mr1fo017')"
+      :cancel-text="$t('common.cancel')"
+      :confirm-loading="instantiating === instTarget?.id"
+      @ok="confirmInstantiate"
+    >
+      <a-form layout="vertical">
+        <a-form-item :label="$t('ctpl.kbOption')">
+          <a-switch
+            v-model:checked="instKb"
+            :checked-children="$t('ctpl.kbOn')"
+            :un-checked-children="$t('ctpl.kbOff')"
+          />
+        </a-form-item>
+        <p class="kb-hint">
+          {{ $t('ctpl.kbHint') }}
+        </p>
+      </a-form>
+    </a-modal>
   </div>
 </template>
 
 <style scoped>
 .page { padding: 4px; }
+.kb-hint { margin: 0; font-size: 12px; opacity: 0.6; line-height: 1.6; }
 .head {
   display: flex;
   align-items: center;

package/app/stores/workshop/notifications.ts

@@ -148,7 +148,7 @@ export const useNotificationsStore = defineStore('workshop.notifications', () =>
     unreadCount.value = items.value.filter(n => !n.readAt).length
   }
 
-  /** 抓取一页通知(cursor 为空 = 最新一页) */
+  /** 已抓取一页通知(cursor 为空 = 最新一页) */
   async function fetchPage(c: NotificationCursor | null): Promise<{ notifications: AepNotification[], unreadCount: number, nextCursor: NotificationCursor | null }> {
     const token = useUserStore().token
     const query: Record<string, string> = { limit: String(PAGE_LIMIT) }
@@ -162,10 +162,35 @@ export const useNotificationsStore = defineStore('workshop.notifications', () =>
     return res.data
   }
 
+  /**
+   * 拉取护栏(防紧循环):进行中请求去重 + **按尝试时刻**限速 2s(成败都算尝试)。
+   * 网络抖动/代理断连/429 时,重连补拉与快照可能被高频重复触发 —— 无护栏会把
+   * HTTP 限流配额(按 IP 计)吃满并自持(429→立即重试→再 429),殃及同源其他请求
+   * (实测 397 次/短窗 → 全站 429)。失败也推进节拍,保证窗口必然滚过、必然恢复。
+   */
+  let inflightFetch: Promise<void> | null = null
+  let lastAttemptAt = 0
+  const FETCH_MIN_GAP_MS = 2000
+  async function guardedFetch(fn: () => Promise<void>): Promise<void> {
+    if (inflightFetch) return inflightFetch
+    const wait = FETCH_MIN_GAP_MS - (Date.now() - lastAttemptAt)
+    if (wait > 0) await new Promise(r => setTimeout(r, wait))
+    lastAttemptAt = Date.now()
+    inflightFetch = (async () => {
+      try {
+        await fn()
+      }
+      finally {
+        inflightFetch = null
+      }
+    })()
+    return inflightFetch
+  }
+
   /** 首屏/刷新快照:替换式(以 DB 为准收敛 WS 期间的可能漂移) */
   async function loadSnapshot(): Promise<void> {
     if (typeof window === 'undefined' || !useUserStore().token) return
-    try {
+    await guardedFetch(async () => {
       const data = await fetchPage(null)
       items.value = [...(data.notifications ?? [])]
       for (const n of items.value) markSeen(n.eventId)
@@ -174,10 +199,9 @@ export const useNotificationsStore = defineStore('workshop.notifications', () =>
       const newest = items.value[0]
       cursor.value = newest ? { createdAt: newest.createdAt, id: newest.id } : null
       loaded.value = true
-    }
-    catch {
+    }).catch(() => {
       // 快照失败不阻塞实时帧(下一帧照常入库)
-    }
+    })
   }
 
   /**
@@ -197,19 +221,21 @@ export const useNotificationsStore = defineStore('workshop.notifications', () =>
     }
     let added = 0
     try {
-      for (let page = 0; page < MAX_BACKFILL_PAGES; page += 1) {
-        const data = await fetchPage(cursor.value)
-        const list = data.notifications ?? []
-        for (const n of list) {
-          if (upsertNotification(n)) added += 1
+      await guardedFetch(async () => {
+        for (let page = 0; page < MAX_BACKFILL_PAGES; page += 1) {
+          const data = await fetchPage(cursor.value)
+          const list = data.notifications ?? []
+          for (const n of list) {
+            if (upsertNotification(n)) added += 1
+          }
+          if (data.nextCursor) cursor.value = data.nextCursor
+          unreadCount.value = data.unreadCount ?? unreadCount.value
+          // 不满一页 = 已到最新,收工;满页可能还有,继续拉
+          if (list.length < PAGE_LIMIT) return
+          // 服务端没给新游标却又是满页 → 无法继续推进,退出防死循环
+          if (!data.nextCursor) return
         }
-        if (data.nextCursor) cursor.value = data.nextCursor
-        unreadCount.value = data.unreadCount ?? unreadCount.value
-        // 不满一页 = 已到最新,收工;满页可能还有,继续拉
-        if (list.length < PAGE_LIMIT) return added
-        // 服务端没给新游标却又是满页 → 无法继续推进,退出防死循环
-        if (!data.nextCursor) return added
-      }
+      })
       return added
     }
     catch {

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.51
+  version: 0.7.52
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/docs/cli.en.md

@@ -62,7 +62,7 @@ pnpm tui             # the terminal workbench
 ### 3. Quick use via npx (no global install)
 
 ```bash
-npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.51 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.52 start)
 npx agentworkshop doctor           # subcommands work as usual
 npx -p agentworkshop aw doctor     # use -p when you want the name aw
 ```
@@ -79,7 +79,7 @@ npx -p agentworkshop aw doctor     # use -p when you want the name aw
 | Package manager | `pnpm@11.9.0` (`packageManager`, needed only for source development) |
 | Module format | ESM (`type: module`) |
 | License | `PolyForm-Noncommercial-1.0.0` |
-| Current version | `0.7.51` (`package.json`) |
+| Current version | `0.7.52` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 
@@ -167,7 +167,7 @@ are never overwritten:
 - Precedence (the CLI, the web settings page and the dev/prod launch scripts all share one engine,
   `shared/config/engine.mjs`):
   `config.yml defaults < runtime-settings.json runtime overrides < environment variables / explicit CLI flags`.
-- There are **113 setting descriptors across 18 groups** (`aw config list` prints exactly 113 rows):
+- There are **115 setting descriptors across 18 groups** (`aw config list` prints exactly 113 rows):
 
 | Group | Count | Group | Count | Group | Count | Group | Count |
 |---|---|---|---|---|---|---|---|

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.51 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.52 start)
 npx agentworkshop doctor           # 子命令照常可用
 npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 ```
@@ -76,7 +76,7 @@ npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 | 包管理器 | `pnpm@11.9.0`（`packageManager`，仅源码开发需要） |
 | 模块形态 | ESM（`type: module`） |
 | 许可证 | `PolyForm-Noncommercial-1.0.0` |
-| 当前版本 | `0.7.51`（`package.json`） |
+| 当前版本 | `0.7.52`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 

package/docs/plugins.en.md

@@ -9,7 +9,7 @@
 >
 > Applies to: plugin system v2 has been available since **v0.7.29** (frontend component
 > injection / plugin settings / plugin i18n / runtime services surface); this document
-> describes **v0.7.51**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.52**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.7.51**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.7.52**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 

package/docs/sdk.en.md

@@ -7,7 +7,7 @@
 
 **SDK version constants**: server-side `SDK_VERSION = '0.3.0'`, browser-side `CLIENT_SDK_VERSION = '0.3.0'`.
 These two constants are the **interface version of the SDK itself** and evolve **independently**
-from the npm package version (the `version` field in `package.json`, currently 0.7.51) —
+from the npm package version (the `version` field in `package.json`, currently 0.7.52) —
 them being out of sync is expected. Never use `SDK_VERSION` to infer the package version, or the reverse.
 **Module format**: ESM only (only `import` / `export`; there is no CJS entry).
 **Types**: `sdk/index.d.mts` and `sdk/client.d.mts` ship with the package, so TypeScript projects

package/docs/sdk.md

@@ -5,7 +5,7 @@
 > 零第三方运行时依赖,Node ≥ 23.4 与现代浏览器双端可用。
 
 **SDK 版本常量**:服务端 `SDK_VERSION = '0.3.0'`,浏览器端 `CLIENT_SDK_VERSION = '0.3.0'`。
-这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.51)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.52)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。