Finloop News Skill

指令

1. 必须直接使用 HTTP 请求调用接口：使用 fetch、axios、curl 或其他 HTTP 客户端直接调用接口，禁止创建任何封装函数或 JS 文件
2. 禁止创建封装函数：不要创建任何 .js、.ts 文件来封装接口调用，必须直接使用 HTTP 请求
3. 接口基础域名：
   • 资讯相关接口：https://ai-uat.finloopfintech.com
   • 股票行情接口：https://papi-uat.finloopg.com
4. 请求头：Content-Type: application/json
5. 响应格式：接口返回的数据结构为 { code: 200, data: {...} }，需要从响应中提取 data 字段
6. 错误处理：需要检查响应状态码和错误信息，进行适当的错误处理

接口列表

1. 市场时段资讯接口

接口信息：

• 接口地址：/flp-news-api/v1/news-agent/financeBreakfast
• 请求方法：POST
• 完整路径：https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast

参数：

• 此接口为 POST 请求，请求体参数根据实际业务需求确定

时间逻辑说明：

• 此接口会根据当前时间自动返回不同类型的内容：
  • 财经早餐：通常在早晨时段返回（tag: 1）
  • 港股午盘：通常在中午时段返回（tag: 3）
  • 港股收盘：通常在收盘时段返回（tag: 2，也称为"收盘汇"）
• 接口会根据服务器当前时间自动判断应该返回哪种类型的内容
• 无需在请求中指定时间或类型，接口会自动返回对应时段的内容

响应参数：

• title: 标题（string）- 根据时间返回"财经早餐"、"港股午盘"或"港股收盘"等
• keyword: 关键词（Array）- 例如：["加密货币", "产业趋势"]
• publish_time: 发布时间（string）
• summary: 摘要（string）
• newsCount: 过去一天资讯数量（number）
• sentiment: 市场情绪（string）- 枚举值
• title_original: 原始title（string）
• tag: 类型标识（int）
  • 1: 财经早餐
  • 2: 港股收盘（收盘汇）
  • 3: 港股午盘

使用说明：

• 此接口用于获取首页市场时段资讯（财经早餐、港股午盘或港股收盘）
• 接口会根据当前时间自动返回对应时段的内容，无需指定时间参数
• 返回数据包含关键词、摘要、市场情绪等综合信息

2. 资讯列表接口

接口信息：

• 接口地址：/flp-news-api/v1/news-agent/informationList
• 请求方法：POST
• 完整路径示例：https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/informationList

请求参数：

• 必填参数：
  • category: 新闻分类（string），可选值："discover", "subscribe", "ai", "rwa", "macro", "industry", "market", "company", "viewpoint", "fund", "bond", "bill", "stock"
  • page_size: 每页加载条数（number，注意：参数名使用下划线 page_size，不是驼峰 pageSize）
• 可选参数：
  • keyword: 关键词检索（string）
  • news_id: 分页游标，最后一条新闻的ID（用于分页加载）
  • user_id: 用户ID（string，订阅分类时必填）

请求说明：

• 基础调用：POST 请求，请求体包含 category 和 page_size
• 带分页：在请求体中添加 news_id 参数
• 带搜索关键词：在请求体中添加 keyword 参数

响应参数：

• information_list: 资讯列表数组（注意：字段名使用下划线）
• total: 总条数（number）- 例如：120
• hasMore: 是否存在更多新闻（Boolean）

informationList 子参数： 每个资讯对象包含：

• newId: 资讯ID（string）- 例如："AICL000001"
• tags: 资讯标签（Array）- 例如：["AI 热闻"]
• title: 资讯标题（string）
• summary: 资讯摘要（string）
• imgUrl: 资讯封面图（string）
• publishTime: 发布时间（string）
• wordCount: 正文字数（number）
• readTime: 预计阅读时间（分钟）（number）
• influence: 影响力（string）- 枚举值
• influenceScore: 影响力得分（string）- 枚举值
• marketTrends: 市场趋势列表（List）

marketTrends 子参数： 每个市场趋势对象包含：

• ticker: 挂钩标的（string）- 例如："AAPL"
• changeRate: 标的涨势（string）- 例如："-0.05"

使用说明：

• 此接口用于获取指定分类下的资讯列表数据
• 适用于信息流或列表页展示
• 支持关键词检索和分页加载
• 个性化分类需要传入 user_id 参数
• 注意：参数名使用下划线 page_size，不是驼峰 pageSize

3. AI热闻列表接口

接口信息：

• 接口地址：/flp-news-api/v1/news-agent/banner/list
• 请求方法：GET
• 完整路径示例：https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/banner/list
• 注意：此接口可能需要 Cookie 认证（sl-session）

参数：

• 此接口为 GET 请求，无需请求体参数

请求说明：

• 此接口为 GET 请求，无需请求体参数
• 需要在请求头中携带 Cookie 认证信息（如 sl-session）

返回数据：

• banner_list: AI热闻列表数组，每个热闻包含：
  • news_id: 新闻ID
  • xcf_id: XCF资讯ID
  • tag: 标签数组
  • title: 标题
  • summary: 摘要
  • img_url: 图片URL（可能为null）

4. AI热闻详情接口

接口信息：

• 接口地址：/flp-news-api/v1/news-agent/bannerDetail
• 请求方法：POST
• 完整路径示例：https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/bannerDetail

参数：

• 必填参数：
  • id: XCF资讯ID（来自AI热闻列表的 xcf_id 字段），类型为字符串

请求说明：

• POST 请求，请求体包含 id 字段（XCF资讯ID，来自AI热闻列表的 xcf_id 字段）
• 请求体格式：{ "id": "21640" }

返回数据：

• 返回 XcfDetail 类型的数据，包含AI热闻的详细信息

5. 股票行情接口

接口信息：

• 接口地址：/flp-mktdata-hub/v1/stock/quote
• 请求方法：POST
• 完整路径：https://papi-uat.finloopg.com/flp-mktdata-hub/v1/stock/quote

请求头：

• Content-Type: application/json（必填）

请求参数：

• 必填参数：
  • tickers: 股票代码列表（list，必填），每个元素按照"代码.市场"格式
  • 支持的市场代码：
    • 港股：.HK
    • 美股：.US
    • A股：.SZ（深交所）、.SH（上交所）、.BJ（北交所）
    • 指数：支持部分指数行情（见下方支持的指数列表）

支持的指数代码：

请求说明：

• POST 请求，请求体包含 tickers 字段
• 请求体格式：{ "tickers": ["HSI.HK"] }
• 支持同时查询多只股票/指数，例如：{ "tickers": ["HSI.HK", "BABA.US", "AAPL.US"] }

响应参数：

• result: 行情数据列表（Array），每个元素包含以下字段：

使用说明：

• 此接口用于查询股票或指数的实时行情数据
• 支持查询单只股票/指数，也支持批量查询多只股票/指数
• 输出时必须包含所有返回的字段信息
• 如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式），无法提供全面的转换规则或枚举

AI热闻查询自动化流程（内置操作）

重要：当需要查询AI热闻详情时，必须使用此自动化流程。

自动化流程说明

当调用AI热闻查询时，系统会自动执行以下步骤：

1. 自动查询AI热闻列表

   • 调用 GET /flp-news-api/v1/news-agent/banner/list 获取所有AI热闻

2. 自动提取所有xcf_id

   • 从返回的 banner_list 中提取所有的 xcf_id
   • 通常返回3个AI热闻，每个热闻都有一个 xcf_id

3. 自动批量查询详情

   • 使用提取的所有 xcf_id，分别调用 POST /flp-news-api/v1/news-agent/bannerDetail 接口
   • 获取每个AI热闻的完整详情信息

执行步骤说明

1. 步骤1：获取AI热闻列表

   • 调用 GET /flp-news-api/v1/news-agent/banner/list 接口
   • 从响应的 data.banner_list 中获取所有AI热闻

2. 步骤2：提取所有xcf_id

   • 遍历 banner_list，提取每个AI热闻的 xcf_id 字段
   • 过滤掉为 null 或 undefined 的 xcf_id

3. 步骤3：批量查询详情

   • 对每个 xcf_id，直接使用 HTTP POST 请求调用 /flp-news-api/v1/news-agent/bannerDetail 接口
   • 请求体格式：{ "id": "xcf_id值" }
   • 建议使用并行请求（如 Promise.all）提高效率
   • 如果某个详情查询失败，记录错误但继续处理其他AI热闻
   • 注意：必须直接使用 HTTP 请求，不要创建封装函数

执行规则

必须遵循以下规则：

1. 查询AI热闻详情时，必须先查询AI热闻列表
2. 必须提取列表中的所有 xcf_id（不能只查询部分）
3. 必须使用所有提取的 xcf_id 分别调用详情接口
4. 如果某个详情查询失败，应该记录错误但继续处理其他AI热闻
5. 建议使用 Promise.all() 并行查询以提高效率

场景预设

场景1：用户询问"给我十条资讯"或"给我十条XX方面的资讯"

触发条件： 当用户询问"给我十条资讯"、"给我十条新闻"、"给我十条XX方面的资讯"等类似问题时，必须执行以下流程。

分类映射规则：

• 如果用户未指定分类或只问"给我十条资讯"，使用 category: 'discover'（发现分类）
• 如果用户明确指定分类，按以下映射：
  • "AI方面的资讯"、"AI资讯"、"人工智能资讯" → category: 'ai'
  • "RWA方面的资讯"、"RWA资讯" → category: 'rwa'
  • "宏观方面的资讯"、"宏观资讯" → category: 'macro'
  • "行业方面的资讯"、"行业资讯" → category: 'industry'
  • "市场方面的资讯"、"市场资讯" → category: 'market'
  • "公司方面的资讯"、"公司资讯" → category: 'company'
  • "观点方面的资讯"、"观点资讯" → category: 'viewpoint'
  • "基金方面的资讯"、"基金资讯" → category: 'fund'
  • "债券方面的资讯"、"债券资讯" → category: 'bond'
  • "票据方面的资讯"、"票据资讯" → category: 'bill'
  • "股票方面的资讯"、"股票资讯" → category: 'stock'

执行流程：

1. 确定分类

   • 根据用户询问内容，确定对应的 category 参数
   • 如果未指定分类，默认使用 'discover'

2. 查询资讯列表

   • 调用 POST /flp-news-api/v1/news-agent/informationList 接口
   • 请求体参数：category 为确定的分类，page_size: 10
   • 返回10条对应分类的资讯

重要提示：

• ✅ 当用户询问"给我十条资讯"时，默认查询 discover 分类
• ✅ 当用户询问"给我十条XX方面的资讯"时，根据XX映射到对应的分类
• ✅ 必须使用资讯列表接口 /flp-news-api/v1/news-agent/informationList，不是AI热闻接口
• ✅ page_size 参数名使用下划线，不是驼峰命名
• ❌ 不要使用AI热闻相关接口，这是资讯列表查询场景

场景2：用户询问"今日的AI热闻"

触发条件： 当用户询问"今日的AI热闻"或类似问题时（如"今天的AI热点"、"AI热门新闻"等），必须执行以下流程。

执行流程：

1. 查询AI热闻列表

   • 调用 GET /flp-news-api/v1/news-agent/banner/list 获取所有AI热闻
   • AI热闻列表通常包含今日最热门的AI相关资讯

2. 查询AI热闻详情

   • 从AI热闻列表中提取所有 xcf_id
   • 使用所有 xcf_id 分别调用 POST /flp-news-api/v1/news-agent/bannerDetail 获取每个AI热闻的完整详情
   • 请求体格式：{ "id": "xcf_id值" }
   • 必须查询所有AI热闻的详情，不能只查询部分

重要提示：

• ✅ 当用户询问"今日的AI热闻"时，必须执行完整的AI热闻查询流程
• ✅ 必须先查询AI热闻列表，再查询详情
• ✅ 必须查询所有AI热闻的详情，不能遗漏
• ❌ 不能直接查询资讯列表接口，必须使用AI热闻相关接口

场景3：用户询问"财经早餐"、"港股午盘"、"港股收盘"

触发条件： 当用户询问"财经早餐"、"港股午盘"、"港股收盘"、"今天的财经早餐"、"今日财经早餐"、"收盘汇"等类似问题时。

执行流程：

1. 调用市场时段资讯接口
   • 调用 POST /flp-news-api/v1/news-agent/financeBreakfast 接口
   • 请求体参数根据实际业务需求确定
   • 接口会根据服务器当前时间自动判断返回财经早餐、港股午盘或港股收盘
   • 返回数据包含标题、关键词、摘要、市场情绪等信息

重要提示：

• ✅ 无论用户问"财经早餐"、"港股午盘"还是"港股收盘"，都调用同一个接口
• ✅ 接口会根据当前时间自动返回对应类型的内容，无需在请求中指定时间或类型
• ✅ 返回的 tag 字段标识内容类型（1:财经早餐，2:港股收盘，3:港股午盘），title 字段显示具体标题
• ✅ 返回数据包含关键词、摘要、市场情绪等综合信息

场景4：用户询问"搜索XXX的资讯"、"查找XXX相关资讯"

触发条件： 当用户询问"搜索XXX的资讯"、"查找XXX相关资讯"、"搜索XXX"、"查找XXX"、"XXX相关的资讯"、"关于XXX的资讯"、"XXX的新闻"等类似问题时。

执行流程：

1. 提取搜索关键词

   • 从用户询问中提取搜索关键词（如"股票"、"AI"、"市场"等）
   • 关键词作为 keyword 参数

2. 确定分类（可选）

   • 如果用户同时指定了分类（如"搜索AI相关的股票资讯"），使用对应的 category 参数
   • 如果用户未指定分类，可以不传 category 参数，或使用 category: 'discover'

3. 调用资讯列表接口

   • 调用 POST /flp-news-api/v1/news-agent/informationList 接口
   • 请求体参数：
     • keyword: 搜索关键词（必填）
     • category: 分类（可选，如果用户指定了分类）
     • page_size: 每页数量（可选，默认10）

重要提示：

• ✅ 必须提取用户询问中的关键词作为 keyword 参数
• ✅ 如果用户同时指定了分类，需要同时传入 category 和 keyword 参数
• ✅ 搜索功能支持跨分类搜索，如果不指定分类，会在所有分类中搜索
• ✅ 必须使用资讯列表接口，参数名使用下划线 page_size

场景5：用户询问某只股票的行情

触发条件： 当用户询问以下任何问题时，必须调用股票行情接口：

• "HSI.HK的行情"
• "恒生指数的行情"
• "BABA.US的股价"
• "苹果股票的行情"
• "AAPL的行情"
• "道琼斯指数的行情"
• "上证指数的行情"
• 其他类似的股票行情查询问题

执行流程：

1. 提取股票代码

   • 从用户询问中提取股票代码或股票名称
   • 如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式）
   • 无法提供全面的转换规则或枚举，需要 skill 根据实际情况进行转换
   • 将股票代码转换为"代码.市场"格式

2. 调用股票行情接口

   • 调用 POST /flp-mktdata-hub/v1/stock/quote 接口
   • 请求头：
     • Content-Type: application/json
   • 请求体参数：
     • tickers: 股票代码列表（list，必填），例如：["HSI.HK"] 或 ["BABA.US", "AAPL.US"]

3. 输出响应数据

   • 从响应的 result 字段获取行情数据列表
   • 必须输出所有字段信息，包括行情时间、价格、涨跌幅、成交量等完整数据

重要提示：

• ✅ 必须从用户询问中提取股票代码，并转换为"代码.市场"格式
• ✅ 如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式）
• ✅ 无法提供全面的转换规则或枚举，需要 skill 根据实际情况进行转换
• ✅ 输出时必须包含所有返回的字段信息
• ✅ 支持同时查询多只股票/指数，在 tickers 数组中添加多个代码即可

通用注意事项

1. 必须直接使用 HTTP 请求：

   • ✅ 直接使用 fetch、axios、curl 或其他 HTTP 客户端调用接口
   • ❌ 禁止创建任何封装函数或 JS/TS 文件
   • ❌ 禁止创建 api/news.ts、utils/api.js 等封装文件
   • ❌ 禁止使用 import 或 require 引入封装函数
   • 所有接口调用必须在调用处直接使用 HTTP 请求

2. 参数命名规范：注意接口参数命名可能使用驼峰命名（如 pageSize）或下划线命名（如 page_size），请根据实际接口文档确定。资讯列表接口使用下划线 page_size

3. 错误处理：检查 HTTP 状态码和响应体中的错误信息，进行适当的错误处理

4. 认证信息：部分接口（如AI热闻列表）可能需要 Cookie 认证，确保在请求时携带 sl-session Cookie

5. 接口路径：使用完整的接口路径，包括基础域名和接口路径

   • 资讯相关接口：https://ai-uat.finloopfintech.com
   • 股票行情接口：https://papi-uat.finloopg.com

6. 响应处理：接口返回格式为 { code: 200, data: {...} }，需要检查 code 字段判断请求是否成功，并从 data 字段获取实际数据

7. AI热闻查询自动化：查询AI热闻详情时必须使用自动化流程，先查列表再查详情

8. 市场时段资讯接口时间逻辑：接口会根据当前时间自动返回财经早餐、港股午盘或港股收盘，无需指定时间参数

9. 股票行情查询：查询股票行情时必须包含所有返回的字段信息，如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式）

10. 调用示例：

    • ✅ 正确：直接使用 fetch('https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({}) })
    • ✅ 正确：直接使用 curl -X POST --location 'https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast' --header 'Content-Type: application/json' --data '{}'
    • ❌ 错误：创建 api/news.ts 文件并封装函数
    • ❌ 错误：使用 import { getFinanceBreakfast } from '@/api/news'

相关文档

• 详细接口文档：references/REFERENCE.md - 包含完整的参数说明、响应结构和使用场景
• 技能清单：SKILL.md - 包含场景预设和重要规则