dolphindb-tushare-check-envlisted
Install: claude install-skill dolphindb/DolphinX_Skill
# Tushare 数据导入 - 前置环境检查
检查 DolphinDB 服务端是否满足 Tushare 数据导入要求,并对可自动处理的问题执行修复或给出明确处理方式。
## 检查内容
| 检查项 | 说明 | 自动修复 |
| --- | --- | --- |
| `httpClient` 插件 | Tushare API 调用依赖 `httpClient::httpPost` | 尝试 `installPlugin` + `loadPlugin`;失败时引导手动安装 |
| `py` 插件 | Tushare API 部分数据调用(如pro_bar接口获取复权数据)依赖 `py::call`等 | 询问用户是否需要安装,如果需要直接引导用户手动安装 |
| `easy_tushare` 模块 | 按本次导入资产域检查 `easy_tushare::ts_init` 和对应资产域模块 | 缺失时只上传必需模块文件 |
## 执行要求
加载本文件后,立即从步骤 1 开始执行,不要额外确认。所有服务端操作都在 DolphinDB Web 平台中通过 `.dos` 脚本��模块上传完成。
## 执行步骤
### 1. 执行环境检查脚本
根据用户需要导入的资产域,先修改脚本顶部的 `dataDomains` 参数,再在 DolphinDB Web 平台执行:
```text
scripts/dolphindb-tushare-check-env.dos
```
示例:用户需要同时导入 `stock` 和 `index` 时:
```dos
dataDomains = ["stock", "index"]
```
脚本会输出结构化标记:
```text
[CHECK-ENV] HTTPCLIENT_STATUS: OK
[CHECK-ENV] HTTPCLIENT_STATUS: FIXED
[CHECK-ENV] HTTPCLIENT_STATUS: FAILED
[CHECK-ENV] PY_STATUS: OK
[CHECK-ENV] PY_STATUS: FAILED
[CHECK-ENV] MODULE_STATUS: OK
[CHECK-ENV] MODULE_STATUS: MISSING
[CHECK-ENV] REQUIRED_DOMAINS: [...]
[CHECK-ENV] REQUIRED_MODULES: [...]
[CHECK-ENV] ERROR: <详细错误信息>
```
处理规则:
1. `MODULE_STATUS=MISSING`:进入步骤 2 上传 `easy_tushare` 模块。
2. `HTTPCLIENT_STATUS=FAILED`:进入步骤 3 引导手动安装插件。
3. `PY_STATUS=FAILED`: 询问用户是否需要安装 py 插件,如有需要进入步骤 4 引导手动安装,且必须关注 4.1 注意事项部分内容。
4. 以上必需项状态均为 `OK` 或 `FIXED` 时环境就绪,结束流程。`PY_STATUS=FAILED` 且用户回复不需要 py 插件,也视为环境就绪,结束流程。
### 2. 上传 easy_tushare 模块
**目标:** 只把本次导入所需模块上传到 DolphinDB 服务端。所需模块由 `REQUIRED_MODULES` 输出决定,固定包含 `easy_tushare::ts_init`,并为每个资产域包含 4 个模块:`*_