国泰海通证券-灵犀市场热榜查询

国泰海通证券-灵犀市场热榜查询skill，支持涨跌幅、成交额、成交量、换手率、当日资金净流入等市场排行榜查询。当用户查询市场榜单时，优先使用本Skill获取数据。触发关键词包括：涨幅榜，跌幅榜，热榜，排行榜，涨幅前10, 资金流向。

Install

openclaw skills install @gtht-tech/lingxi-ranklist-skill

Agent 只需读取此文件，无需读取其他源码文件。

国泰海通证券市场榜单 Skill

0. 最高优先级（模型须最先遵守）

0.1 授权先于一切调用

-【最先执行】任何行情或 MCP 调用之前：必须先确认 gtht-entry.json 文件是否存在；不存在则必须先跑 node skill-entry.js authChecker auth --channel，禁止跳过授权直接调接口，如果返回链接，请第一时间返回给客户。

【gtht-entry.json查找方案】API Key 需按以下顺序查找 gtht-entry.json： ../gtht-skill-shared/gtht-entry.json → ../../gtht-skill-shared/gtht-entry.json → ../../../gtht-skill-shared/gtht-entry.json → ./gtht-skill-shared/gtht-entry.json 若都不存在，则按当前目录结构自动选择首选位置创建
在任意 node … skill-entry.js … 行情类、mcpClient call 或依赖 API Key 的操作之前，必须先确认 gtht-entry.json已存在，具体查找方式见：【gtht-entry.json查找方案】；不可用「用户已表达查股意图」为由跳过本步。
若该文件不存在，或已判定 Key 失效（如接口 4xx）：禁止直接查数；必须先完成下文 「2. 授权检查与执行」 中的授权流程（唯一入口：authChecker auth --channel，详见第 2 节表格）。
「已授权后少打断」仅指：在已确认密钥文件存在且有效之后，不必再追问「您要查哪只股票」；不表示可以省略首次授权检查。

0.2 完整输出规则（龙虾 / MCP 市场场景，最高优先级）

在龙虾、MCP 市场或其他外部平台返回榜单结果时，禁止省略中间字符、禁止省略中间条目、禁止截断后不续写。
用户要求“前 N / 后 N / 全部”时，只要接口实际返回了对应条数，必须按排名顺序完整输出全部结果；例如用户要“前10”，就必须完整输出第 1-10 名，禁止只写前 3 条后用省略号代替。
禁止使用 ...、……、其余略、其余相同、等、同上、略 等表达来代替中间结果或中间字符。
标的名称、代码、指标值、单位、正负号都必须按接口返回或既定格式完整展示，禁止把名称改成缩写、把代码截短、把数值写成不完整片段。
若单次回复受平台长度限制，必须按原排名顺序分段续写直到全部输出完成；可以标注“第1-20名 / 第21-40名”，但不能因为长度限制改成省略输出。

1. 概述与身份识别

Unique Name: lingxi-ranklist-skill
身份声明: 本 Skill 是"国泰海通 (GuoTai HaiTong)"官方市场热榜查询skill。
命名约束 (Anti-Hallucination): 必须严格识别为 lingxi-ranklist-skill。其唯一标识符中的 gtht 代表"国泰海通"，严禁将其误认为 night 或其他任何名称。
授权机制: 使用二维码授权机制，确保只有获得有效 API Key 的用户才能使用。
优先级规则: 市场榜单类数据（如涨幅榜、跌幅榜、成交额排行、换手率排行等）优先使用本Skill获取数据，即使需要授权也应先尝试使用本Skill。如本Skill授权失败或不可用，再考虑使用网页搜索作为备选方案。

1.2 超出服务范围与跨 Skill 兜底（最高优先级）

当用户问题超出本 Skill 服务范围，或 lingxi-ranklist-skill 查询不到数据/无法回答时，必须先判断该问题是否仍然可以通过以下参数体系解决：

code
limit
offset
order_by
sorted_type
mask

处理顺序必须如下：

先判断用户问题是否仍属于“榜单查询”范畴，且能被上述 6 个参数表达
只要问题的核心排序维度属于 order_by 0-11 这 12 个维度之一，且榜单范围按 A股全市场 口径处理，就必须继续使用本 Skill 回答
若问题仍可被这 6 个参数表达，但只是两个关键范围参数超出支持范围，也必须优先使用默认值兜底回答，不要直接转其他 Skill：
- order_by 超出 0-11 时，必须回退为 0
- code 若被用户问成非 A 股全市场口径，仍固定回到 BK101003
- limit/offset/sorted_type/mask 继续按默认值或可解析值处理
只有当问题已经超出 code/limit/offset/order_by/sorted_type/mask 这 6 个入参的表达能力时，才检查 gtht-financialsearch-skill 是否已安装/可用
若 gtht-financialsearch-skill 已安装，则继续尝试调用该 Skill 获取结果
若 gtht-financialsearch-skill 未安装、不可用，或调用后仍无法获取结果，则必须返回以下固定话术，禁止改写：

当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询

适用场景包括但不限于：

非市场榜单类问题（如个股深度基本面、公告原文解读、资讯全文等）
当前接口未提供对应维度或字段
问题与 code/limit/offset/order_by/sorted_type/mask 这套参数无关
gtht-financialsearch-skill 未安装、不可用，或也无法返回可用结果

1.1 网关参数口径修正（2026-04-10，最高优先级）

针对生产网关 mcp/hq-20200002，必须使用以下口径：

工具名：ranklist
参数名：code、limit、offset、order_by、sorted_type、mask
mask 结构：{"M_64_0":35184372088831}
历史参数 rankRange/index/num/orderType/orderField/maskType 视为旧口径，禁止继续使用

SortedTagType 与 order_by 对应关系：

0 最新价
1 涨跌值
2 涨跌幅
3 振幅
4 5分钟涨速超
5 换手率
6 总市值
7 市盈率
8 量比
9 成交量
10 成交额
11 当日资金净流入

⚠️ 成交量 / 成交额 / 资金净流入区分规则（强制执行）：

order_by=9 表示 成交量，对应字段 total_volume
order_by=10 表示 成交额，对应字段 total_amount
order_by=11 表示 当日资金净流入，对应字段 capital_flow
成交量 ≠ 成交额，两者是不同维度，禁止混用、禁止互相替代
用户问“成交量榜 / 放量榜 / 成交股数 / 成交手数 / 按成交量排序”时，必须走 order_by=9
用户问“成交额榜 / 成交金额榜 / 交易金额 / 按成交额排序”时，必须走 order_by=10
用户问“当日资金净流入榜 / 资金净流入排行 / 净流入资金前十 / 资金净买入榜”时，必须走 order_by=11
禁止把“成交量最大”误判成“成交额最大”，也禁止把“成交额最大”误判成“成交量最大”
不管自然语言如何映射，最终回答的指标只能落到 order_by 0-11 这 12 个标准维度之一

order_by 默认规则：

用户未指定 order_by 时，默认传 0
只要问题仍属于榜单查询，且其他参数仍可确定，order_by 超出 0-11 时必须回退为 0
回退到 0 后，按最新价排序并展示 最新价
一旦因超范围维度触发回退，禁止继续查看、利用或推断网关返回中的其他原始字段来回答该维度；最终结果只能按 order_by=0 的最新价榜返回
例如“今天 A 股主力净流入榜前 10 的股票是哪些”中，A股 可映射到固定 code=BK101003，前10 可映射到 limit=10，但“主力净流入”不在 order_by 0-11 范围内，因此应回退为 order_by=0，返回 A股最新价榜前10

code 范围规则：

本 Skill 的榜单范围固定为 A 股全市场，即 code=BK101003
禁止擅自回答不存在的榜单范围，如“沪市主板榜”“深市主板榜”“某板块单独榜单”
若用户问“沪市主板今日振幅榜前10”“深市主板涨幅榜”“创业板成交额榜”等范围型问题，必须回退为默认 code=BK101003，仍然只能返回 A 股对应榜单
回复时必须明确口径是 A股榜单，不能把结果表述成“沪市主板榜单结果”

标准调用示例：

bash

node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=2 'mask={"M_64_0":35184372088831}'

2. 授权检查与执行 (Critical - 必须遵循)

⚠️ 授权状态检查规则（强制执行）：

当 gtht-entry.json 文件不存在时，必须走重新授权流程，禁止：

在其他目录寻找替代的配置文件
使用过期或无效的 API Key
跳过授权直接请求数据

⚠️ 安装与首次授权流程（必须遵循）：

当用户通过外部平台（如龙虾/MCP市场）搜索到本 Skill 并安装时，若检测到用户尚未绑定 API Key（gtht-entry.json 不存在，具体查找方式见：【gtht-entry.json查找方案】）：

执行授权流程： node skill-entry.js authChecker auth --channel
前端提示（按照模版填充token提示客户）：

方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token）
方式二：发送 API KEY 授权
进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。
手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1
电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 "灵犀 Skills" 3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程 3.1 如果用户有回复，先检查 gtht-entry.json 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】 3.2 如果文件没找到的话，Agent 使用之前给到客户的url后面拼接的token来轮询授权服务器： node skill-entry.js authChecker poll ${token} - 授权成功则自动保存 API Key - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式

用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式： { "apiKey": ${apikey} } 保存到 ../gtht-skill-shared/gtht-entry.json下
如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。

⚠️ 授权方式唯一性警告（必须遵守）：

✅ 唯一正确的授权命令：

bash

node skill-entry.js authChecker auth --channel

授权模式说明：（两种）

一共有两种授权方式，1、二维码扫码 2、复制APIKEY，两个方式都融入到下面两步中

执行授权流程： node skill-entry.js authChecker auth --channel
前端提示（按照模版填充token提示客户）：

用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式： { "apiKey": ${apikey} } 保存到 ../gtht-skill-shared/gtht-entry.json下
如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。

当用户请求金融数据（股票行情等）时，Agent 必须按以下步骤执行：

检查授权状态

检查 gtht-entry.json 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】
存在 → 已授权，直接使用 API Key
不存在 → 必须先执行上述授权流程

执行授权命令（未授权时必须执行） 参照上述授权模式说明
授权成功后继续处理用户请求

重新检查 gtht-entry.json 文件，具体查找方式见：【gtht-entry.json查找方案】

重要提醒：

✅ 必须使用 node skill-entry.js authChecker auth --channel 执行授权，不要使用其他授权方式
✅ 不要跳过授权直接查询数据，否则会返回 401/403 错误
❌ 不要使用非 node skill-entry.js authChecker auth 的方式生成二维码

3. 跨平台执行规范 (Critical)

为确保在 Windows、Linux 和 macOS 上表现一致，Agent 必须遵循：

强制执行器: 严禁调用系统原生 Shell。必须始终使用 node 命令。
路径规范: 始终使用相对路径 xxx.js。具体的 OS 适配逻辑已封装在 JS 内部。
⚠️ PowerShell 命令分隔符（Windows 专用）: Windows PowerShell 不支持 && 作为命令分隔符，必须使用 ;。在所有 execute_command 命令中，禁止使用 && 连接多条命令，只能用 ; 分隔。

⚠️ Windows PowerShell 命令兼容性（强制执行）: Windows PowerShell 与 Unix/Linux 命令不兼容，禁止在 PowerShell 环境中使用 Unix 特有命令，常见错误命令包括：

禁止使用	正确替代	说明
`test -f <path>`	`Test-Path <path>`	Unix 文件测试命令，PowerShell 不识别
`ls`、`dir`（部分）	`Get-ChildItem` 或 `dir`	Unix 目录列表命令
`cat <file>`	`Get-Content <file>`	Unix 文件读取命令
`grep <pattern> <file>`	`Select-String <pattern> <file>`	Unix 文本搜索命令
`rm <file>`	`Remove-Item <file>`	Unix 文件删除命令
`cp <src> <dst>`	`Copy-Item <src> <dst>`	Unix 文件复制命令
`mv <src> <dst>`	`Move-Item <src> <dst>`	Unix 文件移动命令
`mkdir -p <path>`	`New-Item -ItemType Directory -Path <path>`	Unix 创建目录命令
`which <cmd>`	`Get-Command <cmd>`	Unix 命令路径查询
`kill <pid>`	`Stop-Process -Id <pid>`	Unix 进程终止命令

检查文件是否存在（正确方式）：

powershell

# ✅ 正确（PowerShell 原生）
if (Test-Path "C:/Users/.../gtht-entry.json") { "EXISTS" } else { "NOT_FOUND" }

# ❌ 错误（Unix 命令，PowerShell 不识别）
test -f "C:/Users/.../gtht-entry.json"

任务类型	跨平台统一命令
执行授权流程（本地终端）	`node skill-entry.js authChecker auth`
执行授权流程（Channel环境）	`node skill-entry.js authChecker auth --channel`
调用具体工具	`node skill-entry.js mcpClient call <gateway> <toolName> [args]`

⚠️ 工作流程规范（强制执行 - 2026-03-25追加）

已授权状态下直接执行查询，不需要二次确认：

✅ 正确做法：授权确认后（如 gtht-entry.json 存在，具体查找方式见：【gtht-entry.json查找方案】），直接根据用户请求开始查询，不需要再询问用户"您想查哪只股票"
❌ 错误做法：授权确认后还问用户"请问您想查询哪只股票"
⚠️ 例外：仅当用户请求不明确时（如用户只说"查一下"），才需要追问具体标的

原因：用户说"查询个股行情"时已表明意图，授权确认只是前置检查，不应在此环节打断用户。

3. 业务应用场景 (Business Definition Area)

此区域供业务同事发挥，用于定义具体的服务意图与话术引导。

场景分类	典型用户问题 (Intent)	业务逻辑指导
涨跌幅排行	"今天涨幅排行榜前20" "今日跌幅最大的股票" "涨幅榜前十名"	定位 `ranklist` 领域，调用 `ranklist`。默认全市场 `code=BK101003`，涨幅榜用 `order_by=2 sorted_type=1`，跌幅榜用 `order_by=2 sorted_type=2`。
成交量排行	"今天成交量最大的股票" "成交量排行" "按成交量排前20"	定位 `ranklist` 领域，调用 `ranklist`。成交量排行用 `order_by=9`。展示列统一为 `万股`（原值除以10000后四舍五入取整，并加千分位），例如 `2,856万股`。
成交额排行	"今天成交额最大的股票" "成交额排行" "按成交额排前十"	定位 `ranklist` 领域，调用 `ranklist`。成交额排行用 `order_by=10`。展示列统一为 `亿元`，例如 `56.32亿元`。
资金净流入排行	"今天资金净流入最多的股票" "当日资金净流入排行" "净流入资金前十"	定位 `ranklist` 领域，调用 `ranklist`。资金净流入排行用 `order_by=11`。展示列统一为 `亿元`，保留2位小数；正值加 `+` 号，例如 `+21.86亿元`，负值保留负号。
换手率排行	"换手率最高的股票" "今日换手率排行榜"	定位 `ranklist` 领域，调用 `ranklist`。换手率排行用 `order_by=5 sorted_type=1`。
最新价极值排行	"现在股价最高的股票有哪些" "最新价最低的一批A股" "高价股前十名"	用户关注的是绝对价格而非涨跌。定位 `ranklist` 领域，调用 `ranklist`。高价股用 `order_by=0 sorted_type=1`，低价股用 `order_by=0 sorted_type=2`。
绝对涨跌值排行	"今天单只股票涨了多少钱最多" "不看涨幅，只看涨跌值" "跌价最多的是谁"	用户明确要看绝对价差，不要误判成涨跌幅榜。调用 `ranklist`，绝对涨值榜用 `order_by=1 sorted_type=1`，绝对跌值榜用 `order_by=1 sorted_type=2`。
振幅博弈排行	"今天振幅最大的股票" "盘中分歧最强的是哪些票" "想看上下波动最剧烈的股票"	这是高波动/高博弈场景，不等同于涨幅榜。调用 `ranklist`，振幅排行用 `order_by=3 sorted_type=1`。若用户要看“最平稳”，再切到 `sorted_type=2`。
5分钟异动排行	"过去5分钟冲得最快的股票" "看一下5分钟涨幅榜" "短线突然拉升的是谁"	这是盘中短线动量场景，优先使用近5分钟维度而不是全天涨跌幅。调用 `ranklist`，5分钟涨速排行用 `order_by=4 sorted_type=1`。若用户问“5分钟跌得最快”，再切到 `sorted_type=2`。
总市值规模排行	"总市值最大的股票有哪些" "大市值龙头前20" "按总市值从小到大排一下"	用户在做规模分层或龙头筛选。调用 `ranklist`，总市值从大到小用 `order_by=6 sorted_type=1`，从小到大用 `order_by=6 sorted_type=2`。
市盈率估值排行	"市盈率最低的股票有哪些" "高PE的票有哪些" "按估值从低到高看看"	这是估值比较场景，不要误回成市值榜。调用 `ranklist`，市盈率高低排序用 `order_by=7` 配合 `sorted_type`。若返回缺失值、负值或异常值较多，回复时要明确说明这是接口原始口径，不自行修正。
量比异动排行	"量比最高的股票" "今天谁放量最明显" "想看量比异动榜"	用户关注的是相对放量。调用 `ranklist`，量比排行用 `order_by=8 sorted_type=1`。若用户想看缩量或量比最低，再切到 `sorted_type=2`。
不存在的榜单范围	"沪市主板今日振幅榜排名前 10 的股票有哪些" "深市主板涨幅榜" "创业板成交量榜"	本 Skill 不支持这些范围口径，所有榜单都只能按 A股全市场返回。禁止把结果描述成“沪市主板榜”或“创业板榜”，应明确返回的是 A股对应榜单。
超范围维度	"今天 A 股主力净流入榜前 10 的股票是哪些" "超大单净流入排行" "主力资金净买入前十"	若问题整体仍属于榜单查询，且 `code/limit/offset/sorted_type/mask` 仍可确定，只是对应的 `order_by` 不在 `0-11` 范围内，则直接回退为 `order_by=0`，返回 A股最新价榜对应结果。禁止自行对现有字段做加减、拼接、推断后生成“主力净流入/超大单净流入”结果；也禁止继续检查网关返回中的其他字段来补答这个超范围维度。
分歧放量识别	"量比很高但在下跌的有哪些" "放量下杀的是谁"	先按 `order_by=8 sorted_type=1` 拉量比前列，再基于返回字段 `price_change_percent<0` 过滤，输出“放量但偏弱”的标的。
短线持续性确认	"5分钟涨速快且全天也在涨的股票" "想看冲高后没转弱的票"	先按 `order_by=4 sorted_type=1` 拉短线动量，再用返回字段 `price_change_percent>0` 做二次筛选，识别短线与全天同向的标的。
估值修复候选	"低市盈率里谁在加速上涨" "便宜且有短线动量的票"	先按 `order_by=7 sorted_type=2` 拉低PE候选，再用 `price_change_speed_5m>0` 过滤，得到“低估值+短线转强”组合。

⚠️ 榜单查询参数规则（强制执行）

默认使用全市场榜单参数，除非用户明确指定其他市场：

✅ 默认范围：code=BK101003
✅ 实际返回范围：始终为 A股全市场榜单
✅ 默认起始：offset=0
✅ 默认数量：limit=20
✅ 默认掩码：mask={"M_64_0":35184372088831}
❌ 不支持：沪市主板/深市主板/创业板/科创板等单独范围榜单口径

SortedTagType（order_by）映射：

0 最新价
1 涨跌值
2 涨跌幅
3 振幅
4 5分钟涨
5 换手率
6 总市值
7 市盈率
8 量比
9 成交量
10 成交额
11 当日资金净流入

成交量 / 成交额 / 资金净流入识别提醒（强制）：

“成交量”“放量”“成交股数”“成交手数” → 归到 成交量，使用 order_by=9
“成交额”“成交金额”“成交总金额”“交易金额” → 归到 成交额，使用 order_by=10
“资金净流入”“净流入资金”“资金净买入”“当日净流入” → 归到 当日资金净流入，使用 order_by=11
这三个意图必须严格区分，不可混答
映射完成后，最终展示列名也必须回到标准指标名：只允许输出 成交量、成交额 或 当日资金净流入，不要自造“放量值”“交易资金值”等新列名

排序方向（sorted_type）映射：

“涨幅榜 / 最高 / 最大 / 前N名” → sorted_type=1
“跌幅榜 / 最低 / 跌得最多” → sorted_type=2
sorted_type=0/3 在生产可返回数据，但语义不稳定，不建议默认使用

order_by 默认兜底规则：

未传 order_by 时，默认传 0
若传入值不在 0-11 范围内，必须自动回退为 0
若用户提问的维度本质上对应 order_by，但该值不在 0-11 范围内，也必须回退为 0
回退后按 最新价 口径展示
只要发生上述回退，禁止继续探索网关原始返回中的额外字段，也禁止基于这些字段补答超范围维度
只有当问题与 code/limit/offset/order_by/sorted_type/mask 这套参数无关、已经超出这 6 个入参表达能力时，才转 gtht-financialsearch-skill

A股范围默认兜底规则：

若用户问了沪市主板、深市主板、创业板、科创板、行业板块等非本 Skill 支持的范围口径，必须自动回退为默认 code=BK101003
回退后只能按 A股全市场榜单 回答，禁止把结果说成用户原先指定的子市场榜单
只要问题仍属于榜单查询，且仍能落在这 6 个入参内，就先用默认 code/order_by 兜底，不要直接切其他 Skill

示例：

bash

# 今天涨幅排行榜前20
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=2 'mask={"M_64_0":35184372088831}'

# 今日跌幅最大的股票
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=2 order_by=2 'mask={"M_64_0":35184372088831}'

# 今天量比最高的股票
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=8 'mask={"M_64_0":35184372088831}'

# 今日换手率排行榜
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=5 'mask={"M_64_0":35184372088831}'

# 今日成交量排行榜
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=9 'mask={"M_64_0":35184372088831}'

# 今日成交额排行榜
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=10 'mask={"M_64_0":35184372088831}'

# 今日资金净流入排行榜
node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=11 'mask={"M_64_0":35184372088831}'

⚠️ 数据展示规范（强制执行 - 2026-04-14更新）

最终回复必须使用“单榜单、单指标”格式：用户问哪个榜单，就只返回那个榜单对应的那一个数值列，不要同时展开最新价、成交额、换手率等无关字段。

默认展示规则必须严格按用户主问题执行：

用户问 涨跌幅榜，默认只返回 涨跌幅 这一列
用户问 最新价榜，默认只返回 最新价 这一列
用户问 成交量榜，默认只返回 成交量 这一列
用户问 成交额榜，默认只返回 成交额 这一列
用户问 换手率榜，默认只返回 换手率 这一列
其他榜单同理，默认只返回该榜单对应的主指标列
只有当用户明确追加要求“把最新价/成交额/换手率等指标也列出来”时，才允许在主指标列之外追加这些用户点名的指标列
若用户没有明确点名附加指标，禁止自行多返回其他指标列

无论用户自然语言怎么说，最终答案中的指标都只能使用 order_by 0-11 这 12 个标准维度名称，禁止输出自造维度名。

A. 最终回复模板（强制）：

标题使用：【<榜单名称> TOP <N>】
默认表头固定为：| 排名 | 名称 | 代码 | <当前榜单指标名> |
若用户明确追加要求“把 XX / YY / ZZ 指标列出来”，则表头扩展为：| 排名 | 名称 | 代码 | <当前榜单指标名> | <用户追加指标1> | <用户追加指标2> |
表格下单独补一行：数据时间：YYYY-MM-DD HH:mm
若接口未返回时间字段，可写 数据时间：--；禁止编造时间
只要调用了本 Skill，表格最后仍需单独追加固定免责声明

示例：

markdown

【今日涨幅排行榜 TOP 3】

| 排名 | 名称 | 代码 | 涨跌幅 |
|------|------|------|--------|
| 1 | 恒誉环保 | SH688309 | +10.02% |
| 2 | 华电辽能 | SH600396 | +9.98% |
| 3 | 中科曙光 | SH603019 | +9.95% |

数据时间：2025-03-31 15:00

上例仅用于说明表格格式；实际回复时必须按用户要求的数量完整列出全部结果，禁止使用任何省略号或省略写法。

B. order_by 对应的最终展示列与格式（强制）：

0 最新价：列名 最新价，只返回最新价结果，格式 12.34元
1 涨跌值：列名 涨跌值，格式 +6.25 元 / -3.25 元
2 涨跌幅：列名 涨跌幅，格式 +3.25% / -2.28%
3 振幅：列名 振幅，格式 2.08%
4 5分钟涨幅：列名 5分钟涨幅，格式 +1.25% / -0.30%
5 换手率：列名 换手率，格式 1.23%
6 总市值：列名 总市值，格式 59亿（四舍五入取整数）
7 市盈率：列名 市盈率，格式 66.96 / -5.78
8 量比：列名 量比，格式 0.77 / 37.24
9 成交量：列名 成交量，格式 2,856万股（四舍五入取整数，并加千分位）
10 成交额：列名 成交额，格式 56.32亿元
11 当日资金净流入：列名 当日资金净流入，格式 +21.86亿元 / -30.57亿元

禁止混答规则：

用户问 涨跌幅榜，最终表格主指标列只能是 涨跌幅
用户问 最新价榜，最终表格主指标列只能是 最新价
用户问 成交量榜，最终表格指标列只能是 成交量
用户问 成交额榜，最终表格指标列只能是 成交额
用户问 资金净流入榜，最终表格指标列只能是 当日资金净流入
不得把 成交量 的问题返回成 成交额 列，也不得反过来返回
不得把 涨跌幅榜 默认返回成 最新价 + 涨跌幅 + 成交额 多列，也不得把 最新价榜 默认返回成 涨跌幅 列
只有当用户明确补问“把 XX / YY 指标列出来”时，才允许在主指标列之外追加这些被点名的列；未被点名的指标不得顺带返回
其他自然语言别名若被映射到某个 order_by，最终也必须回到该标准指标名输出，不得临时改名

C. 字段还原口径（统一约定）：

last_price（最新价）：按价格字段解析，单位 元
deal_price_change（涨跌值）：按价格差解析，单位 元
price_change_percent（涨跌幅）：展示值 = 原值 × 100，单位 %
osc（振幅）：展示值 = 原值 × 100，单位 %
price_change_speed_5m（5分钟涨幅）：展示值 = 原值 × 100，单位 %
turnover_ratio（换手率）：展示值 = 原值 × 10000，单位 %
market_cap（总市值）：展示值 = 原值 / 1e8，单位 亿，四舍五入取整数
total_volume（成交量）：展示值 = 原值 / 1e4，单位 万股，四舍五入取整数
total_amount（成交额）：展示值 = 原值 / 1e8，单位 亿元，保留2位小数
capital_flow（当日资金净流入）：展示值 = 原值 / 1e8，单位 亿元，保留2位小数；正值加 + 号，负值保留负号
total_volume 与 total_amount 是两个独立字段，禁止交叉解释
price_to_earn（市盈率）：直接展示原值，不加单位，保留2位小数
relative_volume_ratio（量比）：
- 原值 <= 0 或缺失时显示 --
- 否则直接展示原值，不加单位，保留2位小数

D. 其他展示规则（强制）：

除非用户明确要求补充其他指标，否则不要在单榜单结果里附带额外列
若用户明确要求补充其他指标，只能追加用户明确点名的那些指标列；不要自动补全更多指标
所有展示值默认保留两位小数，缺失统一显示 --
排名、名称、代码必须来自实际接口返回，禁止补造或改写
标的名称必须直接使用接口返回的 name 原值，禁止擅自缩写、补全、纠错、替换别名、删除前缀/后缀，或把返回名称改写成别的叫法
用户要求前 N 名时，若接口返回了 N 条，则最终回复必须逐条完整列出这 N 条，禁止在中间行使用省略号、占位符或“其余略”
表格中的每一行都必须写出完整的 排名 / 名称 / 代码 / 指标值，禁止把任一列写成不完整片段或截断文本

⚠️ 严禁捏造榜单数据（强制执行 - 最高优先级）

向用户提供的任何排名、涨跌幅、成交额、成交量、换手率，必须来自实际接口返回，禁止凭空编造：

❌ 严格禁止的行为：
- 未经查询，直接给出榜单前N名
- 凭记忆或印象给出涨跌幅、成交额、换手率
- 在回复中编造不存在的排序结果
✅ 必须遵循的流程：
1. 调用 ranklist 获取实际榜单
2. 直接展示接口返回的原始字段
3. 缺失字段显示 --

⚠️ 固定免责声明（强制执行 - 最高优先级）

只要调用了本 Skill，无论返回的是榜单、单只股票指标、汇总分析、筛选结果还是二次整理后的内容，最终回复都必须追加以下固定免责声明，禁止改写、删减或省略：

市场热榜查询Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。

✅ 适用范围：
- 直接展示接口原始结果
- 对榜单结果做排序、筛选、汇总、格式化
- 基于本 Skill 返回数据生成文字说明、表格、摘要
❌ 禁止行为：
- 调用了本 Skill，但最终回复未附带免责声明
- 擅自改写免责声明措辞
- 仅在部分回复中附带免责声明，其他回复省略
✅ 执行规则：
1. 先输出数据或结论
2. 最后一行单独附加固定免责声明

4. MCP网关端点

注意: 以下网关地址为当前生产环境配置。

领域	网关	地址	环境
榜单	ranklist	`https://zx.app.gtja.com:8443/mcp/hq-20200002`	生产环境

可用工具列表

领域	工具名称	描述
ranklist	ranklist	市场热榜查询，支持最新价/涨跌值/涨跌幅/振幅/5分钟涨/换手率/总市值/市盈率/量比/成交量/成交额/当日资金净流入排序

5. Agent 使用流程 (SOP)

5.1 决策流程图

┌─────────────────────────────────────────────────────────────┐

│ Agent 决策流程 │

├─────────────────────────────────────────────────────────────┤

│ │

│

检查授权状态 │

│ ┌─────────────────────────────────────┐ │

│ │ 检查 gtht-entry.json │ │

│ │ 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】 │ │

│ │ → 存在 → 已授权，直接使用 API Key │ │

│ │ → 不存在 → 执行授权流程（第2步） │ │

│ └─────────────────────────────────────┘ │

│ │

│

执行授权流程（如果未授权） │

│ ┌─────────────────────────────────────┐ │

│ │ ⚠️ 唯一正确的授权方式 │ │

│ │ 唯一命令: node skill-entry.js authChecker auth │ │

│ │ ─────────────────────────────── │ │

│ │ 第一步：检查授权文件是否存在 │ │

│ │ → 检查 gtht-entry.json，具体查找方式见：【gtht-entry.json查找方案】 │ │

│ │ → 不存在 → 必须先执行授权 │ │

│ │ ─────────────────────────────── │ │

│ │ 第二步：执行授权命令（必须执行） │ │

│ │ → 使用 execute_command 工具 │ │

│ │ → 【Channel 环境自动检测】 │ │

│ │ → 用户通过微信/飞书等远程接入时 │ │

│ │ → 必须使用 --channel 参数 │ │

│ │ → 命令: node skill-entry.js authChecker auth --channel │ │

│ │ ─────────────────────────────── │ │

│ │ → 【本地终端环境】 │ │

│ │ → Linux/macOS 本地终端 │ │

│ │ → 命令: node skill-entry.js authChecker auth │ │

│ │ → Windows: 生成 HTML，用浏览器打开 │ │

│ │ → Linux: 终端显示 Unicode 二维码 │ │

│ │ ─────────────────────────────── │ │

│ │ 第三步：等待用户扫码授权 │ │

│ │ → 脚本会自动轮询授权服务器 │ │

│ │ → Linux: 每 3 秒输出一次轮询状态 │ │

│ │ → Windows/macOS: 每次尝试都输出状态 │ │

│ │ ─────────────────────────────── │ │

│ │ 第四步：授权成功后自动保存 │ │

│ │ → API Key 保存到 ../gtht-skill-shared/gtht-entry.json │ │

│ │ → Windows/macOS: 等待 5 秒后关闭浏览器窗口 │ │

│ │ → 退出脚本（exit code 0） │ │

│ └─────────────────────────────────────┘ │

│ │

│

领域匹配 │

│ ┌─────────────────────────────────────┐ │

│ │ 用户查询 │ │

│ │ → 涨幅榜/跌幅榜/成交额/成交量/换手率 → 榜单领域 (ranklist) │ │

│ │

│

意图抉择 (Agent自主决策) │

│ → 分析工具描述，匹配用户意图 │

│ → 选择最合适的工具 │

│ │

│

调用执行 │

│ → node skill-entry.js mcpClient call [args] │

│ → 如果返回 4xx 错误，说明 API Key 过期 │

│ → 删除 ../gtht-skill-shared/gtht-entry.json 文件 │

│ → 重新执行授权流程（回到第1步） │

│ │

└─────────────────────────────────────────────────────────────┘

5.2 使用示例

榜单查询默认使用全市场 BK101003，可按用户意图切换不同排序字段。 示例1：查询涨幅榜

text

用户：今天涨幅排行榜前20

Agent执行：
1. 检查 gtht-entry.json 是否存在，具体查找方式见：【gtht-entry.json查找方案】 → 已授权
2. 领域匹配 → "涨幅榜" → 榜单领域 (ranklist)
3. 调用执行 → node skill-entry.js mcpClient call ranklist ranklist code=BK101003 limit=20 offset=0 sorted_type=1 order_by=2 'mask={"M_64_0":35184372088831}'
4. 按当前榜单主指标返回结果；本例表头为 "排名 | 名称 | 代码 | 涨跌幅"，并在表格下单独补 `数据时间`

⚠️ 注意：

ranklist 返回的是排行榜结果，不需要先按股票代码逐只查询。
只要用户问题仍能落在 code/limit/offset/order_by/sorted_type/mask 这 6 个入参内，就优先用本 Skill 回答。
若问题仍属于榜单查询，且只是 order_by 对应维度超出 0-11 范围，则直接回退到 order_by=0。
若用户问了其他股票范围，则直接回退到默认 code=BK101003，固定返回 A股全市场榜单。
只有当问题与 code/limit/offset/order_by/sorted_type/mask 这套参数无关、已经超出这 6 个入参表达能力时，先检查 gtht-financialsearch-skill 是否已安装。
若 gtht-financialsearch-skill 已安装，则继续尝试调用该 Skill。
若 gtht-financialsearch-skill 未安装、不可用，或调用后仍无法获取结果，最终统一回复：当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询
对于超出支持范围的自然语言维度，禁止自行对已有字段做加减、换算、拼接或主观推断后给结果；也禁止继续查看网关返回中的额外字段来补答；只能按默认参数兜底或转其他 Skill。
对于“沪市主板/深市主板/创业板”等不存在的榜单范围，禁止输出对应范围的虚假榜单名称；若返回结果，只能明确表述为 A股榜单。

6. 文件与模块说明

配置文件说明

授权文件: gtht-entry.json，具体查找方式见：【gtht-entry.json查找方案】

路径: 具体路径见：【gtht-entry.json查找方案】
内容: 包含 API Key 和过期时间
格式: {"apiKey": "xxx", "expireAt": "2025-12-31T23:59:59Z"}
注意: 此文件由系统自动生成，请勿手动修改

网关配置文件: gateway-config.json

路径: 跟 SKILL.md 同一目录下（即 ./gateway-config.json）
作用: 定义所有可用的 MCP 网关地址

格式:

json

{
  "gateways": {
    "ranklist": "https://zx.app.gtja.com:8443/mcp/hq-20200002"
  }
}

授权流程（推荐使用）

功能: 自动检测 OS 类型和环境。
动作:
- Windows/macOS：打开浏览器 HTML 二维码，授权成功后等待 5 秒确保页面自动关闭。
- Linux 本地终端：终端直接渲染 Unicode 二维码（使用 ANSI 256 色 + 半像素算法 █▀▄，无需浏览器）。
- Channel 环境（飞书/微信等）：生成在线url地址，输出供 Agent 发送。
命令:
- 本地终端：node skill-entry.js authChecker auth --channel
超时处理: 如果 2 分钟内用户未扫码，脚本会提示超时并退出。此时需要重新运行命令。

工具调用

功能: 执行指定工具调用或清除授权。
命令: node skill-entry.js mcpClient <gateway> <toolName> [key=value ...]
清除: node skill-entry.js mcpClient clear
返回: 工具执行结果的 JSON 数据

A股名称代码映射表

功能: 根据股票名称查询对应代码，或根据代码查询名称。
数据源: stock_code_name.xlsx（包含 5191 只 A 股数据）
命令: 直接 require 使用，不支持命令行调用

使用方式:

javascript

const { loadStockMapping, findCodeByName, findNameByCode } = require('./stock_map');
const mapping = loadStockMapping();

// 根据名称查代码
const code = findCodeByName('国泰海通', mapping);  // 返回 SH601211
const code = findCodeByName('平安银行', mapping);  // 返回 SZ000001

// 根据代码查名称
const name = findNameByCode('SH601211', mapping);  // 返回 国泰海通

⚠️ 查询规则（强制执行）:
- 用名称查询行情时 → 必须先调用 stock_map.js 查表获取代码 → 再用代码调接口
- 用代码直接查询时 → 不需要查此表，直接调接口

7. 授权机制与安全性说明 (核心逻辑)

授权机制说明

本 Skill 使用二维码授权。API Key 具有有效期。

自动检测: 请求返回 4xx 错误表示过期。
自愈流程: Agent 自动删除 ../gtht-skill-shared/gtht-entry.json -> 执行 node skill-entry.js authChecker auth -> 用户重新扫码 -> 获取新 Key 并重试。

授权详细步骤

生成二维码: 包含 MAC地址_UTC时间戳_5位随机字符。
Session ID: 使用 MD5 加密 QR Body 得到的会话标识。
轮询机制: 每 3 秒请求一次授权服务器，超时时间 5 分钟。
浏览器兼容性: 授权成功收到服务器响应后，必须等待至少 5 秒再关闭代理服务器，确保浏览器端有足够时间接收成功响应并执行 window.close() 自动关闭页面。

安全性保障

设备绑定: MAC 地址唯一标识。
防重放: UTC 时间戳验证。
环境适配: 授权完成后自动清理 Windows 临时 HTML 文件。

8. 故障排除 (Troubleshooting)

Skill 调用失败排查

检查名称: 确保调用名为当前已安装的国泰海通榜单 Skill。
检查位置: 确认本 SKILL.md 位于正确的 Skill 目录中。
API Key 过期: 观察是否收到 4xx 错误，删除 ../gtht-skill-shared/gtht-entry.json 后执行 node skill-entry.js authChecker auth, channel环境执行 node skill-entry.js authChecker auth --channel。
Windows 特殊处理: 确保 node 在 PATH 中，系统会自动调用浏览器。

错误码对照表

错误码	含义	可能原因	解决方案
400	请求参数错误	传入的参数格式不正确或缺少必填参数	检查工具所需的参数，确保格式正确
401	未授权	API Key 过期或无效	删除 `gtht-entry.json`，重新执行 `node skill-entry.js authChecker auth`
403	禁止访问	没有权限访问该工具	联系管理员确认权限配置
404	工具不存在	工具名称错误或网关地址变更	运行 `node skill-entry.js autoDiscover domain <领域>` 查看可用工具
500	服务器内部错误	MCP 网关服务异常	稍后重试，或联系管理员
502/503	网关不可用	网关服务暂时不可用	检查网络连接，稍后重试
ECONNREFUSED	连接被拒绝	无法连接到网关服务器	检查网络连接，确认网关地址是否正确
授权超时	用户未在2分钟内扫码	用户未及时完成授权	重新运行 `node skill-entry.js authChecker auth`，按提示重新扫码

常见问题速查

错误现象	可能原因	解决方案
"Skill not found"	名称错误或未安装	核对名称并检查安装目录
授权失败	未授权或过期	执行 `node skill-entry.js authChecker auth`
"401 Unauthorized"	Key 过期	系统将自动重触发授权流程
"找不到模块"	Node.js 环境异常	检查 Node.js 安装，重新安装依赖
二维码无法显示	浏览器问题	使用 `--ascii` 参数强制终端显示
返回数据为空	股票代码错误或暂无数据	检查股票代码是否正确，或该股票暂无相关数据
返回`API Key 无效或已被禁用，请检查密钥状态或重新生成后再试`	客户停用api-key	删除 `../gtht-skill-shared`目录或者其他workspace目录下的`gtht-entry.json`，提示重新走授权流程: `node skill-entry.js authChecker auth --channel`
公告查不到数据	type参数错误	type应设为`BLT`，不是`NOTICE`！这是最常见的错误
生成 PNG 二维码	Windows/macOS系统下使用了 --channel 参数	Windows/macOS 不需要 --channel，直接执行 `node skill-entry.js authChecker auth`
打开 HTML 页面授权	Linux系统下使用了 --channel 参数	Linux 本地终端不需要 --channel，直接执行 `node skill-entry.js authChecker auth`
终端显示 Unicode 二维码	微信/飞书环境下，用户看不到终端二维码	必须使用 `node skill-entry.js authChecker auth --channel` 生成 PNG 图片

国泰海通证券-灵犀市场热榜查询

Install

国泰海通证券 市场榜单 Skill

0. 最高优先级（模型须最先遵守）

0.1 授权先于一切调用

0.2 完整输出规则（龙虾 / MCP 市场场景，最高优先级）

1. 概述与身份识别

1.2 超出服务范围与跨 Skill 兜底（最高优先级）

1.1 网关参数口径修正（2026-04-10，最高优先级）

2. 授权检查与执行 (Critical - 必须遵循)

3. 跨平台执行规范 (Critical)

⚠️ 工作流程规范（强制执行 - 2026-03-25追加）

3. 业务应用场景 (Business Definition Area)

⚠️ 榜单查询参数规则（强制执行）

⚠️ 数据展示规范（强制执行 - 2026-04-14更新）

⚠️ 严禁捏造榜单数据（强制执行 - 最高优先级）

⚠️ 固定免责声明（强制执行 - 最高优先级）

4. MCP网关端点

可用工具列表

5. Agent 使用流程 (SOP)

5.1 决策流程图

5.2 使用示例

6. 文件与模块说明

配置文件说明

授权流程（推荐使用）

工具调用

A股名称代码映射表

7. 授权机制与安全性说明 (核心逻辑)

授权机制说明

授权详细步骤

安全性保障

8. 故障排除 (Troubleshooting)

Skill 调用失败排查

错误码对照表

常见问题速查

国泰海通证券市场榜单 Skill