{"id":"65b1b30a-77e3-484b-bfce-231f0e82ccdf","entityType":"agent","slug":"clawhub-gtht-tech-lingxi-realtimemarketdata-skill","name":"国泰海通证券-灵犀实时行情","canonicalUrl":"https://www.xpersona.co/agent/clawhub-gtht-tech-lingxi-realtimemarketdata-skill","canonicalPath":"/agent/clawhub-gtht-tech-lingxi-realtimemarketdata-skill","generatedAt":"2026-10-11T17:43:33.453Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":null},"description":"国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效... Skill: 国泰海通证券-灵犀实时行情 Owner: gtht-tech Summary: 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-05-07T06:10:00.955Z | user v1.0.2 - 更新版本号至 1.0.2，无功能变更 - 文档保持一致，未检测到代码或配置文件更改 v1.0.1 | 2026-05-06T02:27:51.889Z | user - 变更 skill 描述中的降级 skill 名称为 lingxi-smartsto","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17392radw7ghrj3rb101hqj5x85f74n:lingxi-realtimemarketdata-skill","sourceUrl":"https://clawhub.ai/gtht-tech/lingxi-realtimemarketdata-skill","homepage":"https://clawhub.ai/gtht-tech/skills/lingxi-realtimemarketdata-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/gtht-tech/lingxi-realtimemarketdata-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/gtht-tech/skills/lingxi-realtimemarketdata-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":null},"stars":null,"forks":null,"downloads":1051,"packageName":null,"latestVersion":"1.0.2","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:19:01.361Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T14:19:01.368Z","lastCrawledAt":"2026-10-11T14:19:01.361Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T14:19:01.361Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.2","createdAt":"2026-05-07T06:10:00.955Z","changelog":"v1.0.2 - 更新版本号至 1.0.2，无功能变更 - 文档保持一致，未检测到代码或配置文件更改","fileCount":6,"zipByteSize":107145},{"version":"1.0.1","createdAt":"2026-05-06T02:27:51.889Z","changelog":"- 变更 skill 描述中的降级 skill 名称为 lingxi-smartstock-skill，并调整相关引用 - skill 描述中补充了常用触发关键词，方便检索和自动化匹配 - 版本号由 0.0.8 升级为 0.0.9 - 其余授权、优先级、跨平台规范等内容保持一致","fileCount":5,"zipByteSize":105811},{"version":"1.0.0","createdAt":"2026-04-24T01:18:08.049Z","changelog":"lingxi-realtimemarketdata-skill v1.0.0 - 首次发布: 支持提供A股、港股、美股、ETF与指数实时数据，覆盖多项关键行情与资金流向指标。 - 所有行情调用前需先执行授权流程，支持二维码和APIKEY两种授权方式。 - 如Skill无法满足查询，指导用户前往国泰海通灵犀APP，或兜底调用gtht-smartstock-skill。 - 全平台（Windows/Linux/macOS）命令执行严格使用node，不调用shell，兼容指令规范。 - 严格的输出和回答要求，包括所有回复的固定合规免责声明和防幻觉指令。","fileCount":5,"zipByteSize":437528}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17392radw7ghrj3rb101hqj5x85f74n:lingxi-realtimemarketdata-skill","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:43:33.451Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-gtht-tech-lingxi-realtimemarketdata-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":null},"readme":"Skill: 国泰海通证券-灵犀实时行情\n\nOwner: gtht-tech\n\nSummary: 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效...\n\nTags: latest:1.0.2\n\nVersion history:\n\nv1.0.2 | 2026-05-07T06:10:00.955Z | user\n\nv1.0.2\n\n- 更新版本号至 1.0.2，无功能变更\n- 文档保持一致，未检测到代码或配置文件更改\n\nv1.0.1 | 2026-05-06T02:27:51.889Z | user\n\n- 变更 skill 描述中的降级 skill 名称为 lingxi-smartstock-skill，并调整相关引用\n- skill 描述中补充了常用触发关键词，方便检索和自动化匹配\n- 版本号由 0.0.8 升级为 0.0.9\n- 其余授权、优先级、跨平台规范等内容保持一致\n\nv1.0.0 | 2026-04-24T01:18:08.049Z | user\n\nlingxi-realtimemarketdata-skill v1.0.0\n\n- 首次发布: 支持提供A股、港股、美股、ETF与指数实时数据，覆盖多项关键行情与资金流向指标。\n- 所有行情调用前需先执行授权流程，支持二维码和APIKEY两种授权方式。\n- 如Skill无法满足查询，指导用户前往国泰海通灵犀APP，或兜底调用gtht-smartstock-skill。\n- 全平台（Windows/Linux/macOS）命令执行严格使用node，不调用shell，兼容指令规范。\n- 严格的输出和回答要求，包括所有回复的固定合规免责声明和防幻觉指令。\n\nArchive index:\n\nArchive v1.0.2: 6 files, 107145 bytes\n\nFiles: gateway-config.json (884b), skill-card.md (2497b), skill-entry.js (121290b), SKILL.md (32810b), stock_code_name.json (309148b), _meta.json (150b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: lingxi-realtimemarketdata-skill\ndescription:\n 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。\n 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效数据，须再尝试 lingxi-smartstock-skill，仍无数据则按正文固定话术引导用户至国泰海通灵犀 APP。触发关键词包括：股价，涨跌幅，实时行情，查股价，查行情。\nallowed-tools: [\"node\"]\nversion: 1.0.2\ndisable: false\n---\n\n# 国泰海通证券 实时行情 Skill\n\n## 0. 最高优先级（模型须最先遵守）\n\n### 0.1 授权先于一切调用\n\n-【最先执行】任何行情或 MCP 调用之前：必须先确认 `gtht-entry.json` 文件是否存在；不存在则必须先跑 `node skill-entry.js authChecker auth --channel`，禁止跳过授权直接调接口，如果返回链接，请第一时间返回给客户。\n- 【gtht-entry.json查找方案】API Key 需按以下顺序查找 `gtht-entry.json`：\n 1. `../gtht-skill-shared/gtht-entry.json`\n 2. `../../gtht-skill-shared/gtht-entry.json`\n 3. `../../../gtht-skill-shared/gtht-entry.json`\n 4. `./gtht-skill-shared/gtht-entry.json`\n 若都不存在，则在**优先级 1** 对应位置创建目录并写入（即首选落盘为 `../gtht-skill-shared/gtht-entry.json`）\n\n- **在任意** `node … skill-entry.js …` **行情类、**`mcpClient call` **或依赖 API Key 的操作之前**，必须先确认 **`gtht-entry.json`已存在，具体查找方式见：【gtht-entry.json查找方案】**；不可用「用户已表达查股意图」为由跳过本步。\n- 若该文件**不存在**，或已判定 Key 失效（如接口 **4xx**）：**禁止**直接查数；**必须**先完成下文 **「2. 授权检查与执行」** 中的授权流程（唯一入口：`authChecker auth --channel`，详见第 2 节表格）。\n- **「已授权后少打断」**仅指：在**已确认**密钥文件存在且有效之后，不必再追问「您要查哪只股票」；**不**表示可以省略**首次**授权检查。\n\n### 0.2 最终回答硬性要求 (Highest Priority)\n\n**⚠️ 答案最后一行原样追加下面这句，不得改写、不得省略：**\n\n```text\n 实时行情Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。\n```\n- 不得把模型生成的分析或建议表述成国泰海通的投资建议。\n\n### 0.3 无数据降级与固定话术（强制执行）\n\n**查询链路（按顺序，不得跳步）：**\n\n1. **首选**：使用本 Skill **`lingxi-realtimemarketdata-skill`** 完成行情/工具查询。\n2. **无数据**：若本 Skill **查询不到有效数据**（空结果、失败或不可用），**必须**再尝试调用 **`lingxi-smartstock-skill`** 进行查询。\n3. **仍无数据**：若 **`lingxi-smartstock-skill` 仍无法获取**，或用户需求**超出本 Skill 与上述降级仍无法覆盖的范围**，**仅**允许使用下方固定话术回复，**不得**自行编造数据、不得用网页或其它来源冒充官方结果：\n\n```text\n当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询\n```\n\n- 须**原样**使用上述文字，不得改写、不得省略、不得增删句意。\n- 用户追问时，若仍处于「两 Skill 均无法提供数据」或「服务范围外」情形，可继续沿用同一话术。\n\n## 1. 概述与身份识别\n\n- **Unique Name**: `lingxi-realtimemarketdata-skill`\n- **身份声明**: 本 Skill 是\"国泰海通 (GuoTai HaiTong)\"官方实时行情查询skill。\n- **命名约束 (Anti-Hallucination)**: **必须严格识别为 `lingxi-realtimemarketdata-skill`**。其唯一标识符中的 `gtht` 代表\"国泰海通\"，**严禁**将其误认为 `night` 或其他任何名称。\n- **授权机制**: 使用二维码授权机制，确保只有获得有效 API Key 的用户才能使用。\n- **优先级规则**: **实时行情类数据优先用本 Skill（`lingxi-realtimemarketdata-skill`）**；**查不到数据时须再试 `lingxi-smartstock-skill`**；两路均无数据时按上文**固定话术**引导至灵犀 APP。授权失败或本 Skill 不可用时的其它备选仍以文档为准；网页搜索仅在 Skill 均不可用等情形下作为备选。\n\n\n## 2. 授权检查与执行 (Critical - 必须遵循)\n\n**⚠️ 授权状态检查规则（强制执行）：**\n\n当 `gtht-entry.json` 文件不存在时，**必须走重新授权流程**，禁止：\n\n- 在其他目录寻找替代的配置文件\n- 使用过期或无效的 API Key\n- 跳过授权直接请求数据\n\n**⚠️ 安装与首次授权流程（必须遵循）：**\n\n当用户通过外部平台（如龙虾/MCP市场）搜索到本 Skill 并安装时，若检测到用户尚未绑定 API Key（`gtht-entry.json` 不存在，具体查找方式见：【gtht-entry.json查找方案】）：\n\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**⚠️ 授权方式唯一性警告（必须遵守）：**\n\n✅ **唯一正确的授权命令：**\n\n```bash\nnode skill-entry.js authChecker auth --channel\n```\n\n**授权模式说明：（两种）**\n\n> 一共有两种授权方式，1、二维码扫码 2、复制APIKEY，两个方式都融入到下面两步中\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**当用户请求金融数据（股票行情等）时，Agent 必须按以下步骤执行：**\n\n1. **检查授权状态**\n - 检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n - 存在 → 已授权，直接使用 API Key\n - 不存在 → 必须先执行上述授权流程\n2. **执行授权命令（未授权时必须执行）**\n 参照上述`授权模式说明`\n3. **授权成功后继续处理用户请求**\n - 重新检查 `gtht-entry.json` 文件，具体查找方式见：【gtht-entry.json查找方案】\n\n\n**重要提醒：**\n\n- ✅ **必须使用 `node skill-entry.js authChecker auth --channel` 执行授权**，**不要使用其他授权方式**\n- ✅ **不要跳过授权直接查询数据**，否则会返回 401/403 错误\n- ❌ **不要使用非 node skill-entry.js authChecker auth 的方式生成二维码**\n\n---\n\n## 3. 跨平台执行规范 (Critical)\n\n**为确保在 Windows、Linux 和 macOS 上表现一致，Agent 必须遵循：**\n\n- **强制执行器**: 严禁调用系统原生 Shell。**必须始终使用 `node` 命令**。\n- **路径规范**: 始终使用相对路径 `xxx.js`。具体的 OS 适配逻辑已封装在 JS 内部。\n- **⚠️ PowerShell 命令分隔符（Windows 专用）**: Windows PowerShell 不支持 `&&` 作为命令分隔符，**必须使用 `;`**。在所有 `execute_command` 命令中，禁止使用 `&&` 连接多条命令，只能用 `;` 分隔。\n- **⚠️ Windows PowerShell 命令兼容性（强制执行）**: Windows PowerShell 与 Unix/Linux 命令不兼容，**禁止在 PowerShell 环境中使用 Unix 特有命令**，常见错误命令包括：\n\n | 禁止使用 | 正确替代 | 说明 |\n | ----------------------- | ------------------------------------------- | -------------------------- |\n | `test -f ` | `Test-Path ` | Unix 文件测试命令，PowerShell 不识别 |\n | `ls`、`dir`（部分） | `Get-ChildItem` 或 `dir` | Unix 目录列表命令 |\n | `cat ` | `Get-Content ` | Unix 文件读取命令 |\n | `grep ` | `Select-String ` | Unix 文本搜索命令 |\n | `rm ` | `Remove-Item ` | Unix 文件删除命令 |\n | `cp ` | `Copy-Item ` | Unix 文件复制命令 |\n | `mv ` | `Move-Item ` | Unix 文件移动命令 |\n | `mkdir -p ` | `New-Item -ItemType Directory -Path ` | Unix 创建目录命令 |\n | `which ` | `Get-Command ` | Unix 命令路径查询 |\n | `kill ` | `Stop-Process -Id ` | Unix 进程终止命令 |\n\n **检查文件是否存在（正确方式）：**\n ```powershell\n # ✅ 正确（PowerShell 原生）\n if (Test-Path \"C:/Users/.../gtht-entry.json\") { \"EXISTS\" } else { \"NOT_FOUND\" }\n\n # ❌ 错误（Unix 命令，PowerShell 不识别）\n test -f \"C:/Users/.../gtht-entry.json\"\n ```\n\n\n| 任务类型 | 跨平台统一命令 |\n| --------------------- | ---------------------------------------------------------------- |\n| **执行授权流程（本地终端）** | `node skill-entry.js authChecker auth` |\n| **执行授权流程（Channel环境）** | `node skill-entry.js authChecker auth --channel` |\n| **调用具体工具** | `node skill-entry.js mcpClient call [args]` |\n\n\n---\n\n### ⚠️ 工作流程规范（强制执行 - 2026-03-25追加）\n\n**已授权状态下直接执行查询，不需要二次确认：**\n\n- ✅ **正确做法**：授权确认后（如 `gtht-entry.json` 存在，具体查找方式见：【gtht-entry.json查找方案】），直接根据用户请求开始查询，不需要再询问用户\"您想查哪只股票\"\n- ❌ **错误做法**：授权确认后还问用户\"请问您想查询哪只股票\"\n- ⚠️ **例外**：仅当用户请求不明确时（如用户只说\"查一下\"），才需要追问具体标的\n\n**原因**：用户说\"查询个股行情\"时已表明意图，授权确认只是前置检查，不应在此环节打断用户。\n\n---\n\n## 3. 业务应用场景 (Business Definition Area)\n\n> **此区域供业务同事发挥，用于定义具体的服务意图与话术引导。**\n\n\n| 场景分类 | 典型用户问题 (Intent) | 业务逻辑指导 |\n| -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **实时行情查询** | 单股行情\"SH600000现在什么价格？\" \"SH600000开盘价是多少？\" | 定位 `market` 领域，调用 `marketdata-tool`。 |\n|\n\n### 问句示例\n#### 单股行情\n\n```\n- \"贵州茅台现在什么价格？\"\n- \"宁德时代今天走势怎么样\"\n- \"SH600519当前涨跌幅\"\n```\n\n#### 多股对比\n\n```\n- \"对比贵州茅台和五粮液今天的涨跌幅\"\n- \"同时查看比亚迪和长城汽车的最新价格\"\n```\n\n\n### 返回示例 \n\n```\n【宁德时代 (SZ300750)】\n\n最新价：XXX\n开盘价：XXX\n最高价：XXX\n最低价：XXX\n涨跌幅：XXX\n涨跌额：XXX\n振幅：XXX\n量比：XXX\n成交量：XXX\n成交额：XXX\n换手率：XXX\n当日资金净流入：XXX\n总市值：XXX\n\n注意⚠️：按照实际返回的来展示给客户，不要自己去添加没有的参数，如果客户没有具体点出要哪些参数，上述的参数都应该给到用户\n\n```\n\n### ⚠️ 名称查询 vs 代码查询规则（强制执行）\n\n**当用户输入公司名称查询行情时，必须先执行 `node skill-entry.js stockMap codeByName 贵州茅台` 获取代码：**\n\n- ✅ **用户输入公司名称**（如\"国泰海通\"、\"贵州茅台\"、\"宁德时代\"）\n - **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取股票代码\n - 再用获取的代码调用行情接口\n- ✅ **用户直接输入股票代码**（如\"SH601211\"、\"SZ300750\"）\n - **不需要**调用 `node skill-entry.js stockMap codeByName <股票名称>`，直接调用行情接口\n- **示例 - 用户问\"帮我查一下国泰海通今天的走势\"：**\n ```\n 1. 调用 `node skill-entry.js stockMap codeByName 国泰海通` 查表 → 返回 SH601211\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211`\n ```\n- **示例 - 用户问\"帮我查一下SH601211今天的走势\"：**\n ```\n 1. 直接调用 node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211（无需查表）\n ```\n\n---\n\n### ⚠️ 批量行情查询说明（强制执行）\n\n**marketdata-tool 支持直接批量查询：**\n\n- ✅ **支持批量格式 1 - 逗号分隔**：多次指定同一参数\n ```\n reduced_codes=SZ000001,Z300750,SH600519\n ```\n\n** js文件 内部处理**: 对已知数组参数名（`` 等），单值自动包装为数组；对重复参数或逗号分隔值，自动合并为数组。\n\n---\n\n\n**展示热点相关股票时，若缺少股票代码，必须先补全代码再获取行情：**\n\n- ❌ **错误方式**：直接展示股票名称，代码留空或省略\n- ✅ **正确方式**：\n 1. 先调用 ` nodeskill-entry.js stockMap codeByName <股票名称>` 查询所有缺失代码\n 2. 再按照上面查询到的股票代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>` 获取最新价、涨跌幅、成交额、资金净流入等数据\n 3. 按描述统一呈现给用户，确保信息完整\n- **示例 - 热榜中出现\"恒誉环保\"但无代码：**\n ```\n 1. `node skill-entry.js stockMap codeByName <股票名称>` → 返回 SH688309\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH688309` 获取行情\n 3. 完整展示：恒誉环保 | SH688309 | +XX% | XX亿 | -XX万\n ```\n\n---\n\n### ⚠️ 数据展示规范（强制执行）\n\n**展示接口返回数据时，禁止自行计算或换算，必须直接展示原始值：**\n\n- ❌ **错误做法**：对接口返回的数值进行二次计算后再展示（如将单位从元换算成万元/亿元）\n- ✅ **正确做法**：直接展示接口返回的原始数值，不做任何加工处理\n- ⚠️ **例外**：仅当用户明确要求时才进行单位换算\n\n**原因**：自行计算容易出错（如单位换算错误），且接口返回的值已经是标准单位，直接展示更简洁准确。\n\n**示例**：\n\n```\n接口返回 netInflow: -226585632.00\n❌ 错误展示：-2,266万（计算错误，少了10倍）\n✅ 正确展示：-226585632.00，或由用户决定如何呈现\n```\n\n---\n\n### ⚠️ 严禁捏造股票代码（强制执行 - 最高优先级）\n\n**向用户提供的任何股票代码，必须经过系统验证，禁止凭空捏造或凭记忆给出：**\n\n- ❌ **严格禁止的行为**：\n - 未经查询，随口说出股票代码（如随口说\"SZ001896\"）\n - 凭记忆或印象给出代码，不经验证\n - 在回复中编造不存在的股票代码\n - 对股票代码做任何假设，必须基于实际查询结果\n- ✅ **必须遵循的流程**：\n 1. **执行**:`node skill-entry.js stockMap codeByName <股票名称>`查询正确的股票代码\n 2. **行情接口验证**：用查到的代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>`，确认能返回有效数据\n 3. **再提供给用户**：代码经过验证后，才能在回复中使用\n- **示例 - 用户提到\"华电辽能\"：**\n ```\n ❌ 错误：直接说\"华电辽能的代码是SZ001896\"（未经任何查询）\n\n ✅ 正确：\n 1. 调用 `node skill-entry.js stockMap codeByName 华电辽能` → 返回 SH600396\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>` → 返回有效行情\n 3. 确认后告知用户：华电辽能 | SH600396\n ```\n- **错误后果**：\n - 捏造股票代码会严重损害用户信任\n - 可能导致用户交易错误的标的，造成财产损失\n - 违反证券咨询的专业性和合规性要求\n- **特殊说明**：\n - 即使是知名大盘股（如\"工商银行\"、\"中国石油\"），也必须查询后确认\n - 不同市场的同名股票可能代码不同（如A股和港股）\n - 代码前缀（SH/SZ/HK/US等）必须与市场对应\n\n---\n\n## 4. MCP网关端点\n\n| 领域 | 网关 | 地址 | 环境 |\n| --------- | --------- | ------------------------------------------------ | ---- |\n| 行情 | market | `https://zx.app.gtja.com:8443/mcp/marketdata` | 生产环境 |\n\n\n\n## 可用工具列表\n\n| 领域 | 工具名称 | 描述 |\n| --- | --- | --- |\n| market | marketdata-tool | 自定义榜单功能，可以获得证券的行情 |\n\n\n\n## 5. Agent 使用流程 (SOP)\n\n### 5.1 决策流程图\n\n┌─────────────────────────────────────────────────────────────┐\n\n│ Agent 决策流程 │\n\n├─────────────────────────────────────────────────────────────┤\n\n│ │\n\n│\n\n1. 检查授权状态 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 检查 gtht-entry.json │ │\n\n│ │ 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 存在 → 已授权，直接使用 API Key │ │\n\n│ │ → 不存在 → 执行授权流程（第2步） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 执行授权流程（如果未授权） │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ ⚠️ 唯一正确的授权方式 │ │\n\n│ │ 唯一命令: node skill-entry.js authChecker auth │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第一步：检查授权文件是否存在 │ │\n\n│ │ → 检查 gtht-entry.json，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 不存在 → 必须先执行授权 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第二步：执行授权命令（必须执行） │ │\n\n│ │ → 命令: node skill-entry.js authChecker auth --channel │ │\n\n│ │ ─────────────────────────────── │ │\n\n\n│ │ 第三步：等待用户扫码授权 │ │\n\n│ │ → 脚本会自动轮询授权服务器 │ │\n\n│ │ → Linux: 每 3 秒输出一次轮询状态 │ │\n\n│ │ → Windows/macOS: 每次尝试都输出状态 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第四步：授权成功后自动保存 │ │\n\n│ │ → API Key 保存到 `../gtht-skill-shared/gtht-entry.json` │ │\n\n│ │ → Windows/macOS: 等待 5 秒后关闭浏览器窗口 │ │\n\n│ │ → 退出脚本（exit code 0） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 领域匹配 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 用户查询 │ │\n\n│ │ → 股票/股价/行情/代码/走势/资金流向 → 行情领域 (market) │ │\n\n│ │\n\n│\n\n\n1. 意图抉择 (Agent自主决策) │\n\n│ → 分析工具描述，匹配用户意图 │\n\n│ → 选择最合适的工具 │\n\n│ │\n\n│\n\n1. 调用执行 │\n\n│ → node skill-entry.js mcpClient call [args] │\n\n│ → 如果返回 4xx 错误，说明 API Key 过期 │\n\n│ → 按【gtht-entry.json查找方案】删除已存在的 gtht-entry.json │\n\n│ → 重新执行授权流程（回到第1步） │\n\n│ │\n\n└─────────────────────────────────────────────────────────────┘\n\n### 5.2 使用示例\n\n**股票名由市场和股票代码构成，如SH601211：SH为上海市场，601211为股票代码；SZ000001：SZ为深圳市场，000001为股票代码。类似对应HK(港股)、US(美股)、UK(英股)、SX(新加坡)等，传参的reduced_codes由市场+代码两要素组成\n**示例1：查询个股行情**\n\n```\n用户：查询贵州茅台的股价\n\nAgent执行：\n1. 检查 gtht-entry.json 是否存在，具体查找方式见：【gtht-entry.json查找方案】 → 已授权\n2. 领域匹配 → \"股价\" → 行情领域 (market)\n3. 调用 `node skill-entry.js stockMap codeByName 贵州茅台` → 返回 SH600519\n4. 调用执行 → node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH600519\n5. 返回行情数据给用户\n```\n\n\n⚠️ 注意：\n- marketdata-tool 支持批量查询，无需逐只调用！\n\n\n\n## 6. 文件与模块说明\n\n### 配置文件说明\n\n**授权文件**: `gtht-entry.json`，具体查找方式见：【gtht-entry.json查找方案】\n\n- **路径**: 具体路径见：【gtht-entry.json查找方案】\n- **内容**: 包含 API Key 和 其更新时间（不是apikey的过期时间）\n- **格式**: `{\"apiKey\": \"xxx\"}`\n- **注意**: 此文件由系统自动生成，请勿手动修改\n\n**网关配置文件**: `gateway-config.json`\n\n- **路径**: 跟 SKILL.md 同一目录下（即 `./gateway-config.json`）\n- **作用**: 定义所有可用的 MCP 网关地址\n- **格式**:\n ```json\n {\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\"\n }\n }\n ```\n\n### 授权流程（推荐使用）\n\n- **功能**: 自动检测 OS 类型和环境。\n- **动作**:\n - **Windows/macOS**：打开浏览器 HTML 二维码，授权成功后等待 5 秒确保页面自动关闭。\n - **Linux 本地终端**：**终端直接渲染 Unicode 二维码**（使用 ANSI 256 色 + 半像素算法 █▀▄，无需浏览器）。\n - **Channel 环境（飞书/微信等）**：生成 在线url地址，输出供 Agent 发送。\n- **命令**:\n - 本地终端：`node skill-entry.js authChecker auth --channel`\n- **超时处理**: 如果 2 分钟内用户未扫码，脚本会提示超时并退出。此时需要重新运行命令。\n\n\n### 工具调用\n\n- **功能**: 执行指定工具调用或清除授权。\n- **命令**: `node skill-entry.js mcpClient [key=value ...]`\n- **清除**: `node skill-entry.js mcpClient clear`\n- **返回**: 工具执行结果的 JSON 数据\n\n### A股名称代码映射表\n\n- **功能**: 根据股票名称查询对应代码，或根据代码查询名称。\n- **数据源**: `stock_code_name.json`\n- **命令**: 直接 require 使用，不支持命令行调用\n- **使用方式**:\n `node skill-entry.js stockMap codeByName <股票名称>`\n- **⚠️ 查询规则（强制执行）**:\n - 用**名称**查询行情时 → **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取代码 → 再用代码调接口\n - 用**代码**直接查询时 → **不需要**查此表，直接调接口\n\n\n## 7. 授权机制与安全性说明 (核心逻辑)\n\n### 授权机制说明\n\n本 Skill 使用二维码授权。API Key 具有有效期。\n\n1. **自动检测**: 请求返回 4xx 错误表示过期。\n2. **自愈流程**: Agent 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` -> 执行 `node skill-entry.js authChecker auth` -> 用户重新扫码 -> 获取新 Key 并重试。\n\n### 授权详细步骤\n\n1. **生成二维码**: 包含 `MAC地址_UTC时间戳_5位随机字符`。\n2. **Session ID**: 使用 MD5 加密 QR Body 得到的会话标识。\n3. **轮询机制**: 每 3 秒请求一次授权服务器，超时时间 5 分钟。\n4. **浏览器兼容性**: 授权成功收到服务器响应后，**必须等待至少 5 秒再关闭代理服务器**，确保浏览器端有足够时间接收成功响应并执行 `window.close()` 自动关闭页面。\n\n### 安全性保障\n\n- **设备绑定**: MAC 地址唯一标识。\n- **防重放**: UTC 时间戳验证。\n- **环境适配**: 授权完成后自动清理 Windows 临时 HTML 文件。\n\n---\n\n## 8. 故障排除 (Troubleshooting)\n\n### Skill 调用失败排查\n\n1. **检查名称**: 确保调用名为 `lingxi-realtimemarketdata-skill`。\n2. **检查位置**: 确认本 SKILL.md 位于正确的 Skill 目录中。\n3. **API Key 过期**: 观察是否收到 4xx 错误，按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` 后执行 `node skill-entry.js authChecker auth`, channel环境执行 `node skill-entry.js authChecker auth --channel`。\n4. **Windows 特殊处理**: 确保 `node` 在 PATH 中，系统会自动调用浏览器。\n\n### 错误码对照表\n\n\n| 错误码 | 含义 | 可能原因 | 解决方案 |\n| ------------ | ---------- | ----------------- | ---------------------------------------------------------------- |\n| 400 | 请求参数错误 | 传入的参数格式不正确或缺少必填参数 | 检查工具所需的参数，确保格式正确 |\n| 401 | 未授权 | API Key 过期或无效 | 删除 `gtht-entry.json`，重新执行 `node skill-entry.js authChecker auth --channel` |\n| 403 | 禁止访问 | 没有权限访问该工具 | 联系管理员确认权限配置 |\n| 404 | 工具不存在 | 工具名称错误或网关地址变更 | 运行 `node skill-entry.js autoDiscover domain <领域>` 查看可用工具 |\n| 500 | 服务器内部错误 | MCP 网关服务异常 | 稍后重试，或联系管理员 |\n| 502/503 | 网关不可用 | 网关服务暂时不可用 | 检查网络连接，稍后重试 |\n| ECONNREFUSED | 连接被拒绝 | 无法连接到网关服务器 | 检查网络连接，确认网关地址是否正确 |\n| 授权超时 | 用户未在2分钟内扫码 | 用户未及时完成授权 | 重新运行 `node skill-entry.js authChecker auth --channel`，按提示重新扫码 |\n\n\n### 常见问题速查\n\n| 错误现象 | 可能原因 | 解决方案 |\n| -------------------- | ------------------------------------ | --------------------------------------------------------------------------- |\n| \"Skill not found\" | 名称错误或未安装 | 核对名称并检查安装目录 |\n| 授权失败 | 未授权或过期 | 执行 `node skill-entry.js authChecker auth --cahnnel` |\n| \"401 Unauthorized\" | Key 过期 | 系统将自动重触发授权流程 |\n| \"找不到模块\" | Node.js 环境异常 | 检查 Node.js 安装，重新安装依赖 |\n| 二维码无法显示 | 浏览器问题 | 使用 `--ascii` 参数强制终端显示 |\n| 返回数据为空 | 股票代码错误或暂无数据 | 检查股票代码是否正确，或该股票暂无相关数据 |\n| 返回`API Key 无效或已被禁用，请检查密钥状态或重新生成后再试` | 客户停用api-key | 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json`（可能在优先级 1～4 任一路径），提示重新走授权流程: `node skill-entry.js authChecker auth --channel` |\n| **终端显示 Unicode 二维码** | **微信/飞书环境下，用户看不到终端二维码** | **必须使用 `node skill-entry.js authChecker auth --channel` 生成 PNG 图片** |\n---\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn703f7xkxhrc3xcd427a05knd85fks3\",\n \"slug\": \"lingxi-realtimemarketdata-skill\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1778134200955\n}\n\nFile v1.0.2:skill-card.md\n\n## Description:\n\nGuoTai HaiTong Lingxi Real-Time Market Data helps agents retrieve real-time market quotes for A-shares, Hong Kong stocks, U.S. stocks, ETFs, and indexes, including price, change, volume, turnover, net inflow, turnover rate, and volume ratio.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[gtht-tech](https://clawhub.ai/user/gtht-tech)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and financial-data agents use this skill to answer requests for current securities quotes, stock-code lookup, single-symbol行情, and multi-symbol comparisons. The skill is intended to return objective market data and route users to the Lingxi app when neither this skill nor its documented fallback can provide data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores a GuoTai HaiTong API key locally in gtht-entry.json.\n\nMitigation: Treat the API key like a password, avoid pasting it into chat when possible, review where the file is stored, and restrict local file permissions.\n\nRisk: Credential-bearing market-data requests can be routed through configurable gateways.\n\nMitigation: Use only trusted gateway-config.json or GTHT_GATEWAY_CONFIG values and review gateway destinations before running the skill.\n\nRisk: Market-data responses could be mistaken for investment advice.\n\nMitigation: Present the output as objective data only and preserve the skill's disclaimer that generated content is not investment advice.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/gtht-tech/skills/lingxi-realtimemarketdata-skill)\n- [ClawHub publisher profile](https://clawhub.ai/user/gtht-tech)\n- [GuoTai HaiTong market data gateway](https://zx.app.gtja.com:8443/mcp/marketdata)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown text with inline Node.js command examples and market-data values]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Responses should present returned market-data fields without fabricating securities codes or investment advice.]\n\n## Skill Version(s):\n\n1.0.2 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.2:gateway-config.json\n\n{\n \"active_env\": \"PROD\",\n \"base_urls\": {\n \"prod\": \"https://zx.app.gtja.com:8443/\"\n },\n \"gateway_paths\": {\n \"market\": \"mcp/marketdata\",\n \"mqtt\": \"mcp/mqtt\"\n },\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\",\n \"mqtt\": \"https://zx.app.gtja.com:8443/mcp/mqtt\"\n },\n \"known_domains\": [\n \"market\",\n \"mqtt\"\n ],\n \"discovered_tools\": [\n {\n \"domain\": \"market\",\n \"gateway\": \"market\",\n \"toolName\": \"marketdata-tool\",\n \"description\": \"自定义榜单功能，可以获得证券的行情\",\n \"label\": \"行情\",\n \"params\": [\n \"code\",\n \"market_data_mask\",\n \"product_mask\"\n ],\n \"callExample\": \"node skill-entry.js call market marketdata-tool code= market_data_mask= product_mask=\"\n }\n ],\n \"learned_at\": \"2026-03-20T10:51:20.965Z\",\n \"last_updated\": \"2026-03-20T10:51:20.966Z\"\n}\n\nArchive v1.0.1: 5 files, 105811 bytes\n\nFiles: gateway-config.json (884b), skill-entry.js (121329b), SKILL.md (32915b), stock_code_name.json (309148b), _meta.json (150b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: lingxi-realtimemarketdata-skill\ndescription:\n 国泰海通证券-灵犀实时行情 skill（lingxi-realtimemarketdata-skill）：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。\n 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效数据，须再尝试 lingxi-smartstock-skill，仍无数据则按正文固定话术引导用户至国泰海通灵犀 APP。触发关键词包括：股价，涨跌幅，实时行情，查股价，查行情。\nallowed-tools: [\"node\"]\nversion: 0.0.9\ndisable: false\n---\n\n**Agent 只需读取此文件，无需读取其他源码文件。**\n\n# 国泰海通证券 实时行情 Skill\n\n## 0. 最高优先级（模型须最先遵守）\n\n### 0.1 授权先于一切调用\n\n-【最先执行】任何行情或 MCP 调用之前：必须先确认 `gtht-entry.json` 文件是否存在；不存在则必须先跑 `node skill-entry.js authChecker auth --channel`，禁止跳过授权直接调接口，如果返回链接，请第一时间返回给客户。\n- 【gtht-entry.json查找方案】API Key 需按以下顺序查找 `gtht-entry.json`：\n 1. `../gtht-skill-shared/gtht-entry.json`\n 2. `../../gtht-skill-shared/gtht-entry.json`\n 3. `../../../gtht-skill-shared/gtht-entry.json`\n 4. `./gtht-skill-shared/gtht-entry.json`\n 若都不存在，则在**优先级 1** 对应位置创建目录并写入（即首选落盘为 `../gtht-skill-shared/gtht-entry.json`）\n\n- **在任意** `node … skill-entry.js …` **行情类、**`mcpClient call` **或依赖 API Key 的操作之前**，必须先确认 **`gtht-entry.json`已存在，具体查找方式见：【gtht-entry.json查找方案】**；不可用「用户已表达查股意图」为由跳过本步。\n- 若该文件**不存在**，或已判定 Key 失效（如接口 **4xx**）：**禁止**直接查数；**必须**先完成下文 **「2. 授权检查与执行」** 中的授权流程（唯一入口：`authChecker auth --channel`，详见第 2 节表格）。\n- **「已授权后少打断」**仅指：在**已确认**密钥文件存在且有效之后，不必再追问「您要查哪只股票」；**不**表示可以省略**首次**授权检查。\n\n### 0.2 最终回答硬性要求 (Highest Priority)\n\n**⚠️ 答案最后一行原样追加下面这句，不得改写、不得省略：**\n\n```text\n 实时行情Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。\n```\n- 不得把模型生成的分析或建议表述成国泰海通的投资建议。\n\n### 0.3 无数据降级与固定话术（强制执行）\n\n**查询链路（按顺序，不得跳步）：**\n\n1. **首选**：使用本 Skill **`lingxi-realtimemarketdata-skill`** 完成行情/工具查询。\n2. **无数据**：若本 Skill **查询不到有效数据**（空结果、失败或不可用），**必须**再尝试调用 **`lingxi-smartstock-skill`** 进行查询。\n3. **仍无数据**：若 **`lingxi-smartstock-skill` 仍无法获取**，或用户需求**超出本 Skill 与上述降级仍无法覆盖的范围**，**仅**允许使用下方固定话术回复，**不得**自行编造数据、不得用网页或其它来源冒充官方结果：\n\n```text\n当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询\n```\n\n- 须**原样**使用上述文字，不得改写、不得省略、不得增删句意。\n- 用户追问时，若仍处于「两 Skill 均无法提供数据」或「服务范围外」情形，可继续沿用同一话术。\n\n## 1. 概述与身份识别\n\n- **Unique Name**: `lingxi-realtimemarketdata-skill`\n- **身份声明**: 本 Skill 是\"国泰海通 (GuoTai HaiTong)\"官方实时行情查询skill。\n- **命名约束 (Anti-Hallucination)**: **必须严格识别为 `lingxi-realtimemarketdata-skill`**。其唯一标识符中的 `gtht` 代表\"国泰海通\"，**严禁**将其误认为 `night` 或其他任何名称。\n- **授权机制**: 使用二维码授权机制，确保只有获得有效 API Key 的用户才能使用。\n- **优先级规则**: **实时行情类数据优先用本 Skill（`lingxi-realtimemarketdata-skill`）**；**查不到数据时须再试 `lingxi-smartstock-skill`**；两路均无数据时按上文**固定话术**引导至灵犀 APP。授权失败或本 Skill 不可用时的其它备选仍以文档为准；网页搜索仅在 Skill 均不可用等情形下作为备选。\n\n\n## 2. 授权检查与执行 (Critical - 必须遵循)\n\n**⚠️ 授权状态检查规则（强制执行）：**\n\n当 `gtht-entry.json` 文件不存在时，**必须走重新授权流程**，禁止：\n\n- 在其他目录寻找替代的配置文件\n- 使用过期或无效的 API Key\n- 跳过授权直接请求数据\n\n**⚠️ 安装与首次授权流程（必须遵循）：**\n\n当用户通过外部平台（如龙虾/MCP市场）搜索到本 Skill 并安装时，若检测到用户尚未绑定 API Key（`gtht-entry.json` 不存在，具体查找方式见：【gtht-entry.json查找方案】）：\n\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**⚠️ 授权方式唯一性警告（必须遵守）：**\n\n✅ **唯一正确的授权命令：**\n\n```bash\nnode skill-entry.js authChecker auth --channel\n```\n\n**授权模式说明：（两种）**\n\n> 一共有两种授权方式，1、二维码扫码 2、复制APIKEY，两个方式都融入到下面两步中\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**当用户请求金融数据（股票行情等）时，Agent 必须按以下步骤执行：**\n\n1. **检查授权状态**\n - 检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n - 存在 → 已授权，直接使用 API Key\n - 不存在 → 必须先执行上述授权流程\n2. **执行授权命令（未授权时必须执行）**\n 参照上述`授权模式说明`\n3. **授权成功后继续处理用户请求**\n - 重新检查 `gtht-entry.json` 文件，具体查找方式见：【gtht-entry.json查找方案】\n\n\n**重要提醒：**\n\n- ✅ **必须使用 `node skill-entry.js authChecker auth --channel` 执行授权**，**不要使用其他授权方式**\n- ✅ **不要跳过授权直接查询数据**，否则会返回 401/403 错误\n- ❌ **不要使用非 node skill-entry.js authChecker auth 的方式生成二维码**\n\n---\n\n## 3. 跨平台执行规范 (Critical)\n\n**为确保在 Windows、Linux 和 macOS 上表现一致，Agent 必须遵循：**\n\n- **强制执行器**: 严禁调用系统原生 Shell。**必须始终使用 `node` 命令**。\n- **路径规范**: 始终使用相对路径 `xxx.js`。具体的 OS 适配逻辑已封装在 JS 内部。\n- **⚠️ PowerShell 命令分隔符（Windows 专用）**: Windows PowerShell 不支持 `&&` 作为命令分隔符，**必须使用 `;`**。在所有 `execute_command` 命令中，禁止使用 `&&` 连接多条命令，只能用 `;` 分隔。\n- **⚠️ Windows PowerShell 命令兼容性（强制执行）**: Windows PowerShell 与 Unix/Linux 命令不兼容，**禁止在 PowerShell 环境中使用 Unix 特有命令**，常见错误命令包括：\n\n | 禁止使用 | 正确替代 | 说明 |\n | ----------------------- | ------------------------------------------- | -------------------------- |\n | `test -f ` | `Test-Path ` | Unix 文件测试命令，PowerShell 不识别 |\n | `ls`、`dir`（部分） | `Get-ChildItem` 或 `dir` | Unix 目录列表命令 |\n | `cat ` | `Get-Content ` | Unix 文件读取命令 |\n | `grep ` | `Select-String ` | Unix 文本搜索命令 |\n | `rm ` | `Remove-Item ` | Unix 文件删除命令 |\n | `cp ` | `Copy-Item ` | Unix 文件复制命令 |\n | `mv ` | `Move-Item ` | Unix 文件移动命令 |\n | `mkdir -p ` | `New-Item -ItemType Directory -Path ` | Unix 创建目录命令 |\n | `which ` | `Get-Command ` | Unix 命令路径查询 |\n | `kill ` | `Stop-Process -Id ` | Unix 进程终止命令 |\n\n **检查文件是否存在（正确方式）：**\n ```powershell\n # ✅ 正确（PowerShell 原生）\n if (Test-Path \"C:/Users/.../gtht-entry.json\") { \"EXISTS\" } else { \"NOT_FOUND\" }\n\n # ❌ 错误（Unix 命令，PowerShell 不识别）\n test -f \"C:/Users/.../gtht-entry.json\"\n ```\n\n\n| 任务类型 | 跨平台统一命令 |\n| --------------------- | ---------------------------------------------------------------- |\n| **执行授权流程（本地终端）** | `node skill-entry.js authChecker auth` |\n| **执行授权流程（Channel环境）** | `node skill-entry.js authChecker auth --channel` |\n| **调用具体工具** | `node skill-entry.js mcpClient call [args]` |\n\n\n---\n\n### ⚠️ 工作流程规范（强制执行 - 2026-03-25追加）\n\n**已授权状态下直接执行查询，不需要二次确认：**\n\n- ✅ **正确做法**：授权确认后（如 `gtht-entry.json` 存在，具体查找方式见：【gtht-entry.json查找方案】），直接根据用户请求开始查询，不需要再询问用户\"您想查哪只股票\"\n- ❌ **错误做法**：授权确认后还问用户\"请问您想查询哪只股票\"\n- ⚠️ **例外**：仅当用户请求不明确时（如用户只说\"查一下\"），才需要追问具体标的\n\n**原因**：用户说\"查询个股行情\"时已表明意图，授权确认只是前置检查，不应在此环节打断用户。\n\n---\n\n## 3. 业务应用场景 (Business Definition Area)\n\n> **此区域供业务同事发挥，用于定义具体的服务意图与话术引导。**\n\n\n| 场景分类 | 典型用户问题 (Intent) | 业务逻辑指导 |\n| -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **实时行情查询** | 单股行情\"SH600000现在什么价格？\" \"SH600000开盘价是多少？\" | 定位 `market` 领域，调用 `marketdata-tool`。 |\n|\n\n### 问句示例\n#### 单股行情\n\n```\n- \"贵州茅台现在什么价格？\"\n- \"宁德时代今天走势怎么样\"\n- \"SH600519当前涨跌幅\"\n```\n\n#### 多股对比\n\n```\n- \"对比贵州茅台和五粮液今天的涨跌幅\"\n- \"同时查看比亚迪和长城汽车的最新价格\"\n```\n\n\n### 返回示例 \n\n```\n【宁德时代 (SZ300750)】\n\n最新价：XXX\n开盘价：XXX\n最高价：XXX\n最低价：XXX\n涨跌幅：XXX\n涨跌额：XXX\n振幅：XXX\n量比：XXX\n成交量：XXX\n成交额：XXX\n换手率：XXX\n当日资金净流入：XXX\n总市值：XXX\n\n注意⚠️：按照实际返回的来展示给客户，不要自己去添加没有的参数，如果客户没有具体点出要哪些参数，上述的参数都应该给到用户\n\n```\n\n### ⚠️ 名称查询 vs 代码查询规则（强制执行）\n\n**当用户输入公司名称查询行情时，必须先执行 `node skill-entry.js stockMap codeByName 贵州茅台` 获取代码：**\n\n- ✅ **用户输入公司名称**（如\"国泰海通\"、\"贵州茅台\"、\"宁德时代\"）\n - **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取股票代码\n - 再用获取的代码调用行情接口\n- ✅ **用户直接输入股票代码**（如\"SH601211\"、\"SZ300750\"）\n - **不需要**调用 `node skill-entry.js stockMap codeByName <股票名称>`，直接调用行情接口\n- **示例 - 用户问\"帮我查一下国泰海通今天的走势\"：**\n ```\n 1. 调用 `node skill-entry.js stockMap codeByName 国泰海通` 查表 → 返回 SH601211\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211`\n ```\n- **示例 - 用户问\"帮我查一下SH601211今天的走势\"：**\n ```\n 1. 直接调用 node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211（无需查表）\n ```\n\n---\n\n### ⚠️ 批量行情查询说明（强制执行）\n\n**marketdata-tool 支持直接批量查询：**\n\n- ✅ **支持批量格式 1 - 逗号分隔**：多次指定同一参数\n ```\n reduced_codes=SZ000001,Z300750,SH600519\n ```\n\n** js文件 内部处理**: 对已知数组参数名（`` 等），单值自动包装为数组；对重复参数或逗号分隔值，自动合并为数组。\n\n---\n\n\n**展示热点相关股票时，若缺少股票代码，必须先补全代码再获取行情：**\n\n- ❌ **错误方式**：直接展示股票名称，代码留空或省略\n- ✅ **正确方式**：\n 1. 先调用 ` nodeskill-entry.js stockMap codeByName <股票名称>` 查询所有缺失代码\n 2. 再按照上面查询到的股票代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>` 获取最新价、涨跌幅、成交额、资金净流入等数据\n 3. 按描述统一呈现给用户，确保信息完整\n- **示例 - 热榜中出现\"恒誉环保\"但无代码：**\n ```\n 1. `node skill-entry.js stockMap codeByName <股票名称>` → 返回 SH688309\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH688309` 获取行情\n 3. 完整展示：恒誉环保 | SH688309 | +XX% | XX亿 | -XX万\n ```\n\n---\n\n### ⚠️ 数据展示规范（强制执行）\n\n**展示接口返回数据时，禁止自行计算或换算，必须直接展示原始值：**\n\n- ❌ **错误做法**：对接口返回的数值进行二次计算后再展示（如将单位从元换算成万元/亿元）\n- ✅ **正确做法**：直接展示接口返回的原始数值，不做任何加工处理\n- ⚠️ **例外**：仅当用户明确要求时才进行单位换算\n\n**原因**：自行计算容易出错（如单位换算错误），且接口返回的值已经是标准单位，直接展示更简洁准确。\n\n**示例**：\n\n```\n接口返回 netInflow: -226585632.00\n❌ 错误展示：-2,266万（计算错误，少了10倍）\n✅ 正确展示：-226585632.00，或由用户决定如何呈现\n```\n\n---\n\n### ⚠️ 严禁捏造股票代码（强制执行 - 最高优先级）\n\n**向用户提供的任何股票代码，必须经过系统验证，禁止凭空捏造或凭记忆给出：**\n\n- ❌ **严格禁止的行为**：\n - 未经查询，随口说出股票代码（如随口说\"SZ001896\"）\n - 凭记忆或印象给出代码，不经验证\n - 在回复中编造不存在的股票代码\n - 对股票代码做任何假设，必须基于实际查询结果\n- ✅ **必须遵循的流程**：\n 1. **执行**:`node skill-entry.js stockMap codeByName <股票名称>`查询正确的股票代码\n 2. **行情接口验证**：用查到的代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>`，确认能返回有效数据\n 3. **再提供给用户**：代码经过验证后，才能在回复中使用\n- **示例 - 用户提到\"华电辽能\"：**\n ```\n ❌ 错误：直接说\"华电辽能的代码是SZ001896\"（未经任何查询）\n\n ✅ 正确：\n 1. 调用 `node skill-entry.js stockMap codeByName 华电辽能` → 返回 SH600396\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>` → 返回有效行情\n 3. 确认后告知用户：华电辽能 | SH600396\n ```\n- **错误后果**：\n - 捏造股票代码会严重损害用户信任\n - 可能导致用户交易错误的标的，造成财产损失\n - 违反证券咨询的专业性和合规性要求\n- **特殊说明**：\n - 即使是知名大盘股（如\"工商银行\"、\"中国石油\"），也必须查询后确认\n - 不同市场的同名股票可能代码不同（如A股和港股）\n - 代码前缀（SH/SZ/HK/US等）必须与市场对应\n\n---\n\n## 4. MCP网关端点\n\n| 领域 | 网关 | 地址 | 环境 |\n| --------- | --------- | ------------------------------------------------ | ---- |\n| 行情 | market | `https://zx.app.gtja.com:8443/mcp/marketdata` | 生产环境 |\n\n\n\n## 可用工具列表\n\n| 领域 | 工具名称 | 描述 |\n| --- | --- | --- |\n| market | marketdata-tool | 自定义榜单功能，可以获得证券的行情 |\n\n\n\n## 5. Agent 使用流程 (SOP)\n\n### 5.1 决策流程图\n\n┌─────────────────────────────────────────────────────────────┐\n\n│ Agent 决策流程 │\n\n├─────────────────────────────────────────────────────────────┤\n\n│ │\n\n│\n\n1. 检查授权状态 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 检查 gtht-entry.json │ │\n\n│ │ 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 存在 → 已授权，直接使用 API Key │ │\n\n│ │ → 不存在 → 执行授权流程（第2步） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 执行授权流程（如果未授权） │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ ⚠️ 唯一正确的授权方式 │ │\n\n│ │ 唯一命令: node skill-entry.js authChecker auth │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第一步：检查授权文件是否存在 │ │\n\n│ │ → 检查 gtht-entry.json，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 不存在 → 必须先执行授权 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第二步：执行授权命令（必须执行） │ │\n\n│ │ → 命令: node skill-entry.js authChecker auth --channel │ │\n\n│ │ ─────────────────────────────── │ │\n\n\n│ │ 第三步：等待用户扫码授权 │ │\n\n│ │ → 脚本会自动轮询授权服务器 │ │\n\n│ │ → Linux: 每 3 秒输出一次轮询状态 │ │\n\n│ │ → Windows/macOS: 每次尝试都输出状态 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第四步：授权成功后自动保存 │ │\n\n│ │ → API Key 保存到 `../gtht-skill-shared/gtht-entry.json` │ │\n\n│ │ → Windows/macOS: 等待 5 秒后关闭浏览器窗口 │ │\n\n│ │ → 退出脚本（exit code 0） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 领域匹配 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 用户查询 │ │\n\n│ │ → 股票/股价/行情/代码/走势/资金流向 → 行情领域 (market) │ │\n\n│ │\n\n│\n\n\n1. 意图抉择 (Agent自主决策) │\n\n│ → 分析工具描述，匹配用户意图 │\n\n│ → 选择最合适的工具 │\n\n│ │\n\n│\n\n1. 调用执行 │\n\n│ → node skill-entry.js mcpClient call [args] │\n\n│ → 如果返回 4xx 错误，说明 API Key 过期 │\n\n│ → 按【gtht-entry.json查找方案】删除已存在的 gtht-entry.json │\n\n│ → 重新执行授权流程（回到第1步） │\n\n│ │\n\n└─────────────────────────────────────────────────────────────┘\n\n### 5.2 使用示例\n\n**股票名由市场和股票代码构成，如SH601211：SH为上海市场，601211为股票代码；SZ000001：SZ为深圳市场，000001为股票代码。类似对应HK(港股)、US(美股)、UK(英股)、SX(新加坡)等，传参的reduced_codes由市场+代码两要素组成\n**示例1：查询个股行情**\n\n```\n用户：查询贵州茅台的股价\n\nAgent执行：\n1. 检查 gtht-entry.json 是否存在，具体查找方式见：【gtht-entry.json查找方案】 → 已授权\n2. 领域匹配 → \"股价\" → 行情领域 (market)\n3. 调用 `node skill-entry.js stockMap codeByName 贵州茅台` → 返回 SH600519\n4. 调用执行 → node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH600519\n5. 返回行情数据给用户\n```\n\n\n⚠️ 注意：\n- marketdata-tool 支持批量查询，无需逐只调用！\n\n\n\n## 6. 文件与模块说明\n\n### 配置文件说明\n\n**授权文件**: `gtht-entry.json`，具体查找方式见：【gtht-entry.json查找方案】\n\n- **路径**: 具体路径见：【gtht-entry.json查找方案】\n- **内容**: 包含 API Key 和 其更新时间（不是apikey的过期时间）\n- **格式**: `{\"apiKey\": \"xxx\"}`\n- **注意**: 此文件由系统自动生成，请勿手动修改\n\n**网关配置文件**: `gateway-config.json`\n\n- **路径**: 跟 SKILL.md 同一目录下（即 `./gateway-config.json`）\n- **作用**: 定义所有可用的 MCP 网关地址\n- **格式**:\n ```json\n {\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\"\n }\n }\n ```\n\n### 授权流程（推荐使用）\n\n- **功能**: 自动检测 OS 类型和环境。\n- **动作**:\n - **Windows/macOS**：打开浏览器 HTML 二维码，授权成功后等待 5 秒确保页面自动关闭。\n - **Linux 本地终端**：**终端直接渲染 Unicode 二维码**（使用 ANSI 256 色 + 半像素算法 █▀▄，无需浏览器）。\n - **Channel 环境（飞书/微信等）**：生成 在线url地址，输出供 Agent 发送。\n- **命令**:\n - 本地终端：`node skill-entry.js authChecker auth --channel`\n- **超时处理**: 如果 2 分钟内用户未扫码，脚本会提示超时并退出。此时需要重新运行命令。\n\n\n### 工具调用\n\n- **功能**: 执行指定工具调用或清除授权。\n- **命令**: `node skill-entry.js mcpClient [key=value ...]`\n- **清除**: `node skill-entry.js mcpClient clear`\n- **返回**: 工具执行结果的 JSON 数据\n\n### A股名称代码映射表\n\n- **功能**: 根据股票名称查询对应代码，或根据代码查询名称。\n- **数据源**: `stock_code_name.json`\n- **命令**: 直接 require 使用，不支持命令行调用\n- **使用方式**:\n `node skill-entry.js stockMap codeByName <股票名称>`\n- **⚠️ 查询规则（强制执行）**:\n - 用**名称**查询行情时 → **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取代码 → 再用代码调接口\n - 用**代码**直接查询时 → **不需要**查此表，直接调接口\n\n\n## 7. 授权机制与安全性说明 (核心逻辑)\n\n### 授权机制说明\n\n本 Skill 使用二维码授权。API Key 具有有效期。\n\n1. **自动检测**: 请求返回 4xx 错误表示过期。\n2. **自愈流程**: Agent 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` -> 执行 `node skill-entry.js authChecker auth` -> 用户重新扫码 -> 获取新 Key 并重试。\n\n### 授权详细步骤\n\n1. **生成二维码**: 包含 `MAC地址_UTC时间戳_5位随机字符`。\n2. **Session ID**: 使用 MD5 加密 QR Body 得到的会话标识。\n3. **轮询机制**: 每 3 秒请求一次授权服务器，超时时间 5 分钟。\n4. **浏览器兼容性**: 授权成功收到服务器响应后，**必须等待至少 5 秒再关闭代理服务器**，确保浏览器端有足够时间接收成功响应并执行 `window.close()` 自动关闭页面。\n\n### 安全性保障\n\n- **设备绑定**: MAC 地址唯一标识。\n- **防重放**: UTC 时间戳验证。\n- **环境适配**: 授权完成后自动清理 Windows 临时 HTML 文件。\n\n---\n\n## 8. 故障排除 (Troubleshooting)\n\n### Skill 调用失败排查\n\n1. **检查名称**: 确保调用名为 `lingxi-realtimemarketdata-skill`。\n2. **检查位置**: 确认本 SKILL.md 位于正确的 Skill 目录中。\n3. **API Key 过期**: 观察是否收到 4xx 错误，按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` 后执行 `node skill-entry.js authChecker auth`, channel环境执行 `node skill-entry.js authChecker auth --channel`。\n4. **Windows 特殊处理**: 确保 `node` 在 PATH 中，系统会自动调用浏览器。\n\n### 错误码对照表\n\n\n| 错误码 | 含义 | 可能原因 | 解决方案 |\n| ------------ | ---------- | ----------------- | ---------------------------------------------------------------- |\n| 400 | 请求参数错误 | 传入的参数格式不正确或缺少必填参数 | 检查工具所需的参数，确保格式正确 |\n| 401 | 未授权 | API Key 过期或无效 | 删除 `gtht-entry.json`，重新执行 `node skill-entry.js authChecker auth --channel` |\n| 403 | 禁止访问 | 没有权限访问该工具 | 联系管理员确认权限配置 |\n| 404 | 工具不存在 | 工具名称错误或网关地址变更 | 运行 `node skill-entry.js autoDiscover domain <领域>` 查看可用工具 |\n| 500 | 服务器内部错误 | MCP 网关服务异常 | 稍后重试，或联系管理员 |\n| 502/503 | 网关不可用 | 网关服务暂时不可用 | 检查网络连接，稍后重试 |\n| ECONNREFUSED | 连接被拒绝 | 无法连接到网关服务器 | 检查网络连接，确认网关地址是否正确 |\n| 授权超时 | 用户未在2分钟内扫码 | 用户未及时完成授权 | 重新运行 `node skill-entry.js authChecker auth --channel`，按提示重新扫码 |\n\n\n### 常见问题速查\n\n| 错误现象 | 可能原因 | 解决方案 |\n| -------------------- | ------------------------------------ | --------------------------------------------------------------------------- |\n| \"Skill not found\" | 名称错误或未安装 | 核对名称并检查安装目录 |\n| 授权失败 | 未授权或过期 | 执行 `node skill-entry.js authChecker auth --cahnnel` |\n| \"401 Unauthorized\" | Key 过期 | 系统将自动重触发授权流程 |\n| \"找不到模块\" | Node.js 环境异常 | 检查 Node.js 安装，重新安装依赖 |\n| 二维码无法显示 | 浏览器问题 | 使用 `--ascii` 参数强制终端显示 |\n| 返回数据为空 | 股票代码错误或暂无数据 | 检查股票代码是否正确，或该股票暂无相关数据 |\n| 返回`API Key 无效或已被禁用，请检查密钥状态或重新生成后再试` | 客户停用api-key | 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json`（可能在优先级 1～4 任一路径），提示重新走授权流程: `node skill-entry.js authChecker auth --channel` |\n| **终端显示 Unicode 二维码** | **微信/飞书环境下，用户看不到终端二维码** | **必须使用 `node skill-entry.js authChecker auth --channel` 生成 PNG 图片** |\n---\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn703f7xkxhrc3xcd427a05knd85fks3\",\n \"slug\": \"lingxi-realtimemarketdata-skill\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1778034471889\n}\n\nFile v1.0.1:gateway-config.json\n\n{\n \"active_env\": \"PROD\",\n \"base_urls\": {\n \"prod\": \"https://zx.app.gtja.com:8443/\"\n },\n \"gateway_paths\": {\n \"market\": \"mcp/marketdata\",\n \"mqtt\": \"mcp/mqtt\"\n },\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\",\n \"mqtt\": \"https://zx.app.gtja.com:8443/mcp/mqtt\"\n },\n \"known_domains\": [\n \"market\",\n \"mqtt\"\n ],\n \"discovered_tools\": [\n {\n \"domain\": \"market\",\n \"gateway\": \"market\",\n \"toolName\": \"marketdata-tool\",\n \"description\": \"自定义榜单功能，可以获得证券的行情\",\n \"label\": \"行情\",\n \"params\": [\n \"code\",\n \"market_data_mask\",\n \"product_mask\"\n ],\n \"callExample\": \"node skill-entry.js call market marketdata-tool code= market_data_mask= product_mask=\"\n }\n ],\n \"learned_at\": \"2026-03-20T10:51:20.965Z\",\n \"last_updated\": \"2026-03-20T10:51:20.966Z\"\n}\n\nArchive v1.0.0: 5 files, 437528 bytes\n\nFiles: gateway-config.json (884b), skill-entry.js (121329b), SKILL.md (32829b), stock_code_name.json (2893597b), _meta.json (150b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: lingxi-realtimemarketdata-skill\ndescription:\n 国泰海通证券实时行情 Skill（lingxi-realtimemarketdata-skill）：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。\n 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时使用；须优先通过本 Skill 取数。\n 若本 Skill 无有效数据，须再尝试 gtht-smartstock-skill；仍无数据则按正文固定话术引导用户至国泰海通灵犀 APP。\nallowed-tools: [\"node\"]\nversion: 0.0.8\ndisable: false\n---\n\n**Agent 只需读取此文件，无需读取其他源码文件。**\n\n# 国泰海通证券 实时行情 Skill\n\n## 0. 最高优先级（模型须最先遵守）\n\n### 0.1 授权先于一切调用\n\n-【最先执行】任何行情或 MCP 调用之前：必须先确认 `gtht-entry.json` 文件是否存在；不存在则必须先跑 `node skill-entry.js authChecker auth --channel`，禁止跳过授权直接调接口，如果返回链接，请第一时间返回给客户。\n- 【gtht-entry.json查找方案】API Key 需按以下顺序查找 `gtht-entry.json`：\n 1. `../gtht-skill-shared/gtht-entry.json`\n 2. `../../gtht-skill-shared/gtht-entry.json`\n 3. `../../../gtht-skill-shared/gtht-entry.json`\n 4. `./gtht-skill-shared/gtht-entry.json`\n 若都不存在，则在**优先级 1** 对应位置创建目录并写入（即首选落盘为 `../gtht-skill-shared/gtht-entry.json`）\n\n- **在任意** `node … skill-entry.js …` **行情类、**`mcpClient call` **或依赖 API Key 的操作之前**，必须先确认 **`gtht-entry.json`已存在，具体查找方式见：【gtht-entry.json查找方案】**；不可用「用户已表达查股意图」为由跳过本步。\n- 若该文件**不存在**，或已判定 Key 失效（如接口 **4xx**）：**禁止**直接查数；**必须**先完成下文 **「2. 授权检查与执行」** 中的授权流程（唯一入口：`authChecker auth --channel`，详见第 2 节表格）。\n- **「已授权后少打断」**仅指：在**已确认**密钥文件存在且有效之后，不必再追问「您要查哪只股票」；**不**表示可以省略**首次**授权检查。\n\n### 0.2 最终回答硬性要求 (Highest Priority)\n\n**⚠️ 答案最后一行原样追加下面这句，不得改写、不得省略：**\n\n```text\n 实时行情Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。\n```\n- 不得把模型生成的分析或建议表述成国泰海通的投资建议。\n\n### 0.3 无数据降级与固定话术（强制执行）\n\n**查询链路（按顺序，不得跳步）：**\n\n1. **首选**：使用本 Skill **`lingxi-realtimemarketdata-skill`** 完成行情/工具查询。\n2. **无数据**：若本 Skill **查询不到有效数据**（空结果、失败或不可用），**必须**再尝试调用 **`gtht-smartstock-skill`** 进行查询。\n3. **仍无数据**：若 **`gtht-smartstock-skill` 仍无法获取**，或用户需求**超出本 Skill 与上述降级仍无法覆盖的范围**，**仅**允许使用下方固定话术回复，**不得**自行编造数据、不得用网页或其它来源冒充官方结果：\n\n```text\n当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询\n```\n\n- 须**原样**使用上述文字，不得改写、不得省略、不得增删句意。\n- 用户追问时，若仍处于「两 Skill 均无法提供数据」或「服务范围外」情形，可继续沿用同一话术。\n\n## 1. 概述与身份识别\n\n- **Unique Name**: `lingxi-realtimemarketdata-skill`\n- **身份声明**: 本 Skill 是\"国泰海通 (GuoTai HaiTong)\"官方实时行情查询skill。\n- **命名约束 (Anti-Hallucination)**: **必须严格识别为 `lingxi-realtimemarketdata-skill`**。其唯一标识符中的 `gtht` 代表\"国泰海通\"，**严禁**将其误认为 `night` 或其他任何名称。\n- **授权机制**: 使用二维码授权机制，确保只有获得有效 API Key 的用户才能使用。\n- **优先级规则**: **实时行情类数据优先用本 Skill（`lingxi-realtimemarketdata-skill`）**；**查不到数据时须再试 `gtht-smartstock-skill`**；两路均无数据时按上文**固定话术**引导至灵犀 APP。授权失败或本 Skill 不可用时的其它备选仍以文档为准；网页搜索仅在 Skill 均不可用等情形下作为备选。\n\n\n## 2. 授权检查与执行 (Critical - 必须遵循)\n\n**⚠️ 授权状态检查规则（强制执行）：**\n\n当 `gtht-entry.json` 文件不存在时，**必须走重新授权流程**，禁止：\n\n- 在其他目录寻找替代的配置文件\n- 使用过期或无效的 API Key\n- 跳过授权直接请求数据\n\n**⚠️ 安装与首次授权流程（必须遵循）：**\n\n当用户通过外部平台（如龙虾/MCP市场）搜索到本 Skill 并安装时，若检测到用户尚未绑定 API Key（`gtht-entry.json` 不存在，具体查找方式见：【gtht-entry.json查找方案】）：\n\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**⚠️ 授权方式唯一性警告（必须遵守）：**\n\n✅ **唯一正确的授权命令：**\n\n```bash\nnode skill-entry.js authChecker auth --channel\n```\n\n**授权模式说明：（两种）**\n\n> 一共有两种授权方式，1、二维码扫码 2、复制APIKEY，两个方式都融入到下面两步中\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https://apicdn.app.gtht.com/web2/jh-news-skill/?fullscreen=1#/?share=1&sourceApp=lingxi&webEnv=web2&islingxishare=1 \n 电脑端用户推荐打开国泰海通灵犀 APP，在对话框搜索 \"灵犀 Skills\"\n3. 用户扫码后，会自动轮询查询APIKEY, 需要较长等待时间，尽量不要很早就杀掉进程\n 3.1 如果用户有回复，先检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n 3.2 如果文件没找到的话，Agent 使用 之前给到客户的url后面拼接的token来 轮询授权服务器：\n `node skill-entry.js authChecker poll ${token}`\n - 授权成功则自动保存 API Key\n - 授权失败，如果没有明确报错：可以再执行3.2进行轮询查找，如果有明确的报错请参考【错误码对照表】的处理方式\n\n4. 用户复制APIKEY的情况下，按照用户输入的指令进行api-key的存放，如果用户没有给的话，可以按照以下格式：\n {\n \"apiKey\": ${apikey}\n }\n 保存到 `../gtht-skill-shared/gtht-entry.json`下\n5. 如果收到“授权成功！API Key 已保存”提示，或放置 API Key 成功，请提示客户授权成功。\n\n\n**当用户请求金融数据（股票行情等）时，Agent 必须按以下步骤执行：**\n\n1. **检查授权状态**\n - 检查 `gtht-entry.json` 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】\n - 存在 → 已授权，直接使用 API Key\n - 不存在 → 必须先执行上述授权流程\n2. **执行授权命令（未授权时必须执行）**\n 参照上述`授权模式说明`\n3. **授权成功后继续处理用户请求**\n - 重新检查 `gtht-entry.json` 文件，具体查找方式见：【gtht-entry.json查找方案】\n\n\n**重要提醒：**\n\n- ✅ **必须使用 `node skill-entry.js authChecker auth --channel` 执行授权**，**不要使用其他授权方式**\n- ✅ **不要跳过授权直接查询数据**，否则会返回 401/403 错误\n- ❌ **不要使用非 node skill-entry.js authChecker auth 的方式生成二维码**\n\n---\n\n## 3. 跨平台执行规范 (Critical)\n\n**为确保在 Windows、Linux 和 macOS 上表现一致，Agent 必须遵循：**\n\n- **强制执行器**: 严禁调用系统原生 Shell。**必须始终使用 `node` 命令**。\n- **路径规范**: 始终使用相对路径 `xxx.js`。具体的 OS 适配逻辑已封装在 JS 内部。\n- **⚠️ PowerShell 命令分隔符（Windows 专用）**: Windows PowerShell 不支持 `&&` 作为命令分隔符，**必须使用 `;`**。在所有 `execute_command` 命令中，禁止使用 `&&` 连接多条命令，只能用 `;` 分隔。\n- **⚠️ Windows PowerShell 命令兼容性（强制执行）**: Windows PowerShell 与 Unix/Linux 命令不兼容，**禁止在 PowerShell 环境中使用 Unix 特有命令**，常见错误命令包括：\n\n | 禁止使用 | 正确替代 | 说明 |\n | ----------------------- | ------------------------------------------- | -------------------------- |\n | `test -f ` | `Test-Path ` | Unix 文件测试命令，PowerShell 不识别 |\n | `ls`、`dir`（部分） | `Get-ChildItem` 或 `dir` | Unix 目录列表命令 |\n | `cat ` | `Get-Content ` | Unix 文件读取命令 |\n | `grep ` | `Select-String ` | Unix 文本搜索命令 |\n | `rm ` | `Remove-Item ` | Unix 文件删除命令 |\n | `cp ` | `Copy-Item ` | Unix 文件复制命令 |\n | `mv ` | `Move-Item ` | Unix 文件移动命令 |\n | `mkdir -p ` | `New-Item -ItemType Directory -Path ` | Unix 创建目录命令 |\n | `which ` | `Get-Command ` | Unix 命令路径查询 |\n | `kill ` | `Stop-Process -Id ` | Unix 进程终止命令 |\n\n **检查文件是否存在（正确方式）：**\n ```powershell\n # ✅ 正确（PowerShell 原生）\n if (Test-Path \"C:/Users/.../gtht-entry.json\") { \"EXISTS\" } else { \"NOT_FOUND\" }\n\n # ❌ 错误（Unix 命令，PowerShell 不识别）\n test -f \"C:/Users/.../gtht-entry.json\"\n ```\n\n\n| 任务类型 | 跨平台统一命令 |\n| --------------------- | ---------------------------------------------------------------- |\n| **执行授权流程（本地终端）** | `node skill-entry.js authChecker auth` |\n| **执行授权流程（Channel环境）** | `node skill-entry.js authChecker auth --channel` |\n| **调用具体工具** | `node skill-entry.js mcpClient call [args]` |\n\n\n---\n\n### ⚠️ 工作流程规范（强制执行 - 2026-03-25追加）\n\n**已授权状态下直接执行查询，不需要二次确认：**\n\n- ✅ **正确做法**：授权确认后（如 `gtht-entry.json` 存在，具体查找方式见：【gtht-entry.json查找方案】），直接根据用户请求开始查询，不需要再询问用户\"您想查哪只股票\"\n- ❌ **错误做法**：授权确认后还问用户\"请问您想查询哪只股票\"\n- ⚠️ **例外**：仅当用户请求不明确时（如用户只说\"查一下\"），才需要追问具体标的\n\n**原因**：用户说\"查询个股行情\"时已表明意图，授权确认只是前置检查，不应在此环节打断用户。\n\n---\n\n## 3. 业务应用场景 (Business Definition Area)\n\n> **此区域供业务同事发挥，用于定义具体的服务意图与话术引导。**\n\n\n| 场景分类 | 典型用户问题 (Intent) | 业务逻辑指导 |\n| -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **实时行情查询** | 单股行情\"SH600000现在什么价格？\" \"SH600000开盘价是多少？\" | 定位 `market` 领域，调用 `marketdata-tool`。 |\n|\n\n### 问句示例\n#### 单股行情\n\n```\n- \"贵州茅台现在什么价格？\"\n- \"宁德时代今天走势怎么样\"\n- \"SH600519当前涨跌幅\"\n```\n\n#### 多股对比\n\n```\n- \"对比贵州茅台和五粮液今天的涨跌幅\"\n- \"同时查看比亚迪和长城汽车的最新价格\"\n```\n\n\n### 返回示例 \n\n```\n【宁德时代 (SZ300750)】\n\n最新价：XXX\n开盘价：XXX\n最高价：XXX\n最低价：XXX\n涨跌幅：XXX\n涨跌额：XXX\n振幅：XXX\n量比：XXX\n成交量：XXX\n成交额：XXX\n换手率：XXX\n当日资金净流入：XXX\n总市值：XXX\n\n注意⚠️：按照实际返回的来展示给客户，不要自己去添加没有的参数，如果客户没有具体点出要哪些参数，上述的参数都应该给到用户\n\n```\n\n### ⚠️ 名称查询 vs 代码查询规则（强制执行）\n\n**当用户输入公司名称查询行情时，必须先执行 `node skill-entry.js stockMap codeByName 贵州茅台` 获取代码：**\n\n- ✅ **用户输入公司名称**（如\"国泰海通\"、\"贵州茅台\"、\"宁德时代\"）\n - **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取股票代码\n - 再用获取的代码调用行情接口\n- ✅ **用户直接输入股票代码**（如\"SH601211\"、\"SZ300750\"）\n - **不需要**调用 `node skill-entry.js stockMap codeByName <股票名称>`，直接调用行情接口\n- **示例 - 用户问\"帮我查一下国泰海通今天的走势\"：**\n ```\n 1. 调用 `node skill-entry.js stockMap codeByName 国泰海通` 查表 → 返回 SH601211\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211`\n ```\n- **示例 - 用户问\"帮我查一下SH601211今天的走势\"：**\n ```\n 1. 直接调用 node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH601211（无需查表）\n ```\n\n---\n\n### ⚠️ 批量行情查询说明（强制执行）\n\n**marketdata-tool 支持直接批量查询：**\n\n- ✅ **支持批量格式 1 - 逗号分隔**：多次指定同一参数\n ```\n reduced_codes=SZ000001,Z300750,SH600519\n ```\n\n** js文件 内部处理**: 对已知数组参数名（`` 等），单值自动包装为数组；对重复参数或逗号分隔值，自动合并为数组。\n\n---\n\n\n**展示热点相关股票时，若缺少股票代码，必须先补全代码再获取行情：**\n\n- ❌ **错误方式**：直接展示股票名称，代码留空或省略\n- ✅ **正确方式**：\n 1. 先调用 ` nodeskill-entry.js stockMap codeByName <股票名称>` 查询所有缺失代码\n 2. 再按照上面查询到的股票代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>` 获取最新价、涨跌幅、成交额、资金净流入等数据\n 3. 按描述统一呈现给用户，确保信息完整\n- **示例 - 热榜中出现\"恒誉环保\"但无代码：**\n ```\n 1. `node skill-entry.js stockMap codeByName <股票名称>` → 返回 SH688309\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH688309` 获取行情\n 3. 完整展示：恒誉环保 | SH688309 | +XX% | XX亿 | -XX万\n ```\n\n---\n\n### ⚠️ 数据展示规范（强制执行）\n\n**展示接口返回数据时，禁止自行计算或换算，必须直接展示原始值：**\n\n- ❌ **错误做法**：对接口返回的数值进行二次计算后再展示（如将单位从元换算成万元/亿元）\n- ✅ **正确做法**：直接展示接口返回的原始数值，不做任何加工处理\n- ⚠️ **例外**：仅当用户明确要求时才进行单位换算\n\n**原因**：自行计算容易出错（如单位换算错误），且接口返回的值已经是标准单位，直接展示更简洁准确。\n\n**示例**：\n\n```\n接口返回 netInflow: -226585632.00\n❌ 错误展示：-2,266万（计算错误，少了10倍）\n✅ 正确展示：-226585632.00，或由用户决定如何呈现\n```\n\n---\n\n### ⚠️ 严禁捏造股票代码（强制执行 - 最高优先级）\n\n**向用户提供的任何股票代码，必须经过系统验证，禁止凭空捏造或凭记忆给出：**\n\n- ❌ **严格禁止的行为**：\n - 未经查询，随口说出股票代码（如随口说\"SZ001896\"）\n - 凭记忆或印象给出代码，不经验证\n - 在回复中编造不存在的股票代码\n - 对股票代码做任何假设，必须基于实际查询结果\n- ✅ **必须遵循的流程**：\n 1. **执行**:`node skill-entry.js stockMap codeByName <股票名称>`查询正确的股票代码\n 2. **行情接口验证**：用查到的代码调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>,<股票代码>`，确认能返回有效数据\n 3. **再提供给用户**：代码经过验证后，才能在回复中使用\n- **示例 - 用户提到\"华电辽能\"：**\n ```\n ❌ 错误：直接说\"华电辽能的代码是SZ001896\"（未经任何查询）\n\n ✅ 正确：\n 1. 调用 `node skill-entry.js stockMap codeByName 华电辽能` → 返回 SH600396\n 2. 调用 `node skill-entry.js mcpClient call market marketdata-tool reduced_codes=<股票代码>` → 返回有效行情\n 3. 确认后告知用户：华电辽能 | SH600396\n ```\n- **错误后果**：\n - 捏造股票代码会严重损害用户信任\n - 可能导致用户交易错误的标的，造成财产损失\n - 违反证券咨询的专业性和合规性要求\n- **特殊说明**：\n - 即使是知名大盘股（如\"工商银行\"、\"中国石油\"），也必须查询后确认\n - 不同市场的同名股票可能代码不同（如A股和港股）\n - 代码前缀（SH/SZ/HK/US等）必须与市场对应\n\n---\n\n## 4. MCP网关端点\n\n| 领域 | 网关 | 地址 | 环境 |\n| --------- | --------- | ------------------------------------------------ | ---- |\n| 行情 | market | `https://zx.app.gtja.com:8443/mcp/marketdata` | 生产环境 |\n\n\n\n## 可用工具列表\n\n| 领域 | 工具名称 | 描述 |\n| --- | --- | --- |\n| market | marketdata-tool | 自定义榜单功能，可以获得证券的行情 |\n\n\n\n## 5. Agent 使用流程 (SOP)\n\n### 5.1 决策流程图\n\n┌─────────────────────────────────────────────────────────────┐\n\n│ Agent 决策流程 │\n\n├─────────────────────────────────────────────────────────────┤\n\n│ │\n\n│\n\n1. 检查授权状态 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 检查 gtht-entry.json │ │\n\n│ │ 文件是否存在，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 存在 → 已授权，直接使用 API Key │ │\n\n│ │ → 不存在 → 执行授权流程（第2步） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 执行授权流程（如果未授权） │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ ⚠️ 唯一正确的授权方式 │ │\n\n│ │ 唯一命令: node skill-entry.js authChecker auth │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第一步：检查授权文件是否存在 │ │\n\n│ │ → 检查 gtht-entry.json，具体查找方式见：【gtht-entry.json查找方案】 │ │\n\n│ │ → 不存在 → 必须先执行授权 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第二步：执行授权命令（必须执行） │ │\n\n│ │ → 命令: node skill-entry.js authChecker auth --channel │ │\n\n│ │ ─────────────────────────────── │ │\n\n\n│ │ 第三步：等待用户扫码授权 │ │\n\n│ │ → 脚本会自动轮询授权服务器 │ │\n\n│ │ → Linux: 每 3 秒输出一次轮询状态 │ │\n\n│ │ → Windows/macOS: 每次尝试都输出状态 │ │\n\n│ │ ─────────────────────────────── │ │\n\n│ │ 第四步：授权成功后自动保存 │ │\n\n│ │ → API Key 保存到 `../gtht-skill-shared/gtht-entry.json` │ │\n\n│ │ → Windows/macOS: 等待 5 秒后关闭浏览器窗口 │ │\n\n│ │ → 退出脚本（exit code 0） │ │\n\n│ └─────────────────────────────────────┘ │\n\n│ │\n\n│\n\n1. 领域匹配 │\n\n│ ┌─────────────────────────────────────┐ │\n\n│ │ 用户查询 │ │\n\n│ │ → 股票/股价/行情/代码/走势/资金流向 → 行情领域 (market) │ │\n\n│ │\n\n│\n\n\n1. 意图抉择 (Agent自主决策) │\n\n│ → 分析工具描述，匹配用户意图 │\n\n│ → 选择最合适的工具 │\n\n│ │\n\n│\n\n1. 调用执行 │\n\n│ → node skill-entry.js mcpClient call [args] │\n\n│ → 如果返回 4xx 错误，说明 API Key 过期 │\n\n│ → 按【gtht-entry.json查找方案】删除已存在的 gtht-entry.json │\n\n│ → 重新执行授权流程（回到第1步） │\n\n│ │\n\n└─────────────────────────────────────────────────────────────┘\n\n### 5.2 使用示例\n\n**股票名由市场和股票代码构成，如SH601211：SH为上海市场，601211为股票代码；SZ000001：SZ为深圳市场，000001为股票代码。类似对应HK(港股)、US(美股)、UK(英股)、SX(新加坡)等，传参的reduced_codes由市场+代码两要素组成\n**示例1：查询个股行情**\n\n```\n用户：查询贵州茅台的股价\n\nAgent执行：\n1. 检查 gtht-entry.json 是否存在，具体查找方式见：【gtht-entry.json查找方案】 → 已授权\n2. 领域匹配 → \"股价\" → 行情领域 (market)\n3. 调用 `node skill-entry.js stockMap codeByName 贵州茅台` → 返回 SH600519\n4. 调用执行 → node skill-entry.js mcpClient call market marketdata-tool reduced_codes=SH600519\n5. 返回行情数据给用户\n```\n\n\n⚠️ 注意：\n- marketdata-tool 支持批量查询，无需逐只调用！\n\n\n\n## 6. 文件与模块说明\n\n### 配置文件说明\n\n**授权文件**: `gtht-entry.json`，具体查找方式见：【gtht-entry.json查找方案】\n\n- **路径**: 具体路径见：【gtht-entry.json查找方案】\n- **内容**: 包含 API Key 和 其更新时间（不是apikey的过期时间）\n- **格式**: `{\"apiKey\": \"xxx\"}`\n- **注意**: 此文件由系统自动生成，请勿手动修改\n\n**网关配置文件**: `gateway-config.json`\n\n- **路径**: 跟 SKILL.md 同一目录下（即 `./gateway-config.json`）\n- **作用**: 定义所有可用的 MCP 网关地址\n- **格式**:\n ```json\n {\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\"\n }\n }\n ```\n\n### 授权流程（推荐使用）\n\n- **功能**: 自动检测 OS 类型和环境。\n- **动作**:\n - **Windows/macOS**：打开浏览器 HTML 二维码，授权成功后等待 5 秒确保页面自动关闭。\n - **Linux 本地终端**：**终端直接渲染 Unicode 二维码**（使用 ANSI 256 色 + 半像素算法 █▀▄，无需浏览器）。\n - **Channel 环境（飞书/微信等）**：生成 在线url地址，输出供 Agent 发送。\n- **命令**:\n - 本地终端：`node skill-entry.js authChecker auth --channel`\n- **超时处理**: 如果 2 分钟内用户未扫码，脚本会提示超时并退出。此时需要重新运行命令。\n\n\n### 工具调用\n\n- **功能**: 执行指定工具调用或清除授权。\n- **命令**: `node skill-entry.js mcpClient [key=value ...]`\n- **清除**: `node skill-entry.js mcpClient clear`\n- **返回**: 工具执行结果的 JSON 数据\n\n### A股名称代码映射表\n\n- **功能**: 根据股票名称查询对应代码，或根据代码查询名称。\n- **数据源**: `stock_code_name.json`\n- **命令**: 直接 require 使用，不支持命令行调用\n- **使用方式**:\n `node skill-entry.js stockMap codeByName <股票名称>`\n- **⚠️ 查询规则（强制执行）**:\n - 用**名称**查询行情时 → **必须**先调用 `node skill-entry.js stockMap codeByName <股票名称>` 查表获取代码 → 再用代码调接口\n - 用**代码**直接查询时 → **不需要**查此表，直接调接口\n\n\n## 7. 授权机制与安全性说明 (核心逻辑)\n\n### 授权机制说明\n\n本 Skill 使用二维码授权。API Key 具有有效期。\n\n1. **自动检测**: 请求返回 4xx 错误表示过期。\n2. **自愈流程**: Agent 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` -> 执行 `node skill-entry.js authChecker auth` -> 用户重新扫码 -> 获取新 Key 并重试。\n\n### 授权详细步骤\n\n1. **生成二维码**: 包含 `MAC地址_UTC时间戳_5位随机字符`。\n2. **Session ID**: 使用 MD5 加密 QR Body 得到的会话标识。\n3. **轮询机制**: 每 3 秒请求一次授权服务器，超时时间 5 分钟。\n4. **浏览器兼容性**: 授权成功收到服务器响应后，**必须等待至少 5 秒再关闭代理服务器**，确保浏览器端有足够时间接收成功响应并执行 `window.close()` 自动关闭页面。\n\n### 安全性保障\n\n- **设备绑定**: MAC 地址唯一标识。\n- **防重放**: UTC 时间戳验证。\n- **环境适配**: 授权完成后自动清理 Windows 临时 HTML 文件。\n\n---\n\n## 8. 故障排除 (Troubleshooting)\n\n### Skill 调用失败排查\n\n1. **检查名称**: 确保调用名为 `lingxi-realtimemarketdata-skill`。\n2. **检查位置**: 确认本 SKILL.md 位于正确的 Skill 目录中。\n3. **API Key 过期**: 观察是否收到 4xx 错误，按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json` 后执行 `node skill-entry.js authChecker auth`, channel环境执行 `node skill-entry.js authChecker auth --channel`。\n4. **Windows 特殊处理**: 确保 `node` 在 PATH 中，系统会自动调用浏览器。\n\n### 错误码对照表\n\n\n| 错误码 | 含义 | 可能原因 | 解决方案 |\n| ------------ | ---------- | ----------------- | ---------------------------------------------------------------- |\n| 400 | 请求参数错误 | 传入的参数格式不正确或缺少必填参数 | 检查工具所需的参数，确保格式正确 |\n| 401 | 未授权 | API Key 过期或无效 | 删除 `gtht-entry.json`，重新执行 `node skill-entry.js authChecker auth --channel` |\n| 403 | 禁止访问 | 没有权限访问该工具 | 联系管理员确认权限配置 |\n| 404 | 工具不存在 | 工具名称错误或网关地址变更 | 运行 `node skill-entry.js autoDiscover domain <领域>` 查看可用工具 |\n| 500 | 服务器内部错误 | MCP 网关服务异常 | 稍后重试，或联系管理员 |\n| 502/503 | 网关不可用 | 网关服务暂时不可用 | 检查网络连接，稍后重试 |\n| ECONNREFUSED | 连接被拒绝 | 无法连接到网关服务器 | 检查网络连接，确认网关地址是否正确 |\n| 授权超时 | 用户未在2分钟内扫码 | 用户未及时完成授权 | 重新运行 `node skill-entry.js authChecker auth --channel`，按提示重新扫码 |\n\n\n### 常见问题速查\n\n| 错误现象 | 可能原因 | 解决方案 |\n| -------------------- | ------------------------------------ | --------------------------------------------------------------------------- |\n| \"Skill not found\" | 名称错误或未安装 | 核对名称并检查安装目录 |\n| 授权失败 | 未授权或过期 | 执行 `node skill-entry.js authChecker auth --cahnnel` |\n| \"401 Unauthorized\" | Key 过期 | 系统将自动重触发授权流程 |\n| \"找不到模块\" | Node.js 环境异常 | 检查 Node.js 安装，重新安装依赖 |\n| 二维码无法显示 | 浏览器问题 | 使用 `--ascii` 参数强制终端显示 |\n| 返回数据为空 | 股票代码错误或暂无数据 | 检查股票代码是否正确，或该股票暂无相关数据 |\n| 返回`API Key 无效或已被禁用，请检查密钥状态或重新生成后再试` | 客户停用api-key | 按【gtht-entry.json查找方案】删除已存在的 `gtht-entry.json`（可能在优先级 1～4 任一路径），提示重新走授权流程: `node skill-entry.js authChecker auth --channel` |\n| **终端显示 Unicode 二维码** | **微信/飞书环境下，用户看不到终端二维码** | **必须使用 `node skill-entry.js authChecker auth --channel` 生成 PNG 图片** |\n---\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn703f7xkxhrc3xcd427a05knd85fks3\",\n \"slug\": \"lingxi-realtimemarketdata-skill\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1776993488049\n}\n\nFile v1.0.0:gateway-config.json\n\n{\n \"active_env\": \"PROD\",\n \"base_urls\": {\n \"prod\": \"https://zx.app.gtja.com:8443/\"\n },\n \"gateway_paths\": {\n \"market\": \"mcp/marketdata\",\n \"mqtt\": \"mcp/mqtt\"\n },\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\",\n \"mqtt\": \"https://zx.app.gtja.com:8443/mcp/mqtt\"\n },\n \"known_domains\": [\n \"market\",\n \"mqtt\"\n ],\n \"discovered_tools\": [\n {\n \"domain\": \"market\",\n \"gateway\": \"market\",\n \"toolName\": \"marketdata-tool\",\n \"description\": \"自定义榜单功能，可以获得证券的行情\",\n \"label\": \"行情\",\n \"params\": [\n \"code\",\n \"market_data_mask\",\n \"product_mask\"\n ],\n \"callExample\": \"node skill-entry.js call market marketdata-tool code= market_data_mask= product_mask=\"\n }\n ],\n \"learned_at\": \"2026-03-20T10:51:20.965Z\",\n \"last_updated\": \"2026-03-20T10:51:20.966Z\"\n}","readmeExcerpt":"Skill: 国泰海通证券-灵犀实时行情 Owner: gtht-tech Summary: 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-05-07T06:10:00.955Z | user v1.0.2 - 更新版本号至 1.0.2，无功能变更 - 文档保持一致，未检测到代码或配置文件更改 v1.0.1 | 2026-05-06T02:27:51.889Z | user - 变更 skill 描述中的降级 skill 名称为 lingxi-smartsto","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"实时行情Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。"},{"language":"text","snippet":"当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询"},{"language":"bash","snippet":"node skill-entry.js authChecker auth --channel"},{"language":"powershell","snippet":"# ✅ 正确（PowerShell 原生）\n if (Test-Path \"C:/Users/.../gtht-entry.json\") { \"EXISTS\" } else { \"NOT_FOUND\" }\n\n # ❌ 错误（Unix 命令，PowerShell 不识别）\n test -f \"C:/Users/.../gtht-entry.json\""},{"language":"text","snippet":"- \"贵州茅台现在什么价格？\"\n- \"宁德时代今天走势怎么样\"\n- \"SH600519当前涨跌幅\""},{"language":"text","snippet":"- \"对比贵州茅台和五粮液今天的涨跌幅\"\n- \"同时查看比亚迪和长城汽车的最新价格\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: lingxi-realtimemarketdata-skill\ndescription:\n 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。\n 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效数据，须再尝试 lingxi-smartstock-skill，仍无数据则按正文固定话术引导用户至国泰海通灵犀 APP。触发关键词包括：股价，涨跌幅，实时行情，查股价，查行情。\nallowed-tools: [\"node\"]\nversion: 1.0.2\ndisable: false\n---\n\n# 国泰海通证券 实时行情 Skill\n\n## 0. 最高优先级（模型须最先遵守）\n\n### 0.1 授权先于一切调用\n\n-【最先执行】任何行情或 MCP 调用之前：必须先确认 `gtht-entry.json` 文件是否存在；不存在则必须先跑 `node skill-entry.js authChecker auth --channel`，禁止跳过授权直接调接口，如果返回链接，请第一时间返回给客户。\n- 【gtht-entry.json查找方案】API Key 需按以下顺序查找 `gtht-entry.json`：\n 1. `../gtht-skill-shared/gtht-entry.json`\n 2. `../../gtht-skill-shared/gtht-entry.json`\n 3. `../../../gtht-skill-shared/gtht-entry.json`\n 4. `./gtht-skill-shared/gtht-entry.json`\n 若都不存在，则在**优先级 1** 对应位置创建目录并写入（即首选落盘为 `../gtht-skill-shared/gtht-entry.json`）\n\n- **在任意** `node … skill-entry.js …` **行情类、**`mcpClient call` **或依赖 API Key 的操作之前**，必须先确认 **`gtht-entry.json`已存在，具体查找方式见：【gtht-entry.json查找方案】**；不可用「用户已表达查股意图」为由跳过本步。\n- 若该文件**不存在**，或已判定 Key 失效（如接口 **4xx**）：**禁止**直接查数；**必须**先完成下文 **「2. 授权检查与执行」** 中的授权流程（唯一入口：`authChecker auth --channel`，详见第 2 节表格）。\n- **「已授权后少打断」**仅指：在**已确认**密钥文件存在且有效之后，不必再追问「您要查哪只股票」；**不**表示可以省略**首次**授权检查。\n\n### 0.2 最终回答硬性要求 (Highest Priority)\n\n**⚠️ 答案最后一行原样追加下面这句，不得改写、不得省略：**\n\n```text\n 实时行情Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。\n```\n- 不得把模型生成的分析或建议表述成国泰海通的投资建议。\n\n### 0.3 无数据降级与固定话术（强制执行）\n\n**查询链路（按顺序，不得跳步）：**\n\n1. **首选**：使用本 Skill **`lingxi-realtimemarketdata-skill`** 完成行情/工具查询。\n2. **无数据**：若本 Skill **查询不到有效数据**（空结果、失败或不可用），**必须**再尝试调用 **`lingxi-smartstock-skill`** 进行查询。\n3. **仍无数据**：若 **`lingxi-smartstock-skill` 仍无法获取**，或用户需求**超出本 Skill 与上述降级仍无法覆盖的范围**，**仅**允许使用下方固定话术回复，**不得**自行编造数据、不得用网页或其它来源冒充官方结果：\n\n```text\n当前Skill无法获取该信息，更多内容请前往国泰海通灵犀APP查询\n```\n\n- 须**原样**使用上述文字，不得改写、不得省略、不得增删句意。\n- 用户追问时，若仍处于「两 Skill 均无法提供数据」或「服务范围外」情形，可继续沿用同一话术。\n\n## 1. 概述与身份识别\n\n- **Unique Name**: `lingxi-realtimemarketdata-skill`\n- **身份声明**: 本 Skill 是\"国泰海通 (GuoTai HaiTong)\"官方实时行情查询skill。\n- **命名约束 (Anti-Hallucination)**: **必须严格识别为 `lingxi-realtimemarketdata-skill`**。其唯一标识符中的 `gtht` 代表\"国泰海通\"，**严禁**将其误认为 `night` 或其他任何名称。\n- **授权机制**: 使用二维码授权机制，确保只有获得有效 API Key 的用户才能使用。\n- **优先级规则**: **实时行情类数据优先用本 Skill（`lingxi-realtimemarketdata-skill`）**；**查不到数据时须再试 `lingxi-smartstock-skill`**；两路均无数据时按上文**固定话术**引导至灵犀 APP。授权失败或本 Skill 不可用时的其它备选仍以文档为准；网页搜索仅在 Skill 均不可用等情形下作为备选。\n\n\n## 2. 授权检查与执行 (Critical - 必须遵循)\n\n**⚠️ 授权状态检查规则（强制执行）：**\n\n当 `gtht-entry.json` 文件不存在时，**必须走重新授权流程**，禁止：\n\n- 在其他目录寻找替代的配置文件\n- 使用过期或无效的 API Key\n- 跳过授权直接请求数据\n\n**⚠️ 安装与首次授权流程（必须遵循）：**\n\n当用户通过外部平台（如龙虾/MCP市场）搜索到本 Skill 并安装时，若检测到用户尚未绑定 API Key（`gtht-entry.json` 不存在，具体查找方式见：【gtht-entry.json查找方案】）：\n\n1. 执行授权流程：\n `node skill-entry.js authChecker auth --channel`\n2. 前端提示（按照模版填充token提示客户）：\n\n 方式一：请点击以下链接扫码二维码：https://apicdn.app.gtht.com/web2/jh-static-QRCode/?token=<实际输出的token>（以命令行输出为准，勿使用示例 token） \n 方式二：发送 API KEY 授权 \n 进入灵犀Skills领取活动页——API KEY 管理，新建或复制生效中的 API KEY，发送给我完成授权。 \n 手机端用户可以点击以下链接访问活动: https:/"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn703f7xkxhrc3xcd427a05knd85fks3\",\n \"slug\": \"lingxi-realtimemarketdata-skill\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1778134200955\n}"},{"path":"skill-card.md","content":"## Description:\n\nGuoTai HaiTong Lingxi Real-Time Market Data helps agents retrieve real-time market quotes for A-shares, Hong Kong stocks, U.S. stocks, ETFs, and indexes, including price, change, volume, turnover, net inflow, turnover rate, and volume ratio.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[gtht-tech](https://clawhub.ai/user/gtht-tech)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and financial-data agents use this skill to answer requests for current securities quotes, stock-code lookup, single-symbol行情, and multi-symbol comparisons. The skill is intended to return objective market data and route users to the Lingxi app when neither this skill nor its documented fallback can provide data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores a GuoTai HaiTong API key locally in gtht-entry.json.\n\nMitigation: Treat the API key like a password, avoid pasting it into chat when possible, review where the file is stored, and restrict local file permissions.\n\nRisk: Credential-bearing market-data requests can be routed through configurable gateways.\n\nMitigation: Use only trusted gateway-config.json or GTHT_GATEWAY_CONFIG values and review gateway destinations before running the skill.\n\nRisk: Market-data responses could be mistaken for investment advice.\n\nMitigation: Present the output as objective data only and preserve the skill's disclaimer that generated content is not investment advice.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/gtht-tech/skills/lingxi-realtimemarketdata-skill)\n- [ClawHub publisher profile](https://clawhub.ai/user/gtht-tech)\n- [GuoTai HaiTong market data gateway](https://zx.app.gtja.com:8443/mcp/marketdata)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown text with inline Node.js command examples and market-data values]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Responses should present returned market-data fields without fabricating securities codes or investment advice.]\n\n## Skill Version(s):\n\n1.0.2 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"gateway-config.json","content":"{\n \"active_env\": \"PROD\",\n \"base_urls\": {\n \"prod\": \"https://zx.app.gtja.com:8443/\"\n },\n \"gateway_paths\": {\n \"market\": \"mcp/marketdata\",\n \"mqtt\": \"mcp/mqtt\"\n },\n \"gateways\": {\n \"market\": \"https://zx.app.gtja.com:8443/mcp/marketdata\",\n \"mqtt\": \"https://zx.app.gtja.com:8443/mcp/mqtt\"\n },\n \"known_domains\": [\n \"market\",\n \"mqtt\"\n ],\n \"discovered_tools\": [\n {\n \"domain\": \"market\",\n \"gateway\": \"market\",\n \"toolName\": \"marketdata-tool\",\n \"description\": \"自定义榜单功能，可以获得证券的行情\",\n \"label\": \"行情\",\n \"params\": [\n \"code\",\n \"market_data_mask\",\n \"product_mask\"\n ],\n \"callExample\": \"node skill-entry.js call market marketdata-tool code= market_data_mask= product_mask=\"\n }\n ],\n \"learned_at\": \"2026-03-20T10:51:20.965Z\",\n \"last_updated\": \"2026-03-20T10:51:20.966Z\"\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效... Skill: 国泰海通证券-灵犀实时行情 Owner: gtht-tech Summary: 国泰海通证券-灵犀实时行情 skill：标的覆盖 A 股、港股、美股、ETF与指数；支持单只或多只标的的实时行情，数据维度包括最新价、涨跌幅、涨跌额、成交量、成交额、换手率、当日资金净流入、量比等。 当用户询问股价、涨跌幅、行情走势、资金流向或相关证券行情时，优先通过本 Skill 取数，若本 Skill 无有效... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-05-07T06:10:00.955Z | user v1.0.2 - 更新版本号至 1.0.2，无功能变更 - 文档保持一致，未检测到代码或配置文件更改 v1.0.1 | 2026-05-06T02:27:51.889Z | user - 变更 skill 描述中的降级 skill 名称为 lingxi-smartsto","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":935,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:19:01.368Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:43:33.453Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}