# easyset-go

**Repository Path**: codeyuany/easyset-go

## Basic Information

- **Project Name**: easyset-go
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasySet Go

这是 `EasySet Tool.exe` 的 Go 重写项目交接仓库。当前阶段已经完成 Windows 样本静态逆向和协议主干恢复，尚未开始产品代码实现。

目标是开发一个以 Windows 为主要运行平台、可以在 macOS 上完成大部分开发和测试的打印机配置工具。项目计划使用 Go 实现协议、设备模型和状态机，使用 Wails v2 + TypeScript 实现桌面界面。

## 当前状态

| 范围 | 状态 | 说明 |
|---|---|---|
| UDP 搜索 | 已静态确认 | 目标端口、报文和响应处理已恢复 |
| UDP 改 IP | 已静态确认 | 25 字节报文结构已恢复 |
| DHCP/打印网络信息 | 大部分确认 | 命令值已恢复，两个网络上下文字段名称仍需抓包确认 |
| TCP/串口 | 架构确认 | 打开、超时和统一收发状态机已恢复 |
| USB | 部分确认 | 命令封装已恢复，设备枚举和多机型行为需 Windows 真机验证 |
| 固件升级 | 大部分确认 | 分包、帧头和 CRC 已恢复，设备应答语义需真机验证 |
| 全部机型参数 | 数据存在 | 嵌入命令表已提取，但字段语义需要逐项建模和验证 |

## 阅读顺序

1. [AGENTS.md](AGENTS.md)
2. [docs/handoff.md](docs/handoff.md)
3. [docs/protocol.md](docs/protocol.md)
4. [docs/architecture.md](docs/architecture.md)
5. [docs/api-contract.md](docs/api-contract.md)
6. [docs/ui-spec.md](docs/ui-spec.md)
7. [docs/implementation-plan.md](docs/implementation-plan.md)
8. [docs/testing.md](docs/testing.md)
9. [docs/hardware-validation.md](docs/hardware-validation.md)
10. [docs/mac-setup.md](docs/mac-setup.md)
11. [reverse/function-index.md](reverse/function-index.md)

## Mac 上开始开发

```bash
git clone <your-private-repository-url> easyset-go
cd easyset-go
codex
```

进入 Codex 后使用 [CODEX_BOOTSTRAP_PROMPT.md](CODEX_BOOTSTRAP_PROMPT.md) 中的提示词。

建议环境：

- 当前稳定版 Go
- 当前 LTS 版 Node.js
- Wails v2
- macOS 上安装 Xcode Command Line Tools
- Windows 10/11 真机或虚拟机，用于 USB、打印、驱动和最终安装包验证

## 重要限制

- 不允许根据 UI 文案猜测协议字节。
- 未经明确确认，测试不得广播真实改 IP、DHCP 或固件命令。
- 不复用 `TVicPort.sys`。新版优先使用 WinUSB、USB Print、HID、串口或厂商受支持的 DLL。
- 原始 EXE、驱动、固件和 PCAP 只能放在 `reverse/private/` 或私有制品存储中，不应提交到公共仓库。

Windows 侧完整逆向目录：

```text
C:\Users\yong\Desktop\EasySet Tool-逆向分析
```