Better-Seewo/README.md

# Better-Seewo

希沃白板 5 功能增强插件套件，为希沃白板提供墨迹管理、文件转换增强、触摸检测修复、大屏模式支持和专业版激活等功能。

## 项目结构

```
Better-Seewo/
├── Better-EN5/              # EN5 增强插件（核心模块）
│   ├── Services/            # 服务层（墨迹、转换、触摸修复、激活）
│   ├── UI/                  # 界面组件（Better-Seewo 主窗口、模块）
│   ├── Program.cs           # 插件入口
│   └── manifest.coin        # 插件元数据清单
├── install.ps1              # 安装脚本
├── Better-Seewo.sln         # 解决方案文件
└── README.md
```

## 功能

### Better-Seewo 主界面
横版布局，左栏（1/4）为 Better-EN5 模块，右栏（3/4）为待开发模块占位区。
采用 Fluent 设计风格，圆角窗口，平滑动画。

### 墨迹管理（InkService）
- 通过反射调用希沃白板 Remark API 实现墨迹导出/导入
- 兼容希沃白板 5.2.x 版本

### 文件转换（ConversionService）
- PPT ↔ ENBX 互转
- 调用 `EasiNote.OfficeDocumentConverter.exe` 独立进程

### 触摸修复（TouchFixService）
- 注册表配置（HKCU 级）
- 配置文件补丁（IWBConfig.json、TouchConfig.ini）

### 大屏模式支持（ActivationService）
- 非触摸大屏的 IWB 模式强制启用
- 跳过大屏触摸检测
- 配置文件修补 + 注册表配置
- 创建大屏模式快捷方式

### 专业版激活（ActivationService）
- 激活码验证与注册
- 专业版注册表写入
- 一键启动 BEN5 注册补丁安装程序

## 菜单位置

- **白板模式（授课模式）**：左下角菜单（ApplicationMenu）→ Better-Seewo、导出墨迹
- **备课模式**：文件下拉栏（ApplicationMenu）→ Better-Seewo
- **备课模式**：标题栏区域（ExtendedTitleBar）→ Better-Seewo
- **工具栏**（通用）：顶部工具栏按钮 → 导入墨迹

## 环境要求

- .NET 6.0 SDK
- 希沃白板 5（5.2.2.653 ~ 5.3.0.0）

## 构建

```bash
dotnet build Better-EN5/Better-EN5.csproj -c Release
```

构建后生成：
- `bin/Release/Better-Seewo 增强插件.{version}.exe` — 独立安装程序

## 安装

### 方式一：安装程序
双击 `Better-Seewo 增强插件.{version}.exe`，按向导完成安装。

### 方式二：手动部署
将 `Better-EN5\bin\Release\net6.0-windows\` 目录下所有文件连同 `manifest.coin` 复制到：
```
%APPDATA%\Seewo\EasiNote5\Extensions\Better-EN5\{version}\
```

## 使用方法

1. **重启希沃白板 5**
2. 在白板模式左下角菜单或备课模式文件栏中找到 **Better-Seewo**
3. 打开主界面，使用左栏的 Better-EN5 功能模块

## 技术要点

- 插件 SDK 基于 `dotnetCampus.EasiPlugin.Sdk`（v2.1.1-alpha.3）
- 目标框架 `net6.0-windows`（WPF + WinForms）
- 墨迹 API 通过反射调用（避免编译时硬依赖）
- 转换服务通过外部进程实现
- 菜单注册在 ApplicationMenu / ExtendedTitleBar / HeadToolBar

## 许可证

本项目仅供学习交流使用。