开源分享 | Knox Project：基于 Windows 的本地智能终端套件（C++17 / AI 驱动 / 硬件级授权）
一个高中生团队从零打造的 Windows 本地终端工具套件：AI 智能协助、命令补全、KGPKG 打包分发、HWID 硬件授权，全部开源（GPL-3.0）。
项目简介
KnoxProject WinSet Pro是一款基于 Windows 的本地智能终端工具套件，当前版本v3.1.2。它把命令行终端、AI 大模型、任务管理、工具打包分发、硬件授权集成到一个自成一体的工具集中，主打"数据本地化 + AI 协助 + 极客体验"。
- 语言 / 标准：C++17，CMake ≥ 3.25，MinGW
- 平台：Windows 10 / 11 x64
- 许可证：GPL-3.0
- 官方主页：https://knox-project.gitee.io/Knox-Project-Release/（后续会推出，现在暂时没有）
- 源码仓库：https://gitee.com/knox-project/Knox-Project-Release
为什么做这个项目
- 本地优先：不想把系统管理、命令执行这类敏感操作交给云上工具，一切数据（任务表、命令频率缓存、AI 配置）加密后落在本地；
- AI 能用但可控：大模型做"助手"而不是"替代"，执行命令前分级评估风险、按权限档位决定放行还是询问；
- 打包分发闭环：自己写的工具一键打成
.kgpkg包，加密 + 硬件绑定 + 签名校验，装到别的机器直接用。
技术架构
项目采用四层架构：
┌────────────────────────────────────────────────┐ │ L1 输入层 KnoxTECH 终端 / KnoxAI_GUI Web 界面 │ ├────────────────────────────────────────────────┤ │ L2 智能中枢 KnoxAI / XeonAdapter / XeonShell │ ├────────────────────────────────────────────────┤ │ L3 安全引擎 KnoxDefender / HWID 授权 / AES-256 │ ├────────────────────────────────────────────────┤ │ L4 系统接口 KnoxCommon / XeonLogger │ └────────────────────────────────────────────────┘| 组件 | 说明 |
|---|---|
| KnoxTECH | 主终端：命令分发、任务管理、AI 配置、工具注册、日志审计 |
| XeonShell | 命令执行引擎：子进程管道、双向交互（stdin 修复） |
| KnoxAI | 大模型组件：兼容 OpenAI 协议（默认 DeepSeek API），逐步执行、风险分级 |
| KnoxAI_GUI | 本地 Web 图形界面（http://127.0.0.1:<port>） |
| XeonAdapter | 命令使用频率缓存（.xa/.xan，AES-256 加密存储） |
| KnoxDefender | 守护进程 |
| XeonInstaller | .kgpkg安装器 |
| PackageBuilder | .kgpkg打包器（工具说明元数据 toolDesc） |
| Activator / KeyGen | 离线激活 / 授权序列号生成 |
| KnoxCommon / XeonLogger | 公共库（加密、授权、共享任务表）与日志库 |
核心特性与实现亮点
1. 硬件级授权体系
基于HWID 硬件指纹（读取设备唯一标识）生成绑定授权文件license.lic，配套离线激活工具Activator与序列号生成器KeyGen。授权信息包含许可证类型、有效期、绑定的硬件指纹，从机制上防止授权文件被随意拷贝。
2. 全链路加密
运行时数据全部走AES-256 加密：
XeonAdapter的命令频率缓存.xa/.xan（hex 文本 + AES）- KnoxAI 的配置文件（API 地址 / Key / 模型 / 权限档位）
.kgpkg包内容（AES 加密 + SHA-256 校验 + 硬件绑定）
3. AI 智能协助，但"可控"
knox ai true配置 DeepSeek（OpenAI 兼容协议）后：
- 逐步执行：AI 一次只执行一条命令，先提示风险等级再运行，运行完再继续下一条；
- 风险分级：
safe（直接执行）/warn（询问）/danger（询问或拒绝）/stop（任何权限都拒绝）； - 权限三档：
full（完全操作）/ask（敏感操作询问，默认）/none（完全禁止）。
4. 多窗口任务共享
通过内存映射共享任务表（96 槽）实现多窗口 jobs 共享：每个窗口都能看到并操作同一份任务列表，支持跨窗口终止任务（kill）、AI / 用户来源标注。
5. 交互体验细节
- 灰色自动补全：输入时匹配常用命令（仅统计
.xa中使用次数 > 3 的），→一键接受； - Tab 补全：
.ks脚本名、工具名、任务子命令、目录； .ks脚本：一键创建并直接运行（支持注释、普通任务通道）；neofetch/stat/ver等极客向命令。
6. 打包分发闭环
PackageBuilder把工具 + 说明（toolDesc）打成.kgpkg→XeonInstaller安装 → 终端内直接调用，形成"打包 → 分发 → 安装 → 使用"完整链路。
快速上手
下载：前往 Gitee Releases 下载最新安装包，解压后双击KnoxProject.exe，按提示导入license.lic激活。
源码构建：
# CLion 打开根目录，Reload CMake，Build 即可cmake-Bbuild-GNinja-DCMAKE_CXX_STANDARD=17cmake--buildbuild-j8构建目标：KnoxTECH / XeonShell / KnoxAI / KnoxAI_GUI / XeonAdapter / KnoxDefender / XeonInstaller / PackageBuilder / Activator / KeyGen。
常用命令：
help # 全部命令 task list # 查看任务 tool list # 已安装工具 install xx.kgpkg knox ai true # 配置 AI（API / Key / 模型 / 权限） license # 查看授权 neofetch # 系统信息项目信息
- 许可证：GPL-3.0，源码完全开放，欢迎 fork、提 PR
- 免费声明：软件免费试用，若有人收费请立即拒绝
- 团队：高中生团队（Larry Knox / Yolo），可能有 bug，欢迎建议
后续计划
- AI 组件更多模型接入与工具调用能力
- 更完善的
.kgpkg生态与云端包仓库 - GUI 界面打磨与跨终端体验
如果你对 Windows 终端、AI 落地、授权保护感兴趣，欢迎 Star、提 Issue 或直接联系团队交流！
（本篇为初稿，对软件的覆盖面积很少，后续如有时间的话，我们会推出更加详细的）
详细使用说明（图文）将于11月初推出……
