SuperAPI AI 工具集

gangtise-copilot

智能体与模型

查看项目

更新于 10-15 12:25

技能介绍

Gangtise Copilot 是岗底斯投研(Gangtise)OpenAPI 技能套件的包装层,提供一键安装、凭证配置与诊断能力。岗底斯是中国专业投研数据平台,其 OpenAPI 覆盖研究报告、公司公告、会议纪要、首席分析师观点、财务报表、估值指标、OHLC 行情数据、股东数据、行业指标以及预置研究工作流技能。底层 API 设计良好,但技能生态不易发现:没有公开清单列出 19 个技能,技能以独立 ZIP 文件分发在华为云 OBS 存储桶上且列表权限被禁用,并存在两套并行命名约定(gangtise-<name> 与 gangtise-<name>-client),功能集不同。首次使用者需先逆向梳理完整技能清单才能安装。

用途

Gangtise Copilot 解决上述发现与安装编排问题,主要用途包括:一键安装全部 19 个官方 Gangtise 技能到 Claude Code、OpenClaw 和 Codex;引导用户完成 accessKey + secretAccessKey 配置并执行实时鉴权调用;提供只读诊断脚本,报告已安装技能、凭证有效性与可达能力层级;提供预设安装模式(minimal / workshop / full),让安装规模与账户许可匹配。

主要能力

  1. 安装 Gangtise 技能:入口为 scripts/install_gangtise.sh。技能来自官方 OBS 存储桶 https://gts-download.obs.myhuaweicloud.com/skills/,无镜像。安装器下载 4 个归档(gangtise-skills-client.zip 160 KB、gangtise-research.zip 220 KB、gangtise-skills.zip 118 KB、gangtise-web-client.zip 8 KB),解压出 19 个技能目录,并软链接到检测到的智能体技能目录。其中 gangtise-file-client-no-download 和 gangtise-stockpool-client 仅存在于 gangtise-skills-client 包内,没有独立 ZIP。

  2. 配置凭证:入口为 scripts/configure_auth.sh。每个 Gangtise 技能需要与其 Python 运行时同目录的 .authorization 凭证文件,支持两种形式:accessKey + secretAccessKey(常见,自动刷新令牌)或 long-term-token(高级,预生成长效令牌)。包装层将共享文件存于 ~/.config/gangtise/authorization.json(XDG 标准,权限 600),并将每个技能的本地凭证文件软链接到该共享文件,轮换凭证只需编辑一个文件。配置器会提示输入凭证(或读取 GANGTISE_ACCESS_KEY / GANGTISE_SECRET_KEY 环境变量),写入共享文件,向 https://open.gangtise.com/application/auth/oauth/open/loginV2 执行实时鉴权验证,写入 ~/.GTS_AUTHORIZATION 运行时令牌,创建各技能本地凭证软链接,并报告鉴权服务器返回的 uid 与 userName。

  3. 诊断安装状态:入口为 scripts/diagnose.sh,严格只读。检查各智能体技能目录中 19 个技能的缺失情况、共享凭证文件是否存在且权限为 600、各技能本地凭证是否为指向共享文件的有效软链接、存储凭证是否通过实时鉴权调用、规范 RAG 端点是否响应最小查询(区分有匹配的成功响应、空成功响应、鉴权拒绝、权限拒绝、配额/权益响应、格式错误响应与网络失败,保留 HTTP 状态、API 代码、errorType 和 traceId,不打印凭证或完整令牌响应)。退出码:0 全部健康,1 存在需用户处理的问题,2 诊断本身失败。

  4. 技能注册表查询:帮助用户定位哪个 Gangtise 技能能回答特定数据问题,见 references/skill_registry.md。

使用方式

一键安装流程:第一步,将本技能下载到智能体技能目录(主方法为 git clone,备用方法为通过 GitHub API 直接下载文件);第二步,向智能体注册本技能(如 OpenClaw 创建软链接并在网关配置中启用);第三步,运行 bash <gangtise-copilot-dir>/scripts/install_gangtise.sh --preset full 安装全部 19 个技能;第四步,运行 bash <gangtise-copilot-dir>/scripts/configure_auth.sh --access-key <your-accessKey> --secret-key <your-secretAccessKey> 配置凭证;第五步,运行 bash <gangtise-copilot-dir>/scripts/diagnose.sh 验证安装;第六步,用真实查询测试。

安装预设:minimal(默认,3 个技能:gangtise-data、gangtise-file、gangtise-kb,通过公开 open-* 端点,覆盖 OHLC、财务、公告、外文报告与 RAG 检索);workshop(minimal 的别名,同样 3 个技能);full(全部 19 个技能,两套并行线,多数 -client 技能在账户缺少 skills-backend/* ACL 时运行时会失败);--only 自定义子集;--no-openclaw 跳过 OpenClaw;--target 强制单一目标。

凭证轮换:编辑 ~/.config/gangtise/authorization.json,然后运行 bash scripts/configure_auth.sh --verify-only 重新验证,无需改动其他文件。

适用场景

适用于需要将岗底斯投研 OpenAPI 技能套件安装到 Claude Code、OpenClaw 或 Codex 的用户;需要统一管理 19 个技能凭证的用户;需要诊断技能安装状态与凭证有效性的用户;需要按账户许可选择安装规模的用户。

限制

本技能是 Gangtise OpenAPI 技能套件的包装层,不包含任何上游技能内容的副本、分支或摘录,每次运行都从官方 OBS URL 重新下载。修改任何已安装的 gangtise-* 技能目录需通过 AskUserQuestion 获得用户明确同意。full 预设下多数 -client 技能在账户缺少 skills-backend/* ACL 时会运行失败,需先用诊断确认。安装后即使 ~/.config/gangtise/authorization.json 已存在,也应运行 configure_auth.sh,因为它会创建缺失的软链接。网络到 GitHub 可能不稳定,单文件失败可重试最多 3 次。诊断脚本的 OAuth 检查通过仅证明凭证能生成令牌,RAG 行单独报告可达性。