# traework-win-to-linux

**Repository Path**: xiyidaiwa/traework-win-to-linux

## Basic Information

- **Project Name**: traework-win-to-linux
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-08-27
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TraeWork CN → Linux deb 重打包

将 Windows 版 **TraeWork CN**（TRAE SOLO）拆解后重新打包为 Linux deb 包。

> ⚠️ 本项目为非官方移植，仅供学习交流。所有软件版权归原开发方（ByteDance）所有。

## 原理

TraeWork 与 TraeCode 同源（VS Code 1.107.1 内核），但使用不同的 UI 变体：

| 组件 | 来源 | 作用 |
|------|------|------|
| Electron 二进制 + 原生 `.so` | TraeCode CN **Linux** deb | Chromium 运行时、AI Agent、CKG 模块 |
| JS 资源 `out/` + `product.json` | TraeWork CN **Windows** 安装包 | solo-lite AI 工作台 UI |
| `@byted-icube/solo-lite/dist/` | TraeWork CN **Windows** 安装包 | UI 核心模块（TraeCode 没有此文件） |

## 文件结构

```
├── build.sh              # 唯一构建入口：拆包 → deb → 玲珑 → 安装
├── scripts/
│   └── fix-linglong-yaml.py   # 玲珑 linglong.yaml 适配修复助手（由 build.sh 调用）
├── deb-pkg/              # 打包目录
│   ├── DEBIAN/           # control/postinst/prerm/postrm（入库）
│   ├── opt/.../trae-solo-cn   # 启动脚本（入库）
│   └── opt/.../其余内容        # 由 build.sh 拆包阶段生成（不入库）
├── pica-work/            # 玲珑构建工作目录（build.sh 自动生成，不入库）
├── docs/                 # 设计文档与实施计划
└── README-功能说明.md     # 功能可用/不可用清单
```

## 一键构建（deb + 玲珑）

前置：下载 `TraeWork_CN-Setup-x64.exe`（放项目目录会被自动发现），并安装（或下载）`TraeCode_CN-linux-x64.deb`。

> ℹ️ 0.1.58 起的安装包为 Inno Setup 6.4 格式，需要 innoextract ≥ 1.10（发行版自带的 1.9 无法解析）。
> build.sh 会优先使用本目录 `.innoextract-src/build/innoextract`（自编译版）：
> ```bash
> git clone --depth 1 https://github.com/dscharrer/innoextract.git .innoextract-src
> cmake -S .innoextract-src -B .innoextract-src/build && cmake --build .innoextract-src/build -j$(nproc)
> ```
> 0.1.54 及更早的 NSIS 格式安装包则仍用 7z 解压。

```bash
# 完整流水线：拆包 → 构建 deb → 转制玲珑 → 安装两个版本
bash build.sh

# 常用变体
bash build.sh /path/TraeWork_CN-Setup-x64.exe   # 指定安装包
bash build.sh --extracted <解压目录>            # 复用已解压的 code$GetDestDir
bash build.sh --skip-extract                    # 跳过拆包，用现有 deb-pkg 直接构建
bash build.sh --deb-only                        # 只到 deb（不转玲珑）
bash build.sh --ll-only                         # 只用最新 deb 转玲珑
bash build.sh --no-install                      # 全部构建但都不安装
bash build.sh --install-deps                    # 一键装齐依赖（apt 包 + 自编译 innoextract）
bash build.sh --limit-cpu 4                     # 收紧到前 4 核（deb 压缩会慢一倍多）
bash build.sh --limit-cpu 0                     # 取消限制，跑满所有核
```

> 默认只用前 **8** 核打包：`--limit-cpu N` 通过 `taskset` 给整个脚本钉 CPU 亲和（子进程继承），
> 解包 / strip / `dpkg-deb` 压缩 / 玲珑构建全链路都只在指定核上运行，
> 打包时桌面不会因为 CPU 被打满而卡顿；`N` 超过物理核数时自动回落到实际核数，`N=0` 取消限制。
>
> 为什么默认 8：只有 `dpkg-deb` 的压缩真正吃多核，其余阶段（rsync / cp / innoextract / 7z /
> strip / md5sum）基本单线程。本机 16 核、`deb-pkg` 1.3G 的实测：
>
> | 限制 | `dpkg-deb --build` 耗时 |
> |------|------------------------|
> | 4 核 | 7m10s（明显变慢） |
> | 8 核 | 2m50s |
> | 16 核（不限） | 2m47s（与 8 核基本持平） |

新机器首次使用：先 `bash build.sh --install-deps` 自动安装 7zip、linglong 工具链、
python3-yaml 等 apt 包，并 clone + 编译 innoextract ≥ 1.10（发行版仓库只有 1.9，
不支持 Inno Setup 6.4，无法用 apt 解决）；之后直接 `bash build.sh` 即可。

启动：桌面菜单 `TRAE SOLO CN`（deb）/ `TRAE SOLO CN (玲珑版)`，或 `/opt/trae-solo-cn/trae-solo-cn`。


## 内置补丁（拆包时自动应用，均可用环境变量关闭）

`build.sh` 在组装 `deb-pkg` 时就地修补 0.1.69 的几个行为问题，每项都能用 `TRAE_PATCH_*=0` 关掉：

| 环境变量 | 默认 | 作用 |
|----------|------|------|
| `TRAE_PATCH_SUBSCRIBE_FIX` | 1 | 畸形 `chat.subscribe` 包不再被当成致命错误（恢复 0.1.67 的「只告警忽略」），避免「服务器错误，请稍后重试。(-1)」+「异常打断」 |
| `TRAE_PATCH_SHELL_STRATEGY` | 1 | soloLite 形态上报 `shell_exec` 而不是 `tool_host`，规避 Linux 上不可用的 ToolHost 链路（`ToolHost is not running for shell_execute_strategy=tool_host`） |
| `TRAE_PATCH_NOTIFY_DEDUP` | 1 | 「任务完成」系统通知按会话 60 秒去重（服务端高频重建流时否则会反复弹通知） |
| `TRAE_PATCH_ENABLE_TOOLHOST` | 0 | 是否强行启用 toolhost。默认保持上游 Linux 行为（不启用）；实测强行启用无效 |
| `TRAE_PATCH_CLIENT_TYPE_IDE` | 0 | 是否把注入 ai-agent 的形态声明改成 `ide`。默认不改（无证据支持且风险大） |

用法示例：`TRAE_PATCH_NOTIFY_DEDUP=0 bash build.sh --skip-extract --no-install`

> 说明：这些补丁只改 `deb-pkg` 内的 JS bundle（`solo-lite/dist/551.*.mjs`、`ai-modules-chat/dist/index.mjs`、
> `out/main.js`、`out/vs/workbench/workbench.desktop.main.solo-lite*.js`），不碰 Electron 二进制与 .so；
> 每次完整构建都会重新应用，重复执行幂等。改动 `.mjs` 后必须清 `CachedData`/`Code Cache`/`GPUCache` 再启动，否则仍走旧字节码缓存。

## 玲珑包说明（如意玲珑 / uab）

`build.sh` 的玲珑阶段自动完成：ll-pica 转换 → 适配修复（应用主体复制、
--no-sandbox、桌面入口 PATH 包装脚本等）→ ll-builder build/export。

产物：`pica-work/package/trae-solo-cn/trae-solo-cn_<版本>_x86_64_main.uab`

**版本同步规则**：玲珑版本号 = deb 主版本 + 修订号转点分
（`0.1.58-5` → `0.1.58.5`），确保每次 deb 更新，玲珑包也随之更新且可区分。

玲珑版特性：沙箱隔离、无需 `--no-sandbox` 手动参数（已内置）、自带全部依赖。


## 与 deb 版共存

玲珑版与 deb 版可同时安装、互不干扰，方便 A/B 测试：

| 项目 | deb 版 | 玲珑版 |
|------|--------|--------|
| 桌面入口 | `TRAE SOLO CN` | `TRAE SOLO CN (玲珑版)` |
| desktop 文件 | `trae-solo-cn.desktop` | `trae-solo-cn-linglong.desktop` |
| 应用文件 | `/opt/trae-solo-cn` | 沙箱 `/opt/apps/trae-solo-cn/files` |
| 启动命令 | `/opt/trae-solo-cn/trae-solo-cn` | `ll-cli run trae-solo-cn` |

- **窗口类隔离**：玲珑版启动时注入 `--class=trae-solo-cn-linglong`，任务栏图标各自归组，不与 deb 版混用。
- **用户数据共用** `~/.config/TRAE SOLO CN`（登录、配置、扩展一致）。
- **不要同时运行**两个版本：共用用户数据触发 Electron 单实例锁，后启动者会退出。
- 如需同时对比，可给其中一个指定独立数据目录：
  `ll-cli run trae-solo-cn -- /opt/apps/trae-solo-cn/files/bin/trae-solo-cn --user-data-dir ~/.config/TRAE-SOLO-linglong-test`


## 功能状态（真实测试 2026-08-26）

- ✅ **可用**: solo-lite UI、AI Agent、CKG、插件市场、Git 集成、API 连通
- ⚠️ **有异常**: 飞书 Token 刷新、计费状态、自动更新（无）
- ❌ **不可用**: 积分、企业模型、专家模式等（产品功能开关关闭）

详见 [README-功能说明.md](README-功能说明.md)。

## 相关资源

- [English README](README.en.md)
- 设计文档: [docs/superpowers/specs/](docs/superpowers/specs/)
- 实施计划: [docs/superpowers/plans/](docs/superpowers/plans/)
- 拆包重打包技能手册（CodeBuddy 技能，含 symlink / main.js / 标题栏陷阱）: [docs/skills/traework-deb-repack/SKILL.md](docs/skills/traework-deb-repack/SKILL.md)

## 镜像仓库

- GitHub: https://github.com/testerxydw/traework-win-to-linux
- Gitee: https://gitee.com/xiyidaiwa/traework-win-to-linux

## 下载

- **WorkBuddy 5.3.14-4**（Linux 移植版，Electron 39.2.7；修复退出后进程残留、托盘右键菜单、桌面图标为纯 WorkBuddy logo）
  - GitHub Release（单文件，推荐）：https://github.com/testerxydw/traework-win-to-linux/releases/tag/workbuddy-5.3.14-4
  - Gitee Release（分卷：因 Gitee 单文件限 ~100MB，拆为 `.00`/`.01`/`.02` 三卷，下载后合并）：
    https://gitee.com/xiyidaiwa/traework-win-to-linux/releases/tag/workbuddy-5.3.14-4
    ```bash
    cat workbuddy_5.3.14-4_amd64.deb.0* > workbuddy_5.3.14-4_amd64.deb
    md5sum workbuddy_5.3.14-4_amd64.deb   # 应为 a25753d060e4543944156dcf7a73a948
    sudo dpkg -i workbuddy_5.3.14-4_amd64.deb
    ```
- 历史版本见各 `workbuddy-*` tag 的 Release 附件