摘要
taskListStore 使用 localStorage 键 NdTaskList，并在解析时兼容旧版「纯数组」结构。Popup 与主窗之间通过 storage 事件同步任务状态，长任务 UI 应只通过 addTask/updateTask 写入。
关键词
localStorage;任务状态;Popup
扩展阅读与维护提示
本篇围绕「任务清单存储与跨窗口同步」组织材料。仓库内与主题最直接相关的检索词包括：localStorage、任务状态、Popup。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。
摘要所概括的要点为：taskListStore 使用 localStorage 键 NdTaskList，并在解析时兼容旧版「纯数组」结构。Popup 与主窗之间通过 storage 事件同步任务状态，长任务 UI 应只通过 addTask/updateTask 写入。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。
教程文件名「11-zidingyi-zhushou-renwu-bianpai-yu-qingdan.md」仅用于导航与排序，不等价于源码模块名。若正文中的行号与本地分支不一致，多半因合并导致行偏移，此时应以函数名、导出名为锚重新检索；团队若维护了生成脚本，可在变更大段源码后重新运行以保持摘录大致对齐。
本文刻意避免对产品能力做营销式承诺：所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型，应在网关、证书与代理层收口，而不是假设加载项能绕过浏览器安全模型。
若你同时阅读 docs/chayuan-llm-chain-series，可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序，再回到本教程看数据结构、默认值与修改风险面；两者互补，不重复堆砌功能列表。
正文
1. 存储键与版本
STORAGE_KEY、STORAGE_VERSION、ARCHIVE_LIMIT 控制持久化文件名与归档长度。
阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。
// src/utils/taskListStore.js 第7-16行
const STORAGE_KEY = 'NdTaskList'
const STORAGE_VERSION = 1
const ARCHIVE_LIMIT = 200
/** @typedef {'pending'|'running'|'completed'|'failed'|'cancelled'|'abnormal'} TaskStatus */
/** @typedef {{ id: string, type: string, title: string, status: TaskStatus, progress?: number, total?: number, current?: number, data?: object, error?: string, createdAt: string, startedAt?: string, endedAt?: string, updatedAt: string }} Task */
let tasks = []
let archivedTasks = []
let listeners = new Set()
2. addTask 形状
任务对象包含 id、type、status、时间戳等字段，persistAndNotify 在每次变更后触发。
阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。
// src/utils/taskListStore.js 第147-173行
/**
* 添加任务
* @param {Partial<Task> & { type: string, title: string }} task
* @returns {string} 任务 id
*/
export function addTask(task) {
const id = task.id || `task_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`
const now = new Date().toISOString()
const t = {
id,
type: task.type || 'unknown',
title: task.title || '未命名任务',
status: task.status || 'pending',
progress: task.progress ?? 0,
total: task.total ?? 0,
current: task.current ?? 0,
data: task.data ?? {},
error: task.error,
createdAt: task.createdAt || now,
startedAt: task.startedAt || now,
endedAt: task.endedAt || '',
updatedAt: now
}
tasks.push(t)
persistAndNotify()
return id
}
