数数 Open API 连接器

概述

基于官方数数 URL 与**用户级 Token（userSecret）**连接数数（ThinkingData）平台，支持：

• 国内数数与海外数数两套环境，URL 不同
• 执行 SQL 查询并获取数据
• 用户级鉴权：每人使用自己的 userSecret，国内和海外需分别创建，不能共享

本 connector 不包含任何写死的 Token；调用时优先从环境变量 SHUSHU_OVERSEAS_USER_SECRET（海外）/ SHUSHU_DOMESTIC_USER_SECRET（国内）读取 userSecret。禁止向用户索取明文 token，若环境变量未配置，应提示用户自行在 shell 配置文件中设置。

本地取数鉴权规则

• 在本地 Codex、终端或分析仓库中执行数数查询时，直接使用本 connector。
• 国内项目读取 SHUSHU_DOMESTIC_USER_SECRET，海外项目读取 SHUSHU_OVERSEAS_USER_SECRET。
• 本地环境变量存在时，不调用 shushu-auth，不查询飞书 open_id，也不重新生成 userSecret。
• 环境变量缺失或失效时，明确报告对应变量问题；不要在对话或日志中输出、索取 userSecret。
• 只有飞书/OpenClaw 等需要按消息发送者身份动态生成凭证的非本地场景，才使用 shushu-auth。