---

📖 项目简介

远程知道了 是一款能够实时监测本地系统的远程控制状态，识别多种主流远程工具（如 ToDesk, 向日葵, 网易 UU 远程，AskLink 远程，远程看看等），并提供桌面通知、飞书/钉钉告警以及详细的会话审计记录。

✨ 核心功能

• 🛡️ 实时感知：多维度信号（进程、窗口、网络端口、Session ）综合判定。
• 👁️ 多工具支持：
  • ToDesk
  • 向日葵 (Sunlogin)
  • Windows 远程桌面 (RDP)
  • 网易 UU 远程
  • AskLink 远程
  • 远程看看
• 📝 会话审计：自动记录每次远程控制的开始时间、结束时间、持续时长及判定来源。
• 🔔 多渠道告警：
  • 桌面右下角弹窗通知
  • 系统托盘状态变色（绿色安全，红色警告）
  • 即时通讯软件推送（支持飞书 Webhook 、钉钉 Webhook ）
• 🔒 隐私优先：所有数据均存储在本地 SQLite 数据库中，不上传任何敏感信息。

🚀 快速开始

下载安装

请从以下任一平台下载最新的安装包 (RemoteKnown-Setup-x.x.x.exe) 并安装：

• GitHub: GitHub Releases 页面
• Gitee: Gitee Releases 页面
• AtomGit: AtomGit Releases 页面

运行

安装完成后，双击桌面图标启动。

• 程序启动后会自动最小化到系统托盘。
• 当检测到远程控制时，托盘图标会变红，并弹出提示。
• 点击托盘图标可打开主界面查看详细状态和历史记录。

🛠️ 编译构建

如果您是开发者，想要自行构建项目，请遵循以下步骤：

环境要求

• Windows 10/11 (核心检测逻辑依赖 Windows API)
• Go: 1.21 或更高版本
• Node.js: 18 或更高版本 (推荐使用 LTS)

构建步骤

我们提供了一键构建脚本，自动处理 Go 后端编译和 Electron 前端打包。

必须以管理员身份运行 CMD 或 PowerShell （解决软链接权限问题）：

# 1. 克隆项目
git clone https://github.com/samwafgo/RemoteKnown.git
cd RemoteKnown

# 2. 运行构建脚本 (会自动安装依赖并打包)
.\build.bat

构建完成后，安装包将生成在 web/dist 目录下。

📂 项目结构

RemoteKnown/
├── build.bat             # 一键构建脚本 (Windows)
├── cmd/                  # Go 程序主入口
├── internal/             # Go 核心业务逻辑
│   ├── detector/         # 远程特征检测引擎
│   ├── server/           # 本地 HTTP API 服务
│   └── storage/          # SQLite 数据库操作
├── web/                  # Electron 前端源码
│   ├── assets/           # 静态资源 (Logo 等)
│   ├── index.html        # 主页面
│   └── main.js           # Electron 主进程 (含单实例锁、后端守护)
└── README.md             # 项目文档

🤝 参与贡献

欢迎提交 Issue 和 Pull Request ！

代码仓库

• GitHub: https://github.com/samwafgo/RemoteKnown
• Gitee: https://gitee.com/samwaf/remote-known
• AtomGit: https://atomgit.com/SamSafe/RemoteKnown

📄 开源协议

本项目采用 [MIT License] 开源。