Wind Alice-基金对比分析

概述

通过 alice-fund-compare 调用 Wind Alice Agent，针对多只公募基金（2–5 只）一键生成结构化对比分析报告。

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

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

何时调用本技能

专业的基金对比分析能力，基于 Wind 金融终端数据，对多只基金（股票型、债券型、混合型、指数型、货币型等公募基金）覆盖业绩表现、风险指标、持仓结构、管理评估四大维度，进行全方位、多维度的深度对比，为基金研究、投资决策与组合管理提供定量依据。支持客观中立分析和主观倾向性分析两种模式。

适用场景

核心能力

1. 业绩表现对比
   • 近期 / 中长期净值增长率（近 1 月 / 3 月 / 6 月 / 1 年 / 3 年 / 成立以来）
   • 同类排名与分位数对比
   • 超额收益与基准跟踪误差（指数型）
   • 业绩一致性 / 稳定性评估
2. 风险指标对比
   • 年化波动率、最大回撤、回撤修复时间
   • 夏普比率、卡玛比率、索提诺比率
   • 下行风险、在险价值（VaR）
   • 风险调整后收益对比
3. 持仓结构对比
   • 资产配置（股票 / 债券 / 现金 / 其它占比）
   • 重仓股 / 重仓债集中度与重合度
   • 行业分布、市值风格、久期 / 信用等级（债券基金）
   • 换手率与持仓稳定性
4. 管理评估对比
   • 基金经理任职年限、管理规模、历史业绩
   • 基金公司实力与同类型产品线
   • 管理费率、托管费率、综合费率（含销售服务费）
   • 份额规模与流动性

试试这样问

• "帮我对比一下华夏成长和易方达中小盘"
• "易方达蓝筹精选和兴全合润哪个更好？"
• "对比这几只基金：000001.OF, 110011.OF, 163406.OF"
• "华夏成长相比易方达中小盘有什么优势？"
• "分析一下这两只债券基金的差异"
• "我该不该用基金 A 替换基金 B？"

输出形式

• Agent 向用户展示的内容：CLI stdout 中的 agentResult.value 正文（服务端流式返回）
• 自动生成的结构化内容包含：核心结论、各基金优势、主要风险、投资 / 配置建议
• 多维度对比：业绩表现、风险指标、持仓结构、管理评估的对比表和专业分析
• 部分场景下 CLI 会静默把完整报告附件下载到用户 Downloads/ 文件夹或 -d 指定目录（供用户本地查阅）；Agent 向用户展示时只用 agentResult.value，不要粘贴附件正文
• 数据受限时在对应模块明确标注

💡 使用提示

• 支持 2–5 只基金同时对比，建议不超过 3 只以便深入分析。
• 可以使用基金名称或代码（如 000001.OF）。
• 明确说明"详细分析"可获得更深入的报告。
• 系统会自动识别您的倾向性（如"A 比 B 好在哪"会重点分析 A 的优势）。

触发场景与 prompt 构造

用户提问命中以下任一场景即可调用：对比多只基金 / 基金优劣比较 / 基金替换评估 / 同类基金筛选 / 基金尽职调查。

把对比对象（基金名称 / 代码，如 000001.OF）和关注维度拼成一句自然语言。不要加 使用「...」技能： 前缀，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>scriptsafcmp.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>scriptsafcmp.ps1" -p "帮我对比一下华夏成长和易方达中小盘" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafcmp.ps1" -p "易方达蓝筹精选和兴全合润哪个更好？重点看风险和持仓" --no-wait
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafcmp.ps1" -p "对比 000001.OF 和 110011.OF" --no-wait -d "D:reportsfund"
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafcmp.ps1" -p "重新对比华夏成长和易方达中小盘" --no-wait --new   # 仅用户说"重新跑"才加

# macOS / Linux
node scripts/cli.mjs -p "帮我对比一下华夏成长和易方达中小盘" --no-wait
node scripts/cli.mjs -p "易方达蓝筹精选和兴全合润哪个更好？重点看风险和持仓" --no-wait
node scripts/cli.mjs -p "对比 000001.OF 和 110011.OF" --no-wait -d "/reports/fund"
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>scriptsafcmp.ps1" apikey-set <KEY>
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafcmp.ps1" apikey-get
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>scriptsafcmp.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/afcmp.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)。