免费开源的WPS AI插件 察元AI助手:助手注册表：输入来源、输出格式与写回动作
摘要assistantRegistry 导出 INPUT_SOURCE_OPTIONS、DOCUMENT_ACTION_OPTIONS 等常量数组驱动设置界面与运行时校验。自定义助手应复用这些枚举避免魔法字符串漂移。关键词assistantRegistry;documentAction;枚举扩展阅读与维护提示本篇围绕「助手注册表输入来源、输出格式与写回动作」组织材料。仓库内与主题最直接相关的检索词包括assistantRegistry、documentAction、枚举。建议在阅读正文所列片段后用 IDE 全局搜索这些符号沿 import 与调用栈向上追问「谁在什么时机调用」而不是只记住单文件路径。摘要所概括的要点为assistantRegistry 导出 INPUT_SOURCE_OPTIONS、DOCUMENT_ACTION_OPTIONS 等常量数组驱动设置界面与运行时校验。自定义助手应复用这些枚举避免魔法字符串漂移。落地到排障时可把现象粗分为三类交叉验证配置是否按预期写入持久化介质WPS COM 上下文是否可用例如是否缺少 ActiveDocument以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类需要与相邻篇目拼成完整拼图。教程文件名「09-bianshen-moban-guize-yu-wendang-shenji.md」仅用于导航与排序不等价于源码模块名。若正文中的行号与本地分支不一致多半因合并导致行偏移此时应以函数名、导出名为锚重新检索团队若维护了生成脚本可在变更大段源码后重新运行以保持摘录大致对齐。本文刻意避免对产品能力做营销式承诺所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型应在网关、证书与代理层收口而不是假设加载项能绕过浏览器安全模型。若你同时阅读 docs/chayuan-llm-chain-series可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序再回到本教程看数据结构、默认值与修改风险面两者互补不重复堆砌功能列表。正文1. 输入与输出枚举选项 value 与 label 成对出现前端下拉与持久化字段应使用 value。阅读源码摘录时请把它当作「定位入口」而非完整实现同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前建议用最小文档手工走一遍相关助手或对话框并观察任务清单与日志中的字段是否与预期一致再决定是否做数据迁移或配置重置。// src/utils/assistantRegistry.js 第4-31行 const INPUT_SOURCE_SELECTION_PREFERRED selection-preferred const INPUT_SOURCE_SELECTION_ONLY selection-only const INPUT_SOURCE_DOCUMENT document export const INPUT_SOURCE_OPTIONS [ { value: INPUT_SOURCE_SELECTION_PREFERRED, label: 优先使用当前选中无选中时回退全文 }, { value: INPUT_SOURCE_SELECTION_ONLY, label: 仅处理当前选中内容 }, { value: INPUT_SOURCE_DOCUMENT, label: 始终处理全文 } ] export const DOCUMENT_ACTION_OPTIONS [ { value: replace, label: 替换文档内容 }, { value: insert, label: 插入到光标处 }, { value: insert-after, label: 插入到每段后面 }, { value: prepend, label: 插入到文档最前面 }, { value: comment, label: 添加批注 }, { value: link-comment, label: 链接形式批注 }, { value: comment-replace, label: 批注 替换 }, { value: append, label: 追加到文末 }, { value: none, label: 仅生成结果不写回文档 } ] export const OUTPUT_FORMAT_OPTIONS [ { value: plain, label: 纯文本 }, { value: markdown, label: Markdown }, { value: bullet-list, label: 项目符号列表 }, { value: json, label: JSON } ]2. 运行时能力默认值DEFAULT_RUNTIME_CAPABILITIES 描述 forceDocumentAction、mediaKind 等mergeDefinitionRuntimeCapabilities 用于与单助手定义合并。阅读源码摘录时请把它当作「定位入口」而非完整实现同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前建议用最小文档手工走一遍相关助手或对话框并观察任务清单与日志中的字段是否与预期一致再决定是否做数据迁移或配置重置。// src/utils/assistantRegistry.js 第46-60行 /** 助手运行时能力默认值具体助手可在定义上挂 runtimeCapabilities 覆盖 */ export const DEFAULT_RUNTIME_CAPABILITIES Object.freeze({ /** 非空时强制使用该文档写回动作如拼写检查固定批注 */ forceDocumentAction: null, /** image | audio | video走多模态生成与错误分类 */ mediaKind: null }) export function mergeDefinitionRuntimeCapabilities(definition) { const patch definition?.runtimeCapabilities return { ...DEFAULT_RUNTIME_CAPABILITIES, ...(patch typeof patch object ? patch : {}) } }
)
