场外基金对比

功能范围

支持的对比维度

脚本自动获取以下所有维度的数据：

:|------|------|

> 重要说明：

> - 脚本只负责取数：脚本根据用户提供的基金代码，自动获取上述所有维度的数据

> - 智能体负责分析：取数完成后，智能体需要读取Excel数据，分析并输出专业的对比分析结论

> - 默认输出全部维度：当用户未明确指定对比维度时，严格按上述模块和说明输出所有维度的对比分析

支持对比的基金

• 数量限制：2-4 只基金
• 基金类型：支持股票型、混合型、债券型、货币型等（不支持新基金）

环境要求

• Python 3.13 及以上版本

前置准备

获取API Key

该技能依赖国信证券小信智慧助手的数据服务，需要先配置API Key。

配置步骤：

1. 访问 https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills 注册/登录账号
2. 登录后获取您的API Key。登录位置：网页一级标题栏-登录。登录后，点击账号，在弹窗上可一键复制API Key。
3. 在技能凭证配置中填入API Key

API Key持久化存储（重要）

当用户提供API Key并完成凭证配置后，智能体必须执行以下操作：

1. 立即写入memory.md：
• 创建或更新 ./memory.md 文件
• 添加以下内容：

```markdown

## 国信证券ETF筛选服务配置

• API Key: [用户提供的API Key]
• 环境变量名: COZE_GUOSEN_API_KEY_7627085587157205043
• 配置时间: [当前时间]

```

1. 后续调用脚本时设置环境变量：
• 从memory.md读取API Key
• 在调用脚本前设置环境变量：

```python

import os

api_key = 从memory.md读取的API Key

os.environ["COZE_GUOSEN_API_KEY_7627085587157205043"] = api_key

```

• 然后调用脚本执行ETF筛选

1. 确认存储成功：告知用户API Key已保存，后续使用无需重复配置

注意事项：

• memory.md用于智能体长期记忆，确保API Key在会话间保持有效
• 环境变量 COZE_GUOSEN_API_KEY_7627085587157205043 是脚本读取API Key的唯一途径
• 每次调用脚本前必须设置该环境变量，否则脚本将无法获取API Key
• 如用户更换API Key，需同步更新memory.md中的配置

安装依赖

依赖已在SKILL.md前言区定义，系统会自动安装。

智能体调用脚本流程

智能体在调用脚本执行ETF筛选时，必须遵循以下流程：

1. 检查并读取memory.md：
• 检查 ./memory.md 文件是否存在
• 读取其中的API Key和环境变量名

1. 设置环境变量：

```python

import os

# 从memory.md读取API Key

api_key = "从memory.md读取的API Key"

# 设置环境变量

os.environ["COZE_GUOSEN_API_KEY_7627085587157205043"] = api_key

```

1. 调用脚本执行筛选：

```bash

python /workspace/projects/gs-fund-compare/scripts/get_data.py [参数]

```

1. 读取结果并展示：
• 读取脚本输出的txt或xlsx文件
• 格式化展示基金对比数据

注意事项：

• 每次调用脚本前都必须设置环境变量
• 如果memory.md中不存在API Key，需要提示用户先配置
• 环境变量名必须是 COZE_GUOSEN_API_KEY_7627085587157205043，不能更改

输出说明

脚本会在 /workspace/projects/gs-fund-compare/scripts/output/ 目录下生成中间结果文件（xlsx、txt），这些文件仅用于数据存储，不应向用户展示文件路径或文件内容。

智能体输出要求

智能体在脚本执行完成后，必须：

1. 读取脚本输出的txt或xlsx文件，解析其中的数据
2. 不得向用户展示文件路径、文件名等中间文件信息
3. 当用户未明确指定对比维度时,输出所有支持的对比维度

使用示例

示例1: 对比3只基金

python scripts/get_data.py --funds "021457,016670,020602"

执行方式: 调用脚本获取数据 → 智能体分析Excel数据 → 输出对比报告

示例2: 对比2只基金并指定输出目录

python scripts/get_data.py --funds "000001,161039" --output ./output

执行方式: 脚本生成对比数据 → 智能体读取并分析 → 提供投资建议

补充说明

• 本技能面向基金对比分析，不提供投资建议
• 语句中应包含明确的基金代码
• 支持中英文基金代码输入
• 脚本取数完成后，智能体应分析Excel数据并输出完整的对比分析报告
• 智能体在首次配置API Key后，必须将API Key写入memory.md进行持久化存储
• 后续使用时，智能体应从memory.md读取API Key，无需用户重复提供

必须输出的声明内容

每次调用本SKILL后，智能体必须在输出末尾附上以下重要声明和风险提示：

> 重要声明:基金信息、数据来源于基金公司公告、WIND、恒生聚源等合法公开的信息渠道，国信证券对这些信息的准确性以及完整性不做任何保证。如有错漏，请以中国证监会指定披露上市公司信息报刊或网站为准。基金的过往业绩并不预示其未来表现，基金管理人管理的其他基金的业绩并不构成基金业绩表现的保证。基金详情页中所表达的观点不构成所涉证券买卖的具体建议，投资者依据上述信息进行投资决策所产生的收益和损失，与国信证券无关，国信证券不承担任何法律责任。未经国信证券同意，任何机构和个人不得对页面内容进行任何形式的发布、复制、引用或转载

> 风险提示:投资有风险，以上内容仅供参考，不作为具体推荐，投资者应自主做出投资决策并自行承担投资风险。