Wind Alice-事实核验

概述

通过 alice-fact-check 调用 Wind Alice Agent，对从外部渠道获取的金融信息进行逐点核验，生成结构化核查报告。

核心原则：基础设施交给脚本处理；Agent 只负责把用户想核验的内容拼成 --prompt 传入（可直接粘贴原文）。默认就执行 Fact Check 技能，无需也不要再指定其它 Skill。 任务完成后，只将 CLI stdout 中的 agentResult.value 原文原样交给用户；CLI 静默下载的附件（reportFullFile=）不要读给用户看。

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

调用后：若 stdout 含 ALICE_NEEDS_USER_INPUT=1，或 agentResult.value 是在向用户追问要核验的原文等必填项，必须把追问原文转给用户并停止；等用户回复后再用补全后的 prompt 发起下一次核验（通常须 --new）。禁止未经用户确认就假设内容完整并立刻第二次调用。

何时调用本技能

您好！我是金融事实核验助手，专门帮您验证从外部渠道看到的金融信息是否准确。

使用方式很简单——把您想核查的内容直接粘贴过来就行。比如从新闻、研报、其他 AI、朋友圈或社交媒体上看到的一段话，只要里面包含具体的数据、排名、公司事件等可验证的内容，我都可以帮您逐条核对。

适用场景

核心能力

1. 自动识别可验证数据点
   • 营收、利润、销量、市值、涨跌幅等定量指标
   • 行业排名、市场份额、估值倍数
   • 公司事件（并购、分红、产能、政策影响等）
2. 逐点交叉验证
   • 对照 Wind 金融终端及权威公开来源
   • 标注每条数据的验证结论：准确 / 有出入 / 查不到
3. 结构化核查报告
   • 清晰列出原文数据点与核实结果
   • 对有出入项说明差异原因或可能口径问题
   • 查不到项说明原因与建议

试试这样问

• 粘贴一段文字直接核验，例如："贵州茅台 2024 年营收突破 1500 亿元，同比增长 15.7%；比亚迪全年销量超 380 万辆，位列全球新能源车企第一。"
• "帮我核验这段话里的数据是否准确：[粘贴内容]"
• "Fact check this: Apple's FY2024 revenue exceeded $400 billion with 5% YoY growth."
• "核查一下这篇研报摘要里的关键数字"

输出形式

• Agent 向用户展示的内容：CLI stdout 中的 agentResult.value 正文（服务端流式返回）
• 自动生成的结构化内容包含：逐点核验结论（准确 / 有出入 / 查不到）及简要说明
• 部分场景下 CLI 会静默把完整报告附件下载到用户 Downloads/ 文件夹或 -d 指定目录（供用户本地查阅）；Agent 向用户展示时只用 agentResult.value，不要粘贴附件正文
• 数据受限时在对应条目明确标注

💡 使用提示

• 核查模式：粘贴含具体数据、排名或事件的段落，系统会逐条核对并出报告
• 查询模式：若只是查某个单点数据（如"茅台今天涨了多少"），上层 Agent 可直接回答，不必调用本技能
• 原文越完整、数据点越具体，核验结果越精准

触发场景与 prompt 构造

用户提问命中以下任一场景即可调用：核验外部金融信息 / fact check / 核查新闻研报数据 / 验证公司声明与行业事件。

把用户想核验的原文或问题拼成 --prompt（可直接粘贴段落）。不要加 使用「...」技能： 前缀，CLI 内部已自动注入。

CLI 参数

<SKILL_DIR> = 本文件所在目录绝对路径。Windows 一律用方案 A（PowerShell 5.x 不支持 &&，见 [AGENT.md](./AGENT.md)「命令模板」与「禁止写法（Windows）」）；macOS / Linux 用 node scripts/cli.mjs。

命令行调用

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" --prompt "<USER_QUESTION>" --no-wait [-d "<DIR>"] [--new]

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

参数

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

调用示例

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" -p "贵州茅台 2024 年营收突破 1500 亿元，同比增长 15.7%" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" -p "比亚迪全年销量超 380 万辆，位列全球新能源车企第一" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" -p "Apple FY2024 revenue exceeded $400 billion with 5% YoY growth" --no-wait -d "D:reportsfact-check"
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" -p "重新核验上述内容" --no-wait --new   # 仅用户说"重新跑"才加

# macOS / Linux
node scripts/cli.mjs -p "贵州茅台 2024 年营收突破 1500 亿元，同比增长 15.7%" --no-wait
node scripts/cli.mjs -p "比亚迪全年销量超 380 万辆，位列全球新能源车企第一" --no-wait
node scripts/cli.mjs -p "Apple FY2024 revenue exceeded $400 billion" --no-wait -d "/reports/fact-check"
node scripts/cli.mjs -p "重新核验上述内容" --no-wait --new

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

子命令

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

解析下载目录意图

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

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

环境与配置

1. Node.js 18+

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

2. 获取并配置 WIND_API_KEY

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

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

# Windows（方案 A）
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" apikey-set <KEY>
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" apikey-get
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafc.ps1" apikey-clear

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

CLI 把 Key 写到 ~/.wind-aifinmarket/config.env（Windows %USERPROFILE%.wind-aifinmarketconfig.env），dotenv 格式单行 WIND_API_KEY=...——这是唯一受支持的位置。历史路径仍可读取（同目录无后缀 config、旧目录 ~/.wind-alice/config.env 与 config），apikey-set 只写新路径。

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

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

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

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

配置位置与环境变量

兼容：历史路径仍可读取（同目录无后缀 config、旧目录 ~/.wind-alice/config.env 与 config），apikey-set 只写新路径。

中文乱码（Windows 必读）

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

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

1. scripts/afc.ps1：调用前切 UTF-8 代码页（Windows Agent 优先用它代替裸 node）。
2. ALICE_SESSION_LOG=：非 TTY 管道场景下，CLI 会把全部输出 tee 到 ~/.wind-aifinmarket/logs/<promptHash>.session.log（完整 64 位 promptHash，UTF-8 BOM）。只能读 stdout 打印的那条路径，禁止 view_folder logs/ 扫描：

   # ✅ 从本次 CLI stdout 复制 ALICE_SESSION_LOG= 的完整路径
   Get-Content -Path "$env:USERPROFILE.wind-aifinmarketlogs<promptHash>.session.log" -Encoding UTF8 -Tail 200 -Wait

   # ❌ 禁止：按 mtime 挑「最新」或只认 12 位前缀——不同 prompt（同公司）会落在不同文件

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

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

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

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

# ✅ 正确：显式指定 UTF-8
Get-Content -Path "$env:USERPROFILE.wind-aifinmarketlogs969e4c647aae.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。

执行契约（七步流程 / 红线 / 完成判定 / replay / 退出码 / 交付顺序 / 会话续接 / 命令模板 / 自检清单）见 [AGENT.md](./AGENT.md)——唯一权威来源，本文不重复。

排障与常见问题（任务幂等性与停止行为、CLI 执行失败处理、Q&A）见 [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)。