maoda-commander-tt 0.0.54 → 0.0.56

package/README.md

@@ -92,6 +92,57 @@ pnpm test
 pnpm build && pnpm test:dist
 ```
 
+## 后台启动 Codex
+
+```bash
+tt codex "我的具体 prompt"
+tt codex -C /path/to/repo -m gpt-5.6-sol -r ultra "我的具体 prompt"
+tt codex --help
+```
+
+默认工作目录 `/Users/bytedance/work/autogen`，默认模型 `gpt-6-astra`，默认推理强度
+`high`。模型可选 `gpt-6-astra`、`gpt-5.6-sol`；推理强度可选
+`low`、`medium`、`high`、`xhigh`、`max`、`ultra`。
+
+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
 
 发布采用 GitHub Actions + npm Trusted Publishing（OIDC）。本地 `pnpm pub` 负责