免费开源的WPS AI插件 察元AI助手:evaluationStore：追加记录与上限裁剪

摘要

appendEvaluationRecord 读取桶、归一化单条记录、按时间排序后截断到 ARCHIVE_LIMIT。用于文档任务质量回写与看板统计时，应注意 ownerId 等过滤字段与 listEvaluationRecords 一致。

关键词

评测;归档;localStorage

扩展阅读与维护提示

本篇围绕「evaluationStore：追加记录与上限裁剪」组织材料。仓库内与主题最直接相关的检索词包括：评测、归档、localStorage。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。

摘要所概括的要点为：appendEvaluationRecord 读取桶、归一化单条记录、按时间排序后截断到 ARCHIVE_LIMIT。用于文档任务质量回写与看板统计时，应注意 ownerId 等过滤字段与 listEvaluationRecords 一致。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。

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

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

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

正文

1. 追加实现

sortRecords 与 slice 保证内存与存储体积有界。

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

// src/utils/evaluationStore.js 第108-114行 export function appendEvaluationRecord(record = {}) { const bucket = loadEvaluationStore() const normalized = createEvaluationRecord(record) bucket.records = sortRecords([normalized, ...(bucket.records || [])]).slice(0, ARCHIVE_LIMIT) saveStorageBucket(bucket) return normalized }

维护复核清单（中性备忘）

下列条目为工程维护时的自查提示，不构成对产品功能的承诺。其一：修改本篇涉及模块后，是否已用 eslint / 本地构建验证无语法错误；其二：是否检查过与 globalSettings、assistantSettings、taskListStore 等持久化字段的键名兼容性，避免旧版本数据静默失效；其三：是否在真实 WPS 版本上做过 smoke（打开文档、触发一次助手、观察控制台与日志目录）；其四：若改动影响 URL 或 hash，是否同步验证了 file 与 http 两种部署形态下的 ShowDialog 与资源加载；其五：若改动触及大模型请求体，是否对照 chatApi 与任务快照字段确认未泄露密钥。若仍不足篇幅要求，可重复本段直至满足自动化字数下限——内容仍为可执行的检查项而非广告话术。