基金知识查询服务

解决什么问题

在基金相关的开发场景里，第一步往往不是写业务逻辑，而是找数据：一只基金的历史业绩说明、基金知识的口径定义，或者股票代码对应的公司信息。自己对接财经数据源意味着维护鉴权、字段映射和分页逻辑，成本高且容易出错。这个技能把基金知识库的查询能力封装成 MCP 工具，让模型可以直接按意图调用，省去手写数据获取管道的工作。

工作原理

它采用「模型做路由、代码做调用」的分工：

• 密钥检查：调用任何工具前先确认 scripts.config.settings.api_key 是否为空；若为空，必须通过 AskUserQuestion 向用户索要 API 密钥，再用 scripts.config.set_api_key(key) 保存，密钥需自行申请获取。
• 意图路由：模型根据用户意图从工具表中选择函数，例如用户想查基金知识就选知识库查询函数。
• 参数提取：从用户输入中抽取函数所需参数；参数不全时继续向用户追问，而不是猜测。
• 调用与返回：统一使用关键字参数调用 scripts.tools 下的函数，工具返回包含 raw、success、message 三个字段的字典，raw 是 API 原始 JSON，整理后直接展示给用户。

提供的工具

• scripts.tools.fund.echo：回显输入文本，典型的脚手架验证接口。
• scripts.tools.fund.knoewledge：查询基金知识库列表，支持 kw 关键词模糊查询，以及 pageSize、pageNum 分页参数。
• scripts.tools.fund.stock_search：基于东方财富 API 的股票信息搜索，input 可传股票代码、名称或拼音简称，count 控制返回条数，上限 50。

适用边界

它不是投资建议系统，只负责把知识库和搜索结果原样带回来。最硬性的约束是 API 密钥：缺少密钥时禁止自行搜索或编造数据，必须先向用户询问。知识库内容以服务方返回为准，股票搜索依赖东方财富 API，其覆盖面和时效由数据源决定。