# 文件清理与结构优化说明

清理日期：2026-08-29

本次仅整理当前工作区，没有创建 Git 提交，也没有覆盖清理前已经存在的业务代码修改。

## 清理结果

- 插件文件（不含 `.git`）由约 5.00 MB 降至约 1.86 MB。
- 删除所有 Python 字节码和 `__pycache__`；测试验证后生成的缓存也已再次清除。
- 根目录仅保留插件入口、配置、说明、依赖、更新工具和源码目录。
- 保留 `.git`、`.config`、`cases/` 中的有效案例，以及所有已注册节点和前端运行资源。

## 已删除的临时与工具文件

- 误生成文件：`45deea2`、`=1.2.0`、`screen_capture.png`。
- 本地工具状态：`.agents/`、`.claude/`、`.codex/`、`.playwright-mcp/`。
- 编辑器专用旧配置：`.cursorrules`。
- 无效占位文件：`cases/.gitkeep`。
- 所有 `__pycache__/` 和 `*.pyc`。

## 已删除的历史资料

- `notes/` 中的阶段性重构记录和旧版笔记迁移样本。
- `mockups/note-sidebar-sketch.html`。
- `V3_DEV_GUIDE.py`。
- `SEEDANCE_ELEMENT_QUICKSTART.md`、`SEEDANCE_ELEMENT_README.md`、`SEEDANCE_NEW_FORMAT.md`。

笔记面板仍会使用前端内置样本初始化，并将用户数据保存到 ComfyUI 的 `input/o1key-notes.json`，不再从插件目录迁移旧文件。

## 已删除的死代码

- 旧更新通知链：`utils/update_checker.py`、`version.txt`、`web/js/updateNotifier.js`。
- 已移除颜色去背节点的遗留工具：`utils/color_key.py`。
- 未被活动节点调用的客户端：
  - `clients/base_async_provider.py`
  - `clients/gemini_async_provider.py`
  - `clients/kling_client.py`
  - `clients/openai_client.py`
- 未注册且没有可用入口的节点：`nodes/seedance_firstlast.py`。

相关的包导出、前端工作流线路集合和旧笔记迁移逻辑已同步清理，没有留下悬空引用。

## 测试目录整理

- 将仍有价值的离线测试从根目录移动到 `tests/`。
- 删除带硬编码旧路径或会调用真实接口的手工脚本：
  - `test_autopass_live.py`
  - `test_upload.py`
  - `test_upload_real.py`
- 删除已被新测试覆盖、断言已经过期的 `test_seedance_element.py`。
- 新增 `tests/run_all.py`，让每个测试文件在独立进程中运行，避免 ComfyUI 测试桩污染其他测试模块。

运行全部离线测试：

```powershell
..\..\..\python_embeded\python.exe tests\run_all.py
```

## 代码结构优化

- `clients/__init__.py` 改为延迟导入，加载单个客户端时不再初始化所有模型供应商客户端。
- `utils/__init__.py` 改为延迟导入，减少插件启动期间不必要的图像和文件工具初始化。
- `.gitignore` 增加本地 AI 工具、Playwright、pytest 和覆盖率缓存规则。
- `README.md` 删除对不存在的配置、Mac 更新和编码修复脚本的说明，并改为当前可用的令牌管理界面与 `update.bat` 使用方法。
- 保留 `WEB_DIRECTORY = "./web"`；除确认失效的更新通知脚本外，所有前端扩展继续由 ComfyUI 自动加载。

## 验证结果

- Python 静态编译检查通过。
- 14 个隔离测试文件全部通过，共 107 个 Python 测试用例。
- `test_o1key_image_generator_frontend.mjs` 前端测试通过。
- 使用便携版 ComfyUI Python 成功导入插件。
- 插件成功注册 36 个节点，`WEB_DIRECTORY` 为 `./web`。