@pippit-dev/cli 1.0.41 → 1.0.43

package/README.md

@@ -24,17 +24,43 @@ x-tt-env = ""
 | 技能 | 说明 | 路径 |
 |-------|-------------|------|
 | `xyq-short-drama-skill` | 短剧工作流技能，支持提交创作任务、上传参考文件、查询进度、列出会话文件和下载产物。 | `skills/short-drama/` |
-| `xyq-skill` | 图片生成与参考图编辑、视频生成、视频超分与擦字幕、异步结果交付、个人 Canvas 编辑、积分查询及登录授权。 | `skills/xyq-nest-skill/` |
+| `xyq-skill` | 图片生成与参考图编辑、视频生成、视频超分与擦字幕、异步结果交付、个人或团队 Canvas 编辑、积分查询及登录授权。 | `skills/xyq-nest-skill/` |
 | `xyq-marketing-skill` | 商品图文营销一键成片：剧情广告、品牌大片、达人带货，含素材上传、进度查询与媒体下载。 | `skills/xyq-marketing-skill/` |
 
 ### 技能路由
 
-- 图片生成与参考图编辑、视频生成（含首尾帧和参考素材）、视频超分、擦字幕、结果查询、个人 Canvas 编辑、积分和授权由 `xyq-skill` 处理。
+- 图片生成与参考图编辑、视频生成（含首尾帧和参考素材）、视频超分、擦字幕、结果查询、个人或团队 Canvas 编辑、积分和授权由 `xyq-skill` 处理。
 - 短剧生成、续写、改写、人物设定、分集创作和短剧会话文件处理使用 `xyq-short-drama-skill`。
 - 商品图文营销成片、剧情广告、品牌大片和达人带货视频使用 `xyq-marketing-skill`；由公开营销 API 完成创作编排。
 
 需要补充、选择或确认时，使用宿主实际暴露且当前模式允许的工具：Codex 的 `request_user_input` / `request_user_input_async`、WorkBuddy 的 `ask_user_question`；不可用时用普通聊天。
 
+## 个人与团队空间
+
+同一个 AK 可以切换个人与所属团队，无需重新登录。首次使用默认个人；当前账号与 API origin 的选择独立保存。
+
+```bash
+pippit-tool-cli space list           # 查看个人和所属团队，并标记当前默认空间
+pippit-tool-cli space use 123456      # 保存团队为默认空间
+pippit-tool-cli space use 0           # 保存个人为默认空间
+pippit-tool-cli get-credit-balance --team-id 123456 # 仅本次使用团队
+pippit-tool-cli get-credit-balance --team-id 0      # 仅本次使用个人
+```
+
+`space` 仅提供 `list` 和 `use <TEAM_ID>`，统一输出 JSON。`list` 返回完整分页后的 `spaces` 和已保存的默认空间 `current`，列表项用 `current: true` 标记当前选择；`use` 必须指定 ID，不等待交互输入，成功后返回保存的空间。团队 ID 按 int64 的十进制字符串处理，不接受负数、小数或溢出值。切换到团队前核实账号所属团队列表，失败保留旧选择；切回个人不依赖列表接口。
+
+新任务按「单次 `--team-id` → 已保存默认 → 个人」确定空间；上传、提交、轮询固定同一空间。生成、视频处理、短剧、上传、会话查询、文件列表、积分、营销与 Canvas 命令均适用。同源 API 请求统一携带当前团队的 `X-Team-Id`，由 API 决定是否使用；模型接口内部仍按个人身份查询；Canvas 复用相同空间选择，`--team-id 0` 可单次切回个人。帮助、安装和版本命令无需读取空间或登录。
+
+显式 `--team-id` 不要求 CLI 能读取本地账号标识或空间记录，认证继续使用当前 AK/adapter，由 API 校验团队权限。本地记录可用时照常保存；不可用时本次仍固定使用指定空间，宿主应保存返回的任务 ID 和 `team_id`，后续显式传入原 TeamID。`space use` 保存默认空间仍需要可识别的账号；`space list` 在账号不可识别时返回 `current: null`。
+
+提交成功会按当前账号、API origin 保存 thread/run 的空间记录，上传成功保存资产归属。之后即使切到另一团队，直接 `get-thread --thread-id ...`、`query-result`、`list-thread-file` 或 `marketing query` 仍查询原任务；带原 thread 的续写也使用原空间。显式指定与记录冲突的团队会在请求前停止，已知跨空间素材同样会拦截。跨设备或旧任务无记录时应显式传原 `--team-id`；失败不会遍历其它团队。查询成功后可补齐记录。
+
+空间记录位于系统用户配置目录的 `pippit-cli/spaces/`，按账号与 API origin 摘要隔离，每条记录原子保存，不存 AK。空间账号标识使用本地登录凭证的 UID 摘要，同 UID 换 AK 保留选择。损坏记录报错，不当作首次使用；按错误提示用原 `--team-id` 查询恢复。保存失败不把已经成功的提交改成失败：输出保留 ID 与 `team_id`，警告写 stderr，后续沿用原空间查询，不能重提。
+
+业务 stdout 保留既有结构；上传和提交增加字符串 `team_id`，`status` 增加 `default_space`，空间提示写 stderr。`marketing.js query --wait` 自动向各次 CLI 子进程传递固定空间；有账号记录时同时传递账号/API origin 约束，切换账号会停止。无本地账号记录时可显式传入 `--team-id` 轮询，各次请求仍由 API 鉴权；默认空间切换不会改变已固定的 TeamID。团队出现在列表中不等于有 WRITE 权限、有效会员或可用积分；最终由服务端授权和扣费，CLI 不自动回退。
+
+`space list/use TEAM_ID` 依赖 API 部署 `/api/biz/v1/skill/get_lite_team_list` 的 AK 适配入口，业务团队使用还依赖对应 API 团队权限实现；不直连 commerce Web 接口。宿主 Agent 的选择、任务恢复与不回退规则已写入三个 Skill 的 `Space Selection` 章节。
+
 ## 小云雀营销成片技能
 
 入口：[skills/xyq-marketing-skill/SKILL.md](skills/xyq-marketing-skill/SKILL.md)。使用 [官网](https://xyq.jianying.com/cli?tab=api) 已开放的营销 API，支持素材上传、营销视频提交、结果查询与下载、积分查询。安装器会从 `skills/` 自动安装该 Skill，也可以单独安装：
@@ -53,7 +79,7 @@ node skills/xyq-marketing-skill/scripts/marketing.js generate --request request.
 node skills/xyq-marketing-skill/scripts/marketing.js query --thread-id THREAD_ID --run-id RUN_ID --wait --output-dir ./results
 ```
 
-参数与错误处理见 [接口契约](skills/xyq-marketing-skill/references/api.md)，完整示例见 [商品图到营销视频](skills/xyq-marketing-skill/examples/product-video.md)。这是 Skill 脚本入口，不是新增的 Go CLI 子命令。营销 API 未公开团队切换字段，不宣称支持团队空间切换。
+参数与错误处理见 [接口契约](skills/xyq-marketing-skill/references/api.md)，完整示例见 [商品图到营销视频](skills/xyq-marketing-skill/examples/product-video.md)。Skill 脚本通过原生 `marketing` 命令执行；两者均支持 `--team-id`，空间经 HTTP Header 传递，营销请求 JSON 无需增加字段。
 
 维护后运行 `node scripts/marketing-skill.test.js` 和 `node scripts/skills.test.js`，验证请求、上传、任务状态、下载与 Skill 引用。测试使用本地模拟服务，不会创建真实付费任务。
 
@@ -64,7 +90,7 @@ node skills/xyq-marketing-skill/scripts/marketing.js query --thread-id THREAD_ID
 | 操作 | CLI | 文档 |
 | --- | --- | --- |
 | 登录授权 | `status` / `login` / `logout` | [授权](skills/xyq-nest-skill/commands/auth.md) |
-| 个人 Canvas 画布与节点编辑 | `canvas` | [画布](skills/xyq-nest-skill/commands/canvas.md) |
+| 个人或团队 Canvas 画布与节点编辑 | `canvas` | [画布](skills/xyq-nest-skill/commands/canvas.md) |
 | 生图、参考图编辑 | `generate-image` | [图片](skills/xyq-nest-skill/commands/generate-image.md) |
 | 查看可用图片/视频模型、参数配置 | `model list` / `model describe` | [模型发现](skills/xyq-nest-skill/commands/model.md) |
 | 生视频、首尾帧 | `generate-video` | [视频](skills/xyq-nest-skill/commands/generate-video.md) |
@@ -149,7 +175,7 @@ pippit-tool-cli list-thread-file --thread-id thread_123 --page-num 1 --page-size
 pippit-tool-cli download-result --output-path ./thread_123/results/result.mp4 --url URL --updated-at 1779716734
 ```
 
-`get-credit-balance`: 使用当前登录凭证查询个人有效积分余额，并输出 `{"total_remain_amount":"123"}`；零余额会显式输出为 `"0"`。加 `--with-log-id` 可在输出中同时保留本次请求的 `log_id`。
+`get-credit-balance`: 使用当前登录凭证查询所选个人或团队空间的有效积分余额，并输出 `{"total_remain_amount":"123"}`；零余额会显式输出为 `"0"`。加 `--with-log-id` 可在输出中同时保留本次请求的 `log_id`。
 
 `+submit-run`: 输出 `thread_id`、`run_id` 和 `web_thread_link`；其中 `--message` 为必填参数。
 `get-thread`: 请求中带 `version=v2`，并输出 `readable_text`。
@@ -161,7 +187,7 @@ pippit-tool-cli download-result --output-path ./thread_123/results/result.mp4 --
 
 ## Canvas 原子命令
 
-CLI 提供个人漫剧画布的通用原子命令，不包含特定来源的导入或转换逻辑：
+CLI 提供个人和团队漫剧画布的通用原子命令，不包含特定来源的导入或转换逻辑：
 
 ```bash
 # 首次使用时打开小云雀网页授权
@@ -176,6 +202,8 @@ pippit-tool-cli canvas upload --path ./reference.png
 pippit-tool-cli canvas apply --project-id PROJECT_ID --file ./patch.json
 ```
 
+五个命令复用 `space use TEAM_ID` 保存的默认空间，也支持单次 `--team-id TEAM_ID`，个人空间使用 `0`。操作已有画布时显式使用其原 `--team-id`，CLI 不根据画布 ID 自动选择团队。`canvas get` 返回实际 `team_id`，本地账号可识别时还返回 `space_context`；`canvas command run` 据此固定后续子进程的空间与账号/API origin，期间切换默认空间不影响当前操作。本地恢复记录和检查点按账号、团队与画布隔离，原有个人记录保持可读。
+
 五个命令均输出单行 JSON，资源 ID 保持字符串。`allocate` 只预留 ID，实际资产仍由后续 `apply` transaction 创建。`create` 的 `request_id` 用于追踪，不是跨服务崩溃窗口的严格幂等键；写请求结果不明确时不要盲目重放，应先使用 `canvas get` 回读确认。`apply` 当前只接受一个 transaction，但该 transaction 可以包含多个 patches；CLI 会严格检查 transaction ACK 和每个目标资产的新版本。
 
 通过 npm 安装的 CLI 还提供基于同一 Canvas SDK 的语义命令目录：
@@ -308,7 +336,7 @@ pippit-tool-cli model describe MiniMax-H3
 pippit-tool-cli model list --refresh
 ```
 
-使用当前个人登录凭证查询服务端 Skill 模型接口；图片 scene 为 `web_image_agent`，视频为 `web_turbo_video_generator`，不传 TeamID。成功结果按账号、环境和场景隔离缓存 5 分钟，`--refresh` 强制刷新。失败时提示重试，不回退静态列表或过期缓存。`describe` 提供可直接传给生成命令的参数：图片比例保留数字枚举并附比例说明，视频比例转换为字符串，同时整理分辨率、图片推理强度、视频时长和素材限制；不展示内部 `config_key`，未知比例枚举跳过。图片列表和详情仅用 `name` 标识模型，不展示底层模型枚举；搜索、详情查询和 `generate-image --model` 均使用名称，包含空格时加引号。图片详情保留原始 `parameter_config`，包括条件、必选标记、选项说明和参数组合约束。生成仍由服务端校验；服务端尚未开放图片场景或提交参数时会返回错误，不回退静态模型清单。详见 [模型发现](skills/xyq-nest-skill/commands/model.md)。
+使用当前登录凭证查询服务端 Skill 模型接口；图片 scene 为 `web_image_agent`，视频为 `web_turbo_video_generator`。团队空间的请求携带 `X-Team-Id`，API 内部仍按个人身份查询模型。成功结果按账号、环境和场景隔离缓存 5 分钟，`--refresh` 强制刷新。失败时提示重试，不回退静态列表或过期缓存。`describe` 提供可直接传给生成命令的参数：图片比例保留数字枚举并附比例说明，视频比例转换为字符串，同时整理分辨率、图片推理强度、视频时长和素材限制；不展示内部 `config_key`，未知比例枚举跳过。图片列表和详情仅用 `name` 标识模型，不展示底层模型枚举；搜索、详情查询和 `generate-image --model` 均使用名称，包含空格时加引号。图片详情保留原始 `parameter_config`，包括条件、必选标记、选项说明和参数组合约束。生成仍由服务端校验；服务端尚未开放图片场景或提交参数时会返回错误，不回退静态模型清单。详见 [模型发现](skills/xyq-nest-skill/commands/model.md)。
 
 ## 生视频 CLI
 
@@ -412,6 +440,7 @@ pippit-tool-cli query-result \
 - 同源判断由公共 HTTP client 按 scheme、hostname、有效端口执行；只有同源 API 请求才调用 `PrepareAPIRequest`。非同源请求清除默认认证和 adapter 管理的敏感字段；API 跨域重定向会被拒绝。
 - `AuthProvided` 只表示 adapter 已附加认证材料，不代表服务端验证通过；失败立即返回，不回退到本机认证。`UseDefaultAuth` 才调用默认认证器，未知决策会被拒绝。
 - CLI 策略与 Cobra 解耦。`DefaultAllowRootCommands` 明确指定是否默认放行一级业务命令；为 false 时只开放 `AllowedRootCommands` 白名单，nil 和空列表都表示没有白名单命令。默认 adapter 将该开关设为 true，本机认证和自更新仍受各自开关控制；标准帮助和版本行为仍由 Cobra 提供。可通过 `auth.WithCLIOptions` 将本机认证能力配置应用于独立 Manager。
+- `space` 按普通业务命令白名单开放，不随 `LocalCredentialsEnabled` 隐藏。`space list` 复用请求认证；没有可识别账号时仍可查询列表，JSON 的 `current` 为 `null`。`space use` 需要稳定账号标识，缺失时明确报错；不读取或写入匿名空间配置。显式 `--team-id` 的业务请求仍可使用 adapter 认证。关闭本地凭据后，未用于实际认证的环境 AK 不作为宿主账号标识。
 - 业务 client 与更新遥测 client 都在构造时包装 Transport；遥测 client 属于命令实例，避免使用不同 adapter 的实例共享可变客户端。
 
 例如，自定义 adapter 可以复用默认实现，仅调整命令能力，并在自己的程序入口注入：
@@ -452,7 +481,7 @@ npx @pippit-dev/cli install --source HOST
 pippit-tool-cli update --source HOST
 ```
 
-直接使用 `npm install -g @pippit-dev/cli` 时，可由宿主在该次命令的环境中设置 `PIPPIT_CLI_SOURCE`。安装和更新均按显式 `--source`（命令支持时）、`PIPPIT_CLI_SOURCE`、已核实宿主运行标记的顺序识别来源；首尾空白去除，显式空值清空来源。该值不持久化；生成命令运行环境中若也存在此变量，同样会读取它作为宿主来源，具体兜底规则见下文。
+直接使用 `npm install -g @pippit-dev/cli` 时，可由宿主在该次命令的环境中设置 `PIPPIT_CLI_SOURCE`。安装和更新均按非空显式 `--source`（命令支持时）、`PIPPIT_CLI_SOURCE`、已核实宿主运行标记的顺序识别来源；去掉首尾空白后，未传或空值继续尝试下一来源。该值不持久化；生成命令运行环境中若也存在此变量，同样会读取它作为宿主来源，具体兜底规则见下文。
 
 `report_telemetry` 新增可选请求字段 `host_platform` 上报宿主标识；原有 `source` 保留 `npm_install`、`npx_install`、`cli_update`，`event` 区分 install/update，`platform` 仍表示操作系统。服务端通过独立的 `host_platform` 指标标签统计宿主来源。帮助不安装也不上报，`PIPPIT_CLI_DISABLE_TELEMETRY=1` 仍可关闭上报。内部 `install-cli.js` 仅安装二进制，沿用不安装 Skill、不上报的原有行为。
 
@@ -460,16 +489,18 @@ pippit-tool-cli update --source HOST
 
 生成提交命令均支持可选 `--source`：`generate-image`、`generate-video`、`video-super-resolution`、`erase-video-subtitle`、`short-drama +submit-run`、`marketing generate`。
 
-由宿主 Agent 根据实际环境静默填写稳定标识，例如豆包办公 `doubao_office`、WorkBuddy `workbuddy`、Codex `codex`。其它来源可使用其真实产品标识；来源未知时省略，不询问用户，也不从 prompt 猜测。该值去掉首尾空白后写入请求顶层 `platform`，仅供统计，不参与创作、模型选择或鉴权；无法解析来源或显式空值时不发送该字段。省略 `--source` 时，CLI 按以下顺序尽力补齐来源：
+由宿主 Agent 根据实际环境静默填写稳定标识，例如豆包办公 `doubao_office`、WorkBuddy `workbuddy`、Codex `codex`。其它来源可使用其真实产品标识；来源未知时省略，不询问用户，也不从 prompt 猜测。该值去掉首尾空白后写入请求顶层 `platform`，仅供统计，不参与创作、模型选择或鉴权；无法解析来源时不发送该字段。省略 `--source`、显式空值或纯空白时，CLI 按以下顺序尽力补齐来源：
 
 1. 宿主显式设置的 `PIPPIT_CLI_SOURCE`。
-2. 运行标记：`CODEX_THREAD_ID` / `CODEX_SESSION_ID` → `codex`，`CLAUDECODE` → `claude_code`，`CURSOR_AGENT` → `cursor`，`GEMINI_CLI` → `gemini_cli`。
+2. 运行标记：`CODEX_THREAD_ID` / `CODEX_SESSION_ID` → `codex`，`CLAUDECODE` → `claude_code`，`CURSOR_AGENT` → `cursor`，`GEMINI_CLI` → `gemini_cli`，`OPENCODE` → `opencode`，`QWEN_CODE` → `qwen_code`，`CLINE_ACTIVE` → `cline`，`COPILOT_CLI` / `COPILOT_AGENT_SESSION_ID` → `github_copilot_cli`。
 3. 标记缺失、为 0/false 或不同宿主标记冲突时不猜测，省略来源。
 
-显式 `--source` 始终优先，显式空值可关闭本次归因。仅消费环境标记是否存在，不上传会话标识，不根据 API Key、已安装软件、普通终端名或用户 prompt 猜来源，也不持久化。查询、上传、下载、Canvas 不附加来源。营销脚本的预览与提交采用相同规则；原生 update 也复用该解析，仍写入 `host_platform`，保留旧 source。豆包办公、WorkBuddy 等尚无已核实运行标记的宿主，应优先主动传参或设置上述环境变量。
+非空显式 `--source` 始终优先，空值继续尝试环境识别。仅消费环境标记是否存在，不上传会话标识，不根据 API Key、已安装软件、普通终端名或用户 prompt 猜来源，也不持久化。查询、上传、下载、Canvas 不附加来源。营销脚本的预览与提交采用相同规则；原生 update 也复用该解析，仍写入 `host_platform`，保留旧 source。豆包办公、WorkBuddy 等尚无已核实运行标记的宿主，应优先主动传参或设置上述环境变量。
 
 Cursor 标记依据：[官方终端文档](https://docs.cursor.com/en/agent/terminal)；Gemini 标记依据：[官方命令文档](https://geminicli.com/docs/reference/commands/)。Codex 标记已在本机运行环境核实；Claude Code 标记已在本机安装产物核实。
 
+新增标记依据：[OpenCode 启动入口](https://github.com/anomalyco/opencode/blob/388406238bd5ca15564a762840a2362c3a45bd9c/packages/opencode/src/index.ts#L75-L77)、[Qwen Code shell 环境](https://github.com/QwenLM/qwen-code/blob/e6e2c9efd1dd48bf93143510f7ed1c2413bcea6b/packages/core/src/services/shellExecutionService.ts#L988-L994)、[Cline VS Code 终端环境](https://github.com/cline/cline/blob/e6ad24c43aa2d7551cecdbb97a15269566d3650f/apps/vscode/src/hosts/vscode/terminal/VscodeTerminalRegistry.ts#L28-L34)、[GitHub Copilot CLI 变更记录](https://github.com/github/copilot-cli/blob/main/changelog.md)（0.0.421 增加 `COPILOT_CLI`，1.0.29 增加 `COPILOT_AGENT_SESSION_ID`）。只在子进程实际继承标记时识别，不保证所有宿主版本或启动方式都提供这些标记。
+
 ```bash
 pippit-tool-cli generate-video --prompt "小猫在花园散步" --model Seedance_2.0_mini --source workbuddy
 ```

package/checksums.txt

@@ -1,6 +1,6 @@
-6f7daba79b3423b148e30373bb87e7e8998df3d76be2196e39f84af209f0ea50  pippit-tool-cli-1.0.41-darwin-amd64.tar.gz
-9f03ae01c213a76f45b0dfa110272b45e5b5ecd54b188313c9d256ccbe512980  pippit-tool-cli-1.0.41-darwin-arm64.tar.gz
-ea603412d1c5b0baa42efd34bec92fcd0907333babd64a6e08514d4e2dcb86e5  pippit-tool-cli-1.0.41-linux-amd64.tar.gz
-cebd1f0f34157624c0fc8203eec306bd6c7e31a2db44089f52bca9c74c57ee03  pippit-tool-cli-1.0.41-linux-arm64.tar.gz
-729f413373d185964a42c178a7e0eeafc3fca490670fb753dc36fb38bb47aaf7  pippit-tool-cli-1.0.41-windows-amd64.zip
-b49491ae751e72f994da9388777a43f1b6b5781399dc2da15ced6d74f48dad6d  pippit-tool-cli-1.0.41-windows-arm64.zip
+e7ee32acef1c0a16912c46500ae7f15c46d920953792d1012886fac7e6424b2e  pippit-tool-cli-1.0.43-darwin-amd64.tar.gz
+57e4df86eaa244cd9845eb966299c8c2e1186f74495da0c16f0b378fb4bc5125  pippit-tool-cli-1.0.43-darwin-arm64.tar.gz
+21823c7a675ebcaadebe2ddbfa0324b9e939220d4dd74d5d5d4546f5e6938060  pippit-tool-cli-1.0.43-linux-amd64.tar.gz
+e387bc8eaeafa430a9a594ed1cc381964953b598875b520a6d009a12aec9d619  pippit-tool-cli-1.0.43-linux-arm64.tar.gz
+4569d389a20c75f0485ecc24ad5034308a818f294886dabdf07b2804e915f3a2  pippit-tool-cli-1.0.43-windows-amd64.zip
+078fb4fb09353a58095e1370668884664aad1760ae065983bb23abfdcd9939d1  pippit-tool-cli-1.0.43-windows-arm64.zip

package/cmd/auth/auth.go

@@ -11,15 +11,17 @@ import (
 	internal_auth "github.com/Pippit-dev/pippit-cli/internal/auth"
 	"github.com/Pippit-dev/pippit-cli/internal/commandnames"
 	"github.com/Pippit-dev/pippit-cli/internal/common"
+	"github.com/Pippit-dev/pippit-cli/internal/space"
 	"github.com/spf13/cobra"
 )
 
 type loginResult struct {
-	LoggedIn        bool   `json:"logged_in"`
-	Source          string `json:"source"`
-	UID             string `json:"uid,omitempty"`
-	CredentialScope string `json:"credential_scope,omitempty"`
-	ExpiresAt       string `json:"expires_at,omitempty"`
+	DefaultSpace    *space.Selection `json:"default_space,omitempty"`
+	LoggedIn        bool             `json:"logged_in"`
+	Source          string           `json:"source"`
+	UID             string           `json:"uid,omitempty"`
+	CredentialScope string           `json:"credential_scope,omitempty"`
+	ExpiresAt       string           `json:"expires_at,omitempty"`
 }
 
 type logoutResult struct {
@@ -80,6 +82,18 @@ func NewStatusCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Co
 				return err
 			}
 			result := loginResult{LoggedIn: status.LoggedIn, Source: status.Source, UID: status.UID, CredentialScope: status.CredentialScope}
+			store, scopeErr := common.SpaceStoreForRunner(command.Context(), runner)
+			if scopeErr == nil && store != nil {
+				selected, err := store.Current()
+				scopeErr = err
+				if err == nil {
+					result.DefaultSpace = &selected
+				}
+			}
+			if scopeErr != nil {
+				// Space metadata failures must not be mistaken for expired login.
+				fmt.Fprintf(stderr, "无法读取默认空间：%v\n", scopeErr)
+			}
 			if !status.ExpiresAt.IsZero() {
 				result.ExpiresAt = status.ExpiresAt.Format(time.RFC3339)
 			}

package/cmd/auth/auth_test.go

@@ -5,6 +5,8 @@ import (
 	"context"
 	"encoding/json"
 	"io"
+	"os"
+	"path/filepath"
 	"strings"
 	"testing"
 	"time"
@@ -12,6 +14,7 @@ import (
 	internal_auth "github.com/Pippit-dev/pippit-cli/internal/auth"
 	"github.com/Pippit-dev/pippit-cli/internal/common"
 	"github.com/Pippit-dev/pippit-cli/internal/config"
+	"github.com/Pippit-dev/pippit-cli/internal/space"
 )
 
 type fakeAuthManager struct {
@@ -132,3 +135,23 @@ func TestStatusAndLogoutDoNotModifyExplicitEnvironmentCredential(t *testing.T) {
 		t.Fatalf("logout result/stderr = %#v/%q", result, logoutErr.String())
 	}
 }
+
+func TestStatusDoesNotMistakeSpaceFailureForLoggedOut(t *testing.T) {
+	path := filepath.Join(t.TempDir(), "blocked")
+	if err := os.WriteFile(path, []byte("file"), 0600); err != nil {
+		t.Fatal(err)
+	}
+	manager := &fakeAuthManager{status: &internal_auth.Status{LoggedIn: true, Source: "browser", UID: "123"}}
+	runner := &common.Runner{Config: &config.Config{}, Auth: manager, SpaceStore: &space.Store{Dir: path}}
+	var out, warnings bytes.Buffer
+	if err := NewStatusCommand(&out, &warnings, runner).Execute(); err != nil {
+		t.Fatal(err)
+	}
+	var result loginResult
+	if err := json.Unmarshal(out.Bytes(), &result); err != nil {
+		t.Fatal(err)
+	}
+	if !result.LoggedIn || result.DefaultSpace != nil || !strings.Contains(warnings.String(), "无法读取默认空间") {
+		t.Fatalf("status=%s warning=%s", out.String(), warnings.String())
+	}
+}

package/cmd/canvas/canvas.go

@@ -18,12 +18,12 @@ import (
 
 const maxApplyRequestBytes = 64 << 20
 
-// NewCommand builds the provider-neutral personal Canvas command tree.
+// NewCommand builds the provider-neutral Canvas command tree.
 func NewCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "canvas",
-		Short: "Create and operate personal novel canvases",
-		Long:  "Create and operate personal novel canvases.\n\n" + CommandDiscoveryHelp,
+		Short: "Create and operate novel canvases",
+		Long:  "Create and operate novel canvases in the selected personal or team space.\n\n" + CommandDiscoveryHelp,
 		Args:  cobra.NoArgs,
 	}
 	cmd.SetOut(stdout)
@@ -62,7 +62,7 @@ func newCreateCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Co
 	var opts canvascore.CreateOptions
 	cmd := &cobra.Command{
 		Use:   "create",
-		Short: "Create a personal novel Canvas project",
+		Short: "Create a novel Canvas project in the selected space",
 		Args:  cobra.NoArgs,
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			if strings.TrimSpace(opts.RequestID) == "" {
@@ -100,7 +100,7 @@ func newGetCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Comma
 	var assetIDs []string
 	cmd := &cobra.Command{
 		Use:   "get",
-		Short: "Get personal Canvas assets by ID",
+		Short: "Get Canvas assets by ID in the selected space",
 		Args:  cobra.NoArgs,
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			result, err := canvascore.Get(cmd.Context(), canvascore.GetOptions{AssetIDs: assetIDs}, runner)
@@ -150,7 +150,7 @@ func newApplyCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Com
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
 	flags.StringVar(&filePath, "file", "-", "BatchPatch JSON request file, or - for stdin")
-	flags.StringVar(&projectID, "project-id", "", "personal novel project ID as a decimal string")
+	flags.StringVar(&projectID, "project-id", "", "novel project ID as a decimal string")
 	flags.BoolVar(&transportResult, "transport-result", false, "return explicit transaction outcomes for transport decoding")
 	if err := flags.MarkHidden("transport-result"); err != nil {
 		panic(err)
@@ -162,7 +162,7 @@ func newUploadCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Co
 	var opts canvascore.UploadOptions
 	cmd := &cobra.Command{
 		Use:   "upload",
-		Short: "Upload a file to personal assets and wait until it is queryable",
+		Short: "Upload a file to the selected space and wait until it is queryable",
 		Args:  cobra.NoArgs,
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			result, err := canvascore.Upload(cmd.Context(), opts, runner)

package/cmd/download_result.go

@@ -6,6 +6,7 @@ import (
 	"strconv"
 	"strings"
 
+	"github.com/Pippit-dev/pippit-cli/internal/commandnames"
 	"github.com/Pippit-dev/pippit-cli/internal/common"
 	"github.com/spf13/cobra"
 )
@@ -14,10 +15,10 @@ func newDownloadResultCommand(stdout, stderr io.Writer, runner *common.Runner) *
 	var opts common.DownloadResultOptions
 
 	cmd := &cobra.Command{
-		Use:   "download-result",
+		Use:   commandnames.DownloadResult,
 		Short: "Download a generated result URL",
 		Args:  cobra.NoArgs,
-		RunE: withErrorLog("download-result", func() map[string]string {
+		RunE: withErrorLog(commandnames.DownloadResult, func() map[string]string {
 			fields := map[string]string{
 				"output_path": opts.OutputPath,
 				"has_url":     strconv.FormatBool(strings.TrimSpace(opts.URL) != ""),

package/cmd/marketing.go

@@ -18,8 +18,8 @@ import (
 )
 
 var marketingPaths = map[string]string{
-	"generate": "/api/biz/v1/agent/submit_marketing_run",
-	"query":    "/api/biz/v1/agent/query_generate_video_result",
+	"generate": config.SubmitMarketingRunPath,
+	"query":    config.QueryGenerateVideoResultPath,
 	"upload":   config.UploadFilePath,
 	"balance":  config.GetCreditBalancePath,
 }
@@ -103,7 +103,19 @@ func newMarketingAction(action string, stdout, stderr io.Writer, runner *common.
 			}
 			body = value
 			if !execute {
-				return common.WriteJSON(stdout, map[string]any{"dry_run": true, "url": config.DefaultBaseURL + marketingPaths[action], "body": body})
+				if session := common.SpaceSession(cmd.Context()); session != nil {
+					if err := session.CheckIdentity(cmd.Context()); err != nil {
+						return err
+					}
+					ref, err := common.SpaceReferences(body)
+					if err != nil {
+						return err
+					}
+					if _, err := session.Resolve(ref); err != nil {
+						return err
+					}
+				}
+				return common.WriteJSON(stdout, map[string]any{"dry_run": true, "url": config.DefaultBaseURL + marketingPaths[action], "body": body, "team_id": common.SpaceTeamID(cmd.Context())})
 			}
 		case "query":
 			if strings.TrimSpace(threadID) == "" || strings.TrimSpace(runID) == "" {
@@ -143,6 +155,10 @@ func newMarketingAction(action string, stdout, stderr io.Writer, runner *common.
 			_ = json.Unmarshal(result["log_id"], &logID)
 			return common.NewLogIDError(fmt.Sprintf("营销 API 失败: ret=%s errmsg=%s", ret, message), logID)
 		}
+		result["team_id"], _ = json.Marshal(common.SpaceTeamID(ctx))
+		if session := common.SpaceSession(ctx); session != nil {
+			result["space_context"], _ = json.Marshal(session.Token())
+		}
 		return common.WriteJSON(stdout, result)
 	}
 	return command

package/cmd/marketing_test.go

@@ -17,6 +17,7 @@ import (
 	"github.com/Pippit-dev/pippit-cli/internal/adapter"
 	"github.com/Pippit-dev/pippit-cli/internal/auth"
 	"github.com/Pippit-dev/pippit-cli/internal/config"
+	"github.com/Pippit-dev/pippit-cli/internal/space"
 )
 
 type marketingCredentialStore struct {
@@ -128,6 +129,7 @@ func TestMarketingUsesSharedBrowserAuth(t *testing.T) {
 			cfg.AccessKey = ""
 			store := &marketingCredentialStore{credential: &auth.Credential{AccessKey: "browser-secret", UID: "user", DeviceID: "device", ExpiredAt: time.Now().Add(time.Hour).Unix()}}
 			runner := newRootRunner(cfg)
+			runner.SpaceStore = &space.Store{Dir: t.TempDir()}
 			runner.Auth = auth.NewManager(cfg, auth.WithCredentialStore(store))
 			var output bytes.Buffer
 			root := newRootCommand(&output, io.Discard, runner)
@@ -149,7 +151,7 @@ func TestMarketingUsesSharedBrowserAuth(t *testing.T) {
 			if err := root.Execute(); err != nil {
 				t.Fatal(err)
 			}
-			if calls != 1 || store.loads != 1 {
+			if calls != 1 || store.loads != 2 {
 				t.Fatalf("HTTP calls=%d credential loads=%d", calls, store.loads)
 			}
 			if strings.Contains(output.String(), "browser-secret") || !strings.Contains(output.String(), "log-test") {
@@ -187,7 +189,7 @@ func TestMarketingAuthFailureAndEnvironmentPrecedence(t *testing.T) {
 			root.SetArgs([]string{"marketing", "balance"})
 			err := root.Execute()
 			if scenario == "override" {
-				if err != nil || calls != 1 || store.loads != 0 {
+				if err != nil || calls != 1 || store.loads != 1 {
 					t.Fatalf("override: err=%v calls=%d loads=%d", err, calls, store.loads)
 				}
 			} else if err == nil || !strings.Contains(err.Error(), "pippit-tool-cli login") || calls != 0 {
@@ -197,7 +199,7 @@ func TestMarketingAuthFailureAndEnvironmentPrecedence(t *testing.T) {
 	}
 }
 
-func TestMarketingPreviewAndHelpDoNotReadCredentials(t *testing.T) {
+func TestMarketingOfflineCommandsReadIdentityOnlyWhenNeeded(t *testing.T) {
 	for _, args := range [][]string{{"marketing", "--help"}, {"marketing", "generate", "--request", "-"}, {"marketing", "query"}} {
 		cfg := config.Load()
 		cfg.AccessKey = ""
@@ -214,8 +216,12 @@ func TestMarketingPreviewAndHelpDoNotReadCredentials(t *testing.T) {
 		if args[1] == "query" && err == nil {
 			t.Fatal("missing IDs accepted")
 		}
-		if store.loads != 0 {
-			t.Fatal("offline operation accessed credentials")
+		wantLoads := 1 // Resolve the local account for space selection, without requiring login.
+		if args[1] == "--help" {
+			wantLoads = 0
+		}
+		if store.loads != wantLoads {
+			t.Fatalf("%v: credential loads=%d, want %d", args, store.loads, wantLoads)
 		}
 	}
 }

package/cmd/model.go

@@ -6,6 +6,7 @@ import (
 	"strings"
 	"time"
 
+	"github.com/Pippit-dev/pippit-cli/internal/commandnames"
 	"github.com/Pippit-dev/pippit-cli/internal/common"
 	"github.com/Pippit-dev/pippit-cli/internal/models"
 	"github.com/spf13/cobra"
@@ -40,11 +41,11 @@ func newModelCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Com
 		return common.WriteJSON(stdout, output)
 	}
 	cmd := &cobra.Command{
-		Use:   "model [name-or-key]",
+		Use:   commandnames.Model + " [name-or-key]",
 		Short: "Discover available image and video models and their server configuration",
 		Long:  "Query available image and video models using your current credentials. Select images by their full display name (in quotes), videos by key. Successful queries are cached locally for 5 minutes. Use --refresh to bypass the cache; retry if a query fails.",
 		Args:  cobra.MaximumNArgs(1),
-		RunE: withErrorLog("model", nil, func(cmd *cobra.Command, args []string) error {
+		RunE: withErrorLog(commandnames.Model, nil, func(cmd *cobra.Command, args []string) error {
 			return query(cmd, args, len(args) > 0)
 		}),
 	}
@@ -56,14 +57,14 @@ func newModelCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Com
 		Use: "list [query]", Aliases: []string{"search"},
 		Short: "List models; search images by name, videos by key or name",
 		Args:  cobra.MaximumNArgs(1),
-		RunE: withErrorLog("model list", nil, func(cmd *cobra.Command, args []string) error {
+		RunE: withErrorLog(commandnames.Model+" list", nil, func(cmd *cobra.Command, args []string) error {
 			return query(cmd, args, false)
 		}),
 	})
 	cmd.AddCommand(&cobra.Command{
 		Use: "describe <name-or-key>", Short: "Show model parameters; use the full image name or video key",
 		Args: cobra.ExactArgs(1),
-		RunE: withErrorLog("model describe", nil, func(cmd *cobra.Command, args []string) error {
+		RunE: withErrorLog(commandnames.Model+" describe", nil, func(cmd *cobra.Command, args []string) error {
 			return query(cmd, args, true)
 		}),
 	})

package/cmd/root.go

@@ -20,6 +20,7 @@ import (
 	"github.com/Pippit-dev/pippit-cli/internal/common"
 	"github.com/Pippit-dev/pippit-cli/internal/config"
 	"github.com/Pippit-dev/pippit-cli/internal/version"
+	"github.com/Pippit-dev/pippit-cli/internal/versioncheck"
 	"github.com/spf13/cobra"
 )
 
@@ -86,17 +87,27 @@ func newRootCommandWithAdapter(stdout, stderr io.Writer, runner *common.Runner,
 		SilenceUsage:  true,
 		SilenceErrors: true,
 	}
-	// Only commands already exposing --source receive attribution. Explicit empty
-	// flags suppress fallback, and no source is persisted between CLI processes.
+	// Only commands already exposing --source receive attribution. Missing or blank
+	// flags allow fallback, and no source is persisted between CLI processes.
+	// 子命令执行 pre hook
 	root.PersistentPreRunE = func(cmd *cobra.Command, _ []string) error {
+		if policy.CLIOptions().SelfUpdateEnabled && cmd.Runnable() {
+			versioncheck.Check(cmd.Context(), stderr, version.BuildVersion(), cmd.Name())
+		}
 		flag := cmd.Flags().Lookup("source")
-		if flag != nil && !flag.Changed {
+		if flag != nil && (!flag.Changed || strings.TrimSpace(flag.Value.String()) == "") {
 			if source := common.DetectHostSource(); source != "" {
-				return cmd.Flags().Set("source", source)
+				if err := cmd.Flags().Set("source", source); err != nil {
+					return err
+				}
 			}
 		}
-		return nil
+		return prepareCommandSpace(cmd, runner, stderr)
 	}
+	// 定义根命令和子命令都能使用的字符串参数
+	root.PersistentFlags().String("team-id", "", "本次业务操作的空间：0 为个人空间，正整数为团队空间；不改变默认空间")
+	root.PersistentFlags().String("space-context", "", "固定跨进程操作的账号、API origin 和空间")
+	_ = root.PersistentFlags().MarkHidden("space-context")
 	root.CompletionOptions.DisableDefaultCmd = true
 	root.SetVersionTemplate("{{.Version}}\n")
 	root.SetOut(stdout)
@@ -104,6 +115,7 @@ func newRootCommandWithAdapter(stdout, stderr io.Writer, runner *common.Runner,
 	root.AddCommand(authcmd.NewLoginCommand(stdout, stderr, runner))
 	root.AddCommand(authcmd.NewStatusCommand(stdout, stderr, runner))
 	root.AddCommand(authcmd.NewLogoutCommand(stdout, stderr, runner))
+	root.AddCommand(newSpaceCommand(stdout, runner))
 	root.AddCommand(canvascmd.NewCommand(stdout, stderr, runner))
 	root.AddCommand(newDownloadResultCommand(stdout, stderr, runner))
 	root.AddCommand(newGetCreditBalanceCommand(stdout, stderr, runner))