aitable-workflow-cli 0.1.23 → 0.1.24

package/templates/support-qa/workflows/admin-kb-update/recipes/kb-refine.recipe.ts

@@ -1,137 +0,0 @@
-import { z } from "zod";
-import { type RecipeDefinition, type RecipeContext, type RecipeResult } from "aitable-workflow-core";
-import { KB_STATUS, resolveCurationTarget, DEFAULT_CURATION_TARGET } from "../../../lib/contract.js";
-
-/**
- * 知识提炼并写入本地知识库（管理员知识更新流的唯一步骤）
- *
- * 输入来自 kb_sync_handler 建的工单：原问题(question) + 对话上下文(context) + 管理员结论(adminUpdate)。
- * 流程：coding agent 依据三者【提炼】出要追加的 Markdown 结论（只输出结论正文，不决定写哪个文件），
- * 再由本 recipe 用 file toolkit 确定性追加到固定目标文件（config.kb_file，缺省 FAQ.md，jail 在 base_dir 内），
- * ~60s 自动重编生效。kb_file 规则收口在 contract.resolveCurationTarget（与 assemble 定点回写共用，
- * 评审 P1）：不自动补扩展名、不静默回退，显式非法配置直接 failed。
- *
- * 不发群消息（本流无 reply 步骤）。提炼规范见执行 workspace 下的 AGENTS.md（CLI 自动读取）。
- */
-
-/** 从 agent 响应中取出要追加的正文：剥离可能的 ``` 代码块围栏，其余原样 */
-function extractContent(raw: string): string {
-  if (!raw) return "";
-  const s = raw.trim();
-  const fence = s.match(/```(?:markdown|md)?\s*([\s\S]*?)```/i);
-  return (fence?.[1] ?? s).trim();
-}
-
-const recipe: RecipeDefinition = {
-  meta: {
-    id: "kb_refine",
-    name: "提炼并写入知识库",
-    role: "kb-editor",
-    description: "coding agent 依据问答与管理员结论提炼要追加的结论，file toolkit 写入本地知识库",
-    version: "1.0.0",
-    requiresAgent: true,
-    timeoutMs: 180_000,
-    config: z.object({
-      coding: z.object({ engine: z.string().optional() }).optional(),
-      file: z.object({ base_dir: z.string().optional() }).optional(),
-      kb_file: z.string().optional().describe(`追加目标 .md 文件（相对 file.base_dir），缺省 ${DEFAULT_CURATION_TARGET}`),
-    }),
-  },
-
-  async execute(ctx: RecipeContext): Promise<RecipeResult> {
-    const { input, toolkit, config, log } = ctx;
-    const adminUpdate = String(input.adminUpdate ?? "").trim();
-    const question = String(input.question ?? "").trim();
-    const context = String(input.context ?? "").trim();
-    const srcBaseId = String(input.srcBaseId ?? "").trim();
-    const srcTableId = String(input.srcTableId ?? "").trim();
-    const srcRecordId = String(input.srcRecordId ?? "").trim();
-    // 与 assemble 定点回写同源的目标文件规则（评审 P1）：显式非法配置是配置错误而非瞬时故障，
-    // 直接 failed 暴露（不自动修正到另一个文件，避免与 profile/workflow 声明值分家）
-    const kbTarget = resolveCurationTarget(config.kb_file);
-    if (kbTarget.error) {
-      log(`kb_file 配置非法，阻断写入: ${kbTarget.error}`);
-      return { status: "failed", output: { kb_synced: "失败" }, error: `kb_refine: ${kbTarget.error}`, logs: ["kb_file 配置非法 → failed（请修正 profile/workflow 配置）"] };
-    }
-    const kbFile = kbTarget.value;
-
-    if (!adminUpdate) {
-      // 空更新是数据问题而非瞬时故障，重试无益 → 保持 success 终态留痕
-      log("管理员更新为空，跳过（本流工单应始终带管理员更新）");
-      return { status: "success", output: { kb_synced: "失败" }, logs: ["管理员更新为空 → 跳过"] };
-    }
-
-    const prompt = `请把「管理员的权威结论」提炼成一条规范、可检索的知识库 FAQ 条目，并【只输出要追加到知识库的结论正文】。
-
-## 素材
-### 原始问题
-${question || "（未提供）"}
-### 对话上下文
-${context || "（无）"}
-### 管理员结论（权威依据，以此为准）
-${adminUpdate}
-
-## 输出要求
-- 只输出要追加的 Markdown 结论正文本身（形如 "## 问题\\n\\n答案"）；简洁、准确、可检索。
-- 不要输出目标文件名、不要输出 JSON、不要任何前后缀说明或代码块包裹。
-详细提炼规范见本工作目录下的 AGENTS.md。`;
-
-    // 执行 workspace（含该角色 AGENTS.md）由 coding toolkit 按角色自动准备，recipe 无需关心 workDir。
-    log(`kb_refine 调 coding agent 提炼: ${(question || adminUpdate).slice(0, 40)}`);
-    const result = await toolkit.coding.run(prompt);
-
-    // 以下三类失败均返回 status: "failed"（评审 P1）：触发引擎按 max_step_failures 重试；
-    // 重试耗尽后源行仍是「待沉淀」，handler 内存 seen 过期/重启后会重新建单——
-    // 收敛唯一锚点是成功回写「已沉淀」，知识更新不会因一次失败永久卡死。
-    if (!result.response) {
-      log("coding agent 无有效响应，标记失败（可重试）");
-      return { status: "failed", output: { kb_synced: "失败" }, error: "kb_refine: coding agent 无有效响应", logs: ["agent 无响应 → failed(可重试)"] };
-    }
-
-    const content = extractContent(result.response);
-    if (!content) {
-      log("提炼结果为空，标记失败（可重试）");
-      return {
-        status: "failed",
-        output: { kb_synced: "失败" },
-        error: "kb_refine: 提炼结果为空",
-        logs: ["提炼内容为空 → failed(可重试)", `原始: ${result.response.slice(0, 120)}`],
-      };
-    }
-
-    try {
-      await toolkit.file.append({ path: kbFile, content: `\n\n${content}\n` });
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error);
-      log(`写入知识库失败: ${kbFile} — ${msg}`);
-      return { status: "failed", output: { kb_synced: "失败" }, error: `kb_refine: 写入知识库失败 ${msg}`, logs: ["file.append 失败 → failed(可重试)"] };
-    }
-
-    const title = content.split("\n").find((l) => l.trim())?.replace(/^#+\s*/, "").slice(0, 40) ?? "";
-    log(`已追加到知识库: ${kbFile}（${content.length} 字，${title}）`);
-
-    // 回写 group-qa 源行「知识沉淀=已沉淀」，使事件源过滤集收敛（不再重复拉取该行）。
-    // 幂等：仅成功路径回写；失败只 log 不阻断，下轮源行仍为「待沉淀」会自动重试。
-    if (srcBaseId && srcTableId && srcRecordId) {
-      try {
-        await toolkit.table.updateRecordIn(
-          { baseId: srcBaseId, tableId: srcTableId },
-          srcRecordId,
-          { "知识沉淀": KB_STATUS.PERSISTED },
-        );
-        log(`已回写源行 ${srcRecordId} 知识沉淀=已沉淀`);
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        log(`回写源行知识沉淀失败（不阻断，下轮重试）: ${srcRecordId} — ${msg}`);
-      }
-    }
-
-    return {
-      status: "success",
-      output: { kb_synced: "已同步", kb_article: kbFile },
-      logs: [`已写入 ${kbFile}`, "答疑侧直接读取原文，追加即生效"],
-    };
-  },
-};
-
-export default recipe;

package/templates/support-qa/workflows/admin-kb-update/recipes/kb_sync_handler.recipe.ts

@@ -1,119 +0,0 @@
-import { createHash } from "node:crypto";
-import { z } from "zod";
-import type {
-  EventHandlerRecipeDefinition,
-  HandlerInitContext,
-  HandlerInstance,
-} from "aitable-workflow-core";
-
-/**
- * 管理员知识更新 — 事件过滤 + 去重 + 建单（dumb handler，不碰 toolkit）
- *
- * aitable_record 源监听「群问答表」（filter: 知识沉淀=待沉淀），产出 record_created/record_updated。
- * 本 handler 只做三件事：
- *   1. 过滤：只处理「管理员更新」列非空的行；
- *   2. 去重：按 hash(recordId + 管理员更新内容) 做**进程内存 + TTL** 抑制——
- *      只防同进程短窗口内的重复建单（同一行反复触发事件/emit_existing 首轮重放）；
- *      **故意不持久化**：收敛的唯一锚点是 kb_refine 成功后回写源行「知识沉淀=已沉淀」
- *      （事件源过滤集随之收敛）。若 kb_refine 失败（返回 failed → 引擎按 max_step_failures
- *      重试），源行仍是「待沉淀」，进程重启/TTL 过期后 emit_existing 会重放建单，
- *      天然构成失败恢复通道——持久 seen 会把失败行永久卡死（评审 P1）。
- *   3. 建单：把 消息内容/对话上下文/管理员更新 复制进【本流】的知识更新表，
- *      交给 kb_refine 步骤用 coding agent 提炼后写库。
- */
-
-const SEEN_TTL_MS = 30 * 60 * 1000; // 覆盖 refine 执行 + 引擎重试窗口即可，无需更长
-const SEEN_CAPACITY = 1000;
-
-/** 把 aitable cell 值稳健地转成纯文本（兼容 string / number / {text}/{value} / 数组） */
-function cellToString(value: unknown): string {
-  if (value == null) return "";
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (Array.isArray(value)) return value.map(cellToString).filter(Boolean).join("\n");
-  if (typeof value === "object") {
-    const rec = value as Record<string, unknown>;
-    if (typeof rec.text === "string") return rec.text;
-    if (typeof rec.value === "string") return rec.value;
-    if (typeof rec.name === "string") return rec.name;
-  }
-  return "";
-}
-
-const recipe: EventHandlerRecipeDefinition = {
-  meta: {
-    id: "kb_sync_handler",
-    name: "管理员知识更新过滤器",
-    description: "过滤群问答表「管理员更新」列非空的行，短窗口去重后建知识更新工单（交给 kb_refine 提炼写库）",
-    config: z.object({
-      admin_field: z.string().optional().describe("管理员填结论的列名，默认「管理员更新」"),
-      question_field: z.string().optional().describe("原问题列名，默认「消息内容」"),
-      context_field: z.string().optional().describe("对话上下文列名，默认「对话上下文」"),
-    }),
-  },
-
-  create(ctx: HandlerInitContext): HandlerInstance {
-    const adminField = String(ctx.config.admin_field ?? "管理员更新");
-    const questionField = String(ctx.config.question_field ?? "消息内容");
-    const contextField = String(ctx.config.context_field ?? "对话上下文");
-    // 进程内存去重（key → 首见时间）；重启即清空（见文件头注释：这是特性不是缺陷）
-    const seen = new Map<string, number>();
-
-    function seenRecently(key: string): boolean {
-      const now = Date.now();
-      const at = seen.get(key);
-      if (at !== undefined && now - at <= SEEN_TTL_MS) return true;
-      seen.set(key, now);
-      // 容量/TTL 裁剪
-      if (seen.size > SEEN_CAPACITY) {
-        for (const [k, ts] of seen) {
-          if (now - ts > SEEN_TTL_MS) seen.delete(k);
-          if (seen.size <= SEEN_CAPACITY) break;
-        }
-      }
-      return false;
-    }
-
-    return {
-      onEvent(event) {
-        const cells = (event.payload?.cells ?? {}) as Record<string, unknown>;
-        const admin = cellToString(cells[adminField]).trim();
-        if (!admin) return; // 绝大多数群问答字段变更事件在此快速返回
-
-        const recordId = String(event.itemId ?? "");
-        const key = createHash("sha1").update(`${recordId}\u0000${admin}`).digest("hex");
-        if (seenRecently(key)) {
-          ctx.log(`管理员更新短窗口内已建单（seen TTL 命中），跳过: ${recordId}`);
-          return;
-        }
-
-        const question = cellToString(cells[questionField]).trim();
-        const context = cellToString(cells[contextField]).trim();
-
-        // 源行坐标：供 kb_refine 处理完回写 group-qa 源行「知识沉淀=已沉淀」，使拉取集收敛。
-        const payload = (event.payload ?? {}) as Record<string, unknown>;
-        const srcBaseId = typeof payload.baseId === "string" ? payload.baseId : "";
-        const srcTableId = typeof payload.tableId === "string" ? payload.tableId : "";
-
-        ctx.log(`捕获管理员更新（源行 ${recordId}），建知识更新工单`);
-        ctx.pushEvent({
-          action: "create_record",
-          fields: {
-            "标题": `知识更新: ${(question || admin).slice(0, 20)}`,
-            "消息内容": question,
-            "对话上下文": context,
-            "管理员更新": admin,
-            "源表BaseId": srcBaseId,
-            "源表TableId": srcTableId,
-            "源行RecordId": recordId,
-          },
-        });
-      },
-      stop() {
-        seen.clear();
-      },
-    };
-  },
-};
-
-export default recipe;

package/templates/support-qa/workflows/admin-kb-update/workflow.yml

@@ -1,96 +0,0 @@
-meta:
-  name: "管理员知识更新"
-  version: "1.0.0"
-  domain: kb_admin
-  description: "监听群问答表「知识沉淀=待沉淀」行的「管理员更新」列，coding agent 提炼后写入本地知识库（不发群消息）。知识飞轮三路进料（手工/缺口/学习候选）在此汇合入库"
-
-# ─── 通知配置 ─────────────────────────────────────
-notification:
-  channel: "none"
-
-# ─── 数据表（独立于群问答表：本流自己的「知识更新工单表」）─────
-# table_id 留空 → setup 自动建表并回写到本文件；不可与 group-qa 同表，
-# 否则 group-qa 的 reconcile 会把知识更新工单也当群问答处理。
-# ⚠️ 占位:部署前替换为你自己的 base_id
-tracker:
-  label: "管理员知识更新留痕表"
-  description: "记录知识沉淀内容的表格，提炼后写入本地知识库"
-  base_id: ""
-  table_id: ""
-
-  states:
-    initial: "待处理"
-    active: [ "处理中" ]
-    terminal: [ "已完成", "已关闭" ]
-    blocked: "已阻塞"
-
-  fields:
-    state: "状态"
-    title: "标题"
-    current_step: "当前步骤"
-    event_log: "事件日志"
-
-  field_definitions:
-    - name: 消息内容
-      type: text
-    - name: 对话上下文
-      type: text
-    - name: 管理员更新
-      type: text
-    - name: 知识库文章
-      type: text
-    - name: 知识库同步
-      type: singleSelect
-      options:
-        - 已同步
-        - 失败
-    - name: 源表BaseId
-      type: text
-    - name: 源表TableId
-      type: text
-    - name: 源行RecordId
-      type: text
-
-  views:
-    - id: default_grid
-      type: Grid
-      name: 表格
-      field_order:
-        - 标题
-        - 消息内容
-        - 管理员更新
-        - 知识库文章
-        - 知识库同步
-        - 状态
-        - 当前步骤
-        - 事件日志
-      description: 管理员知识更新 - 处理留痕
-
-# ─── 事件源：监听群问答表「知识沉淀=待沉淀」行的「管理员更新」列 ─────
-event_sources:
-  - name: 管理员更新监听
-    type: aitable_record
-    handler: kb_sync_handler
-
-# ─── 步骤：唯一一步，coding agent 提炼后写库（无 reply 步骤 → 不发群）─────
-steps:
-  - id: kb_refine
-    name: "提炼并写入知识库"
-    recipe: kb-refine
-    auto: true
-    input_mapping:
-      question: "消息内容"
-      context: "对话上下文"
-      adminUpdate: "管理员更新"
-      srcBaseId: "源表BaseId"
-      srcTableId: "源表TableId"
-      srcRecordId: "源行RecordId"
-    output_mapping:
-      kb_synced: "知识库同步"
-      kb_article: "知识库文章"
-
-edges:
-  - from: __start__
-    to: kb_refine
-  - from: kb_refine
-    to: __end__