# 【Skill名称】 ## 适用场景 当【岗位/领域】需要基于【输入材料】完成【具体任务】并输出【标准交付物】时使用。 ## 不适用场景 - 涉及最终审批、付款、签署、处罚等高风险动作时，不直接给最终结论。 - 输入材料缺失关键字段时，不编造，应先列出补充问题。 - 需要实时调用核心系统权限时，仅输出建议，不代替系统操作。 ## 使用者 - 【岗位1】 - 【岗位2】 ## 输入材料 - 必填：【材料1】 - 选填：【材料2】 - 禁止：【未脱敏高敏材料】 ## 执行流程 1. 检查材料完整性。 2. 提取关键事实并标注来源。 3. 按规则逐项判断。 4. 标注不确定项和风险项。 5. 输出标准化结果和人工确认点。 ## 输出标准 输出【表格/报告/清单/邮件/方案】，必须包含【字段列表】。 ## 测试用例 1. 正常输入。 2. 缺失输入。 3. 格式混乱。 4. 高风险内容。 5. 空输入。 ## 维护信息 Owner：【姓名/岗位】 版本：v0.1 状态：草稿/已测待修/可试用

请你作为 Skill 评测专家，按以下五个维度评测我粘贴的 Skill： 1. 规范（15分）：名称、结构、字段、版本、Owner 是否完整。 2. 触发（20分）：是否写清 WHEN / WHEN NOT，是否有正例问法和反例场景。 3. 执行质量（25分）：是否有具体工作流、输入要求、输出模板、示例、失败处理和人工断点。 4. 可验证与 Benchmark（25分）：是否有测试用例、预期行为、评分规则、结果落盘和复跑说明。 5. 可维护（15分）：是否有 Owner、版本、更新记录、引用材料和后续迭代建议。 请输出： - 总分和等级； - 五维评分表； - 正例命中 / 反例误触发判断； - P0 / P1 / P2 整改清单； - 可直接复制的改写后 Skill 片段； - 不少于20条测试用例； - benchmark 落盘目录结构，包含 method、cases、scores、report 和 evidence。 被评测 Skill 如下： 【粘贴 Skill Markdown】

# AI流程管理专家插件 · 开发PRD > 用途：把这份 PRD 完整粘贴给 Qoder（或任何具备代码生成能力的 Agent IDE），它就能从 0 到 1 复刻出一个与原版功能等价的 Chrome 浏览器插件。 > 版本：v0.1.3 对齐版（基于"AI流程管理专家插件"现网版本逆向沉淀） > 作者：流程经理 · 冯周冲 --- ## 0. TL;DR（一段话讲清楚） 做一个 **Chrome MV3 浏览器扩展**，名字叫 **"AI流程管理专家插件"**。 点击图标会从右侧弹出一个常驻 **侧边栏面板**，面板里能： 1. **读取当前页面的文本** 当作上下文； 2. **挂多家大模型**（Kimi / DeepSeek / 智谱 / 任意 OpenAI 兼容接口），用户自己填 API Key； 3. **管理一组本地 Skill**（12 个开箱即用的流程管理 Skill，存放为 Markdown 文件），用户在输入框打 `/` 就能选 Skill 并把当前页面/上传文件作为输入跑起来； 4. **本地知识库**：上传 txt / md / docx / pdf / xlsx / csv / json，浏览器内分片存 IndexedDB，对话时自动检索拼进上下文； 5. **统一对话区**：Skill 结果 + 自由追问 共用一个 chat 流，支持 Mermaid 渲染、Excel 下载、HTML 报告下载、附件上传、语音输入。 最终交付物：一个文件夹结构跟"manifest.json + 一堆 .js + skills/ + libs/"对齐的插件，能在 `chrome://extensions` "加载已解压扩展程序"直接跑。 --- ## 1. 产品定位 | 项 | 内容 | |----|------| | 产品名 | AI流程管理专家插件 | | 一句话定位 | 流程经理在浏览器里随手能用的"流程管理专家助理" | | 目标用户 | 企业流程经理、咨询顾问、流程负责人(GPO/BPO)、变革项目经理 | | 核心价值 | 把 12 个流程管理领域的"专家级 Prompt（Skill）"装进浏览器，配合大模型 + 当前页面 + 自有知识库，实现"边浏览边输出"咨询级交付物 | | 商业模式 | 用户自带 API Key，插件本身不收费、不联网回传数据 | | 核心差异点 | ① 12 个内置专业流程 Skill；② 完全本地化；③ 多模型自由切换；④ 知识库内置；⑤ 输出物可直接下载 HTML/Excel | --- ## 2. 角色与场景 ### 2.1 用户画像 - **流程经理 / 咨询顾问**：每天要写流程文件、做流程评审、出诊断报告 - **业务负责人**：需要快速理解 / 评审 / 复盘自己负责的流程 - **变革项目经理**：要做流程成熟度评估、流程架构规划、项目孵化清单 ### 2.2 典型场景 | # | 场景 | 触发动作 | 期望结果 | |---|------|----------|----------| | S1 | 看公司 wiki 上的流程文件，想现场评审 | 打开 panel → 点"读取页面" → 输入 `/流程设计评审` | 桌面下载一份 HTML 评审报告 | | S2 | 老板让做企业级流程架构 | panel → `/流程架构规划` → 答几个问题 | 桌面下载咨询级 HTML 架构报告（L1-L3 全量） | | S3 | 拿到一份 PDF 流程文件 | 把 PDF 拖进面板附件区 → `/流程评审` | 解析 PDF 后产出评审报告 | | S4 | 不调 Skill，单纯问"这个流程哪里有问题" | 直接打字提问 | AI 自动结合页面 / 附件 / 知识库回复 | --- ## 3. 信息架构 ``` 浏览器图标（icons/icon16/48/128.png） └─ 点击图标 → popup.html（200px 小弹窗） ├─ 📋 打开分析面板 → 在当前网页右侧注入 panel └─ ⚙️ 设置 → 打开 panel 并跳到设置页 panel（侧边栏注入式，宽度约 420px，可拖拽） ├─ 顶部 Header：Logo + 标题 + ⚙ 设置 + ✕ 关闭 ├─ 上下文条：● 状态点 + "已读取 / 未读取" + 📋 读取页面 + ↺ 刷新 ├─ 设置覆盖层（点 ⚙ 弹出，全屏覆盖 panel） │ ├─ Tab1 🧩 Skill：已安装 / 安装新 Skill / 来源设置 │ ├─ Tab2 🤖 模型：服务商 + API Key + 模型 + 自定义URL │ └─ Tab3 📚 知识库：上传区 + 进度条 + 片段列表 ├─ 主体对话区（chat-history）：消息流，支持 Markdown / Mermaid / 表格 └─ 输入区 ├─ 📎 附件按钮（多文件） ├─ 输入框（输 "/" 弹 Skill 浮层） ├─ 🎤 语音按钮 └─ ↑ 发送 ``` --- ## 4. 文件清单与职责 > 以下为最终目录结构，**任何文件都不能少**，且文件名要严格一致（panel.js 在 manifest 的 web_accessible_resources 里被点名）。 ``` AI流程管理专家插件/ ├── manifest.json # MV3 清单 ├── popup.html # 工具栏图标弹窗 ├── popup.js # 弹窗按钮 → 注入/打开 panel ├── panel.html # 主面板 UI ├── panel.css # 主面板样式 ├── panel_init.js # 面板挂载前的早期初始化 ├── panel.js # 主面板核心逻辑（最大文件，~150KB） ├── background.js # service worker，路由消息、注入面板、跨域代理 ├── content_script.js # 当前页面文本抓取（被 background 动态注入） ├── bridge_client.js # 大模型多 provider 适配层 + 流式调用 ├── skill_runtime.js # Skill 执行引擎（解析 frontmatter + 拼 prompt + 调 LLM） ├── sandbox.js # 安全沙箱：执行 Skill 里的 JS 代码块 ├── file_parser.js # 多格式文件解析（txt/md/docx/pdf/xlsx/csv/json） ├── knowledge_store.js # IndexedDB 知识库（写入/检索/分片） ├── offscreen.html / offscreen.js# 离屏文档：解析 PDF / 大文件，避免阻塞 SW ├── icons/ │ ├── icon16.png │ ├── icon48.png │ └── icon128.png ├── libs/ # 第三方库（本地化，离线可用） │ ├── mermaid.min.js │ ├── xlsx.min.js # SheetJS 导出 Excel │ ├── mammoth.browser.min.js # docx 解析 │ ├── pdf.min.js # pdf.js │ └── pdf.worker.min.js └── skills/ # 12 个内置 Skill（Markdown） ├── process-planning.md ├── process-design-review.md ├── process-detail-design.md ├── process-high-level-design.md ├── process-maturity-assessment.md ├── process-mining.md ├── process-quiz.md ├── process-exam.md ├── digital-consulting-report.md ├── skill-mining.md ├── 方案评估.md └── 流程审批分析.md ``` --- ## 5. manifest.json（直接复制） ```json { "manifest_version": 3, "name": "AI流程管理专家插件", "version": "0.1.3", "description": "汇聚行业优秀实践，辅助流程规划、建设、运营全生命周期管理，你的AI流程管理专家助手", "permissions": ["activeTab", "scripting", "storage", "unlimitedStorage", "offscreen"], "host_permissions": [ "https://dashscope.aliyuncs.com/*", "https://api.moonshot.cn/*", "https://api.deepseek.com/*", "https://open.bigmodel.cn/*", "https://www.bing.com/*", "https://www.google.com/*", "https://html.duckduckgo.com/*" ], "optional_host_permissions": ["https://*/*", "http://localhost/*", "http://127.0.0.1/*"], "background": { "service_worker": "background.js" }, "action": { "default_title": "AI流程管理（点击打开/关闭面板）" }, "web_accessible_resources": [{ "resources": [ "panel.html","panel.css","panel_init.js","panel.js", "bridge_client.js","skill_runtime.js","sandbox.js", "file_parser.js","knowledge_store.js", "skills/*","libs/*", "offscreen.html","offscreen.js" ], "matches": ["http://*/*","https://*/*","file:///*"] }], "icons": { "16": "icons/icon16.png", "48": "icons/icon48.png", "128": "icons/icon128.png" } } ``` > ⚠️ 注意：`action` 不带 `default_popup`，因为我们要在 background 监听 `chrome.action.onClicked` 来切换 panel 显示/隐藏。 > 如果想保留 popup，则 popup 里再放"打开分析面板"按钮，二选一。本 PRD 默认 **保留 popup.html**，由 popup 触发面板注入。 --- ## 6. 各模块详细规格 ### 6.1 background.js（service worker） **职责清单**： 1. 监听 `chrome.action.onClicked`：往当前 Tab 注入 / 切换 panel.html iframe 2. 维护一个全局 message bus，路由 panel ↔ content_script ↔ offscreen 之间的通信 3. **CORS 代理**：当 panel 直接 fetch 第三方搜索引擎被 CORS 拦截时，由 SW 转发 4. 大模型流式调用的"中转站"（可选，不强制；如果直接在 panel 里 fetch 也行） 5. 启动时注册 offscreen document（用于解析大文件） **关键消息类型**（建议用 type 字段路由）： ``` { type: 'PANEL_TOGGLE' } { type: 'PAGE_READ_REQUEST', tabId } { type: 'PAGE_READ_RESULT', text, title, url } { type: 'LLM_CALL', provider, apiKey, model, messages, stream:true } { type: 'LLM_CHUNK', chunk } / { type:'LLM_DONE' } / { type:'LLM_ERROR' } { type: 'OFFSCREEN_PARSE', file:{name,type,arrayBuffer} } { type: 'OFFSCREEN_RESULT', text } ``` ### 6.2 content_script.js **职责**： - 由 background.js 通过 `chrome.scripting.executeScript` **按需注入**（不在 manifest 里静态声明） - 抓取页面正文：`document.title` + `document.body.innerText`，简单清洗（删多空行） - 同时把当前 URL 一起回传 > 静态 content script 在 manifest 里不声明，避免在所有页面常驻，节省内存和提高隐私性。 ### 6.3 panel_init.js 仅负责：在 panel.html 加载完成前，做 try/catch 包装的全局错误兜底，防白屏。 ### 6.4 panel.js（主逻辑，最复杂） **功能模块（按代码区块组织）**： 1. **状态管理**：`AppState = { skills:[], currentSkill:null, messages:[], context:null, model:{provider,apiKey,model,customUrl}, kb:[] }`，全部用 `chrome.storage.local` 持久化 2. **设置面板**：3 个 Tab 切换（Skill / 模型 / 知识库），逻辑各自独立 3. **Skill 列表渲染**：从 `skills/*.md` 读取（`chrome.runtime.getURL`），解析 frontmatter（name + description + 触发词），渲染列表卡片 4. **Skill 安装新增**： - 直接粘贴：把内容写进 `chrome.storage.local` 的 `customSkills[]` - URL 安装（可隐藏）：fetch 远端 .md 5. **模型设置**： - 5 个 provider 的下拉 - "获取模型"按钮：调对应 provider 的 `/v1/models` 列出可用模型 - 配置后存 `chrome.storage.local.model` 6. **知识库**： - 上传 → 调 file_parser.js 解析 → 切片（每片 800 字，重叠 100 字）→ 存 IndexedDB - 列表展示：按来源文件分组，可单条删 / 全清 7. **统一对话区**： - 输入"/"弹 Skill 浮层（搜索过滤） - 选中 Skill → 把 Skill 的 prompt + 当前 context（页面文本/附件/知识库相关片段）拼好 → 调 bridge_client → 流式渲染 - 自由对话：跳过 Skill，直接发用户输入 + context 给 LLM 8. **渲染能力**： - Markdown → 渲染（用轻量库或自己写） - Mermaid 代码块 → 调 mermaid 渲染 - 表格 → 标准 HTML table - 检测到 LLM 输出"完整 HTML 报告"或"Excel 数据" → 提供"⬇ 下载"按钮 ### 6.5 bridge_client.js（多 provider 适配层） **接口契约（必须全部实现）**： ```js // 统一入参 const req = { provider: 'aliyun'|'kimi'|'deepseek'|'zhipu'|'custom', apiKey: 'sk-xxx', model: 'qwen-max', // 用户在设置里选的 customUrl: '', // 仅 custom 用 messages: [{role:'system'|'user'|'assistant', content:'...'}], stream: true, onChunk: (text)=>{}, onDone: (full)=>{}, onError: (err)=>{} } // provider → endpoint 映射 const ENDPOINTS = { aliyun: 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions', kimi: 'https://api.moonshot.cn/v1/chat/completions', deepseek: 'https://api.deepseek.com/v1/chat/completions', zhipu: 'https://open.bigmodel.cn/api/paas/v4/chat/completions', custom: req.customUrl } // 统一 OpenAI 兼容协议（请求体一致：{model, messages, stream:true}） // 响应：SSE，逐行 data: {...}，解析 choices[0].delta.content ``` **关键要求**： - 流式：用 `fetch` + `ReadableStream` 解 SSE，不能等全部返回 - 失败重试：最多 1 次，错误透传 - 不在控制台打 API Key ### 6.6 skill_runtime.js（Skill 执行引擎） **Skill 文件协议**： ```markdown --- name: 流程架构规划 # 必填，展示名 description: 一句话描述 + 触发词 # 必填 --- # 角色 你是 XXX... # 工作流程 Step 1... Step 2... ``` **runtime 行为**： 1. 读 .md → 解析 frontmatter（用正则匹配 `^--- ([\s\S]*?) --- `） 2. 把 frontmatter 之后的内容当 system prompt 3. 拼最终消息： ``` [system]: <Skill 的 prompt> [user]: 下面是当前可用上下文： # 当前页面（如有） ${pageText} # 附件内容（如有） ${attachmentTexts} # 知识库相关片段（top-K 检索后） ${kbChunks} # 用户问题 ${userInput} ``` 4. 调 bridge_client，流式塞回 panel 的 chat 区 ### 6.7 sandbox.js > 用于执行 Skill 里可能出现的 ` ```js ... ``` ` 代码块。 > 简化版：用 `iframe sandbox=""` 创建隔离环境，postMessage 通信。 > 主要场景：Skill 让 AI 输出 HTML 时，提供"在沙箱预览"。 ### 6.8 file_parser.js（多格式解析） | 扩展名 | 解析方式 | |--------|----------| | .txt / .md / .csv / .json | `FileReader.readAsText(utf-8)` | | .docx | `mammoth.convertToHtml({arrayBuffer})` → 取纯文本 | | .pdf | `pdfjsLib.getDocument(arrayBuffer)` 逐页 `getTextContent()` 拼接 | | .xlsx | `XLSX.read(arrayBuffer)` → 每个 sheet 转 CSV 拼接 | | 图片 | 不解析正文，作为 base64 附件传给支持视觉的模型（可选） | > .pdf 较慢，扔到 offscreen.html 里跑，避免阻塞主线程。 ### 6.9 knowledge_store.js（IndexedDB 知识库） ```js // schema db: 'kb_db', store: 'chunks', keyPath:'id' chunk = { id: uuid, source: 'xxx.pdf', // 来源文件名 ord: 12, // 在文件内的片段序号 text: '...', // 800 字 embedding: [Float32]?, // 可选，无 embedding 也能跑（走 BM25/关键词） ts: 1716200000 } // 检索（无 embedding 默认走关键词）： // 按用户问题分词 → 对每个 chunk 算 hit 数 → 取 top 5 拼进 prompt // 有 embedding 时（用户配了支持 embedding 的模型）→ 用余弦相似度 top 5 ``` **MVP 决策**：先做关键词检索（最简单），第二迭代再上 embedding。 ### 6.10 offscreen.html / offscreen.js 仅做一件事：跑 pdf.js 解析。 被 background.js 创建：`chrome.offscreen.createDocument({url:'offscreen.html', reasons:['DOM_PARSER'], justification:'parse pdf'})` --- ## 7. 数据流（关键路径） ### 7.1 调用一个 Skill 的完整链路 ``` 用户在输入框打 "/" → panel.js 弹出 skillPopup（从 AppState.skills 渲染） 用户选中"流程架构规划"，回车 → panel.js 收集：currentContext(页面) + attachments + 用户问题 → skill_runtime.runSkill({skillName, context, userInput}) → 读 skills/process-planning.md → 解析 frontmatter，组装 system + user → bridge_client.chat({provider, apiKey, model, messages, stream:true, onChunk: text => panel.appendStreaming(text)}) → bridge_client 走 fetch SSE，每来一段 text 实时塞进 chat → 全部完成后：检测输出里是否含 ```html ... ``` 大段 是 → 自动给一个"⬇ 下载 HTML"按钮，点击 saveAs("xxx_报告_YYYYMMDD.html") ``` ### 7.2 知识库检索 ``` 用户发消息 → panel.js 先调 knowledge_store.search(userInput, topK=5) → 命中片段拼进 user 消息（带"# 知识库片段"分节） → 后续与 7.1 一致 ``` --- ## 8. 12 个内置 Skill 清单 > 这 12 个 .md 文件每个都是一段长 prompt（300-600 行不等），它们决定了插件的"专家级"输出能力。完整内容见原版插件 `skills/` 目录。新复刻的版本至少要把以下 **name + description + 核心工作流** 留下来。 | 文件 | name | 触发词 | 核心交付物 | |------|------|--------|------------| | process-planning.md | 流程架构规划 | "做流程规划"、"流程架构图" | 咨询级 HTML 报告（L1-L3 全量、商业画布、AI 机会、项目孵化矩阵） | | process-design-review.md | 流程设计评审 | "评审这个流程"、"流程诊断" | 6 维度 360° 评审 HTML 报告 | | process-detail-design.md | 流程详细设计 | "做流程详细设计" | 含活动节点 5W2H 的流程文件 | | process-high-level-design.md | 流程高阶设计 | "流程高阶设计"、"L2 设计" | L2 流程组 + 价值流地图 | | process-maturity-assessment.md | 流程成熟度评估 | "流程成熟度"、"PEMM 评估" | PEMM/GPMM 五维雷达 + 改进路线图 | | process-mining.md | 流程挖掘 | "流程挖掘" | 基于日志数据出当前流程现状图 | | process-quiz.md | 流程小考 | "流程小考"、"考试技能" | 10 题 HTML 答题页 | | process-exam.md | 流程考试 | 同上更长版 | 20+ 题题库 + 管理员视图 | | digital-consulting-report.md | 数字化咨询报告 | "出咨询报告" | McKinsey 风格 HTML | | skill-mining.md | Skill 挖掘 | "帮我把这个变成 skill" | 自动产出新 Skill .md | | 方案评估.md | 方案评估 | "评估这个方案" | 多维评分 + 排序矩阵 | | 流程审批分析.md | 流程审批分析 | "审批分析" | 审批节点合理性诊断 | > 复刻时建议：先把 **name / description / 触发词** 抄齐，prompt 内容可以让 Qoder 基于上述"核心交付物"重新生成，不必逐字复制。 --- ## 9. UI 视觉规范 | 元素 | 规格 | |------|------| | 主色 | #6c63ff（紫，title / hover） | | 强调蓝 | #4e7cff（按钮） | | 成功 / 已配置 | #10b981 | | 危险 | #ff4d4f | | 圆角 | 6-8px | | 字体 | -apple-system, "PingFang SC", sans-serif | | 面板宽度 | 默认 420px，支持左拖把手缩放（min 360 / max 720） | | Header 高度 | 48px，固定 | | 输入区 | 固定底部，textarea 自适应行高（max 6 行后内滚） | | 暗色模式 | v0.1.3 不要求；可作为 v0.2 | --- ## 10. 安全 & 隐私 红线 1. **API Key 仅存 chrome.storage.local**，不上传任何服务器 2. **页面文本不离开浏览器**，唯一的出口是用户配置的大模型 API 3. **所有第三方库本地化**（libs/），不动态加载远程脚本 4. 不收集任何遥测；不静默注入 content_script，**按需注入** 5. CSP：默认 MV3 严格 CSP，不内联 eval；Skill 沙箱里的 JS 必须经过 sandbox.js 隔离 6. 处理用户上传文件时，错误提示不暴露文件路径 --- ## 11. 验收标准（DoD） 新插件视为"复刻成功"必须满足： - [ ] `chrome://extensions` 加载已解压扩展程序，零报错 - [ ] 点击图标 → popup → 打开面板，能在任何 https 页面正常显示 - [ ] "读取页面"能拿到当前页正文（>0 字） - [ ] 设置 → 模型 → 填模型服务 Key → 选模型 → 保存 → 测试一句话能正常流式回复 - [ ] 输入 `/` 弹 Skill 列表，至少 12 个 - [ ] 选中"流程架构规划"，输入"消费电子，3000人，目标3年出海"，能产出含 L1-L3 全量结构 + 商业画布 + 项目孵化矩阵 的 HTML 报告，下载到桌面能在浏览器正常打开 - [ ] 上传一份 PDF（≤10MB）到知识库 → 切片成功 → 后续对话能引用片段 - [ ] 切换 4 家国产模型 + 1 家自定义 OpenAI 兼容，全部能跑通 - [ ] 关闭面板再打开，模型配置 / Skill 自定义 / 历史对话仍在 - [ ] 全程网络请求只命中 manifest 声明的 host_permissions --- ## 12. 一键复刻 Prompt（直接丢给 Qoder） > 把下面这一整段（含 PRD 全文）粘到 Qoder 新建项目对话框，让它一次性建出整个工程。 ``` 你是一名资深的 Chrome MV3 扩展开发工程师 + 前端工程师。 请严格按下方 PRD（v0.1.3 对齐版）从 0 到 1 创建一个名为 "AI流程管理专家插件" 的 Chrome 扩展工程。 要求： 1. 严格按 PRD 第 4 节的目录结构和文件名建文件，一个不能少。 2. 严格按 PRD 第 5 节生成 manifest.json。 3. 严格按 PRD 第 6 节实现各 .js 模块，所有跨模块通信用 PRD 第 7 节定义的消息类型。 4. 12 个 Skill .md 先按 PRD 第 8 节生成"骨架"（name + description + 触发词 + 工作流要点）， prompt 详细内容由你基于"核心交付物"自动展开，每个不少于 200 行。 5. UI 严格按 PRD 第 9 节配色与布局。 6. 所有 fetch 都做 try/catch，用户没配 Key 时给友好提示。 7. 所有 JS 用浏览器原生 ESM / 全局变量即可，不引入打包工具，零构建步骤。 8. 完成后给我一份 README，告诉我怎么加载到 Chrome、怎么填 API Key、怎么跑第一个 Skill。 完工标准：以 PRD 第 11 节验收清单为准，每一项必须 ✅。 现在开始，先把目录骨架建好，然后逐个文件实现。 [PRD 全文从此处往下粘贴 ↓↓↓] （粘贴本文件 1-11 节全部内容） ``` --- ## 13. 常见坑（前人踩过的） | 坑 | 解决办法 | |----|----------| | MV3 的 service worker 跑久了会被回收 | 每次需要长任务（流式 LLM）都从 panel 直接 fetch，不要走 SW 中转 | | pdf.worker.min.js 路径报错 | 在 pdf.js 加载前 `pdfjsLib.GlobalWorkerOptions.workerSrc = chrome.runtime.getURL('libs/pdf.worker.min.js')` | | 使用 OpenAI 兼容协议时 endpoint 要填对 | 按对应平台文档填写兼容模式地址，不要混用原生协议地址 | | docx 里的图片 mammoth 处理慢 | 配置 `mammoth.images.imgElement(()=>({src:''}))` 直接丢弃图片只取文字 | | Skill 输出 HTML 太长被截断 | 改成"分段流式 + 最后一次 done 时拼总下载" | | 面板被宿主页 CSS 污染 | panel 用 iframe 注入而不是直接 div，彻底隔离 | | 用户连不上 dashscope（公司网络拦截） | 在错误提示里同时给"切换 DeepSeek / Kimi"的快捷按钮 | --- ## 14. 版本路线图（参考） | 版本 | 关键变化 | |------|----------| | v0.1.0 | 基础面板 + 5 个 Skill | | v0.1.1 | 模型修复（多 provider 兼容） | | v0.1.2 | API Key 持久化修复 | | v0.1.3 | **页面按需调用**：content_script 不再常驻，改为 background 动态注入 | | v0.2.0（建议） | 暗色模式 + Embedding 知识库 + 多对话历史管理 | | v0.3.0（建议） | 上 Chrome Web Store；用户登录 + Skill 云同步 | --- > 完。把这份 md 整文贴进 Qoder，按第 12 节的 Prompt 执行，理论上一晚上就能跑出一个能装能用的同款插件。 > 真要复刻得跟原版"一模一样"，最稳的做法是把原版插件文件夹和这份 PRD 一起丢进去，让 Qoder 对照 + 仿写。