# Changelog

All notable changes to Codely Bridge will be documented in this file.

## [1.0.84] - 2026-09-14

### Added

- **Cowork 支持按项目暂停自动资源监听**（`b088ccb`、`b8c203e`、`1940db0`、`2bad5d6`、`73afad0`、`1b27c52`）：
  - 新增内部 `set` / `status` 动作并向所有连接的 Cowork 窗口广播状态；暂停状态保存在 `SessionState`，domain reload 后仍保持，关闭编辑器后恢复默认监听
  - 暂停时仅阻止编辑器聚焦触发的 AutoRefresh，工具主动发起的刷新与导入仍正常执行；恢复时在下一帧统一扫描并导入暂停期间的改动，同时兼容 Unity 6

## [1.0.83] - 2026-09-11

### Fixed

- **Bridge 更新检测改用原生 DLL 哈希，不再误判同版本 UPM 重注册**（`ce21879`、`fdf6a92`、`d9143fc`）：
  - UPM 在安装或移除其它包时会把 Bridge 重新列进 changedTo，此前即使版本与 DLL 均未变化也会卸载 socket 并弹重启提示；现在改为比较原生插件 MD5，字节相同则既不卸载也不提示
  - 首次记录只写入基线，离线替换 DLL 后打开编辑器不再误弹重启提示
  - DLL 哈希计算失败时输出警告日志，不再静默吞掉，便于排查漏检
- **macOS AI Marketplace 无法选择图片**（`d686fcc`）：
  - macOS WKWebView 需要宿主实现 `WKUIDelegate` 才会弹出文件选择框，此前页面上点击 `<input type="file">`（如生成页的“添加参考图”）没有任何反应；Windows WebView2 无此问题
  - 实现原生 `NSOpenPanel` 文件选择，主 frame 与嵌套 iframe 均生效，并同步更新 macOS `WebViewPlugin` 二进制

## [1.0.82] - 2026-09-09

### Added

- **`manage_asset.ensure_prefab_variant` 幂等创建 Prefab Variant**（`4b23d27`、`8067fbc`、`be40a4a`、`f7a6922`、`b41f636`、`3545673`）：
  - 传入 `path` + `sourcePrefab` 创建 Prefab Variant；目标已是同一 source 的 Variant 时直接返回成功（幂等），目标存在但不是 Variant 或基于其它 source 时报错
  - 拒绝 FBX/Model 源并提示先创建普通 Prefab；AssetDatabase 尚未导入 / 刚保存的目标按幂等重试处理，不再误报冲突；保存成功但读取资产信息失败时不误删已生成的 Variant
- **Bridge 包更新后弹窗提示重启团结编辑器**（`9afd0aa`、`1573e8a`）：原生插件与当前编辑器进程绑定，包更新需要完整重启而非 domain reload；更新后弹出 “Codely Bridge Updated” 对话框（Restart Now / Later），Restart Now 重开当前工程；pending 标记存于 SessionState（domain reload 后仍会提示），批量 / 自动化运行不弹窗

### Changed

- **`unity_asset` / `unity_shader` 动作面精简**（`2678ca9`、`1915c41`）：
  - `manage_asset` 移除 `ensure_has_meta`、`ensure_meta_integrity`、`create_folder`、`get_components`：组件列表并入 `get_info` 响应（含 Missing Script 槽位标记）；.meta 确保 / 完整性助手移除（refresh / import 本就会安全重建 .meta）；不再支持显式创建文件夹——`create` / `move` 会自动创建缺失的父目录
  - `manage_shader` 仅保留 `compile` 与 `preview`，移除与场景 / 材质工作流重复的 `detect_render_pipeline`、`ensure_material_shader_for_srp`
- **`manage_editor.refresh` 在 Play 模式下不再报错**（`cf83963`）：刷新前自动退出 Play 模式（Job 新增 ensure-edit-mode 步骤，已处于编辑模式时跳过），替代原先的 `refresh_blocked_in_play_mode` 错误
- **发布渠道切换为 CDN**（`e13099e`、`311e5cf`）：引入 `scripts/release-tools` 发布脚本与 `release_bridge` 手动流水线（打包、上传 TOS、校验 CDN、创建 release tag 并自动开 bump MR）；Packman 发布、兼容性注册与 1.0.0 别名退役

### Fixed

- **Windows 下输出路径含非 ASCII 字符时 MP4 录制失败**（`8faae3c`）：原生 MediaEncoder 在 Dispose 重写时间戳时对非 ASCII 路径报错（WindowsVideoMedia 0x8000ffff “Erase timestamps”）；编码先落到 `%TEMP%` 暂存文件，成功后再移动到目标路径
- **`manage_asset` 路径校验加固**（`5a5faa7`）：路径清洗不再盲信 `Assets/` 前缀，解析后强制结果留在项目 `Assets/` 内，越界直接报错而非探测 / 写到工程外

## [1.0.81-exp.1] - 2026-09-04

### Added

- **Game View 录制改用原生 MediaEncoder，并支持慢动作 encodeFps**（`691799c`）：
  - Windows / macOS 使用 Unity `MediaEncoder` 编码 H.264 MP4，不再依赖外部编码器
  - `start_game_view_recording` 新增 `encodeFps`（默认 2），低于采集 fps 时输出慢动作，方便低采样率模型看全每一帧

### Fixed

- **替换 meta 中的占位 GUID**（`b7a70ba`）：
  - 将 AI 生成的顺序占位 GUID 换成真实唯一值，避免导入时资源引用冲突

### Changed

- **端口注册与 handshake 行为调整**（`893e8f1`）：
  - 端口注册文件改到项目 `Temp/`；native heartbeat 不再写入 `stream_port`
- **更新各平台原生 TCP Bridge**（`893e8f1`、`a35e6d9`、`a2c1c5b`）：
  - 同步最新 Windows `NativeTcpBridge.dll`、macOS `libNativeTcpBridge.dylib`、Linux `libNativeTcpBridge.so`

## [1.0.80] - 2026-09-03

## [1.0.80-exp.1] - 2026-09-02

## [1.0.79-exp.2] - 2026-09-02

### Added

- **刷新资源数据库并返回最新诊断**（`94b2808`）：
  - `manage_editor.refresh` 同步刷新资源数据库，等待导入与编译结束后返回错误、警告和控制台信息；播放或暂停模式下会阻止刷新

## [1.0.79-exp.1] - 2026-08-31

### Added

- **显式 resume 动作**（`0cbeef3`）：
  - `manage_editor` 新增 `resume`，通过 `singleFrame` 选择单帧步进或持续播放；`pause` 支持 `targetPaused` 指定目标暂停状态，不再只能切换

### Changed

- **移除已废弃的 wait_for_upm**（`c8dddd3`）：
  - 删除 `wait_for_upm` 处理与对应 job，未知 action 统一走路由错误；`install_package` / `remove_package` 本身已等待完成
- **更新 Windows 原生 TCP Bridge**（`46040d2`）：
  - 同步最新 Windows `NativeTcpBridge.dll` 预编译产物

## [1.0.78] - 2026-08-28

### Changed

- **废弃 wait_for_bake**（`d0d0628`）：
  - `bake_lighting` / `bake_navmesh` 本身会等到完成，`wait_for_bake` 改为返回 `action_deprecated`，引导改用阻塞烘焙或 `wait_for_idle`
- **废弃 wait_for_upm，并处理传递依赖**（`99451ad`）：
  - `install_package` / `remove_package` 完成后才返回，`wait_for_upm` 改为返回 `action_deprecated`
  - 安装已作为传递依赖存在的包时返回 `already_present`；移除传递依赖时给出可操作错误

## [1.0.78-exp.1] - 2026-08-27

### Fixed

- **域重载期间保留待处理命令**（`8c1b74a`）：
  - 重载时暂停原生命令领取并恢复未完成租约，在新域的命令消费者与弹窗处理准备就绪后继续执行，避免排队命令丢失

## [1.0.77] - 2026-08-27

## [1.0.77-exp.1] - 2026-08-26

### Added

- **按模式拆分脚本执行**（`efe9e12`、`b8ef1c4`、`9071a49`、`8153fa6`）：
  - 新增 `exec_editor_script` / `exec_runtime_script`，由命令名选择编辑器或运行时模式；不再接受 `execution_mode`

### Changed

- **统一 Action 分发**（`e75ddbb`）：
  - 新增 `ActionRouter`，各工具改为字典路由，统一处理别名、默认 action 与未知 action 错误
- **精简 manage_asset**（`38c89de`）：
  - 删除批量资源操作，并重命名 action 别名
- **移除实验性 manage_ui_toolkit**（`c406b6d`、`6966515`）：
  - 先精简为 `ensure_panel_settings_asset`，随后整工具下线
- **Yamato 在 main 推送时跑测试**（`1fa666b`、`60465f9`）：
  - 推送到 main 时同样触发 bridge 测试，覆盖 merge commit 与直接推送

## [1.0.76] - 2026-08-21

### Added

- **Game View MP4 录制与原子化脚本验证**（`23102e7`、`6b3f359`、`ab3ff33`）：
  - 支持分段录制及 `execute_csharp_script.record_game_view`，提供 ffmpeg 编码、录制会话隔离、输出路径约束与生命周期清理
- **有状态 C# REPL 会话**（`18d05f1`、`74e4fcd`、`5654fae`）：
  - 支持跨调用变量、方法与类型复用，新增 `Repl.Id` / `Repl.ById`、`Repl.Vars` 及反射签名查询
- **自定义工具元数据与 Agent 附件**（`d3b9d53`、`bb24b5c`）：
  - 支持查询、刷新自定义工具注册信息，并允许 AgentInputNotifier 携带可选附件
- **Shader 变体编译与预览**（`89a3660`、`85e7c32`）：
  - 新增 `ShaderVariantApi` 与 `manage_shader` 的 `compile` / `preview`，按变体模式预热并渲染预览帧
- **Scene View 多视角截图**（`efb4fb0`）：
  - `capture_scene_view` 支持多方向拍摄；时间戳精确到毫秒，避免连拍文件名冲突
- **编译流水线内嵌控制台**（`6840981`）：
  - `start_compilation_pipeline` 完成后直接返回控制台诊断，无需再单独读取 console

### Changed

- **C# 脚本异步执行与会话安全**（`92d79ad`、`5ffc251`、`ed3b86b`）：
  - 支持 Task / IEnumerator 跨帧完成，REPL 默认改为关闭，并增加超时、取消及域重载操作保护
- **C# 执行结果与控制台输出整理**（`ae08d2f`、`56ca366`）：
  - 统一返回脚本结果并移除控制台消息内嵌堆栈，减少重复输出
- **精简 manage_shader**（`85e7c32`）：
  - 删除 shader CRUD，仅保留 `detect_render_pipeline` / `ensure_material_shader_for_srp` / `compile` / `preview`

### Fixed

- **C# 执行死锁、会话延续与结果格式化**（`c8dde2c`、`c387e95`、`3d73799`、`4198b41`）：
  - 修复阻塞调用、迭代器误判、REPL 自动修复延续及嵌套调用破坏会话状态等问题
- **串流窗口与复合布局恢复**（`d41da2f`、`b740d8f`、`24677d3`、`092fc22`）：
  - 修复遮罩窗口残留或消失，以及应用布局后未激活聚焦复合槽位的问题
- **原生插件平台配置**（`8dc1ff3`）：
  - 修正 Windows、Linux 与 macOS 原生插件的目标平台和 CPU 设置
- **Shader 编译错误过滤与预览防护**（`de261c1`）：
  - 过滤过期 shader 错误，编译/预览前校验，避免损坏变体提交 GPU compiler 导致卡住
- **Scene View 线框渲染**（`efb4fb0`）：
  - 非 Shaded 模式改走 `GL.wireframe`，修复 wireframe / shadedwireframe 被内部相机反射路径忽略的问题

## [1.0.76-exp.1] - 2026-08-18

### Added

- **Game View MP4 录制与原子化脚本验证**（`23102e7`、`6b3f359`、`ab3ff33`）：
  - 支持分段录制及 `execute_csharp_script.record_game_view`，提供 ffmpeg 编码、录制会话隔离、输出路径约束与生命周期清理
- **有状态 C# REPL 会话**（`18d05f1`、`74e4fcd`、`5654fae`）：
  - 支持跨调用变量、方法与类型复用，新增 `Repl.Id` / `Repl.ById`、`Repl.Vars` 及反射签名查询
- **自定义工具元数据与 Agent 附件**（`d3b9d53`、`bb24b5c`）：
  - 支持查询、刷新自定义工具注册信息，并允许 AgentInputNotifier 携带可选附件

### Changed

- **C# 脚本异步执行与会话安全**（`92d79ad`、`5ffc251`、`ed3b86b`）：
  - 支持 Task / IEnumerator 跨帧完成，REPL 默认改为关闭，并增加超时、取消及域重载操作保护
- **C# 执行结果与控制台输出整理**（`ae08d2f`、`56ca366`）：
  - 统一返回脚本结果并移除控制台消息内嵌堆栈，减少重复输出

### Fixed

- **C# 执行死锁、会话延续与结果格式化**（`c8dde2c`、`c387e95`、`3d73799`、`4198b41`）：
  - 修复阻塞调用、迭代器误判、REPL 自动修复延续及嵌套调用破坏会话状态等问题
- **串流窗口与复合布局恢复**（`d41da2f`、`b740d8f`、`24677d3`、`092fc22`）：
  - 修复遮罩窗口残留或消失，以及应用布局后未激活聚焦复合槽位的问题
- **原生插件平台配置**（`8dc1ff3`）：
  - 修正 Windows、Linux 与 macOS 原生插件的目标平台和 CPU 设置

## [1.0.75] - 2026-08-13

## [1.0.75-exp.1] - 2026-08-04

### Added

- **Scene View 所见即所得截图**（`40ae2a3`、`731b1c4`）：
  - 新增 `capture_scene_view`，支持按当前编辑器视角、渲染模式、时间序列及 GIF 捕获 Scene View
- **Yamato 代码覆盖率与发布流程指引**（`8b9eaf2`、`aa0a889`）：
  - 新增 EditMode 覆盖率采集、报告生成与归档任务，并补充 Bridge 发布及版本更新指引

### Changed

- **原生 TCP Bridge 与日志精简**（`969f2d6`）：
  - 更新 Windows、macOS、Linux 原生插件，移除逐命令 verbose 处理日志
- **UPM CI 打包与测试产物调整**（`aa0a889`、`c9aec68`）：
  - 统一传递完整 `upm-ci~` 产物并更新测试命令、产物名称；从 npm 包排除测试配置 meta 与内部发布文件

### Fixed

- **编辑模式 Game View 截图陈旧**（`2713352`、`24c7794`、`cb2ce01`）：
  - 捕获前强制刷新 Game View 与编辑器渲染循环，避免场景或 UI 变化后仍读取缓存帧

## [1.0.74] - 2026-08-01

## [1.0.74-exp.1] - 2026-08-01

### Added

- **编辑器消息注入 Agent 输入框**（`79d38a4`、`3a4ddd5`）：
  - 新增 `AgentInputNotifier`，广播 `input_from_editor` 事件，将编辑器侧消息推入 Agent 输入框
  - Codely 窗口未就绪时自动打开并排队；前端可通过 `manage_editor.drain_agent_input` 在页面加载完成后取队列
- **Yamato Windows 多版本 EditMode 测试与 CI 加固**（`dfd7bd4`、`2e0be74`、`272e8cf`、`6afd6aa`）：
  - 拆分 TUANJIE/UNITY 版本变量，迁移 Windows EditMode 到新镜像与物理机，增加 flaky 重试
  - 恢复 `Tests` 目录并修复 EditMode 失败；补充 `EditorAutomationGuard` meta 与 `TestRunnerOptions.json`

### Changed

- **精简协调面：移除 manage_workflow 与 console token**（`71cbcbf`、`e1f4dfc`）：
  - 删除 `manage_workflow`（保留 stub 指引改用 `manage_editor.start_compilation_pipeline`）
  - 取消增量 console token；`wait_for_idle` 改为等待 JobRegistry 全部完成且非编译/导入
  - `wait_for_compile` / `wait_for_stop` 等返回 `action_deprecated`；错误路径改用 `Response.Error`（`12dcaba`）
- **串流启动时隐藏迷你窗口**（`e2abe93`）

### Fixed

- **复合串流停止后黑屏僵尸窗与编辑器消失**（`762d22a`、`9cf0016`）：
  - 释放时销毁僵尸 HWND，并在 layout/stop 路径关闭空孤儿 ContainerWindow，避免误关主编辑器窗口
- **复合/远程串流纵向抖动与 resize 循环**（`42b9cbd`、`c2ae1f3`）：
  - 复合/远程模式跳过 `DeactivateUnityKeepWindows`（除非任务栏激活），并收紧 reclaim 告警噪音
- **停靠 GameView 压缩串流 UI**（`c04029f`）：
  - 串流前关闭停靠 GameView，每帧强制刷新 PanelSettings，停止后恢复停靠状态
- **GameView 播放区误点 PaneOptions**（`d1484ee`）：
  - Play 模式下跳过游戏区域的 PaneOptions 命中拦截
- **Windows 串流遮罩抢焦点**（`872aff2`）：
  - Windows 推迟显示 streaming mask，直至用户经任务栏激活 Unity
- **Unity 6 兼容与 CI batchmode**（`3357aac`、`4ae138e`、`80480cf`）：
  - 实例 ID 改用 long、修正 `FindObjectsByType` 版本守卫；batchmode 下跳过 Bridge 自动启动
- **Win32 模态对话框扫描器 Mono 委托崩溃**（`3a4ddd5`）：
  - 主线程预创建枚举回调并复用长生命周期委托

## [1.0.73] - 2026-07-28

## [1.0.73-exp.1] - 2026-07-27

### Added

- **模态对话框检测与后台命令泵**（`a095256`、`0daf2b9`）：
  - 新增 `BackgroundCommandPump`，在主线程被原生模态对话框阻塞时仍可处理线程安全命令
  - 新增 `DialogWatcher` / `ModalDialogScanner`（Win32/macOS），检测模态对话框、分离在途 Job，并跨线程点击按钮
  - 新增 `manage_dialog` / `manage_job` 命令，以及 `JobRegistry` / `JobControl` 跟踪 attached/detached Job
- **New Input System 鼠标状态注入**（`206197c`）：
  - 离屏串流场景下通过反射 `QueueStateEvent` 注入 Mouse 位置与按键，修复 InputAction 绑定拖拽/点击失效

### Fixed

- **对话框/Job 后台处理评审修复**（`0daf2b9`）：
  - 原生 dequeue 串行化，避免超时 Stop 后残留 fetch 线程并发出队；仅在 Editor update 心跳停滞时升级扫描到的对话框；修复 DetachedJobs 旧字段加载后立刻过期
- **串流鼠标注入与恢复**（`31441c4`、`5acde62`、`4602051`、`26b445f`）：
  - 修正同批 mousedown/mouseup 的拖拽检测；串流结束后通过 domain reload / LegacyMouseBridge 恢复 InputSystem；恢复 raw input 注册并清理卡住的鼠标按键状态

## [1.0.72] - 2026-07-21

## [1.0.72-exp.1] - 2026-07-21

### Added

- **UI Toolkit 流式指针注入兜底**（`33b5fca`）：
  - 在 UI Toolkit 场景下补齐 streaming pointer injection fallback
- **支持 client DPR 以提升高 DPI 采集清晰度**（`32f786e`）：
  - 根据 client DPR 调整采集逻辑，提升高 DPI 捕获效果

### Changed

- **替换 AsyncOperationTracker 轮询：改为 StepJob 运行到完成**（`191e3f5`）：
  - 用 run-to-completion jobs 驱动流程，降低轮询带来的回归风险
- **简化 UI Toolkit 释放注入**（`4f2dd93`）：
  - 精简 release 注入逻辑，统一 streaming 注入路径
- **停止在每个工具响应中附带环境编辑器状态**（`82b58eb`）：
  - 减少无关状态传输，避免后续解析噪音
- **更新 mac 平台 native 库版本**（`184e95d`）：
  - 将 native lib 更新到 1.0.0 以匹配平台需求

### Fixed

- **修复 StepJob runner 回归并补齐覆盖率**（`7a14764`）：
  - 纠正 runner 行为并新增测试覆盖，避免回归
- **域重载后恢复离屏窗口位置**（`6b595ed`）：
  - 处理 off-screen window positions，在 domain reload 后回到可见状态
- **复合窗口桥接 DPI 缩放修正**（`b564df2`）：
  - 修复 composite window bridge 的 DPI scaling 计算
- **UI Toolkit 流式拖拽增量与兜底修复**（`6de5594`）：
  - 修复 streaming drag delta，并补齐 UI Toolkit fallback
- **修正 Letterboxed 视图下 GameView 输入坐标**（`7684f9b`）：
  - 在 letterboxed 场景下使用正确坐标映射
- **支持 plain VisualElements 上的 Clickable manipulators**（`0ea02d5`）：
  - 让 Clickable manipulators 能在普通 VisualElements 工作
- **修复 unity-script 依赖问题**（`5bb6aec`）：
  - 修复 unity-script 相关依赖，保证脚本可用

## [1.0.71] - 2026-07-17

## [1.0.71-exp.1] - 2026-07-17

### Added

- **Bridge 停止原因上报与无重载包更新后自动重启**（`863ed8d`、`859da3d`）：
  - 贯通 `manually_stopped` / `unity_quit` / `package_updating` / `package_removed` 等停止原因至握手文件；无脚本变更的包更新跳过重载时从 `Events.registeredPackages` 自动重启 Bridge；同步重建各平台 native 插件
- **声明式脚本无顶层语句检测测试**（`c4ce285`）：
  - 新增 `NoTopLevelStatementsTests`，覆盖拒绝路径、合法用例与嵌套语句场景

### Changed

- **Tauri 实例生命周期策略调整**（`c1ca350`）：
  - Unity 不再主动销毁 Tauri 实例，精简 `CodelyWindow` 相关逻辑

### Fixed

- **声明式脚本空跑与编译诊断**（`c4ce285`、`ea13615`）：
  - `execute_csharp_script` 在 emit 前拒绝仅含类型声明的脚本，避免无效果的成功返回；将检测移至编译成功后以返回真实 Roslyn 诊断，并移除易误导的 `SuggestEntryCall`

## [1.0.70-exp.3] - 2026-07-16

### Fixed

- **Unity 2019 原生桥接崩溃修复**（`7df5956`）：
  - 新增 ABI 版本握手与 handle 有效性探测，避免 domain reload 后误用无效句柄或 ABI 不匹配的原生库；同步更新各平台 native 插件
- **复合布局 GameView 鼠标坐标修正**（`c9385ce`、`a46c8cc`）：
  - composite 模式下 rawX/rawY 相对整帧而非 GameView 渲染纹理，导致点击与 uGUI 拖拽注入位置错误；改用 GameView 本地 gameRawX/gameRawY
- **New Input System 按键解析加固**（`d01d4d7`）：
  - `TryParseKey` 改用 `Enum.IsDefined` + `Enum.Parse`，无效键名返回 null 而非默认值

## [1.0.70-exp.2] - 2026-07-16

### Fixed

- **ReadConsole 绕过编辑器 UI 过滤**（`0e365c5`）：
  - 读取控制台时临时绕过 Collapse / Log·Warning·Error 级别开关与搜索过滤，避免被 Console 工具栏隐藏的日志读不到

## [1.0.70-exp.1] - 2026-07-16

### Added

- **编辑器循环 Task/协程 Runner**（`114ba85`、`5ab56bf`）：
  - 新增 `AsyncTaskRunner` / `CoroutineRunner`，支持 `execute_csharp_script` 调度异步 Task 与协程（含 `WaitFor*`），并将 `manage_input` / 截图流程迁至非阻塞 Job 模型
- **New Input System 与 uGUI 拖拽注入**（`f8ca500`、`ba331fa`）：
  - 通过反射 `QueueStateEvent` 注入键盘状态，补齐离屏/串流场景下 New Input System 输入
  - 支持虚拟摇杆等 drag-handler 的 uGUI OnDrag 注入，并抽取 GameView 坐标辅助方法
- **编译进度 DataChannel 转发**（`7783f79`、`4389cb3`）：
  - 将脚本编译进度转发至前端；domain reload 完成后发送 `domain_reload_complete`；Unity 2019 提供 CompilationPipeline 事件回退
- **异步退出 PlayMode 等待**（`b10d8cb`）：
  - 新增 `wait_for_stop`，支持异步等待 PlayMode 退出完成

### Changed

- **心跳写入下沉至原生 TCP Bridge**（`3a38433`、`0c04c2c`）：
  - `.com-unity-codely.json` 心跳改由 native 层维护，移除 `StatusHelper` 并精简 `PortManager`；同步更新各平台 native 库
- **observation-invalidated 归因与节流**（`c42f5f6`、`94b5f04`）：
  - 通知载荷补充 `source` / `pending`；5s 静默窗口内节流合并，避免会话期间通知洪水
- **窗口透明度刷新节流**（`e3d9612`）：
  - `ReapplyWindowTransparency` 限制为最多每 250ms 一次，降低离屏串流帧开销

### Fixed

- **脚本异步失败与协程清理**（`5ab56bf`、`7b738e4`）：
  - Task 失败以 tool error 返回；协程异常/超时处置 enumerator 栈以执行 `finally`；去重 log capture
- **Canvas 布局与输入反射加固**（`ba331fa`）：
  - SetFocus 后恢复 Canvas 渲染尺寸，避免 ScreenSpaceOverlay UI 偏移；加固 Input System 反射缓存与按键解析
- **observation 源归因与脚本拒绝语义**（`94b5f04`、`dbe5937`）：
  - dirty 源在 MarkDirty 时捕获，避免误归因到后续 flush 命令；`execution_mode` 不匹配时返回 Error 而非 Success
- **ReadConsole Unity 6 反射修复**（`38848d2`、`9f47466`）：
  - 修复最新 Unity 6 下控制台日志反射读取失败
- **Drill 窗口交互与完成态**（`59c686d`）：
  - 保持 drill 窗口控件与 completion 响应可用，并修复 cowork 缺失时的回退打开路径
- **EnumWindows 原生崩溃规避**（`208913e`）：
  - 改用 `GetWindow`/`GetDesktopWindow` 遍历 HWND，避免 shell extension 触发 `STATUS_DLL_INIT_FAILED` 原生崩溃

## [1.0.69-exp.1] - 2026-07-09

### Added

- **编辑器测试 CI 覆盖补齐**（`d375edb`）：
  - 新增 bridge EditMode tests 的 Yamato CI 流程，提升回归覆盖
- **Input System 依赖声明补齐**（`fd9b66a`）：
  - package 依赖中新增 Input System，为可选输入能力提供安装基础
- **脚本执行异常可观测性增强**（`ee42f50`）：
  - `CSharpScript.EvaluateAsync` 抛错时返回 stacktrace，便于定位运行期脚本问题

### Changed

- **CI 任务中包拷贝流程优化**（`dcd9b53`、`0255468`、`77e7670`）：
  - 调整 package copy 方式并改用显式 `PACKAGE_NAME`，提升流水线稳定性
- **输入系统集成策略调整**（`2d5f6c0`）：
  - 通过 `CODELY_INPUT_SYSTEM` 编译开关将 Input System 改为可选集成，降低无依赖场景接入成本

### Fixed

- **平台守卫与条件编译修复**（`89bb341`、`ddea6d7`）：
  - 为 `reuseDetachedTarget` 增加平台 guard；修正预处理分支与测试断言，避免跨平台分支误行为
- **Roslyn 引用与测试可见性恢复**（`0a9109a`）：
  - 恢复 Roslyn 引用和 `InternalsVisibleTo`，修复编辑器测试编译/运行失败

## [1.0.68] - 2026-07-09

### Added

- **Unity 6.5（6000.5）兼容性支持**（`ae78b49`、`98fa895`、`699dfc5`）：
  - 引入 EntityId 兼容层（`InstanceIdExtensions`），统一封装 Unity 6.5 中被弃用为错误的 int 实例 ID API（`GetInstanceID`、`InstanceIDToObject`、`Selection.activeInstanceID` 等），全链路改用 64 位 `long` 承载，确保 ID 在存储与传输中无损往返
  - 修复 Unity 6.5 下 bridge 无法安装的问题（AICODE-2127）
- **输入模拟与 GIF 捕获能力增强**（`f1348f6`、`b8f6f51`）：
  - 新增 `manage_input` 桥接命令，支持 PlayMode 下的输入模拟
  - 为 `ManageScreenshot` 新增增量式内存 GIF 捕获 API
- **复合布局重连能力**（`33a5f27`）：
  - 支持在 detached-hidden 重连场景下保留 composite 布局

### Changed

- **Composite 功能模块化与持久化重构**（`51a61ea`、`af73df6`、`f3d2e85`）：
  - 将 composite 相关功能拆分到独立文件，提升可维护性
  - 改进 composite 窗口在 domain reload 后的持久化，并补充 slot 管理的 verbose 日志
- **脚本编译性能优化**（`f3d7dbf`）：
  - `ExecuteCSharpScript` 的阻塞调用扫描复用 Roslyn 编译结果，降低重复编译开销
- **构建与发布流程调整**（`921fd35`、`af1ca8b`、`93b1010`、`58eb69b`）：
  - 非 canary 版本仅允许从 release 分支构建；实验版本仅上传至 TOS；从版本号直接推导 `IS_CANARY_RELEASE`；移除多余调试日志

### Fixed

- **Composite slot 稳定性修复**（`78bc94e`、`4daf696`）：
  - 校验尺寸并延迟 handle 重新获取，加固 composite remap 与 slot handle 重取逻辑
- **拖拽与输入交互修复**（`41c4f8b`、`b19e00b`、`f1bb14b`、`6966ea8`）：
  - 忽略低于阈值的细微拖拽抖动；修正 `manage_input` 的 UI 拖拽目标与协程释放；修复拖拽 popup 阻塞问题；为 Unity 2019 增加版本感知的 tab-drag 守卫
- **截图与离屏窗口修复**（`f59e040`、`0d4d08e`、`8f89316`）：
  - 加固 `ManageScreenshot.CaptureFrame` 的纹理缩放；修复离屏窗口处理的 fallback 与缩进问题；编辑器失焦时支持全速 PlayMode 与 GIF 捕获
- **脚本编译流程修复**（`c8dae67`、`c308966`）：
  - 脚本编译前自动保存 dirty 场景；修复 `RequestScriptCompilation` 重入问题

## [1.0.67] - 2026-07-03

### Added

- **拖拽与场景交互能力增强**（`abe18de`、`af8bfa0`、`dfc44e6`、`6363eac`）：
  - 新增将资源拖拽到场景进行交互的能力，补齐编辑器内拖拽工作流
  - 修复并优化 drag-and-drop 相关链路，提升稳定性与可用性

### Changed

- **原生桥接平台与事件追踪路径重构**（`47c12c0`、`af2aa43`、`6c1f17a`、`2012543`、`2de2568`）：
  - 为 Native Bridge 增加平台抽象层，并移除 Native Window Bridge 的 Linux 平台支持
  - `CodelyEventTracker` 改为以 HTTP invoke 为主，补充 pending metrics 的即时 flush 机制，提升生命周期事件上报可靠性
  - 增加原生日志回调的平台守卫，降低跨平台构建风险
- **截图与异步流程优化**（`e25b143`、`06f1317`）：
  - 优化 `PrintWindow` 捕获流程，引入 viewport cropping 提升截图效率
  - 让异步任务在 reload 后继续可追踪，并在缓存过期场景下自动重试编译

### Fixed

- **复合布局输入稳定性修复**（`1d4bca0`）：
  - 修复 composite layout 下键盘输入处理问题，降低输入丢失与交互异常风险

## [1.0.66] - 2026-06-30

### Added

- **Popup 菜单与标签页交互能力增强**（`d2378a0`、`934d4ff`、`8986725`、`d346e60`）：
  - 新增 `PopupMenu` 能力并重构 `NativeWindowBridgeHost` 相关路径，补齐左键下拉（`DisplayPopupMenu`）与标签页表头菜单触发链路
  - 新增标签页表头 context menu 能力与 composite 自动恢复机制，完善串流场景下标签页操作
  - 新增 `ProjectBrowser` 过滤器场景下的 `PopupList` 支持，覆盖更多编辑器原生弹出菜单类型
- **GUID 修复脚本与校验流程增强**（`99df5b2`、`99b8ba9`）：
  - 新增用于修复无效 Unity `.meta` GUID 的脚本
  - 改进 GUID 校验 hook 与脚本交互体验，降低 `.meta` GUID 异常导致的导入问题

### Changed

- **上下文菜单与指针事件路径优化**（`b604490`、`c139b04`）：
  - 优化上下文菜单日志与关闭（dismissal）流程，减少噪声并提升可观测性
  - 优化指针事件处理与 tooltip 开销，降低高频交互路径的性能负担
- **开发流程文档与仓库整洁度更新**（`3287efa`、`e70351b`）：
  - 新增 Git hooks 配置文档

### Fixed

- **弹窗定位与命中检测修复**（`2a78541`、`91ace8d`、`9094bf0`、`8664761`）：
  - 统一 composite 视图下的 popup 定位计算逻辑，修复弹窗位置偏移问题
  - 提升 PaneOptions 按钮 hit-test 精度，减少误判与误触发
  - 修复上下文菜单处理与原生 popup 关闭流程的稳定性问题

## [1.0.65] - 2026-06-29

### Added

- **TextMeshPro Essentials 自动导入**（`181108d`、`96c1627`、`07c7e49`）：
  - 新增 `TmpEssentialsAutoImporter`，在工具触发安装 `com.unity.textmeshpro` 后静默执行 `Window/TextMeshPro/Import TMP Essential Resources`，避免首次使用 TMP 时缺少 Essentials 资源
  - `execute_csharp_script` 在脚本包含 `TextMeshProUGUI` 时自动补齐 TMP Essentials；`manage_editor` 编译前检查也会识别 TMP UI 依赖并触发导入
  - `execute_menu_item` 执行 TMP Essentials 菜单项后同步调用导入流程，并通过 `Response.SuccessWithData` 返回更结构化的成功数据

### Changed

- **遥测事件追踪增强**（`0ee3c00`、`6d29f7e`、`1644599`）：
  - 重构 `CodelyEventTracker` 与 IPC 消息处理，将欢迎页 / 面板生命周期事件统一到事件追踪入口
  - `codely_panel_opened` / `codely_panel_closed` 等面板事件接入生命周期追踪，并对需要用户标识的事件补充 user ID
  - `CodelyIpcManager` 补充连接状态回调，使事件在 IPC 连接变化时能更可靠地投递

## [1.0.64] - 2026-06-25

### Added

- **`manage_gameview` 工具 + 场景视图渲染模式 + GIF 截图**（`191c384`、`0240e83`）：
  - 新增 `manage_gameview` 工具，支持获取 / 设置 / 列举 Game View 分辨率；接入 `CommandRegistry` 与 `UnityTcpBridge`，并在 `StateDirtyPolicy` 中标记为非 dirty 动作，避免产生多余的 observation-invalidated 通知
  - `ManageScreenshot.capture_scene_view` 新增 `render_mode`（`shaded` / `wireframe` / `shadedwireframe`）；`shadedwireframe` 将 shaded pass 与双背景 wireframe 蒙版合成，做到与渲染管线无关
  - `capture_game_view` 新增 `scale` 参数（0.25–1.0，默认 0.5）
  - 新增 `as_gif`：录制 N 帧并编码为动画 GIF（`frameCount` / `fps` / `colorCount` / `startDelay`），覆盖 `game_view` / `scene_view` / `main_camera` / `specific_camera`；内置自包含的 median-cut + LZW GIF89a 编码器，逐帧延迟按实际抓帧间隔测量
  - `DrawLabelOnTexture` 将标签高度限制在图像高度的 1/5 并按宽度自适应
- **遥测事件追踪（经 IPC 上报 Tauri 后端）**（`d1c17ea`）：新增 `CodelyEventTracker`，从 Unity Bridge 经 IPC `trackEvent` 消息向 Tauri cowork APP 上报 6 个分析事件——`welcome_window_shown` / `welcome_window_closed`（`DrillWindow` OnEnable / OnDestroy）、`welcome_button_clicked`（`OnDrillCompleted`）、`codely_panel_opened`（`CodelyWindow` OnEnable）、`codely_panel_closed`（OnDisable，置于 IPC release 之前以保证可投递）、`codely_panel_input_submitted`（Tauri 侧经 `llm/streamChat` 处理）
  - `CodelyIpcManager` 缓冲 IPC 连接建立前发送的消息并在连接后 flush，避免事件静默丢失
  - `CodelyIpcServer` 的 `IpcMessageType` 新增 `TrackEvent`；`TauriUtils.GetEditorType()` 增强 tuanjie 检测（回退到 `m_EditorVersion` 的 `t` 后缀判断）
- **串流标签页 "more options" 弹出菜单**（`2a7566d`、`e0bcf09`）：新增 `NativeWindowBridgeHost.PaneOptions.cs`，为合成 / 串流模式下的 `DockArea` 标签页提供窗口选项（kebab / more action）按钮的弹出菜单提取与回调处理，使串流前端能正确触发标签页的更多操作
- **串流图标选择器（icon picker）**（`8a9dc08`、`2821905`）：新增 `NativeWindowBridgeHost.IconSelector.cs`，为串流场景提供简易的图标选择弹窗支持；并修复其在 Unity 2019 上的编译错误
- **合成模式新弹窗自动停靠到 DockArea**（`a593f90`）：增强多窗口合成（composite）串流——合成开始后自动检测并停靠新出现的 `EditorWindow`，覆盖经菜单项创建与右键 `Add Tab` 创建的窗口，确保它们被纳入合成串流捕获
  - 新增 `NativeWindowBridgeHost.PopupDock.cs`：`InterceptAndDockNewPopupWindows`（自动停靠新弹窗）、`TrackUntrackedCompositePanes`（检测原生新增标签页）、`InitCompositeWindowTracking`（快照基线窗口 ID 集合）
  - 基于反射的标签页移动，并对 Windows / macOS 分别处理；将弹窗检测与 `Add Tab` 右键菜单检测集成进 `ManageWindowBridge` 工作流

### Changed

- **更新 Windows 原生二进制**（`3acfb27`）：更新 `Plugins/Win` 下的 `NativeWindowBridge.dll` 与 `datachannel.dll` 至最新构建
- **新增脚本后编译前先 `AssetDatabase.Refresh()`**（`2660b00`）：经 `write_file` 或外部工具新建的脚本在触发编译前先执行 `AssetDatabase.Refresh()` 导入，确保新增脚本被纳入本次编译（`CompilationHelper`、`ManageEditor`）
- **暂时禁用 `SceneHierarchyNotifier` 与 `ConsoleLogChangedNotifier`**（`1f73a84`）：关闭这两个推送通知器

### Fixed

- **AICODE-1977 `execute_csharp_script` 非 UTF-8 脚本编码乱码**（`f723f56`）：修复脚本文件以本地 ANSI 代码页（如 zh-CN Windows 的 GBK/936）保存时，`File.ReadAllText` 默认按 UTF-8 解码导致中文标识符 / 字符串变成 '�' 并触发 Roslyn `CS1056` 的问题——新增 `ReadScriptFileSmart` 编码自动探测：优先识别 BOM（UTF-8 / UTF-16 LE / BE），无 BOM 时手动校验字节是否为合法 UTF-8（Mono 的 `UTF8Encoding.throwOnInvalidBytes` 不可靠，会静默替换为 '�' 而不抛异常），否则按结构校验回退到 GBK/936，再不行才用系统默认页并大声告警；脚本路径含 `U+FFFD` 时给出明确的"路径已在 TCP 层被非 UTF-8 解码、原始字节不可恢复"诊断提示，替代含糊的 not-found
- **`manage_gameobject` find 对缺失脚本组件抛 NRE**（`e60a32c`）：含缺失 / 损坏脚本引用（脚本被重命名 / 删除、编译错误、或非 UTF-8 脚本导入失败）的 GameObject，其 `GetComponents<Component>()` 会返回 null 项；`find` 动作序列化时在 `GetGameObjectData` 的 `componentNames` 中解引用这些 null，抛出以 "Internal error processing action 'find'" 暴露的 `NullReferenceException`，现已加 null 防护（`GameObjectSerializer`、`ManageGameObject`）

### Removed

- **移除 WebRTC 串流功能**（`1194445`）：移除基于 Unity RenderStreaming 包的 WebRTC 串流特性（已弃用），简化代码并减少依赖——删除 `ManageWebRtcStream` 工具及其 `.meta`、从 `CommandRegistry` 移除 `manage_webrtc_stream` 命令、从 `UnityTcpBridge` 移除 WebRTC 命令路由、从 `CodelyIpcServer` 移除 WebRTC IPC 消息类型与处理器；同步更新原生 `NativeWindowBridge.dll` / `datachannel.dll`

## [1.0.63] - 2026-06-22

### Added

- **合成窗口选择变更同步与 domain reload 句柄重获**（`f289ec5`）：大幅增强多窗口合成（composite）串流的捕获与状态同步
  - 新增选择变更监听与通知机制，selection 改变时主动驱动合成槽位重绘并向前端同步状态，确保 Inspector 等随选择刷新的窗口在串流端及时更新
  - domain reload 后重新获取各合成槽位（composite slot）的原生窗口句柄，避免脚本重编译后句柄失效导致黑帧 / 不刷新
  - 新增 `ForceRepaintImmediately`，对离屏窗口执行同步立即重绘，消除合成更新延迟
  - 新增 `NativeWindowBridgeHost.Json.cs` 共享 JSON 解析工具，捕获操作后恢复 GL 矩阵（避免抓帧改写渲染状态），并将 `EditorWindowNativeHandleHelper` 改为 `public` 以供合成槽位访问
  - 改进 `PrintWindow` 抓帧的 DPI 缩放与日志
- **串流标签页拖出自动重路由为 AddTab**（`54198be`）：新增 `NativeWindowBridgeHost.TabDrag.cs`，修复串流（合成 / 离屏）模式下把 Editor 标签页拖出停靠区时的问题——在串流画布中央释放标签页时 Unity 会新建一个无法被串流的浮动 `ContainerWindow`（`DropInfo.dropArea == null`）；改为经反射检测该情形并将拖放重路由为对光标下 `DockArea` 的 `AddTab`（从原 DockArea `RemoveTab` 后按末尾索引插入并选中、关闭残留的 `PaneDragTab`、复位拖拽状态与 `hotControl` 并重绘相关窗口）；落在停靠边缘 / 既有面板（`dropArea` 非空）的拖放仍走 Unity 原生 `SendEvent` 流程

### Changed

- **`ExecuteCSharpScript` 错误路径改为返回成功响应**（`0a2e598`）：`script` 参数缺失、脚本文件不存在 / 为空 / 读取失败 / 访问被拒，以及脚本执行抛异常等原先返回 `Response.Error` 的分支，统一改为返回 `Response.Success` 并仅携带提示文本；执行异常分支不再附带 `logs` 与 `exception` 详情

### Fixed

- **AICODE-1952 编辑器内嵌 cowork 卡 Loading**（`f9b792f`）：修复 macOS 内嵌 WebView（WKWebView）在 Tauri 后端尚未就绪 / 被重启替换时停在白屏的问题
  - 新增 `/api/tauri/status` HTTP 就绪门控（`_serverHttpReady`）：`_tauriServerPort` 在选定端口时即被赋值（远早于 Tauri 进程实际 bind），仅凭 `port > 0` 就导航会与服务端竞速并永久停在 connection-refused 白屏（WKWebView 不会自动重试失败的导航）；改为经后台轮询 `ProbeServerReadyAsync` 确认状态接口应答后再创建 / 重载 WebView
  - 后端被重启或重新 attach（经 project lock 或新启进程）时，从序列化句柄恢复的 WebView 绑定的是已失效 / 被替换的后端，页面停在白屏且 SPA 不再重跑加载握手；新增 `_pendingWebViewReloadAfterRelaunch`，在新服务 HTTP 就绪后重载内嵌 WebView 以重新 bootstrap UI（新服务可能复用同一端口，故经 `ResetServerReadyGate` 显式失效旧的就绪状态）
- **合成 GameView 在 Play 模式下水平压缩**（`6dccde1`、`75e1155`）：修复 Play 模式下合成 GameView 槽位（尤其鼠标点击后）出现水平压缩的渲染瑕疵——根因是 focus 事件期间 `Camera.aspect` 被破坏，以及 `PlayModeView` 优先级不当导致取到陈旧 render texture
  - 在 `SetFocus` 等原生 focus 事件后恢复相机 aspect，单窗口与合成两种模式均恢复宽高比
  - 合成已激活时不再重置帧计数，避免 warm-up 抢焦点；新增 Play 模式初始化检测与正确的 GameView 聚焦处理
  - 点击后强制连续 3 帧同步重绘以消除 backbuffer 延迟；合成模式下跳过原生鼠标按键消息以免扰动 backbuffer
  - 随后（`75e1155`）清理用于排查压缩 / 渲染问题的诊断日志与未使用的反射辅助方法（`GetGameViewDiagState`、`GetGameViewRenderTextureDiag`、`GameViewRenderTextureFieldResolved`、`WM_MOUSEMOVE` 常量），focus 操作日志降为 verbose，保留必要日志
- **`CompilationHelper` 编译错误 / 警告计数反射签名错误**（`f289ec5`）：内部 `LogEntries.GetCountsByType` 实际签名为 `(ref int errorCount, ref int warningCount, ref int logCount)` 三个 `ref int` 参数，而非单个 `int[3]` 数组；原代码传入数组无法被正确回填，导致错误 / 警告计数失效，进而影响编译自动修复判定。改为传入 `object[] { 0, 0, 0 }` 并在反射调用后回读 `args[0]` / `args[1]`
- **Unity 2019 标签页拖拽崩溃**（`f289ec5`）：跟踪标签栏鼠标位置以避免 Unity 2019 上 `DragTab` 崩溃，并为布局变化的标签页拖出检测增加跳帧处理

## [1.0.62] - 2026-06-18

### Fixed

- **Unity 2019 下串流光标相关代码编译错误**（`bae7482`）：修复串流光标 / 弹窗支持在 Unity 2019 上的编译错误（`NativeWindowBridgeHost.Cursor.cs`、`NativeWindowBridgeHost.AddComponent.cs`、`NativeWindowBridgeHost.ObjectSelector.cs`），并补齐相应 `.meta` 文件

## [1.0.61] - 2026-06-18

### Added

- **串流弹窗（popup）支持**（`4488ced`）：新增对 Editor 弹出式 UI 的串流支持，覆盖 `AddComponent`（`NativeWindowBridgeHost.AddComponent.cs`）、`AdvancedDropdown`（`NativeWindowBridgeHost.AdvancedDropdownPopup.cs`）与对象选择器 `ObjectSelector`（`NativeWindowBridgeHost.ObjectSelector.cs`），使这些原生弹窗能在远程串流场景下正确呈现与交互
- **串流光标样式支持**（`0ef377c`、`91c1193`）：新增 `NativeWindowBridgeHost.Cursor.cs`，将 Unity 编辑器光标样式同步到串流前端；并修复串流光标的相关问题
- **Canary（beta）通道版本注册**（`3c81426`）：`scripts/register-version.js` 与 `.gitlab-ci.yml` 增加将包注册到 canary（beta）通道的能力，便于灰度发布
- **Unity 2019 菜单 fallback 与 ConnectionTreeView 弹窗支持**（`876a399`）：在 `Menu.GetMenuItems` 不可用时，经反射使用 `Unsupported.GetSubmenus` / `GetSubmenusCommands` 提取菜单（`EnsureUnsupportedMenuReflection`、`SendDelayedPopupViaSubmenus`），兼容 Unity 2019；并新增对 `ConnectionTreeViewWindow`（Console / Profiler 连接目标选择器）弹出菜单的提取与回调处理，缓存原始弹窗索引以将前端选择映射回原生索引

### Changed

- **提取离屏 sentinel 处理逻辑为辅助方法**（`35be89d`）：将分散的离屏哨兵坐标（off-screen sentinel）判断与修复代码抽取为 `IsAtOffscreenSentinel` 与 `RepairOffscreenSentinel` 辅助方法，移除 `RestoreAllWindows` 中冗余的兜底代码并统一 POST-STOP 自动修复逻辑，降低重复、提升可维护性

### Fixed

- **窗口恢复后卡在离屏哨兵位置**（`e837798`）：修复 Unity 窗口在恢复后可能滞留在离屏哨兵坐标 `(-32000, -32000)` 而彻底消失的严重问题——当累积的恢复失败（尤其窗口因上次停止失败已处于哨兵位置）阻止其回到屏幕内时，新增安全兜底：保存时若窗口已在哨兵位置则赋予默认屏幕内坐标、主恢复后用兜底循环强制移回卡住的窗口、并在停止后校验中分离样式与坐标检查、补充恢复坐标的详细日志
- **Unity 2019 Gamma 色彩空间下截图黑屏**（`c9261b2`）：修复 Unity 2019 + Gamma 色彩空间下抓帧黑屏——`Present` 后 SwapChain 后台缓冲为空导致 `GrabPixels` 取到黑色像素；新增 `PrintWindow` fallback（`s_UseRenderTextureFallback`），经 DWM 合成抓取窗口内容，并在该模式下用 `HWND_BOTTOM` 定位以维持 DWM 合成
- **`ExecuteCSharpScript` 在 `Codely.Utility` 包出现时未更新引用**（`51fe455`）：修复 Codely.Utility 包后续加入时 `ExecuteCSharpScript` 未刷新程序集引用的问题

## [1.0.60] - 2026-06-15

### Fixed

- **AICODE-1862 Windows Unity6 内嵌 Tuanjie AI 卡 Loading**（`b6ca840`、`a168a99`）：重写 `NativeWindowHelper.GetHWND`，使其能在多显示器 / 多 DPI 缩放环境下可靠定位 Unity `EditorWindow` 背后的 Win32 HWND；此前纯绝对坐标匹配仅在主显示器有效，副屏上永远匹配不到导致内嵌面板一直卡在 "Loading"
  - 新增策略 1（首选）：经反射读取宿主 GUIView 的内部 `nativeHandle`（`EditorWindowNativeHandleHelper`），并校验其为本进程的 `UnityGUIViewWndClass` 窗口后直接使用，与坐标 / DPI 无关；Unity 构建缺少该属性或返回非 HWND 指针时安全降级到坐标搜索
  - 当反射得到的是本进程其他类窗口（如 ContainerWindow）时，将搜索范围收窄到该顶层窗口；其唯一 GUIView 子窗口直接采纳（浮动面板常见情形）
  - 坐标搜索对每个候选窗口在多种坐标假设下测试包含关系：(a) 旧逻辑物理像素 × `pixelsPerPoint`、(b) 候选物理矩形 ÷ 自身 `GetDpiForWindow` 缩放后按点比较、(d) 保留显示器物理原点的 monitor-anchored 映射、(c) container-relative 相对偏移比较（相对偏移不跨显示器，在任意 per-monitor 映射下都成立）；取最小匹配候选
  - 全部失败时按节流输出每个候选窗口的诊断转储，便于现场定位实际坐标映射
- **AICODE-1768 `ensure_scene_saved` 对未命名场景会弹出文件系统对话框卡住 yolo 模式**（`add76ed`）：未命名（untitled）场景没有路径，`SaveScene` 会弹出阻塞编辑器线程的原生 "Save Scene" 对话框使自动化 / yolo 模式卡死；改为在 `path` 为空时快速失败并提示先用 `save` 动作指定 `name` 与 `path`，而非触发对话框
- **退出编辑器时停止 WebRTC 服务以防卡死**（`9c27eae`）：WebRTC 串流激活时关闭 Unity 编辑器会卡死——libdatachannel 的原生线程在 DLL 卸载后仍存活，Mono 线程管理器无法中止它们；在原生 DLL 卸载前于 `OnEditorQuitting` 调用 `NativeWindowBridgeHost.StopServer()`，先销毁 `PeerConnection`（其析构会 join libdatachannel 内部处理线程），`StopServer` 已在带超时的后台线程执行 `NWB_StopServer` 故不阻塞主线程
- **合成模式下 IMGUI 浮层交互改进**（`b6a6f2d`）：修复合成窗口模式下 IMGUI 浮层（如 SceneView 的 OrientationGizmo）无法正确接收鼠标事件的问题——为合成模式增加标签页切换以将事件派发到正确浮层、在 Layout 事件中传入真实鼠标位置以便浮层控件注册、经 `hotControl` 变化检测并跟踪浮层是否消费了 MouseDown（消费时跳过 picking 命令注入以免抢占交互）、在 domain reload 与工作区清理时重置浮层状态、并抑制弹出菜单移除期间的 Unity 内部报错

## [1.0.59] - 2026-06-12

### Added

- **合成窗口关闭标签页（Close Tab）检测与通知**（`6f2fd0b`）：`NativeWindowBridgeHost` 在执行 `Close Tab` 菜单动作前先快照该合成窗口涉及的窗口类型，关闭后检测被移除的合成槽位（composite slot），并经 DataChannel 主动通知前端，使前端能及时同步窗口状态

### Changed

- **限制 ContextClick 合成范围到标签页表头**（`6f2fd0b`）：合成的 `ContextClick` 事件仅在 `DockArea` 标签页表头区域内触发，避免误伤 Game 输入与 Scene 导航等其他区域的交互
- **原生状态跨 domain reload 保活**（`b2c5287`）：重构 assembly reload 处理，使原生 C++ 单例（HTTP 服务、WebRTC 会话、离屏渲染）在 domain reload 期间保持存活，消除端口重新绑定、避免 WebRTC 断连、并规避在主线程调用 `Stop()` 可能导致的死锁；reload 期间仅清理 C# 侧状态并将日志回调置空以防悬空委托调用，reload 后重新注册日志回调恢复日志
  - `OnBeforeAssemblyReload` 移除 `NWB_StopServer` / `NWB_StopCapture` 调用，reload 前先关闭浮动捕获窗口以避免遗留孤窗
  - 更新 Windows 原生二进制 `NativeWindowBridge.dll`、`datachannel.dll`
- **UI Toolkit 截图样式微调**（`7dc9dad`）：`ManageUIToolkit` 为根视觉元素增加背景色与居中对齐，放大标题字号并调整标题 Label 样式，改善视觉呈现

### Fixed

- **沙箱 iframe 下双击检测不可靠**（`857a7a2`）：在沙箱 iframe 或 `setPointerCapture` 重置浏览器内部计数器导致 `e.detail` 始终为 1 的场景下，原先仅依赖前端 `clickCount` 的判断会漏检双击；改为始终在 C# 侧运行计时 / 位置跟踪，并与前端值取 `MAX` 组合判定，提升双击检测稳健性；新增双击检测的 verbose 调试日志

## [1.0.57] - 2026-06-09
### Fixed
- Fix unity 2019 编译错误

## [1.0.56] - 2026-06-05

### Added

- **多窗口串流支持**（`0952ec1`）：`NativeWindowBridgeHost` 大幅扩展（约 +1000 行），支持同时串流多个 Editor 窗口；新增 `NWB_GetPendingCompositeRequest` P/Invoke，拉取待处理的合成（composite）串流请求并回传 fps / width / height；同步更新 Windows 原生二进制 `NativeWindowBridge.dll`、`datachannel.dll`、`libcrypto-3-x64.dll`、`libssl-3-x64.dll`
- **平台相关窗口句柄检测以支持键盘注入**（`3acdaa2`）：`NativeWindowBridgeHost` 在 `Show()` 后通过 before/after diff 捕获新建的原生窗口句柄——Windows 记录 `ContainerHwnd` / `GUIViewHwnd`，macOS 记录 `NSWindow` 指针——供 Play 模式键盘焦点操作使用（Windows `SetFocus` / `PostMessageW`，macOS `activateIgnoringOtherApps` / `makeKeyWindow`），确保串流交互时 `Input.GetKey` 正常工作；新增 `Menu.GetMenuItems` 反射缓存
- **GameView Play 模式鼠标处理与远程串流增强**（`74ac304`）：针对物理鼠标位于另一台机器的远程串流场景，全面改进 Play 模式 GameView 的鼠标事件处理，覆盖 uGUI 交互、Input Manager 集成与 cursor lock，跨 Windows / macOS
  - 新增 uGUI EventSystem 直接注入，绕过离屏 GameView 下 `StandaloneInputModule` 的限制，保证 UI 点击可靠
  - 经前端专用 `mousedelta` 消息注入远程鼠标增量，并新增 `connection_info` 消息区分远程 / 本地串流
  - Windows 经原生 Win32 鼠标按键注入支持 `Input.GetMouseButton`；macOS 经 CGEvent 鼠标注入支持 cursor-locked 模式下的 `Input.GetAxisRaw`
  - 新增 `BrowserBtnToUnityBtn` 按键映射、按住鼠标按键跟踪与断开时清理、`QueuePlayModeMouseEvent` 精确坐标排队、新连接建立时重发 cursor lock 状态
  - 更新 macOS 原生二进制 `libNativeWindowBridge.dylib` / `libdatachannel.dylib`

### Changed

- **Play 模式跳过窗口去激活并统一日志**（`74ac304`）：Play 模式下不再执行窗口去激活，以维持 Input Manager 焦点；相关 `Debug.Log` 调用统一改走 `CodelyLogger`
- **关闭原生窗口桥接的冗余日志**（`361e8a0`）：默认关闭 `NativeWindowBridgeHost` 的 verbose 日志输出

### Fixed

- **AICODE-1636 Bridge 状态没有实时切换**（`53f44f6`）：`NativeDllLoader` 的包变更回调原先仅处理 `args.changedTo`（更新场景），而卸载只出现在 `args.removed` 中而被忽略，导致卸载后原生 socket 仍保持打开、客户端永远收不到断开通知；新增对 `args.removed` 的处理，卸载时同步调用 `Unload()`
- **macOS 暂时禁用串流并改进平台检测**（`4ce6311`）：`IsStreamingSupportedOnCurrentPlatform` 在 macOS 改回返回 `false`，避免 macOS 用户使用尚未完善的串流功能；`GetStreamServerStatus` 新增平台检测，响应新增 `platformSupported` 与 `platform`（windows / macos / linux）字段，平台不支持时 `running` / `port` / `streamStatus` 返回空值

### Removed

- **移除 verbose 日志切换菜单项**（`f015771`）：删除 `Window/Codely/Toggle Verbose Log` 菜单项及 `ToggleVerboseLog()` 方法与关联的 verbose log 状态，简化界面

## [1.0.55] - 2026-06-03

### Added

- **`manage_window_bridge` / `manage_webrtc_stream` 标记为只读动作类别**（`fe6691f`）：在 `StateDirtyPolicy` 中将这两类工具注册为额外的只读（readonly）动作类别——`manage_window_bridge` 9 个动作、`manage_webrtc_stream` 5 个动作——使窗口管理与 WebRTC 串流操作不再触发多余的 dirty state delta，符合其本质上不改变工程状态的语义；新增对应单元测试

### Changed

- **集中式日志系统 CodelyLogger**（AICODE-1703）：新增 `Editor/Logging/CodelyLogger.cs`（独立 `Codely.Logging.asmdef`），作为全包唯一允许直接调用 `UnityEngine.Debug` 的入口，统一品牌前缀（`Codely Bridge`）并支持全局开关；移除旧的 `TcpLog`，56 个文件的日志调用统一改走 `CodelyLogger`
  - 经菜单 `AI/Logging/Enable Codely Logs` / `AI/Logging/Enable Verbose Logs` 或 `CodelyLogger.Enabled` 切换；Verbose 复用既有 `UnityTcp.DebugLogs` 偏好键以保持向后兼容
  - 开关值持久化（`EditorPrefs`）并缓存到 volatile 字段，使后台线程（IPC 循环、ThreadPool 回调）与 domain reload 期间的 `[InitializeOnLoad]` 静态构造函数也能安全读取——首次主线程访问时惰性加载，避免 off-thread 读 `EditorPrefs` 抛异常
- **公共接口统一加 Codely 命名空间前缀**（`23e97d4`）：将所有对外公开的类型前缀化到 `Codely` 命名空间，避免与宿主工程 / 其他包的类型名冲突（主要涉及 ScriptFix 系列与 `ExecuteCSharpScript` / `ManageScript`）；同步更新 `Codely.Roslyn.dll` 与 README
- **更新 macOS 原生桥接二进制**（`b8ffd44`）：更新 `libNativeTcpBridge.dylib`、`libNativeWindowBridge.dylib`、`libdatachannel.dylib` 至最新版本，纳入原生侧 bug 修复与性能改进

### Fixed

- **AICODE-1655 bridge 依赖冲突**：将分散的 Roslyn / `Microsoft.CodeAnalysis.*` / `System.*` 托管 DLL 合并打包为单个 `Codely.Roslyn.dll`，删除 `Microsoft.Bcl.*`、`Microsoft.CodeAnalysis.*`、`System.Buffers/Memory/Collections.Immutable/Reflection.Metadata/...` 等独立 DLL，避免与宿主工程或其他包携带的同名程序集冲突
- **AICODE-1416 内嵌模式下 Ctrl+L 快捷键会关闭 Codely**：标签页重新可见时（已初始化的 WebView）新增 `FocusEmbeddedInputOnBecameVisible`，延迟一帧把原生焦点显式送入内嵌内容（macOS `_webViewBridge.Focus()` / Windows `_webView2Host.MoveFocus()`），使页面输入框直接获得光标，不再因焦点停留在 Unity 侧而让 Ctrl+L 等快捷键命中编辑器并关闭 Codely
- **AICODE-1618 右键菜单 AI → Add to context 逻辑问题**：`Add to context` 不再强制打开 CodelyWindow；当无窗口打开导致共享 IPC 客户端未启动时，经新增的独立 IPC owner（`CodelyWindow:StaticContextSender`）启动客户端把排队的 context items 投递出去，投递完成后释放该 owner，使无窗口存活时共享客户端能正常停止
- **Windows domain reload 后窗口透明度恢复**（`cc6de44`）：修复 domain reload 清空静态状态但原生 HWND 仍保留被改样式 / 位置，导致窗口不可见或卡在屏幕外的问题——保存原始样式前先剥离 `WS_EX_TRANSPARENT`、跳过保存屏幕外哨兵位置、恢复可见时始终剥离 `WS_EX_TRANSPARENT`，并新增 `ShowWindow`（`SW_SHOWNOACTIVATE`）回退与停止后验证阶段的自动修复兜底

## [1.0.54] - 2026-05-28

### Fixed

- **macOS 串流 DPI 缩放错误**（`52b6148`）：`NativeWindowBridgeHost.DPIScale` 的预处理守卫由 `UNITY_EDITOR_WIN` 扩展为 `UNITY_EDITOR_WIN || UNITY_EDITOR_OSX`，使 macOS 也按 `EditorGUIUtility.pixelsPerPoint` 计算缩放，修复 Retina / HiDPI 显示器下 macOS 串流帧尺寸缩放错误的问题
- **串流期间 macOS Dock 图标处理**（`591c403`）：移除离屏 / Play 模式串流期间将 NSApp 切到 `Accessory` 激活策略（隐藏 Dock 图标）的逻辑，串流期间保留 Tuanjie / Unity 编辑器的 Dock 图标常驻；恢复可见时改为在 `activate` 前先 `unhide` 并设回 `Regular` 策略，避免遗留的 `hide:` / `Accessory` 状态导致编辑器窗口不可见

## [1.0.53] - 2026-05-27

### Added

- **`unity_menu` 的 `get_available_menus` 正式实现**（AICODE-1272）：原先返回空列表的占位实现改为真正枚举 Editor 菜单项
  - 主路径经反射调用内部 `UnityEditor.Menu.GetMenuItems(string, bool, bool)`，同时覆盖原生（C++ 定义）与脚本定义菜单项；该 API 在当前 Unity 版本不可用时回退到通过 `TypeCache` 扫描 `[MenuItem]` 特性方法
  - 内置顶层菜单（`File`/`Edit`/`Assets`/`GameObject`/`Component`/`Window`/`Help`/`Tools`/`Mobile`）作为基线种子，自定义顶层菜单（如 `AI`）动态补充
  - 支持可选参数：`menu_path`/`menuPath`（限定子树）、`filter`/`search`（大小写不敏感子串匹配）、`include_separators`/`includeSeparators`（默认 `false`）
  - 修复（`e1cdce7`）：`TypeCache` 结果改为无条件并入同一集合（去重），即使反射 API 仅返回部分子树或不可用，脚本定义菜单项也始终存在；`path` `PropertyInfo` 改为按条目运行时类型缓存（`_pathPropByType`），并新增快捷键尾串正则 `_shortcutTailPattern` 以正确剥离菜单热键标记
- **Device Simulator / HMI Simulator 截图支持**（AICODE-1533）：`ManageScreenshot.CaptureGameViewTexture` 不再只抓 Game View，而是枚举所有 `PlayModeView` 派生窗口（Game View、Device Simulator、HMI Simulator…）并逐一探测，返回首个非黑帧
  - 按基类名 `PlayModeView` 识别窗口（而非按已解析 `Type`），解决 Simulator 位于独立模块程序集（`UnityEditor.DeviceSimulatorModule` / `HMISimulatorModule`）导致 `Type.GetType(...,UnityEditor)` 返回 `null` 而被跳过的原 bug
  - 探测顺序：聚焦窗口优先，其次 Simulator，最后 Game View，使活跃的模拟帧优先于陈旧的 Game View RT；新增 `IsTextureBlack` 中心采样判黑，黑帧让位于下一来源，全黑时仍返回首帧
  - `GetGameViewRT` 沿类型层级遍历读取 RT 字段（`m_RenderTexture` / 基类 `PlayModeView.m_TargetTexture`）；Tuanjie 专属 HMI Simulator 渲染进 `DeviceView.PreviewTexture` 而不落到基类 RT，故在 `TUANJIE_1_0_OR_NEWER` 下通过 `FindPreviewTextureInVisualTree` 反射遍历可视树查找 `PreviewTexture`
- **串流遮罩窗口（Streaming Mask Window）**：新增 `StreamingMaskWindow`，在离屏 / Play 模式串流期间于 Windows 与 macOS 上叠加遮罩 UI，配合帧串流隐藏底层窗口内容
- **macOS 原生键盘输入注入**：Play 模式串流期间经 `CGEventCreateKeyboardEvent` 注入 OS 级键盘事件，新增浏览器键到 macOS 虚拟键码映射、按住键跟踪与超时去激活、本机物理按键状态轮询优化；新增 verbose 日志开关（菜单命令），高频日志改用 `LogVerbose`
- **Cowork 输入框自动 focus**（AICODE-1542）：WebView2 内嵌为 Unity GUIView 子窗口时，仅 `EditorWindow.Focus()` 只把 Win32 焦点给到父 GUIView，HTML 的 `autofocus` / `element.focus()` 不显示光标也收不到键盘输入；新增 `NB_MoveFocus` P/Invoke 与 `WebView2Host.MoveFocus`，首次导航完成后（仅本窗口可见时，且只做一次）把焦点显式送入内容，避免 SPA 后续路由切换抢焦点

### Changed

- **NWB 信令服务改用 OS 动态分配端口**（`361f647`）：原生窗口桥接的串流信令服务默认端口由固定值改为 `port=0`（OS 自动分配），避免同机多 Unity Editor 实例的端口冲突
  - `PortManager.PortConfig` 新增 `stream_port` 字段，`StatusHelper` 经 `NativeWindowBridgeHost.GetBoundPort()` 查询并在状态载荷（含 legacy payload）中上报实际绑定端口，供客户端运行时发现
  - `AutoStartStreamServer` 与 `start_stream_server` 默认走动态端口；端口回退逻辑调整为仅在显式指定固定端口（`port>0`）且 `allowPortFallback=true` 时生效，错误信息与日志同步改为动态端口语境
- **DrillWindow 单实例 attach 流程**（AICODE-1507）：Walkthrough 启动改为 `EnsureTauriProcess`——先经 `~/.codely/app.lock.meta.json` 发现运行中的单实例 `cowork` APP，校验 `/api/tauri/status` 的 `single_instance` 后 POST `/api/tauri/attach-embed-workspace` 注册当前工作区并走正常 lock-file attach，仅在无运行实例时才新启进程；HTTP 与 lock 轮询置于后台线程，避免阻塞主线程
  - `OnGUI` backstop 改以 IPC `server_ready` URL 的端口为准（覆盖启动时乐观缓存的陈旧端口），杜绝把 WebView2 指向死端口（`ERR_CONNECTION_REFUSED`）
  - `GetWebViewUrl` 追加 `workspaceDir` / `theme` / `mode=embedded` 查询参数，使 Tauri 后端能为这个无窗口标签的内嵌 WebView 注入 `window.__CODELY_WORKSPACE_DIR__` 并正确路由 drill 相关 invoke
- **重绘 / 重新隐藏逻辑改用基于帧的 ticker**（`126ba3e`）：将嵌套 `delayCall` 回调替换为 `PlayModeRepaintTick` / `ReloadRehideTick` 帧计数器（`s_PendingPlayModeRepaints` / `s_PendingReloadRehidePasses`），使 GameView 重绘与 domain reload 后窗口重新隐藏分散到不同 editor 帧、时序更可控
- **打包 macOS 原生桥接依赖**（`f5fb3a9`）：随包附带 `libcrypto.3.dylib`、`libssl.3.dylib`，并更新 `libNativeWindowBridge.dylib` / `libdatachannel.dylib`，解决传递依赖缺失
- **更新各平台原生二进制**：Windows `NativeWindowBridge.dll` / `datachannel.dll` / `NativeBrowser.dll` / `NativeIpcClient.dll` / `NativeTcpBridge.dll`，macOS `libNativeWindowBridge.dylib` / `libNativeTcpBridge.dylib`，Linux `libNativeTcpBridge.so`

### Fixed

- **AICODE-1508 Walk Through 最后一步点击无响应**：内嵌 WebView 缺少工作区路由信息时后端以 "Missing workspace routing info" 拒绝全部 invoke，`drill/drillCompleted` 永远到不了处理器、Unity 收不到 `drillCompleted` IPC；经 `GetWebViewUrl` 注入 `workspaceDir` 修复
- **AICODE-1507 Walk Through 页面无法访问 / 打开时把 Tuanjie Cowork 拉到前台**：经单实例 attach 流程复用运行中的 APP，不再新启会被 `tauri_plugin_single_instance` 转发后立即退出（端口从未绑定）的多余进程
- **Windows Play 模式下幽灵移动与遮罩窗口闪烁**（`c8951ff`）：`SetFocus` 触发前台窗口回收打断 `WM_KEYUP`、Input Manager 残留按键状态；新增前台回收宽限期与按住键跟踪，在 mouseup 时 flush 陈旧状态，离屏去激活时重置按键跟踪
- **Windows Play 模式按住键卡顿**（`9c700fb`）：初始按键重复延迟（~500ms）超过宽限期（0.15s）导致遮罩窗口过早回收焦点；前台回收跳过逻辑扩展为在整个按住期间检查 `s_WinHeldKeys`
- **退出 Play 模式时帧停顿与 domain reload 恢复**（`45e6298`）：Play 模式状态切换后强制立即重绘 GameView 并安排多次重绘覆盖 Unity 短暂渲染停顿；domain reload teardown 前先通知浏览器以缩短重连延迟
- **assembly reload 期间残留浮动捕获窗口**（`fb53c07`）：自动创建的浮动捕获窗口因 close 被推迟到 `delayCall`，会先被 `RestoreAllWindowsVisible` 恢复可见而永久残留；改为 reload 前经 `SessionState` 跟踪并同步关闭，reload 后再按保存的 instance ID 检测并清理遗留窗口，macOS `RestoreAllWindowsVisible` 排除正在关闭的 NSWindow

## [1.0.52] - 2026-05-21

### Fixed

- **Unity 2019 / 标准 Unity 编译失败**：1.0.50–1.0.51 引入的 WebRTC 串流 / 窗口桥接代码无法在 Unity 2019.4 与标准 Unity（非团结引擎）上编译，本次统一修复
  - C# 8.0 switch 表达式改写为传统 switch 语句（`ManageWebRtcStream`、`ManageWindowBridge`），并将目标类型 `new()` 还原为显式构造函数调用（`new object()` / `new RenderStreamingSession()`）
  - `EditorWindow.docked` 在团结引擎中为 internal（标准 Unity 2020.1+ 为 public）：新增 `NativeWindowBridgeHost.IsWindowDocked` 反射助手，`ManageWindowBridge` 的 `list_windows` 等改为经其读取，不可用时返回 `false`
  - `EditorSnapSettings.gridSize` 仅团结引擎存在：`NativeWindowBridgeHost.Panel` 新增 `GetSnapGridSize` / `SetSnapGridSize` 反射访问，标准 Unity 下回退到 `EditorSnapSettings.move`
  - `SceneView.IsCameraDrawModeSupported`、`EditorGUIUtility.GetIconForObject` 在团结引擎中为 internal：改为反射调用（`IsCameraDrawModeSupportedReflected`），API 不可用时默认视为支持，避免静默隐藏绘制模式
  - Windows / macOS 原生 DLL 静态字段加 `#if UNITY_EDITOR_WIN` / `#if UNITY_EDITOR_OSX` 平台预处理守卫
  - .NET Standard 2.0 兼容：`string.Contains(char)` 改为 `Contains(string)`（`ManageGameObject`、`ReadConsole`），`Contains(string, StringComparison)` 改为 `IndexOf(..., StringComparison) >= 0`（`CodelyIpcServer`）
- **批处理 / 无头模式下自动弹窗导致测试失败**：新增 `TauriUtils.IsAutomatedEditorRun`（`Application.isBatchMode` 或 `SystemInfo.graphicsDeviceType == Null`）；`CodelyWindow.TryAutoOpenAfterInstall`、`DrillWindow.AutoOpenOnLoadIfDrillIncomplete` 与 `OpenWalkThrough` 在该环境下不再创建窗口，避免触发原生 `SUCCEEDED(hr)` 断言把本可通过的 CI / QA 测试整体判为 FAIL

## [1.0.51] - 2026-05-20

### Added

- **macOS 原生依赖预加载**：`NativeWindowBridgeHost` 新增 `EnsureMacDylibLoaded`，在首次探测原生可用性前通过 `dlopen`（`RTLD_NOW | RTLD_GLOBAL`）主动加载 `libdatachannel.dylib` 与 `libNativeWindowBridge.dylib`，解决部分打包流程产生的裸名称（bare-name）链接无法解析传递依赖的问题
  - `EnumerateMacNativeBridgeFolders` 先经 `AssetDatabase.FindAssets` 定位已导入的 dylib 资源目录，再回退到 `Packages/cn.tuanjie.codely.bridge/Plugins/macOS` 与 `Library/PackageCache` 下的包目录
  - 预加载结果（成功路径或 `dlerror` 详情）记录到 `macNativeDylibLoadDetail`，并在 `DllNotFoundException` / `EntryPointNotFoundException` 时追加到可用性原因中，便于排查
- **流服务自动启动重试与失败检测**：`ManageWindowBridge.AutoStartStreamServer` 新增可配置的重试机制（`AutoStartRetryDelayMs` 2000ms、`AutoStartRetryMaxAttempts` 30 次），插件尚未就绪时按节流策略（首次及每 5 次）打印进度日志，超过上限后停止重试并提示可手动调用 `start_stream_server`
  - 新增 `IsNonRetryablePluginFailure`，识别架构不匹配（`wrong architecture` / `incompatible architecture` / `no suitable image found` 等）等不可恢复失败，直接报错并停止重试，避免无意义的日志噪音

### Changed

- **macOS 暂时禁用原生流服务**：`IsStreamingSupportedOnCurrentPlatform` 在 macOS 平台改为返回 `false`（与 Linux 一致），在 macOS 原生插件 / 运行时路径完善前保持硬禁用
- **平台相关日志与错误信息细化**：Linux / macOS 分别打印各自的禁用提示；`AutoStartStreamServer` 失败及 `start_stream_server` / offscreen 入口的错误信息改为附带 `GetAvailabilityReason()` 详情，并去除指向特定平台的过时措辞
- **更新 macOS 原生二进制**：同步发布更新后的 `libNativeWindowBridge.dylib` 与 `libdatachannel.dylib`（通用 / x86_64 构建）

## [1.0.50] - 2026-05-20

### Added

- **WebRTC 串流与窗口管理桥接**：新增完整的 Editor 窗口 WebRTC 串流基础设施，支持通过浏览器远程查看与交互 Unity Editor 窗口
  - 新增 `ManageWebRtcStream` 与 `ManageWindowBridge` 两个工具，并配套 `NativeWindowBridgeHost` / `NativeWindowBridgeAPI` P/Invoke 绑定层
  - 随包附带跨平台原生插件：Windows `NativeWindowBridge.dll`、`datachannel.dll`、`libcrypto-3-x64.dll`、`libssl-3-x64.dll`；macOS `libNativeWindowBridge.dylib`、`libdatachannel.dylib`
  - 支持窗口枚举、聚焦与原生句柄解析；鼠标 / 键盘事件注入；离屏（offscreen）渲染模式与帧串流
  - WebRTC 会话生命周期经 IPC（`CodelyIpcServer`）管理，串流服务端口被占用时支持端口回退（port fallback）启动
  - Unity 与原生平台之间的坐标系转换，并通过反射访问 Unity 内部 Editor API
  - 交互式面板提取：Grid Settings、Snap Increments、Grid Snapping（`NativeWindowBridgeHost.Panel.cs`）
- **原生日志回调与 assembly reload 加固**：`NativeWindowBridgeHost` 新增 `NWB_SetLogCallback` 委托 / P/Invoke，将原生 C++ 日志接入 Unity Console，并在服务初始化前注册回调以捕获全部 C++ 日志
  - 新增 `OnBeforeAssemblyReload` 处理：domain reload 前停止服务并安全置空日志回调，避免悬空函数指针导致崩溃
  - 新增 `ForceResetNativeOffscreenState`（restore 失败时清理原生状态）与 `NWB_StopCapture` P/Invoke（干净退出 offscreen 模式）
  - 找不到 `NWB_SetLogCallback` 导出时打印 `Debug.LogWarning`，替代原先的静默跳过，便于排查原生日志缺失
- **macOS 原生键盘事件注入**：更新 `libNativeWindowBridge.dylib`，接入 CoreGraphics / CoreFoundation 的 `CGEventCreateKeyboardEvent` / `CGEventSetFlags`，使 Play 模式 GameView 串流期间可向 Unity 运行时 Input 系统派发 OS 级键盘事件

### Changed

- **DPI 缩放逻辑集中到 `DPIScale`**：`NativeWindowBridgeHost` 新增静态 `DPIScale` 属性，统一 Windows / macOS 平台相关的缩放计算，替换散落在 capture 尺寸、GUIView 尺寸提取、resize 目标比较中的重复条件分支
- **截图未指定尺寸时自动降采样并下调默认分辨率**：`ManageScreenshot` 在调用方未提供 width/height 时，将每张截图按最长边降采样至 256px（保持宽高比）；同时下调各截图入口的默认回退分辨率（Scene View `960×540` → `480×270`、asset `1024` → `480×270`、UI Toolkit 改用 `Math.Min(..., 480/270)`），避免输出超大图
- **更新 Windows 原生二进制**：同步发布更新后的 `NativeWindowBridge.dll` 与 `datachannel.dll`

### Fixed

- **ERD-4273 启动失败**：更新 Windows `NativeBrowser.dll`、`NativeIpcClient.dll`、`NativeTcpBridge.dll`（并补充 `NativeBrowser/CMakeLists.txt`），修复启动失败问题
- **Windows HiDPI 离屏截图被放大**：修复 Windows HiDPI 显示器下 offscreen 窗口渲染内容被放大 / 缩放错误的问题——前端 CSS 像素与 Unity 逻辑点 1:1 对应，但 GPU backbuffer 工作在物理像素分辨率，Windows 需缩放到物理像素、macOS 由 backing scale 内部处理；`TryGetCurrentGUIViewSize` 在 Windows 改为返回物理像素，并移除错误的 `pixelsPerPoint` 除法
- **离屏串流结束后相机宽高比错乱**：串流期间相机被手动设为浮窗尺寸，docked GameView 恢复时 Unity 的 aspect 重置逻辑会跳过 manual 模式相机，导致后续渲染水平压缩；`StopOffscreenCapture` 新增 `ResetAspect()` 恢复 auto 模式，新增 `RestoreGameCameraAspects()` 在串流事件期间修复 aspect 损坏，并缓存 `m_TargetTexture` FieldInfo 避免反复反射
- **Editor 无焦点启动时 WebView2 初始化卡住**：编辑器无焦点启动时 `EditorApplication.update` / `delayCall` 被节流到接近停摆，导致 `server_ready → OnTauriServerReady → TryInitializeWebView2` 链路卡在 "Loading..." 占位
  - `CodelyIpcManager` 用 volatile 静态缓存最新 `server_ready` URL，主线程无需等待 delayCall 即可读取
  - 从 IPC 后台线程对每个 `UnityGUIViewWndClass` 子窗口 `InvalidateRect`，借 WM_PAINT 唤醒 Unity 消息循环、强制走一次 OnGUI
  - `CodelyWindow` / `DrillWindow` 新增 OnGUI backstop，在 paint 期间读取缓存 URL 直接驱动 `TryInitializeWebView2`
  - 移除主线程冗余 delayCall 与基于 Sleep 的阻塞式 HWND 轮询；`Ctrl+L` 无选中时恢复（Show/Focus）已有窗口而非将其关闭
- **Windows 包升级时原生崩溃**：domain reload 前对 WebView2 BrowserInstances 做 Windows 平台同步关闭（`NB_ShutdownAll`，5000ms 超时），在 `NativeBrowser.dll` 卸载前完成全部原生资源清理；清空 C# 句柄引用避免重复清理，并清理 `DrillWindow` 的 WebView2 引用
- **移除过时的 signaling URL 构建并加强 JSON 转义**：移除依赖已不存在的 `CodelyIpcManager.LastServerUrl` 的 `BuildSignalingUrlFromTauri`，RenderStreaming 会话改为要求显式 `signaling_url` 参数；`EscapeJson` 补充 Unicode 控制字符（U+0000–U+001F，含退格 / 换页）转义，避免 JSON 解析错误
- **AICODE-1474 force reload 与点击 AI 后 layout 错乱**：新增 `CodelyWindowDocker`，修复 force reload 及点击 AI 之后窗口 layout 不正确的问题
- **AICODE-1492 Get Started 最后一步按钮无响应**：修复 Walkthrough 中 Get Started 最后按钮点击无反应的问题（`CodelyWindow` / `CodelyWindowDocker`）

## [1.0.49] - 2026-05-15

### Added

- **Editor 加载时若 drill 未完成则自动弹出 Walkthrough**：`DrillWindow` 新增 `[InitializeOnLoadMethod] AutoOpenOnLoadIfDrillIncomplete`，在编辑器启动 / domain reload 时通过 `EditorApplication.delayCall` 延迟到首个 idle tick，再读取 `~/.codely/data.json` 的 `drillCompleted` 字段；为 `false` 时自动调用 `OpenWalkThrough()` 让首次接入的用户无需手动点 `AI/Open Walkthrough` 菜单
  - 使用 `SessionState` key `Codely_DrillAutoOpened` 作为 per-session 守卫，确保同一个 Editor 会话内的多次 domain reload（脚本重编译）不会反复弹窗
  - 跳过条件：`TauriUtils.GetCodelyRunnable()` 为空（未安装 cowork runnable）、已存在 `DrillWindow` 实例（`HasOpenInstances<DrillWindow>()`）、或 drill 已完成

### Changed

- **`IsDrillCompleted` 从 `CodelyWindow` 提升到 `TauriUtils`**：原先位于 `CodelyWindow` 的私有静态方法 `IsDrillCompleted` 迁移到 `TauriUtils.IsDrillCompleted`（`internal`），`CodelyWindow.OpenCodelyWindow` 与新的 `DrillWindow.AutoOpenOnLoadIfDrillIncomplete` 共享同一份 `~/.codely/data.json` 读取实现，避免后续两份代码出现行为漂移

## [1.0.48] - 2026-05-15

### Changed

- **顶层菜单从 `Window/Tuanjie AI/` 改为 `AI/`**：将 1.0.46 引入的 `Window/Tuanjie AI/*` 菜单组整体上移到主菜单栏顶层 `AI/`，并去除 `Tuanjie` 前缀，使条目在菜单栏一级即可访问
  - `Window/Tuanjie AI/Open Assistant` → `AI/Open Assistant`（保留 `Ctrl+L`）
  - `Window/Tuanjie AI/Open CLI` → `AI/Open CLI`
  - `Window/Tuanjie AI/Open Walkthrough` → `AI/Open Walkthrough`
  - `Window/Tuanjie AI/Check Connections` → `AI/Check Connections`
  - `Window/Tuanjie AI/Force Reload` → `AI/Force Reload`
  - 右键菜单同步：`Assets/Tuanjie AI/Add to context` → `Assets/AI/Add to context`，`GameObject/Tuanjie AI/Add to context` → `GameObject/AI/Add to context`
- **主工具栏按钮文案改为 `AI`**：`CodelyToolbar` 中 `MainToolbarContent` text、`ToolbarButton.tooltip` 与 `Label` 由 `Tuanjie AI` 改为 `AI`，与新的顶层菜单命名保持一致
- **`Open CLI` 未找到 CLI 时的提示更新**：`CodelyWindow.OpenCodelyTerminal` 中 `Tuanjie AI CLI Not Found` 弹窗的提示改为指引设置 `CODELY_HOME`（包含 `codely[.exe]`）或 `CODELY_APP_HOME`（包含 `cli/bin/<platform>/codely[.exe]`），替换原先 `CODELY_CLI_PATH` 的过时描述
- **`CODELY_APP_HOME` 查询走统一 `ReadOsEnvVar` 助手**：`TauriUtils.GetCodelyRunnable` 删除内联的 Windows 注册表 / macOS 登录 shell 查询代码，改为通过共享的 `ReadOsEnvVar("CODELY_APP_HOME")` 每次从 OS 级存储读取，行为与 1.0.46 等价但实现统一，便于其它读取项复用

### Fixed

- **macOS `Open CLI` 路径含空格时启动失败**：`CodelyWindow.OpenCodelyTerminal` 在调用 `osascript` 时不再直接把 `cliPath` 拼进 `do script "..."` 字符串，而是先做 AppleScript 级 escape（先 `\` 后 `"`）再用 `quoted form of` 由 AppleScript 在运行时做 shell quote；包含空格的安装路径（如 `/Applications/Codely Cowork.app/Contents/Resources/cli/...`）现在能作为单一参数完整传入 Terminal 子 shell，不再被空格截断

### Documentation

- **Tests/Coverage 文档对齐 bridge 实现**：
  - 新增 `execute_csharp_script_full_coverage.md`（约 500 行），覆盖 ExecuteCSharpScript 自动修复、`script_path`、内部日志抑制等用例
  - 重写 `unity_script_full_coverage.md`（+1191 行）覆盖 ScriptFix 全套修复器与 edit revision 行为
  - 修正 `execute_custom_tool_full_coverage.md` 断言与 lookup 用例，与当前 `ExecuteCustomTool` 注册/反射路径一致
  - `unity_workflow_full_coverage.md` 补充 batch + 工作流场景；`README.md` 更新索引

## [1.0.47] - 2026-05-15

### Changed

- **UI 文案统一改为 "Tuanjie AI"**：将编辑器内残留的 "Codely" 用户可见字符串整体替换为 "Tuanjie AI"，与顶层菜单 `Window/Tuanjie AI` 改名保持一致；底层命名空间、包名、`CODELY_APP_HOME` 等环境变量与 IPC 协议保持不变，仅修改可见文案与菜单/资源命名
  - `TcpBridgeControlWindow`：窗口标题 `Codely Bridge` → `Tuanjie AI Bridge`，就绪 / 未连接提示文案同步替换为 `Tuanjie AI bridge is ready` / `Connect to Tuanjie AI Agent` / `Start Tuanjie AI Bridge to connect to Tuanjie AI Agents.`
  - `CodelyToolbar`：主工具栏元素路径 `Codely AI/Codely Bridge` → `Tuanjie AI/Tuanjie AI Bridge`，按钮 tooltip / Label 由 `Codely` 改为 `Tuanjie AI`
  - `CodelyWindow`：窗口标题、`Loading Codely...` 占位、`Updating Codely` 更新页、Setup 引导页的 logo / 主副标题、`Codely CLI Not Found` 与终端打开失败弹窗等全部改为 `Tuanjie AI`；右键菜单 `Assets/Codely AI/Add to context` → `Assets/Tuanjie AI/Add to context`，`GameObject/Codely AI/Add to context` → `GameObject/Tuanjie AI/Add to context`
  - `DrillWindow`：Walkthrough 窗口标题 `Codely WalkThrough` → `Tuanjie AI WalkThrough`
- **布局文件改名 `Codely Mode.wlt` → `Tuanjie AI Mode.wlt`**：随包附带的 Window Layout 资源同步更名，避免 `Window > Layouts` 菜单中同时出现新旧两份 Codely 布局

### Fixed

- **`CodelyLayoutInstaller` 兼容老布局迁移**：
  - 安装新 `Tuanjie AI Mode.wlt` 时同步从用户 layouts 目录删除遗留的 `Codely Mode.wlt`，确保菜单中不再出现旧条目
  - 新增 `IsLegacyLayoutActive` 检测：通过反射定位 `UnityEditor.WindowLayout.GetCurrentLayoutPath()`（不可用时回退到扫描 `layoutsPreferencesPath` 下最新的 `CurrentLayout*.dwlt`），解析 `m_LastLoadedLayoutName` 是否为 `Codely Mode` / `Codely`；仅当用户仍停留在旧布局时才自动切换到 `Tuanjie AI Mode`，避免每次 domain reload 都重置用户的窗口自定义

## [1.0.46] - 2026-05-15

### Added

- **Welcome 流程结束后自动切换 Codely Layout**：`DrillWindow.OnDrillCompleted` 在打开 `CodelyWindow` 前先调用新增的 `CodelyLayoutInstaller.ApplyCodelyLayout()`，把 Editor 加载到随包附带的 Codely `.wlt` 布局
  - 新增 `ApplyCodelyLayout`：若用户 layouts 目录缺少布局文件则先执行 `InstallCodelyLayout` 重新落盘，再通过反射调用 `UnityEditor.WindowLayout.TryLoadWindowLayout` / `LoadWindowLayout` 加载
  - 在 layout swap 前先 `Close()` DrillWindow，确保 IPC release / WebView teardown 同步走完，避免布局切换将其他窗口一并销毁时遗留资源

### Changed

- **顶层菜单移入 `Window/Tuanjie AI`**：原 `Codely AI/*` 菜单整组迁出主菜单栏，挂到 `Window` 下并改名 `Tuanjie AI`，同时重命名条目以去除 "Codely" 字样
  - `Open Codely` → `Open Assistant`（保留 `Ctrl+L` 快捷键）
  - `Open Codely (Terminal)` → `Open CLI`
  - `Open Codely Walkthrough` → `Open Walkthrough`
  - `Open Codely Bridge` → `Check Connections`
  - `Force Reload Codely` → `Force Reload`
- **默认安装目录优先 Tuanjie Cowork**：`GetCodelyRunnable` 在 `CODELY_APP_HOME` 未设置时，先尝试 `%LOCALAPPDATA%\programs\Tuanjie Cowork`（macOS：`/Applications/Tuanjie Cowork.app/Contents/MacOS`），仅当该路径下不存在 `cowork[.exe]` 时回退至 `Codely Cowork`
- **`CODELY_APP_HOME` 每次从最新环境读取**：移除进程启动时缓存的 `Environment.GetEnvironmentVariable("CODELY_APP_HOME")`，改为每次解析时从 Windows 注册表（`HKCU/HKLM Environment`）或 macOS 登录 shell 读取，避免安装器更新环境变量后必须重启 Editor 才能生效

### Fixed

- **`CODELY_APP_HOME` 指向无效目录时不再硬失败**：`GetCodelyRunnable` 在读取到 `CODELY_APP_HOME` 后，若该目录下不存在 `cowork[.exe]`，会打印 warning 并清空 `home`，让默认 `Tuanjie Cowork` / `Codely Cowork` 回退逻辑继续生效，而不是把无效路径一直传到最末的 `File.Exists` 错误

## [1.0.45] - 2026-05-15

### Fixed

- **`capture_ui_toolkit` 空白截图**：重写 `CaptureUIToolkitCoroutine` 中 PanelSettings / UIDocument 初始化与渲染驱动逻辑，解决在 HiDPI 显示器与全新 Editor 会话下 UI Toolkit 截图输出为空白或 0×0 的问题
  - `PanelSettings.scaleMode` 改为 `ConstantPixelSize` 并将 `scale`、`referenceDpi`、`fallbackDpi` 锁定到 1×/96 dpi，避免 HiDPI 下 panel 解析尺寸缩半或为 0
  - `clearDepthStencil` 置为 `true`，清理上一次重试残留深度，防止后续 UI quad 被深度剔除
  - 临时 `__CodelyTempUIDocument__` GameObject 改用 `HideFlags.DontSave`，使 runtime panel 系统能正确注册其离屏 panel
  - root `VisualElement` 显式钉到 RenderTexture 尺寸，避免首次 layout tick 之前为 0×0
  - 新增 `GetDefaultRuntimeTheme` 回退，当 UI Builder 主题映射不可用时仍使用默认 runtime 主题渲染
  - 新增 `TryForceUIDocumentRepaint`：通过反射调用 panel 的 `Repaint(Event)` / `Render()` 同步刷新 UIR draws，移除原先依赖编辑器前台 + player loop 的实现
  - 移除 `FocusUnityEditor` 及配套 Win32 `SetForegroundWindow` / `AttachThreadInput` P/Invoke 与 macOS `osascript` 调用，截图不再抢占用户当前前台窗口

### Changed

- **`Plugins\Codely.Newtonsoft.Json.dll` Auto Reference 打开**：将 `isExplicitlyReferenced` 由 1 改为 0，使用户程序集无需显式 reference 即可使用 bundled Newtonsoft.Json

## [1.0.44] - 2026-05-14

### Added

- **Unity 2019.4 支持**：将包最低支持版本从 Unity 2021.3 下调至 Unity 2019.4，并打平 Mono / C# 7.3 兼容性差异
  - 重写跨 Bridge / Tauri 编辑器代码中的 C# 8+ 构造（switch expressions、range indexers、`using var`）为 7.3 兼容形式
  - 随包附带 Unity 2019 缺失的 .NET Standard 2.0 facade DLL：`System.Memory`、`System.Buffers`、`System.Numerics.Vectors`、`System.Threading.Tasks.Extensions`、`Microsoft.Bcl.*`、`System.Text.Encoding.CodePages`
  - Windows 下将 `CodelyIpcServer` 内的 `System.IO.Pipes.NamedPipeClientStream` 替换为原生 `NIC_*` 单例（`NativeIpcClient.dll`），规避 Mono 5.x 命名管道取消挂起与程序集重载线程泄漏
  - `NativeWindowHelper` 改为基于位置的 GUIView 匹配 + 缓存的静态 `EnumWindowsProc` 委托，避免 Mono `delegate_hash_table` 每次分配委托导致的崩溃
  - 移除未使用的 `BinaryFrameHelper` 与 `InternalAPIEditorBridge.017` asmdef
- **`ConsoleLogChangedNotifier`**：新增 NTB_* 推送通知器，监听 Unity Console 日志变化并向已订阅客户端广播
- **`ManageEditor` focus window 前置**：聚焦 Codely 窗口前先将 Unity 主进程带到前台（Windows `AttachThreadInput` + `SetForegroundWindow`、macOS `osascript` 激活 PID），避免被其他应用遮挡
- **`ExecuteCSharpScript`**
  - 新增 `description` 参数，用于在调用侧标注脚本意图
  - 抑制工具自身内部跟踪日志，避免污染脚本执行期间捕获的 Console 输出
- **macOS WebView**：新增 `WebViewPlugin.bundle` 骨架，Tauri/WebView 多平台共享同一组接口

### Changed

- **Tauri 单实例进程管理重构**：在 Codely 跨工作区切换、关闭窗口等场景下保留单一 Tauri 进程，避免 UI 拆解与重复启动
  - `CodelyWindow` / `TauriUtils` 增加 single-instance attach 逻辑与全局 app meta path 检索
  - 工作区目录获取统一走 `GetWorkspaceDirectory`，standalone window state 处理更新以与 attach 流程对齐
  - Tauri 应用启动改为 async 入口，提升窗口打开响应性
  - 关闭窗口时清理遗留 Tauri 进程；切换 workspace 时不再误杀仍在使用的 Tauri 实例
  - 强化进程终止与 IPC 通道在单实例模式下的清理顺序
- **拖拽 UI 重写（`CodelyWindow`）**：重写 drag & drop 渲染与命中测试路径（+623 行），修正拖拽视觉与上下文添加流程
- **macOS 主题同步**：IPC 连接建立时与 Tauri 同步深色/浅色主题，主题变更时主动下发颜色到 Tauri
- **场景视图截图默认分辨率**：`take_scene_screenshot` 在未提供 width/height 时回退到 1920×1080，避免输出空尺寸
- **更新插件图标**
- **更新 `Plugins\Win\NativeIpcClient.dll` 与 `NativeBrowser.dll` 元数据**

### Fixed

- **WebView 与编辑器 Tab 重叠**：调整 `CodelyWindow` 中 WebView 的布局，避免覆盖编辑器窗口标签栏
- **Unity 2019 macOS WebView 错误**：修复 macOS + Unity 2019 下 WebView 初始化与崩溃问题
- **Unity 2020.3.15 兼容性**：修复 `ManageUIToolkit` 与 `CodelyIpcServer` 在 2020.3.15 上的编译/运行错误
- **Windows IL2CPP 构建报错**：修正 Win 原生插件（`NativeBrowser.dll`、`NativeIpcClient.dll`、相关 cpp/h）的 `.meta` 平台设置，使 IL2CPP 构建不再误纳编辑器原生插件
- **DLL 平台 meta 配置**：修正随包附带的 facade DLL（`System.Buffers`、`System.Memory`、`System.Numerics.Vectors`、`System.Text.Encoding.CodePages`、`System.Threading.Tasks.Extensions`）以及 `NativeBrowser.dll` / `NativeIpcClient.dll` 的 import settings，消除 dll 重复加载/平台冲突报错
- **ScriptFix `SyntaxTree` 歧义**：在 `ScriptFixProvider` 与各 `Fix*` 类中显式限定 `Microsoft.CodeAnalysis.SyntaxTree`，解决与其他程序集类型同名导致的编译歧义
- 移除遗留调试日志

## [1.0.43] - 2026-05-07

- 版本号占位（package.json 已升至 1.0.43，但未独立发布；变更内容合并至 1.0.44）

## [1.0.42] - 2026-04-29

### Fixed

- **Codely Window 显示问题**：修复 Codely Setup Window Icon 显示问题
## [1.0.41] - 2026-04-29

### Fixed

- **GameObject 序列化崩溃**：新增 `Matrix4x4Converter` 与 `TransformHandleConverter`，避免 Newtonsoft 反射序列化 `Matrix4x4`（`inverse`/`transpose` 递归与 `rotation` 触发 `ValidTRS` 断言导致 StackOverflow）以及 `UnityEngine.TransformHandle`（默认值触发 `AssertHandleIsValid`）时的崩溃
- **`get_components` 按 instanceID 查找失败**：`FindObjectsInternal` 现将数字字符串与 `searchMethod == "default"` 视为按 ID 查找，避免传入整型 instance ID（如 `49552`）时回退到按名称匹配
- **U6 打开 Codely 时点击 AI 按钮自动输入 `@Readme`**（AICODE-1326）
- **`OnServerReady` 端口校验**：在服务就绪回调中新增端口有效性校验
- **WebView 稳定性与资源共享**：改善 WebView 多窗口场景下的资源共享与稳定性

### Changed

- **Unity Bridge UI 调整**（AICODE-1317）
- 更新插件图标

### Removed

- 移除未使用文件

## [1.0.40] - 2026-04-22

### Added

- **统一命令与通知 TCP 通道**：将原有 `UnityStateServer`（USS_*）与 `NativeTcpBridge`（NTB_*）整合为单一 NTB_* ABI，单条 TCP 监听同时承载入站命令与出站推送通知；`CLIENT_VERSION>=2` 客户端可订阅推送
- **Unity 状态推送通知**：新增 `SceneHierarchyNotifier` 与 `SelectionChangedNotifier`，通过 debounce 合并高频事件，载荷与 `ManageScene` / `ManageEditor` 响应保持一致
- **`UnityTcpBridge.NotifyAll(eventType, payload)` 公共 API**：暴露统一的推送入口
- **`ManageEditor.GetSelection` 增强**：响应额外返回 `activeAsset`、`assetPaths` 以及每个 GameObject 的层级路径
- **Tauri Embed 模式检测**：通过 `/api/tauri/status` 端点读取远端 detach/embed 状态，附加进程时正确判定模式；新增 `TryParseJsonEmbedModeField` 解析与同步调试日志

### Changed

- **GameObject 路径语义统一**：`ManageEditor.GetGameObjectPath` 返回层级路径而非场景路径，与 `SelectionChangedNotifier` 对齐，使 `get_selection` 响应与 `selection_changed` 通知中的 `path` 字段含义一致
- **场景层级树构建迭代化**：`ManageScene` / `SceneHierarchyNotifier` 的递归 DFS 重写为两阶段迭代实现，避免深层级时托管栈溢出
- **`SceneHierarchyNotifier` 防抖**：从 per-frame `delayCall` 合并改为基于 `EditorApplication.update` 的 250 ms idle-debounce，事件爆发时仅产生单条通知
- **原生桥接绑定流程**：`NativeUnityTcpBridgeHost.StartOrAttach` 在调用 `NTB_Start` 前先探测 `IsRunning` / `GetBoundPort`，域重载后能可靠复用既有原生监听
- **`NativeDllLoader.Load` 句柄校验**：通过 `GetModuleHandleExW`（Windows）/ `dlopen(RTLD_NOLOAD)`（macOS/Linux）做 path-based 探测，消除包升级后 `SessionState` 句柄复用导致的 double-free 风险
- **拆解顺序修正**：新增 `NativeDllLoader.OnUnload` 事件，`UnityTcpBridge` 与 `UnityStateServer` 在原生句柄释放前先自行停止，替代 `Unload()` 中的直接调用
- **反射加载容错**：`ICommandExecutor.Register` 捕获 `ReflectionTypeLoadException`，部分类型加载失败时仍可注册其余可用类型，避免整体扫描被静默丢弃
- **`UssConfig` 缓存**：内存缓存配置，避免心跳写入时反复读取磁盘
- **进程环境清理**：启动 Tauri 前调用 `TauriUtils.SanitizePkgEnvironment` 从 `ProcessStartInfo` 中移除 `PKG_EXECPATH`、`PKG_INVOKE_NODEJS`、`PKG_INVOKE_ENTRYPOINT` 等 pkg bootstrap 变量，防止 cowork/core 启动时入口探测失败
- **DLL 加载与进程绑定**：补充错误检查路径，加载或绑定失败时及时返回
- **更新 Win/Linux/macOS 原生插件二进制**：同步发布 `NativeTcpBridge.dll`、`libNativeTcpBridge.so`、`libNativeTcpBridge.dylib`

### Fixed

- **iOS 打包失败（AICODE-1278）**：修复安装 codelybridge 后打 iOS 应用报错

### Removed

- 旧版 `Editor/Bridge/Server` 目录（`UnityStateServer`、executor 抽象、`SceneHierarchyBuilder`、`UssConfigHelper`、schema 文档），由统一 NTB 通道及新通知器替代

## [1.0.39] - 2026-04-16

### Added

- **FixMissingAssemblyReference 支持 CS0234 命名空间修复**：当 CS0234 错误因使用了错误命名空间前缀（如 `UnityEngine.SerializedObject` 实际位于 `UnityEditor`）时，自动重写源码将错误前缀替换为正确命名空间
- **FixMissingAssemblyReference 扩展至 CS0103**：将 `FixMissingAssemblyReference` 支持的诊断 ID 扩展为 `CS0246`、`CS0234`、`CS0103`，提升未限定符号的自动修复覆盖范围
- **新增 FixMissingAssemblyReference 测试套件**：新增 226 行覆盖测试（`FixMissingAssemblyReferenceTests.cs`）及 115 行 `FixMissingImportsTests.cs` 补充用例

### Changed

- **包升级处理优化**：改善 `CodelyWindow` 与 `DrillWindow` 在 Unity 包升级场景下的窗口生命周期处理，提升升级过程中的稳定性

## [1.0.38] - 2026-04-15

### Added

- **Native TCP Bridge**：将托管 C# TCP 服务器替换为原生插件架构，新增 Windows、macOS、Linux 三平台原生插件（`NativeTcpBridge.dll` / `libNativeTcpBridge.dylib` / `libNativeTcpBridge.so`）
- **NativeTcpBridgeHost**：新增 P/Invoke 绑定层，支持跨程序集重载后保持原生服务器状态；新增 `GetConnectedClients` 原生快照 API
- **NativeLibLoader**：动态加载原生 DLL，支持包更新后无需重启即可热替换
- **FixUnqualifiedUnityStaticMethod**：新增 ScriptFix 自动修复器，处理 CS0103（未限定的 Unity 静态方法调用），通过诊断 span 精确定位节点

### Changed

- **TCP 架构重构**：移除托管 `TcpListener` 及客户端循环代码，网络 I/O 移至原生层，减少 Editor 主线程阻塞；移除端口发现逻辑，改用操作系统自动分配端口
- **CompileAndAutoFix 重构**：用 `CSharpScript.Create()` 替代 `WrapScript`/`ExtractScript` 方案，自动修复编译检查与实际执行使用同一脚本引擎；新增回归保护，若修复后错误数增加则自动回滚；简化 `FixMissingBrace`，新增正则守卫跳过锯齿数组与命名元组数组的 CS1513
- **asmdef 重命名**：将内部桥接 asmdef 重命名为 `Unity.InternalAPIEditorBridge.017`，修复与 `com.unity.localization` 的冲突（AICODE-1121）
- **`NativeTcpBridge` 仅限 Editor**：将原生桥接代码限制为仅在 Editor 环境编译
- **`.npmignore` 更新**：排除构建产物

### Fixed

- **右键"加到 Codely"上下文未添加**：修复在未打开 Codely 窗口时使用右键菜单，内容不会被添加到上下文的问题（AICODE-1258）
- **Welcome 页面未显示**：修复 Tuanjie 和 Unity Editor 中未出现 Welcome 页面的问题（AICODE-1232）
- **Linux 原生库加载**：修复 Linux 下 DLL 加载器问题并更新 `.so` 文件
- **macOS 原生插件**：更新 macOS `libNativeTcpBridge.dylib`

## [1.0.37] - 2026-04-10

### Fixed
- fix: 打开Plugins\Codely.Newtonsoft.Json.dll auto reference

## [1.0.36] - 2026-04-09

### Added

- **ExecuteCSharpScript 自动修复**：新增 ScriptFix 框架，包含 `FixMissingImports`、`FixMissingSemicolon`、`FixMissingBrace`、`FixMissingParenthesis`、`FixMissingSquareBracket`、`FixMissingAssemblyReference`、`FixAmbiguousReference` 等修复器，编译失败时自动尝试修复并重试
- **ExecuteCSharpScript 支持 `script_path`**：新增 `script_path` 参数，可直接传入脚本文件路径；`script` 与 `script_path` 二选一
- **Assets 右键菜单"加到 Codely"**：启用 `Assets/Codely/Add to context` 右键菜单，将选中资源/GameObject 添加为 Codely 上下文（AICODE-1096）
- **Codely Layout**：新增 Codely 专属布局入口

### Changed

- **更新加载 UI 重构**：采用纯色 `#2d2d2d` 背景；内容区域扩展至 480px；标题字号升至 22px Bold；状态文本与页脚文本分行并用分割线隔开；旋转 spinner 改用 `Handles.DrawSolidDisc` 渲染
- **包名校验修正**：`OnPackagesRegistered` / `OnPackagesRemoved` 中将 `cn.tuanjie.codely` 更正为 `cn.tuanjie.codely.bridge`
- **安装后窗口打开方式**：改为调用 `ToggleCodely()` 优先显示引导页，Setup 完成后同样使用 `ToggleCodely()` 打开窗口
- **菜单栏结构**：`Open Codely Bridge` 菜单项从 `Window/Codely/` 移至顶层 `Codely/`（AICODE-1123）
- **DLL 重命名**：将 `Codely.Microsoft.CodeAnalysis.*` 系列 DLL 统一去除 `Codely.` 前缀，修复 Burst 编译报错
- **ReadConsole 优化**：新增最大 1000 条目限制、完善堆栈信息处理（AICODE-1117）
- **共享 IPC 基础设施**：提取可复用的 IPC 消息处理与工具类到独立模块
- **Codely Logo 及图标更新**：更新应用图标与标题栏图标

### Fixed

- **连接前进程存活检查**：尝试连接前先验证目标进程是否仍在运行，避免无效连接
- **Bridge 移除时窗口行为**：修复在 Codely 对话打开状态下移除 Bridge 不会自动关闭 Codely 窗口、顶部面板显示异常的问题（AICODE-1131）
- **TCP 服务器停止时端口状态**：服务器停止后将 `currentUnityPort` 重置为 `-1`（无效状态），避免残留端口被误用
- **Meta GUID 修复**：修正若干 `.meta` 文件的 GUID

## [1.0.35] - 2026-04-01

### Added

- **Tauri 自动更新**：新增 `updateRestart` IPC；更新重启期间显示加载 UI，重连后恢复窗口；`OnConnectionChanged` 经 `EditorApplication.delayCall` 派发；30 秒超时兜底
- **`manage_screenshot`**：支持 `capture_asset`、`capture_ui_toolkit`；部分命令支持协程执行；`UnityTcpBridge` 相应配合

### Changed

- **拖拽上下文 IPC**：`dropItems` 更名为 `addContexts`（Unity 内拖拽资源/GameObject 作为上下文）
- **启动 Tauri**：简化 Unity 登录态逻辑，直接使用当前会话 token，移除 `RefreshAccessToken` 与超时回退
- **工程锁与 Tauri 进程**：抽取可复用的 lock 解析与校验；支持就地更新后刷新进程身份
- **可执行文件与文案**：`codely-app` 更名为 `cowork`（Windows/macOS 路径与日志）

### Fixed

- **安装路径**：未配置 `CODELY_APP_HOME` 时回退到默认安装目录（Windows：`%LOCALAPPDATA%\programs\Codely Cowork`；macOS：`/Applications/Codely Cowork.app/Contents/MacOS`）
- **关闭标签页**：主线程立即 `Kill` Tauri 进程，避免新窗口误复用旧进程导致竞态（AICODE-1054）
- **切换工程关闭窗口**：`preserveTauri` 为 true 时不终止 Tauri 进程
- **macOS 粘贴**：聚焦嵌入 WKWebView（`MacOSWebViewBridge` / `WebViewPlugin`）

## [1.0.34] - 2026-03-26
### Fixed
- fix: 修复mac os 文件拖拽问题
## [1.0.33] - 2026-03-25
### Fixed
- fix: close window if project switched
- fix: codely bridge mac 上经常重连报错
## [1.0.32] - 2026-03-24
### Fixed

- 修复 `editor codely` 无法通过拖拽添加文件的问题

## [1.0.31] - 2026-03-23

### Changed

- **`take_scene_screenshot` multi-view capture**: Replace single scene-camera capture with a 4-view composite; a temporary camera mirrors all scene camera settings and shoots from ISO, TOP, FRONT, and RIGHT angles, then stitches the four renders into a 2×2 grid image (`StitchTextures2x2`)
- **Scene screenshot labels**: Draw white uppercase view-name labels (ISO / TOP / FRONT / RIGHT) with a darkened background at the top-left corner of each quadrant using a built-in 5×7 bitmap font rendered at 12× scale (`DrawLabelOnTexture`)

## [1.0.30] - 2026-03-23

### Added

- **IPC `focus_window` message**: Add `focusWindow` IPC message type and handler to bring the Unity Editor window to the foreground; on Windows uses `AttachThreadInput` + `SetForegroundWindow` to bypass foreground-switch restrictions; on macOS uses `osascript` to activate the process by PID

### Fixed

- **`execute-csharp-script` Assembly-CSharp.dll lock**: Switch Roslyn assembly references from in-process `Assembly` objects to `MetadataReference.CreateFromFile`; shadow-copy `Assembly-CSharp` and `Assembly-CSharp-Editor` to a versioned temp directory (`CodelyScriptRefs`) so the originals are never locked during script compilation; automatically clean up stale shadow copies on each run

## [1.0.29] - 2026-03-20

### Added

- **WebView persistence across domain reloads**: Keep webview alive by storing the native browser window handle (`_serializedWebView2Handle`) and validity flag as serialized fields; add set-callback methods to re-bind C# callbacks after assembly reload (`NativeBrowserAPI`, `WebView2Host`)

### Changed

- **CodelyToolbar**: Rename `TcpBridgeToolbar` -> `CodelyToolbar` and wire toolbar button to `CodelyWindow.FocusOrOpenWindow` instead of `TcpBridgeControlWindow.ShowWindow`

### Fixed

- Fix `Editor/Bridge/Icons/app.png.meta` GUID and remove stale Server platform texture settings
- Skip `MeshFilter.mesh` access in `GameObjectSerializer` to avoid instantiating a new mesh and causing unintended side effects
- Remove unused function in `CodelyWindow`
- Exclude Tauri-specific code on Linux with platform compile guards

## [1.0.28] - 2026-03-17

### Added

- **WebView persistence across domain reloads**: Keep webview alive by storing the native browser window handle (`_serializedWebView2Handle`) and validity flag as serialized fields; add set-callback methods to re-bind C# callbacks after assembly reload (`NativeBrowserAPI`, `WebView2Host`)

### Changed

- **CodelyToolbar**: Rename `TcpBridgeToolbar` → `CodelyToolbar` and wire toolbar button to `CodelyWindow.FocusOrOpenWindow` instead of `TcpBridgeControlWindow.ShowWindow`

### Fixed

- Fix `Editor/Bridge/Icons/app.png.meta` GUID and remove stale Server platform texture settings
- Skip `MeshFilter.mesh` access in `GameObjectSerializer` to avoid instantiating a new mesh and causing unintended side effects
- Remove unused function in `CodelyWindow`
- Exclude Tauri-specific code on Linux with platform compile guards

## [1.0.27] - 2026-03-13

### Added

- Add meta files: `Editor\Bridge\fonts\NotoSans-Regular.ttf.meta`, `Editor\Bridge\Icons\setup_download.png.meta`, `Editor\Bridge\Icons\setup_main.png.meta`

## [1.0.26] - 2026-03-13

### Added

- **Download Codely page** and new menu items
- Setup window assets: `setup_download.png`, `setup_main.png` (Editor/Bridge/Icons)
- Noto Sans Regular font for setup UI (Editor/Bridge/fonts/NotoSans-Regular.ttf)

### Changed

- CodelyWindow and DrillWindow updates for download/setup flow and new menu entries
- TcpBridgeControlWindow minor update

## [1.0.25] - 2026-03-10

### Added

- **Codely setup flow**
  - Add setup window (CodelySetupWindow) to guide users when Codely is not installed; includes download link and "重新检测" (re-detect) button
  - Resolve `CODELY_HOME` without Unity restart: read from Windows registry (user/system) and macOS login shell when process env is not set
- **Drill / Tauri server management**
  - Add detach/attach mode and replace previous drill mode
  - Introduce `DrillWindow` for Tauri server management
  - Add drill walkthrough check in CodelyWindow and `DrillCompleted` event

### Changed

- Rename **codely-tauri** to **codely-app** (executable and references)
- Use **CODELY_APP_HOME** instead of **CODELY_HOME** as the app home environment variable
- Optimize `GetCodelyRunnable` logic
- Update UI to show multiple connection status for the same platform

### Fixed

- Try to dock Codely window to any existing editor window when embedding fails
- Fix `Editor/Tauri/CodelyWindow.cs.meta` GUID issue

## [1.0.24] - 2026-03-03
### Changed

- Meged Codely and Codely Bridge into one package
- Update cicd pipeline to build package into dll
- Add `AI` toolbar button to open Codely Window 


## [1.0.23] - 2026-02-25

### Changed

- **UI**
Codely bridge 页面改版

## [1.0.22] - 2026-02-11

### Enhanced

- **ExecuteCSharpScript**
  - Added Unity.InputSystem assembly support for C# script execution
  - Scripts can now access Input System types and APIs when the package is installed

## [1.0.21] - 2026-02-06

### Changed

- **Batch Operations Refactoring**
  - Split generic `batch` action into two distinct operations: `create_batch` for write-only deterministic sequences and `edit_batch` for search-then-write edits
  - Added `HandleCreateBatch` method for write-only deterministic batch operations
  - Added `HandleEditBatch` method for search-then-write batch operations with captureAs support
  - Improved code clarity and prevented mixed read/write batch states
  - Maintained parity with TypeScript client schema
  - Added backward compatibility aliases for snake_case to camelCase parameters
  - Updated ValidActions list to include new batch operation types
  - Updated writeActions array to include new batch operations for state validation

### Enhanced

- **ManageAsset**
  - Enhanced batch operation handling with clearer separation of concerns
  - Improved parameter naming consistency with backward compatibility support

- **ManageGameObject**
  - Enhanced batch operation handling with clearer separation of concerns
  - Improved parameter naming consistency with backward compatibility support

### Test Coverage

- Updated `unity_asset_full_coverage.md` to reflect new batch operations
- Updated `unity_gameobject_full_coverage.md` to reflect new batch operations
- Updated `unity_workflow_full_coverage.md` with refined batch operation workflows
- Updated `Tests/Coverage/README.md` documentation


## [1.0.20] - 2026-02-05

### Fixed

- **TCP Port Management on macOS**
  - Disabled ReuseAddress socket option on macOS in PortManager.cs


## [1.0.19] - 2026-02-04

### Fixed

- **TCP Port Management on macOS**
  - Disabled ReuseAddress socket option on macOS to prevent multiple Unity instances from listening on the same port
  - Ensures proper port exclusivity across Unity Editor instances


## [1.0.18] - 2026-02-04

### Fixed

- **TCP Connection Reliability**
  - Add LingerState to test listener to send RST on close (same as actual listener)
  - Increase immediate retry attempts from 3 to 5
  - Increase retry sleep time from 75ms to 150ms
  - Extend wait time on Windows from 100ms to 500ms to allow TCP port full release


## [1.0.17] - 2026-02-03

### Fixed

- **Revert IPV6 Loopback Support**


## [1.0.16] - 2026-02-03

### Added

- **C# Script Execution**
  - New `ExecuteCSharpScript` tool for executing arbitrary C# code at runtime using Microsoft.CodeAnalysis.CSharp.Scripting (Roslyn compiler services)
  - Captures and returns Unity console logs during script execution
  - Supports custom using directives and assembly references
  - Enables dynamic C# code execution without requiring editor restart or recompilation
  - Added bundled Roslyn assemblies: `Codely.Microsoft.CodeAnalysis.dll`, `Codely.Microsoft.CodeAnalysis.CSharp.dll`, `Codely.Microsoft.CodeAnalysis.Scripting.dll`, `Codely.Microsoft.CodeAnalysis.CSharp.Scripting.dll`
  - Added supporting assemblies: `Codely.System.Collections.Immutable.dll`, `Codely.System.Reflection.Metadata.dll`, `Codely.System.Runtime.CompilerServices.Unsafe.dll`

### Fixed

- **UnityTcpBridge**
  - Reverted accidental handshake string change that broke package functionality (changed from incorrect 'WELCOME UNITY-TCP 1 FRAMING=1' back to correct 'WELCOME Codely-Bridge 1 FRAMING=1')
- **Add IPV6 Loopback Support**

### Changed

- **Branding & Menu Structure**
  - Renamed "Unity TCP" to "Codely Bridge" across logging and port management
  - Simplified menu structure: removed redundant menu items and kept only "Window/Codely Bridge/Control Window"
  - Updated menu organization for better user experience

- **CI/CD**
  - Updated register_version job rules in CI pipeline

## [1.0.15] - 2026-01-29

### Changed

- **ManageScreenshot**
  - Simplified screenshot API: removed redundant `capture_game_view` action; its behavior is now covered by the unified `capture` action
  - `capture` action now consistently uses GameView reflection to capture what the user sees in both edit and play modes
  - Removed redundant `FlipTextureVertically` call and related comments for clearer, more maintainable code

- **Package Publishing**
  - Updated `.npmignore` to include `Tests/` directory in the published npm package so consumers can run and extend the test suite

### Fixed

- **Screenshot Capture**
  - Fixed vertical flip of textures captured from RenderTexture so screenshots match on-screen orientation

### Test Coverage

- Updated `unity_screenshot_full_coverage.md` and `Tests/Coverage/README.md` to reflect the simplified screenshot API and current test structure

## [1.0.14] - 2026-01-22

### Changed

- **Dependency Management**
  - Swapped to bundled `Codely.Newtonsoft.Json.dll` in `Plugins/` directory instead of external `Newtonsoft.Json` package
  - Removed external `Newtonsoft.Json` dependency from `package.json`
  - Updated all code references to use bundled Newtonsoft.Json assembly

- **Architecture**
  - Moved runtime implementation code from `Runtime/` to `Editor/` scope to align with Unity usage patterns

### Added

- **Package Publishing**
  - Added `.npmignore` file to exclude unwanted files from npm publication
  - Excludes CI/CD configuration, build artifacts, Git metadata, IDE files, and test directories
  - Ensures only essential code and documentation are published to npm registry

- **CI/CD Pipeline**
  - Added automated npm pack and TOS (Tencent Object Storage) upload steps to deployment pipelines
  - Added backup version (1.0.0) upload for both staging and production environments
  - Improved deployment reliability with fallback version availability

## [1.0.13] - 2026-01-20

### Fixed

- **Test Assembly Dependencies**
  - Fixed missing `Newtonsoft.Json.dll` reference in `UnityTcp.Editor.Tests.asmdef`
  - Added `com.unity.ext.nunit` package dependency to `package.json` for proper NUnit framework support
  - Ensures test assembly can properly reference required dependencies for compilation

## [1.0.12] - 2026-01-19

### Added

- **ManageGameObject**
  - Added `list_children` action for listing GameObject children with configurable depth
  - Support for three result modes: `auto` (default), `inline`, and `file`
  - Automatic fallback to file output when hierarchy exceeds `maxInlineItems` threshold (default: 200)
  - Depth-limited traversal with `depth` parameter (default: 1 for direct children)
  - `includeInactive` parameter to control whether inactive GameObjects are included
  - Iterative tree building to avoid stack overflow on deep hierarchies
  - JSON streaming to file for large results to prevent memory issues
  - New helper methods: `CountDescendantsUpToDepth`, `BuildChildrenTreeIterative`, `WriteChildrenTreeIterative`

### Enhanced

- **ManageScene**
  - Improved large scene hierarchy handling (>500 GameObjects)
  - Returns shallow root-only tree with hints instead of error when scene is too large
  - Changed `CountGameObjectsRecursive` to use iterative traversal (stack-based) to avoid stack overflow on deep hierarchies
  - Better user guidance for drilling down into large hierarchies incrementally

- **Coverage Tools**
  - Added `CodelyUnityCoverageTools` class for E2E test utilities
  - New `codely.generate_large_hierarchy` custom tool for quickly generating test hierarchies
  - Configurable generation parameters: root name, child/grandchild prefixes, and counts

### Test Coverage

- Added `unity_large_hierarchy_e2e_coverage.md` with 152 lines of E2E test scenarios for large hierarchy handling
- Updated `unity_gameobject_full_coverage.md` with `list_children` action coverage
- Updated `unity_scene_full_coverage.md` with improved large scene handling coverage

## [1.0.11] - 2026-01-13

### Added

- **Tuanjie Editor Scene File Support**
  - Added support for `.scene` file extension used by Tuanjie Editor
  - Implemented extension-aware scene path handling in `ManageScene`
  - Support both `.unity` (Unity Editor) and `.scene` (Tuanjie Editor) extensions based on editor type

### Enhanced

- **UnityStateDirtyHook**
  - Added `.scene` extension detection for scene file change tracking
  - Ensures proper state tracking for both Unity and Tuanjie editor scene files

- **Documentation**
  - Improved documentation for scene file extension handling

## [1.0.10] - 2026-01-12

### Fixed

- **ManageGameObject**
  - Updated default behavior for `searchInactive` parameter from `false` to `true`
  - Ensures inactive GameObjects are included in search results unless explicitly specified otherwise

- **UnityEngineObjectConverter**
  - Added support for `{"find":"...", "method":"..."}` reference format in object deserialization
  - Fixed deserialization errors when encountering find instruction format used by MCP tools for dynamic GameObject lookups
  - Implemented delegate pattern to call `ManageGameObject.FindObjectByInstruction` from Runtime assembly without direct Editor assembly reference

## [1.0.9] - 2026-01-05

### Changed

- **Unity Project Metadata**
  - Updated Unity project metadata GUIDs across all .meta files
  - Refreshed GUIDs in Editor, Runtime, and Tests directories

## [1.0.8] - 2025-12-16

### Enhanced

- **Compilation Tracking**
  - Improved compilation error/warning count tracking with nullable integers
  - Changed `CompilationHelper.GetCompilationErrors()` and `GetCompilationWarnings()` to return `int?` instead of `int`
  - Updated `GetCompilationSummary()` to only include known values in result (removes misleading default 0 values)
  - Enhanced compilation result handling in `ManageEditor` to properly process nullable values
  - Improved type handling for compilation result payloads (supports both dictionary and anonymous object formats)
  - Added clarifying comments explaining why returning 0 for unknown counts is problematic
  - Better distinction between "0 errors/warnings" (validated) vs "unknown count" (not yet validated)

## [1.0.7] - 2025-12-15

### Changed

- **Package Renaming**
  - Renamed package from `com.unity.codely` to `cn.tuanjie.codely.bridge`
  - Updated all internal references and documentation to reflect new package name

- **Branding Update**
  - Renamed all menu item paths and labels in the Unity Editor

## [1.0.6] - 2025-12-10

### Added

- **Compilation Pipeline**
  - New `pipeline_kind: "compile"` field for structured hints to downstream tools
  - `requires_console_validation: true` flag to guide compilation validation
  - Comprehensive integration test documentation for compilation pipeline policy
  - Enhanced play mode state synchronization with `playMode` field in responses

### Enhanced

- **StateComposer**
  - Simplified state reporting to focus on essential information (compiling vs idle)
  - Minimized state complexity with clear documentation directing users to specific diagnostic tools

- **ManageAsset**
  - Improved `AssetExists` method with ghost asset detection
  - New `BuildAssetNotFoundResponse` for better error messaging about desync issues
  - Enhanced asset validation and error handling

- **Test Coverage**
  - Added `unity_compile_pipeline_integration.md` with 152 lines of comprehensive test scenarios
  - Updated `unity_editor_full_coverage.md` with compilation pipeline requirements

## [1.0.5] - 2025-12-04

### Added

- **Test Coverage**
  - Added comprehensive test coverage for `ExecuteCustomTool` functionality
  - UI Toolkit tools test coverage documentation and validation

### Enhanced

- **ManageUIToolkit**
  - Enhanced `link_uss_to_uxml` action with GUID support
  - Added `ResolveAssetPath` helper method for flexible path/GUID resolution
  - Improved parameter validation for mixed path/GUID usage

- **ManageShader**
  - Enhanced `ensure_material_shader_for_srp` action with `material_guid` parameter support
  - Improved parameter handling for material identification via path or GUID
  - Better error messages for missing material parameters

- **CodelyUnityValidationTools**
  - Added nested field path support in `validate_response`
  - Support for dot-notation field paths (e.g., "state.project.srp", "project.srp")
  - Automatic recursive field search when direct path fails
  - Enhanced field validation with path tracking and debugging

- **ManageBake**
  - Refactored NavMesh operations to use runtime reflection
  - Improved AI Navigation package detection and type resolution
  - Better compatibility with optional AI Navigation package installation
  - Enhanced error handling for missing package scenarios

## [1.0.4] - 2025-12-03

### Added

- **Validation Tools Framework**
  - New `CodelyUnityValidationTools`: 15+ validation helpers for automated testing
  - `codely.validate_play_mode`: Validate current editor PlayMode state
  - `codely.validate_active_tool`: Validate current active editor tool
  - `codely.validate_not_compiling`: Ensure editor is not compiling
  - `codely.validate_tag_and_layer_exist`: Verify Tag/Layer existence
  - `codely.validate_window_open`: Check editor window state
  - `codely.validate_console_contains`: Validate console messages with filter
  - `codely.validate_console_count`: Verify console message counts
  - `codely.validate_active_scene`: Validate active scene properties
  - `codely.validate_scene_dirty`: Check scene dirty state
  - `codely.validate_hierarchy_root_count`: Verify hierarchy root object count
  - `codely.validate_gameobject_exists`: Check GameObject existence
  - `codely.validate_response`: Generic response validation

- **Compilation Pipeline**
  - `CompilationHelper`: New helper class for compilation status checking and error tracking
  - `start_compilation_pipeline` action in ManageEditor for standardized compile workflow
  - Block compilation during play mode to prevent editor errors

- **Test Coverage Documentation**
  - Complete test coverage specs for all Unity tools
  - `unity_editor_full_coverage.md`: 24 actions coverage
  - `unity_console_full_coverage.md`: Console operations coverage
  - `unity_scene_full_coverage.md`: Scene management coverage
  - `unity_gameobject_full_coverage.md`: GameObject operations coverage
  - `unity_asset_full_coverage.md`: Asset management coverage
  - `unity_script_full_coverage.md`: Script management coverage
  - `unity_shader_full_coverage.md`: Shader operations coverage
  - `unity_package_full_coverage.md`: Package manager coverage
  - `unity_menu_full_coverage.md`: Menu execution coverage

### Enhanced

- **State Management**
  - State delta tracking added to async operation responses
  - Internal state publish tracking for write operations
  - Enhanced console state tracking with `since_token` filtering

- **ManageEditor**
  - Idempotent `ensure_tag` and `ensure_layer` operations
  - Extended with compilation pipeline integration

- **ManageAsset**
  - Enhanced robustness with better error handling

- **ManageGameObject**
  - Improved serialization with `GameObjectSerializer` enhancements

- **ReadConsole**
  - Enhanced filtering with `since_token` support for incremental reads

- **ExecuteCustomTool**
  - Improved tool registry with better parameter validation

### Fixed

- Improved Unity version compatibility across various tools

## [1.0.3] - 2025-12-01

### Added

- **State Management System**
  - `AsyncOperationTracker`: Comprehensive async operation management with progress tracking and cancellation support
  - `StateComposer`: Full Unity state composition including scene, project, packages, and shaders
  - `UnityStateDirtyHook`: Automatic tracking of Unity Editor state changes (hierarchy, project, selection, console)
  - `WriteGuard`: Thread-safe write operation protection with main thread enforcement
  - New `get_current_state` endpoint for retrieving complete Unity state snapshots

- **New Unity Tools**
  - `ManageBake`: Light baking controls (start, cancel, clear, status queries)
  - `ManagePackage`: Package manager operations with version pinning support (package@version syntax)
  - `ManageUIToolkit`: UI Toolkit template instantiation with automatic USS/C# generation

- **Custom Tool Execution Framework**
  - `ExecuteCustomTool`: Reflection-based tool discovery and execution via `[CustomTool]` attribute
  - Automatic tool registry with parameter validation and error handling
  - Support for custom tools without modifying CommandRegistry

- **Enhanced Existing Tools**
  - `ManageEditor`: Extended with state-aware operations and full state retrieval
  - `ManageGameObject`: Added find, query, parent/child operations, and component management
  - `ManageAsset`: New asset import, export, and metadata operations
  - `ManageScene`: Enhanced with scene creation and multi-scene management
  - `ManageShader`: Expanded with shader compilation, variant queries, and global property management
  - `ReadConsole`: Added scope-based console clearing and entry filtering

### Enhanced

- **Response Helpers**: New state-aware methods (`SuccessWithDelta`, `SuccessWithState`, `Conflict`) for better change tracking
- **CompilationHelper**: Improved compilation workflow handling with better async integration
- **Test Coverage**: Added unit tests for `AsyncOperationTracker`, `StateComposer`, and `WriteGuard`

## [1.0.2] - 2025-11-11

### Fixed

- **Unity Version Compatibility**: Added conditional compilation in `ManageGameObject.cs`
  - Uses `FindObjectsByType` with `FindObjectsInactive` enum for Unity 2022.2+
  - Falls back to `FindObjectsOfType` for Unity 2021.3 and earlier
  - Resolves CS0246 error: `FindObjectsInactive` type not found on Unity 2021
  - Maintains backward compatibility across Unity versions

## [1.0.1] - 2025-11-07

### Fixed

- 🐛 **Fixed build compilation error**
  - Corrected assembly definition configuration for `UnityTcp.Editor.asmdef`
  - Changed from platform exclusion list to explicit Editor platform inclusion
  - Ensures Editor assembly only compiles in Unity Editor, not in game builds
  - Resolves compilation errors during game packaging for all platforms

## [1.0.0] - 2024-12-19

### Major Refactoring

- 🔄 **Complete removal of MCP (Model Context Protocol) logic**
  - Removed all MCP-specific components, tools, and protocol handling
  - Eliminated MCP server integration and HTTP server components
  - Removed MCP client models, configuration systems, and UI windows

### New TCP-Focused Architecture

- 🚀 **Pure TCP Socket Implementation**
  - New `UnityTcpBridge` class for TCP server management
  - Basic echo server implementation as starting point
  - Async/await patterns for non-blocking operations
  - Multi-client connection support with proper resource management

### Core TCP Features

- **Port Management**
  - Automatic port discovery and allocation
  - Project-specific port persistence
  - Smart port conflict resolution
  - Cross-platform compatibility

- **Connection Handling**
  - TCP listener with automatic client acceptance
  - Configurable socket options (keep-alive, timeouts)
  - Graceful connection cleanup on shutdown
  - Unity lifecycle integration (assembly reload, editor quit)

### Updated Components

- **Renamed Assemblies**: `UnityTcp.*` → `UnityTcp.*`
- **Updated Namespaces**: All classes moved to `UnityTcp.Editor.*` namespace
- **Simplified Helpers**: Kept only TCP-relevant utilities (PortManager, TcpLog)
- **Package Rebranding**: Updated from "Unity MCP" to "Unity TCP Bridge"

### Removed Components

- All MCP protocol handling and message processing
- MCP tool implementations (ManageScript, ManageAsset, etc.)
- MCP UI windows and editor integrations
- HTTP server and MCP server management
- Telemetry and MCP-specific logging
- Configuration builders and MCP client models

### Technical Details

- **Architecture**: Direct TCP socket server with customizable protocol handling
- **Performance**: Lightweight implementation focused on TCP networking
- **Compatibility**: Unity 2021.3+ with Newtonsoft.Json dependency
- **Protocol**: Basic TCP with welcome handshake (easily customizable)

### Migration Guide

This is a breaking change that removes all MCP functionality:

1. **Previous MCP Users**: This package no longer provides MCP integration
2. **TCP Socket Users**: Replace any `UnityTcpBridge` references with `UnityTcpBridge`
3. **Custom Protocols**: Implement your protocol logic in `HandleClientAsync` method
4. **Port Management**: Use `PortManager` for dynamic port allocation needs

### Development Notes

- Codebase reduced by ~80% by removing MCP complexity
- Focus shifted to providing a clean TCP socket foundation
- Easy to extend for custom networking protocols
- Maintains Unity Editor integration for automatic lifecycle management

## Previous Versions

Previous versions (1.x.x) included MCP (Model Context Protocol) integration which has been completely removed in this version.