在上一篇《开源分享 | Knox Project：基于 Windows 的本地智能终端套件》中，我们介绍了项目整体架构、核心特性与设计思路。发布后陆续收到开发者关于部署流程、授权激活与基础配置的咨询。为方便大家快速上手、完整体验全部功能，本文整理了 Knox Project 完整的安装配置指南，从环境依赖、安装包部署、HWID 离线激活到初始参数配置逐一说明，全程无强制联网依赖，适配主流 Windows 环境快速部署。
废话不多说，我们直接开始。
第一步：下载与激活
1、访问Gitee仓库（链接）–> 下载
2、解压缩，进入Version 3.1.1子目录（里面的所有东西即为软件本体） –> 将它们整体复制进你喜欢的地方（例如：U盘、硬盘、C盘等）
在此，我将它们复制进了D盘（但千万要注意，确保路径中没有任何中文、空格或是特殊符号！！！）
3、运行Activator.exe以及KeyGen.exe，将Avtivator.exe输出的Local Hardware ID复制，然后粘贴到KeyGen.exe中，然后按照KeyGen.exe中的提示按顺序输入用户名、激活有效期，回车后获得激活码，将激活码粘贴进Avctivator.exe中，按要求顺序输入激活码、用户名、激活有效期，回车后激活成功。
KeyGen.exe界面
Avtivator.exe界面
4、双击运行主程序（KnoxProject.exe），若激活成功即为这样，但若激活失败上方字体即为1红色
到此即为激活配置完成。
第二步：启用并配置AI
1、访问DeepSeek API网站（链接），登陆自己的账号，进入“API Keys”，进入“创建API Key”，复制好Keys –> 输入命令“knox ai true”，回车，按提示输入内容（回车即为默认选项），完成AI配置。
到此KnoxAI即已被启用，你可以通过message+参数来调用它（具体命令如下）
附言：
1、详细命令参考清单：
KnoxProject WinSet Pro 完整命令参考
————————————————————–
核心系统命令:
cd [目录] 切换工作目录（~ 为用户主目录）
newwin 打开独立的新程序窗口
license 查看离线激活许可证状态
elevate 以完整管理员令牌重启程序
lock 锁定工作站屏幕
install <包> 安装 .kgpkg 安全审计工具包
exit 关闭窗口（系统转后台）
shutdown 关闭整个系统并终止全部进程
执行 Shell 命令:
cmd <命令> 执行原生 CMD 命令
ps <命令> 执行 PowerShell 命令
sudo <命令> 以管理员权限执行单条命令（输出内联）
sudo su 进入 root 会话：所有命令以管理员运行
logout 离开 root 会话（等同 root 会话内 'exit'）
后台任务管理器:
jobs / task list 显示所有运行中/已完成的任务
task kill <id> 强制终止指定任务
task attach <id> 将后台任务重新切到前台
task log <id> 打印任务完整输出历史
快捷键 Ctrl+B: 将当前任务转入后台
工具注册表:
tools / tool list 列出所有已注册工具
tool add <名> <路径> [描述] 注册新外部工具
install <package> 安装 .kgpkg 工具包
uninstall <工具名> 完全移除工具及其文件
tool remove <名> 删除工具注册项（保留文件）
<工具名> [参数] 直接运行已注册工具（如 toolname -h）
日志与会话管理:
log list 列出所有已保存的日志会话
log load <sid> 加载历史任务日志
log del <sid> 永久删除日志会话
log clean 自动清理过期日志
log system 打印实时系统日志
export <dir> 导出全部会话日志到文件夹
AI 助手 (KnoxAI):
message -c <text> 与 KnoxAI 普通对话
message -r <request> KnoxAI 分步执行任务
message -q <tid> <q> 询问任务输出/报错
message -a <tid> <q> 解释任务输出/命令含义
message -s <tid> 显示 AI 任务的工具输出
knox ai true|false 启用/禁用 AI 组件
命令缓存与脚本 (V3.1):
ax reload 从全部日志重建 .xa/.xan 命令缓存
→ (Right arrow at end) 接受灰色补全建议
add ks <name> 创建 .ks 脚本（记事本编辑）按名调用
change <new> <cmd> 为已注册工具设置别名
ls [dir] 列出目录内容
cp <src> <dst> 复制文件/目录
rm <path> 删除文件/目录
系统工具命令:
ver / buildvs 显示程序版本与版权
stat / info 显示运行状态面板
neofetch 显示硬件与系统详情
cls / clear 清屏
help / ? 显示本命令手册
2、已探明bugs及说明：
1、路径中千万不要包括空格！！！目前我们还未能成功定位到bugs位置，所以暂时未能修复，源代码我们已经上传Gitee仓库，若有人能帮助我们找出问题，我们将不胜感激！
2、install命令安装包时不知道为什么一直会报错（错误代码：1），我们也没能成功找到问题……所以，暂时可能只能使用tool add命令进行添加。另外，在后续版本中我们将会把路径引用改为相对，实现即插即用，敬请期待。
若你们在使用过程中发现了更多的bugs，欢迎向我们提出！
