# tools

**Repository Path**: LogicByteCraft/tools

## Basic Information

- **Project Name**: tools
- **Description**: 开源软件库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tools

本仓库用于收录我本人开发的一些小工具，便于集中存放与分享。后续有新工具也会持续更新到这里。

## 许可协议

本仓库及其中全部工具均受 **[PolyForm Noncommercial License 1.0.0](./LICENSE)**（PolyForm 非商业许可）约束：

- **版权与所有权**：始终归作者（LogicByteCraft）所有，不因下载或使用而转移。
- **允许**：个人免费下载、使用、分享（须保留本许可与版权声明），可用于个人学习、娱乐、业余项目等非商业目的。
- **禁止**：任何商业用途（含销售、收费服务、公司内部盈利性使用等），未经作者书面授权不得商用。

完整条款见仓库根目录 [`LICENSE`](./LICENSE)。

---

## 安全提示：为什么会被杀毒软件拦截？

本仓库中的工具均为作者个人开发、免费分享，**软件本身安全，不含广告、捆绑安装或恶意行为，可放心使用**。

下载或运行时若被 Windows 或杀毒软件提示「风险」「未知发布者」，甚至被自动删除，**这是正常现象，并非软件真的有问题**。常见原因如下：

| 原因 | 说明 |
|---|---|
| **无代码签名证书** | 商业软件通常会购买数字证书对 `.exe` 签名。本仓库工具为个人作品，未购买证书，Windows 会显示「发布者：未知」。 |
| **下载来源未被广泛信任** | SmartScreen 等机制会统计软件的下载量与信誉，小众、新发布的程序容易被标记为「无法识别的应用」。 |
| **杀毒软件启发式误报** | 360 等国产杀软对「无签名 + 单文件绿色软件 + 系统钩子/托盘」类程序较敏感，可能误判为「风险程序」。 |
| **行为特征触发规则** | 部分工具会监听鼠标、修改窗口状态、常驻托盘等——这些合法功能有时会被启发式规则误伤。 |

**结论**：提示来自「缺少商业背书 + 启发式规则」，不是检测到病毒。发布包仅包含程序本身，无后门、无挖矿、无广告。

---

## 如何放行本仓库的工具

以下步骤适用于本仓库中所有 Windows 可执行文件（如 `pin.exe` 等）。

### 1. Windows SmartScreen（微软 Defender）

首次双击运行时，可能出现蓝色窗口：**「Windows 已保护你的电脑」**。

1. 点击 **「更多信息」**；
2. 点击 **「仍要运行」**。

![Windows SmartScreen：点击「更多信息」后选择「仍要运行」](./docs/images/windows-smartscreen-run-anyway.png)

> 不要因「发布者：未知」而放弃——个人开发者未签名的程序都会显示此项。

### 2. 360 安全卫士：运行时的拦截弹窗

若弹出橙色警告：**「有程序可能误导您下载安装不需要的软件」**：

1. **不要** 点击 **「立即清除」**（会阻止运行或删除文件）；
2. 点击左下角蓝色链接 **「忽略提醒」**。

![360 拦截弹窗：点击左下角「忽略提醒」，勿点「立即清除」](./docs/images/360-ignore-warning.png)

### 3. 360 安全卫士：加入信任区（推荐，防误删）

仅「忽略提醒」有时仍可能在后台被隔离或删除，**建议将程序加入「已信任区」**：

1. 打开 **360 安全卫士**，点击右上角 **「安全操作中心」**（盾牌 + 加号图标）；
2. 左侧选择 **「已信任区」**；
3. 点击 **「添加文件」**，选中已下载的可执行文件；
4. 添加成功后再运行，可避免再次被误报或误删。

![360 安全卫士：安全操作中心 → 已信任区 → 添加文件](./docs/images/360-add-trusted-file.png)

> 若日后将程序移动到其他文件夹，请对新路径重复添加。若文件已被误删，请从本仓库重新下载，加入信任区后再运行。

### 4. 其他杀毒软件

- **Windows Defender**：设置 → 病毒和威胁防护 → 排除项 → 添加程序或所在文件夹；
- **火绒、腾讯电脑管家等**：在「信任区 / 白名单」中添加本程序；
- **企业环境**：请将本说明提供给 IT 管理员申请放行。

---

## 目录说明

### `pin/windows/pin.exe`

**Pin** — Windows 窗口置顶小工具。

- **作用**：把任意窗口固定在最上层（Always on Top），适合看文档、对照网页、看视频时需要某个窗口始终可见的场景。
- **用法简述**：
  1. 双击运行后，程序常驻系统托盘（无主窗口）。
  2. 左键点击托盘图标，或右键菜单选择「图钉模式」，进入选窗状态。
  3. 左键点击目标窗口即可置顶，标题栏会出现图钉徽章；再次点击徽章可取消置顶。
  4. 右键菜单提供「赞赏作者」「联系作者」「工具列表」「退出」等项。
- **系统要求**：Windows 7 / 10 / 11（x64）。绿色单文件，免安装，无第三方运行库依赖。

---

更多工具将按「工具名 / 平台」分目录放置，请直接进入对应目录使用。