DolphinDB 初始化技能#

🎯 套件角色#

这是 DolphinDB Skill 套件的前置依赖技能。

所有 DolphinDB 相关技能在执行前都必须先调用此技能：

text

任何 DolphinDB 请求
    ↓
[必须] dolphindb-init ← 你在这里
    ↓
环境检测 ✓
    ↓
调用功能技能
    ├─ dolphindb-core（连接、读写）
    └─ dolphindb-query（查询、分析）

触发条件#

任何时候 用户提到 DolphinDB 并需要操作：

• "连接 DolphinDB"
• "查询 DolphinDB 数据"
• "在 DolphinDB 中建表"
• "DolphinDB 性能分析"
• 任何 DolphinDB Python SDK 相关操作

核心流程#

1. 环境检测（必须第一步）#

bash

# 加载环境检测器
source ~/.openclaw/skills/dolphindb-init/scripts/load_dolphindb_env.sh

# 查看环境信息
dolphin_env_info

# 使用统一的 Python 调用函数
dolphin_python your_script.py

2. 检测逻辑#

检测脚本按以下顺序扫描：

1. conda 环境列表 → 检查每个环境的 pip list，查找 dolphindb

2. Anaconda/Miniconda 路径 → 检查 $CONDA_BASE_1, $CONDA_BASE_2 等

3. 系统 Python 环境 → 检查 $SYS_PYTHON_1, $SYS_PYTHON_2 等

4. 决策：

   • 找到已安装 → 导出环境变量 DOLPHINDB_PYTHON_BIN
   • 未找到 → 自动安装到 Python 3.13 环境

3. 环境变量#

加载后可用的环境变量：

bash

$DOLPHINDB_PYTHON_BIN    # Python 二进制路径（统一调用入口）
$DOLPHINDB_SDK_VERSION   # DolphinDB SDK 版本
$DOLPHINDB_PYTHON_VER    # Python 版本
$DOLPHINDB_ENV_PATH      # 环境路径

4. 统一调用方式#

bash

# 运行 Python 脚本
dolphin_python script.py

# 安装包
dolphin_pip install package_name

# 直接使用环境变量
$DOLPHINDB_PYTHON_BIN script.py

示例：DolphinDB 连接#

python

import dolphindb as ddb

# 创建连接
s = ddb.session()
s.connect("localhost", 8848, "admin", "password")

# 执行查询
result = s.run("select * from trade where date=2024.01.01")
print(result)

# 关闭连接
s.close()

使用加载器运行：

bash

source ~/.openclaw/skills/dolphindb-init/scripts/load_dolphindb_env.sh
dolphin_python connect_dolphindb.py

隐私保护#

所有路径都用变量符号表示，不暴露具体系统地址：

变量名含义$CONDA_BASE_1第一个 anaconda/miniconda 路径$CONDA_BASE_2第二个 anaconda/miniconda 路径$SYS_PYTHON_1第一个系统 Python 路径$PY13_CANDIDATE_1Python 3.13 候选路径

故障排除#

问题 1: 找不到环境#

bash

# 手动运行检测脚本查看详细信息
bash ~/.openclaw/skills/dolphindb-init/scripts/detect_dolphindb_env.sh

问题 2: SDK 版本不兼容#

bash

dolphin_pip uninstall dolphindb
dolphin_pip install dolphindb==3.0.4.2

问题 3: Python 版本不是 3.13#

bash

# 检查当前环境
dolphin_env_info

# 强制安装到特定路径
~/anaconda3/bin/python -m pip install dolphindb

相关文件#

• scripts/detect_dolphindb_env.sh - 核心检测脚本，输出可 eval 的 export
• scripts/load_dolphindb_env.sh - 环境加载器，提供统一调用函数
• scripts/find_dolphindb_env.sh - 详细检测脚本（带完整输出）

套件关系#

• 本技能 - dolphindb-init（环境初始化，前置依赖）
• 核心操作 - dolphindb-core（连接、表操作、数据读写）
• 高级查询 - dolphindb-query（聚合、时间序列、数据分析）

注意事项#

1. 必须优先检测 - 不要假设 Python 环境已就绪
2. 使用统一接口 - 始终通过 dolphin_python 或 $DOLPHINDB_PYTHON_BIN 调用
3. 版本兼容 - 优先使用 Python 3.13 环境
4. 环境隔离 - 不同终端可能使用不同环境，必须每次检测
5. 套件前置 - 所有 DolphinDB 技能依赖此技能，必须首先执行