maoda-commander-tt 0.0.53 → 0.0.55

package/README.md

@@ -92,6 +92,25 @@ 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` 后台运行 `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 返回。
+
 ## 发布到 npm
 
 发布采用 GitHub Actions + npm Trusted Publishing（OIDC）。本地 `pnpm pub` 负责
@@ -319,9 +338,9 @@ tt sc w2
 `wait` 等待已有任务，`--output` 隐含 `--wait`。生成是否成功以 `data.state` 为准，
 不能只看查询命令的 `code=0`；超时返回 `data.timedOut=true`，不会取消生成。
 
-`ai image` 根据 cross-app settings 的 `imagegen.source` 选择实现：值精确为 `xyq`
-（忽略大小写和首尾空格）时，通过 XYQ HTTP 提交；未配置、其他值或读取失败时继续
-使用原来的本地 Codex 后台任务。两种实现都返回 `taskId`、当前 `state` 和
+`ai image` 根据 cross-app settings 的 `imagegen.source` 选择实现：未配置、为空或值为
+`xyq`（忽略大小写和首尾空格）时，通过 XYQ HTTP 提交；显式配置其他值时使用
+原来的本地 Codex 后台任务。两种实现都返回 `taskId`、当前 `state` 和
 `nextCommand`。图片 ID 分别为 `xyq-image:<threadId>` 和 `local-image:<uuid>`；
 后续 `status` / `wait` 根据 ID 前缀回到原 provider，不受配置后来切换影响。
 
@@ -346,7 +365,8 @@ tt ai image list
 ```
 
 等待默认 360 秒，上限 600 秒。本地实现完成时会返回 `outputs[].localPath`；
-XYQ 的 `status` / `--wait` 会在 `outputs[]` 返回
+XYQ 优先使用 artifact 的 `image.url` 无水印原图，缺失时才回退到 `scene_urls`。
+`status` / `--wait` 会在 `outputs[]` 返回
 `downloadUrl`、`assetId`、`pippitAssetId` 和尺寸等槽位元数据。
 使用 `--output` 会把 XYQ 产物下载到本地，并用 `localPath` 取代 `downloadUrl`；再次
 `wait --output` 只下载或复制已有产物。