dolphindb-tushare-importlisted
Install: claude install-skill dolphindb/DolphinX_Skill
# Tushare 数据导入 - DolphinX 版
将 Tushare Pro API 数据自动导入 DolphinDB 分布式数据库。本 skill 在 DolphinDB Web 平台中运行，全程使用 `.dos` 脚本。
## 执行要求
1. 加载本文件后，立即从步骤 1 开始执行，且必须按��指定流程执行。
2. 除非缺少必要参数或用户需要确认导入范围，不要额外中断流程。
3. 如果按流程执行报错，直接返回即可，不要做额外尝试。
4. 所有需要在服务端执行的内容均通过 DolphinDB Web 平台完成。
## 执行步骤
### 1. 收集导入参数
向用户确认或收集以下参数：
| 参数 | 是否必填 | 说明 |
| --- | --- | --- |
| `token` | 是 | Tushare Pro API token |
| `dataDomains` | 是 | 一个或多个数据域，例如 `["stock", "index"]` |
| `startDate` | 是 | 起始日期，转换为 DolphinDB `DATE`，例如 `2026.01.01` |
| `endDate` | 是 | 结束日期，转换为 DolphinDB `DATE`，例如 `2026.01.02` |
| `tableNamesByDomain` | 否 | 按数据域指定表名映射；空映射表示每个数据域导入全部表 |
若用户已在请求中提供所有必要参数，可直接使用，不要重复询问。若缺少必要参数，只询问缺失项。
### 2. 环境检查与模块准备
使用步骤 1 收集到的 `dataDomains` 调用 `dolphindb-tushare-check-env` skill，完成：
1. `httpClient` 插件检查和加载。
2. 只检查并上传本次导入需要的模块：`easy_tushare::ts_init`，以及每个数据域对应的 `*_init`、`*_create_table`、`*_load_data`、`*_schedulejob` 4 个模块。
3. `py` 插件检查；仅在用户需要依赖 `py` 插件的接口时必须安装。
判断逻辑：
- `dolphindb-tushare-check-env` 成功：继续步骤 3。
- `dolphindb-tushare-check-env` 失败：终止流程，并向用户展示 `dolphindb-tushare-check-env` 输出的错误信息。
### 3. 展示参数确认
执行前向用户展示：
```text
请确认以下 Tushare 导入参数：
- 数据域：{dataDomains}
- 日期范围：{startDate} ~ {endDate}
- 表名映射：{tableNamesByDomain 或 全部}
确认后将在 DolphinDB Web 平台执行导入脚本。
```
提供选项：
- 使用以上参数继续执行。
- 修改表名或日期范围。
- 取消。
### 4. 修改并执行导入脚本
根据确认参数修改：
```text
scripts/import_data.dos
```
需要改动的用户参数区：
```dos
token = "YOUR_TUSHARE_TOKEN"
dataDomains = ["stock"]
startDate = 2026.01.01
endDate = 2026.01.02
tableNamesByDomain =