Market Sizing & Strategic Modeling（市场规模测算与战略建模）

通过 alice-market-sizing-strategic-modeling 调用万得 Alice Agent，围绕特定市场、细分赛道或产品机会，一键生成结构化市场规模模型与研究报告。

核心原则：基础设施交给脚本处理；Agent 只负责把用户的市场测算问题拼成一句自然语言 prompt 传入。默认就执行 Market Sizing & Strategic Modeling 技能，无需也不要再指定其它 Skill。 任务完成后，只将 CLI stdout 中的 agentResult.value 原文原样交给用户；CLI 静默下载的附件（reportFullFile=）不要读给用户看。

宿主 Agent：执行任何 shell 命令前必须先读同目录 AGENT.md（一页执行契约，与 IDE 无关，随 skill 包发布）。

技能介绍

官方技能：市场规模测算与战略建模

专业级市场规模量化分析工具。通过自上而下（TD）与自下而上（BU）双路径交叉验证，结合多情景预测与敏感性分析，输出可直接用于决策的市场规模 Excel 模型与结构化研究报告。

适用场景：

• 市场规模测算 — 量化某个行业/细分市场的当前体量与历史趋势
• 市场预测建模 — 预测未来 3-10 年的市场增长路径（CAGR、TAM/SAM/SOM）
• 战略进入评估 — 评估新市场的可寻址规模，支持投资或业务拓展决策
• 多情景分析 — 构建乐观/基准/悲观情景，量化关键假设的敏感性
• 竞争格局建模 — 分析市场细分结构、区域分布与渠道占比
• 投融资支撑材料 — 为 BP、尽调报告、战略规划提供可引用的市场数据模型

试试这样问：

• 帮我测算中国 AI 大模型应用市场的规模
• 全球新能源汽车市场未来 5 年的增长预测
• 中国私募股权市场的 TAM/SAM/SOM 是多少？
• 帮我建一个东南亚跨境电商市场的规模模型
• 医疗器械耗材市场的市场规模和增速是多少？
• 预测中国 SaaS 市场 2025-2030 年的收入规模
• 帮我做一个咖啡连锁市场的自下而上测算
• 分析宠物经济市场的细分结构和增长驱动

💡 提示：

• 必要输入：市场名称（你想测算哪个市场）；地理范围（中国/全球/某区域，不填则自动推断）
• 可选输入：测算指标（收入/GMV/用户数/AUM 等）、预测年限（默认未来 5 年）、币种
• 默认同时构建自上而下与自下而上两套模型，并进行交叉验证
• 自动生成公式驱动的 Excel 模型文件，可直接下载使用
• 支持 compact（3-5 页快速决策版）或 full（10-15 页完整报告版）两种报告模式，可在对话中指定
• 每个关键假设均附有数据来源、置信区间与合理性校验

输出形式

• Agent 向用户展示的内容：CLI stdout 中的 agentResult.value 正文（服务端流式返回）
• 自动生成的结构化内容包含：市场定义、测算方法论、关键假设、Top-down / Bottom-up 测算结果、交叉验证、情景与敏感性分析、结论与建议
• 部分场景下 CLI 会静默把完整报告附件与 Excel 模型下载到用户 Downloads/ 文件夹或 -d 指定目录（供用户本地查阅）；Agent 向用户展示时只用 agentResult.value，不要粘贴附件正文
• 数据受限时在对应模块明确标注

Agent 调用红线（必读）

Agent 调用本技能时，一律用下列单条命令（CLI 内部自旋直到拿到结果）。按操作系统选写法——禁止在 Windows PowerShell 里用 cd ... && node ...（&& 会 ParserError，命令根本不会执行）。

Windows PowerShell（Trae / Cursor 默认 shell，一律用方案 A）：

= 本 SKILL.md 所在目录的绝对路径（例：C:Users<用户名>.agentsskills）。

# ✅ 方案 A（唯一推荐）：amssm.ps1 绝对路径，无需 cd，自带 UTF-8 代码页
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" --prompt "" --no-wait

# ❌ 禁止：PowerShell 5.x 不支持 &&，整条命令解析失败
cd "" && node scripts/cli.mjs --prompt "..." --no-wait

# ❌ 禁止：裸 node 相对路径（易因 cwd 不对而失败；且无 UTF-8 包装）
Set-Location ""; node scripts/cli.mjs --prompt "..." --no-wait

macOS / Linux（bash / zsh）：

cd /path/to/alice-market-sizing-strategic-modeling && node scripts/cli.mjs --prompt "" --no-wait

判定与红线（CLI 程序层已强制，但 Agent 仍须能识别这些信号、不被 stdout 文案误导）：

五大红线（违反任一条都会导致重复消耗积分 / 编造结果 / 向用户交付错误数据）：

1. 阻塞等待 CLI 进程结束——禁止 check_command_status / Start-Sleep 替代。
2. 不要换 prompt 重试——"分析X" 与 "分析X，关注Y" 会被识别为相似任务直接 exit=76。
3. 没有 DONE 行 = 未完成——不要把 STATUS=COMPLETED 文案、tasks.json 中 running 记录或 download/ 目录 mtime 当成"完成"。
4. 禁止手动翻目录猜报告——不要用 view_folder / view_files 扫 download/、results/ 或 logs/；若 CLI 未完成，stdout 会出现 ALICE_ARTIFACT_GUARD / ALICE_POLL_HEARTBEAT / ALICE_MISLEAD_RISK / ORPHAN_DOWNLOAD_CANDIDATE 提示，这些只是警告，不是可交付的报告路径。
5. 只交付 agentResult.value，禁止概括，禁止展示下载附件正文——将 CLI stdout 中的 agentResult.value 原文交给用户；禁止自行总结、摘录、重写表格或「用自己的话」复述。若 stdout 被沙箱截断，读取 DONE 行 reportFile= 落盘正文（跳过 HTML 注释头）。DONE 含 reportFullFile= 时必须转告绝对路径；禁止读取 reportFullFile= / download/ 附件正文向用户展示。

完整步骤、异常处理、典型现场复盘见下方 Agent 调用流程 与 常见问题。

环境要求

1. Node.js 18+

CLI 基于 Node.js（18+ 自带 fetch）。node -v 检查，未达标到 nodejs.org 下载。

2. 获取并配置 WIND_API_KEY

获取：浏览器打开 万得 Alice → 设置 → 账户，在「API Key」一栏点「生成」/「复制」（失效或泄漏点「重置」会让旧 Key 立即作废）。

写入（推荐用 CLI 子命令）：

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" apikey-set 
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" apikey-get
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" apikey-clear

# macOS / Linux
node scripts/cli.mjs apikey-set     # 写入（KEY 裸值，不加引号）
node scripts/cli.mjs apikey-get          # 查看是否已配置 + 脱敏末四位
node scripts/cli.mjs apikey-clear        # 清除

CLI 把 Key 写到 ~/.wind-alice/config.env（Windows %USERPROFILE%.wind-aliceconfig.env），dotenv 格式单行 WIND_API_KEY=...——这是唯一受支持的位置。历史无后缀的 ~/.wind-alice/config 仍可读取，apikey-set 会自动迁移。

手动写入（无 Node 运维场景）：

# macOS / Linux
mkdir -p ~/.wind-alice && printf 'WIND_API_KEY=...n' > ~/.wind-alice/config.env && chmod 600 ~/.wind-alice/config.env

# Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE.wind-alice" | Out-Null
"WIND_API_KEY=..." | Set-Content -Encoding ascii "$env:USERPROFILE.wind-aliceconfig.env"

安全：CLI 不读环境变量，也不读 skill 目录内的 config.json——避免 Key 残留在 shell 历史 / CI 日志 / 提交记录。apikey-set / apikey-get stdout 仅回显脱敏 Key；macOS/Linux 会自动把文件权限收到 600。

CLI 调用说明

Windows Agent 一律用方案 A：amssm.ps1 写绝对路径，无需 cd。macOS / Linux 在 SKILL.md 所在目录下用 node scripts/cli.mjs（可用 cd ... &&）。

Windows PowerShell 语法（Agent 必读）

Trae / Cursor 在 Windows 上默认使用 PowerShell 5.x，不支持 &&。Agent 只能用方案 A：

# ✅ 方案 A（唯一写法）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" --prompt "帮我做一份金三江的市场规模测算与战略建模报告" --no-wait

# ❌ 禁止
cd "" && node scripts/cli.mjs --prompt "..."
Set-Location ""; node scripts/cli.mjs --prompt "..."

其他注意：

• 替换为本技能目录绝对路径；路径含空格时必须加双引号。
• 禁止在命令末尾拼接 undefined 等无效 token（部分 Agent 工具 bug）。
• bash 的 && 仅适用于 macOS / Linux，不要在 Windows PowerShell 里照搬。

中文乱码（Windows 必读）

根因：Node 输出 UTF-8 字节，Trae / PowerShell 5.x 管道捕获时默认按 GBK 解码 → live 输出变成 鏈繘绋嬪皢闃诲...，不是 CLI 坏了。

三层防护（由 CLI 自动提供）：

1. scripts/amssm.ps1：调用前切 UTF-8 代码页（Windows Agent 优先用它代替裸 node）。

2. ALICE_SESSION_LOG=：非 TTY 管道场景下，CLI 会把全部输出 tee 到 ~/.wind-alice/logs/.session.log（完整 64 位 promptHash，UTF-8 BOM）。只能读 stdout 打印的那条路径，禁止 view_folder logs/ 扫描：

   # ✅ 从本次 CLI stdout 复制 ALICE_SESSION_LOG= 的完整路径
   Get-Content -Path "$env:USERPROFILE.wind-alicelogs.session.log" -Encoding UTF8 -Tail 200 -Wait
   
   # ❌ 禁止：按 mtime 挑「最新」或只认 12 位前缀——不同 prompt（同公司）会落在不同文件
   

3. 落盘 .md（results/、Downloads/、--detach 日志）均带 UTF-8 BOM，Get-Content 即使不写 -Encoding UTF8 通常也能正确显示。

禁止：因 live 乱码就改 prompt 重试、连发多条 CLI、或手工 Start-Sleep 轮询 tasks.json。

查看 --detach 日志（避免中文乱码）

~/.wind-alice/logs/.log 由 CLI 以 UTF-8 写入。PowerShell 5.x 的 Get-Content 默认按 GBK 解码，会把 UTF-8 中文显示成 鏈繘绋嬪皢闃诲... 这类乱码——不是日志坏了，是读法错了。

# ✅ 正确：显式指定 UTF-8
Get-Content -Path "$env:USERPROFILE.wind-alicelogs969e4c647aae.log" -Encoding UTF8 -Tail 50 -Wait

# ❌ 错误：省略 -Encoding UTF8，中文 Windows 上几乎必乱码
Get-Content -Path "...969e4c647aae.log" -Tail 50 -Wait

自新版 CLI 起，--detach 创建的日志文件会写入 UTF-8 BOM，部分环境下即使不写 -Encoding UTF8 也能正常显示；仍建议 Agent 始终带 -Encoding UTF8。

命令行调用

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" --prompt "" --no-wait [-d ""] [--new]

# macOS / Linux
node scripts/cli.mjs --prompt "" --no-wait [-d ""] [--new]

参数

已废弃：--watch / -w（--no-wait 默认即内部自旋）。

调用示例

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" -p "帮我测算中国 AI 大模型应用市场的规模" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" -p "全球新能源汽车市场未来 5 年的增长预测，重点看 TAM/SAM" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" -p "预测中国 SaaS 市场 2025-2030 年的收入规模" --no-wait -d "D:reportsmarket-sizing"
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" -p "重新测算中国新能源汽车市场" --no-wait --new   # 仅用户说"重新跑"才加

# macOS / Linux
node scripts/cli.mjs -p "帮我测算中国 AI 大模型应用市场的规模" --no-wait
node scripts/cli.mjs -p "全球新能源汽车市场未来 5 年的增长预测" --no-wait
node scripts/cli.mjs -p "预测中国 SaaS 市场 2025-2030 年的收入规模" --no-wait -d "/reports/market-sizing"
node scripts/cli.mjs -p "重新测算中国新能源汽车市场" --no-wait --new

附件用 WIND_API_KEY 自动鉴权下载到 Downloads/ 或 -d 目录（CLI 在 DONE 行给出 reportFullFile= 路径仅供落盘核对）；Agent 交付用户时只用 agentResult.value，不要展示下载附件内容。

子命令

只读 / 配置类，不消耗服务端额度：

Agent 调用流程

上方「调用红线」已给出退出码识别与禁止动作；本节是分步操作流程。唯一推荐命令永远是 --no-wait，CLI 内部自旋直到完成。

1. 识别意图

用户提问命中以下任一场景即可调用：市场规模测算 / 市场增长预测 / TAM·SAM·SOM / 自下而上测算 / 情景与敏感性分析 / 细分结构建模。

2. 构造 prompt

把市场名称（行业/赛道/产品机会）和关注维度拼成一句自然语言。不要加 使用「...」技能： 前缀，CLI 内部已自动注入。

3. 解析下载目录意图

扫描用户对话中是否说过"下载到 X / 保存到 X / 放到 X 目录"。

• 命中 → 用 -d "" 传入（多次指定取最近一次，含空格的路径必须加双引号）。
• 未命中 → 不要传该参数；CLI 落到用户 Downloads/ 文件夹。

4. 告知用户耗时

Alice 市场规模测算与战略建模通常 2-15 分钟。调用前必须用一句话告诉用户这个耗时，并禁止中途取消或重复发起。

推荐话术：「好的，我来帮你分析。市场规模测算与战略建模通常需要 2–15 分钟，请稍等。」

5. 冲突预检（必做，避免与另一个 Agent 撞车）

主调用前先跑一条快速预检（纯本地查询，不发请求、不消耗额度）。

对用户说：「先确认一下没有重复任务……」

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" check-conflict --prompt ""

# macOS / Linux
node scripts/cli.mjs check-conflict --prompt ""

• 退出码 0：无 running 冲突、无 24h 内可重放的 completed（含同 prompt 本地 completed），主调用 --no-wait 将向服务端新建分析。注意：由于 check-conflict 与主调用的查询时机 / 沙箱写入延迟可能存在微小差异，即使 exit=0，主调用仍可能触发 replay（ALICE_NO_SERVER_CALL=1）；此时 Agent 必须按步骤 6 的 replay 处理流程询问用户，不得直接交付旧结果。

• 退出码 11：检测到已有 running 任务（ALICE_CONFLICT_CHECK kind=exact|similar），必须停下来询问用户。stdout 会逐行列出 EXISTING_TASK matchKind=... taskId=... elapsed=... promptPreview=...——把这些信息原样告诉用户，让用户三选一。对用户说：「已经有一条相同或相似的分析正在执行中，你想怎么处理？」

  • (A) 续接已有任务（推荐，最快）：用户原 prompt + --no-wait（CLI 会自动续接 running 任务）。
  • (B) 另外新建一条分析：加 --new --no-wait（须先经用户明确确认）。
  • (C) 取消本次提问。

  禁止 Agent 自作主张选 attach 或 --new；必须让用户裁决。

• 退出码 12：无 running 冲突，但 24h 内已有相似 completed 或同 prompt 本地 completed（kind=replay_available + REPLAY_CANDIDATE）。未经确认直接 --no-wait 会 重放本地结果（ALICE_NO_SERVER_CALL=1，不发请求）。必须停下来询问用户。对用户说：「最近已经有一条相同或相似的分析结果，你想怎么处理？」

  • (A) 查看已有结果（推荐）：用 stdout 里 REPLAY_CANDIDATE 的 原 promptPreview 执行 --no-wait（CLI 会 replay_completed）。
  • (B) 重新做一次分析：当前 prompt + --new --no-wait（必须 --new）。
  • (C) 取消。

  禁止在 exit=12 时直接 view_files 打开 REPLAY_CANDIDATE_REPORT path=——该文件绑定的是旧 promptHash，不是用户本次措辞的结果。

• 退出码 2：参数错误（通常是 prompt 缺失），按命令行错误处理。

这一步是处理"用户在多个 Agent 同时问相同问题"的关键。即便 Agent 跳过预检直接跑第 6 步，主路径在相似 prompt 上仍会兜底 exit=76、相同 prompt 上会自动 attach；但只有走预检 Agent 才能在动作发生之前让用户介入。

6. 执行命令并阻塞等待

对用户说：「已提交分析，正在等待结果，请稍候……」（禁止说「CLI 自旋」「进程」「shell」等技术细节）。

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" --prompt "" --no-wait [-d ""]

# macOS / Linux
node scripts/cli.mjs --prompt "" --no-wait [-d ""]

• 必须前台运行，阻塞等待该命令返回，读完整 stdout/stderr 与退出码。
• 禁止 fire-and-forget 写法：Start-Process（含 -NoNewWindow）、| Out-Null、nohup、后台 job 等。
• 禁止用 check_command_status / Start-Sleep / 轮询下载目录 / 轮询 tasks.json 替代等待 CLI 进程结束。
• 禁止在命令末尾拼接 undefined 或其它无效参数；只传 SKILL 列出的参数。
• 终端必须配置 ≥1200 秒（20min） 超时；若做不到（典型于 Trae run_command 数十秒就 kill），跳到下方第 8 步「沙箱被 kill 后的续接」即可——--no-wait 模式天然为此设计。
• replay 检测：进程退出后，若 stdout 含 ALICE_NO_SERVER_CALL=1 / reason=replay_completed，说明复用了本地已有结果而非新建分析——必须先询问用户（见下方「replay 重放处理」）。

7. 判定完成的唯一标准

stdout 含 ALICE_MARKET_SIZING_STRATEGIC_MODELING_DONE taskId=... promptHash=... reportFile=... reportFullFile=... 行 + 退出码 0。同时满足才算完成；promptHash= 必须与本次 --prompt 对应（CLI 启动时会打印 PROMPT_HASH= 供核对）。

以下情况一律视为未完成（即使 exit=0）：

• 只有 ALICE_MARKET_SIZING_STRATEGIC_MODELING_STATUS=COMPLETED / [任务已受理] / state=submitted，没有 DONE 行；
• 退出码 6（strict 兜底，进程被沙箱杀）或 76（重复提交防护）。

8. 沙箱被 kill 后的续接（Trae / Codex 等受限终端）

为何像「卡住」：市场规模测算与战略建模要 2–15 分钟，而 Trae/Cursor run_command 常只有 60–120s 超时。Agent 若用 check_command_status 轮询而非阻塞等待，终端会先杀 CLI（exit 4/6），服务端任务却仍在跑——results/ 尚未生成，Agent 误判为卡住。此时对用户说：「分析仍在进行中，我继续等待……」，不要向用户提及超时、被杀等技术细节。

首选：终端超时 ≥1200s，只发一条 --no-wait 阻塞等到 DONE。

无法拉长超时时，用 --detach 再续接：

powershell ... amssm.ps1 --prompt "" --detach
powershell ... amssm.ps1 --prompt "<和首次完全一致的 prompt>" --no-wait

退出码 4 或 6（未见到 DONE）——任务在服务端可能仍在跑。处理方式：

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "scriptsamssm.ps1" --prompt "<和首次完全一致的 prompt>" --no-wait

# macOS / Linux
node scripts/cli.mjs --prompt "<和首次完全一致的 prompt>" --no-wait

• 默认每 60s 探针一次；每轮最长 30min，CLI 自动续轮；全程最长 60min。
• 退出码 4 触顶时：再发一次相同命令续接；禁止连发多条、禁止 --new。
• 探针输出 state=submitted 是正常排队，不要因为连续几次 submitted 就 --new 或换 prompt。
• 禁止 check_command_status、Test-Path results/、Get-Content 扫 logs 猜进度——CLI 未输出 DONE 前这些都不能当交付依据。
• replay_completed 时 CLI 会把 agentResult.value 重新打印到 stdout；Agent 应读 stdout 原样交付，禁止 view_files 打开 results/ 后自行概括。

8.5 replay 重放处理（必须，当 stdout 含 ALICE_NO_SERVER_CALL=1）

主调用 --no-wait 返回后，若 stdout 含 ALICE_NO_SERVER_CALL=1 / reason=replay_completed，说明本次未向服务端发请求，直接复用了本地已有的 completed 结果——这不是新建分析。

即使 check-conflict 返回 exit=0，主调用仍可能 replay（两个命令的查询时机 / 沙箱写入延迟可能导致差异）。Agent 必须在交付前检查是否触发了 replay。

处理流程：

1. 检查 stdout 是否含 ALICE_NO_SERVER_CALL=1；
2. 若是：检查 agentResult.value 正文中的主体名称是否与用户请求一致；
   • 无论是否一致，均停下来告知用户。若主体不一致，说明：「检测到本地缓存的结果，且与本次请求可能不一致（例如请求富创精密，缓存为苏美达）。」若一致，说明：「该主体的市场规模测算与战略建模已有最近的结果。」然后统一列出选项：
     • (A) 查看已有结果 — 直接交付 stdout 的 agentResult.value 原文（不扣费）；
     • (B) 重新做一次分析 — 用相同 prompt 加 --new --no-wait 重新执行（将消耗积分）；
     • (C) 取消。
   • 禁止未经用户明确选择 (B) 就执行 --new --no-wait。
3. 若否：正常交付，按步骤 9 处理。

禁止在触发 replay 时未经用户确认就直接交付旧结果或自行加 --new 重跑。

9. 交付给用户：只要 agentResult.value（必看）

CLI 完成任务后，Agent 只向用户交付服务端 agentResult.value，不要展示下载附件。

正确流程（成功场景）：

1. stdout 出现 ALICE_MARKET_SIZING_STRATEGIC_MODELING_DONE 且 promptHash= 与本次 PROMPT_HASH= 一致；
2. 从 CLI stdout 提取全部 agentResult.value: 正文，原样呈现给用户（CLI 已自动去掉 ### …完整报告 与 /project/ 附件行）；其余正文禁止改写；
3. 若 stdout 被沙箱截断、读不全，再读 DONE 行 reportFile= 兜底文件的正文部分；
4. DONE 含 reportFullFile= 时，必须把完整报告附件的绝对路径转告用户（照抄 DONE 行或 ALICE_USER_DOWNLOAD_HINT=）；禁止只说「已下载」「可本地查阅」等空话；禁止读取 download/ 附件正文展示给用户。
5. 禁止把 results/ 称为「完整报告」——results/ 只是 agentResult.value 摘要副本，不是服务端 /project/*.md 附件。

转告路径：禁止空话 vs 必须写清

路径易混（必记）：

典型错误（永辉超市复盘）：(1) Agent 连发多条 CLI 未等到 DONE，读 results/.md 后自行概括成表格——数字会被改错；(2) 收尾告诉用户「完整报告在 %USERPROFILE%.wind-aliceresults」——**路径说反了**，完整附件实际在 %USERPROFILE%Downloads（DONE 行 reportFullFile=）。正确做法：阻塞等到 DONE → 输出 agentResult.value 原文 → 禁止概括 → 若附言文件路径，只引用 reportFullFile=，不把 results/ 当完整报告。

10. 任务调度 / 续接 / 强制新建

• 默认（--no-wait）：同 prompt 有 running → 自动续接；本地 completed → 重放落盘结果（replay_completed，不消耗新额度）；无记录 → 新建。
• 默认（阻塞 SSE，无 --no-wait）：同 prompt 有 running → 续接；本地 completed → 清除后提交新分析；无记录 → 新建。
• --new：用户明确要求并行新建；须先 check-conflict 询问用户。
• prompt 必须和首次提交时完全一致（trim + 折叠空白后哈希相同），否则可能命中退出码 76（相似 prompt 检测）。

防重复扣费：沙箱 kill 后 Agent 只应再发一条 --no-wait 续接。若本地已是 completed，CLI 会直接输出 DONE（重放），不会再调 message/stream。连发多条时，旧版会在第二条误触发新任务——现已修复。

11. 退出码 75（并发 / 额度上限，立即停止）

stdout 含 [严重] 服务端拒绝任务 / 达到最大同步执行任务数目，或退出码 = 75 时：

• 立即停止，告知用户「当前分析任务较多，请稍等 5-15 分钟后再试」；
• 禁止换 prompt、--new、改 -d 这些"绕过"动作——它们仍会占用并发槽；
• 把 stdout 里 [严重] 横幅的原文转述给用户。

任务幂等性与停止行为

CLI 跨进程在 ~/.wind-alice/tasks.json 按 taskId 记录任务，~/.wind-alice/results/.md 存每条任务的 agentResult.value 落盘副本。基于 prompt 的 promptHash（trim + 折叠空白后 SHA-256）做幂等。

• 默认调度（--no-wait）：同 prompt running → 续接；completed → 重放落盘（不新建）；无记录 → 新建。
• 默认调度（阻塞 SSE）：同 prompt running → 续接；completed → 新建；无记录 → 新建。
• --new：用户明确要求并行新建；须先 check-conflict 询问用户。
• 状态同步：收到 agentResult → completed；服务端提示 / jsonrpc 错误 / 流静默结束 → failed；Ctrl+C → 保持 running（服务端仍在跑，下次自动续接）。
• attach 失败自动回退：attach 模式下 60s 无 SSE / jsonrpc 错误 / 4xx → 自动删旧记录新建任务（单进程内最多 1 次）。
• 自动清理：running > 6h 强清；completed > 7d 清；failed > 3d 清；总条数 > 200 裁到 100。

配置位置与环境变量

兼容：历史无后缀的 ~/.wind-alice/config 仍可读取，apikey-set 会自动迁移到 config.env。

CLI 执行失败处理（核心红线）

CLI 失败时，立即停止；绝不用 WebSearch 或其它信息源拿"近似的市场规模测算与战略建模"敷衍用户。

• KEY_MISSING（仅当 exit=2 且 stderr 含 JSON "code":"KEY_MISSING" 时才成立）：按「环境要求」检查 Key 后重试。禁止在退出码不是 2、或 stderr 没有 KEY_MISSING 字段时，凭"进程被杀""输出不完整""apikey-get 返回 missing"等迹象猜测 Key 缺失——这些与 Key 无关（典型反例：exit=6 是 strict 兜底，Key 配得好好的）。若需核实 Key 状态，用 apikey-get 并读其 JSON 的 status 字段：configured = 正常，missing = 确实缺失；禁止把 configured 读成 missing 或凭空下结论。
• exit=75 / [严重] 服务端拒绝任务 / 达到最大同步执行任务数目：临时拒绝，等 5-15 分钟后用相同 prompt 重试；禁止换 prompt / --new，把 [严重] 原文转述给用户。
• 服务端用户提示（体验账户 / 数据受限）：原样转述，不要替换为外部信息源。
• macOS Gatekeeper / Windows SmartScreen / 企业安全软件拦截：按系统提示放行后重试。
• 网络 / 服务端 5xx：CLI 内置最多 10 次重连，耐心等。
• 仍失败：向用户展示完整错误，让用户处理；绝不回退到其它信息源伪造"看似合理"的市场规模测算与战略建模。

常见问题

Q1：提示「WIND_API_KEY 未配置」 / Key 失效怎么换？

A：从 万得 Alice → 设置 → 账户 复制（或点「重置」换新）Key，然后写入：Windows 用 powershell ... -File "scriptsamssm.ps1" apikey-set ；macOS/Linux 用 node scripts/cli.mjs apikey-set 。apikey-get 验证脱敏末四位；apikey-clear 清除。CLI 不读环境变量与 skill 目录内 config.json——只读 ~/.wind-alice/config.env。

Q2：能否同时分析多个公司？报告附件在哪？怎么改下载目录？

A：(a) 可以——把多家主体写进同一个 prompt（建议 ≤ 5 家）。(b) 完整报告附件会静默落到 ~/Downloads/（Windows %USERPROFILE%Downloads），供用户本地查阅；Agent 不要把附件正文展示给用户。(c) 用户对话中说"下载到 X" → Agent 加 -d "X"。向用户交付时只用 stdout 的 agentResult.value 原文（截断时读 reportFile= 兜底），禁止读 Downloads/ 附件展示。

Q3：PowerShell 报 && 不是有效语句分隔符 / 中文乱码？

A：(a) PowerShell 5.x 不支持 &&——Windows 只能用方案 A（amssm.ps1 绝对路径，见「调用红线」）。(b) 若 live 仍乱码，读 CLI 输出的 ALICE_SESSION_LOG= 路径（Get-Content -Encoding UTF8），或直接用 Cursor / VS Code 打开 .log / .md 文件。

Q4：用户 Ctrl+C 停掉后再发同样 prompt，会重