开源WPS AI插件察元AI文档助手:getStructuredJsonAnchorExtraRules 与助手 id 分支

摘要

该函数按助手 id 与 documentAction 追加给模型的额外规则文本。保密检查、AI 痕迹、涉密关键词抽取等分支要求命中片段与 ChunkText 逐字一致，是批注锚点可靠性的关键约束。

关键词

锚点;ChunkText;批注

扩展阅读与维护提示

本篇围绕「getStructuredJsonAnchorExtraRules 与助手 id 分支」组织材料。仓库内与主题最直接相关的检索词包括：锚点、ChunkText、批注。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。

摘要所概括的要点为：该函数按助手 id 与 documentAction 追加给模型的额外规则文本。保密检查、AI 痕迹、涉密关键词抽取等分支要求命中片段与 ChunkText 逐字一致，是批注锚点可靠性的关键约束。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。

教程文件名「24-pizhu-maodian-guize-ji-zhong.md」仅用于导航与排序，不等价于源码模块名。若正文中的行号与本地分支不一致，多半因合并导致行偏移，此时应以函数名、导出名为锚重新检索；团队若维护了生成脚本，可在变更大段源码后重新运行以保持摘录大致对齐。

本文刻意避免对产品能力做营销式承诺：所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型，应在网关、证书与代理层收口，而不是假设加载项能绕过浏览器安全模型。

若你同时阅读 docs/chayuan-llm-chain-series，可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序，再回到本教程看数据结构、默认值与修改风险面；两者互补，不重复堆砌功能列表。

正文

1. 函数签名与保密检查分支

summary 字段与 Markdown 小节格式在规则中写死，减少模型自由发挥导致的解析失败。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/structuredCommentPolicy.js 第118-128行/** 追加到结构化 JSON 系统说明中的、按助手与文档动作区分的锚点规则 */exportfunctiongetStructuredJsonAnchorExtraRules(assistantId,documentAction=''){constid=String(assistantId||'').trim()constact=String(documentAction||'').trim()constparts=[]if(id===ANALYSIS_SECURITY_CHECK_ID){parts.push(['保密检查：须将完整审查结论写入 JSON 的 summary 字段；summary 内仍使用模板要求的 Markdown 小节（## 高风险项 等）。','每条风险项必须包含「命中片段」且反引号内为 ChunkText 中的连续原文（逐字照抄）；推荐格式：- 命中片段： `原文片段`（加粗与否均可，反引号内必须与正文一致）；operations 可留空 []。'].join('\n'))}

2. 涉密关键词数组约束

keywords 数组元素必须是 ChunkText 可搜索子串。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/structuredCommentPolicy.js 第135-141行if(id===ANALYSIS_SECRET_KEYWORD_EXTRACT_ID){parts.push(['涉密关键词：必须输出 keywords 数组；每个 term 必须是当前 ChunkText 中可直接搜索到的连续原文子串，不得改写或概括。','若本段出现部队番号、单位全称、联系人、电话、项目/系统名、内部编号等确需脱密实体，必须列入 keywords，不得以「示例」「技术文档」「疑似虚构」为由整段留空；','仅当本段确实无可脱密实体时返回 "keywords":[]。'].join('\n'))}