免费开源的WPS AI插件 察元AI助手:结构化流水线:模式集合与 JSON 候选提取
摘要assistantStructuredPipeline 用 REVISION_ASSISTANTS、TRANSFORM_ASSISTANTS 等集合区分拼写检查、翻译改写等是否走结构化 JSON。extractJsonCandidate 从模型输出中抽取代码块或首尾大括号片段。关键词JSON;schema;助手模式扩展阅读与维护提示本篇围绕「结构化流水线模式集合与 JSON 候选提取」组织材料。仓库内与主题最直接相关的检索词包括JSON、schema、助手模式。建议在阅读正文所列片段后用 IDE 全局搜索这些符号沿 import 与调用栈向上追问「谁在什么时机调用」而不是只记住单文件路径。摘要所概括的要点为assistantStructuredPipeline 用 REVISION_ASSISTANTS、TRANSFORM_ASSISTANTS 等集合区分拼写检查、翻译改写等是否走结构化 JSON。extractJsonCandidate 从模型输出中抽取代码块或首尾大括号片段。落地到排障时可把现象粗分为三类交叉验证配置是否按预期写入持久化介质WPS COM 上下文是否可用例如是否缺少 ActiveDocument以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类需要与相邻篇目拼成完整拼图。教程文件名「14-jiegouhua-json-liushuixian-yu-banben.md」仅用于导航与排序不等价于源码模块名。若正文中的行号与本地分支不一致多半因合并导致行偏移此时应以函数名、导出名为锚重新检索团队若维护了生成脚本可在变更大段源码后重新运行以保持摘录大致对齐。本文刻意避免对产品能力做营销式承诺所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型应在网关、证书与代理层收口而不是假设加载项能绕过浏览器安全模型。若你同时阅读 docs/chayuan-llm-chain-series可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序再回到本教程看数据结构、默认值与修改风险面两者互补不重复堆砌功能列表。正文1. 版本与集合STRUCTURED_PIPELINE_SCHEMA_VERSION 与各类助手集合在同一文件维护修改批次协议时应 bump 版本并评估向后兼容。阅读源码摘录时请把它当作「定位入口」而非完整实现同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前建议用最小文档手工走一遍相关助手或对话框并观察任务清单与日志中的字段是否与预期一致再决定是否做数据迁移或配置重置。// src/utils/assistantStructuredPipeline.js 第16-31行 export const STRUCTURED_PIPELINE_SCHEMA_VERSION 2026-03-structured-batch-v1 /** 仅内置「拼写与语法检查」需结构化 JSON 精确定位「纠正拼写和语法」走与普通助手相同的单次/分段 plain 链路 */ const REVISION_ASSISTANTS new Set([ spell-check ]) const TRANSFORM_ASSISTANTS new Set([ translate, analysis.rewrite, analysis.polish, analysis.formalize, analysis.simplify, analysis.term-unify, analysis.policy-style ])2. extractJsonCandidate优先解析 fenced code block其次对象/数组正则最后退回原文。阅读源码摘录时请把它当作「定位入口」而非完整实现同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前建议用最小文档手工走一遍相关助手或对话框并观察任务清单与日志中的字段是否与预期一致再决定是否做数据迁移或配置重置。// src/utils/assistantStructuredPipeline.js 第33-50行 function safeJsonParse(text) { try { return JSON.parse(text) } catch (_) { return null } } export function extractJsonCandidate(text) { const raw String(text || ).trim() if (!raw) return const fenced raw.match(/(?:json)?\s*([\s\S]*?)\s*/i) if (fenced?.[1]) return fenced[1].trim() const objectMatch raw.match(/\{[\s\S]*\}/) if (objectMatch) return objectMatch[0] const arrayMatch raw.match(/\[[\s\S]*\]/) if (arrayMatch) return arrayMatch[0] return raw