@clawos-dev/clawd 0.2.446 → 0.2.448

package/dist/cli.cjs

@@ -7594,6 +7594,14 @@ var init_schemas = __esm({
       // 快速问答临时会话标记（spec 2026-06-23-fork-quick-ask）：true = 关闭抽屉即删、
       // 不进 sidebar 树、daemon 启动清扫孤儿。普通会话缺省。
       ephemeral: external_exports.boolean().optional(),
+      /**
+       * 这条会话属于哪张部署单（persona 上云的环境扫描会话）。
+       *
+       * 有值 = 它在单据页右栏里活着，**sidebar 不再列它**——同一条会话两处出现，和话题 worker
+       * 会话不进「最近」是同一条规矩。不复用 `ephemeral`：那个标记会被 daemon 启动清扫**删掉**，
+       * 而扫描会话要跟单据一样长期留着（人隔天回来还要翻管家当时是怎么判的、还要接着追问）。
+       */
+      deployId: external_exports.string().min(1).optional(),
       // owner-mode persona session 身份标识；UI 用它在 SessionList 过滤 + jump，
       // daemon 用它做 idempotent dedupe + spawn 时派生 ctx.personaMode='owner'
       ownerPersonaId: external_exports.string().min(1).optional(),
@@ -8796,9 +8804,13 @@ var init_methods = __esm({
         args: WorkspaceReadArgs
       },
       "deploy:start": {
-        summary: "\u5BF9\u67D0\u4E2A persona \u53D1\u8D77\u4E00\u6B21\u4E0A\u4E91\u90E8\u7F72\uFF1A\u5EFA\u5355\u636E\u5E76**\u5F02\u6B65**\u8D77\u73AF\u5883\u626B\u63CF\u3002\u7ACB\u523B\u8FD4\u56DE scanning \u6001\u5355\u636E\uFF0C\u626B\u63CF\u8981\u8DD1\u51E0\u5206\u949F\u3001\u626B\u5B8C\u7531\u540E\u53F0\u56DE\u5199\uFF1Bowner-only",
+        summary: "\u6253\u5F00\u67D0\u4E2A persona \u7684\u90E8\u7F72\u5355\uFF1A**\u5DF2\u6709\u5C31\u539F\u6837\u8FD4\u56DE\u90A3\u5F20**\uFF08\u8349\u7A3F\u7EED\u586B\uFF0C\u4E0D\u91CD\u626B\uFF0C\u4E5F\u4E0D\u65B0\u5EFA\uFF09\uFF0C\u6CA1\u6709\u624D\u5EFA\u4E00\u5F20\u5E76**\u5F02\u6B65**\u8D77\u73AF\u5883\u626B\u63CF\u3002\u4E00\u4E2A persona \u540C\u65F6\u53EA\u6709\u4E00\u5F20\u5355\uFF0C\u8981\u91CD\u626B\u8D70 deploy:rescan\uFF1Bowner-only",
         args: DeployStartArgsSchema
       },
+      "deploy:rescan": {
+        summary: "\u5C31\u5730\u91CD\u626B\u4E00\u5F20\u5DF2\u6709\u7684\u90E8\u7F72\u5355\uFF1A\u6E05\u6389\u4E0A\u6B21\u626B\u51FA\u6765\u7684\u6E05\u5355 / \u8BC1\u636E / \u5B58\u7591\u9879\uFF0C\u72B6\u6001\u56DE scanning\uFF0C\u8D77\u4E00\u4E2A\u65B0\u7684\u626B\u63CF\u4F1A\u8BDD\u3002**\u5DF2\u586B\u7684\u51ED\u636E\u503C\u548C\u5C65\u7EA6\u9009\u62E9\u539F\u6837\u4FDD\u7559**\uFF08\u5B83\u4EEC\u6309\u5355\u636E id \u5B58\uFF0C\u4E0D\u968F\u626B\u63CF\u7ED3\u679C\u8D70\uFF09\uFF0C\u6240\u4EE5\u91CD\u626B\u4E0D\u4F1A\u8BA9\u4EBA\u767D\u586B\u4E00\u904D\uFF1Bowner-only",
+        args: DeployIdArgsSchema
+      },
       "deploy:list": {
         summary: "\u5217\u51FA\u5168\u90E8\u90E8\u7F72\u5355\uFF08\u65B0\u7684\u5728\u524D\uFF09\uFF1Bowner-only\u3002\u65E0\u53C2\u6570",
         args: NO_ARGS
@@ -48645,6 +48657,7 @@ var SessionManager = class {
       // persona 绑定的 model / effort 快照进 SessionFile（spec 2026-08-12）
       ...personaDefaultFields(personaDefaults),
       ...args.sourceSessionId ? { shiftFiredFromSessionId: args.sourceSessionId } : {},
+      ...args.deployId ? { deployId: args.deployId } : {},
       createdAt: now,
       updatedAt: now
     };
@@ -54406,8 +54419,8 @@ function buildDeployHandlers(deps) {
     if (!deps.hasPersona(args.personaId)) {
       throw new ClawdError(ERROR_CODES.PERSONA_NOT_FOUND, `PERSONA_NOT_FOUND: \u6CA1\u6709\u8FD9\u4E2A persona\uFF08${args.personaId}\uFF09`);
     }
-    const inFlight = deps.receipts.list().find((r) => r.personaId === args.personaId && r.status === "scanning");
-    if (inFlight) return view(inFlight);
+    const existing = deps.receipts.list().find((r) => r.personaId === args.personaId);
+    if (existing) return view(existing);
     const receipt = deps.receipts.create({
       deployId: deps.genId(),
       personaId: args.personaId,
@@ -54417,6 +54430,26 @@ function buildDeployHandlers(deps) {
     if (scanSessionId) deps.receipts.update(receipt.deployId, { scanSessionId });
     return view(deps.receipts.get(receipt.deployId) ?? receipt);
   };
+  const rescan = async (frame, _client, ctx) => {
+    ensureOwner(ctx);
+    const args = parseArgs2(DeployIdArgsSchema, frame, "deploy:rescan");
+    const receipt = mustGet(deps, args.deployId);
+    if (receipt.status === "scanning") {
+      throw new ClawdError(ERROR_CODES.VALIDATION_ERROR, "VALIDATION_ERROR: \u8FD9\u5F20\u5355\u6B63\u5728\u626B\u63CF\u4E2D\uFF0C\u7B49\u5B83\u626B\u5B8C\u518D\u91CD\u626B");
+    }
+    deps.receipts.update(args.deployId, {
+      status: "scanning",
+      manifest: void 0,
+      evidence: [],
+      notes: [],
+      smokeTask: void 0,
+      error: void 0,
+      scanSessionId: void 0
+    });
+    const scanSessionId = deps.startScan(args.deployId, receipt.personaId);
+    if (scanSessionId) deps.receipts.update(args.deployId, { scanSessionId });
+    return view(deps.receipts.get(args.deployId) ?? receipt);
+  };
   const list = async (_frame, _client, ctx) => {
     ensureOwner(ctx);
     return { response: { type: "deploy:list", receipts: deps.receipts.list() } };
@@ -54517,6 +54550,7 @@ function buildDeployHandlers(deps) {
   };
   return {
     "deploy:start": start,
+    "deploy:rescan": rescan,
     "deploy:list": list,
     "deploy:get": get,
     "deploy:patch": patch,
@@ -63379,6 +63413,7 @@ var METHOD_GRANT_MAP = {
   // deploy:*（persona 上云的部署单）：全部 owner-only。单据里有履约决策、凭据录入口，
   // guest 不该看见更不该动。
   "deploy:start": ADMIN_ANY,
+  "deploy:rescan": ADMIN_ANY,
   "deploy:list": ADMIN_ANY,
   "deploy:get": ADMIN_ANY,
   "deploy:patch": ADMIN_ANY,
@@ -63631,7 +63666,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.446".length > 0 ? "0.2.446" : "dev";
+var version = "0.2.448".length > 0 ? "0.2.448" : "dev";
 
 // src/cli-probe/probe.ts
 var fs68 = __toESM(require("fs"), 1);
@@ -68628,7 +68663,7 @@ async function startDaemon(config) {
       ].join("\n");
       let handle;
       try {
-        handle = manager.createShiftSession({ targetPersona: BUTLER_PERSONA_ID, prompt });
+        handle = manager.createShiftSession({ targetPersona: BUTLER_PERSONA_ID, prompt, deployId });
       } catch (err) {
         deployReceipts.update(deployId, { status: "scanFailed", error: `\u8D77\u626B\u63CF\u4F1A\u8BDD\u5931\u8D25\uFF1A${String(err)}` });
         logger.error("deploy scan session failed to start", { deployId, personaId: personaId2, error: String(err) });

package/dist/deploy-kit/scripts/ensure-credentials.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# ============================================================
+# 发布/清理动手前把阿里云凭证准备好（publish.sh / remove-extension.sh 共用）。
+# 被 `source` 进来，再调 ensure_credentials。跟 ensure-toolchain.sh 是一对：
+# 那个管「命令在不在」，这个管「命令拿什么身份跑」。
+#
+# 硬约束：**全程不碰用户全局 ~/.s**。clawd 发布用的是 ship 出来的共享 demo AK，
+# 而 ~/.s/access.yaml 里的 default 是用户自己账号的 Serverless Devs 凭证——它是用户的
+# 东西，不是我们的。做法对齐本 kit 处理 aliyun CLI 的方式（凭证只进本次进程的 env，
+# 全局 ~/.aliyun/ 一个字节不碰）：把 Serverless Devs 的配置家目录整个指到 deploy-kit
+# 名下，access.yaml 写在那里。
+# ============================================================
+
+# s 的 profile 名。刻意不叫 default：万一哪天某个版本的 s 不认 serverless_devs_config_home，
+# 隔离失效时它会退回去用户的 ~/.s/access.yaml 里找 clawd-fc —— 找不到就
+# `Not found access: clawd-fc` 硬报错，而不是默默拿用户的 default 凭证把 extension
+# 部署进别人的账号。调 s 时都显式带 `--access "$S_ACCESS_ALIAS"`：命令行参数覆盖 s.yaml
+# 里的 access 字段，本改动前 scaffold 的老项目（s.yaml 写着 default）照样走这条。
+S_ACCESS_ALIAS=clawd-fc
+
+# 分层加载阿里云 AK 进 env：shared demo（OTA 每次启动覆盖）→ 本机 .local override（永不被覆盖）。
+ensure_aliyun_env() {
+  local kit="${KIT_DIR:?ensure_aliyun_env 需要调用方先设 KIT_DIR}"
+  [ -f "$kit/.secrets/aliyun.env" ] || {
+    echo "❌ 缺 $kit/.secrets/aliyun.env（clawd ship 的共享 demo 凭证，OTA 自动刷新）。参考 .secrets/aliyun.env.example 填写。" >&2
+    return 1
+  }
+  set -a; . "$kit/.secrets/aliyun.env"; set +a
+  # aliyun.env.local: 本机个人 override（永远不被 OTA 覆盖，见 refreshDeployKit）。有就后 source 覆盖 env。
+  # 写成 if 而不是 `[ -f ] && { }`：后者在函数末尾会把「文件不存在」变成函数返回 1，调用方 set -e 直接中止。
+  if [ -f "$kit/.secrets/aliyun.env.local" ]; then
+    set -a; . "$kit/.secrets/aliyun.env.local"; set +a
+  fi
+  export ALIBABA_CLOUD_REGION_ID="${REGION:?config.env 缺 REGION}"
+}
+
+# 把 Serverless Devs 的配置家目录（access.yaml / 组件缓存 / 日志）指到 deploy-kit 名下，
+# 再把当前 env 里的凭证写成 $S_ACCESS_ALIAS profile。
+# s v3 的 rootHome = `$serverless_devs_config_home/.s`（默认 `$HOME/.s`），`s -v` 打印的 s-home 就是它——
+# 注意差一层：env 指到 X，文件落 X/.s/，所以下面是 "$s_home/.s/access.yaml" 而不是 "$s_home/access.yaml"。
+# 前置：ensure_toolchain（aliyun 可执行）+ ensure_aliyun_env（AK 进 env）。
+# 放 $KIT_DIR 下而不是另起路径：跟它写的那份凭证同源，且 refreshDeployKit 只覆盖
+# scripts/ contract/ .secrets/，OTA 不会动这里的组件缓存。
+ensure_s_access() {
+  local kit="${KIT_DIR:?ensure_s_access 需要调用方先设 KIT_DIR}"
+  local s_home="$kit/.s-home"
+  local ident acc
+
+  ident="$(aliyun --mode AK sts GetCallerIdentity 2>&1)" || {
+    echo "❌ aliyun sts GetCallerIdentity 失败(检查 .secrets/aliyun.env 凭证):" >&2
+    echo "$ident" >&2
+    return 1
+  }
+  # 用 node 不用 python3：目标机器保证有 node（clawd 本身就是 node 跑的），不保证有 python
+  # —— 清理路径尤其不该多一个装不上就跑不了的依赖。
+  acc="$(printf '%s' "$ident" | node -e 'console.log(JSON.parse(require("fs").readFileSync(0,"utf8")).AccountId)')" || {
+    echo "❌ 解析 AccountId 失败,aliyun 输出非 JSON:" >&2
+    echo "$ident" >&2
+    return 1
+  }
+
+  export serverless_devs_config_home="$s_home"
+  mkdir -p "$s_home/.s"
+  # umask 管「新建」：SK 从落盘第一个字节起就是 0600，不留「先 644 写完再 chmod」的窗口。
+  # 后面的 chmod 管「文件已存在」：umask 不改已有文件的 mode，重复发布时靠它兜底。
+  ( umask 077; cat > "$s_home/.s/access.yaml" <<EOF
+$S_ACCESS_ALIAS:
+  AccountID: '$acc'
+  AccessKeyID: $ALIBABA_CLOUD_ACCESS_KEY_ID
+  AccessKeySecret: $ALIBABA_CLOUD_ACCESS_KEY_SECRET
+EOF
+  )
+  chmod 600 "$s_home/.s/access.yaml"
+}
+
+ensure_credentials() {
+  ensure_aliyun_env
+  ensure_s_access
+}

package/dist/deploy-kit/scripts/ensure-credentials.spec.ts

@@ -0,0 +1,204 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { execFileSync } from 'node:child_process'
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, statSync, cpSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+
+// ensure-credentials.sh 的契约测试。核心不变量：**发布/清理全程不碰用户全局 ~/.s**。
+// 老实现 `cat > ~/.s/access.yaml` 会把用户自己的 Serverless Devs default 凭证顶掉且不可恢复
+// （所有装了 clawd 的用户点一次「发布上线」就中招），这些用例就是钉死那个回归。
+//
+// 真脚本 + 真 bash 跑，只把两个外部 CLI（aliyun / s）换成记录 argv 的 shim：
+// 断言的是脚本自己的行为（写哪、写什么、传什么 flag），没有 mock 掉被测逻辑。
+
+const SCRIPTS_DIR = __dirname
+
+interface Sandbox {
+  root: string
+  kit: string
+  home: string
+  bin: string
+}
+
+let box: Sandbox
+
+/** 用户自己的 ~/.s/access.yaml —— 全程必须一个字节都不变。 */
+const USER_ACCESS_YAML = `default:
+  AccountID: '1999888877776666'
+  AccessKeyID: LTAI-USER-OWN-KEY
+  AccessKeySecret: user-own-secret
+`
+
+/** aliyun CLI shim：`sts GetCallerIdentity` 回真 CLI 那样的 JSON，其余子命令原样成功。 */
+function writeAliyunShim(bin: string, accountId = '5566778899001122'): void {
+  writeFileSync(
+    join(bin, 'aliyun'),
+    `#!/usr/bin/env bash\nprintf '{"AccountId":"${accountId}","Arn":"acs:ram::${accountId}:user/clawd-fc-developer"}\\n'\n`,
+    { mode: 0o755 },
+  )
+}
+
+/** s shim：把每次调用的 argv 追加到 $S_ARGV_LOG，供断言 --access 传对了没。 */
+function writeSShim(bin: string, log: string): void {
+  writeFileSync(
+    join(bin, 's'),
+    `#!/usr/bin/env bash\nprintf '%s\\n' "$*" >> "${log}"\n`,
+    { mode: 0o755 },
+  )
+}
+
+beforeEach(() => {
+  const root = mkdtempSync(join(tmpdir(), 'ensure-creds-'))
+  const kit = join(root, 'deploy-kit')
+  const home = join(root, 'home')
+  const bin = join(root, 'bin')
+  mkdirSync(join(kit, '.secrets'), { recursive: true })
+  mkdirSync(join(home, '.s'), { recursive: true })
+  mkdirSync(bin, { recursive: true })
+
+  // 真脚本进沙箱 kit（.secrets 用假凭证，绝不碰 repo 里 ship 的那份）
+  cpSync(SCRIPTS_DIR, join(kit, 'scripts'), { recursive: true })
+  writeFileSync(
+    join(kit, '.secrets', 'aliyun.env'),
+    'ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI-SHARED-DEMO\nALIBABA_CLOUD_ACCESS_KEY_SECRET=shared-demo-secret\n',
+  )
+  writeFileSync(join(home, '.s', 'access.yaml'), USER_ACCESS_YAML)
+  writeAliyunShim(bin)
+
+  box = { root, kit, home, bin }
+})
+
+afterEach(() => {
+  rmSync(box.root, { recursive: true, force: true })
+})
+
+/** 在沙箱里 source ensure-credentials.sh 并跑一段 bash，返回 stdout。 */
+function runInKit(body: string): string {
+  const script = `
+set -euo pipefail
+KIT_DIR="${box.kit}"
+REGION="\${REGION:-cn-hangzhou}"
+source "$KIT_DIR/scripts/ensure-credentials.sh"
+${body}
+`
+  return execFileSync('bash', ['-c', script], {
+    env: { ...process.env, HOME: box.home, PATH: `${box.bin}:${process.env.PATH}` },
+    encoding: 'utf8',
+  })
+}
+
+function userAccessYaml(): string {
+  return readFileSync(join(box.home, '.s', 'access.yaml'), 'utf8')
+}
+
+function kitAccessYaml(): string {
+  return readFileSync(join(box.kit, '.s-home', '.s', 'access.yaml'), 'utf8')
+}
+
+describe('ensure_credentials', () => {
+  it('不碰用户全局 ~/.s/access.yaml', () => {
+    runInKit('ensure_credentials')
+    expect(userAccessYaml()).toBe(USER_ACCESS_YAML)
+  })
+
+  it('凭证写进 kit 私有 s-home', () => {
+    runInKit('ensure_credentials')
+    const yaml = kitAccessYaml()
+    expect(yaml).toContain("AccountID: '5566778899001122'")
+    expect(yaml).toContain('AccessKeyID: LTAI-SHARED-DEMO')
+    expect(yaml).toContain('AccessKeySecret: shared-demo-secret')
+  })
+
+  it('profile 名是 clawd-fc 而不是 default', () => {
+    // 隔离万一失效（某版本 s 不认 serverless_devs_config_home）时，s 会去用户
+    // ~/.s/access.yaml 找 clawd-fc —— 找不到就硬报错，而不是默默拿用户的 default
+    // 凭证把 extension 部署进别人的账号。
+    runInKit('ensure_credentials')
+    expect(kitAccessYaml()).toMatch(/^clawd-fc:$/m)
+    expect(kitAccessYaml()).not.toMatch(/^default:$/m)
+  })
+
+  it('把 Serverless Devs 的家目录指向 kit 私有目录', () => {
+    const out = runInKit('ensure_credentials; echo "S_HOME=$serverless_devs_config_home"')
+    expect(out).toContain(`S_HOME=${box.kit}/.s-home`)
+  })
+
+  it('access.yaml 权限 600（含 SK，不给同机其它用户读）', () => {
+    runInKit('ensure_credentials')
+    const mode = statSync(join(box.kit, '.s-home', '.s', 'access.yaml')).mode & 0o777
+    expect(mode.toString(8)).toBe('600')
+  })
+
+  it('aliyun.env.local 覆盖 shared 凭证', () => {
+    writeFileSync(
+      join(box.kit, '.secrets', 'aliyun.env.local'),
+      'ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI-MY-OWN\nALIBABA_CLOUD_ACCESS_KEY_SECRET=my-own-secret\n',
+    )
+    runInKit('ensure_credentials')
+    expect(kitAccessYaml()).toContain('AccessKeyID: LTAI-MY-OWN')
+    expect(kitAccessYaml()).toContain('AccessKeySecret: my-own-secret')
+  })
+
+  it('缺共享凭证文件时 fail-loud', () => {
+    rmSync(join(box.kit, '.secrets', 'aliyun.env'))
+    expect(() => runInKit('ensure_credentials')).toThrow()
+    expect(existsSync(join(box.kit, '.s-home', '.s', 'access.yaml'))).toBe(false)
+  })
+})
+
+describe('publish.sh', () => {
+  it('用 clawd-fc profile 调 s deploy，不碰用户全局 ~/.s', () => {
+    const log = join(box.root, 's-argv.log')
+    writeSShim(box.bin, log)
+    // 自定义域名查询回空 → publish.sh 在 verify 段 exit 1。deploy 之后的事，
+    // 不影响本用例要断言的凭证行为，省掉 curl shim。
+    writeFileSync(
+      join(box.bin, 'aliyun'),
+      `#!/usr/bin/env bash\ncase " $* " in\n  *" sts "*) printf '{"AccountId":"5566778899001122"}\\n' ;;\n  *) printf '{"customDomains":[]}\\n' ;;\nesac\n`,
+      { mode: 0o755 },
+    )
+
+    const ext = join(box.root, 'proj')
+    const persona = join(box.root, 'persona')
+    mkdirSync(join(ext, 'server'), { recursive: true })
+    mkdirSync(join(persona, 'extension-kit', 'contract'), { recursive: true })
+    mkdirSync(join(box.kit, 'contract'), { recursive: true })
+    writeFileSync(join(box.kit, 'contract', 'bootstrap'), '#!/usr/bin/env bash\n')
+    writeFileSync(join(ext, 'ext.conf'), 'APP_NAME=demo\nSLUG=ab12\nCODE_DIR=./server\n')
+    writeFileSync(join(persona, 'extension-kit', 'config.env'), 'REGION=cn-hangzhou\n')
+    writeFileSync(join(persona, 'extension-kit', 'contract', 's.yaml.tmpl'), 'name: __DEPLOY_NAME__-app\naccess: clawd-fc\n')
+
+    expect(() =>
+      execFileSync('bash', [join(box.kit, 'scripts', 'publish.sh'), ext, persona], {
+        env: { ...process.env, HOME: box.home, PATH: `${box.bin}:${process.env.PATH}` },
+        encoding: 'utf8',
+        stdio: 'pipe',
+      }),
+    ).toThrow() // verify 段无域名 → exit 1，deploy 已经跑过了
+
+    expect(readFileSync(log, 'utf8')).toContain('deploy -y --access clawd-fc')
+    expect(userAccessYaml()).toBe(USER_ACCESS_YAML)
+  })
+})
+
+describe('remove-extension.sh', () => {
+  it('用 clawd-fc profile 调 s remove，不碰用户全局 ~/.s', () => {
+    const log = join(box.root, 's-argv.log')
+    writeSShim(box.bin, log)
+
+    const ext = join(box.root, 'proj')
+    const persona = join(box.root, 'persona')
+    mkdirSync(ext, { recursive: true })
+    mkdirSync(join(persona, 'extension-kit'), { recursive: true })
+    writeFileSync(join(ext, 'ext.conf'), 'APP_NAME=demo\nSLUG=ab12\n')
+    writeFileSync(join(persona, 'extension-kit', 'config.env'), 'REGION=cn-hangzhou\n')
+
+    execFileSync('bash', [join(box.kit, 'scripts', 'remove-extension.sh'), ext, persona], {
+      env: { ...process.env, HOME: box.home, PATH: `${box.bin}:${process.env.PATH}` },
+      encoding: 'utf8',
+    })
+
+    expect(readFileSync(log, 'utf8')).toContain('remove -y --access clawd-fc')
+    expect(userAccessYaml()).toBe(USER_ACCESS_YAML)
+  })
+})

package/dist/deploy-kit/scripts/publish.sh

@@ -39,21 +39,8 @@ DEPLOY_NAME="${APP_NAME}-${SLUG}"
 # 2) 工具链 + 阿里云凭证（分层：shared demo + 可选 local override）
 source "$KIT_DIR/scripts/ensure-toolchain.sh"
 ensure_toolchain
-[ -f "$KIT_DIR/.secrets/aliyun.env" ] || { echo "❌ 缺 $KIT_DIR/.secrets/aliyun.env（clawd ship 的共享 demo 凭证，OTA 自动刷新）。参考 .secrets/aliyun.env.example 填写。" >&2; exit 1; }
-set -a; . "$KIT_DIR/.secrets/aliyun.env"; set +a
-# aliyun.env.local: 本机个人 override（永远不被 OTA 覆盖，见 refreshDeployKit）。有就后 source 覆盖 env。
-[ -f "$KIT_DIR/.secrets/aliyun.env.local" ] && { set -a; . "$KIT_DIR/.secrets/aliyun.env.local"; set +a; }
-export ALIBABA_CLOUD_REGION_ID="${REGION:?config.env 缺 REGION}"
-_ident="$(aliyun --mode AK sts GetCallerIdentity 2>&1)" || { echo "❌ aliyun sts GetCallerIdentity 失败(检查 .secrets/aliyun.env 凭证):" >&2; echo "$_ident" >&2; exit 1; }
-ACC="$(printf '%s' "$_ident" | python3 -c 'import sys,json;print(json.load(sys.stdin)["AccountId"])')" || { echo "❌ 解析 AccountId 失败,aliyun 输出非 JSON:" >&2; echo "$_ident" >&2; exit 1; }
-mkdir -p ~/.s
-cat > ~/.s/access.yaml <<EOF
-default:
-  AccountID: '$ACC'
-  AccessKeyID: $ALIBABA_CLOUD_ACCESS_KEY_ID
-  AccessKeySecret: $ALIBABA_CLOUD_ACCESS_KEY_SECRET
-EOF
-chmod 600 ~/.s/access.yaml
+source "$KIT_DIR/scripts/ensure-credentials.sh"
+ensure_credentials
 
 # 3) persona hook（可选）：校验/导出 persona 特化运行时变量（如 SESSION_SECRET / APP_BASE_URL / persona 密钥）
 if [ -f "$PERSONA_KIT/hooks/pre-deploy.sh" ]; then
@@ -94,7 +81,7 @@ sed "${sed_args[@]}" "$TMPL" > "$EXT_DIR/s.yaml"
 # 7) deploy + verify
 echo "::stage::deploy"
 echo "==> s deploy ($DEPLOY_NAME)"
-( cd "$EXT_DIR" && s deploy -y )
+( cd "$EXT_DIR" && s deploy -y --access "$S_ACCESS_ALIAS" )
 
 echo "::stage::verify"
 # 精确匹配 s.yaml.tmpl 里写死的 domainName 模式: <DEPLOY_NAME>.app.clawos.chat

package/dist/deploy-kit/scripts/remove-extension.sh

@@ -25,14 +25,13 @@ TABLE_PREFIX="${APP_NAME}_${SLUG:+${SLUG}_}"
 source "$KIT_DIR/scripts/ensure-toolchain.sh"
 ensure_toolchain
 
-# 阿里云凭证（分层：shared demo + 可选 local override）
-[ -f "$KIT_DIR/.secrets/aliyun.env" ] || { echo "❌ 缺 $KIT_DIR/.secrets/aliyun.env（clawd ship 的共享 demo 凭证，OTA 自动刷新）。" >&2; exit 1; }
-set -a; . "$KIT_DIR/.secrets/aliyun.env"; set +a
-[ -f "$KIT_DIR/.secrets/aliyun.env.local" ] && { set -a; . "$KIT_DIR/.secrets/aliyun.env.local"; set +a; }
+# 阿里云凭证（分层：shared demo + 可选 local override）+ deploy-kit 私有的 s profile
+source "$KIT_DIR/scripts/ensure-credentials.sh"
+ensure_credentials
 
 # 1) 删 FC 侧(函数 + 触发器 + 自定义域名)
 echo "==> 删 FC 资源: $APP_NAME${SLUG:+ (deploy=${APP_NAME}-${SLUG})}"
-( cd "$EXT_DIR" && s remove -y )
+( cd "$EXT_DIR" && s remove -y --access "$S_ACCESS_ALIAS" )
 
 # 2) 列出要删的 Supabase 表(脚本不直接调 DB,改打印 DROP 让 agent 用 supabase MCP 跑)。
 # bash 调不到 MCP(MCP 是 LLM 通道),pg 直连要密码 agent 拿不到 —— 最干净:打印 DROP,

package/dist/dispatch/mcp-server.cjs

@@ -22682,6 +22682,14 @@ var SessionFileSchema = external_exports.object({
   // 快速问答临时会话标记（spec 2026-06-23-fork-quick-ask）：true = 关闭抽屉即删、
   // 不进 sidebar 树、daemon 启动清扫孤儿。普通会话缺省。
   ephemeral: external_exports.boolean().optional(),
+  /**
+   * 这条会话属于哪张部署单（persona 上云的环境扫描会话）。
+   *
+   * 有值 = 它在单据页右栏里活着，**sidebar 不再列它**——同一条会话两处出现，和话题 worker
+   * 会话不进「最近」是同一条规矩。不复用 `ephemeral`：那个标记会被 daemon 启动清扫**删掉**，
+   * 而扫描会话要跟单据一样长期留着（人隔天回来还要翻管家当时是怎么判的、还要接着追问）。
+   */
+  deployId: external_exports.string().min(1).optional(),
   // owner-mode persona session 身份标识；UI 用它在 SessionList 过滤 + jump，
   // daemon 用它做 idempotent dedupe + spawn 时派生 ctx.personaMode='owner'
   ownerPersonaId: external_exports.string().min(1).optional(),
@@ -23840,9 +23848,13 @@ var METHOD_DOCS = {
     args: WorkspaceReadArgs
   },
   "deploy:start": {
-    summary: "\u5BF9\u67D0\u4E2A persona \u53D1\u8D77\u4E00\u6B21\u4E0A\u4E91\u90E8\u7F72\uFF1A\u5EFA\u5355\u636E\u5E76**\u5F02\u6B65**\u8D77\u73AF\u5883\u626B\u63CF\u3002\u7ACB\u523B\u8FD4\u56DE scanning \u6001\u5355\u636E\uFF0C\u626B\u63CF\u8981\u8DD1\u51E0\u5206\u949F\u3001\u626B\u5B8C\u7531\u540E\u53F0\u56DE\u5199\uFF1Bowner-only",
+    summary: "\u6253\u5F00\u67D0\u4E2A persona \u7684\u90E8\u7F72\u5355\uFF1A**\u5DF2\u6709\u5C31\u539F\u6837\u8FD4\u56DE\u90A3\u5F20**\uFF08\u8349\u7A3F\u7EED\u586B\uFF0C\u4E0D\u91CD\u626B\uFF0C\u4E5F\u4E0D\u65B0\u5EFA\uFF09\uFF0C\u6CA1\u6709\u624D\u5EFA\u4E00\u5F20\u5E76**\u5F02\u6B65**\u8D77\u73AF\u5883\u626B\u63CF\u3002\u4E00\u4E2A persona \u540C\u65F6\u53EA\u6709\u4E00\u5F20\u5355\uFF0C\u8981\u91CD\u626B\u8D70 deploy:rescan\uFF1Bowner-only",
     args: DeployStartArgsSchema
   },
+  "deploy:rescan": {
+    summary: "\u5C31\u5730\u91CD\u626B\u4E00\u5F20\u5DF2\u6709\u7684\u90E8\u7F72\u5355\uFF1A\u6E05\u6389\u4E0A\u6B21\u626B\u51FA\u6765\u7684\u6E05\u5355 / \u8BC1\u636E / \u5B58\u7591\u9879\uFF0C\u72B6\u6001\u56DE scanning\uFF0C\u8D77\u4E00\u4E2A\u65B0\u7684\u626B\u63CF\u4F1A\u8BDD\u3002**\u5DF2\u586B\u7684\u51ED\u636E\u503C\u548C\u5C65\u7EA6\u9009\u62E9\u539F\u6837\u4FDD\u7559**\uFF08\u5B83\u4EEC\u6309\u5355\u636E id \u5B58\uFF0C\u4E0D\u968F\u626B\u63CF\u7ED3\u679C\u8D70\uFF09\uFF0C\u6240\u4EE5\u91CD\u626B\u4E0D\u4F1A\u8BA9\u4EBA\u767D\u586B\u4E00\u904D\uFF1Bowner-only",
+    args: DeployIdArgsSchema
+  },
   "deploy:list": {
     summary: "\u5217\u51FA\u5168\u90E8\u90E8\u7F72\u5355\uFF08\u65B0\u7684\u5728\u524D\uFF09\uFF1Bowner-only\u3002\u65E0\u53C2\u6570",
     args: NO_ARGS

package/dist/persona-defaults/persona-app-builder/CLAUDE.md

@@ -173,16 +173,20 @@ AK/SK 分两层，都放在共享 deploy-kit 下（`$HOME/.clawd/deploy-kit/.sec
 - **`aliyun.env`** — clawd ship 的**共享 demo 凭证**（归属 RAM 用户 `clawd-fc-developer`，权限收敛：`AliyunFCFullAccess` + `STSAssumeRole` + `Log` + `OSS` + `YundunCert-RO`）。**每次 daemon 启动 refreshDeployKit 会用 defaults 里的最新版覆盖本文件（OTA 即升级）**——用户不用手动 rotate。
 - **`aliyun.env.local`**（可选）— 本机个人 override，永远不被 OTA 覆盖。publish.sh / remove-extension.sh 先 source `aliyun.env`（shared）、再 source `aliyun.env.local`（后者的值覆盖前者）。用户想用自己的 AK（如不想让 demo AK 部署到自己账号）就复制 `aliyun.env.local.example` → `aliyun.env.local` 填自己的值。
 
-手动跑 CLI 时在当前 shell 加载：
+手动跑 CLI 时在当前 shell 加载（`ensure-credentials.sh` 就是 publish.sh / remove-extension.sh 用的那套，别另起炉灶）：
 
 ```bash
-set -a
-. "$HOME/.clawd/deploy-kit/.secrets/aliyun.env"
-[ -f "$HOME/.clawd/deploy-kit/.secrets/aliyun.env.local" ] && . "$HOME/.clawd/deploy-kit/.secrets/aliyun.env.local"
-set +a
+export KIT_DIR="$HOME/.clawd/deploy-kit"
+source "$HOME/.clawd/personas/persona-app-builder/extension-kit/config.env"  # REGION 等平台变量
+source "$KIT_DIR/scripts/ensure-toolchain.sh"   && ensure_toolchain          # 缺 aliyun/s 则装
+source "$KIT_DIR/scripts/ensure-credentials.sh" && ensure_credentials
 ```
 
-之后 `aliyun` / `s` / `ossutil` 会自动读这两个环境变量。Serverless Devs 还需 `~/.s/access.yaml` 含 `AccountID`（用 `aliyun sts GetCallerIdentity` 取），SK 走 heredoc 写入、不进命令行。
+⚠️ **上面这几行和后续的 `aliyun` / `s` 命令必须在同一个 Bash 调用里跑完**——你的 Bash tool 每次调用是独立进程，shell 变量不跨调用留存。分两次跑 = 第二次丢了 `serverless_devs_config_home`，`s` 会回头去读 `~/.s` 然后报 `Not found access: clawd-fc`。**这时正确做法是把 source 那几行和 `s` 命令拼进同一条命令重跑，绝不是去写 `~/.s/access.yaml`。**
+
+之后 `aliyun` / `ossutil` 直接可用（AK 已进 env）。**Serverless Devs（`s`）要显式带 profile**：凭证写在 deploy-kit 私有的 `.s-home/` 里、profile 名 `clawd-fc`，所以每次都是 `s deploy -y --access "$S_ACCESS_ALIAS"` / `s remove -y --access "$S_ACCESS_ALIAS"`。
+
+**红线：绝不写用户全局 `~/.s/access.yaml`**。那里的 `default` 是用户自己账号的凭证，clawd 用的是共享 demo AK，盖上去用户的就没了、不可恢复。
 
 - **红线**：绝不 `echo` / 打印 / 写进日志或提交记录里暴露 SK；绝不把 `.secrets/` 拷进被部署的项目代码（已被 `.gitignore` 挡住）。**shared aliyun.env 为空**（demo 凭证意外没 ship）先停下提醒老板；**用户想用自己的 AK** 就引导他建 `aliyun.env.local`，别去改 shared 那份（OTA 会盖回）。
 

package/dist/persona-defaults/persona-app-builder/extension-kit/contract/s.yaml.tmpl

@@ -7,7 +7,9 @@
 #                    保证多用户/多副本同名时不撞 FC 函数 + 不撞域名
 edition: 3.0.0
 name: __DEPLOY_NAME__-app
-access: default
+# clawd 自己的 Serverless Devs profile，写在 deploy-kit 私有 s-home 里（见 scripts/ensure-credentials.sh）。
+# 刻意不用 default —— 那是用户自己账号的 profile，不该被 clawd 读也不该被 clawd 写。
+access: clawd-fc
 
 vars:
   region: __REGION__

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/contract/s.yaml.tmpl

@@ -2,7 +2,9 @@
 # 框架无关:command 固定走 ./bootstrap,入口由 FC_ENTRY 环境变量决定
 edition: 3.0.0
 name: __APP_NAME__-app
-access: default
+# clawd 自己的 Serverless Devs profile，写在 deploy-kit 私有 s-home 里（见 scripts/ensure-credentials.sh）。
+# 刻意不用 default —— 那是用户自己账号的 profile，不该被 clawd 读也不该被 clawd 写。
+access: clawd-fc
 
 vars:
   region: __REGION__