Gacut/OpenTrace
GitHub: Gacut/OpenTrace
OpenTrace 是一个完全离线、隐私优先的桌面 OSINT 调查组织工具,通过可视化看板帮助调查者结构化管理线索、证据和调查流程。
Stars: 0 | Forks: 0
# OpenTrace
OpenTrace 是一个隐私优先、完全离线的桌面工作区,专为组织
OSINT 调查而设计。它提供了可视化的调查看板,无需
账号、云同步、遥测或强制性的在线服务。
## 核心亮点
- 无限可视化看板,支持文本笔记、图像、图钉和
有向关系
- 可编辑的关系标签、颜色、箭头和分支连接
- 任务、验证队列、来源、假设和调查日志
- OSINT 属性、标签、分类、来源 URL、别名和 SHA-256
完整性信息
- 跨材料、日志条目和 UUID 标识符的搜索功能
- 全局、用户管理的 OSINT 工具库,可在不同调查间共享
- 自动保存、撤销/重做、图层、保存的摄像头状态和看板导航
- 便携式调查文件夹,支持 ZIP 打包和解压
- 导出为 PNG 和结构化的 JSON 格式
- 提供波兰语和英语用户界面
- 完全离线运行,无任何遥测
## 环境要求
- Python 3.12
- PySide6 6.11.1
## 从源码运行
```
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .[dev]
python -m app
```
在 Linux 上,使用以下命令激活环境:
```
source .venv/bin/activate
```
源代码设计为跨平台的,但当前可下载的 1.0.0
二进制发布版本主要针对 Windows x64 平台。
## 测试
```
$env:QT_QPA_PLATFORM = "offscreen"
pytest
```
GitHub Actions 测试工作流会在 Windows 和 Ubuntu 上运行该测试套件。
## 构建 Windows 应用程序
```
python -m pip install -e .[dev]
pyinstaller --clean --noconfirm opentrace.spec
```
应用程序将生成在 `dist/OpenTrace/` 目录中。发布工作流会运行
测试,在 Windows runner 上构建此目录,添加许可证文件,
创建 ZIP 压缩包,计算其 SHA-256 校验和,并将这两者作为
GitHub Release 资产发布。
## 调查数据
一项调查即是一个常规的便携式目录。SQLite 用于存储其元数据,
而导入的图像会被复制到调查的 `media/` 目录中。
存储在数据库中的路径均为相对路径。
全局 OSINT 工具库存储在用户的应用程序配置
目录中,并有意设计为独立于单个调查。
## 隐私与网络行为
OpenTrace 不发送遥测数据,也不自动查询外部
服务。由用户明确打开的 URL 将被传递给系统的默认
Web 浏览器。
## 许可证
OpenTrace 基于 [MIT 许可证](LICENSE) 发布。
独立发行版包含了基于
LGPLv3 使用的 Qt for Python 组件。第三方声明、完整的许可证文本、对应源
代码信息以及重新链接说明可在
[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) 和
[`licenses/`](licenses/) 目录中找到。
## 作者
由 [Gacut](https://github.com/Gacut) 借助
[OpenAI Codex](https://openai.com/codex/) 创建。
OpenTrace 是一个隐私优先、完全离线的桌面工作区,专为组织
OSINT 调查而设计。它提供了可视化的调查看板,无需
账号、云同步、遥测或强制性的在线服务。
## 核心亮点
- 无限可视化看板,支持文本笔记、图像、图钉和
有向关系
- 可编辑的关系标签、颜色、箭头和分支连接
- 任务、验证队列、来源、假设和调查日志
- OSINT 属性、标签、分类、来源 URL、别名和 SHA-256
完整性信息
- 跨材料、日志条目和 UUID 标识符的搜索功能
- 全局、用户管理的 OSINT 工具库,可在不同调查间共享
- 自动保存、撤销/重做、图层、保存的摄像头状态和看板导航
- 便携式调查文件夹,支持 ZIP 打包和解压
- 导出为 PNG 和结构化的 JSON 格式
- 提供波兰语和英语用户界面
- 完全离线运行,无任何遥测
## 环境要求
- Python 3.12
- PySide6 6.11.1
## 从源码运行
```
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .[dev]
python -m app
```
在 Linux 上,使用以下命令激活环境:
```
source .venv/bin/activate
```
源代码设计为跨平台的,但当前可下载的 1.0.0
二进制发布版本主要针对 Windows x64 平台。
## 测试
```
$env:QT_QPA_PLATFORM = "offscreen"
pytest
```
GitHub Actions 测试工作流会在 Windows 和 Ubuntu 上运行该测试套件。
## 构建 Windows 应用程序
```
python -m pip install -e .[dev]
pyinstaller --clean --noconfirm opentrace.spec
```
应用程序将生成在 `dist/OpenTrace/` 目录中。发布工作流会运行
测试,在 Windows runner 上构建此目录,添加许可证文件,
创建 ZIP 压缩包,计算其 SHA-256 校验和,并将这两者作为
GitHub Release 资产发布。
## 调查数据
一项调查即是一个常规的便携式目录。SQLite 用于存储其元数据,
而导入的图像会被复制到调查的 `media/` 目录中。
存储在数据库中的路径均为相对路径。
全局 OSINT 工具库存储在用户的应用程序配置
目录中,并有意设计为独立于单个调查。
## 隐私与网络行为
OpenTrace 不发送遥测数据,也不自动查询外部
服务。由用户明确打开的 URL 将被传递给系统的默认
Web 浏览器。
## 许可证
OpenTrace 基于 [MIT 许可证](LICENSE) 发布。
独立发行版包含了基于
LGPLv3 使用的 Qt for Python 组件。第三方声明、完整的许可证文本、对应源
代码信息以及重新链接说明可在
[THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) 和
[`licenses/`](licenses/) 目录中找到。
## 作者
由 [Gacut](https://github.com/Gacut) 借助
[OpenAI Codex](https://openai.com/codex/) 创建。标签:PySide6, Python, 可视化分析, 数据库接管, 无后门, 桌面应用, 漏洞挖掘, 调查与取证, 逆向工具