# YOND WebUI 更新日志

> 本更新日志由 **Kimi 2.7 Code** 撰写。README.md 与 GUIDE.md 同样由 Kimi 2.7 Code 协助生成。

## 2026-07-04

### 新增功能

1. **YAML 参数覆盖**
   - 新增 `Parameter Override (YAML)` 面板，支持上传 YAML 文件覆盖运行参数。
   - 支持覆盖 WB/CCM、RAW 元数据、噪声参数、DDIM 参数以及 `patch_size`。
   - 提供 **Download Template** 按钮，基于当前参数生成默认全部注释的 YAML 模板。

2. **ZIP 打包下载**
   - 新增 **Download ZIP** 按钮。
   - 可自选打包 Input (Noisy)、Output (Denoised)、Mask 的 NPY / PNG。
   - 移除了原先独立的 `Save as NPY` 和 `Save as PNG` 按钮。

3. **手动 WB / CCM 支持**
   - 用户可通过 YAML 指定白平衡和颜色校正矩阵。
   - 加载 RAW 文件时，手动指定的 WB/CCM 不会被 RAW 元数据覆盖。

### 性能与架构优化

1. **图像传输改用 numpy/cv2**
   - `gr.Image` 组件统一使用 `type="numpy"`。
   - 预览、掩模可视化、结果生成直接返回 `uint8 RGB numpy`，减少 PIL 转换开销。

2. **多用户状态隔离**
   - 以新版 `app_new.py` / `app_function_new.py` 替换旧版入口。
   - 每个浏览器 Tab 拥有独立的 `UserState`。
   - 模型与 `BiasLUT` 作为全局单例共享，限制最大并发用户数。

3. **pyarmor Windows 兼容性修复**
   - `pyarmor.sh` 支持在 Git Bash 下自动探测 conda 环境中的 `pyarmor`。
   - 若根目录 `isp_algos.py` 已归档到 `private/`，脚本会自动复制源文件继续加密。
   - 修复 `pyarmor --version` 解析错误。
   - `app_function.py` 优先加载 `dist/isp_algos.py`（加密版），失败时回退到 `private/isp_algos.py`（源码）。

### Bug 修复

1. **Slider / Number 字符串类型错误**
   - 现象：点击 **Noise Estimation** 后，Hugging Face 线上（Gradio 5.44.1）报错 `TypeError: '<' not supported between instances of 'str' and 'int'`。
   - 根因：Gradio 5.44.1 的 `.then()` 链式事件会把 Slider / Number 组件值从前端回传为字符串。
   - 修复：删除 `.then()` 链，直接在 `_estimate_noise` 中返回 `gr.update(value=..., minimum=..., maximum=...)`。

2. **YAML 超参数加载后 UI 不同步**
   - `_load_params_yaml` 现在返回多个 `gr.update(...)`，同步刷新 `bl`/`wp`/`ratio`/`ispgain`/`gain`/`sigma`/`sigsnr`/`ddim_mode`/`patch_size` 等界面组件。

### 界面调整

- 主界面标题、教程、下拉框标签等改为简洁英语。
- `gr.Info` 弹窗提示与代码注释保持中文。

### 文档

- 新增 `GUIDE.md` 使用说明。
- 新增 `UPDATE_LOG.md` 更新日志。
- `README.md` 入口指向 `app.py`。

## 致谢

本次更新由 **Kimi 2.7 Code** 协助完成，包括需求分析、代码实现、调试与文档撰写。