aitable-workflow-cli 0.1.23 → 0.1.24

package/templates/support-qa/lib/thread-adapter.ts

@@ -1,281 +0,0 @@
-import {
-  type NormalizedMessage,
-  type ThreadRoleRoster,
-  type ThreadStoreOptions,
-} from "aitable-workflow-core";
-
-/**
- * thread observer 场景适配层 —— DingTalk payload / profile 名单 → core thread 契约。
- *
- * 为什么这一层在模板而不在 core：core 不知道 support-qa 的 `globalVar.group_configs`
- * 长什么样、群名从哪来、谁算答疑人员。core 只吃 {@link NormalizedMessage} 与
- * {@link ThreadRoleRoster}，把「怎么从这个客户的配置里算出这两样」留给模板。
- *
- * 两个实测坑，改动前先看：
- *
- * ① **必须逐条拆 `payload.messages`，不能用 `payload.content`。**
- *    `dingtalk_message` 源默认 `aggregate_by_sender=true`，一个 event 可能含同一人多条消息，
- *    `payload.content` 是它们拼成的多行文本。用拼接结果当一条会把每条自己的
- *    `openMessageId` 与 `quotedMessageId` 全丢掉 —— 而这两个正是归并与溯源的地基。
- *    （现有 group-qa 的 conversation_handler 读的就是 `payload.content` + 不存在的
- *    `payload.messageId`，所以它拿不到稳定的消息身份，这也是本试点要独立建表的原因。）
- *
- * ② **群名不能指望事件源给。**
- *    `dingtalk_message` 走的是逐群 `dws chat message list`，响应里没有群名（只有
- *    `dingtalk_user_message` 的 list-all 在会话层给 `title` → `payload.conversationTitle`）。
- *    因此群名从 `globalVar.group_configs` 的 `groupName` 按 groupId 反查，取不到就留空串
- *    —— 留空串而不是 undefined，避免下游写表时该列被整列跳过。
- */
-
-/** 身份名单：先按 openDingTalkId 精确匹配，匹配不到再用昵称兜底。 */
-export interface IdentitySets {
-  ids: Set<string>;
-  nicks: Set<string>;
-}
-
-const EMPTY_IDENTITY: IdentitySets = { ids: new Set(), nicks: new Set() };
-
-/**
- * 解析名单。兼容三种形状：`["花名"]` / `[{nick, openDingTalkId}]` / `[{botNick}]`。
- *
- * 非数组（含 `undefined`）一律得空集合——`${globalVar.X}` 在首轮 config-sync 发布前解为
- * `undefined`，这里必须能降级，不能抛。
- */
-export function parseIdentities(list: unknown): IdentitySets {
-  const ids = new Set<string>();
-  const nicks = new Set<string>();
-  for (const e of Array.isArray(list) ? list : []) {
-    if (typeof e === "string") {
-      const nick = e.trim();
-      if (nick) nicks.add(nick);
-      continue;
-    }
-    if (!e || typeof e !== "object") continue;
-    const rec = e as Record<string, unknown>;
-    for (const key of ["nick", "name", "botNick"]) {
-      const nick = String(rec[key] ?? "").trim();
-      if (nick) nicks.add(nick);
-    }
-    const openId = String(rec.openDingTalkId ?? "").trim();
-    if (openId) ids.add(openId);
-  }
-  return { ids, nicks };
-}
-
-/**
- * 从功能模块人员配置里取**模块名字典**（不取人），拼成一行递给分析 agent。
- *
- * 为何复用 `module_owners` 而不另配一份字典：模块口径必须与答疑链路同源，否则
- * observer 算出的 `结论模块` 与主链的 `模块` 对不上，后续按模块聚合就失效。两份配置
- * 必然漂移。
- *
- * 兼容两种形状：`[{module, owners}]` 与 `{模块名: [...]}`。取不到时返回空串，
- * agent 侧按 AGENTS.md 的约定省略 module 字段（而不是乱造一个）。
- */
-export function parseModuleTaxonomy(raw: unknown): string {
-  const names = new Set<string>();
-  if (Array.isArray(raw)) {
-    for (const e of raw) {
-      if (typeof e === "string") {
-        const n = e.trim();
-        if (n) names.add(n);
-        continue;
-      }
-      if (!e || typeof e !== "object") continue;
-      const n = String((e as Record<string, unknown>).module ?? "").trim();
-      if (n) names.add(n);
-    }
-  } else if (raw && typeof raw === "object") {
-    for (const key of Object.keys(raw as Record<string, unknown>)) {
-      const n = key.trim();
-      if (n) names.add(n);
-    }
-  }
-  return [...names].join(" / ");
-}
-
-/** groupId → 群名。群配置里没有该群或没填群名时不进 map（下游降级为空串）。 */
-export function parseGroupNames(list: unknown): Map<string, string> {
-  const out = new Map<string, string>();
-  for (const g of Array.isArray(list) ? list : []) {
-    if (!g || typeof g !== "object") continue;
-    const rec = g as Record<string, unknown>;
-    const gid = String(rec.groupId ?? "").trim();
-    const name = String(rec.groupName ?? "").trim();
-    if (gid && name) out.set(gid, name);
-  }
-  return out;
-}
-
-export function matchesIdentity(sets: IdentitySets, name: string, openId: string): boolean {
-  if (openId && sets.ids.has(openId)) return true;
-  return !!name && sets.nicks.has(name);
-}
-
-/** 客观身份类别。**不是 thread 里的 role** —— 谁是本 thread 的 asker 要等 thread 成型才知道。 */
-export type MessageIdentity = "bot" | "answerer" | "user";
-
-export function resolveIdentity(bots: IdentitySets, answerers: IdentitySets, name: string, openId: string): MessageIdentity {
-  if (matchesIdentity(bots, name, openId)) return "bot";
-  if (matchesIdentity(answerers, name, openId)) return "answerer";
-  return "user";
-}
-
-/**
- * 角色判定状态。写进观察表供人工一眼看出「SLA 算不出来是名单没配，还是真没人回」。
- *
- * `missing_bots` 优先于 `missing_answerers` 报：机器人名单缺失会让机器人消息被当成用户
- * 提问，污染面更大。
- */
-export type RosterStatus = "ok" | "missing_bots" | "missing_answerers";
-
-export function rosterStatus(bots: IdentitySets, answerers: IdentitySets): RosterStatus {
-  if (bots.ids.size === 0 && bots.nicks.size === 0) return "missing_bots";
-  if (answerers.ids.size === 0 && answerers.nicks.size === 0) return "missing_answerers";
-  return "ok";
-}
-
-export function toRoster(bots: IdentitySets, answerers: IdentitySets): ThreadRoleRoster {
-  return {
-    answererIds: [...answerers.ids],
-    answererNames: [...answerers.nicks],
-    botNames: [...bots.nicks],
-  };
-}
-
-/** 从 handler_config / step.config 解析出的名单与群名，一次算好供本轮复用。 */
-export interface ObserverRosters {
-  bots: IdentitySets;
-  answerers: IdentitySets;
-  groupNames: Map<string, string>;
-  status: RosterStatus;
-  roster: ThreadRoleRoster;
-}
-
-/**
- * 活读名单。**每次事件都要重算**，不能在 create() 时快照：名单来自 config-sync 发布的
- * globalVar，首轮发布前为空；快照下来的话名单后来发布也不生效，SLA 会永远算不出来。
- *
- * 调用方可自行加短 TTL 缓存（见 handler），但缓存期必须远小于 config-sync 周期。
- */
-export function loadObserverRosters(input: {
-  bots: unknown;
-  answerers: unknown;
-  /** 仅用于反查群名。收尾阶段群名已写入表，可省。 */
-  groupConfigs?: unknown;
-}): ObserverRosters {
-  const bots = parseIdentities(input.bots);
-  const answerers = parseIdentities(input.answerers);
-  return {
-    bots,
-    answerers,
-    groupNames: parseGroupNames(input.groupConfigs),
-    status: rosterStatus(bots, answerers),
-    roster: toRoster(bots, answerers),
-  };
-}
-
-/** 图片标记，用于把纯图片消息与空消息区分开。 */
-const IMAGE_MARK = "![图片]";
-
-/**
- * 把一个 `message_received` 事件拆成逐条 {@link NormalizedMessage}。
- *
- * 丢弃规则（两条，都是刻意的）：
- * - **无 openMessageId 一律丢**：既无法归并也无法溯源，记了只会弄脏日志重放；
- * - 既无正文又无图片的丢（文件/系统消息）。
- *
- * `role` 只填 `bot` 或 `unknown`：真正的 asker/answerer 由 core 在收敛时按名单派生。
- * 这里填 `bot` 是必需的 —— core 靠它避免把机器人登记成提问人锚点。
- */
-export function normalizeEventMessages(
-  payload: Record<string, unknown>,
-  rosters: Pick<ObserverRosters, "bots" | "answerers" | "groupNames">,
-): Array<{ message: NormalizedMessage; identity: MessageIdentity }> {
-  const conversationId = String(payload.conversationId ?? "").trim();
-  if (!conversationId) return [];
-  // 群名优先用事件源给的（list-all 源有），否则从群配置反查；都没有则空串
-  const groupName =
-    String(payload.conversationTitle ?? "").trim() || rosters.groupNames.get(conversationId) || "";
-
-  const raw = Array.isArray(payload.messages) ? payload.messages : [];
-  const out: Array<{ message: NormalizedMessage; identity: MessageIdentity }> = [];
-  for (const item of raw) {
-    if (!item || typeof item !== "object") continue;
-    const rec = item as Record<string, unknown>;
-    const openMessageId = String(rec.messageId ?? rec.openMessageId ?? "").trim();
-    if (!openMessageId) continue;
-
-    const content = String(rec.content ?? "");
-    const images = Array.isArray(rec.images) ? rec.images.map(String) : [];
-    if (!content.trim() && images.length === 0 && !content.includes(IMAGE_MARK)) continue;
-
-    // senderName 兜底顺序对齐两个源：逐群轮询给 senderName，list-all 只给 sender
-    const senderName = String(rec.senderName ?? rec.sender ?? payload.senderName ?? "").trim();
-    const senderOpenDingTalkId = String(rec.senderOpenDingTalkId ?? "").trim();
-    const identity = resolveIdentity(rosters.bots, rosters.answerers, senderName, senderOpenDingTalkId);
-
-    out.push({
-      identity,
-      message: {
-        openMessageId,
-        conversationId,
-        groupName,
-        senderName,
-        senderOpenDingTalkId,
-        createTime: parseCreateTime(rec.createTime),
-        content,
-        images,
-        ...(typeof rec.quotedMessageId === "string" && rec.quotedMessageId.trim()
-          ? { quotedMessageId: rec.quotedMessageId.trim() }
-          : {}),
-        role: identity === "bot" ? "bot" : "unknown",
-      },
-    });
-  }
-  // 归并信号依赖「上一条」，乱序会把追问判成新 thread。源已排序，这里再兜一次底。
-  out.sort((a, b) => a.message.createTime - b.message.createTime);
-  return out;
-}
-
-/**
- * 事件里的时间统一成 epoch ms。
- *
- * 源已把时间归一为带时区的 ISO（无时区的墙上时间按 Asia/Shanghai 解释），所以这里直接
- * `Date.parse` 即可。解析不出来时回落「当下」而不是 0：0 会让这条消息在时间排序里跑到
- * 所有 thread 之前，把归并搅乱。
- */
-function parseCreateTime(raw: unknown): number {
-  const str = typeof raw === "string" ? raw.trim() : "";
-  if (str) {
-    const ms = Date.parse(str);
-    if (Number.isFinite(ms)) return ms;
-  }
-  return Date.now();
-}
-
-/**
- * 从 handler_config 取归并策略开关。
- *
- * 只暴露少量开关，不把 core 的全部 option 都摊给用户：R0 需要调的就是「收敛多久」
- * 与「哪些归并信号打开」。启发式与 mention 在 core 里默认关，这里也保持关 —— 想开必须
- * 在 profile 里显式写，且开了就会在复核池里看到 low 置信样本。
- */
-export function parseThreadOptions(config: Record<string, unknown>): ThreadStoreOptions {
-  const num = (v: unknown): number | undefined => {
-    const n = typeof v === "number" ? v : Number(v);
-    return Number.isFinite(n) && n > 0 ? n : undefined;
-  };
-  const idleMin = num(config.thread_idle_close_min);
-  const maxOpenHour = num(config.thread_max_open_hour);
-  const patterns = Array.isArray(config.thread_address_patterns)
-    ? config.thread_address_patterns.map(String).filter((s) => s.includes("{name}"))
-    : [];
-  return {
-    ...(idleMin ? { idleCloseMs: idleMin * 60_000 } : {}),
-    ...(maxOpenHour ? { maxOpenMs: maxOpenHour * 60 * 60_000 } : {}),
-    ...(config.thread_enable_mention_merge === true ? { enableMentionMerge: true } : {}),
-    ...(config.thread_enable_heuristic_merge === true ? { enableHeuristicMerge: true } : {}),
-    ...(patterns.length > 0 ? { addressPatterns: patterns } : {}),
-  };
-}

package/templates/support-qa/lib/thread-digest.ts

@@ -1,144 +0,0 @@
-import { z } from "zod";
-
-/**
- * thread 抽取结果 —— **模板侧业务层**，刻意不放进 core。
- *
- * core 的 thread 模块只回答「哪些消息属于同一个问题」；「这个问题是知识缺口还是需求」、
- * 「落到表里哪一列」是业务口径，换个客户就会变。把它放进 core 就等于让 core 认识
- * `kb_gap`、`需求`、`结论模块` 这些只对本场景成立的概念。
- *
- * 与观察表 `归并置信度` 的关系：**两者必须分开看**。
- * - `归并置信度` 来自 core 的确定性规则，说的是「threadId 归得对不对」；
- * - 本文件的 `confidence` 来自 LLM，说的是「结论/分类抽得对不对」。
- *
- * 混成一列的后果是复核时分不清该改 ThreadStore 策略还是该改 prompt。因此 digest 的低置信
- * 只**追加**到 `归并疑点` 与 `复核状态`，绝不覆盖 `归并置信度`。
- */
-
-/** 问题类型（英文枚举是 LLM 的输出契约，落表时映射成中文，见 {@link typeToColumn}）。 */
-export const THREAD_TYPES = ["kb_gap", "requirement", "bug", "answered", "chitchat"] as const;
-export type ThreadType = (typeof THREAD_TYPES)[number];
-
-export const THREAD_CONFIDENCES = ["high", "medium", "low"] as const;
-export type ThreadDigestConfidence = (typeof THREAD_CONFIDENCES)[number];
-
-export interface ThreadDigest {
-  type: ThreadType;
-  module?: string;
-  /** 检索友好的归一问法 */
-  standardQuestion: string;
-  /** 本次对话的最终结论（已被推翻的说法不进这里） */
-  conclusion: string;
-  /** 对先前错误理解的纠正，按发生顺序 */
-  amendments?: string[];
-  /** 结论所依据的消息的 openMessageId，供人工 review 回群核对 */
-  evidenceMessageIds?: string[];
-  confidence: ThreadDigestConfidence;
-  /** 为何不确定（confidence 非 high 时应给） */
-  confidenceReason?: string;
-}
-
-/**
- * LLM 输出的边界校验。抽取结果是**外部不可信输入**，必须过这道 schema。
- *
- * `kb_gap / requirement / bug` 要求 conclusion 非空：这三类是要人跟进的，结论为空说明抽取
- * 失败，放过去只会在表里留一行没内容的记录，让复核的人白读一遍。
- *
- * `confidence 非 high 时要求 confidenceReason`：「我不确定」不带理由对复核没有价值，
- * 反而让人重新读一遍 thread。
- */
-export const threadDigestSchema = z
-  .object({
-    type: z.enum(THREAD_TYPES),
-    module: z.string().trim().min(1).optional(),
-    standardQuestion: z.string().trim().min(1),
-    conclusion: z.string().trim(),
-    amendments: z.array(z.string().trim().min(1)).optional(),
-    evidenceMessageIds: z.array(z.string().trim().min(1)).optional(),
-    confidence: z.enum(THREAD_CONFIDENCES),
-    confidenceReason: z.string().trim().min(1).optional(),
-  })
-  .superRefine((v, ctx) => {
-    const needsConclusion = v.type === "kb_gap" || v.type === "requirement" || v.type === "bug";
-    if (needsConclusion && !v.conclusion.trim()) {
-      ctx.addIssue({ code: "custom", message: `type=${v.type} 时 conclusion 必填` });
-    }
-    if (v.confidence !== "high" && !v.confidenceReason) {
-      ctx.addIssue({ code: "custom", message: `confidence=${v.confidence} 时 confidenceReason 必填` });
-    }
-  });
-
-/** 解析并校验抽取结果；失败返回 null 由调用方决定降级（**不要**抛到工作流外）。 */
-export function parseThreadDigest(raw: unknown): ThreadDigest | null {
-  const checked = threadDigestSchema.safeParse(raw);
-  if (!checked.success) return null;
-  const v = checked.data;
-  return {
-    type: v.type,
-    ...(v.module ? { module: v.module } : {}),
-    standardQuestion: v.standardQuestion,
-    conclusion: v.conclusion,
-    ...(v.amendments?.length ? { amendments: v.amendments } : {}),
-    ...(v.evidenceMessageIds?.length ? { evidenceMessageIds: v.evidenceMessageIds } : {}),
-    confidence: v.confidence,
-    ...(v.confidenceReason ? { confidenceReason: v.confidenceReason } : {}),
-  };
-}
-
-/**
- * 拼出落入「本次结论」列的文本。
- *
- * 为何 amendments 不单独建列、但也不丢：实测存在「第二个解答者引用中间某条消息做
- * 纠正」的分叉形态，这类 thread 同时含错误理解与正确结论。若输出契约只给单个答案字段，
- * 模型可能选中**被推翻的那个**。因此契约上分两段让模型先把两者区分开，落表时再合成
- * 一列，既保留契约好处又不给观察表加列。
- */
-export function renderConclusion(digest: ThreadDigest): string {
-  const parts = [digest.conclusion.trim()].filter(Boolean);
-  if (digest.amendments?.length) {
-    parts.push(`【过程更正】${digest.amendments.map((a) => `- ${a}`).join("\n")}`);
-  }
-  if (digest.evidenceMessageIds?.length) {
-    parts.push(`【证据】${digest.evidenceMessageIds.join(", ")}`);
-  }
-  return parts.join("\n\n");
-}
-
-/**
- * 类型 → 观察表 `问题类型` 列的选项值。
- *
- * 列里用中文是为了让复核的人不用记英文枚举；`kb_gap` 保留原样，与既有答疑口径的
- * `处置动作` 对齐，便于横向比对两条链路对同一个问题的判断。
- */
-const TYPE_TO_COLUMN: Record<ThreadType, string> = {
-  kb_gap: "kb_gap",
-  requirement: "需求",
-  bug: "bug",
-  answered: "已答",
-  chitchat: "闲聊",
-};
-
-export function typeToColumn(type: ThreadType): string {
-  return TYPE_TO_COLUMN[type];
-}
-
-/**
- * 从 LLM 响应中提取 JSON 对象。
- *
- * 必须兼容 ```json 围栏与裸 JSON 两种形态：同一个模型在不同轮次会给不同包装，只认一种
- * 会把好结果当解析失败丢掉、白烧一次重试额度。
- */
-export function extractJsonObject(raw: string): Record<string, unknown> | null {
-  const trimmed = raw.trim();
-  const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/);
-  const jsonStr = fenced?.[1]?.trim() ?? trimmed;
-  const start = jsonStr.indexOf("{");
-  const end = jsonStr.lastIndexOf("}");
-  if (start < 0 || end < 0) return null;
-  try {
-    const obj = JSON.parse(jsonStr.slice(start, end + 1));
-    return obj && typeof obj === "object" ? (obj as Record<string, unknown>) : null;
-  } catch {
-    return null;
-  }
-}

package/templates/support-qa/npmrc

@@ -1 +0,0 @@
-registry=https://registry.npmjs.org/

package/templates/support-qa/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "support-qa-app",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "description": "通用群答疑助手（由 aitable-workflow init --template support-qa 生成）。业务差异全部在 profile/profile.yml。",
-  "scripts": {
-    "run": "aitable-workflow run",
-    "setup": "aitable-workflow setup",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "aitable-workflow-core": "^0.1.5",
-    "@ali/aone-remote-agent": "^4.1.0",
-    "@ali/aone-sandbox": "^1.0.10",
-    "fflate": "^0.8.2",
-    "tsx": "^4.20.6",
-    "yaml": "^2.8.1",
-    "zod": "^4.1.13"
-  },
-  "devDependencies": {
-    "@types/node": "^24.10.1",
-    "typescript": "^5.9.3",
-    "vitest": "^3.0.0"
-  }
-}

package/templates/support-qa/profiles/aitable/profile/escalation/contacts.json

@@ -1,37 +0,0 @@
-{
-  "学澜": {
-    "userId": "314321",
-    "openDingTalkId": "DHqTPjhJwIC6iPVkvTqSiiiSdiSv65f4yxiScR"
-  },
-  "龙衔": {
-    "userId": "132984",
-    "openDingTalkId": "DHqTPjhJwIC7l00iSIGLaJhlWGuSudnciiC"
-  },
-  "饶超": {
-    "userId": "442922",
-    "openDingTalkId": "DWe5nTPjuTWZOWo5W1x0Vj2GYZnCxN64H"
-  },
-  "羽承": {
-    "userId": "329849",
-    "openDingTalkId": "D4NgPmiSwO21ROWo5W1x0Vj2GYZnCxN64H"
-  },
-  "荣权": {
-    "userId": "475007",
-    "openDingTalkId": "DtyBiiC76t0EXuHZs1SjvTJ7NFHliioS5CU"
-  },
-  "桦楠": {
-    "userId": "239198",
-    "openDingTalkId": "Dnv9vDZLISpHfF7vfnAiiHNbNFHliioS5CU"
-  },
-  "蓝锋": {
-    "userId": "308709",
-    "openDingTalkId": "DHqTPjhJwIC5qSGeYbV6RE2r6tk7GINOa"
-  },
-  "枫与": {
-    "userId": "450841",
-    "openDingTalkId": "DHqTPjhJwIC6ANlW0Es0sZtfpXstQ2BoC"
-  },
-  "脉昆": {
-    "userId": "13669584"
-  }
-}

package/templates/support-qa/profiles/aitable/profile/escalation/owner-map.json

@@ -1,18 +0,0 @@
-{
-  "字段类型与高级字段": ["学澜"],
-  "自动化": ["龙衔"],
-  "表单": ["饶超"],
-  "仪表盘和应用模式": ["脉昆"],
-  "商业化与版本权益": ["羽承", "荣权"],
-  "高级权限": ["饶超"],
-  "侧栏插件和脚本插件": ["桦楠"],
-  "数据源": ["桦楠"],
-  "导入 excel": ["桦楠"],
-  "AI表格导出": ["枫与"],
-  "AI表格数据源": ["桦楠"],
-  "AI字段": ["桦楠"],
-  "功能实践玩法": ["羽承"],
-  "查找引用 & 表格加载等性能问题": ["蓝锋"],
-  "数据不显示 & 数据丢失等问题": ["蓝锋"],
-  "公式": ["蓝锋"]
-}