maoda-commander-tt 0.0.55 → 0.0.57

package/README.md

@@ -104,12 +104,44 @@ tt codex --help
 `high`。模型可选 `gpt-6-astra`、`gpt-5.6-sol`；推理强度可选
 `low`、`medium`、`high`、`xhigh`、`max`、`ultra`。
 
-macOS/Linux 下通过 `nohup` 后台运行 `codex exec --json`，固定配置
-`sandbox_mode="danger-full-access"`、`approval_policy="never"`，无沙箱且不请求审批。
-stdin/stdout/stderr 均接到 `/dev/null`；tt 不生成日志、不跟踪任务，保留 Codex 默认
-会话持久化与本机登录态。返回一行 JSON，`data` 包含 `status: "launched"`、`pid`、
-`cwd`、`model`、`reasoning`。成功仅表示已提交后台启动，不保证 Codex 初始化或任务
-执行成功；启动后的错误和输出不会由 tt 返回。
+macOS/Linux 下通过 `nohup` 启动后台 worker，由 worker 运行 `codex app-server`，
+通过 `initialize`、`project/list`、`thread/start`、`turn/start` 提交任务。
+工作目录支持普通目录，无需 Git 仓库。固定无沙箱 `danger-full-access` 和审批策略
+`never`，保留本机 Codex 配置、登录态与会话持久化。
+
+服务端确认 `turn/start` 后 tt 立即返回一行 JSON，`data` 包含 `status: "launched"`、
+worker `pid`、`threadId`、`turnId`、`projectId`、`cwd`、`model`、`reasoning`。
+这表示任务已提交，不代表执行成功。启动或提交错误会直接返回失败；超时不自动重试，
+以免重复创建任务。后台 worker 保持协议连接直到本轮结束后退出，调用终端关闭不影响
+任务运行。终端 IO 丢弃，不生成任务日志，不提供任务跟踪命令。
+
+按目录实际路径精确匹配已保存项目，并通过 `thread/start.projectId` 绑定；无匹配
+则返回 `projectId: null`，不自动创建项目；匹配多个项目则在创建会话前报错。
+App 可发现 app-server 会话，但 App 侧边栏是否按项目分组还取决于该版本是否启用
+项目归属同步。服务端绑定 projectId 不等同于旧版 App 侧边栏已同步；tt 不修改 App
+私有状态文件或数据库来强制分组。
+
+## 后台启动 Traex
+
+```bash
+tt traex "我的具体 prompt"
+tt traex -C /path/to/repo -m gpt-6-astra -r high "我的具体 prompt"
+tt traex --help
+```
+
+默认目录 `/Users/bytedance/work/autogen`，默认模型 `gpt-5.6-sol`，默认推理强度
+`xhigh`。模型可选 `gpt-5.6-sol`、`gpt-6-astra`；推理强度按 Traex
+支持范围提供 `low`、`medium`、`high`、`xhigh`。需要本机已安装并登录 `traex`。
+
+与 `tt codex` 一样，通过 `nohup` 后台 worker 运行 `traex app-server`，固定
+`danger-full-access` 和 `never`，收到 `turn/start` 确认后立即返回一行 JSON。
+保留本机 Traex 配置、登录态及会话持久化，终端 IO 丢弃，不生成任务日志，
+不提供任务跟踪。后台 worker 保持连接到本轮结束后退出。
+
+返回 `status: "launched"`、worker `pid`、`threadId`、`turnId`、`cwd`、`model`、
+`reasoning` 和 `projectId: null`。Traex 暂不支持项目接口，因此仅传工作目录，
+不调用 `project/list` 或传入 `thread/start.projectId`。App 显示及项目分组可能
+延迟，`launched` 只代表服务端已接受任务，不代表执行完成或已在 App 中显示。
 
 ## 发布到 npm
 
@@ -375,8 +407,19 @@ XYQ 优先使用 artifact 的 `image.url` 无水印原图，缺失时才回退
 写入生成上下文，XYQ 实现先上传图片，再把对应 `pippitAssetId` 按顺序放进
 `pippit_asset_ids` 槽位。因此切换 source 时调用命令和“图1/图2”提示词都不用变化。
 旧的“直接把绝对路径写进提示词”仍只作为本地实现的兼容用法。
-两种实现都提供 2K 图片，无需在 prompt 中声明分辨率。XYQ 推理强度默认
-`medium`，通常无需设置 `--effort`。支持的比例为 `21:9`、`16:9`、`3:2`、
+两种实现都提供 2K 图片，无需在 prompt 中声明分辨率。XYQ 默认模型为
+`gpt_image_2_5_sunburst`（image2.5 Sunburst），可用 `--model-id` 切换模型。
+`--effort` 的可选值和默认值按模型区分，非法组合会在上传参考图或提交任务前报错：
+
+| `--model-id` | `--effort` 可选值 | 默认 effort |
+| --- | --- | --- |
+| `gpt_image_2`（image2） | `medium`、`high` | `high` |
+| `gpt_image_2_5_sunburst`（image2.5 Sunburst，默认模型） | `high`、`xhigh`、`max` | `max` |
+
+例如 `tt ai image '兔子'` 默认使用 Sunburst + max；
+`tt ai image '兔子' --model-id gpt_image_2` 使用 image2 + high。
+其他模型 ID 仍允许透传，其 effort 不校验，省略时沿用 `medium`。
+支持的比例为 `21:9`、`16:9`、`3:2`、
 `4:3`、`1:1`、`3:4`、`2:3`、`9:16` 和 `auto`。XYQ 未设置时默认 `16:9`；
 非 XYQ 未设置时不追加比例。修图时使用
 `--aspect-ratio auto`，无需在 prompt 重复比例；需要枚举外的特殊比例时使用