@pippit-dev/cli 1.0.41 → 1.0.43

package/internal/versioncheck/semver.go

@@ -0,0 +1,84 @@
+package versioncheck
+
+import (
+	"regexp"
+	"strconv"
+	"strings"
+)
+
+var semverPattern = regexp.MustCompile(`^v?(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$`)
+
+type semver struct {
+	core [3]uint64
+	pre  []string
+}
+
+func parseVersion(value string) (semver, bool) {
+	var parsed semver
+	if len(value) > 256 {
+		return parsed, false
+	}
+	parts := semverPattern.FindStringSubmatch(value)
+	if parts == nil {
+		return parsed, false
+	}
+	for index := range parsed.core {
+		part, err := strconv.ParseUint(parts[index+1], 10, 64)
+		if err != nil {
+			return parsed, false
+		}
+		parsed.core[index] = part
+	}
+	if parts[4] != "" {
+		parsed.pre = strings.Split(parts[4], ".")
+		for _, identifier := range parsed.pre {
+			if numeric(identifier) && len(identifier) > 1 && identifier[0] == '0' {
+				return parsed, false
+			}
+		}
+	}
+	return parsed, true
+}
+
+func isNewer(latest, current string) bool {
+	a, validA := parseVersion(latest)
+	b, validB := parseVersion(current)
+	if !validA || !validB {
+		return false
+	}
+	for index, part := range a.core {
+		if part != b.core[index] {
+			return part > b.core[index]
+		}
+	}
+	if len(a.pre) == 0 || len(b.pre) == 0 {
+		return len(a.pre) == 0 && len(b.pre) != 0
+	}
+	for index, part := range a.pre {
+		if index >= len(b.pre) {
+			return true
+		}
+		other := b.pre[index]
+		if part == other {
+			continue
+		}
+		numericA, numericB := numeric(part), numeric(other)
+		if numericA != numericB {
+			return !numericA
+		}
+		if numericA && len(part) != len(other) {
+			return len(part) > len(other)
+		}
+		return part > other
+	}
+	return false
+}
+
+func numeric(value string) bool {
+	for _, character := range value {
+		if character < '0' || character > '9' {
+			return false
+		}
+	}
+	return value != ""
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pippit-dev/cli",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "description": "Pippit CLI",
   "bin": {
     "pippit-tool-cli": "scripts/run.js"

package/scripts/canvas-command.js

@@ -17,6 +17,8 @@ const DEFAULT_SDK_MODULE = path.join(
   "xyq-canvas-command-runtime.cjs"
 );
 const MAX_INPUT_BYTES = 64 * 1024 * 1024;
+const UPGRADE_NOTICE_PREFIX = "[pippit-tool-cli] New version available:";
+const LOGIN_UPGRADE_NOTICE = "[pippit-tool-cli] If browser authorization fails, update the CLI and run pippit-tool-cli login again.";
 const PERSISTENCE_VERSION = 1;
 const OPTIONAL_SCHEMA = Symbol("optional canvas command schema");
 const CHECKPOINT_COMMANDS = new Set([
@@ -46,13 +48,32 @@ const COMMAND_HELP = `用法:
 list 返回简短索引；describe 按层展示字段和可选操作，使用 --path 展开 schema_path。
 guide 按主题说明时间、引用和工作流；schema 显式导出完整 schema（可能很大）。
 这些发现入口无需登录；run 需要目标画布的访问权限。
+run 使用默认空间，可通过 --team-id <ID> 覆盖；0 为个人空间。
 `;
 
+function canvasSpaceArgs(args) {
+  const clean = [];
+  let teamID;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--team-id" || args[i].startsWith("--team-id=")) {
+      const value = args[i] === "--team-id" ? args[++i] : args[i].slice("--team-id=".length);
+      if (teamID !== undefined || !/^\d+$/.test(value || "") || BigInt(value) > 9223372036854775807n) throw new Error("team-id 必须为唯一的 0 或正整数 ID");
+      teamID = BigInt(value).toString();
+    } else clean.push(args[i]);
+  }
+  return { args: clean, teamID };
+}
+
 function isCanvasCommand(args) {
-  return args[0] === "canvas" && args[1] === "command";
+  // Global team-id may appear before or after the command. Other flags retain
+  // their existing parser and are never forwarded into canvas mutation JSON.
+  let start = 0;
+  while (args[start] === "--team-id" || (args[start] || "").startsWith("--team-id=")) start += args[start] === "--team-id" ? 2 : 1;
+  return args[start] === "canvas" && args[start + 1] === "command";
 }
 
 function parseCanvasCommandArgs(args) {
+  args = canvasSpaceArgs(args).args;
   if (!isCanvasCommand(args)) throw new Error("仅支持 canvas command 命令");
   const values = args.slice(2);
   if (!values.length || values[0] === "--help" || values[0] === "-h") {
@@ -144,6 +165,7 @@ function spawnProcess(invocation, args, options = {}) {
     }
     const child = spawn(invocation.command, [...(invocation.prefixArgs || []), ...args], {
       cwd: options.cwd,
+      env: invocation.env || process.env,
       shell: false,
       stdio: options.interactive ? "inherit" : ["pipe", "pipe", "pipe"],
       windowsHide: true,
@@ -193,19 +215,34 @@ class NativeCanvasClient {
     this.invocation = invocation;
     this.cwd = options.cwd;
     this.stderr = options.stderr || process.stderr;
+    this.teamID = options.teamID;
   }
 
   async runJSON(args, input) {
+    if (args[0] === "canvas" && this.teamID !== undefined) args = [...args, "--team-id", this.teamID];
+    if (args[0] === "canvas" && this.spaceContext) args = [...args, "--space-context", this.spaceContext];
     const result = await spawnProcess(this.invocation, args, {
       cwd: this.cwd,
       input: input === undefined ? undefined : JSON.stringify(input),
     });
     if (result.exitCode !== 0) throw new NativeCommandError(args, result);
+    let output;
     try {
-      return JSON.parse(result.stdout);
+      output = JSON.parse(result.stdout);
+      // The first canvas get resolves the space in Go. Reuse its binding for
+      // every SDK transport call, even if another process changes the default.
+      if (args[0] === "canvas" && output.team_id !== undefined) {
+        this.teamID = output.team_id;
+        this.spaceContext = output.space_context;
+      }
     } catch (error) {
       throw new Error(`原生 CLI 未返回有效 JSON（${args.join(" ")}）：${error.message}`);
     }
+    const notices = result.stderr.split(/\r?\n/).filter((line) =>
+      line.startsWith(UPGRADE_NOTICE_PREFIX) || line === LOGIN_UPGRADE_NOTICE
+    );
+    if (notices.length) this.stderr.write(`${notices.join("\n")}\n`);
+    return output;
   }
 
   async ensureAuthenticated() {
@@ -777,6 +814,7 @@ function executePublicCommand(route, definitions, input) {
 }
 
 async function runCanvasCommand(args, options = {}) {
+  const { teamID } = canvasSpaceArgs(args);
   const parsed = parseCanvasCommandArgs(args);
   const stdout = options.stdout || process.stdout;
   const stderr = options.stderr || process.stderr;
@@ -833,8 +871,11 @@ async function runCanvasCommand(args, options = {}) {
   const input = parseInputJSON(parsed, cwd);
   const route = routes.get(parsed.commandName);
   validatePublicCommandInput(route, input);
-  const nativeClient = new NativeCanvasClient(options.nativeInvocation, { cwd, stderr });
+  const nativeClient = new NativeCanvasClient(options.nativeInvocation, { cwd, stderr, teamID });
   const authStatus = await nativeClient.ensureCanvasAccess(parsed.canvasId);
+  const credentialScope = authStatus.credential_scope && nativeClient.teamID && nativeClient.teamID !== "0"
+    ? `${authStatus.credential_scope}:team:${nativeClient.teamID}`
+    : authStatus.credential_scope;
   const requiresDurableCheckpoint = CHECKPOINT_COMMANDS.has(parsed.commandName) ||
     (parsed.commandName === "apply_mutations" && input.checkpointBefore === true);
   if (requiresDurableCheckpoint && !authStatus.credential_scope) {
@@ -844,7 +885,7 @@ async function runCanvasCommand(args, options = {}) {
   const checkpointStore = authStatus.credential_scope
     ? createFileCheckpointStore({
         canvasId: parsed.canvasId,
-        credentialScope: authStatus.credential_scope,
+        credentialScope,
         stateDirectory: options.stateDirectory,
       })
     : undefined;
@@ -863,7 +904,7 @@ async function runCanvasCommand(args, options = {}) {
   const persistence = authStatus.credential_scope
     ? createFilePersistence({
         canvasId: parsed.canvasId,
-        credentialScope: authStatus.credential_scope,
+        credentialScope,
         stateDirectory: options.stateDirectory,
       })
     : createMemoryPersistence();
@@ -954,6 +995,7 @@ module.exports = {
   createSchemaFactory,
   definitionToJSON,
   ensureNodeRuntimeGlobals,
+  canvasSpaceArgs,
   isCanvasCommand,
   parseCanvasCommandArgs,
   runCanvasCommand,

package/scripts/install-wizard.js

@@ -21,7 +21,7 @@ PIPPIT_CLI_INSTALL_PACKAGE can override the package/version to install.
 
 Options:
   --source HOST  Real host identifier reported as host_platform; unknown hosts omit it
-                 Defaults to PIPPIT_CLI_SOURCE, then known host runtime markers; an explicit empty value omits host_platform
+                 Missing or blank values default to PIPPIT_CLI_SOURCE, then known host runtime markers
   -h, --help  Show this help without installing, updating, or sending telemetry
 `;
 

package/scripts/run.js

@@ -3,12 +3,14 @@
 const { execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
-const { isCanvasCommand, runCanvasCommand } = require('./canvas-command');
+const { isCanvasCommand, parseCanvasCommandArgs, runCanvasCommand, canvasSpaceArgs } = require('./canvas-command');
 const { maybeWarnNewVersion } = require('./version-check');
 
 const ext = process.platform === 'win32' ? '.exe' : '';
 const bin = path.join(__dirname, '..', 'bin', 'pippit-tool-cli' + ext);
 const args = process.argv.slice(2);
+// The launcher owns the notice for this invocation, including native children.
+const nativeEnv = { ...process.env, PIPPIT_CLI_UPDATE_CHECKED: '1' };
 
 const oldBin = bin + '.old';
 function restoreOldBinary() {
@@ -25,7 +27,7 @@ function restoreOldBinary() {
 
 function runCanvas() {
   runCanvasCommand(args, {
-    nativeInvocation: { command: bin },
+    nativeInvocation: { command: bin, env: nativeEnv },
   })
     .then((exitCode) => {
       if (exitCode) process.exitCode = exitCode;
@@ -43,7 +45,16 @@ function main() {
   }
 
   const helpRequested = args.includes('--help') || args.includes('-h') || args[0] === 'help';
-  if (isCanvasCommand(args) && (args[2] !== 'run' || helpRequested)) {
+  if (isCanvasCommand(args) && (canvasSpaceArgs(args).args[2] !== 'run' || helpRequested)) {
+    // Discovery commands also need update notices. Keep help and invalid
+    // commands free of network checks and cache writes.
+    if (!helpRequested) {
+      try {
+        if (parseCanvasCommandArgs(args).action !== 'help') maybeWarnNewVersion(args);
+      } catch (_) {
+        // runCanvas reports argument errors through the existing path.
+      }
+    }
     return runCanvas();
   }
 
@@ -88,7 +99,7 @@ function main() {
     runCanvas();
   } else {
     try {
-      execFileSync(bin, args, { stdio: 'inherit' });
+      execFileSync(bin, args, { stdio: 'inherit', env: nativeEnv });
     } catch (e) {
       process.exit(e.status || 1);
     }

package/scripts/telemetry.js

@@ -21,12 +21,14 @@ function telemetryBaseURL() {
 
 // Keep the same attribution rules as native CLI common.DetectHostSource.
 function resolveHostSource(explicit) {
-  if (explicit !== undefined) return explicit.trim();
+  if (explicit !== undefined && explicit.trim()) return explicit.trim();
   if ((process.env.PIPPIT_CLI_SOURCE || "").trim()) return process.env.PIPPIT_CLI_SOURCE.trim();
   const hosts = new Set();
   for (const [key, host] of [
     ["CODEX_THREAD_ID", "codex"], ["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", "github_copilot_cli"], ["COPILOT_AGENT_SESSION_ID", "github_copilot_cli"],
   ]) {
     const value = (process.env[key] || "").trim().toLowerCase();
     if (value && value !== "0" && value !== "false") hosts.add(host);

package/scripts/version-check.js

@@ -5,6 +5,7 @@ const { runSilent } = require("./platform");
 const { DEFAULT_PKG } = require("./skills");
 
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const RETRY_INTERVAL_MS = 5 * 60 * 1000;
 
 function defaultCacheFile() {
   return path.join(os.homedir(), ".pippit_tool_cli", "version-check.json");
@@ -49,7 +50,7 @@ function writeCache(cacheFile, data) {
 }
 
 function fetchLatestVersion(pkg = DEFAULT_PKG) {
-  return runSilent("npm", ["view", pkg, "version"], { timeout: 3000 }).toString().trim();
+  return runSilent("npm", ["view", pkg, "version"], { timeout: 1000 }).toString().trim();
 }
 
 function shouldSkip(args, env) {
@@ -70,6 +71,7 @@ function maybeWarnNewVersion(args = [], opts = {}) {
   const cacheFile = opts.cacheFile || defaultCacheFile();
   const cache = readCache(cacheFile);
   const cacheFresh = cache && now - cache.checkedAt < CHECK_INTERVAL_MS;
+  if (cacheFresh && !cache.latest && now - cache.checkedAt < RETRY_INTERVAL_MS) return;
 
   let latest = cacheFresh ? cache.latest : "";
   if (!latest) {
@@ -77,6 +79,7 @@ function maybeWarnNewVersion(args = [], opts = {}) {
       latest = (opts.fetchLatestVersion || fetchLatestVersion)(opts.pkg || DEFAULT_PKG);
       writeCache(cacheFile, { latest, checkedAt: now });
     } catch (_) {
+      writeCache(cacheFile, { latest: "", checkedAt: now });
       return;
     }
   }
@@ -86,10 +89,14 @@ function maybeWarnNewVersion(args = [], opts = {}) {
 
   const warn = opts.warn || console.error;
   warn(`[pippit-tool-cli] New version available: ${current} -> ${latest}. Run: pippit-tool-cli update`);
+  if (args[0] === "login") {
+    warn("[pippit-tool-cli] If browser authorization fails, update the CLI and run pippit-tool-cli login again.");
+  }
 }
 
 module.exports = {
   CHECK_INTERVAL_MS,
+  RETRY_INTERVAL_MS,
   compareSemver,
   defaultCacheFile,
   maybeWarnNewVersion,

package/skills/short-drama/SKILL.md

@@ -16,6 +16,17 @@ metadata:
 2. 需要业务调用时先按 [授权](commands/auth.md) 执行 `status`，已有登录可复用。
 3. 按下表读取命中的命令说明。提交、续接和处理后端问题必须读 [创作与会话续接](workflows/creation.md)；查询或取得产物必须读 [轮询与文件交付](workflows/poll-and-deliver.md)。
 
+## Space Selection
+
+业务命令支持个人和团队空间，复用同一个 CLI 登录凭据。执行前先检查 `pippit-tool-cli space --help` 和业务命令的 `--team-id`；旧版不支持时先更新 CLI，不能忽略团队选择后继续收费操作。
+
+- `space list` 统一输出 JSON，列出个人和当前账号的团队；顶层 `current` 表示已保存的默认空间，列表项 `current: true` 标记当前选择，无法识别本地账号时顶层为 `null`。`team_id` 保留字符串，`0` 为个人。列表中的团队不代表有生成权限、有效订阅或可用积分，最终由服务端判断。
+- 用户明确要求长期切换时，运行 `space use TEAM_ID`；`space use 0` 保存个人空间。`use` 必须指定 ID，成功后返回保存的空间，不等待交互输入。只为本次任务选择空间时使用 `--team-id TEAM_ID`，不修改用户默认值；不能按模糊名称或剩余积分自动选团队。
+- 新创作未指定空间时，读取并沿用保存的默认空间，首次使用为个人。向用户说明本次空间与积分账户，不重复索要已有授权。一次工作流开始后保存 TeamID，分开的上传、提交、查询和余额命令均显式传相同 `--team-id`，不能中途重新读取默认值。
+- 已有任务优先沿用提交结果中的 `team_id` 或 CLI 的任务记录；切换默认团队后可以直接按原 thread/run 查询，CLI 自动恢复原空间。不要把当前默认 TeamID 强加给旧任务。跨设备或旧任务没有记录时，使用已知原空间；未知且用户也未指定时先核实，不能轮流试团队。
+- 保存上传结果的资产 ID 和 `team_id`，提交结果的 thread/run ID 和 `team_id`。跨空间资产或任务冲突时停止；无权限、会员失效或余额不足不回退个人或其它团队。提交成功但本地记录写入失败时，保留返回 ID，用原 `--team-id` 查询，不重新生成。
+- CLI 向同源 API 统一透传当前团队的 TeamID；模型接口内部继续按个人身份查询；模型列表成功不代表团队有生成权限。Canvas 同样使用所选空间；操作已有画布时沿用该画布原空间，切换默认空间后仍显式传入原 `--team-id`。
+
 ## 意图路由
 
 | 用户意图 | CLI | 必读文档 |
@@ -44,7 +55,7 @@ metadata:
 
 ## 宿主来源统计
 
-优先从宿主的系统身份、当前工具运行环境和明确的平台元数据确认真实宿主，并在每次提交主动填写 `--source`；不要仅因字段可选就跳过。缺少显式值时，CLI 依次尝试 `PIPPIT_CLI_SOURCE` 和已核实的宿主运行标记。只上报稳定的平台名，不上报标记中的会话 ID；来源冲突或仍无法确认则省略，不询问用户、不扫描登录凭据或安装目录。显式 `--source ""` 禁用该次自动归因。
+优先从宿主的系统身份、当前工具运行环境和明确的平台元数据确认真实宿主，并在每次提交主动填写 `--source`；不要仅因字段可选就跳过。未传 `--source`、显式空值或纯空白时，CLI 依次尝试 `PIPPIT_CLI_SOURCE` 和已核实的宿主运行标记。只上报稳定的平台名，不上报标记中的会话 ID；来源冲突或仍无法确认则省略，不询问用户、不扫描登录凭据或安装目录。
 
 仅 `short-drama +submit-run` 静默附加可选 `--source`，用于统计：豆包办公 `doubao_office`、WorkBuddy `workbuddy`、Codex `codex`；其它宿主使用可信环境中的真实稳定标识，无法确认则省略。不从创作文本猜来源，不附带版本、会话 ID、用户信息或 prompt，不向用户询问，不改写 `--message`。上传、查询、下载不附加此参数；旧 CLI 的 `--help` 不支持时省略，不为统计字段重提任务。
 

package/skills/xyq-marketing-skill/SKILL.md

@@ -22,6 +22,25 @@ metadata:
 
 先按 [接口契约](references/api.md) 准备请求；需要完整执行示例时读 [商品图到营销视频](examples/product-video.md)。
 
+## Space Selection
+
+业务命令支持个人和团队空间，复用同一个 CLI 登录凭据。执行前先检查 `pippit-tool-cli space --help` 和业务命令的 `--team-id`；旧版不支持时先更新 CLI，不能忽略团队选择后继续收费操作。
+
+- `space list` 统一输出 JSON，列出个人和当前账号的团队；顶层 `current` 表示已保存的默认空间，列表项 `current: true` 标记当前选择，无法识别本地账号时顶层为 `null`。`team_id` 保留字符串，`0` 为个人。列表中的团队不代表有生成权限、有效订阅或可用积分，最终由服务端判断。
+- 用户明确要求长期切换时，运行 `space use TEAM_ID`；`space use 0` 保存个人空间。`use` 必须指定 ID，成功后返回保存的空间，不等待交互输入。只为本次任务选择空间时使用 `--team-id TEAM_ID`，不修改用户默认值；不能按模糊名称或剩余积分自动选团队。
+- 新创作未指定空间时，读取并沿用保存的默认空间，首次使用为个人。向用户说明本次空间与积分账户，不重复索要已有授权。一次工作流开始后保存 TeamID，分开的上传、提交、查询和余额命令均显式传相同 `--team-id`，不能中途重新读取默认值。
+- 已有任务优先沿用提交结果中的 `team_id` 或 CLI 的任务记录；切换默认团队后可以直接按原 thread/run 查询，CLI 自动恢复原空间。不要把当前默认 TeamID 强加给旧任务。跨设备或旧任务没有记录时，使用已知原空间；未知且用户也未指定时先核实，不能轮流试团队。
+- 保存上传结果的资产 ID 和 `team_id`，提交结果的 thread/run ID 和 `team_id`。跨空间资产或任务冲突时停止；无权限、会员失效或余额不足不回退个人或其它团队。提交成功但本地记录写入失败时，保留返回 ID，用原 `--team-id` 查询，不重新生成。
+- CLI 向同源 API 统一透传当前团队的 TeamID；模型接口内部继续按个人身份查询；模型列表成功不代表团队有生成权限。Canvas 同样使用所选空间；操作已有画布时沿用该画布原空间，切换默认空间后仍显式传入原 `--team-id`。
+
+营销脚本的 `upload / generate / query / balance` 都支持 `--team-id TEAM_ID`。预览也读取同一空间；`query --wait` 固定 TeamID，本地账号可识别时同时固定账号和 API origin，切换账号则停止。无本地账号记录时，显式传入原 `--team-id` 仍可轮询，由 API 按当前凭据鉴权；不能读取默认值代替原任务空间。不要手工构造内部 `space_context`；使用原任务查询命令恢复。不同脚本调用之间仍需由宿主保留任务原 TeamID。
+
+```bash
+node scripts/marketing.js upload --file /path/to/product.png --team-id TEAM_ID
+node scripts/marketing.js generate --request /path/to/request.json --execute --team-id TEAM_ID
+node scripts/marketing.js query --thread-id THREAD_ID --run-id RUN_ID --wait --team-id TEAM_ID
+```
+
 ## Workflow
 
 1. 确认用户要生成的营销内容与商品素材。保留用户原始指令，不主动扩写或加入未经提供的卖点。仅查询、接入咨询或估算不提交生成；明确要求生成即可执行，不重复询问已给出的授权。必要的补充信息用宿主当前允许的 `request_user_input_async`、`request_user_input` 或 `ask_user_question` 询问，没有工具时用普通聊天。
@@ -42,9 +61,9 @@ node scripts/marketing.js balance
 
 ## Source Attribution
 
-仅营销生成命令（`marketing generate` 或 `marketing.js generate`）静默附加可选 `--source`，由 CLI 映射为请求体 `platform`，不写入创作文本或请求文件。豆包办公填 `doubao_office`，WorkBuddy 填 `workbuddy`，Codex 填 `codex`；其它宿主使用可信环境中的真实稳定标识，未知则省略，不询问用户。不附带版本、会话 ID、用户信息或 prompt。首尾空白去除，未传或空值省略；首次生成和同一会话继续提交均适用。上传、查询、下载、余额不附加。旧 CLI 不支持时省略，不为来源统计重提任务。
+仅营销生成命令（`marketing generate` 或 `marketing.js generate`）静默附加可选 `--source`，由 CLI 映射为请求体 `platform`，不写入创作文本或请求文件。豆包办公填 `doubao_office`，WorkBuddy 填 `workbuddy`，Codex 填 `codex`；其它宿主使用可信环境中的真实稳定标识，未知则省略，不询问用户。不附带版本、会话 ID、用户信息或 prompt。首尾空白去除，未传或空值时先读取 `PIPPIT_CLI_SOURCE`、再尝试已核实的宿主运行标记，仍无法识别时省略；首次生成和同一会话继续提交均适用。上传、查询、下载、余额不附加。旧 CLI 不支持时省略，不为来源统计重提任务。
 
-优先从宿主的系统身份、当前工具运行环境和明确的平台元数据确认真实宿主，并在每次提交主动填写 `--source`；不要仅因字段可选就跳过。缺少显式值时，CLI 依次尝试 `PIPPIT_CLI_SOURCE` 和已核实的宿主运行标记。只上报稳定的平台名，不上报标记中的会话 ID；来源冲突或仍无法确认则省略，不询问用户、不扫描登录凭据或安装目录。显式 `--source ""` 禁用该次自动归因。
+优先从宿主的系统身份、当前工具运行环境和明确的平台元数据确认真实宿主，并在每次提交主动填写 `--source`；不要仅因字段可选就跳过。未传 `--source`、显式空值或纯空白时，CLI 依次尝试 `PIPPIT_CLI_SOURCE` 和已核实的宿主运行标记。只上报稳定的平台名，不上报标记中的会话 ID；来源冲突或仍无法确认则省略，不询问用户、不扫描登录凭据或安装目录。
 
 ## Completion and Recovery
 
@@ -58,4 +77,4 @@ node scripts/marketing.js balance
 
 ## Scope
 
-本 Skill 仅使用正式公开营销接口；不宣称支持团队空间切换。鉴权范围沿用当前 CLI 登录身份和服务端授权，公开请求没有 `TeamID` 字段，不自行加入团队字段或跨账号复用资产/任务 ID。沉浸式短片、火山引擎服务不在此脚本范围。
+本 Skill 使用 CLI 登录和服务端空间授权，通过 `--team-id` 选择个人或团队，CLI 将其写入 HTTP Header；不向营销请求 JSON 添加 `TeamID` / `team_id`，不跨账号复用资产或任务。沉浸式短片、火山引擎服务不在此脚本范围。

package/skills/xyq-marketing-skill/references/api.md

@@ -22,7 +22,7 @@ Base URL：`https://xyq.jianying.com`。全部使用 POST，`Accept: application
 | `general_agent_settings` | object | 必传，且必须包含非空 `video_model` |
 | `thread_id` | string | 可选，只在继续已有营销会话时使用 |
 
-来源统计由生成命令的可选 `--source HOST` 提供，CLI 在提交及预览的请求体中映射为 `platform` 字符串；不传或去除首尾空白后为空时省略。请求文件仍只填写上表中的创作字段，不直接添加 `source` 或 `platform`。
+来源统计由生成命令的可选 `--source HOST` 提供，CLI 在提交及预览的请求体中映射为 `platform` 字符串；不传或去除首尾空白后为空时，依次尝试 `PIPPIT_CLI_SOURCE` 和已核实的宿主运行标记，仍未知则省略。请求文件仍只填写上表中的创作字段，不直接添加 `source` 或 `platform`。
 
 设置块必须传对象，且 `video_model` 必填。2026-09-22 实际调用及服务端 `validateMarketingGeneralAgentSettings` 均确认：`{}` 或仅有比例/时长会返回 `ret=2`、缺少 `video_model`。不再按文档中的默认策略说明发送空对象；预览和提交都先本地校验。用户未指定模型时先询问，已有明确选择授权时按授权选择，不隐式降级。
 
@@ -63,3 +63,9 @@ HTTP 成功还需检查 `ret` 为 `"0"` 或 `0`；失败保留 `errmsg` 和 `log
 查询接口透传 Run 状态；仅在 3 时提取媒体，4/5 时提取失败原因，其它状态返回空媒体数组。因此 9 的空 `video_urls` 不能解释为生成失败。状态 3 也不保证有视频；以真实媒体列表判断交付。未知数值保留原始响应并停止，不自动重提或无期限轮询。
 
 一条 thread 可以有多个 Run。问卷、达人图或工具执行确认会产生后续 Run，原 `run_id` 不会自动变成最新运行。确认后从网页或可用的 `pippit-tool-cli get-thread --thread-id THREAD_ID` 读取新的真实 run_id，再传给营销查询命令；不要猜 ID 或为查询创建新 Run。
+
+## Space Context
+
+原生 CLI 和 Skill 脚本均支持 `--team-id TEAM_ID`；`0` 为个人，正整数为团队。空间通过 API origin 上的 `X-Team-Id` Header 传递，保持本文件中的 JSON 请求字段不变。非 Canvas 业务默认使用 `space use` 保存的空间；旧任务按本地记录恢复原空间。团队列表为 `space list`，由 CLI 使用同一 AK 调用 `/api/biz/v1/skill/get_lite_team_list`，不直连 commerce Web 接口。
+
+营销响应增加 `team_id` 和供脚本固定轮询使用的 `space_context`；无可用本地账号记录时 `space_context` 为空，脚本通过显式 `--team-id` 固定轮询空间。二者只是本地路由信息，不能替代服务端鉴权。预览增加 `team_id`，不发送生成请求。权限或积分错误不自动切空间重试。

package/skills/xyq-marketing-skill/scripts/marketing.js

@@ -113,15 +113,29 @@ function invokeCLI(args, input, timeout, invocation = resolveCLI()) {
       clearTimeout(timer);
       if (failure) return reject(failure);
       if (code !== 0) return reject(new Error(`CLI 调用失败：${stderr.trim() || `退出码 ${code}`}；请求未重试。若不支持 marketing 命令，请更新 CLI。`));
-      if (args.includes('--help')) return resolve(stdout);
-      try { resolve(JSON.parse(stdout)); }
-      catch (_) { reject(new Error('CLI 未返回有效 JSON；提交结果可能不明确，请勿自动重提')); }
+      let result;
+      try { result = args.includes('--help') ? stdout : JSON.parse(stdout); }
+      catch (_) { return reject(new Error('CLI 未返回有效 JSON；提交结果可能不明确，请勿自动重提')); }
+      // Relay successful update and space notices; backend logs stay buffered.
+      for (const notice of stderr.split(/\r?\n/)) {
+        if (notice.startsWith('[pippit-tool-cli] New version available:') ||
+            notice === '[pippit-tool-cli] If browser authorization fails, update the CLI and run pippit-tool-cli login again.' ||
+            notice.startsWith('本次空间：') ||
+            notice.startsWith('请求已成功，但空间记录保存失败：') ||
+            notice === '本地空间记录不可用，将使用显式 --team-id；本次不保存空间记录。') {
+          process.stderr.write(`${notice}\n`);
+        }
+      }
+      resolve(result);
     });
     child.stdin.end(input);
   });
 }
 
-function createClient({ request = https.request, timeout = 60000, invoke = invokeCLI } = {}) {
+function createClient({ request = https.request, timeout = 60000, invoke = invokeCLI, teamID, spaceContext } = {}) {
+  const scopeArgs = [];
+  if (teamID !== undefined) scopeArgs.push('--team-id', normalizeTeamID(teamID));
+  if (spaceContext) scopeArgs.push('--space-context', spaceContext);
   function open(url, method, headers, body) {
     return new Promise((resolve, reject) => {
       const target = new URL(url);
@@ -142,13 +156,14 @@ function createClient({ request = https.request, timeout = 60000, invoke = invok
     });
   }
 
-  async function api(action, body, source) {
+  async function api(action, body, source, execute = true) {
     requireValue(['generate', 'query', 'balance'].includes(action), '无效营销 API 操作');
-    const args = ['marketing', action, '--timeout', `${timeout}ms`];
+    const args = ['marketing', action, '--timeout', `${timeout}ms`, ...scopeArgs];
     let input;
     if (action === 'generate') {
       validate(body);
-      args.push('--request', '-', '--execute');
+      args.push('--request', '-');
+      if (execute) args.push('--execute');
       if (source !== undefined) {
         // Probe before submitting; optional attribution must not break older CLIs.
         let help = '';
@@ -158,13 +173,14 @@ function createClient({ request = https.request, timeout = 60000, invoke = invok
       input = JSON.stringify(body);
     }
     if (action === 'query') args.push('--thread-id', body.thread_id, '--run-id', body.run_id);
-    return checkResponse(action, await invoke(args, input, timeout), body);
+    const result = await invoke(args, input, timeout);
+    return action === 'generate' && !execute ? result : checkResponse(action, result, body);
   }
 
   async function upload(file) {
     const stat = await fs.promises.stat(file);
     requireValue(stat.isFile() && stat.size > 0 && stat.size < 500000000, '上传需要非空文件且小于 500 MB');
-    return checkResponse('upload', await invoke(['marketing', 'upload', '--file', path.resolve(file), '--timeout', `${timeout}ms`], undefined, timeout));
+    return checkResponse('upload', await invoke(['marketing', 'upload', '--file', path.resolve(file), '--timeout', `${timeout}ms`, ...scopeArgs], undefined, timeout));
   }
 
   async function download(url, destination) {
@@ -205,7 +221,8 @@ const HELP = `小云雀营销 Skill（Node.js >= 16）
   node marketing.js query --thread-id ID --run-id ID [--wait] [--max-wait 900] [--output-dir DIR]
   node marketing.js balance
 所有 API 调用复用 pippit-tool-cli 登录态；未登录先运行 pippit-tool-cli login，无需提供 access_token。generate 默认仅预览。
---source HOST：仅生成提交使用，映射为请求体 platform；去除首尾空白，空值省略。
+--source HOST：仅生成提交使用，映射为请求体 platform；未传或空值时尝试环境识别，来源未知则省略。
+--team-id ID：本次使用团队；0 为个人，不改变 space use 保存的默认空间。轮询固定使用原任务空间。
 --timeout 秒数：单请求总时限，默认 60；--max-wait：轮询总时限，默认 900。
 query 输出 API 原始响应；有 --output-dir 时成功结果附带 downloaded_files。
 退出码：0 成功/单次查询进行中；1 输入或接口错误；2 生成失败/取消/无视频；3 等待超时；4 等待用户交互；5 未知或未指定状态。
@@ -213,12 +230,14 @@ query 输出 API 原始响应；有 --output-dir 时成功结果附带 downloade
 
 // Keep runtime marker semantics aligned with internal/common/host_source.go.
 function resolveHostSource(explicit, env = process.env) {
-  if (explicit !== undefined) return explicit.trim();
+  if (explicit !== undefined && explicit.trim()) return explicit.trim();
   if ((env.PIPPIT_CLI_SOURCE || '').trim()) return env.PIPPIT_CLI_SOURCE.trim();
   const hosts = new Set();
   for (const [key, host] of [
     ['CODEX_THREAD_ID', 'codex'], ['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', 'github_copilot_cli'], ['COPILOT_AGENT_SESSION_ID', 'github_copilot_cli'],
   ]) {
     const value = (env[key] || '').trim().toLowerCase();
     if (value && value !== '0' && value !== 'false') hosts.add(host);
@@ -226,12 +245,18 @@ function resolveHostSource(explicit, env = process.env) {
   return hosts.size === 1 ? [...hosts][0] : '';
 }
 
+function normalizeTeamID(value) {
+  requireValue(typeof value === 'string' && /^\d+$/.test(value), 'team-id 必须为 0 或正整数');
+  requireValue(BigInt(value) <= 9223372036854775807n, 'team-id 超出 int64 范围');
+  return BigInt(value).toString();
+}
+
 function parseArgs(argv) {
   const [action, ...rest] = argv;
   requireValue(Object.hasOwnProperty.call(PATHS, action), '操作必须是 generate/upload/query/balance');
   const options = {};
   const flags = ['execute', 'dry-run', 'wait'];
-  const allowed = { generate: ['request', 'execute', 'dry-run', 'source'], upload: ['file'], query: ['thread-id', 'run-id', 'wait', 'max-wait', 'output-dir'], balance: [] }[action].concat('timeout');
+  const allowed = { generate: ['request', 'execute', 'dry-run', 'source'], upload: ['file'], query: ['thread-id', 'run-id', 'wait', 'max-wait', 'output-dir'], balance: [] }[action].concat('timeout', 'team-id');
   for (let i = 0; i < rest.length; i++) {
     const name = rest[i].replace(/^--/, '');
     requireValue(rest[i].startsWith('--') && allowed.includes(name) && !(name in options), `无效或重复参数：${rest[i]}`);
@@ -241,6 +266,7 @@ function parseArgs(argv) {
       options[name] = rest[++i];
     }
   }
+  if (options['team-id'] !== undefined) options['team-id'] = normalizeTeamID(options['team-id']);
   requireValue(!(options.execute && options['dry-run']), '--execute 和 --dry-run 不能同时使用');
   for (const [name, fallback, max] of [['timeout', 60, 1800], ['max-wait', 900, 86400]]) {
     const value = options[name] === undefined ? fallback : Number(options[name]);
@@ -259,26 +285,32 @@ async function main(argv, { out = console.log, clientFactory = createClient, now
     if (options.source !== undefined || source) options.source = source;
     requireValue(options.request, 'generate 需要 --request JSON 文件');
     body = validate(JSON.parse(await fs.promises.readFile(options.request, 'utf8')));
-    if (!options.execute) {
-      const source = (options.source || '').trim();
-      out(JSON.stringify({ dry_run: true, url: BASE + PATHS.generate, body: source ? { ...body, platform: source } : body }));
-      return 0;
-    }
   }
   if (action === 'query') {
     requireValue(nonempty(options['thread-id']) && nonempty(options['run-id']), 'query 需要 thread-id 和 run-id');
     body = { thread_id: options['thread-id'], run_id: options['run-id'] };
   }
   if (action === 'upload') requireValue(nonempty(options.file), 'upload 需要 --file');
-  const client = clientFactory({ timeout: options.timeout * 1000 });
+  const client = clientFactory({ timeout: options.timeout * 1000, teamID: options['team-id'] });
+  if (action === 'generate' && !options.execute) {
+    out(JSON.stringify(await client.api(action, body, options.source, false)));
+    return 0;
+  }
+  let fixedScope;
+  let fixedTeamID = options['team-id'];
   let result;
   const deadline = now() + options['max-wait'] * 1000;
   do {
     // A poll request cannot overrun the remaining wait budget.
     const pollClient = action === 'query' && options.wait
-      ? clientFactory({ timeout: Math.min(options.timeout * 1000, Math.max(1, deadline - now())) }) : client;
+      ? clientFactory({ timeout: Math.min(options.timeout * 1000, Math.max(1, deadline - now())), teamID: fixedTeamID, spaceContext: fixedScope }) : client;
     result = action === 'upload' ? await client.upload(options.file) : await pollClient.api(action, body, options.source);
+    if (action === 'query' && options.wait && fixedTeamID !== undefined) requireValue(result.team_id === fixedTeamID, '任务空间发生变化，已停止轮询');
+    if (action === 'query' && options.wait && fixedScope) requireValue(result.space_context === fixedScope, '任务空间或账号发生变化，已停止轮询');
     if (action !== 'query' || !options.wait || !WAIT_STATES.includes(String(result.data.run_state))) break;
+    requireValue(nonempty(result.team_id) && (nonempty(result.space_context) || fixedTeamID !== undefined), 'CLI 未返回固定空间信息，已停止轮询；请使用原 --team-id 查询同一任务，不要重提');
+    fixedScope = result.space_context;
+    fixedTeamID = result.team_id;
     if (now() >= deadline) {
       out(JSON.stringify({ ...result, wait_timed_out: true })); return 3;
     }