Skip to content

Commit 48b6ffb

Browse files
committed
docs: add FAQ section on antivirus false positives
1 parent 6bb35d6 commit 48b6ffb

File tree

2 files changed

+50
-0
lines changed

2 files changed

+50
-0
lines changed

docs/en/faq.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -154,6 +154,31 @@ You can also set these through the graphical configuration editor: `API - retry_
154154

155155
The solution is the same as above.
156156

157+
## Antivirus software flags the executable as a virus/threat
158+
159+
This is a **false positive**. KToolBox is completely safe and open-source software.
160+
161+
**Why this happens:**
162+
- PyInstaller executables are commonly flagged by antivirus engines due to their packing method
163+
- Downloaded executables from the internet are often treated with suspicion
164+
- Some heuristic engines flag any "download manager" type software
165+
166+
**Solutions:**
167+
1. **Add an exception** in your antivirus software for the KToolBox executable
168+
2. **Use pipx or pip installation** instead
169+
3. **Build from source** if you're still concerned:
170+
```bash
171+
git clone https://github.com/Ljzd-PRO/KToolBox.git
172+
cd KToolBox
173+
poetry install --with pyinstaller
174+
poetry run pyinstaller ktoolbox.spec
175+
```
176+
177+
**Security assurance:**
178+
- All releases are built automatically using GitHub Actions (publicly visible)
179+
- Source code is completely open and auditable
180+
- No malicious code exists in this project
181+
157182
## Where can I find more information about KToolBox?
158183
159184
- Guide: Use **AI(Copilot Spaces)** for command params and configuration help: [#304](https://github.com/Ljzd-PRO/KToolBox/issues/304)

docs/zh/faq.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,31 @@ ktoolbox sync-creator "https://coomer.su/onlyfans/user/hollyharper11" --start-ti
155155

156156
解决方法同上
157157

158+
## 杀毒软件将可执行文件标记为病毒/威胁
159+
160+
这是**误报**。KToolBox 是完全安全的开源软件。
161+
162+
**为什么会发生这种情况:**
163+
- PyInstaller 可执行文件由于其打包方法经常被杀毒引擎标记
164+
- 从网络下载的可执行文件通常被怀疑对待
165+
- 一些启发式引擎会标记任何"下载管理器"类型的软件
166+
167+
**解决方案:**
168+
1. **在杀毒软件中添加例外** 对 KToolBox 可执行文件
169+
2. **使用 pipx 或 pip 安装**
170+
3. **从源码构建** 如果你仍有顾虑:
171+
```bash
172+
git clone https://github.com/Ljzd-PRO/KToolBox.git
173+
cd KToolBox
174+
poetry install --with pyinstaller
175+
poetry run pyinstaller ktoolbox.spec
176+
```
177+
178+
**安全保证:**
179+
- 所有发布版本都使用 GitHub Actions 自动构建(公开可见)
180+
- 源代码完全开放且可审计
181+
- 此项目中不存在恶意代码
182+
158183
## 我在哪里可以找到更多帮助?
159184

160185
- 向导:用 **AI(Copilot Spaces)** 获取命令参数和配置帮助:[#304](https://github.com/Ljzd-PRO/KToolBox/issues/304)

0 commit comments

Comments
 (0)