插件安装

本指南将帮助您安装和配置 CodeSign 切图助手浏览器插件。

前置要求

在安装插件之前，请确保：

1. ✅ 已安装 QT Tool
2. ✅ QT Tool 服务器已启动
3. ✅ 服务器地址可访问（默认 http://localhost:9999）

构建插件

1. 进入插件目录

cd /root/tmp/qt-tool/plug/codesign-qt-helper

2. 安装依赖

npm install

3. 构建插件

npm run build

构建完成后，会在 dist 目录生成插件文件。

安装到浏览器

Chrome / Edge / Brave

步骤 1：打开扩展管理页面

• Chrome: 地址栏输入 chrome://extensions/
• Edge: 地址栏输入 edge://extensions/
• Brave: 地址栏输入 brave://extensions/

步骤 2：启用开发者模式

在页面右上角找到「开发者模式」开关并启用。

步骤 3：加载已解压的扩展程序

1. 点击「加载已解压的扩展程序」按钮
2. 选择插件构建目录 dist
3. 确认加载

步骤 4：验证安装

安装成功后，你应该在扩展列表中看到「CodeSign 切图助手」图标。

验证安装

1. 检查插件图标

安装后，浏览器工具栏应该显示插件图标。

2. 打开插件弹窗

点击插件图标，应该看到以下界面：

• 历史记录按钮
• 通用设置按钮

3. 测试服务器连接

1. 点击「通用设置」
2. 确认服务器地址为 http://localhost:9999
3. 点击「测试连接」
4. 应该显示「连接成功」

如果连接失败，请检查：

• QT Tool 服务器是否已启动
• 服务器地址是否正确
• 防火墙是否阻止了连接

配置插件

设置服务器地址

1. 打开插件弹窗
2. 点击「通用设置」
3. 修改「服务地址」字段
4. 点击「保存配置」

自定义弹窗尺寸

1. 打开插件弹窗
2. 点击「通用设置」
3. 调整「弹窗宽度」和「弹窗高度」
4. 点击「保存配置」

推荐设置：

• 宽度：400px - 600px
• 高度：240px - 400px

卸载插件

Chrome / Edge / Brave

1. 打开扩展管理页面
2. 找到「CodeSign 切图助手」
3. 点击「移除」按钮
4. 确认移除

更新插件

开发者模式更新

由于插件是以「已解压」方式安装的，更新很简单：

1. 重新构建插件：npm run build
2. 在扩展管理页面点击「刷新」按钮

正式版更新

未来将提供正式版更新，通过浏览器扩展商店自动更新。

故障排除

1. 插件无法加载

问题： 加载插件时出现错误

解决方法：

1. 检查 manifest.json 文件是否存在
2. 确认构建是否成功：检查 dist 目录
3. 查看浏览器控制台的错误信息

2. 无法连接到服务器

问题： 点击「测试连接」显示失败

解决方法：

1. 确认 QT Tool 服务器已启动：qt --run
2. 检查服务器地址是否正确
3. 尝试在浏览器中访问 http://localhost:9999/process/test
4. 检查防火墙设置

3. 插件图标不显示

问题： 工具栏中没有插件图标

解决方法：

1. 在扩展管理页面找到插件
2. 点击「详细信息」
3. 在「在工具栏中显示」开关上点击
4. 确认图标图标是否被隐藏在菜单中

4. 自动下载不工作

问题： 在 CodeSign 平台下载切图时没有自动处理

解决方法：

1. 确认当前页面为 CodeSign 平台
2. 刷新页面后重试
3. 检查插件权限是否已授予
4. 查看插件设置中的服务器连接状态

5. 构建失败

问题： 运行 npm run build 时出现错误

解决方法：

1. 清除 node_modules：rm -rf node_modules
2. 重新安装依赖：npm install
3. 确认 Node.js 版本（推荐 16 或更高）
4. 检查 TypeScript 配置是否正确

下一步

安装完成后，您可以：

• 查看 插件使用说明
• 了解 配置说明
• 查看 API 文档