Skip to content

HugoWidget/HugoDbg

Repository files navigation

HugoDbg

希沃前端调试工具,用于对希沃(Seewo)软件前端进行增强与功能补充,主要面向电教管理场景。

项目介绍

HugoDbg 通过调试器注入希沃服务进程,利用 Chrome DevTools Protocol (CDP) 向目标前端注入脚本,从而实现以下模式:

  • 主模式(Main):加载并执行完整的增强脚本(含 Loader 及 Bundle 分片)。
  • 清理模式(Cleanup):注入清理脚本,移除先前注入的功能。
  • 测试模式(Test):注入测试脚本,用于功能验证。

程序会持续检测目标进程的出现,待进程稳定存在后自动执行注入;同时支持锁文件、检测跳过、超时控制等辅助功能。

环境依赖

  • Visual Studio 2022
  • Windows SDK

编译运行

  1. 克隆仓库(注意包含子模块):

    git clone https://github.com/HugoWidget/HugoDbg --recursive
  2. 使用 Visual Studio 2022 打开解决方案 HugoDbg.slnx

  3. 选择配置(Debug/Release)与平台(x64),生成解决方案。

  4. 运行生成的 HugoDbg.exe,可通过命令行参数控制行为(见下文)。

命令行参数

HugoDbg.exe [选项]
参数 说明
-nocheck 跳过进程检测,只要目标进程出现即注入(默认会要求连续检测到目标进程 3 次后才注入)。
-cleanup 运行清理模式,注入移除脚本。
-test 运行测试模式,注入测试脚本。
-interval <毫秒> 检测目标进程的轮询间隔(默认 1000 毫秒)。
-timeout <毫秒> 最大等待时间,超时退出(默认 10,000,000 毫秒)。
-lockfile create 在当前用户目录或指定目录下创建 unlock.bin 锁文件。
-lockfile delete 删除对应的锁文件。
-dir <路径> -lockfile 配合,指定锁文件的存放目录(默认为 C:\Users\<当前用户>)。

若未指定模式,默认运行主模式。

使用示例

你可以在 HugoSetup 获取已配置版本

  • 常规运行(检测到目标稳定后注入主脚本):

    HugoDbg.exe
  • 无需稳定性检测,立即注入:

    HugoDbg.exe -nocheck
  • 运行清理脚本:

    HugoDbg.exe -cleanup
  • 调整轮询间隔为 500 ms,总超时 60 秒:

    HugoDbg.exe -interval 500 -timeout 60000

项目依赖

HugoUtils(Hugo系列核心库)

许可证

本项目采用 GPLv3 许可证,详情参见 LICENSE 文件。

HugoUtils: LGPLv3 许可证

WinUtils: MIT 许可证

hash-library: zlib 许可证

swhelper:MIT 许可证

cpp-httplib: MIT 许可证

mINI: MIT 许可证

WinReg: MIT 许可证

免责声明

本项目仅用于研究或教育目的,请勿将本项目用于可能违反当地法律、侵犯著作权或其他软件 EULA 的用途。若将本项目用于非法用途,一切后果由使用者承担,开发者不承担此类行为带来的任何后果或责任。

About

希沃管家前端页面调试工具

Resources

License

Stars

Watchers

Forks

Contributors