Skip to content

常见问题FAQ

Jump to bottom
Yuxuan Guan edited this page Aug 3, 2026 · 3 revisions

常见问题 FAQ

运行相关

Q: 运行时提示缺少 VCRuntime DLL？

A: 请安装 Visual C++ Redistributable。可以从 Microsoft 官网下载最新版本：

Q: 杀毒软件报毒怎么办？

A: PowerBox 是开源项目，源码完全可见，不会包含恶意代码。杀毒软件误报可能是因为程序使用了进程管理、窗口操作等底层 API。您可以：

  1. 将 PowerBox.exe 添加到杀毒软件的白名单中
  2. 自行从源码编译（参见 编译指南）
  3. 在 GitHub 上查看完整源码

Q: 如何卸载 PowerBox？

A: PowerBox 是绿色软件，无需安装。卸载方法：

  1. 直接删除 PowerBox.exe 文件
  2. 如果设置了开机自启，请先取消勾选"开机自启"选项，或手动删除注册表启动项
  3. 配置文件为可执行文件所在目录下的 config.ini，如需完全清除可一并删除该文件
  4. 右键菜单字典数据的缓存文件位于 %AppData%\PowerBox\，如需完全清除可一并删除该目录

Q: 配置文件保存在哪里？

A: 配置文件保存在以下位置：

  • 应用配置: 可执行文件所在目录下的 config.ini（例如 PowerBox.exe 所在目录）
  • 包含：应用设置、应用快捷路径、AI 配置、Git 命令列表、连点器参数等
  • 右键菜单字典数据: %AppData%\PowerBox\ 目录（缓存文件、备份文件）
  • 对话历史: 默认保存在 %AppData%\PowerBox\conversations\，可在 config.ini 的 [Paths] 节的 ConversationDir 中自定义

AI 相关

Q: AI 无法连接或没有响应？

A: 请按以下步骤排查：

  1. 检查 API Key

    • 打开"文件" > "设置"，确认 AI 供应商和 API Key 已正确填写
    • 注意 API Key 区分大小写，建议直接复制粘贴

  2. 检查网络环境

    • OpenAI 的 API 在大陆地区可能无法直接访问，需要配置代理
    • DeepSeek、通义千问、智谱AI、Moonshot、硅基流动的 API 在国内可直接访问
    • 确认防火墙没有阻止 PowerBox 的网络访问

  3. 检查 API 余额

    • 登录 AI 供应商的官网，确认 API 账户余额充足

  4. 查看错误提示

    • AI 面板会显示具体的错误信息，根据提示进行排查

Q: AI 回复速度慢？

A: 可能的原因：

  • 网络延迟较高
  • AI 模型处理需要时间
  • 当前使用的是流式输出模式，会逐字显示，看起来较慢属正常现象

多语言相关

Q: 语言切换功能不可用，设置中只有"中文"选项？

A: 语言文件（lang/ 目录）缺失或未正确放置。请确保：

  1. 从 Releases 下载了 lang.zip 语言包
  2. 将 lang.zip 解压后的 lang/ 文件夹放在 PowerBox.exe 同级目录下
  3. 目录结构应为： 
    PowerBox.exe
lang/
├── zh-CN.ini
└── en-US.ini
  4. 重启 PowerBox 后生效

如果自行编译，需要将源码中的 MFCApplication1/lang/ 文件夹复制到 exe 所在目录（参见编译指南）。

Q: 如何添加新的语言？

A: 在 lang/ 目录下新建一个 .ini 文件，文件名格式为 语言代码.ini（如 ja-JP.ini），在文件开头添加 [Language] 节并设置 DisplayName，然后将所有翻译键填入对应译文即可。程序启动后会自动识别新语言文件。详见功能详解中的"扩展更多语言"章节。

Q: 切换语言后界面没有变化？

A: 切换语言后需要重启应用才能生效。请点击"确定"保存设置，然后关闭并重新启动 PowerBox。

功能相关

Q: 截图 OCR 无法识别文字？

A: 请确认：

  1. 系统语言包中已安装 OCR 识别所需的语言包
  2. 截图区域包含清晰的文字内容
  3. 在 OCR 对话框中选择了正确的识别语言（中文/英文等）

Q: 右键菜单管理中的修改如何恢复？

A: 右键菜单管理工具在禁用菜单项时只会修改注册表中的启用标志，不会删除原始注册表项。重新启用即可恢复。如果误删了菜单项，可以通过"字典路径"功能查看对应的注册表位置，手动恢复。

Q: 环境变量修改后没有生效？

A: 修改环境变量后，需要重启应用程序才能生效。某些系统环境变量的修改可能需要重启 Windows Explorer 或重新登录系统。

Q: 文件占用查看显示没有占用进程？

A: 文件占用查看功能需要以管理员权限运行才能获取完整的进程句柄信息。建议以管理员身份运行 PowerBox。

编译相关

Q: 编译时找不到 MFC 头文件？

A: 请确保 Visual Studio 安装时勾选了"使用 C++ 的桌面开发"工作负载，并在右侧详细信息中勾选了"适用于最新 v143 生成工具的 C++ MFC"。

Q: 编译报错 C++20 特性不支持？

A: 在 Visual Studio 中打开项目属性，将"配置属性" > "C/C++" > "语言" > "C++ 语言标准"设置为"ISO C++20 标准 (/std:c++20)"或更高。

反馈

Q: 如何反馈问题或建议？

A: 请通过以下方式反馈：

  • 提交 GitHub Issues
  • 请尽量提供详细的复现步骤、系统信息、截图等，以便快速定位问题

Clone this wiki locally