Note
我们诚挚的邀请您参与我们的生态建设，欢迎通过Issue、Pull Request协助我们开发NOT Toolbox及资源仓库，我们将不胜感激。
Note
Agent 功能已经进入发布候选阶段！点击此处了解最新的功能更改
- Linux\Win跨平台：支持Windows 10+与主流Linux发行版
- 包管理器集成：自动检测系统包管理器（APT、DNF、PACMAN、ZYPPER、SCOOP、WINGET等）
- 终端功能集成: 集成终端模拟器，支持多会话管理
- 现代UI：采用 Material Design 3 设计风格
- 极佳可迁移性：使用 Kotlin + Compose Multiplatform 跨平台框架
- 代码透明：完全开源，可供任何人审计
- 去本地化：不打包任何第三方应用，完全由云端+包管理器获取
- Linux
推荐Arch、Debian/Ubuntu、Fedora、openSUSE等主流发行版，Linux Kernel 4.x+ - Windows
Windows 10 1507+（内部版本 10240），需要至少存在一种包管理器。
- Java环境：Java 21 或更高版本
- 网络：需要稳定网络连接（用于包管理器操作）
- 权限：Linux平台上需要sudo权限，否则将无法使用大部分功能，在Windows需要用户同意UAC（由包管理器发起，NOT Toolbox程序不提升权限）
Windows
- 从 Releases 下载
NTB.exe - 运行并安装（若未安装Java21会自动跳转至TUNA下载JRE 21安装包，安装即可）
- 点击快捷方式通过启动器快速启动NOT Toolbox
Linux
- 从 Releases 下载
NTB.tar.gz - 使用
解压压缩包
tar -zxvf NTB.tar.gz
cd NTB进入解压后的目录- 执行：
sh linux-startup.sh
- 确保已安装Java 21或更高版本
- 从本项目的 Releases 页面下载
NTB-all.jar - 运行应用程序：
java -jar NTB-all.jar
# 克隆仓库
git clone https://github.com/HOE-Team/not-toolbox.git
cd not-toolbox
# 构建可执行JAR
./gradlew fatJar
# 或构建一个经过ProGuard压缩的包
./gradle shrinkJar
# 运行应用程序
java -jar build/libs/NTB-all.jar
# 或
java -jar build/libs/NTB-shrunk.jar本项目使用JAR分发，具有以下优势：
- 跨平台：可在任何支持Java的Linux与Windows系统上运行
- 便携性：单个JAR文件包含所有依赖
- 易于分发：无需复杂的安装过程
欢迎向我们发送 Issue 或 Pull Request。
-
创建分支
git checkout -b feat/agoodfeat
-
提交代码
git add . git commit -m "[feat] A good feat."
-
推送分支
git push origin feat/agoodfeat
-
创建 PR
- 前往 GitHub 仓库
- 点击 "New Pull Request"
- 选择你的分支
- 填写标题和描述
- 提交
类型: 描述
[feat] - 新功能(或[feature])
[fix] - 修复bug
[docs] - 文档更新
[style] - 代码格式
[refactor]- 代码重构
[chore] - 杂项
git commit -m "[feat] 添加新功能"
git commit -m "[fix] 修复已知问题"
not-toolbox/
├── src/main/kotlin/ # Kotlin源代码
│ ├── components/ # 可复用组件
│ ├── screens/ # 主要界面
│ ├── utils/ # 工具类（包管理器、系统信息等）
│ ├── theme/ # 主题配置
│ └── config/ # 配置类
├── LICENSES/ # 非主项目的授权信息或许可证
│ ├── LICENSE-MIT-NNETB # NNETB(上游)许可证
│ ├── LICENSE-GPLV3- # NNETB For Linux(上游)许可证
| | NNETB-FOR-LINUX
│ ├── LICENSE-MIT-NTB- # NTB Launcher(启动器)许可证
| | LAUNCHER
│ └── LICENSE-MIT-NTB- # NTB LPT(打包程序)许可证
| LAUNCHER-PACK-TOOLS
├── startup/ # 启动脚本与启动器
│ ├── res-py # 打包用资源文件
│ └── pyi # 打包操作目录
├── src/main/resources/ # 资源文件
├── build.gradle.kts # Gradle构建配置
└── README.md # 项目说明
| 组件 | 用途 | 开源协议 |
|---|---|---|
| Kotlin | 主要编程语言 | Apache 2.0 |
| Compose Multiplatform | 跨平台声明式 UI 框架 | Apache 2.0 |
| OSHI | 操作系统和硬件信息获取 | MIT |
| Ktor | 异步网络框架 | Apache 2.0 |
| Gradle(Kotlin DSL) | 编译工具 | GPL 2.0 |
| ProGuard | 混淆与压缩工具 | GPL2.0 |
| Skiko | 渲染库 | Apache 2.0 |
| Python | Windows启动器使用语言 | PSF 2.0 |
| PyInstaller | 启动器打包工具 | GPL 2.0 |
| Inno Setup | Windows平台安装程序打包工具 | Inno Setup License |
| Multiplatform Markdown Render | 跨平台Markdown渲染库 | Apache 2.0 |
你可以通过我们的电子邮箱 hoe_software_team@outlook.com 发送邮件联系我们，或者加入我们的团队QQ群：1081639867。
如果你觉得本项目对你有帮助，欢迎给个 Star 支持！
将此变量改为“true”启用调试，程序将使用本地存储的Packages Lists而不是从远程拉取。
Caution
非调试用途不要修改变量，因为本地调试包列表不是最新的且质量不佳，Fork项目也可能遭受针对此的供应链攻击。
MainApp.kt:
// 编译时常量：true=启用本地DEBUG包列表，false=从远程拉取
const val IS_DEBUG = false参见 HOE-Team/not-toolbox-resource
参见本仓库的 startup 文件夹中的 适用于 NOT Toolbox 的 Windows 平台打包工具、启动器与 Linux 平台启动脚本 文档。
版权所有 © 2026 HOE Team。保留部分权利。
本项目（NOT Toolbox）基于 GNU GPL v3 许可证 开源，是独立于 NNETB （MIT 许可证）和 NNETB-For-Linux （GPLv3 许可证）的跨平台下游分支。
启动脚本及启动器授权信息参见 适用于 NOT Toolbox 的 Windows 平台打包工具、启动器与 Linux 平台启动脚本 文档。
Note
这份许可证(GNU GPL v3)意味着：
你可以自由使用、修改、复制、分发这个项目代码，无论是在个人项目还是商业项目中。
如果你修改并重新发布这个代码，你必须以 GPL v3 许可证公开你的修改后的源代码（即“传染性”开源）。
你可以用它来开发商业软件并销售，但你必须同时以 GPL v3 许可证提供你修改后的完整源代码。
作者不提供任何保证，如果使用该软件导致任何问题，你需要自己承担风险。