@harness-mix/cli 0.1.7 → 0.1.9

package/src/assets/skins/codex-styler/ASSET_LICENSES.md

@@ -0,0 +1,36 @@
+# Asset licenses
+
+Original artwork shipped in the built-in Codex Styler themes is distributed
+under Creative Commons Attribution 4.0 International (CC BY 4.0).
+
+| Asset                                                  | Origin                                                                                                                                                    |                                             Dimensions | License                                   |
+| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------: | ----------------------------------------- |
+| Codex Styler CS orbit logo, dark and light appearances | Generated specifically for this project, 2026-07-16                                                                                                       | 1254×1254 sources; platform exports generated by Tauri | CC BY 4.0                                 |
+| Nocturne Studio background                             | Generated specifically for this project, 2026-07-16                                                                                                       |                                              1600×1000 | CC BY 4.0                                 |
+| Quiet Garden background                                | Generated specifically for this project, 2026-07-16                                                                                                       |                                              1600×1000 | CC BY 4.0                                 |
+| Gilded Grandeur background                             | Generated specifically for this project with the built-in image generation workflow, 2026-07-17                                                           |                                               1586×992 | CC BY 4.0                                 |
+| Merry Big Top background                               | Generated specifically for this project with the built-in image generation workflow, 2026-07-17                                                           |                                               1586×992 | CC BY 4.0                                 |
+| Moss chameleon calibrated direction atlas              | Generated specifically for this project; non-linear direction calibration, shared cropping, chroma-key removal, and exact-alpha WebP encoding, 2026-07-16 |                              181 frames across 4 pages | CC BY 4.0                                 |
+| Pico parrot calibrated direction atlas                 | Generated specifically for this project; natural pose frames retained, background and watermark excluded, 2026-07-17                                      |                              189 frames across 4 pages | CC BY 4.0                                 |
+| Puddle frog calibrated direction atlas                 | Generated specifically for this project; natural pose frames retained, non-linear direction calibration, background and watermark excluded, 2026-07-17    |                              211 frames across 5 pages | CC BY 4.0                                 |
+| Mochi cat calibrated direction atlas                   | Generated specifically for this project; adaptive matte, shared ground line, and seamless loop closure, 2026-07-17                                        |                              175 frames across 4 pages | CC BY 4.0                                 |
+| Token Thief calibrated direction atlas                 | User-provided generated video; dual-corner watermark exclusion, gray-speck cleanup, shared ground line, and non-linear direction calibration, 2026-07-17  |                              101 frames across 3 pages | CC BY 4.0                                 |
+| Reset God calibrated direction atlas                   | User-provided generated video; dual-corner watermark exclusion, gray-speck cleanup, shared ground line, and non-linear direction calibration, 2026-07-17  |                              100 frames across 3 pages | CC BY 4.0                                 |
+| README and desktop companion portraits                 | Representative frames derived from the six calibrated direction atlases; exact cell crop, normalized transparent canvas, and alpha cleanup, 2026-07-17    |                                    6 images at 480×480 | CC BY 4.0                                 |
+| Codex Styler manager screenshots                       | Captured from the English manager UI in matching light and dark appearances, 2026-07-17                                                                   |                                   2 images at 1320×840 | CC BY 4.0                                 |
+| Composer game object set                               | Generated specifically for Triple Drop, Capsule Crane, and Mission Map; chroma-key removal and lossless-alpha WebP encoding, 2026-07-20                   |                        4 transparent images at 160×160 | CC BY 4.0                                 |
+| Composer Interactions documentation screenshots        | Captured from the English manager and a live local Codex configuration session, 2026-07-20                                                                |                       1280×720 and 1474×538 WebP files | Documentation evidence; Codex UI excluded |
+| Companion Creator H.264 test fixture                   | Synthetic half-second color-frame video generated specifically for local media decoding and E2E regression tests, 2026-07-17                              |                               160×90, 12 fps, 6 frames | CC BY 4.0                                 |
+
+No source code, image, video, sprite, logo, or other asset from
+Fei-Away/Codex-Dream-Skin or xplol/KaMenisACat is redistributed by this
+repository. Those projects are implementation and style references only.
+
+Documentation screenshots of themes applied to Codex Desktop are included to
+demonstrate compatibility. Original Codex interface elements, product names,
+and trademarks visible in those screenshots remain the property of their
+respective owners and are not relicensed by this project. Codex Styler theme
+artwork and companion artwork remain covered by the project asset license.
+
+Asset dimensions, frame order, and replacement guidance are recorded in
+[docs/assets-and-replacement.md](docs/assets-and-replacement.md).

package/src/assets/skins/codex-styler/NOTICE

@@ -0,0 +1,11 @@
+Codex Styler
+Copyright 2026 Codex Styler contributors
+
+Codex Styler is an independent, unofficial project. It is not affiliated
+with, endorsed by, or sponsored by OpenAI.
+
+OpenAI and Codex are trademarks of OpenAI, L.L.C. Their names are used only
+to describe compatibility with the OpenAI Codex Desktop application.
+
+Third-party dependency notices and the release inventory policy are recorded
+in THIRD_PARTY_NOTICES.md.

package/src/assets/skins/heige/ASSET_PROVENANCE.md

@@ -0,0 +1,56 @@
+# 视觉素材来源与再分发状态
+
+本表记录当前仓库能够证明的事实与项目所有者作出的发布决定。Git 历史能证明文件何时进入仓库，不能单独证明原始作者、生成工具、授权链或再分发许可。
+
+`node scripts/check-asset-provenance.mjs --check` 校验清单完整性。公开发布前必须运行 `node scripts/check-asset-provenance.mjs --release`；它接受「已验证可公开再分发」或「项目所有者确认公开发布」两种状态。后者表示项目所有者在知悉来源记录边界后明确接受公开发布风险，不等同于第三方法律意见或商业授权证明。
+
+2026-07-17，项目所有者确认当时清单中的视觉素材可以随 `v5.2.1` 公开发布。2026-07-18，项目所有者提供两张当前 Mac 的 Codex 真机截图，并明确要求更新到 GitHub 项目介绍区；同日提供两张悟空主题生成图，明确要求制作成内置预设并公开发布。2026-08-11，项目所有者提供一张当前 Mac 的 WorkBuddy 真机截图（Miku 488137 主题），并明确要求补充到 GitHub 项目介绍区开头。2026-08-23，项目所有者提供一张 HeiGe 皮肤启动器 5.5.15 真机截图，并明确要求放入 GitHub 介绍页面作为更新声明。后续新增素材仍须逐项登记，未经验证或所有者确认的状态继续阻断 Release。
+
+| 仓库路径 | 用途 | 已知创建或来源证据 | 已知许可 | 再分发状态 | 替换行动 |
+| --- | --- | --- | --- | --- | --- |
+| `assets/miku-character.png` | Miku 主题角色图层 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `assets/launcher/miku-launcher-icon.png` | macOS 启动器图标母版 | 2026-08-19 按项目所有者要求，以 `assets/miku-character.png` 为参考经图像生成工具编辑衍生 | 未知，继承角色源图未验证的授权状态 | 项目所有者确认公开发布 | 公开分发前补齐角色及源图授权，或替换为原创素材 |
+| `assets/launcher/AppIcon.icns` | macOS 启动器 Bundle 图标 | 2026-08-19 由 `assets/launcher/miku-launcher-icon.png` 的标准尺寸 iconset 确定性衍生 | 未知，继承图标母版与角色源图未验证的授权状态 | 项目所有者确认公开发布 | 与图标母版同步替换或补齐权利记录 |
+| `assets/launcher/LauncherLogo.png` | macOS 启动器窗口内置 Logo | 2026-08-21 按项目所有者要求，以 `assets/miku-character.png` 中的核心人物为参考，经图像生成工具重构为正方形上半身构图 | 未知，继承角色源图未验证的授权状态 | 项目所有者确认公开发布 | 公开分发前补齐角色及源图授权，或替换为原创素材 |
+| `assets/miku-full-canvas.png` | Miku 主题完整画布 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `assets/miku-hero.png` | Miku 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `assets/miku-polaroid.png` | Miku 主题拍立得装饰 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `assets/miku-portrait-reference.png` | Miku 主题肖像参考 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐可核验来源或替换 |
+| `assets/miku-reference.png` | Miku 主题构图参考 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐可核验来源或替换 |
+| `assets/miku-sidebar-wash.png` | Miku 主题侧栏纹理 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `assets/previews/genshin-impact-codex-ui-1.webp` | Genshin 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/genshin-impact-codex-ui-2.webp` | Genshin 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/love-and-deepspace-codex-ui-1.webp` | Love and Deepspace 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/love-and-deepspace-codex-ui-2.webp` | Love and Deepspace 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/miku-studio.webp` | Miku Studio 预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/naruto-codex-ui-1.webp` | Naruto 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/naruto-codex-ui-2.webp` | Naruto 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/wuthering-waves-codex-ui-1.webp` | Wuthering Waves 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `assets/previews/wuthering-waves-codex-ui-2.webp` | Wuthering Waves 预设预览 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补齐来源记录或替换预览 |
+| `custom-pet/miku-future/spritesheet.webp` | Miku 宠物精灵图 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的精灵图 |
+| `docs/images/appearance-theme-contrast.jpg` | 外观主题配色设置说明截图 | 仓库标注为运行截图，但原始采集与画面权利记录缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充自有截图与来源记录 |
+| `docs/images/dalao-live.jpg` | 大佬点烟主题运行截图 | 仓库标注为运行截图，但原始采集与画面权利记录缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充自有截图与来源记录 |
+| `docs/images/genshin-dawn-live.jpg` | Genshin Dawn 运行截图 | 仓库标注为运行截图，但原始采集与画面权利记录缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充自有截图与来源记录 |
+| `docs/images/genshin-night-live.jpg` | Genshin Night 运行截图 | 仓库标注为运行截图，但原始采集与画面权利记录缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充自有截图与来源记录 |
+| `docs/images/macos-launcher-5.5.15-live.webp` | HeiGe 皮肤启动器 5.5.15 真机截图 | 项目所有者于 2026-08-23 提供当前 Mac 启动器 PNG，并明确要求发布到 GitHub 介绍页面作为更新声明；仓库保存压缩 WebP | 截图内第三方角色、标识及应用图标的权利不随截图转移 | 项目所有者确认公开发布 | 保留原始截图与本条提供记录 |
+| `docs/images/theme-center-live.webp` | HeiGe 主题中心运行截图 | 项目所有者于 2026-07-18 提供当前 Mac 真机 PNG，并明确要求发布到 GitHub；仓库保存压缩 WebP | 截图内第三方角色、标识及界面元素的权利不随截图转移 | 项目所有者确认公开发布 | 保留原始截图与本条提供记录 |
+| `docs/images/theme-switcher-live.webp` | Miku 主题及顶部切换入口运行截图 | 项目所有者于 2026-07-18 提供当前 Mac 真机 PNG，并明确要求发布到 GitHub；仓库保存压缩 WebP | 截图内第三方角色、标识及界面元素的权利不随截图转移 | 项目所有者确认公开发布 | 保留原始截图与本条提供记录 |
+| `docs/images/wechat-group-qr.png` | 微信交流群二维码 | 项目所有者于 2026-07-18 提供当前个人微信二维码 PNG，并明确要求替换 GitHub 项目介绍图片 | 个人头像、昵称及二维码由项目所有者提供 | 项目所有者确认公开发布 | 保留本条提供记录；二维码失效时及时替换 |
+| `docs/images/workbuddy-miku-live.webp` | WorkBuddy 换肤运行截图（Miku 488137 主题） | 项目所有者于 2026-08-11 提供当前 Mac WorkBuddy 真机 PNG，并明确要求补充到 GitHub 项目介绍区开头；仓库保存压缩 WebP | 截图内第三方角色、标识及界面元素的权利不随截图转移 | 项目所有者确认公开发布 | 保留原始截图与本条提供记录 |
+| `docs/images/wuthering-live.jpg` | Wuthering Waves 主题运行截图 | 仓库标注为运行截图，但原始采集与画面权利记录缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充自有截图与来源记录 |
+| `themes/dalao-dianyan/hero.webp` | Dalao Dianyan 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充人物及图像权利记录 |
+| `themes/deepspace-dawn/hero.webp` | Deepspace Dawn 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/deepspace-star/hero.webp` | Deepspace Star 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/dragonball-nimbus/hero.webp` | 龙珠筋斗云主题主视觉 | 项目所有者于 2026-07-18 提供生成 PNG，并明确要求制作预设后公开发布；仓库保存压缩 WebP | 画面含第三方角色形象，项目未取得可独立核验的第三方授权文件 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的原创角色素材 |
+| `themes/dragonball-super-saiyan/hero.webp` | 龙珠超级赛亚人主题主视觉 | 项目所有者于 2026-07-18 提供生成 PNG，并明确要求制作预设后公开发布；仓库保存压缩 WebP | 画面含第三方角色形象，项目未取得可独立核验的第三方授权文件 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的原创角色素材 |
+| `themes/genshin-dawn/hero.webp` | Genshin Dawn 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/genshin-night/hero.webp` | Genshin Night 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/miku-488137/hero.webp` | Miku 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/miku-488137/logo.webp` | Miku 主题 Logo | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充标识来源或替换 |
+| `themes/miku-488137/polaroid.webp` | Miku 主题拍立得装饰 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/naruto-hokage/hero.webp` | Naruto Hokage 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/naruto-sasuke/hero.webp` | Naruto Sasuke 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/wuthering-echo/hero.webp` | Wuthering Echo 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+| `themes/wuthering-tide/hero.webp` | Wuthering Tide 主题主视觉 | 来源证据缺失，授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
+
+MIT 许可证只适用于软件代码，不自动改变第三方可能拥有的素材权利。项目所有者确认发布表示接受当前发布决定及其风险。新增、替换或删除图片后，必须运行 `node scripts/check-asset-provenance.mjs --check`，并在同一变更中同步本表。

package/src/assets/skins/heige/NOTICE.md

@@ -0,0 +1,13 @@
+# 软件许可、视觉素材与商标
+
+本仓库是非官方项目，与 OpenAI、Crypton Future Media、miHoYo/HoYoverse、Kuro Games、Shueisha、Papergames 及其合作方不存在隶属、认可或背书关系。
+
+MIT License 只覆盖本仓库的软件代码，不自动覆盖图片、角色设计、人物肖像、商标、截图或其他第三方内容。免责声明、「仅供学习」「非商业用途」「粉丝作品」「来自网络」或「AI 生成」等表述，不会产生授权，也不会替代原作者、肖像权人或商标权人的许可。
+
+当前视觉素材的逐项证据与处置状态见 `ASSET_PROVENANCE.md`。部分素材缺少完整来源记录，公开打包、Release 和再分发仍有发布风险。项目所有者已在知悉该边界后确认随 `v5.2.1` 公开发布；该确认不构成对第三方权利的法律判断。使用者在复制、修改或再次分发这些素材前，应自行评估并取得所需权利。
+
+Hatsune Miku（初音未来）、Genshin Impact（原神）、Wuthering Waves（鸣潮）、Naruto（火影忍者）、Love and Deepspace（恋与深空）及相关名称、角色设计和标识归各自权利人所有。提及这些名称只用于描述现有预设，不表示获得许可。
+
+## English summary
+
+The MIT License covers software code only. It does not grant permission to copy or redistribute bundled artwork, screenshots, likenesses, character designs, or trademarks. The project owner has explicitly accepted the documented provenance risk for the v5.2.1 public release. See `ASSET_PROVENANCE.md` before further redistribution.

package/src/assets/skins/heige/themes/dalao-dianyan/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "dalao-dianyan",
+  "name": "大佬 · 点烟",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 8 },
+  "colors": {
+    "accent": "#e09a52",
+    "secondary": "#9aa3b0",
+    "surface": "#111111",
+    "text": "#f2e8da"
+  }
+}

package/src/assets/skins/heige/themes/deepspace-dawn/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "deepspace-dawn",
+  "name": "恋与深空 · 晨曦",
+  "hero": "hero.webp",
+  "appearance": "light",
+  "previewFocus": { "x": 50, "y": 8 },
+  "colors": {
+    "accent": "#8f7fe8",
+    "secondary": "#f097c8",
+    "surface": "#f6f2fb",
+    "text": "#4a4668"
+  }
+}

package/src/assets/skins/heige/themes/deepspace-star/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "deepspace-star",
+  "name": "恋与深空 · 星辰",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 8 },
+  "colors": {
+    "accent": "#9d8bff",
+    "secondary": "#f097c8",
+    "surface": "#201a40",
+    "text": "#e8e2ff"
+  }
+}

package/src/assets/skins/heige/themes/dragonball-nimbus/theme.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "id": "dragonball-nimbus",
+  "name": "龙珠 · 筋斗云",
+  "hero": "hero.webp",
+  "appearance": "light",
+  "previewFocus": { "x": 72, "y": 24 },
+  "thumbnailFocus": { "x": 66, "y": 31 },
+  "thumbnailZoom": 350,
+  "colors": {
+    "accent": "#4FC3F7",
+    "secondary": "#F6C445",
+    "surface": "#F3F7FF",
+    "text": "#14213D"
+  }
+}

package/src/assets/skins/heige/themes/dragonball-super-saiyan/theme.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "id": "dragonball-super-saiyan",
+  "name": "龙珠 · 超级赛亚人",
+  "hero": "hero.webp",
+  "appearance": "light",
+  "previewFocus": { "x": 67, "y": 3 },
+  "thumbnailFocus": { "x": 67, "y": 15 },
+  "thumbnailZoom": 400,
+  "colors": {
+    "accent": "#F5C451",
+    "secondary": "#52C7F2",
+    "surface": "#FFF8E8",
+    "text": "#282033"
+  }
+}

package/src/assets/skins/heige/themes/genshin-dawn/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "genshin-dawn",
+  "name": "原神 · 晨曦",
+  "hero": "hero.webp",
+  "appearance": "light",
+  "previewFocus": { "x": 50, "y": 24 },
+  "colors": {
+    "accent": "#5b7fd6",
+    "secondary": "#e0aa3e",
+    "surface": "#f2f1fb",
+    "text": "#2c3a6b"
+  }
+}

package/src/assets/skins/heige/themes/genshin-night/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "genshin-night",
+  "name": "原神 · 星夜",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 17 },
+  "colors": {
+    "accent": "#e0b458",
+    "secondary": "#7a86d8",
+    "surface": "#171a2e",
+    "text": "#f0e6c8"
+  }
+}

package/src/assets/skins/heige/themes/miku-488137/theme.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "id": "miku-488137",
+  "name": "Miku 488137",
+  "hero": "hero.webp",
+  "appearance": "light",
+  "previewFocus": { "x": 50, "y": 33 },
+  "logo": "logo.webp",
+  "polaroid": "polaroid.webp",
+  "colors": {
+    "accent": "#19c9e5",
+    "secondary": "#ed6ec1",
+    "surface": "#f5f6fc",
+    "text": "#122c60"
+  }
+}

package/src/assets/skins/heige/themes/naruto-hokage/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "naruto-hokage",
+  "name": "火影 · 鸣人",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 27 },
+  "colors": {
+    "accent": "#f2801e",
+    "secondary": "#ffd166",
+    "surface": "#17110b",
+    "text": "#ffe3c2"
+  }
+}

package/src/assets/skins/heige/themes/naruto-sasuke/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "naruto-sasuke",
+  "name": "火影 · 佐助",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 24 },
+  "colors": {
+    "accent": "#d8443c",
+    "secondary": "#7fb3ff",
+    "surface": "#171019",
+    "text": "#ffd9d2"
+  }
+}

package/src/assets/skins/heige/themes/wuthering-echo/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "wuthering-echo",
+  "name": "鸣潮 · 共鸣",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 27 },
+  "colors": {
+    "accent": "#56e0d8",
+    "secondary": "#a98fe8",
+    "surface": "#16121f",
+    "text": "#e4def2"
+  }
+}

package/src/assets/skins/heige/themes/wuthering-tide/theme.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "id": "wuthering-tide",
+  "name": "鸣潮 · 声骸",
+  "hero": "hero.webp",
+  "appearance": "dark",
+  "previewFocus": { "x": 50, "y": 30 },
+  "colors": {
+    "accent": "#3fd6d0",
+    "secondary": "#9aa8b0",
+    "surface": "#0d1418",
+    "text": "#d8eef0"
+  }
+}

package/src/main/adapters/cline.js

@@ -0,0 +1,22 @@
+const { nativeAcp } = require('./native-acp');
+
+// Cline CLI 官方 ACP 入口：`cline --acp`（apps/cli/src/acp/acpAgent.ts）。
+// 已核对的协议事实（决定下面的诚实能力声明）：
+// - initialize 声明 loadSession: true、promptCapabilities.image: true；
+//   session/new 与 session/load 都返回 modes（plan/act）、models 与
+//   configOptions（provider/model/mode/autoApprove），并支持 session/set_model、
+//   session/set_mode、session/set_config_option → models / permissionModes /
+//   resume / attachments 为真。
+// - 事件投影只有 agent_message_chunk / agent_thought_chunk / tool_call /
+//   tool_call_update（rawOutput），没有 plan 条目、diff 内容块或 usage_update
+//   → plan / nativeDiff / usage / contextUsage 不声明。
+// - 审批走标准 session/request_permission（allow_once/allow_always/reject_once），
+//   没有独立提问请求 → questions 不声明（提问会作为审批选项出现）。
+// - configOptions 不含 effortLevel/thought_level → thinkingLevels 不声明。
+// - 无 session/fork 与 compact → fork / compaction 不声明。
+module.exports = nativeAcp({
+  id: 'cline', name: 'Cline', aliases: ['cline-cli'], args: ['--acp'],
+  capabilities: { questions: false, thinkingLevels: false, plan: false, nativeDiff: false },
+});
+// Cline Skills：项目 `.cline/skills/` 与全局 `~/.cline/skills/`（docs/customization/skills）。
+module.exports.manifest.integrations.skills = { global: ['.cline/skills'], project: ['.cline/skills'] };

package/src/main/adapters/codex.js

@@ -2,6 +2,7 @@ const { execFile } = require('node:child_process');
 const { CodexAppServer } = require('./codex-app-server');
 const { cliSpawn } = require('../host/jsonl');
 const { recordNative } = require('../harness-adapter/fixture-recorder');
+const { codexErrorInfoKey } = require('../harness-adapter/error-kind');
 
 const manifest = {
   id: 'codex',
@@ -203,10 +204,13 @@ function projectNotification(message, session, emit) {
     case 'configWarning':
       emit({ kind: 'notice', level: 'warning', text: params.message, nativeRef });
       break;
-    case 'error':
-      if (!params.willRetry) emit({ kind: 'error', message: params.error?.message ?? 'Codex 回合失败', nativeRef });
+    case 'error': {
+      // Codex 原生 CodexErrorInfo 随错误透传：分类与桌面原生错误 UX 都以它为准
+      const codexErrorInfo = codexErrorInfoKey(params.error?.codexErrorInfo);
+      if (!params.willRetry) emit({ kind: 'error', message: params.error?.message ?? 'Codex 回合失败', ...(codexErrorInfo ? { codexErrorInfo } : {}), nativeRef });
       else emit({ kind: 'status', text: `Codex 正在重试：${params.error?.message ?? '请求失败'}`, nativeRef });
       break;
+    }
     case 'turn/completed': {
       const turn = params.turn ?? {};
       if (turn.usage || params.usage) {
@@ -226,7 +230,7 @@ function projectNotification(message, session, emit) {
         break;
       }
       const failed = turn.status === 'failed';
-      if (failed) emit({ kind: 'error', message: turn.error?.message ?? 'Codex 回合失败', nativeRef: { ...nativeRef, checkpointId: turn.id } });
+      if (failed) emit({ kind: 'error', message: turn.error?.message ?? 'Codex 回合失败', ...(codexErrorInfoKey(turn.error?.codexErrorInfo) ? { codexErrorInfo: codexErrorInfoKey(turn.error?.codexErrorInfo) } : {}), nativeRef: { ...nativeRef, checkpointId: turn.id } });
       else emit({
         kind: 'completed', finalAnswer: turn.status === 'completed',
         stopReason: turn.status === 'interrupted' ? 'cancelled' : 'completed',
@@ -334,11 +338,59 @@ function attachSession(host, nativeSessionId, { emit, diagnostic, model, effort,
   return session;
 }
 
+// 官方 app-server 的两种权限序列化（实测 26.9.x）：
+// thread/start 与 thread/resume 的 sandbox 只接受 kebab-case 纯字符串；
+// turn/start 的 sandboxPolicy 接受 camelCase type 的对象；approvalsReviewer 枚举有限定。
+const SANDBOX_TO_KEBAB = { dangerFullAccess: 'danger-full-access', readOnly: 'read-only', workspaceWrite: 'workspace-write', 'danger-full-access': 'danger-full-access', 'read-only': 'read-only', 'workspace-write': 'workspace-write' };
+const SANDBOX_TO_CAMEL = { dangerFullAccess: 'dangerFullAccess', readOnly: 'readOnly', workspaceWrite: 'workspaceWrite', externalSandbox: 'externalSandbox', 'danger-full-access': 'dangerFullAccess', 'read-only': 'readOnly', 'workspace-write': 'workspaceWrite' };
+const REVIEWER_TO_WIRE = { user: 'user', auto_review: 'auto_review', guardian_subagent: 'guardian_subagent', guardian: 'guardian_subagent' };
+
+function sandboxToKebabString(sandbox) {
+  if (sandbox == null) return null;
+  const raw = typeof sandbox === 'string' ? sandbox : sandbox.type;
+  return SANDBOX_TO_KEBAB[raw] ?? null;
+}
+
+function sandboxPolicyToCamelObject(sandbox) {
+  if (!sandbox || typeof sandbox !== 'object') return null;
+  const type = SANDBOX_TO_CAMEL[sandbox.type];
+  return type ? { ...sandbox, type } : null;
+}
+
+function reviewerToWire(reviewer) {
+  return typeof reviewer === 'string' ? REVIEWER_TO_WIRE[reviewer] ?? null : null;
+}
+
+const APP_SERVER_BUSY = /^Agent is already processing(?:\.|$)/i;
+
+async function startTurnAfterNativeSettlement(host, params) {
+  // A queue-start can arrive immediately after turn/completed, while app-server is still
+  // clearing its active-turn slot. Keep the same logical Core turn and retry only this
+  // narrow transient; other errors must remain visible and must never be duplicated.
+  for (let attempt = 0, delay = 25; ; attempt++, delay *= 2) {
+    try {
+      return await host.request('turn/start', params);
+    } catch (error) {
+      if (!APP_SERVER_BUSY.test(String(error?.message ?? error)) || attempt >= 5) throw error;
+      await new Promise(resolve => setTimeout(resolve, delay));
+    }
+  }
+}
+
 function threadOptions(thread) {
+  // turnPermissions 来自 Desktop 权限菜单（thread/settings/update 或 thread/start 参数），
+  // 转发给原生 app-server 让显示选择与实际生效一致；permissions 优先级高于旧 permissionMode 档案
+  const perms = thread.options?.turnPermissions ?? {};
+  const sandbox = sandboxToKebabString(perms.sandboxPolicy);
+  const approvalsReviewer = reviewerToWire(perms.approvalsReviewer);
   return {
     cwd: thread.cwd,
     ...(thread.options?.model?.id ? { model: thread.options.model.id } : {}),
-    ...(thread.options?.permissionMode && thread.options.permissionMode !== 'default' ? { permissions: thread.options.permissionMode } : {}),
+    ...(perms.approvalPolicy ? { approvalPolicy: perms.approvalPolicy } : {}),
+    ...(approvalsReviewer ? { approvalsReviewer } : {}),
+    ...(sandbox ? { sandbox } : {}),
+    ...(perms.permissions ? { permissions: perms.permissions } : {}),
+    ...(thread.options?.permissionMode && thread.options.permissionMode !== 'default' && !perms.permissions ? { permissions: thread.options.permissionMode } : {}),
   };
 }
 
@@ -361,11 +413,22 @@ function create() {
       try {
         const servers = require('./managed-mcp').namedServers(managedMcp, collaboration);
         const options = { ...threadOptions(thread), ...(Object.keys(servers).length ? { config: Object.fromEntries(Object.entries(servers).map(([name, value]) => [`mcp_servers.${name}`, value])) } : {}) };
-        const result = thread.restore
-          ? await host.request('thread/resume', { threadId: thread.nativeSessionId, ...options })
-          : await host.request('thread/start', options);
+        let result;
+        if (thread.restore) {
+          // 旧版 app-server 可能拒绝 resume 上的权限覆盖字段：降级重试不阻塞会话恢复
+          try {
+            result = await host.request('thread/resume', { threadId: thread.nativeSessionId, ...options });
+          } catch (error) {
+            const { approvalPolicy, approvalsReviewer, sandbox, ...fallback } = options;
+            if (approvalPolicy === undefined && sandbox === undefined && approvalsReviewer === undefined) throw error;
+            result = await host.request('thread/resume', { threadId: thread.nativeSessionId, ...fallback });
+          }
+        } else {
+          result = await host.request('thread/start', options);
+        }
         const model = { id: result.model, name: result.model, provider: result.modelProvider ?? 'openai' };
         const session = attachSession(host, result.thread.id, { emit, diagnostic, model, effort: result.reasoningEffort, cwd: thread.cwd });
+        session.turnPermissions = thread.options?.turnPermissions ?? null;
         session.collaborationEnabled = !!collaboration;
         emit({ kind: 'session', nativeSessionId: result.thread.id, model });
         return session;
@@ -386,11 +449,18 @@ function create() {
           ...(prompt ? [{ type: 'text', text: prompt }] : []),
           ...(attachments?.images ?? []).map((a) => ({ type: 'image', url: `data:${a.mime};base64,${a.data}` })),
         ];
-        const result = await session.host.request('turn/start', {
+        // 回合级权限覆盖优先于线程级（Desktop 每个回合都可能推送最新选择）
+        const perms = attachments?.turnPermissions ?? session.turnPermissions ?? {};
+        const sandboxPolicy = sandboxPolicyToCamelObject(perms.sandboxPolicy);
+        const approvalsReviewer = reviewerToWire(perms.approvalsReviewer);
+        const result = await startTurnAfterNativeSettlement(session.host, {
           threadId: session.nativeSessionId,
           input,
           ...(session.model?.id ? { model: session.model.id } : {}),
           ...(session.state.effort ? { effort: session.state.effort } : {}),
+          ...(perms.approvalPolicy ? { approvalPolicy: perms.approvalPolicy } : {}),
+          ...(approvalsReviewer ? { approvalsReviewer } : {}),
+          ...(sandboxPolicy ? { sandboxPolicy } : {}),
         });
         session.state.nativeTurnId = result.turn.id;
       } catch (error) {

package/src/main/adapters/index.js

@@ -14,12 +14,13 @@ const zcode = require('./zcode');
 const trae = require('./trae');
 const kiro = require('./kiro');
 const cursor = require('./cursor');
+const cline = require('./cline');
 
 /**
  * Adapter 注册表（借鉴 codex-host 插件结构：Manifest + 工厂 + Adapter + Session）。
  * 新增 Harness 时：实现同形状模块并加入此列表，Renderer 无需改动协议。
  */
-const REGISTRY = [antigravity, pi, omp, dsh, claude, codex, opencode, grok, openclaw, hermes, qoder, codebuddy, zcode, trae, kiro, cursor];
+const REGISTRY = [antigravity, pi, omp, dsh, claude, codex, opencode, grok, openclaw, hermes, qoder, codebuddy, zcode, trae, kiro, cursor, cline];
 
 function buildAdapters(emit) {
   return REGISTRY.map(({ manifest, create }) => {

package/src/main/adapters/native-acp-command.js

@@ -13,6 +13,7 @@ function nativeCommand(id, argv) {
     'kiro-cli': ['kiro-cli', 'HARNESS_MIX_KIRO_EXECUTABLE', 'https://kiro.dev/docs/cli/'],
     qoder: ['qodercli', 'HARNESS_MIX_QODER_EXECUTABLE', 'https://docs.qoder.com/cli/acp'],
     trae: ['traecli', 'HARNESS_MIX_TRAE_EXECUTABLE', 'https://github.com/bytedance/trae-agent'],
+    cline: ['cline', 'HARNESS_MIX_CLINE_EXECUTABLE', 'https://docs.cline.bot/usage/cli-overview'],
     zcode: ['zcode-acp-server', 'HARNESS_MIX_ZCODE_ACP_EXECUTABLE', 'https://zcode.z.ai/'],
   };
   if (!specs[id]) throw new Error(`Unknown native CLI: ${id}`);