拓展市场与自定义插件
「拓展市场」用于给团队准备浏览器拓展：从市场下载、通过 Chrome Web Store 地址导入外部拓展，或上传自定义插件包，然后按窗口绑定加载。
入口：左侧导航「拓展市场」，页面分「拓展市场」与「已下载拓展」两个页签。
前置条件
整页入口受拓展查看权限门控，无权限时导航项和市场页签不可用；下载/更新/置顶、上传、删除各需对应权限，无权限时按钮置灰并提示（如「当前无拓展保存权限」「当前无上传插件权限」「当前无拓展删除权限」），详见角色与权限。
市场浏览与分类筛选
- 顶部一级分类按钮（首项「全部」），选中某一级后出现二级分类行（首项也是「全部」）；分类列显示为「父分类 / 子分类」。
- 页头有搜索框和「刷新」按钮；列表展示拓展图标、名称、分类、版本（市场版与本地版对比）、说明和操作按钮，支持分页并可修改每页条数。
- 分类加载失败时提示「拓展分类加载失败，请稍后刷新」，此时仍可搜索，只是无法按分类筛选。
输入搜索关键词会自动把分类重置为「全部」再搜索。
下载与按钮三态
点行内「下载」按钮开始下载，按钮实时显示进度百分比（「下载 X%」）；完成后提示「插件已下载到当前团队」并自动切换到「已下载拓展」页签。
同一行的操作按钮会根据状态变化：
| 状态 | 按钮 | 说明 |
|---|---|---|
| 未下载 | 「下载」 | 把安装包下载到本机缓存并登记到当前团队 |
| 已下载且有新版 | 「更新」 | 悬浮提示「从 X 更新至 Y」；只重新下载包到本机缓存，成功提示「插件已更新至最新版本」 |
| 已下载且最新 | 「删除」 | 删除已下载拓展（从团队移除，见下文） |
下载的安装包会缓存在本机。带校验信息的包在下载后会做完整性校验，校验不通过时自动清除缓存并报「插件包校验失败」。
「更新」不改变团队登记信息，只重新下载安装包到本机缓存。因此换电脑后，需要在新机器上重新下载一次包。
Chrome URL 下载外部拓展
市场页签和已下载页签都有「Chrome URL」按钮，可把外部拓展直接登记到当前团队：
- 点「Chrome URL」按钮，打开「下载 Chrome 拓展」弹窗。
- 在「Chrome Web Store URL」输入框（占位符：Chrome Web Store 地址或拓展 ID）粘贴地址或 ID。
- 点「下载」，通过二次风险确认弹窗「确认下载外部 Chrome 拓展」（确认按钮文案「下载拓展」）。
- 成功后提示「Chrome 拓展已下载到当前团队」并切到已下载页签。
输入校验：http/https URL，或恰好 32 位、仅含 a-p 字母的拓展 ID；含空白字符即无效，提示「请输入有效的 Chrome Web Store 地址或 32 位拓展 ID」。弹窗内固定提示：「外部来源下载：请输入可信 Chrome Web Store 地址或拓展 ID。下载范围为当前团队。」
风险确认弹窗原文：「请确认来源可信。客户端下载前无法解析完整权限清单，下载后如有异常可在已下载列表删除。」即客户端不会预先展示该拓展申请的权限列表，请自行确认来源可信。
上传自定义插件
仅「已下载拓展」页签有「上传插件」按钮，把本地 ZIP、7z 或 CRX 插件包上传到当前团队，供团队成员下载使用。
- 点「上传插件」，在系统文件选择框「选择插件包」中选择文件（过滤器：Chrome 插件包 zip/7z/crx）。
- 弹窗「上传团队插件」显示文件名/版本/大小，表单含「插件 ID」（只读，自动推导）、「插件名称」（必填）、「校验 Hash」（只读）、「说明」。
- 点「上传并添加」，底部状态依次显示：解析插件包 → 申请上传授权 → 上传并安装到本地 → 保存插件资料。
- 成功提示「插件已上传并添加到当前团队」并切到已下载页签。
要求与限制：
- 插件包版本不受支持时会报「仅支持 Manifest V2 或 V3 插件」，无法上传。
- 「插件 ID」由客户端从插件包中自动识别，无需手动填写。
- 压缩包外层可以再套一层文件夹；包内文件路径异常的插件包会被拒绝。
- 上传时客户端会自动整理插件包，并生成用于完整性校验的「校验 Hash」；上传成功的包同时保存到本机缓存，本机无需再下载。
常见报错速查：
| 报错原文 | 原因与处置 |
|---|---|
| 「仅支持 Manifest V2 或 V3 插件」 | 插件包版本不受支持，无法上传 |
| 「插件包包含多个 manifest.json，请只保留一个插件根目录」 | 包内有多个插件根目录，重新打包只保留一个 |
| 「当前插件包未包含可推导插件 ID 的签名信息，请重新选择 CRX 包或带签名信息的 ZIP 包」 | 无法推导插件 ID（ID 框显示「未解析到插件 ID」），提交时校验「请填写 32 位有效插件 ID」；换用 CRX 包或带签名信息的 ZIP 包 |
| 「插件包已过期，请重新选择文件」 | 弹窗放置过久后文件解析结果失效，重新选择文件即可 |
| 「插件文件已上传，资料保存未完成，请重试提交」 | 文件已上传但资料保存失败，按钮变为「重试保存」；重试不会重复上传文件 |
已下载拓展管理
「已下载拓展」页签管理当前团队已登记的拓展：
- 来源列区分「用户上传」与「市场安装」徽标；列表还显示所属用户和版本状态。用户上传来源的拓展在下载/更新时需要临时下载授权，离线或授权失败会提示「缺少插件下载地址」。
- 置顶：操作列图钉按钮（提示「置顶」/「取消置顶」，成功提示「拓展置顶状态已更新」）。该拓展有可用更新时，置顶按钮会被刷新图标的「更新」按钮暂时取代（提示「更新至 X」，更新中显示「正在更新拓展」），更新完成后恢复。
- 删除：勾选多行后顶部出现「删除 N 个」危险按钮，确认弹窗「确认删除选中的 N 个拓展吗？」；市场页签对已下载且最新的拓展显示单个「删除」，确认弹窗标题「删除拓展」。删除成功提示「拓展已删除」。
- 列表数据以服务器为准；如未看到最新变化，点「刷新」按钮获取最新数据。
删除的是团队登记记录——该拓展从整个团队的可用范围移除，不只是清理本机文件。请确认没有队友的窗口还在使用它。
拓展与窗口的绑定
拓展按窗口指定加载：
- 打开窗口创建/编辑弹窗，找到「拓展插件」字段。
- 打开「选择拓展插件」弹窗（搜索占位符「搜索拓展名称、分类或备注」，支持多选与分页），勾选后点「确认选择」。
- 启动该窗口时，客户端会用本机已下载的缓存包自动加载这些拓展。
表单单元格最多显示 2 个拓展图标+名称，多余的显示「+N 个拓展插件」；未绑定时显示「未绑定拓展插件」。打开选择器需要拓展查看权限，无权限时单元格禁用并提示「当前无权配置」。
安装包内置插件与客户端版本要求的插件对所有窗口全局加载，不需要手动绑定（其更新随客户端组件更新，见版本更新）；内置的密码保险库插件由客户端单独管理，同样无需手动绑定。
窗口启动时只加载本机已缓存的插件包：绑定了拓展但本机缓存缺失或解压失败时，会静默跳过、不阻断窗口启动——窗口能开，但拓展不在。换机或清理缓存后，请先到拓展市场把绑定的拓展重新下载一次，再启动窗口。
拓展图标由客户端统一下载并缓存到本机；图标加载失败时只回退为默认拼图占位图标，不影响拓展本身的下载与使用。
相关页面
- 窗口配置项详解 · 基础信息（资源绑定）
- 创建窗口
- 版本更新（内置插件组件）
- 角色与权限