@pippit-dev/cli 1.0.42 → 1.0.44

package/internal/space/store_test.go

@@ -0,0 +1,246 @@
+package space
+
+import (
+	"bytes"
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+)
+
+func testStore(t *testing.T) *Store {
+	t.Helper()
+	return &Store{Dir: t.TempDir(), Account: "account-a", Origin: "https://example.test"}
+}
+
+func TestTaskScopeSurvivesDefaultSwitchAndRejectsConflicts(t *testing.T) {
+	s := testStore(t)
+	a := Selection{TeamID: "12", Name: "A"}
+	b := Selection{TeamID: "34", Name: "B"}
+	ref := References{ThreadID: "thread", RunID: "run", AssetIDs: []string{"asset"}}
+	if err := s.Remember(ref, a); err != nil {
+		t.Fatal(err)
+	}
+	if err := s.SaveDefault(b); err != nil {
+		t.Fatal(err)
+	}
+	got, err := (&Session{Store: s}).Resolve(ref)
+	if err != nil || got.TeamID != "12" {
+		t.Fatalf("old task = %+v, %v", got, err)
+	}
+	got, err = (&Session{Store: s}).Resolve(References{})
+	if err != nil || got.TeamID != "34" {
+		t.Fatalf("new task = %+v, %v", got, err)
+	}
+	if _, err := (&Session{Store: s, Explicit: &b.TeamID}).Resolve(ref); err == nil {
+		t.Fatal("explicit conflicting team accepted")
+	}
+	if _, err := (&Session{Store: s}).Resolve(References{AssetIDs: []string{"asset"}}); err == nil {
+		t.Fatal("cross-team asset accepted")
+	}
+	zero := "0"
+	got, err = (&Session{Store: s, Explicit: &zero}).Resolve(References{})
+	if err != nil || got.TeamID != "0" {
+		t.Fatalf("personal override = %+v, %v", got, err)
+	}
+	current, _ := s.Current()
+	if current.TeamID != "34" {
+		t.Fatal("one-shot override changed saved default")
+	}
+	if err := os.Remove(s.file("thread", "thread")); err != nil {
+		t.Fatal(err)
+	}
+	got, err = (&Session{Store: s}).Resolve(ref)
+	if err != nil || got.TeamID != "12" {
+		t.Fatalf("partial task record = %+v, %v", got, err)
+	}
+}
+
+func TestCorruptRecordRequiresExplicitRecovery(t *testing.T) {
+	s := testStore(t)
+	ref := References{ThreadID: "thread", RunID: "run"}
+	a := Selection{TeamID: "12", Name: "A"}
+	if err := s.Remember(ref, a); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(s.file("run", "run"), []byte("broken"), 0600); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := (&Session{Store: s}).Resolve(ref); err == nil {
+		t.Fatal("corrupt record treated as missing")
+	}
+	other := "34"
+	if _, err := (&Session{Store: s, Explicit: &other}).Resolve(ref); err == nil {
+		t.Fatal("corrupt run overrode valid thread")
+	}
+	if _, err := (&Session{Store: s, Explicit: &a.TeamID}).Resolve(ref); err != nil {
+		t.Fatal(err)
+	}
+	if err := s.Remember(ref, a); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := (&Session{Store: s}).Resolve(ref); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(s.file("default", ""), []byte("broken"), 0600); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := (&Session{Store: s}).Resolve(References{}); err == nil {
+		t.Fatal("corrupt default fell back to personal")
+	}
+	zero := "0"
+	if _, err := (&Session{Store: s, Explicit: &zero}).Resolve(References{}); err != nil {
+		t.Fatal(err)
+	}
+}
+
+func TestSpaceIdentityAndInt64Boundary(t *testing.T) {
+	for _, raw := range []string{"", "-1", "1.5", " 12", "+12", "9223372036854775808"} {
+		if _, err := ParseTeamID(raw); err == nil {
+			t.Errorf("accepted %q", raw)
+		}
+	}
+	s := testStore(t)
+	for raw, want := range map[string]string{"0": "0", "000": "0", "00012": "12", "9223372036854775807": "9223372036854775807"} {
+		if got, err := ParseTeamID(raw); err != nil || got != want {
+			t.Errorf("%q = %q, %v", raw, got, err)
+		}
+		if err := s.SaveDefault(Selection{TeamID: raw}); err != nil {
+			t.Fatalf("save %q: %v", raw, err)
+		}
+		if got, err := s.Current(); err != nil || got.TeamID != want {
+			t.Errorf("read saved %q = %+v, %v; want team_id %q", raw, got, err, want)
+		}
+	}
+	a, err := NewStore("https://EXAMPLE.test:443/path", "account-a")
+	if err != nil {
+		t.Fatal(err)
+	}
+	b, _ := NewStore("https://example.test", "account-a")
+	c, _ := NewStore("https://example.test", "account-b")
+	d, _ := NewStore("https://other.test", "account-a")
+	if a.Dir != b.Dir || a.Dir == c.Dir || a.Dir == d.Dir {
+		t.Fatal("account/origin isolation failed")
+	}
+}
+
+func TestFixedSessionRequiresExplicitRecordRecovery(t *testing.T) {
+	for _, teamID := range []string{"0", "12"} {
+		for _, bindingOnly := range []bool{false, true} {
+			s := testStore(t)
+			selected := Selection{TeamID: teamID}
+			if err := s.SaveDefault(selected); err != nil {
+				t.Fatal(err)
+			}
+			session := &Session{Store: s}
+			if _, err := session.Resolve(References{}); err != nil {
+				t.Fatal(err)
+			}
+			if bindingOnly {
+				binding, err := DecodeBinding(session.Token())
+				if err != nil {
+					t.Fatal(err)
+				}
+				session = &Session{Store: s, Expected: binding}
+			}
+			if err := s.SaveDefault(Selection{TeamID: "34"}); err != nil {
+				t.Fatal(err)
+			}
+			ref := References{ThreadID: "thread", RunID: "run"}
+			if err := s.Remember(ref, selected); err != nil {
+				t.Fatal(err)
+			}
+			if err := os.WriteFile(s.file("run", "run"), []byte("broken"), 0600); err != nil {
+				t.Fatal(err)
+			}
+			if _, err := session.Resolve(ref); err == nil {
+				t.Fatalf("team %s, binding=%v: fixed space bypassed corrupt record", teamID, bindingOnly)
+			}
+			session.Explicit = &teamID
+			got, err := session.Resolve(ref)
+			if err != nil || got.TeamID != teamID {
+				t.Fatalf("explicit recovery = %+v, %v", got, err)
+			}
+			if err := s.Remember(References{ThreadID: "other"}, Selection{TeamID: "34"}); err != nil {
+				t.Fatal(err)
+			}
+			if _, err := session.Resolve(References{ThreadID: "other"}); err == nil {
+				t.Fatal("fixed space accepted a conflicting task")
+			}
+		}
+	}
+}
+
+func TestSessionWithoutStoreKeepsExplicitSpace(t *testing.T) {
+	for _, teamID := range []string{"0", "12", "34"} {
+		explicit := teamID
+		session := &Session{Explicit: &explicit}
+		selected, err := session.Resolve(References{})
+		if err != nil || selected.TeamID != teamID {
+			t.Fatalf("space = %+v, %v", selected, err)
+		}
+		explicit = "56"
+		selected, err = session.Resolve(References{ThreadID: "thread", RunID: "run"})
+		if err != nil || selected.TeamID != teamID {
+			t.Fatalf("command changed its frozen space: %+v, %v", selected, err)
+		}
+		session.Remember(References{ThreadID: "thread", RunID: "run"})
+		if session.Token() != "" {
+			t.Fatal("unknown account must not produce an identity binding")
+		}
+	}
+	session := &Session{Expected: &Binding{Selection: Personal(), Account: "account", Origin: "https://example.test"}}
+	if _, err := session.Resolve(References{}); err == nil {
+		t.Fatal("identity binding accepted without an identifiable account")
+	}
+}
+
+func TestCommandSessionFreezesScopeAndChecksIdentity(t *testing.T) {
+	s := testStore(t)
+	if err := s.SaveDefault(Selection{TeamID: "12", Name: "A"}); err != nil {
+		t.Fatal(err)
+	}
+	account := s.Account
+	var warning bytes.Buffer
+	session := &Session{Store: s, Stderr: &warning, Identity: func(context.Context) (string, error) { return account, nil }}
+	ctx := context.Background()
+	if _, err := session.Resolve(References{}); err != nil {
+		t.Fatal(err)
+	}
+	token := session.Token()
+	if err := s.SaveDefault(Selection{TeamID: "34", Name: "B"}); err != nil {
+		t.Fatal(err)
+	}
+	got, err := session.Resolve(References{})
+	if err != nil || got.TeamID != "12" {
+		t.Fatalf("session changed = %+v, %v", got, err)
+	}
+	binding, err := DecodeBinding(token)
+	if err != nil {
+		t.Fatal(err)
+	}
+	next := &Session{Store: s, Expected: binding}
+	got, err = next.Resolve(References{})
+	if err != nil || got.TeamID != "12" || next.Token() != token {
+		t.Fatalf("cross-process binding = %+v, %v", got, err)
+	}
+	account = "account-b"
+	if err := session.CheckIdentity(ctx); err == nil {
+		t.Fatal("account switch accepted")
+	}
+	next.Store = &Store{Dir: s.Dir, Account: account, Origin: s.Origin}
+	if _, err := next.Resolve(References{}); err == nil {
+		t.Fatal("binding allowed different account")
+	}
+	// A successful request stays successful even if the record directory fails.
+	blocked := filepath.Join(t.TempDir(), "file")
+	if err := os.WriteFile(blocked, []byte("file"), 0600); err != nil {
+		t.Fatal(err)
+	}
+	s.Dir = blocked
+	session.Remember(References{ThreadID: "created-thread", RunID: "created-run"})
+	if !strings.Contains(warning.String(), "created-run") || !strings.Contains(warning.String(), "不要重复提交") {
+		t.Fatal(warning.String())
+	}
+}

package/package.json

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

package/scripts/canvas-command.js

@@ -48,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") {
@@ -196,9 +215,12 @@ 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),
@@ -207,6 +229,12 @@ class NativeCanvasClient {
     let output;
     try {
       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}`);
     }
@@ -786,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;
@@ -842,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) {
@@ -853,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;
@@ -872,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();
@@ -963,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,7 +3,7 @@
 const { execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
-const { isCanvasCommand, parseCanvasCommandArgs, runCanvasCommand } = require('./canvas-command');
+const { isCanvasCommand, parseCanvasCommandArgs, runCanvasCommand, canvasSpaceArgs } = require('./canvas-command');
 const { maybeWarnNewVersion } = require('./version-check');
 
 const ext = process.platform === 'win32' ? '.exe' : '';
@@ -45,7 +45,7 @@ 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) {

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/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`，不发送生成请求。权限或积分错误不自动切空间重试。