# vkbox

**Repository Path**: jun626/vkbox

## Basic Information

- **Project Name**: vkbox
- **Description**: 这是一个HID转换器，用于把串口命令转换为鼠标或者键盘的命令，可以用于制作一些解放操作的小工具或者键鼠中继器，延长线缆长度
禁止用于密码破解，非法游戏竞技等方面
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VKBox - 精灵盒子
<img src="./picture/20250518.png" alt="第一版3D视图" width="300" />  

一个软件开源的自动化工具,允许用于配置接口功能,开放控制协议  

## 项目背景
产品开发过程中,经常遇到需要和测试/产线同事对接操作流程的问题,由于专业性的差距,有些研发认为很合理的行为,对他们来说是一件不能理解的事情.  
最近几年尝试了诸多方式简化对接流程,包括且不限于  
- 写操作文档,却被批判描述不清,或者步骤不详细  
- 用类似python/qt/matlab等工具实现各种各样的自动化工具,但是却苦于测试的不确定性,导致经常会出现项目变动修改代码,往往时间久了,我都不知道要干个啥  
- 实地操作手把手教学....算了吧,产品有时候玩的还没人家溜,教人有时候还教错了
  
有幸看到了node-red项目和按键精灵工具,突然冒出一个灵感,无论是生活或者工作,用电脑的时候,总是有些机械重复性的工作,那么
- 假设有一个软件,像node-red一样是以节点拖拽的方式,实现的业务逻辑，类似小朋友的电子积木,又或者是设备读取类似json文件,实现一些预置操作,像按键精灵一样,有顺序的执行
- 有一个设备能模拟人的操作,也就是键盘和鼠标,模仿按键精灵,不要纯软件,搞了几年QT，说起来是跨平台,但或多或少会存在一些兼容性问题,而我的工作环境经常在win和linux下切换
当这样一个东西存在的时候,以简便的方式实现功能配置,不需要投入研发成本,对于一些重复性的工作就可以交给机器,而人只要看着就行

## 项目构思
1.应该是一个通用的接口
- IIC和SPI这些不考虑,这些是硬件协议,不是普通人用的东西
- 485/串口在考虑中,嵌入式入门必学的东西,实现简单,也是常用接口
- 网络有考虑,但放弃了因为它更倾向于纯软件,纯软件我要考虑诸如跨平台和各种杀毒软件的问题(ps:罪恶360)
- USB是主要考虑的,因为思路就是来源于按键精灵,在电脑上又免驱
2.使用场景不应该影响正常的设备使用,所以应该是有个USB HOST能够读取USB信息，再转发到电脑，通过设备自己虚拟出键盘鼠标出来，这样的好处在于
- 可以截取输入的信息,也就可以自定义快捷键,配置操作行为
- 避免设备管理器有一堆的键盘鼠标,设备重复不太好

那么硬件的设计应该是  
- 键盘鼠标接到设备的USB HOST,电脑通过custom hid或者串口实现对设备的控制,设备再模拟键盘鼠标的操作实现功能  
- 要做一个IAP,方便更新固件  

## 短期的功能规划
### 1. 电脑开机启动应用程序工具
- 自定义快捷键绑定常用软件（QQ/微信/企业微信等）
- 支持多应用组合启动
- 可配置启动延迟和顺序

### 2. 智能生产工具
- 自动化固件烧录流程
- 通过Python脚本模拟人工操作
- 可视化操作录制与回放
- 错误检测与自动恢复机制

### 3. 代码辅助工具
- 一键插入常用代码模板
  - 标准头文件结构
  - 函数注释模板
  - 常用代码片段
- 支持自定义模板库
- 多语言支持（C/C++/Python等）

## 项目进度
```
20250517:样机已经开始打样,修改备忘
- 要加一个flash芯片,用于存储配置数据,不然后期必须时刻连接控制软件
- 要把串口和usb从设备改为typec座子,USB-A的话,必须要配线,不常见,不好
- 要添加时间和版本丝印

20250524:实现固件更新的程序，并且实现了固件更新软件,下一步开始做应用程序
20250610:来来回回白忙活，STM32不支持HUB，导致我调了两个礼拜都失败了,现在换个了芯片，终于搞定了
20250611:程序基本实现了,接下来可以为这个项目实现一些有趣的功能
20250809:发现有些鼠标，走的是复合设备，需要做一些调整
```
<img src="./picture/20250524.png" alt="PCB进度" width="300" />  

## 法律声明与使用规范
### 使用限制
本工具仅限合法用途，严禁用于：  
任何形式的黑客攻击或网络入侵  
绕过软件版权保护机制  
自动化点击广告等灰色/黑色产业  
其他违反所在国家/地区法律法规的行为 
   
使用者需承诺：  
不用于干扰或破坏他人计算机系统  
不用于自动化作弊（游戏/考试等）  
不侵犯他人隐私或知识产权  
开发者不承担因滥用本工具导致的任何法律责任  

### 免责声明
使用者应对自己的行为负全部责任。开发者不对以下情况负责：  
  
因使用本工具导致的任何直接或间接损失  
因违反法律法规导致的任何后果  
工具使用过程中可能存在的安全风险