📥 安装指南
本页面将指导您完成 PixWit 的安装和初始设置。
系统要求
- 操作系统：Windows 10 / Windows 11
Windows 7 不支持
PixWit 仅支持 Windows 10 / 11，不支持 Windows 7。
两种分发方式
更新对话框里提供两个下载按钮，对应两种分发方式：
| 分发方式 | 说明 |
|---|---|
| 📦 便携版 | 绿色免安装，解压后直接运行 |
| 💿 安装版 | 安装到 %LocalAppData%\PixWit，不需要管理员权限 |
下载入口：
- 托盘右键 → 帮助 → 检查更新，在新版本对话框里选 📦 便携版 或 💿 安装版；
- 也可以在下载页面获取安装包。
下载通过系统浏览器打开对应链接完成，程序本身不做静默安装。
首次启动
- 主界面：一条固定在屏幕上的细长工具条（宽 60px、始终置顶），从上到下依次是拖动把手
⋮⋮⋮、区域截图、打开图片、录制屏幕，以及底部的 ×。 - 贴边自动隐藏（默认开启）：把主界面拖到屏幕边缘会自动吸附，鼠标移开后延时收起、只留一条细边（左右 8px、上下 6px），鼠标移回细边自动弹出；拖到桌面中间则不会自动隐藏。收起不等于退出，截图、录屏等快捷键照常可用。
- 单实例：重复启动 PixWit 不会开出第二个程序，而是把已有主界面显示出来并置顶。
- 托盘常驻：点主界面底部的 × 只是隐藏主界面，程序继续在托盘运行；要退出请用托盘菜单 → 退出。
📷 插图占位（图 1）
主界面工具条 — 展示 60px 宽的置顶工具条：拖动把手、区域截图、打开图片、录制屏幕、底部 ×，以及贴边收起后留下的细边 补图：图片放到 docs/public/images/install-main-toolbar.webp，然后删除本提示块并打开下一行注释
首次上手三步
- 按 F1（或点主界面「区域截图」）进入截图选区，框选要截取的区域；
- 在打开的编辑窗口里用箭头、画笔、矩形、文字、马赛克等工具标注；
- 点「复制」（Ctrl+C）复制到剪贴板，或点「保存」（Ctrl+S）保存到文件。
开机自动启动
托盘右键 → 勾选 开机自动启动：
- 管理员账户：通过任务计划实现开机自启；
- 普通账户：通过启动项实现开机自启。
首次使用录屏
首次录屏会提示下载视频编码组件（约 94MB）：只需下载一次，之后可离线使用。
本地 OCR 模型（可选）
文字识别可以只走本地 OCR，离线也能用。模型在 设置中心 → AI 服务配置 → 本地 OCR 模型 里选择：
| 模型 | 体积 | 说明 |
|---|---|---|
| tiny（内置，快速） | 约 6MB | 随安装包内置，无需下载 |
| small（高精度） | 约 31MB | 点「下载 small」下载一次，之后可离线使用 |
切换模型需重启
在 自动（推荐） / tiny / small 之间切换后，需要重启程序才会生效。
AI 功能默认使用 PixWit AI（开箱即用，无需自己配置 API Key）；也可以在设置中心里改为「仅本地OCR」或配置自己的服务，详见设置中心。
被系统或安全软件拦截
如果下载后被 Windows 提示「无权限」或被安全软件拦截，有三种处理办法（详见更新与反馈）：
- 解除文件的「网络标记」：右键下载的文件 → 属性 → 勾选「解除锁定」→ 确定；
- 使用安装版：安装到
%LocalAppData%\PixWit，不需要管理员权限； - 联系 IT 管理员把 PixWit 加入白名单。
卸载
| 版本 | 卸载方式 |
|---|---|
| 💿 安装版 | 控制面板 → 程序和功能 → 找到 PixWit → 卸载（安装目录 %LocalAppData%\PixWit 会随之移除） |
| 📦 便携版 | 托盘右键 → 退出 后，直接删除解压出来的文件夹即可，不写注册表 |
卸载不会自动清理你的截图与录像：历史截图可在托盘菜单 历史截图 → 📁 打开历史文件夹 里查看和清理；录屏与图片默认保存在上次保存的目录或桌面。
启动失败排查
提示「找不到 MSVCP140_2.dll」或缺少 VC++ 运行库
官方安装包与便携版都已内置所需的运行库（msvcp140.dll、msvcp140_1.dll、msvcp140_2.dll、vcruntime140.dll、vcruntime140_1.dll），正常情况下不会出现这个提示。如果仍然报错，说明系统里的 Visual C++ 运行库缺失或已损坏：
- 安装 Visual C++ 2015-2022 Redistributable (x64)：官方下载（注意选 x64，不是 x86）；
- 如果本来就装过，打开 控制面板 → 程序和功能，找到 Microsoft Visual C++ 2015-2022 Redistributable (x64) → 右键 → 更改 → 修复；
- 修复完成后重启计算机，再启动 PixWit。
程序启动时也会自动检测这几个 DLL，缺失时会弹出提示对话框，可以直接在里面选择「立即安装」。
需要以管理员身份运行吗
不需要。官方安装版装到 %LocalAppData%\PixWit，普通账户即可完成安装与运行；只有把程序手动放到 Program Files 等受保护目录时，才需要以管理员身份运行。若提示无权限或被安全软件拦截，见上一节。
其它启动异常
- 先确认不是重复启动：PixWit 是单实例程序，重复启动只会把已有主界面显示出来并置顶；
- 托盘右键 → 帮助 → 打开日志文件，打开
%LocalAppData%下的 PixWit logs 目录，把最新日志连同问题描述一起反馈（QQ 群或 Gitee Issues），排查会快很多； - 如果卡在某个正在进行中的操作上，可按系统内置的 Shift+Esc 紧急重置。