COO Assistant

Appearance

安装指南 ​

系统要求 ​

  • 操作系统: Windows 10+
  • 磁盘空间: 至少 800MB 可用空间（包含 Chromium）
  • 内存: 建议 4GB 以上
  • 网络: 稳定的互联网连接（首次运行可能需要下载组件）

安装步骤 ​

Windows 安装 ​

  1. 下载安装包

    • 从下载页面下载最新的 Windows 安装包（.exe 文件）
    • 文件名格式：COO Assistant Setup x.x.x.exe

  2. 运行安装程序

    • 双击运行安装程序
    • 如果出现"Windows 已保护你的电脑"提示，点击"更多信息" → "仍要运行"
    • 安装程序需要管理员权限，请点击"是"允许

  3. 安装向导步骤

    • 欢迎页面：阅读欢迎信息，点击"下一步"
    • 选择安装位置：默认安装到 C:\Program Files\COO Assistant，可以点击"浏览"自定义安装目录
    • 选择组件：选择要安装的组件（通常保持默认即可）
    • 准备安装：确认安装信息，点击"安装"
    • 安装进度：等待安装完成
    • 完成安装：安装完成后会自动启动应用（可选）

  4. 安装完成

    • 桌面会自动创建快捷方式
    • 开始菜单中会添加"COO Assistant"程序组
    • 可以从桌面或开始菜单启动应用

安装配置说明：

  • 安装类型：默认安装到所有用户（需要管理员权限）
  • 安装目录：默认 C:\Program Files\COO Assistant，支持自定义
  • 快捷方式：自动创建桌面和开始菜单快捷方式
  • 语言支持：支持中文和英文界面（默认中文）
  • 自动运行：安装完成后可选择立即启动应用

安装程序配置说明 ​

Windows 安装程序特性 ​

根据构建配置，Windows 安装程序具有以下特性：

安装类型 ​

  • 安装范围：默认安装到所有用户
  • 安装目录：支持自定义安装目录
  • 默认路径：C:\Program Files\COO Assistant

快捷方式 ​

  • 桌面快捷方式：自动创建
  • 开始菜单快捷方式：自动创建
  • 快捷方式名称：COO Assistant

语言支持 ​

  • 支持语言：中文（简体，语言代码：2052）

安装行为 ​

  • 安装后运行：安装完成后自动启动应用
  • 开始菜单分类：不添加到开始菜单分类

发布者信息 ​

  • 发布者名称：上海三寸时光数字科技有限公司

用户数据管理 ​

Windows ​

  • 数据目录：%APPDATA%\COO Assistant
  • 日志目录：%APPDATA%\COO Assistant\logs
  • 用户数据：%APPDATA%\COO Assistant\user-data
  • 浏览器数据：%APPDATA%\COO Assistant\chrome-persistent-data
  • 卸载行为：卸载时默认不删除用户数据（deleteAppDataOnUninstall: false）

安装流程 ​

  1. 欢迎页面

    • 显示欢迎信息和应用介绍
    • 点击"下一步"继续

  2. 选择安装位置

    • 默认安装路径：C:\Program Files\COO Assistant
    • 可以点击"浏览"按钮选择自定义安装目录
    • 点击"下一步"

  3. 选择组件（如果有）

    • 选择要安装的组件
    • 通常保持默认选择即可
    • 点击"下一步"

  4. 准备安装

    • 显示安装摘要信息
    • 确认安装位置和组件选择
    • 点击"安装"开始安装

  5. 安装进度

    • 显示安装进度条
    • 显示当前正在安装的文件
    • 等待安装完成

  6. 完成安装

    • 显示安装完成提示
    • 可选择"立即启动 COO Assistant"
    • 点击"完成"退出安装程序

卸载流程 ​

Windows 卸载 ​

方式一：通过控制面板卸载 ​

  1. 打开程序和功能

    • 打开"控制面板" → "程序和功能"（或"应用和功能"）
    • 在程序列表中找到"COO Assistant"

  2. 开始卸载

    • 点击"COO Assistant"
    • 点击"卸载"或"更改"按钮
    • 确认卸载操作

  3. 卸载向导

    • 确认卸载：确认是否要卸载程序
    • 数据删除选择：选择是否删除用户数据
      • 默认不删除用户数据（保留配置和数据）
      • 如需完全卸载，可选择删除用户数据
    • 卸载进度：显示卸载进度
    • 完成提示：卸载完成提示

方式二：通过开始菜单卸载 ​

  1. 打开开始菜单
  2. 找到"COO Assistant"程序组
  3. 点击"卸载 COO Assistant"
  4. 按照卸载向导完成卸载

验证安装 ​

安装完成后，可以通过以下方式验证安装是否成功：

基本验证 ​

  1. 启动应用

    • 双击桌面快捷方式或从开始菜单启动

  2. 检查版本信息

    • 打开应用后，进入"设置"页面
    • 查看"关于"或"版本信息"
    • 确认版本号与下载的版本一致

  3. 检查安装位置

    • 确认 C:\Program Files\COO Assistant 目录存在
    • 确认快捷方式指向正确的安装目录

功能验证 ​

  1. 浏览器控制

    • 进入"浏览器控制"页面
    • 尝试启动浏览器（有界面或无界面模式）
    • 确认浏览器正常启动

  2. 自动化脚本

    • 进入"自动化脚本"页面
    • 选择一个脚本模板并执行
    • 确认脚本执行成功

  3. 数据目录

    • 检查用户数据目录是否已创建
    • 数据目录：%APPDATA%\COO Assistant
    • 日志目录：%APPDATA%\COO Assistant\logs
    • 用户数据：%APPDATA%\COO Assistant\user-data

注册表验证（仅 Windows） ​

  1. 打开注册表编辑器（regedit）
  2. 检查卸载信息
    • 路径：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\COO Assistant
    • 确认存在卸载信息
  3. 检查应用信息
    • 路径：HKEY_LOCAL_MACHINE\SOFTWARE\COO Assistant
    • 确认存在应用配置信息

故障排除 ​

安装失败 ​

如果安装过程中遇到问题，请尝试以下解决方案：

  1. 检查磁盘空间：确保有足够的磁盘空间
  2. 管理员权限：安装到 Program Files 需要管理员权限
  3. 关闭杀毒软件：某些杀毒软件可能会误报安装程序
  4. 重新下载：重新下载安装包，确保文件完整

启动失败 ​

如果应用无法启动，请检查：

  1. 系统要求：确认系统满足最低要求

    • Windows 10 或更高版本
    • 足够的磁盘空间（至少 800MB）
    • 足够的内存（建议 4GB 以上）

  2. 权限问题

    • 确认有足够的权限运行应用
    • 检查用户账户控制（UAC）设置
    • 确认当前用户账户有运行应用的权限

  3. 日志查看

    • 查看 %APPDATA%\COO Assistant\logs 目录
    • 查看最新的日志文件获取错误信息

  4. 重新安装

    • 尝试卸载后重新安装
    • 清理用户数据目录后重新安装

权限问题 ​

如果遇到权限问题：

  1. 安装权限（Windows）

    • 以管理员身份运行安装程序
    • 安装到 Program Files 需要管理员权限
    • 右键点击安装程序 → "以管理员身份运行"

  2. 运行权限

    • 确认用户账户有运行应用的权限
    • 检查用户账户控制（UAC）设置

  3. 用户数据目录权限

    • 检查用户数据目录的读写权限
    • 数据目录：%APPDATA%\COO Assistant
    • 确保当前用户对该目录有读写权限

  4. 防火墙设置

    • 检查防火墙是否阻止应用运行
    • 检查是否阻止应用访问网络（自动更新功能需要）

  5. 杀毒软件

    • 某些杀毒软件可能会阻止应用运行
    • 将应用添加到杀毒软件的白名单

更新应用 ​

自动更新 ​

应用支持自动更新功能：

  1. 自动检查

    • 应用启动后延迟 5 秒自动检查更新
    • 比较当前版本与最新版本

  2. 更新提示

    • 如果发现新版本，会在应用右上角显示更新通知
    • 点击通知可以查看更新详情
    • 可以选择立即更新或稍后更新

  3. 自动下载和安装

    • 点击更新后，自动下载新版本安装包
    • 下载完成后自动启动安装程序
    • 安装程序会自动检测并覆盖旧版本

手动更新 ​

  1. 下载新版本

    • 从下载页面下载最新版本的 Windows 安装包
    • 确保下载的是最新版本

  2. 运行安装程序

    • 双击运行新版本安装程序
    • 安装程序会自动检测旧版本
    • 按照安装向导完成更新

  3. 数据保留

    • 更新时用户数据会自动保留
    • 配置、登录信息等不会丢失
    • 建议更新前备份重要数据

更新注意事项 ​

  • 备份数据：更新前建议备份用户数据
  • 关闭应用：更新时确保应用已完全关闭
  • 网络连接：自动更新需要稳定的网络连接
  • 测试验证：更新后请测试主要功能是否正常

注意事项 ​

安装注意事项 ​

  1. 权限要求

    • Windows：安装到 Program Files 需要管理员权限
    • 建议以管理员身份运行安装程序

  2. 磁盘空间

    • 确保有足够的磁盘空间（至少 800MB）
    • 安装包大小约 315MB（包含 Chromium）
    • 安装后可能需要额外空间用于用户数据

  3. 路径长度

    • 避免使用过长的安装路径
    • Windows 路径长度限制可能影响某些功能

  4. 杀毒软件

    • 某些杀毒软件可能会误报安装程序
    • 如果出现误报，请将安装程序添加到白名单
    • 发布者：上海三寸时光数字科技有限公司

  5. 网络连接

    • 首次运行可能需要网络连接以下载必要的组件
    • 自动更新功能需要网络连接
    • 某些功能需要访问外部 API

使用注意事项 ​

  1. 数据备份

    • 定期备份用户数据目录
    • 卸载时建议备份重要数据
    • 更新前建议备份配置和数据

  2. 系统兼容性

    • 确保操作系统版本满足要求
    • Windows 10 或更高版本
    • 建议使用 Windows 10 1903 或更高版本
    • 确保系统已安装必要的运行库

  3. 浏览器数据

    • 应用使用独立的浏览器数据目录
    • 不会影响系统已安装的 Chrome 浏览器
    • 浏览器数据存储在用户数据目录中

获取帮助 ​

如果遇到安装问题，可以通过以下方式获取帮助：

技术信息 ​

构建配置 ​

  • 应用 ID：com.coo.assistant
  • 产品名称：COO Assistant
  • Electron 版本：28.3.3
  • 构建工具：electron-builder
  • Windows 安装程序：NSIS

安装程序文件 ​

安装包包含以下文件：

  • dist/**/* - 渲染进程文件
  • dist-electron/**/* - Electron 主进程文件
  • build/chrome/**/* - Chromium 浏览器文件
  • package.json - 应用配置
  • THIRD_PARTY_LICENSES.txt - 第三方许可证

自定义安装脚本 ​

安装程序使用自定义脚本 build/installer.nsh：

  • preInit：设置默认安装目录
  • customInstall：创建用户数据目录
  • customUnInstall：询问是否删除用户数据

COO电商助手 - 专业的电商数据管理工具

Copyright © 2025 COO开发团队 | 沪公网安备31011402021584号