siluzan-tso-cli 1.1.20-beta.2 → 1.1.20-beta.4

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.20-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.20-beta.4），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -2603,6 +2603,81 @@ function defineCommand(spec) {
     return cmd;
   };
 }
+function deriveMainApiOrigin(apiBase) {
+  try {
+    const u = new URL(apiBase);
+    const host = u.hostname.toLowerCase();
+    const isCi = apiBase.includes("-ci");
+    if (host.endsWith("siluzan.com") || host.endsWith("siluzan.cn")) {
+      if (host.startsWith("tso-api")) {
+        const suffix = host.endsWith("siluzan.cn") ? "siluzan.cn" : "siluzan.com";
+        const apiHost = isCi ? `api-ci.${suffix}` : `api.${suffix}`;
+        return `${u.protocol}//${apiHost}${u.port ? `:${u.port}` : ""}`;
+      }
+      if (host === "api.siluzan.com" || host === "api-ci.siluzan.com" || host === "api.siluzan.cn" || host === "api-ci.siluzan.cn") {
+        return `${u.protocol}//${host}${u.port ? `:${u.port}` : ""}`;
+      }
+      return isCi ? "https://api-ci.siluzan.com" : "https://api.siluzan.com";
+    }
+    return isCi ? "https://api-ci.siluzan.com" : "https://api.siluzan.com";
+  } catch {
+    return apiBase.includes("-ci") ? "https://api-ci.siluzan.com" : "https://api.siluzan.com";
+  }
+}
+function pickStr(obj, key) {
+  const v = obj[key];
+  return typeof v === "string" && v.trim() ? v.trim() : void 0;
+}
+function pickCompanyId(data) {
+  const direct = pickStr(data, "companyId") ?? pickStr(data, "companyID") ?? pickStr(data, "CompanyId");
+  if (direct) return direct;
+  const ci = data["companyInfo"];
+  if (ci && typeof ci === "object") {
+    const o = ci;
+    return pickStr(o, "id") ?? pickStr(o, "companyId") ?? pickStr(o, "companyID");
+  }
+  return void 0;
+}
+function parseMeResponse(text) {
+  try {
+    const json = JSON.parse(text);
+    const data = json?.data && typeof json.data === "object" ? json.data : json;
+    const id = pickStr(data, "entityId") ?? pickStr(data, "id") ?? pickStr(data, "userId") ?? pickStr(data, "accountId");
+    const email = pickStr(data, "email");
+    const username = pickStr(data, "userName") ?? pickStr(data, "username") ?? pickStr(data, "name") ?? pickStr(data, "phone");
+    const companyId = pickCompanyId(data);
+    if (!id && !email && !username && !companyId) return null;
+    return { id, email, username, companyId };
+  } catch {
+    return null;
+  }
+}
+async function fetchSiluzanCurrentUser(apiBase, config) {
+  const mainOrigin = deriveMainApiOrigin(apiBase);
+  const meUrl = `${mainOrigin.replace(/\/$/, "")}/query/account/me`;
+  const authHeaders = config.apiKey ? { "x-api-key": config.apiKey } : { Authorization: `Bearer ${config.authToken}` };
+  try {
+    const res = await rawRequest(meUrl, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "Accept-Language": "zh-CN",
+        ...authHeaders
+      }
+    });
+    if (res.status < 200 || res.status >= 300) return null;
+    const parsed = parseMeResponse(res.text);
+    if (!parsed) return null;
+    return {
+      entityId: parsed.id,
+      email: parsed.email,
+      username: parsed.username,
+      companyId: parsed.companyId
+    };
+  } catch {
+    return null;
+  }
+}
 function truncate(s, max) {
   if (s.length <= max) return s;
   return `${s.slice(0, max)}\u2026[truncated ${s.length - max} chars]`;
@@ -3679,6 +3754,13 @@ function loadConfig(tokenArg) {
 \u274C googleApiUrl \u4E0D\u5408\u6CD5\uFF1A${googleApiErr}`);
     process.exit(1);
   }
+  const csoBaseUrl = process.env.SILUZAN_CSO_BASE ?? deriveCsoApiBaseUrl(apiBaseUrl);
+  const csoErr = validateBaseUrl(csoBaseUrl);
+  if (csoErr) {
+    console.error(`
+\u274C csoBaseUrl \u4E0D\u5408\u6CD5\uFF1A${csoErr}`);
+    process.exit(1);
+  }
   return {
     apiBaseUrl,
     authToken,
@@ -3688,6 +3770,7 @@ function loadConfig(tokenArg) {
     tiktokApiUrl: deriveTiktokApiUrl(apiBaseUrl),
     facebookApiUrl: deriveFacebookApiUrl(apiBaseUrl),
     chatGptApiUrl: deriveChatGptApiUrl(apiBaseUrl),
+    csoBaseUrl,
     dataPermission: process.env.SILUZAN_DATA_PERMISSION ?? shared.dataPermission
   };
 }
@@ -112442,6 +112525,489 @@ var register21 = defineCommand({
   }
 });
 
+// src/commands/rag.ts
+init_auth();
+function splitCsv2(s) {
+  if (!s) return [];
+  return s.split(",").map((x) => x.trim()).filter(Boolean);
+}
+function splitQueryWhitespaceToKeywords(query) {
+  return String(query ?? "").trim().split(/\s+/).filter(Boolean);
+}
+function ragItemDedupeKey(item) {
+  const id = String(item.id ?? "").trim();
+  if (id) return `id:${id}`;
+  const name = String(item.fields?.name ?? "").trim();
+  const content = String(item.fields?.content ?? "").slice(0, 160);
+  return `fb:${name}\0${content}`;
+}
+function mergeRagResultsByBestScore(batches) {
+  const best = /* @__PURE__ */ new Map();
+  for (const batch of batches) {
+    for (const item of batch) {
+      const key = ragItemDedupeKey(item);
+      const prev = best.get(key);
+      const s = item.score ?? 0;
+      if (!prev || s > (prev.score ?? 0)) {
+        best.set(key, item);
+      }
+    }
+  }
+  return [...best.values()].sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+}
+function normalizeRagScores(rawOutput) {
+  return rawOutput.map((item) => {
+    const r = item.score;
+    if (typeof r !== "number" || Number.isNaN(r)) return item;
+    const s = Math.min(1, Math.max(0, 1 - r));
+    return { ...item, score: s };
+  });
+}
+function unwrapQueryKnowledges(raw) {
+  if (!raw || typeof raw !== "object") return { output: [] };
+  if ("output" in raw && Array.isArray(raw.output)) {
+    return raw;
+  }
+  const w = raw;
+  if (w.data != null && typeof w.data === "object") {
+    const d = w.data;
+    return Array.isArray(d.output) ? d : { output: [] };
+  }
+  return { output: [] };
+}
+function similarityPercent(score) {
+  if (score === void 0 || Number.isNaN(score)) return "N/A";
+  const s = Math.min(1, Math.max(0, score));
+  return `${Math.round(s * 100)}%`;
+}
+function blockquoteMarkdown(text) {
+  return text.split("\n").map((line) => `> ${line}`).join("\n");
+}
+function formatTime(iso) {
+  if (!iso) return "";
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return iso;
+  return d.toLocaleString("zh-CN", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+function flatTagArray(tags) {
+  if (!Array.isArray(tags) || tags.length === 0) return [];
+  return tags.flat().filter((t) => typeof t === "string" && t.trim().length > 0);
+}
+function flatCategoryArray(category) {
+  if (!Array.isArray(category) || category.length === 0) return [];
+  return category.flat().filter((c) => typeof c === "string" && c.trim().length > 0);
+}
+function formatRagResultsMarkdown(query, items, subQueries) {
+  if (!items.length) {
+    return "\u672A\u627E\u5230\u76F8\u5173\u7ED3\u679C\u3002\n";
+  }
+  const parts = [];
+  if (subQueries && subQueries.length > 1) {
+    parts.push(`## \u67E5\u8BE2\uFF1A${query}
+
+`);
+    parts.push(
+      `\u5DF2\u6309\u7A7A\u767D\u62C6\u5206\u4E3A **${subQueries.length}** \u4E2A\u5173\u952E\u8BCD\u5206\u522B\u68C0\u7D22\uFF0C\u7ED3\u679C\u6309\u7247\u6BB5\u53BB\u91CD\uFF08\u4FDD\u7559\u6700\u9AD8\u76F8\u4F3C\u5EA6\uFF09\u540E\u6392\u5E8F\u3002
+
+`
+    );
+    parts.push(`${subQueries.map((q) => `- \`${q}\``).join("\n")}
+
+`);
+  } else {
+    parts.push(`## \u67E5\u8BE2\uFF1A${query}
+`);
+  }
+  items.forEach((item, itemIndex) => {
+    const fields = item.fields;
+    if (!fields) return;
+    const name = fields.name ?? "\u672A\u77E5\u6587\u4EF6";
+    const content = fields.content ?? "";
+    const sourceUrl = fields.source_url ?? "";
+    const createTime = fields.create_time ?? "";
+    const usageCount = fields.usage_count ?? 0;
+    parts.push(`### ${itemIndex + 1}. ${name}
+`);
+    if (item.id) {
+      parts.push(`**\u7247\u6BB5 ID\uFF1A** \`${item.id}\`
+`);
+    }
+    parts.push(`**\u76F8\u4F3C\u5EA6\u5206\u6570\uFF1A** ${similarityPercent(item.score)}
+`);
+    if (createTime) {
+      parts.push(`**\u521B\u5EFA\u65F6\u95F4\uFF1A** ${formatTime(createTime)}
+`);
+    }
+    if (usageCount > 0) {
+      parts.push(`**\u4F7F\u7528\u6B21\u6570\uFF1A** ${usageCount}
+`);
+    }
+    if (sourceUrl) {
+      parts.push(`**\u9884\u89C8\u94FE\u63A5\uFF1A** ${sourceUrl}
+`);
+    }
+    if (content) {
+      parts.push(`
+**\u5185\u5BB9\uFF1A**
+
+`);
+      parts.push(`${blockquoteMarkdown(content.trim())}
+
+`);
+    }
+    const tagFlat = flatTagArray(fields.tags);
+    if (tagFlat.length > 0) {
+      parts.push(`**\u6807\u7B7E\uFF1A** ${tagFlat.join(", ")}
+`);
+    }
+    const catFlat = flatCategoryArray(fields.category);
+    if (catFlat.length > 0) {
+      parts.push(`**\u5206\u7C7B\uFF1A** ${catFlat.join(", ")}
+`);
+    }
+    parts.push(`
+---
+
+`);
+  });
+  return parts.join("");
+}
+function normalizeQueryPartition(p) {
+  return p === "wiki" ? "wiki" : "default";
+}
+function requireCsoBaseUrl(config) {
+  const url = config.csoBaseUrl?.trim();
+  if (!url) {
+    console.error("\n\u274C \u672A\u627E\u5230 CSO/RAG \u7F51\u5173\u5730\u5740\uFF08csoBaseUrl\uFF09\u3002");
+    process.exit(1);
+  }
+  return url;
+}
+function buildQueryKnowledgesSearchParams(options) {
+  const p = new URLSearchParams();
+  p.append("queryTxt", options.queryTxt);
+  p.append("belongTo", String(options.belongTo));
+  p.append("belongToId", options.belongToId);
+  p.append("topK", String(options.topK));
+  for (const id of options.sourceIds) {
+    p.append("sourceid", id);
+  }
+  for (const id of options.folderIds) {
+    p.append("comid", id);
+  }
+  for (const t of options.tags) {
+    p.append("tags", t);
+  }
+  for (const c of options.categories) {
+    p.append("category", c);
+  }
+  p.append("partition", options.partition);
+  return p.toString();
+}
+async function runRagQuery(options) {
+  const sourceIds = splitCsv2(options.sourceId);
+  const folderIds = splitCsv2(options.folderId);
+  let topK = options.topK ?? 7;
+  if (!Number.isFinite(topK) || !Number.isInteger(topK)) {
+    topK = 7;
+  }
+  const clamped = Math.min(30, Math.max(3, topK));
+  let belongTo = options.belongTo ?? 0;
+  if (!Number.isFinite(belongTo)) {
+    belongTo = 0;
+  }
+  const queryTxt = String(options.query ?? "").trim();
+  if (!queryTxt) {
+    console.error("\n\u274C --query \u4E0D\u80FD\u4E3A\u7A7A\u3002");
+    process.exit(1);
+  }
+  const subQueries = splitQueryWhitespaceToKeywords(queryTxt);
+  const multiKeyword = subQueries.length > 1;
+  const mergedCap = Math.min(30, clamped * subQueries.length);
+  const config = loadConfig(options.token);
+  const csoBaseUrl = requireCsoBaseUrl(config);
+  let belongToId = String(options.belongToId ?? "").trim();
+  if (!belongToId) {
+    const me = await fetchSiluzanCurrentUser(config.apiBaseUrl, config);
+    belongToId = (me?.companyId ?? "").trim();
+  }
+  if (!belongToId) {
+    console.error(
+      "\n\u274C \u65E0\u6CD5\u786E\u5B9A\u4F01\u4E1A ID\uFF1A\u8BF7\u4F20\u5165 --belong-to-id\uFF0C\u6216\u786E\u4FDD GET /query/account/me \u54CD\u5E94\u4E2D\u542B companyId\u3002"
+    );
+    process.exit(1);
+  }
+  const tagList = splitCsv2(options.tags);
+  const categories = splitCsv2(options.category);
+  const rawPartition = options.partition?.trim();
+  if (rawPartition && rawPartition !== "wiki" && rawPartition !== "default") {
+    console.error("\n\u274C partition \u53EA\u80FD\u4E3A wiki \u6216 default\u3002");
+    process.exit(1);
+  }
+  const partition = normalizeQueryPartition(rawPartition);
+  const baseSearch = {
+    belongTo,
+    belongToId,
+    topK: clamped,
+    sourceIds,
+    folderIds,
+    tags: tagList,
+    categories,
+    partition
+  };
+  const verbose = Boolean(options.verbose);
+  async function fetchKnowledgesOne(queryPart) {
+    const qs = buildQueryKnowledgesSearchParams({
+      ...baseSearch,
+      queryTxt: queryPart
+    });
+    const url = `${csoBaseUrl}/cutapi/v1/material/queryknowledges?${qs}`;
+    let raw;
+    try {
+      raw = await apiFetch2(
+        url,
+        config,
+        {},
+        verbose
+      );
+    } catch (e) {
+      const msg = e.message;
+      console.error(`
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${msg}`);
+      if (!verbose) console.error("   \u52A0 --verbose \u53C2\u6570\u53EF\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F");
+      process.exit(1);
+    }
+    if (raw && typeof raw === "object" && "code" in raw) {
+      const w = raw;
+      if (w.code !== 1) {
+        console.error(`
+\u274C \u77E5\u8BC6\u5E93\u68C0\u7D22\u5931\u8D25\uFF1A${w.message || `\u4E1A\u52A1\u7801 ${w.code}`}`);
+        process.exit(1);
+      }
+    }
+    const payload = unwrapQueryKnowledges(raw);
+    const rawOutput = Array.isArray(payload.output) ? payload.output : [];
+    return normalizeRagScores(rawOutput);
+  }
+  let output;
+  if (multiKeyword) {
+    const batches = await Promise.all(subQueries.map((q) => fetchKnowledgesOne(q)));
+    output = mergeRagResultsByBestScore(batches).slice(0, mergedCap);
+  } else {
+    output = await fetchKnowledgesOne(subQueries[0]);
+  }
+  if (options.json) {
+    console.log(
+      JSON.stringify(
+        {
+          query: queryTxt,
+          ...multiKeyword ? { subQueries, mergedCap } : {},
+          belongToId,
+          tags: tagList,
+          topK: clamped,
+          output,
+          partition
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (output.length === 0) {
+    console.log("\n\u672A\u68C0\u7D22\u5230\u5339\u914D\u7247\u6BB5\uFF08\u53EF\u5C1D\u8BD5\u653E\u5BBD --top-k \u6216\u8C03\u6574\u5173\u952E\u8BCD/\u8303\u56F4\uFF09\u3002\n");
+    return;
+  }
+  const modeHint = multiKeyword ? ` \xB7 \u5206\u8BCD\u5408\u5E76\u2264${mergedCap}\u6761` : "";
+  const header = `> \u77E5\u8BC6\u5E93\u68C0\u7D22 \xB7 topK=${clamped}${modeHint} \xB7 \u7528\u4E8E\u5E7F\u544A\u6295\u653E/\u8D26\u6237\u5206\u6790\u4E1A\u52A1\u53C2\u8003
+>
+`;
+  const body = formatRagResultsMarkdown(queryTxt, output, multiKeyword ? subQueries : void 0);
+  console.log(`
+${header}${body}`);
+}
+var RAG_ROOT_FOLDER_ID = "88888888-8888-8888-0000-888888888888";
+var RAG_BUILTIN_PARENT_FOLDER_ID = "88888888-8888-0000-0000-888888888888";
+function buildMaterialQueryListParams(belongToId, folderId) {
+  return new URLSearchParams({
+    belongTo: "0",
+    belongToId,
+    showCut: "true",
+    isGlobal: "true",
+    orderBy: "createTime",
+    isDesc: "true",
+    pageIndex: "1",
+    pageSize: "999",
+    folderId
+  });
+}
+function mergeFoldersByIdOrder(primary, secondary) {
+  const seen = new Set(primary.map((f) => f.id));
+  const out = [...primary];
+  for (const f of secondary) {
+    if (!seen.has(f.id)) {
+      seen.add(f.id);
+      out.push(f);
+    }
+  }
+  return out;
+}
+async function safeQueryMaterialFolderList(csoBaseUrl, config, belongToId, folderId, verbose) {
+  const p = buildMaterialQueryListParams(belongToId, folderId);
+  const url = `${csoBaseUrl}/cutapi/v1/material/querylist?${p.toString()}`;
+  try {
+    const raw = await apiFetch2(url, config, {}, verbose);
+    if (raw.code !== 1) {
+      return { ok: false, reason: raw.message || `\u4E1A\u52A1\u7801 ${raw.code}` };
+    }
+    return { ok: true, folders: raw.data?.folders ?? [] };
+  } catch (e) {
+    return { ok: false, reason: e.message };
+  }
+}
+async function runRagList(options) {
+  const config = loadConfig(options.token);
+  const csoBaseUrl = requireCsoBaseUrl(config);
+  const verbose = Boolean(options.verbose);
+  let belongToId = String(options.belongToId ?? "").trim();
+  if (!belongToId) {
+    const me = await fetchSiluzanCurrentUser(config.apiBaseUrl, config);
+    belongToId = (me?.companyId ?? "").trim();
+  }
+  if (!belongToId) {
+    console.error(
+      "\n\u274C \u65E0\u6CD5\u786E\u5B9A\u4F01\u4E1A ID\uFF1A\u8BF7\u4F20\u5165 --belong-to-id\uFF0C\u6216\u786E\u4FDD GET /query/account/me \u54CD\u5E94\u4E2D\u542B companyId\u3002"
+    );
+    process.exit(1);
+  }
+  const [rootRes, builtinRes] = await Promise.all([
+    safeQueryMaterialFolderList(csoBaseUrl, config, belongToId, RAG_ROOT_FOLDER_ID, verbose),
+    safeQueryMaterialFolderList(
+      csoBaseUrl,
+      config,
+      belongToId,
+      RAG_BUILTIN_PARENT_FOLDER_ID,
+      verbose
+    )
+  ]);
+  if (!rootRes.ok) {
+    console.error(`
+\u274C \u83B7\u53D6\u77E5\u8BC6\u5E93\u5217\u8868\u5931\u8D25\uFF08\u6839\u8282\u70B9\uFF09\uFF1A${rootRes.reason}`);
+    if (!verbose) console.error("   \u52A0 --verbose \u53C2\u6570\u53EF\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F");
+    process.exit(1);
+  }
+  let folders = rootRes.folders;
+  if (builtinRes.ok) {
+    folders = mergeFoldersByIdOrder(rootRes.folders, builtinRes.folders);
+  } else if (verbose) {
+    console.error(
+      `
+\u26A0\uFE0F \u83B7\u53D6\u77E5\u8BC6\u5E93\u5217\u8868\u5931\u8D25\uFF08\u5185\u7F6E\u7236\u7EA7\uFF09\uFF1A${builtinRes.reason}\uFF08\u5DF2\u4EC5\u7528\u6839\u8282\u70B9\u6570\u636E\u5408\u5E76\u5C55\u793A\uFF09`
+    );
+  }
+  if (options.ragOnly) {
+    folders = folders.filter((f) => f.ragStatus === true);
+  }
+  if (options.json) {
+    console.log(
+      JSON.stringify(
+        {
+          belongToId,
+          total: folders.length,
+          folders: folders.map((f) => ({
+            id: f.id,
+            name: f.name,
+            ragStatus: f.ragStatus,
+            createTime: f.createTime
+          }))
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (folders.length === 0) {
+    console.log(options.ragOnly ? "\n\u6682\u65E0\u5DF2\u5EFA RAG \u7D22\u5F15\u7684\u77E5\u8BC6\u5E93\u3002\n" : "\n\u6682\u65E0\u77E5\u8BC6\u5E93\u6587\u4EF6\u5939\u3002\n");
+    return;
+  }
+  const ragTag = (s) => s === true ? "\u2705 \u5DF2\u7D22\u5F15" : "\u2014";
+  const rows = folders.map((f) => ({
+    id: f.id,
+    name: f.name,
+    ragStatus: ragTag(f.ragStatus),
+    createTime: formatTime(f.createTime)
+  }));
+  const colWidths = {
+    id: Math.max(36, ...rows.map((r) => r.id.length)),
+    name: Math.max(4, ...rows.map((r) => [...r.name].length)),
+    ragStatus: Math.max(6, ...rows.map((r) => [...r.ragStatus].length)),
+    createTime: Math.max(10, ...rows.map((r) => r.createTime.length))
+  };
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - [...s].length));
+  const sep2 = `+-${"-".repeat(colWidths.id)}-+-${"-".repeat(colWidths.name)}-+-${"-".repeat(colWidths.ragStatus)}-+-${"-".repeat(colWidths.createTime)}-+`;
+  const header = `| ${pad("ID", colWidths.id)} | ${pad("\u540D\u79F0", colWidths.name)} | ${pad("RAG", colWidths.ragStatus)} | ${pad("\u521B\u5EFA\u65F6\u95F4", colWidths.createTime)} |`;
+  const lines = [
+    `
+\u77E5\u8BC6\u5E93\u5217\u8868\uFF08belongToId=${belongToId}\uFF0C\u5171 ${folders.length} \u6761\uFF09
+`,
+    sep2,
+    header,
+    sep2,
+    ...rows.map(
+      (r) => `| ${pad(r.id, colWidths.id)} | ${pad(r.name, colWidths.name)} | ${pad(r.ragStatus, colWidths.ragStatus)} | ${pad(r.createTime, colWidths.createTime)} |`
+    ),
+    sep2,
+    "",
+    options.ragOnly ? "\u{1F4A1} \u4F7F\u7528 --folder-id <id> \u6307\u5B9A\u4E0A\u65B9\u77E5\u8BC6\u5E93\uFF0C\u914D\u5408 rag query \u68C0\u7D22\u5BA2\u6237/\u4EA7\u54C1\u8D44\u6599\u3002\n" : "\u{1F4A1} \u4EC5\u663E\u793A RAG \u5DF2\u7D22\u5F15\u7684\u77E5\u8BC6\u5E93\uFF1A\u52A0 --rag-only \u53C2\u6570\u3002\n   \u7528 --folder-id <id> \u5728 rag query \u4E2D\u6307\u5B9A\u68C0\u7D22\u8303\u56F4\u3002\n"
+  ];
+  console.log(lines.join("\n"));
+}
+function register22(program2) {
+  const ragCmd = program2.command("rag").description(
+    "RAG \u77E5\u8BC6\u5E93\u68C0\u7D22\uFF08\u534F\u52A9\u5E7F\u544A\u6295\u653E\u3001\u62D3\u8BCD\u3001\u8D26\u6237\u8BCA\u65AD\u4E0E\u62A5\u544A\uFF1B\u9ED8\u8BA4 belongToId=account/me \u7684 companyId\uFF09"
+  );
+  ragCmd.command("list").description("\u5217\u51FA\u5F53\u524D\u4F01\u4E1A\u4E0B\u6240\u6709\u77E5\u8BC6\u5E93\u6587\u4EF6\u5939\uFF0C\u4F9B\u9009\u62E9\u5BA2\u6237/\u54C1\u724C\u68C0\u7D22\u8303\u56F4").option("--belong-to-id <id>", "\u4F01\u4E1A ID\uFF1B\u4E0D\u4F20\u5219\u4ECE GET /query/account/me \u53D6 companyId").option("--rag-only", "\u4EC5\u663E\u793A\u5DF2\u5EFA RAG \u5411\u91CF\u7D22\u5F15\uFF08ragStatus=true\uFF09\u7684\u77E5\u8BC6\u5E93", false).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u8F93\u51FA\u5B8C\u6574 JSON", false).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runRagList({
+        belongToId: opts.belongToId,
+        ragOnly: opts.ragOnly,
+        token: opts.token,
+        json: opts.json,
+        verbose: opts.verbose
+      });
+    }
+  );
+  ragCmd.command("query").description("\u6309\u5173\u952E\u8BCD\u68C0\u7D22\u5DF2\u7EB3\u5165\u5411\u91CF\u7684\u77E5\u8BC6\u7247\u6BB5\uFF08GET cutapi/v1/material/queryknowledges\uFF09").requiredOption("-q, --query <text>", "\u68C0\u7D22\u5173\u952E\u8BCD\u6216\u95EE\u53E5").option("--belong-to-id <id>", "\u4F01\u4E1A ID\uFF1B\u4E0D\u4F20\u5219\u4ECE GET /query/account/me \u53D6 companyId").option("--source-id <ids>", "\u7D20\u6750\u6587\u4EF6 ID\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u53EF\u9009\uFF0Cqueryknowledges \u7684 sourceid\uFF09").option("--folder-id <ids>", "\u6587\u4EF6\u5939 ID\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u53EF\u9009\uFF0Ccomid\uFF09").option("--top-k <n>", "\u8FD4\u56DE\u6761\u6570\uFF0C3\u201330\uFF08\u9ED8\u8BA4 7\uFF09", "7").option("--belong-to <n>", "\u5F52\u5C5E\u7C7B\u578B\uFF08\u9ED8\u8BA4 0\uFF0C\u4F01\u4E1A\uFF09", "0").option("--tags <tags>", "\u6807\u7B7E\u8FC7\u6EE4\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u4E0D\u4F20\u5219\u4E0D\u8FC7\u6EE4\u6807\u7B7E\uFF08\u5168\u91CF\u68C0\u7D22\uFF09").option("--category <categories>", "\u5206\u7C7B\u8FC7\u6EE4\uFF0C\u9017\u53F7\u5206\u9694").option(
+    "--partition <wiki|default>",
+    "\u68C0\u7D22\u5206\u533A\uFF08queryknowledges \u7684 partition\uFF0C\u9ED8\u8BA4 default\uFF09",
+    "default"
+  ).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u8F93\u51FA\u5B8C\u6574 JSON", false).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runRagQuery({
+        query: opts.query,
+        belongToId: opts.belongToId,
+        sourceId: opts.sourceId,
+        folderId: opts.folderId,
+        topK: opts.topK ? parseInt(opts.topK, 10) : void 0,
+        belongTo: opts.belongTo ? parseInt(opts.belongTo, 10) : void 0,
+        tags: opts.tags,
+        category: opts.category,
+        partition: opts.partition,
+        token: opts.token,
+        json: opts.json,
+        verbose: opts.verbose
+      });
+    }
+  );
+}
+
 // src/commands/account-manage/share.ts
 init_auth();
 init_cli_json_snapshot();
@@ -113567,7 +114133,7 @@ async function runAccountBmBind(opts) {
 }
 
 // src/commands/account-manage-register.ts
-function register22(program2) {
+function register23(program2) {
   const accountCmd = program2.command("account").description("\u5E7F\u544A\u8D26\u6237\u7BA1\u7406\uFF1AOAuth \u6DFB\u52A0\u6388\u6743\u3001\u89E3\u9664\u5173\u8054\uFF08\u89E3\u7ED1\uFF09\u3001Google MCC \u7ED1\u5B9A/\u89E3\u7ED1\u3001\u8D26\u53F7\u5206\u4EAB");
   accountCmd.command("delink").description(
     "\u89E3\u9664\u6388\u6743\uFF1A\u65AD\u5F00\u5E7F\u544A\u8D26\u6237\u4E0E\u5F53\u524D\u4E1D\u8DEF\u8D5E\u8D26\u53F7\u7684\u5173\u8054\uFF08\u7F51\u9875 manageAccounts\u300C\u89E3\u9664\u6388\u6743\u300D\uFF1B--id \u6216 --ids\uFF09"
@@ -115003,7 +115569,7 @@ TikTok \u6CE8\u518C\u5730\u5217\u8868\uFF08\u7B2C 1 \u9875\uFF0C\u672C\u9875 ${r
 }
 
 // src/commands/open-account-register.ts
-function register23(program2) {
+function register24(program2) {
   const openAccountCmd = program2.command("open-account").description("\u5F00\u6237\u7533\u8BF7\uFF08Google / TikTok / Yandex / Bing / Kwai\uFF09");
   openAccountCmd.command("list-groups").description("\u67E5\u8BE2\u5E7F\u544A\u4E3B\u7EC4\u5217\u8868\uFF08\u83B7\u53D6\u5F00\u6237\u6240\u9700\u7684 --advertiser-id\uFF09").option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA", false).option(
     "--json-out <path>",
@@ -115215,7 +115781,7 @@ function register23(program2) {
 }
 
 // src/commands/diagnostic.ts
-function register24(program2) {
+function register25(program2) {
   program2.command("diagnostic").description("Google \u5E7F\u544A\u8BCA\u65AD\uFF1A\u8F93\u51FA\u4E1D\u8DEF\u8D5E\u5E7F\u544A\u8BCA\u65AD\u62A5\u544A\u9875\u9762\u5730\u5740").action(() => {
     console.log("\nGoogle \u5E7F\u544A\u8BCA\u65AD\n");
     console.log(
@@ -115279,7 +115845,8 @@ var REGISTRARS = [
   register21,
   register22,
   register23,
-  register24
+  register24,
+  register25
 ];
 for (const reg of REGISTRARS) reg(program);
 program.parseAsync();

package/dist/skill/SKILL.md

@@ -2,7 +2,7 @@
 name: siluzan-tso
 description: >-
   Siluzan TSO 广告 skill（siluzan-tso-cli）：Google/Bing/Yandex/TikTok/Kwai 账户开户、授权与分享、数据与消耗、Google 广告管理、发票与转账、优化报告与智能预警、TikTok/Meta 线索。
-  各能力执行细节按本文「功能以及对应文档」表路由到 references/；周期报告、OKKI 周报、Google 账户询盘分析等固定触发模板见 report-templates/ 与 REPORT-WORKFLOW.md。
+  各能力执行细节按本文「功能以及对应文档」表路由到 references/；周期报告、OKKI 周报、Google 账户询盘分析等固定触发模板见 report-templates/ 与 REPORT-WORKFLOW.md，有提供rag(知识库查询)
 license: MIT
 metadata:
   requires: nodejs,siluzan-tso-cli
@@ -43,6 +43,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | `references/open-account-by-media.md`          | 各媒体开户、参数与资料要求                                                                                                                                                                                                                                                                                                               |
 | `references/google-ads.md`                     | Google Ads 创建、修改、优化与管理；含 `ad list` 等读命令的 JSON 拒审字段。**搜索广告方案/计划**见本文开篇必读表与 `google-ads-rules/`（launch 模板、按需落地页推断专篇） |
 | `references/keyword-planner-workflows.md`      | Google 关键字推荐与拓词：`keyword` / `google-analysis` / `ad` 多命令编排；关键词规划师、执行步骤 |
+| `references/rag.md`                            | **知识库检索**：为拓词、广告方案、诊断/询盘报告等提供客户产品/行业事实依据（`rag list` + `rag query`） |
 | `references/reporting.md`                      | Siluzan TSO 优化报告（Google/TikTok）的生成、推送与查看                                                                                                                                                                                                                                                                                  |
 | `references/account-analytics.md`              | 广告平台账户分析数据拉取与分析/诊断报告模板                                                                                                                                                                                                                                                                                              |
 | `references/google-analysis-batch.md`          | **多账户 × 多维度** Google 数据批处理引擎（`run/resume/status`）；产物目录、退出码、stdout 协议、错误分类、resume 语义                                                                                                                                                                                                                   |
@@ -80,6 +81,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 
 - **报告生成（推荐）**：`google-analysis … --json-out <目录>`（通过 `--sections` 选取维度），**须编写并执行代码**（Node/Python）从目录读取 JSON 完成计算再写出最终文件。详见 `references/account-analytics.md`。**禁止**用 `Read` 扫 JSON 后在对话里手填数，**禁止**在报告脚本中以字面量写死应从 JSON 得到的业务数据。
 - **广告账户**：开户→`references/open-account-by-media.md`；管理→`references/accounts.md`；分析→`references/account-analytics.md`；Google 广告→`references/google-ads.md`
+- **需要客户/产品背景**（拓词、方案、报告背景段）：先 `references/rag.md` → `rag list` + `rag query`，再衔接 `keyword` / `ad` / `google-analysis`
 - **仅调用接口、无需你输出**：优化记录（`references/optimize.md`）、线索表单（`references/clue.md`）、预警（`references/forewarning.md`）、财务（`references/finance.md`）
 
 **写报告前必读**：`stats` / `balance` / `list-accounts` 里的 `status` 只表示**广告账户**是否可用，**不能**当作**广告系列**是否启用；系列状态须用 `ad campaigns`。

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.20-beta.2",
-  "publishedAt": 1778828241807
+  "version": "1.1.20-beta.4",
+  "publishedAt": 1778829586058
 }