@clawos-dev/clawd 0.2.444 → 0.2.446

package/dist/dispatch/mcp-server.cjs

@@ -21272,6 +21272,172 @@ var ContactHandshakeOkSchema = external_exports.object({
   grants: external_exports.array(GrantSchema)
 });
 
+// ../protocol/src/environment-schemas.ts
+var EnvCliSchema = external_exports.object({
+  // 可执行文件名，装配后要能在 PATH 里直接调到（'aliyun' / 's' / 'pnpm' / 'python3'）
+  name: external_exports.string().min(1),
+  /**
+   * 从哪装，约定 `<kind>:<ref>`：`npm:@serverless-devs/s` / `github:aliyun/aliyun-cli` /
+   * `apt:python3`。
+   *
+   * **不是装饰字段，是构建器的必需输入**：可执行名往往推不出安装源——Serverless Devs 的命令
+   * 就叫单个字母 `s`，没人能从 's' 猜到要 `npm i -g @serverless-devs/s`；`aliyun` 也不在
+   * apt 源里，得从 GitHub release 拉 tarball。扫描器读 ensure-toolchain.sh 的时候本来就看见
+   * 了这些，顺手带出来即可。
+   *
+   * 它同时解决人的阅读问题：单据上只写一个 `s`，看的人不知道那是什么东西。
+   *
+   * 允许缺省：扫描器拿不准安装源时不该编一个（编错了构建期才炸，还查不出来源）。缺省时构建
+   * 器会失败或猜错，试装当场暴露——这跟整体「宁可让试装发现，不要靠猜」的取向一致。
+   *
+   * 只给一个源，不给平台回落链：本地那套 brew → GitHub → npm 的三级兜底是
+   * ensure-toolchain.sh 的事，云上只构一个镜像、一个基础环境，多给反而要求构建器做选择。
+   */
+  from: external_exports.string().optional(),
+  // 精确版本；缺省 = 不挑版本，装配器自选
+  version: external_exports.string().optional(),
+  // 版本下限（'20.6' 这种）。与 version 的区别：version 是「就要这个」，min 是「不低于」。
+  // 两者都缺省即完全不约束。
+  min: external_exports.string().optional()
+});
+var EnvSecretSchema = external_exports.object({
+  // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。
+  name: external_exports.string().min(1),
+  // 解析出的值注入到哪些环境变量。一份凭据可含多个字段（AK 是 id+secret 两个，
+  // supabase 是 url/anon/service-role/jwt 四个），所以是数组不是单值。
+  env: external_exports.array(external_exports.string().min(1)).min(1)
+});
+var EnvAssetSchema = external_exports.object({
+  name: external_exports.string().min(1)
+});
+var MANIFEST_BODY = {
+  clis: external_exports.array(EnvCliSchema),
+  secrets: external_exports.array(EnvSecretSchema),
+  assets: external_exports.array(EnvAssetSchema)
+};
+var EnvManifestBodySchema = external_exports.object(MANIFEST_BODY);
+var EnvironmentManifestSchema = external_exports.object({
+  // 格式版本。manifest 要跨进程（daemon 扫 → 镜像构建器读）也跨时间（部署记录留档），
+  // 加字段兼容但改语义不兼容，留一个显式版本位。
+  version: external_exports.literal(1),
+  ...MANIFEST_BODY
+}).strict();
+var EnvEvidenceSchema = external_exports.object({
+  // 这条证据支持的是哪一项：`${kind}:${name}`，如 'cli:aliyun' / 'secret:aliyun-ak'
+  target: external_exports.string().min(1),
+  // 一句人话：为什么需要它 + 从哪看出来的。单据默认显示这句。
+  reason: external_exports.string().min(1),
+  // persona 目录内的相对路径（'CLAUDE.md' / '.claude/skills/foo/SKILL.md'）
+  file: external_exports.string().min(1),
+  // 原文摘录（一两句即可，不是整段）。默认收起，起疑时才看。
+  //
+  // **自由文本，schema 守不住凭据值**：这里只验得了非空，而 agent 被要求「引原文不要转述」，
+  // 引到 `KEY=值` 那行是迟早的事。落盘前由 daemon 的 deploy/redact.ts 涂抹（reason 同理）。
+  quote: external_exports.string().min(1)
+});
+
+// ../protocol/src/deploy-schemas.ts
+var FulfillmentSchema = external_exports.enum(["deployer", "user"]);
+var DeployStatusSchema = external_exports.enum([
+  "scanning",
+  "scanFailed",
+  "draft",
+  "ready",
+  "trialing",
+  "failed",
+  "deployed"
+]);
+var DeployGapSchema = external_exports.object({
+  // agent 的自然语言错因，如「我要解析 aliyun 的 JSON 输出，但容器里没有 python3」
+  errorText: external_exports.string().min(1),
+  // 原始输出片段，给人自己判断用
+  raw: external_exports.string().optional(),
+  // 建议补的依赖：`cli:python3` 这种。拿不准就不给，让人自己决定。
+  suggest: external_exports.string().optional()
+}).strict();
+var DeployReceiptSchema = external_exports.object({
+  deployId: external_exports.string().min(1),
+  personaId: external_exports.string().min(1),
+  status: DeployStatusSchema,
+  /**
+   * 干这次扫描的 butler 会话 id。单据上「看它怎么干的」入口靠它把工作过程调出来。
+   *
+   * 扫描不是 daemon 里一个闷头跑的黑盒进程，是 persona-butler 的一次真实会话——用户能翻
+   * 看它读了哪些文件、搜了什么。这条也顺带解决「它到底有没有上网查」这类问题：不用另造
+   * 探针去抓证据，看一眼就知道。
+   */
+  scanSessionId: external_exports.string().optional(),
+  // 扫描产物；scanning / scanFailed 时还没有
+  manifest: EnvironmentManifestSchema.optional(),
+  evidence: external_exports.array(EnvEvidenceSchema).optional(),
+  smokeTask: external_exports.string().optional(),
+  notes: external_exports.array(external_exports.string()).default([]),
+  /**
+   * 每条凭据的履约选择：secret name → 'deployer' | 'user'。
+   * **只记「谁出」，不记值。** 没做选择的凭据不在这个 map 里（缺席即未定），
+   * 用缺席而不是 'unset' 枚举值表达未定，省掉一个下游要处处判的第三态。
+   */
+  fulfillment: external_exports.record(external_exports.string(), FulfillmentSchema).default({}),
+  /** 试装失败时的缺口清单；成功或没试装过是空数组 */
+  gaps: external_exports.array(DeployGapSchema).default([]),
+  // 扫描 / 试装失败的原因（status 是 scanFailed / failed 时才有意义）
+  error: external_exports.string().optional(),
+  createdAt: external_exports.number(),
+  updatedAt: external_exports.number()
+}).strict();
+var DeployStartArgsSchema = external_exports.object({
+  personaId: external_exports.string().min(1)
+}).strict();
+var DeployIdArgsSchema = external_exports.object({
+  deployId: external_exports.string().min(1)
+}).strict();
+var DeployPatchArgsSchema = external_exports.object({
+  deployId: external_exports.string().min(1),
+  patch: external_exports.object({
+    fulfillment: external_exports.record(external_exports.string(), FulfillmentSchema).optional(),
+    smokeTask: external_exports.string().min(1).optional(),
+    // 人工补依赖（试装失败后补 python3 这种）；整份替换 manifest
+    manifest: EnvironmentManifestSchema.optional()
+  }).strict()
+}).strict();
+var DeployPutSecretArgsSchema = external_exports.object({
+  deployId: external_exports.string().min(1),
+  // 对应 manifest.secrets[].name
+  name: external_exports.string().min(1),
+  // 环境变量名 → 值。key 必须是该 secret 声明过的 env 之一，handler 校验。
+  values: external_exports.record(external_exports.string(), external_exports.string())
+}).strict();
+var DeployReportFindingArgsSchema = external_exports.object({
+  deployId: external_exports.string().min(1),
+  kind: external_exports.enum(["cli", "secret", "asset"]),
+  // 该条目在 manifest 对应数组里的内容（形状随 kind 变，handler 按 kind 收窄校验）
+  item: external_exports.record(external_exports.string(), external_exports.unknown()),
+  // 这条发现的来历（一句人话 + 原文出处），形状同 EnvEvidence，target 由 handler 从 kind+name 派生
+  evidence: external_exports.object({
+    reason: external_exports.string().min(1),
+    file: external_exports.string().min(1),
+    quote: external_exports.string().min(1)
+  })
+}).strict();
+var DeployFinishScanArgsSchema = external_exports.object({
+  deployId: external_exports.string().min(1),
+  smokeTask: external_exports.string().min(1),
+  notes: external_exports.array(external_exports.string()).default([])
+}).strict();
+var DeploySecretStatusSchema = external_exports.object({
+  name: external_exports.string(),
+  // 该 secret 声明的 env 里已有值的个数
+  filled: external_exports.number(),
+  total: external_exports.number()
+}).strict();
+var DeployReceiptViewSchema = external_exports.object({
+  receipt: DeployReceiptSchema,
+  secretStatus: external_exports.array(DeploySecretStatusSchema)
+}).strict();
+var DeployListResultSchema = external_exports.object({
+  receipts: external_exports.array(DeployReceiptSchema)
+}).strict();
+
 // ../protocol/src/contact-remote-access.ts
 var ContactSetRemoteAccessArgsSchema = external_exports.object({
   deviceId: external_exports.string().min(1),
@@ -23499,11 +23665,11 @@ var METHOD_DOCS = {
     }
   },
   "session:externalScan": {
-    summary: "\u626B\u63CF\u672C\u673A Claude Code / Codex \u5386\u53F2\u4F1A\u8BDD\uFF0C\u8FD4\u56DE\u53EF\u5BFC\u5165\u5019\u9009\u6E05\u5355\uFF08cwd/toolSessionId/\u65F6\u95F4\u6233/\u8F6E\u6570\uFF09\uFF1B\u6458\u8981\u7EDF\u8BA1\u4E0E\u65F6\u95F4\u7A97\u8FC7\u6EE4\u7531 UI \u6D3E\u751F\uFF0Cskip \u89C4\u5219\u4E0E clawd-session-import skill \u4E00\u81F4\uFF1Bowner-only",
+    summary: "\u626B\u63CF\u672C\u673A Claude Code / Codex \u5386\u53F2\u4F1A\u8BDD\uFF0C\u8FD4\u56DE\u53EF\u5BFC\u5165\u5019\u9009\u6E05\u5355\uFF08cwd/toolSessionId/\u65F6\u95F4\u6233/\u8F6E\u6570\uFF09\uFF1Bowner-only\u3002\u88AB skip \u7684\u76F4\u63A5\u4E0D\u8FD4\u56DE\uFF1Asubagent \u652F\u7EBF / \u65E0 cwd / \u975E\u7528\u6237\u5165\u53E3\uFF08CC \u7684 entrypoint \u4E0D\u662F cli\xB7claude-desktop\uFF09/ \u975E\u7528\u6237\u65B0\u5EFA\xB7\u5DF2\u5F52\u6863\xB7\u7A7A\u4F1A\u8BDD\uFF08codex\uFF09/ \u96F6\u7528\u6237\u53D1\u8A00 / \u5DE5\u4F5C\u76EE\u5F55\u5DF2\u4E0D\u5B58\u5728 / cwd \u5728 ~/.clawd \u4E0B / \u5DF2\u5BFC\u5165\u8FC7\uFF08\u53BB\u91CD\u96C6\u5408 = \u6D3B\u7740\u7684 session \u222A \u5BFC\u5165\u53F0\u8D26\uFF0C\u5220\u4E86\u4F1A\u8BDD\u4E5F\u4E0D\u5931\u5FC6\uFF09\u3002**\u9664\u300C\u96F6\u7528\u6237\u53D1\u8A00\u300D\u5916\u4E0D\u518D\u8BBE\u8F6E\u6B21\u95E8\u69DB\uFF0C\u4E5F\u4E0D\u505A\u65F6\u95F4\u7A97\u8FC7\u6EE4**\u2014\u2014\u6309\u8FD4\u56DE\u7684 turns / \u65F6\u95F4\u6233\u7531\u8C03\u7528\u65B9\u81EA\u5DF1\u7B5B\uFF08UI \u7684\u6458\u8981\u7EDF\u8BA1\u540C\u7406\uFF09\u3002\u53E6\u6709\u6574\u6E90\u4E0D\u4EA7\u5019\u9009\u7684\u60C5\u51B5\uFF1A\u672C\u673A\u6CA1\u88C5 codex\u3001\u6216 codex \u5E93\u91CC\u5224\u4E0D\u51FA\u4F1A\u8BDD\u5165\u53E3\uFF08\u65E0 threads \u8868 / \u7F3A thread_source \u5217\uFF09\u65F6\uFF0C**codex \u4FA7\u6574\u4E2A\u8FD4\u7A7A**\uFF0C\u4E0D\u662F\u9010\u6761 skip",
     args: SessionExternalScanArgs
   },
   "session:importExternal": {
-    summary: "\u628A Claude Code / Codex \u65E2\u6709\u5386\u53F2\u4F1A\u8BDD\u5BFC\u5165\u4E3A clawd \u5F15\u7528\uFF1A\u53EA\u5199 SessionFile\uFF0C\u4E0D\u62C9\u8D77 runner\uFF0C\u4E0D\u6539\u539F\u59CB transcript\uFF1B\u6309 toolSessionId \u8DE8 owned scope \u53BB\u91CD\uFF0C\u65B0\u5BFC\u5165\u4F1A\u5E7F\u64AD session:info",
+    summary: "\u628A Claude Code / Codex \u65E2\u6709\u5386\u53F2\u4F1A\u8BDD\u5BFC\u5165\u4E3A clawd \u5F15\u7528\uFF1A\u5199 SessionFile + \u5F80\u5BFC\u5165\u53F0\u8D26 append \u4E00\u884C\uFF08\u53BB\u91CD\u547D\u4E2D\u7684\u4E0D\u843D\u8D26\uFF09\uFF0C**\u4E0D\u62C9\u8D77 runner\u3001\u4E0D\u6539\u539F\u59CB transcript**\uFF1B\u6309 toolSessionId \u8DE8 owned scope \u53BB\u91CD\uFF0C\u65B0\u5BFC\u5165\u4F1A\u5E7F\u64AD session:info\u3002\u53F0\u8D26 append-only \u4E14\u4E0D\u968F\u4F1A\u8BDD\u5220\u9664\u6D88\u5931\u2014\u2014\u5220\u6389\u4F1A\u8BDD\u4E0D\u7B49\u4E8E\u64A4\u9500\u5BFC\u5165\uFF0C\u60F3\u8BA9\u67D0\u6761\u91CD\u65B0\u53EF\u5BFC\u5165\u8981\u8D70 clawd-session-import --undo \u6E05\u8D26",
     args: SessionImportExternalArgs
   },
   "session:list": {
@@ -23515,7 +23681,7 @@ var METHOD_DOCS = {
     args: SessionIdArgs
   },
   "session:update": {
-    summary: "\u6539\u4F1A\u8BDD\u5143\u6570\u636E\uFF0C\u4E0D\u5F71\u54CD\u8FDB\u7A0B\u3002patch \u5141\u8BB8\u7684\u952E\uFF1Alabel / model / permissionMode / effort / cwd / iconKey\u2014\u2014**\u4F20\u522B\u7684\u952E\u4F1A\u88AB\u9759\u9ED8\u4E22\u5F03**\uFF08zod strip\uFF09\uFF0Chandler \u7167\u6837\u8FD4 ok",
+    summary: "\u6539\u4F1A\u8BDD\u5143\u6570\u636E\uFF0C\u4E0D\u5F71\u54CD\u8FDB\u7A0B\u3002**patch \u91CC\u7684\u672A\u77E5\u952E\u4F1A\u88AB\u9759\u9ED8\u4E22\u5F03**\uFF08zod strip\uFF09\uFF0Chandler \u7167\u6837\u8FD4 ok\u2014\u2014\u5141\u8BB8\u54EA\u4E9B\u952E\u4EE5 argsSchema \u4E3A\u51C6\uFF08meta:methods \u4F20 method \u53C2\u6570\u5373\u53EF\u53D6\u5230\uFF09\uFF0C\u522B\u7167\u8BB0\u5FC6\u731C\u3002ephemeral \u53EA\u6536 false\uFF1A\u5FEB\u901F\u95EE\u7B54\u4F1A\u8BDD\u8F6C\u6B63\u53EA\u80FD\u6458\u4E0D\u80FD\u6253\uFF0C\u53CD\u5411\u6807\u8BB0\u4F1A\u8BA9\u4F1A\u8BDD\u4ECE\u6240\u6709 sidebar \u89C6\u91CE\u6D88\u5931\u4E14\u5220\u4E0D\u6389",
     args: SessionUpdateArgs
   },
   "session:delete": {
@@ -23647,11 +23813,11 @@ var METHOD_DOCS = {
     args: NO_ARGS
   },
   "project:list": {
-    summary: "\u5217\u51FA project registry\uFF08owner-only\uFF09\uFF1Bpersona / ~/.clawd \u5185\u90E8\u76EE\u5F55\u5DF2\u88AB\u8FC7\u6EE4\uFF0C\u4F1A\u8BDD\u5F52\u7EC4\u5728 UI \u4FA7\u505A",
+    summary: "\u5217\u51FA\u9879\u76EE\u6E05\u5355\uFF08owner-only\uFF09\u3002**\u771F\u503C = Codex \u7684 local-projects \u222A \u672C\u673A projects.json \u53E0\u52A0\u5C42**\uFF1A\u6309\u5F52\u4E00\u5316 path \u53BB\u91CD\u3001Codex \u4FA7\u7684 name \u4F18\u5148\uFF08\u7528\u6237\u5728 Codex \u91CC\u6539\u8FC7\u7684\u66F4\u6743\u5A01\uFF09\uFF0CCodex \u91CC createdAt=0 \u7684\u81EA\u52A8\u6536\u5F55\u6761\u76EE\u8DF3\u8FC7\uFF1B\u6CA1\u914D Codex state \u6587\u4EF6\u65F6\u9000\u5316\u4E3A\u53EA\u6709\u672C\u5730\u53E0\u52A0\u5C42\u3002\u4E09\u6761\u8DEF\u5F84\u5224\u636E\u4E00\u5F8B\u8FC7\u6EE4\uFF1A~/.clawd \u5B50\u6811 / home \u6839 / \u6587\u4EF6\u7CFB\u7EDF\u6839\u3002\u4F1A\u8BDD\u5F52\u7EC4\u5728 UI \u4FA7\u505A",
     args: NO_ARGS
   },
   "project:create": {
-    summary: "\u65B0\u5EFA project\uFF1A\u6821\u9A8C\u76EE\u5F55\u5B58\u5728 + \u975E ~/.clawd \u5B50\u6811\uFF0Cupsert \u8FDB ~/.clawd/projects.json\uFF08owner-only\uFF09\u3002**path \u4E0E name \u81F3\u5C11\u4F20\u4E00\u4E2A**",
+    summary: "\u65B0\u5EFA project\uFF08owner-only\uFF09\u3002**path \u4E0E name \u81F3\u5C11\u4F20\u4E00\u4E2A**\uFF0C\u4E24\u6761\u5206\u652F\u526F\u4F5C\u7528\u4E0D\u540C\uFF1A\u7ED9 path = \u5728\u73B0\u6210\u76EE\u5F55\u4E0A\u767B\u8BB0\uFF08\u53EA\u6821\u9A8C\u662F\u76EE\u5F55\uFF0C\u4E0D\u52A8\u78C1\u76D8\uFF09\uFF1B**\u53EA\u7ED9 name = \u5728 ~/Documents/ChatGPT/<name>/ \u5EFA\u76EE\u5F55\u5E76 git init**\uFF08\u649E\u540D\u52A0\u6570\u5B57\u540E\u7F00 `x 2`\uFF1Bgit init \u5931\u8D25\u4F1A\u6E05\u6389\u521A\u5EFA\u7684\u76EE\u5F55\u518D\u62A5\u9519\uFF09\u3002\u843D\u8FDB\u672C\u673A projects.json \u53E0\u52A0\u5C42\uFF08\u8DEF\u5F84\u987B\u8FC7 project:list \u90A3\u4E09\u6761\u5224\u636E\uFF0C\u5426\u5219\u62A5\u9519\uFF09\uFF0C**\u4E0D\u5199 Codex registry**\uFF08Codex \u4FA7\u9760\u81EA\u7136\u6536\u5F55\uFF09",
     args: ProjectCreateArgs,
     argsConstraints: {
       anyOf: [{ required: ["path"] }, { required: ["name"] }]
@@ -23673,6 +23839,38 @@ var METHOD_DOCS = {
     summary: "\u8BFB\u6587\u4EF6\u5185\u5BB9\uFF1Bguest \u8DEF\u5F84\u8FB9\u754C\u4E0E workspace:list \u540C",
     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",
+    args: DeployStartArgsSchema
+  },
+  "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
+  },
+  "deploy:get": {
+    summary: "\u53D6\u4E00\u5F20\u90E8\u7F72\u5355 + \u6BCF\u6761\u51ED\u636E\u7684\u586B\u5199\u8FDB\u5EA6\u3002**\u8FDB\u5EA6\u53EA\u6709\u4E2A\u6570\u4E0D\u542B\u503C**\u2014\u2014\u51ED\u636E\u503C\u4E0D\u7ECF\u8FC7\u8FD9\u6761\u8DEF\uFF1Bowner-only",
+    args: DeployIdArgsSchema
+  },
+  "deploy:patch": {
+    summary: "\u7F16\u8F91\u90E8\u7F72\u5355\uFF1A\u9009\u5C65\u7EA6\uFF08\u8C01\u51FA\u8FD9\u6761\u51ED\u636E\uFF09/ \u6539\u5192\u70DF\u4EFB\u52A1 / \u624B\u5DE5\u8865\u4F9D\u8D56\u3002**\u4E0D\u80FD\u4ECE\u8FD9\u91CC\u4F20\u51ED\u636E\u7684\u503C**\uFF08\u503C\u8D70 deploy:putSecret\uFF09\uFF1B\u5C65\u7EA6\u540D\u5FC5\u987B\u662F\u6E05\u5355\u91CC\u58F0\u660E\u8FC7\u7684\u51ED\u636E\uFF1Bowner-only",
+    args: DeployPatchArgsSchema
+  },
+  "deploy:putSecret": {
+    summary: "\u5F55\u5165\u4E00\u6761\u51ED\u636E\u7684\u503C\u3002**\u8FD9\u662F\u503C\u552F\u4E00\u7684\u5165\u53E3**\uFF1A\u5165\u53C2\u4E0D\u8FDB\u65E5\u5FD7\u3001\u54CD\u5E94\u53EA\u56DE\u586B\u5199\u8FDB\u5EA6\u4E0D\u56DE\u663E\u503C\u3002env \u540D\u5FC5\u987B\u662F\u8BE5\u51ED\u636E\u5728\u6E05\u5355\u91CC\u58F0\u660E\u8FC7\u7684\uFF0C\u5426\u5219\u503C\u5B58\u4E86\u4E5F\u6C38\u8FDC\u6CE8\u5165\u4E0D\u5230\uFF1Bowner-only",
+    args: DeployPutSecretArgsSchema
+  },
+  "deploy:reportFinding": {
+    summary: "\u626B\u63CF\u4E2D\u7684 butler \u9010\u6761\u4E0A\u62A5\u4E00\u4E2A\u53D1\u73B0\uFF08cli / secret / asset\uFF09\u3002**\u8FB9\u626B\u8FB9\u62A5**\uFF0C\u5355\u636E\u9875\u968F\u4E4B\u4E00\u70B9\u70B9\u586B\u5145\uFF1B\u540C (kind,name) \u91CD\u590D\u4E0A\u62A5\u5373\u8986\u76D6\u3002owner-only\u2014\u2014butler \u4F1A\u8BDD\u672C\u8EAB\u8DD1\u5728 owner \u6A21\u5F0F",
+    args: DeployReportFindingArgsSchema
+  },
+  "deploy:finishScan": {
+    summary: "butler \u6536\u5C3E\uFF1A\u7ED9\u51FA\u5192\u70DF\u4EFB\u52A1\u4E0E\u5B58\u7591\u9879\uFF0C\u5355\u636E\u4ECE scanning \u8F6C draft\u3002\u6CA1\u8C03\u5230\u5B83\u5C31\u7B49\u4E8E\u6CA1\u626B\u5B8C\u2014\u2014butler \u4F1A\u8BDD\u7ED3\u675F\u65F6\u5355\u636E\u8FD8\u505C\u5728 scanning\uFF0Cdaemon \u636E\u6B64\u5224 scanFailed\uFF1Bowner-only",
+    args: DeployFinishScanArgsSchema
+  },
+  "deploy:remove": {
+    summary: "\u5220\u6389\u4E00\u5F20\u90E8\u7F72\u5355\uFF0C\u8FDE\u5E26\u6E05\u6389\u5B83\u7684\u5168\u90E8\u51ED\u636E\u503C\uFF08\u503C\u4E0D\u8BE5\u6BD4\u5355\u636E\u6D3B\u5F97\u4E45\uFF09\uFF1Bowner-only",
+    args: DeployIdArgsSchema
+  },
   "shift:list": {
     summary: "\u5217\u51FA owner \u7684\u5168\u90E8 shift\uFF08\u6392\u73ED\uFF09\uFF0C\u7ED9 UI \u65E5\u5386\u6E32\u67D3\u7528\uFF1Bowner-only",
     args: NO_ARGS
@@ -23745,7 +23943,7 @@ var METHOD_DOCS = {
   },
   // ---- master:*（授权查表，Master 经 clawd-rpc 桥调）----
   "master:authorityCheck": {
-    summary: "\u67E5 Master \u7684\u6388\u6743\u8BBE\u5B9A\uFF08\u5168\u5C40\u4E00\u5957\uFF09\uFF1A\u8FD4\u56DE ask / allow / deny\u3002\u8868\u7F3A\u5931\u3001\u8BFB\u574F\u3001\u7ED3\u6784\u4E0D\u5BF9\u3001action \u62FC\u9519\u3001id \u672A\u767B\u8BB0\uFF0C\u4E00\u5F8B\u88C1\u51B3 ask",
+    summary: "\u67E5 Master \u7684\u6388\u6743\u8BBE\u5B9A\uFF08\u5168\u5C40\u4E00\u5957\uFF09\uFF1A\u8FD4\u56DE ask / allow / deny + source\u3002**\u8BBE\u5B9A\u6587\u4EF6\u4E0D\u5B58\u5728 \u2192 \u7528\u51FA\u5382\u9ED8\u8BA4\u89C4\u5219\u8868**\uFF08source=default\uFF0C\u5F53\u524D\u56DB\u6761\u5BF9\u5916\u4E0D\u53EF\u9006\u52A8\u4F5C\u5168\u662F ask\uFF0C\u522B\u628A\u5B83\u5F53\u5F02\u5E38\u515C\u5E95\uFF09\uFF1B\u8BFB\u574F / \u7ED3\u6784\u4E0D\u5BF9 / action \u62FC\u9519 / id \u672A\u767B\u8BB0 \u2192 **fail-safe \u88C1\u51B3 ask**\uFF08source=fallback:<\u539F\u56E0>\uFF0C\u4E0D\u9759\u9ED8\u541E\uFF09",
     args: AuthorityCheckArgsSchema
   },
   "github:status": {
@@ -23869,7 +24067,7 @@ var METHOD_DOCS = {
     args: NO_ARGS
   },
   "persona:get": {
-    summary: "\u53D6\u5355\u4E2A persona \u8BE6\u60C5\uFF0C**\u542B personality\uFF08CLAUDE.md \u6B63\u6587\uFF09**\u2014\u2014\u552F\u4E00\u643A\u5E26\u6B63\u6587\u7684 method\u3002\u54CD\u5E94\u628A PersonaFile \u5E73\u94FA\u5728\u5E27\u4E0A\uFF08\u65E0 persona \u5305\u88F9\u952E\uFF09\uFF1B\u67E5\u4E0D\u5230 / guest \u65E0\u6743\u9650\u629B PERSONA_NOT_FOUND",
+    summary: "\u53D6\u5355\u4E2A persona \u8BE6\u60C5\u2014\u2014\u552F\u4E00\u643A\u5E26\u4EBA\u683C\u6B63\u6587\u7684 method\uFF0C\u800C**\u6B63\u6587\u662F\u4E24\u5C42\u3001\u8981\u8BFB\u5168\u5F97\u4E24\u5C42\u90FD\u770B**\uFF1Apersonality\uFF08builtin CLAUDE.md\uFF09+ personalityLocal\uFF08\u8865\u5145\u5C42 .clawd/personality.local.md\uFF0C'' = \u6CA1\u5199\uFF09\uFF0CpersonalityManaged \u6807 builtin \u5C42\u5F52\u4E0D\u5F52 daemon \u6258\u7BA1\uFF08\u9884\u88C5 persona = \u4EA7\u54C1\u89C4\u683C\u3001\u53EA\u8BFB\uFF09\u3002\u53E6\u5E26 skills / plugins / sandboxSettings / codexSandbox\u3002\u54CD\u5E94\u628A PersonaFile \u5E73\u94FA\u5728\u5E27\u4E0A\uFF08\u65E0 persona \u5305\u88F9\u952E\uFF09\uFF1B\u67E5\u4E0D\u5230 / guest \u65E0\u6743\u9650\u629B PERSONA_NOT_FOUND",
     args: PersonaIdArgsSchema
   },
   "persona:update": {
@@ -23905,16 +24103,16 @@ var METHOD_DOCS = {
     args: PeerExecRunArgsSchema
   },
   "session:pty:input": {
-    summary: "\u628A\u7528\u6237\u952E\u76D8\u5B57\u8282\u5199\u8FDB pty stdin\uFF08\u4EC5 CLAWD_CC_MODE=tui\uFF09\u3002\u9AD8\u9891\u5E27\uFF0C\u4E0D\u5165 reducer\u3002body: { sessionId, data\uFF08base64-utf8\uFF09 }"
+    summary: "\u628A\u7528\u6237\u952E\u76D8\u5B57\u8282\u5199\u8FDB pty stdin\uFF08\u4EC5 CLAWD_CC_MODE=tui\uFF09\u3002\u9AD8\u9891\u5E27\uFF0C\u4E0D\u5165 reducer\u3002body: { sessionId, data\uFF08base64-utf8\uFF09 }\u3002**\u53C2\u6570\u7F3A\u5931 / \u7C7B\u578B\u4E0D\u5BF9 / \u975E tui / pty \u5DF2\u9000\u51FA\u90FD\u9759\u9ED8\u8FD4 ok:false \u800C\u4E0D\u62A5\u9519**\uFF08\u9AD8\u9891\u5E27\u4E0D\u80FD\u629B\u9519\u5237\u5C4F\uFF09\u2014\u2014\u62FF\u5230 false \u5206\u4E0D\u51FA\u662F\u54EA\u79CD\u539F\u56E0\u3002\u53EA\u6709\u8D8A\u6743\u8BBF\u95EE\u8BE5\u4F1A\u8BDD\u624D\u629B\u9519"
   },
   "session:pty:resize": {
-    summary: "\u540C\u6B65\u7EC8\u7AEF\u5C3A\u5BF8\u7ED9 pty\uFF08\u4EC5 tui \u6A21\u5F0F\uFF09\u3002body: { sessionId, cols, rows }"
+    summary: "\u540C\u6B65\u7EC8\u7AEF\u5C3A\u5BF8\u7ED9 pty\uFF08\u4EC5 tui \u6A21\u5F0F\uFF09\u3002body: { sessionId, cols, rows }\u3002**\u540C pty:input\uFF1A\u53C2\u6570\u4E0D\u5BF9 / \u627E\u4E0D\u5230 pty \u9759\u9ED8\u8FD4 ok:false\uFF0C\u4E0D\u62A5\u9519**"
   },
   "session:pty:snapshot": {
-    summary: "\u62C9\u5F53\u524D pty \u5C4F\u5E55\u5168\u91CF\u5FEB\u7167\uFF08\u5207\u56DE\u4F1A\u8BDD / \u5237\u65B0\u65F6\u7528\uFF09\uFF0C\u8FD4\u56DE { data, atSeq, popupKind }\uFF1B\u975E tui \u6216\u5DF2\u9000\u51FA\u65F6 data=null\u3002body: { sessionId }"
+    summary: "\u62C9\u5F53\u524D pty \u5C4F\u5E55\u5168\u91CF\u5FEB\u7167\uFF08\u5207\u56DE\u4F1A\u8BDD / \u5237\u65B0\u65F6\u7528\uFF09\uFF0C\u8FD4\u56DE { data, atSeq, popupKind }\u3002body: { sessionId }\u3002**\u7F3A sessionId \u9759\u9ED8\u8FD4 ok:false\uFF1B\u975E tui / pty \u5DF2\u9000\u51FA\u8FD4 ok:true \u4F46 data=null, atSeq=0** \u2014\u2014 \u4E24\u8005\u90FD\u4E0D\u62A5\u9519\uFF0C\u8981\u5206\u6E05\u5F97\u770B ok\u3002\u53EA\u6709\u8D8A\u6743\u8BBF\u95EE\u8BE5\u4F1A\u8BDD\u624D\u629B\u9519"
   },
   "attachment.signUrl": {
-    summary: "\u7ED9\u5DF2\u5165\u7FA4\u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09",
+    summary: "\u7ED9\u5DF2\u5165\u7FA4**\u4E14\u975E stale** \u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09\u3002**\u9ED8\u8BA4 24h \u8FC7\u671F**\uFF1BttlSeconds \u663E\u5F0F\u4F20 null = \u6C38\u4E0D\u8FC7\u671F\u3002\u4E0D\u5728\u6E05\u5355\u91CC\u548C stale \u62A5\u540C\u4E00\u4E2A\u9519\uFF0C\u5206\u4E0D\u51FA\u662F\u54EA\u79CD",
     args: AttachmentSignUrlArgs
   },
   "attachment.groupAdd": {
@@ -23942,7 +24140,7 @@ var METHOD_DOCS = {
     args: InboxPostMessageArgsSchema
   },
   "inbox:sendDm": {
-    summary: "\u4EE5\u5F53\u524D\u4F1A\u8BDD\u7684\u8EAB\u4EFD\u53D1\u4E00\u6761 DM\uFF08\u53D1\u4FE1\u4EBA\u7531 session scope \u5F52\u56E0\uFF0C\u4E0D\u53EF\u4F2A\u9020\uFF09\u3002**owner \u9A71\u52A8\u7684\u4F1A\u8BDD\u5FC5\u586B peerDeviceId**\uFF0Cguest \u9A71\u52A8\u7684\u53EF\u7701",
+    summary: "\u4EE5\u5F53\u524D\u4F1A\u8BDD\u7684\u8EAB\u4EFD\u53D1\u4E00\u6761 DM\uFF08\u53D1\u4FE1\u4EBA\u7531 session scope \u5F52\u56E0\uFF0C\u4E0D\u53EF\u4F2A\u9020\uFF09\u3002**owner \u9A71\u52A8\u7684\u4F1A\u8BDD\u5FC5\u586B peerDeviceId**\uFF0Cguest \u9A71\u52A8\u7684\u53EF\u7701\uFF08\u4E14\u53EA\u80FD\u53D1\u7ED9 owner\uFF09\u3002**sessionId \u786C\u5FC5\u586B\u4F46\u4E0D\u5728 args schema \u91CC**\uFF08clawd-rpc \u81EA\u52A8\u8865\uFF0C\u76F4\u8FDE\u987B\u81EA\u5E26\uFF09\uFF0C\u4E14\u5FC5\u987B\u662F persona \u4F1A\u8BDD\uFF0C\u5426\u5219\u62D2",
     args: InboxSendDmArgsSchema
   },
   "contact:list": {
@@ -24010,7 +24208,7 @@ var METHOD_DOCS = {
     args: ExtensionIdArgs
   },
   "extension.publish": {
-    summary: "\u628A\u672C\u673A extension \u516C\u5F00\u5230\u5206\u4EAB\u9891\u9053\uFF0C\u4F9B\u8054\u7CFB\u4EBA\u62C9\u53D6\u3002owner-only",
+    summary: "\u628A\u672C\u673A extension \u516C\u5F00\u5230**\u5206\u53D1\u6E20\u9053**\uFF08extension \u7684\u5206\u4EAB\u9762\uFF0C\u4E0E channel:* \u7684\u300C\u9891\u9053\u300D\u662F\u4E24\u56DE\u4E8B\uFF09\uFF0C\u4F9B\u8054\u7CFB\u4EBA\u62C9\u53D6\u3002owner-only\u3002**\u7ED9\u4E86 newVersion \u4F1A\u5148\u539F\u5B50\u6539\u5199\u8BE5 extension \u78C1\u76D8\u4E0A manifest.json \u7684 version**\uFF08\u683C\u5F0F\u4E0D\u5408 semver \u2192 INVALID_VERSION\uFF1B\u6B64\u524D\u53D1\u5E03\u8FC7\u7684\u8FD8\u8981\u6C42\u4E25\u683C\u5927\u4E8E\u4E0A\u4E00\u4E2A\u5DF2\u53D1\u5E03\u7248\u672C\uFF0C\u5426\u5219 VERSION_NOT_BUMPED\uFF0C\u9996\u6B21\u53D1\u5E03\u4E0D\u6BD4\u8F83\uFF09\uFF1Bnull = \u4E0D bump",
     args: ExtensionPublishArgs
   },
   "extension.unpublish": {
@@ -24030,11 +24228,11 @@ var METHOD_DOCS = {
     args: ExtensionFetchBundleArgs
   },
   "extension.install-from-channel": {
-    summary: "\u5728\u81EA\u5DF1 daemon \u4E0A\u4ECE\u5206\u4EAB\u9891\u9053\u5B89\u88C5 extension",
+    summary: "\u5728\u81EA\u5DF1 daemon \u4E0A\u88C5\u4E00\u4E2A\u6765\u81EA**\u5206\u53D1\u6E20\u9053**\u7684 extension\uFF08channelRef \u6307\u7684\u662F\u5206\u53D1\u6E20\u9053\uFF0C\u4E0E channel:* \u7684\u300C\u9891\u9053\u300D\u65E0\u5173\uFF09\u3002**bundle \u5B57\u8282\u8981\u8C03\u7528\u65B9\u7ED9**\uFF08zipBase64\uFF09\u2014\u2014daemon \u4E0D\u81EA\u5DF1\u53BB\u5BF9\u7AEF\u53D6\uFF0C\u5B8C\u6574\u94FE\u8DEF\u662F extension.list-published \u2192 extension.fetchBundle \u2192 \u672C\u65B9\u6CD5",
     args: ExtensionFromChannelArgs
   },
   "extension.update-from-channel": {
-    summary: "\u5728\u81EA\u5DF1 daemon \u4E0A\u628A\u5DF2\u88C5 extension \u66F4\u65B0\u5230\u9891\u9053\u6700\u65B0\u7248",
+    summary: "\u628A\u5DF2\u88C5 extension \u66F4\u65B0\u5230**\u5206\u53D1\u6E20\u9053**\u4E0A\u7684\u65B0\u7248\u672C\uFF1B\u4E0E install-from-channel \u540C\u6837\u8981\u8C03\u7528\u65B9\u81EA\u5E26 zipBase64\uFF0C\u53D6\u5B57\u8282\u4ECD\u8D70 extension.fetchBundle",
     args: ExtensionFromChannelArgs
   },
   "auth:login:start": {
@@ -24070,7 +24268,7 @@ var METHOD_DOCS = {
     args: GetProjectArgsSchema
   },
   "appBuilder:createProject": {
-    summary: "\u7ED9\u4F1A\u8BDD\u7ED1\u5B9A\u65B0 project\uFF1A\u6821\u9A8C\u540D + \u4ECE 6173-6182 \u6BB5\u5206\u914D\u7AEF\u53E3 + \u5EFA\u76EE\u5F55\u5199\u5143\u6570\u636E",
+    summary: "\u7ED9\u4F1A\u8BDD\u7ED1\u5B9A\u65B0 project\uFF1A\u6821\u9A8C\u540D + \u4ECE PROJECT_PORT_MIN..MAX \u6BB5\uFF08\u5F53\u524D 6173-6272\uFF09\u5206\u914D\u672A\u5360\u7528\u7AEF\u53E3\uFF08\u8DE8 user \u5168\u5C40\u552F\u4E00\uFF0C\u6C60\u6EE1\u62A5\u9519\uFF09+ \u5EFA\u76EE\u5F55\u5199\u5143\u6570\u636E + **\u540C\u6B65 scaffold**\uFF08spawn \u811A\u672C\u628A nestjs-react \u6A21\u677F\u62F7\u8FDB\u53BB\uFF1B\u5931\u8D25\u4F1A\u5220\u6389\u521A\u5EFA\u7684\u76EE\u5F55\u518D\u629B INTERNAL\uFF0C\u4E0D\u7559\u534A\u6210\u54C1\uFF09\u3002**\u88C5\u4F9D\u8D56\u548C\u8D77 dev server \u90FD\u4E0D\u5728\u8FD9\u91CC**\uFF1A\u843D\u5730 stage=install-pending\uFF0C\u8C03\u7528\u65B9\u81EA\u5DF1 pnpm install + appBuilder:reportStage + appBuilder:startDevServer",
     args: CreateProjectArgsSchema
   },
   "appBuilder:deleteProject": {
@@ -24078,7 +24276,7 @@ var METHOD_DOCS = {
     args: DeleteProjectArgsSchema
   },
   "appBuilder:updateProjectPort": {
-    summary: "\u6539 dev server \u7AEF\u53E3\uFF08\u6821\u9A8C\u6BB5\u5185 + \u4E0D\u649E\u8F66\uFF09\u5E76\u91CD\u542F",
+    summary: "\u6539 dev server \u7AEF\u53E3\uFF08\u6821\u9A8C\u5728 PROJECT_PORT_MIN..MAX \u6BB5\u5185\u3001\u5F53\u524D 6173-6272\uFF1B**\u649E\u8F66\u53EA\u67E5\u8C03\u7528\u65B9\u81EA\u5DF1\u540D\u4E0B\u7684 project**\uFF0C\u4E0D\u50CF createProject \u90A3\u6837\u8DE8 user \u67E5\uFF09\uFF1A\u505C\u65E7\u7AEF\u53E3 dev server + \u6539 .clawd-project.json + \u7F6E stage=stopped\u3002**\u4E0D\u81EA\u52A8\u62C9\u8D77\u65B0\u7AEF\u53E3\u7684 dev server**\u2014\u2014\u8981\u8D77\u5F97\u518D\u8C03 appBuilder:startDevServer\uFF08\u90A3\u6761\u624D\u8D70 readiness probe\uFF09",
     args: UpdateProjectPortArgsSchema
   },
   "appBuilder:setProdUrl": {

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-persona-for-deploy/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: scan-persona-for-deploy
+description: 老板要把某个 persona 发布到云上时触发——把这个 persona 读一遍，弄清它挪到一台干净的云上机器要预备什么（命令行工具、凭据、随行资产），边查边填进部署单据。收到形如「扫描 persona-xxx 的部署环境，deployId=dp-xxxx」的任务时使用。只负责扫，不负责部署。
+---
+
+# 扫 persona 的上云环境
+
+老板在界面上点了「发布到云上」，现在有一张空的部署单据等着你填。**这张单据是随你干活一点点
+长出来的**——他正看着页面，你查明白一条就报一条，别攒到最后一次性倒出来。
+
+## 你要回答的问题
+
+这个 persona 如果被搬到一台**干净的 Linux 容器**里跑（没有任何人的 home 目录、没有预装工具、
+没有任何凭据），需要事先给它备好什么，它才能正常干活？
+
+## 读什么
+
+主体是任务里给你的 persona 目录，把里面的**全部文本**读完：
+
+- `CLAUDE.md` / `AGENTS.md`——人格与操作指引，依赖大多写在这里
+- `.claude/skills/**/SKILL.md` 及 skill 附带的脚本
+- `.mcp.json`——挂了哪些 MCP server，怎么启动、要什么参数
+- 目录里的任何脚本、模板、配置样例
+
+**关键：跟着引用往外走至少一跳。** 人格里出现的文件路径、脚本名、命令，都要去把那个文件读了
+再下结论。一句「发布走 publish.sh」背后可能藏着五六个命令行工具，只读人格发现不了。
+
+任务里会告诉你还有哪些 persona 目录之外的共享资产可以读（如 `deploy-kit`）。
+
+## 边查边报
+
+每查明白一条，立刻调 `clawd-rpc` 的 `call`：
+
+```
+call({ method: "deploy:reportFinding", args: {
+  deployId: "<任务里给的>",
+  kind: "cli" | "secret" | "asset",
+  item: { ... },        // 见下面各类的字段
+  evidence: { reason: "...", file: "...", quote: "..." }
+}})
+```
+
+同一个名字重复上报即覆盖——先给初判、读到更硬的证据再修正，是允许的。
+
+### kind: "cli" —— 需要预装的命令行工具
+
+`item` 字段：`name`（必填，可执行名）、`from`（从哪装）、`version`（精确版本）、`min`（版本下限）。
+
+只列**干净容器里不会自带**的：要列 `aliyun` / `s`(Serverless Devs) / `pnpm` / `python3` / `git`
+这类；不必列 `ls` `cat` `grep` `sed` `awk` `curl` `tar` `bash` 这些基础镜像自带的。
+
+**`from` 必须给出，查清楚是你的活，不是留给老板的作业。** 写成 `<kind>:<ref>`，如
+`npm:@serverless-devs/s` / `github:aliyun/aliyun-cli` / `apt:python3`。按这个顺序找：
+
+1. **persona 自己的脚本**——工具链自举脚本（如 `ensure-toolchain.sh`）里往往直接写着安装命令。
+   这层最可信：是这个 persona 实际验证过的装法。
+2. **你已经知道的**——`python3` / `git` / `rsync` 这类常见工具，直接给 `apt:<包名>`。
+3. **上网查**——前两层没有就用 WebSearch 查官方安装文档。冷门工具、自研 CLI、包名和命令名对不上
+   的（`s` 那种）都走这条。以官方文档为准，别信随手一篇博客。
+
+只有三层都试过还查不到，才允许省略 `from`，并在收尾的 `notes` 里写清你查了什么、卡在哪。
+
+注意目标是 **Linux 容器**：persona 脚本里的 macOS 装法（brew 之类）不能照抄，要找 Linux 对应的。
+
+版本：拿得准精确版本填 `version`，只知道下限填 `min`，都不确定就都不填。**不要猜版本号**。
+
+### kind: "secret" —— 需要的凭据
+
+`item` 字段：`name`（命名引用，短横线小写）、`env`（字符串数组，这份凭据要落进哪些环境变量）。
+
+- 一份凭据含多个字段就把多个环境变量都列进 `env`（AK 是 id+secret 两个，supabase 是四个）
+- **绝对不要把凭据的值写进来**，哪怕你在文件里看到了明文的 key。你只报告「这里需要一份
+  supabase 凭据」，值由老板另外填进单据。看到明文 key 也不要复述它的内容。
+- **不要判断这条凭据该谁出**（部署者出还是使用者自带）。那是老板的决定，不是你能扫出来的。
+
+### kind: "asset" —— persona 目录之外的共享资产
+
+`item` 字段只有 `name`。任务里列的共享资产里，这个 persona 确实用到的才报。
+
+资产是从本机整包带走的，**没有「装法」这回事**，不要给它编 `from`。
+
+### evidence —— 每条的来历
+
+- `reason`：**一句人话**，说清「为什么需要它 + 你从哪看出来的」，写给不熟悉这个 persona 的人看。
+  - 好：「发布脚本用它解析 aliyun CLI 返回的 JSON，没有它 publish 走不到底」
+  - 差：「publish.sh 里用到了 python3」（复述原文，没说清为什么要）
+  - 差：「用于 JSON 解析」（太短，看不出跟这个 persona 有什么关系）
+- `file`：persona 目录内的相对路径，或资产名开头的路径
+- `quote`：原文摘一两句，**引原文不要转述**（老板起疑时展开核对用）
+
+**引文里不要带凭据的值。** 这条对 `quote` 和 `reason` 都成立——引到 `KEY=值` 这种行时，
+把等号右边换成 `<已略去>` 再写进来：
+
+```
+好：SUPABASE_KEY=<已略去>
+好：ALIYUN_ACCESS_KEY_SECRET=          ← 空值/占位符本身就是证据，照引不用改
+差：SUPABASE_KEY=eyJhbGciOiJIUzI1NiIs...
+```
+
+值一旦进了单据，就会跟着单据进 UI、进日志、将来进模型上下文。左边的键名和这行在哪个文件，
+已经足够老板核对了，右边的值对他没有任何用处。
+
+## 收尾
+
+全部查完，调一次：
+
+```
+call({ method: "deploy:finishScan", args: {
+  deployId: "<任务里给的>",
+  smokeTask: "...",
+  notes: ["...", "..."]
+}})
+```
+
+**`smokeTask`** —— 一句冒烟任务。这个 persona 上云后会被真跑一遍来验证环境装全了：
+
+- 覆盖它的**主线活**（读完人格你该知道它主要干什么）
+- 尽量把你列的依赖都用上——用不到的依赖，试装也验不出来
+- 规模最小：能跑通就行，别让它干半小时
+- 用祈使句，就像老板会怎么吩咐它
+
+**`notes`** —— 需要老板判断的事。例如「这个 skill 要求浏览器登录，云上大概率不可用」、
+「这里引用的服务是裸 IP，可能受出网策略影响」、「某个工具三层都查了还是没找到装法，卡在 X」。
+没有就空数组。
+
+调完 `finishScan` 单据就从「分析中」转成可编辑的草稿，你的活就结束了。
+
+## 纪律
+
+- **只读不写**：不要修改被扫 persona 目录里的任何文件，不要执行它的脚本。
+- **宁缺毋滥**：拿不准的放进 `notes`，不要编一条依赖进单据。多报一条假依赖会让镜像装一堆没用的
+  东西；漏报一条真依赖，后面试装会当场发现。
+- **没调 `finishScan` 就等于没扫完**——中途卡住也要调，把卡在哪写进 `notes`，别让单据一直停在
+  「分析中」。