1. 为什么要在 VS Code 里把 Copilot 和 DolphinDB Skill 接起来如果你平时用量化脚本、时序数据处理大概率会遇到这种场景脑子里想的是「建一张 VALUEHASH 组合分区的 TSDB 表再灌 20 条模拟行情」手上却要翻文档确认createPartitionedTable的参数顺序、database函数的引擎写法。写一段几十行的 DolphinDB 脚本查文档的时间比敲代码还长。GitHub Copilot 本身能补全通用代码但它对 DolphinDB 这种相对垂直的时序数据库语法并不熟经常给你生成「看起来像 SQL 但跑不通」的东西。DolphinDB Skill 就是来解决这个问题的——它把 DolphinDB 的官方文档、最佳实践、脚本范式打包成一个 Agent Skill让 Copilot 在聊天和补全时能调用这套知识。再配合 TaoToken 的统一 Key 通道你就不用在不同 AI 服务之间来回切账号、换配置一个 Key 走通模型调用。这篇面向量化/数据分析开发者给出settings.json与config.toml骨架、TaoToken 统一 Key 接入步骤以及一次补全触发和 Skill 调用的验证动作。目标很直接减少环境切换把脚本编写效率提上来。适合谁看已经装了 VS Code、用过 Copilot、手上有 DolphinDB 环境本地或测试集群都行的人。如果你还没装 DolphinDB 扩展后面会顺带说一句但重点在 Skill 配置和 Key 接入。2. 前置准备DolphinDB Skill 与 TaoToken 通道先把两件事分清楚。DolphinDB Skill 是「知识包」负责让 AI 懂 DolphinDBTaoToken 是「通道」负责让你的 AI 请求走统一入口。两者不冲突可以叠加。2.1 装好三样东西第一VS Code 客户端这个不用多说。第二GitHub Copilot 扩展和 DolphinDB 扩展都在扩展市场搜名字装即可。第三DolphinDB Skill 本体下载后解压到指定目录。Skill 的目录层级必须严格否则 Copilot 找不到。正确结构是这样skills/ └── dolphindb_skill/ ├── assets/ ├── ... └── SKILL.md注意SKILL.md必须在dolphindb_skill/这一层不能多套一层文件夹。2.2 项目级还是个人级类型推荐路径兼容路径生效范围项目 Skill.github/skills/.claude/skills/仅当前项目适合团队共享个人 Skill~/.copilot/skills/~/.claude/skills/全局生效所有项目可用团队协作、要统一 Skill 版本就放项目根目录的.github/skills/。个人日常开发、不想每个项目重复配就放~/.copilot/skills/。我一般个人机用后者团队仓库用前者。2.3 TaoToken 统一 Key 的位置TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要先去控制台拿一个 Key后面在config.toml里填。拿 Key 的入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。注意TaoToken 是统一模型调用通道不是让你绕过任何本地环境。DolphinDB 本身还是跑在你自己的机器或集群上。3. 可复制配置settings.json 与 config.toml 骨架这一节是全文最该照着抄的部分。分两块VS Code 侧的settings.json以及 TaoToken 通道侧的config.toml。3.1 VS Code settings.json 骨架打开命令面板CtrlShiftP输入Preferences: Open User Settings (JSON)在打开的settings.json里加上 Copilot 相关配置。核心是启用 Agent Skills{ github.copilot.chat.agentSkills.enabled: true, github.copilot.chat.useAgentSkills: true, github.copilot.enable: { *: true, dolphindb: true }, files.associations: { *.dos: dolphindb } }github.copilot.chat.agentSkills.enabled是总开关useAgentSkills让聊天视图能识别/指令。files.associations把.dos脚本关联到 DolphinDB 语言模式补全上下文更准。如果你把 Skill 放在项目里还可以加一条工作区级别的设置指向项目 Skill 目录{ github.copilot.chat.agentSkills.paths: [ ${workspaceFolder}/.github/skills ] }3.2 TaoToken config.toml 骨架TaoToken 通道用config.toml管理模型接入。放在你的配置目录下比如~/.taotoken/config.toml骨架如下[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoTokenKey [model] default claude-sonnet fallback glm-4.7 timeout_seconds 60 [chat] stream true max_tokens 4096 temperature 0.2几个参数说明base_url固定填https://taotoken.net/api不要带 UTM 后缀api_key从控制台复制temperature写脚本建议压到 0.2 左右减少胡编语法fallback是主模型不可用时的兜底。提示config.toml里的 Key 不要提交到 Git。项目里用.gitignore排除或者用环境变量TAOTOKEN_API_KEY覆盖。3.3 让 Copilot 走 TaoToken 通道Copilot 默认走自己的服务但你可以通过 VS Code 的模型配置把自定义 provider 接进来。在settings.json里补一段{ github.copilot.chat.customProviders: [ { name: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, models: [claude-sonnet, glm-4.7] } ] }然后在终端里导出环境变量export TAOTOKEN_API_KEYsk-你的TaoTokenKeyWindows PowerShell 用$env:TAOTOKEN_API_KEYsk-你的TaoTokenKey这样 Copilot 聊天时就能选到 TaoToken 提供的模型Skill 调用和模型请求走同一条通道不用来回切账号。4. 验证请求补全触发与 Skill 调用配置写完不算完得验证两件事补全能不能触发Skill 能不能被/dolphindb调起来。4.1 验证 Skill 是否加载重启 VS Code打开 Copilot 聊天视图输入/看下拉列表里有没有dolphindb。如果能看到/dolphindb指令说明 Skill 目录层级和SKILL.md都没问题。如果没出现先检查目录~/.copilot/skills/dolphindb_skill/SKILL.md是否存在。再检查settings.json里agentSkills.enabled是否为true。两个都对还不行就重启一次窗口Developer: Reload Window。4.2 验证补全触发新建一个test.dos文件输入下面这行看 Copilot 是否给出补全建议login(admin, 123456)正常情况它会提示login的参数和用法。如果没反应检查files.associations是否把.dos关联到了dolphindb以及 Copilot 状态栏图标是不是正常没有报错叹号。4.3 验证 Skill 调用自然语言转脚本在聊天视图输入/dolphindb 帮我写一个创建 TSDB 存储引擎分区表的脚本采用 VALUEHASH 组合分区字段有 time, symbol, price生成 20 条模拟数据用标准 SQL 实现预期返回一段完整脚本类似db database(dfs://tsdb_demo, VALUE, 2024.01.01..2024.12.31, engineTSDB) pt db.createPartitionedTable( table(20:0, timesymbolprice, [TIMESTAMP, SYMBOL, DOUBLE]), tick, timesymbol, partitionTypeHASH, partitionScheme[SYMBOL, 10] )拿到脚本后直接在 DolphinDB 会话里跑一遍确认能建表、能插入。这一步跑通说明 Skill 的知识注入生效了。4.4 验证概念讲解再试一个纯知识类问题/dolphindb 解释一下 TSDB 和 OLAP 存储引擎的区别正常会返回一段带示例的对比说明。如果返回的是通用 SQL 解释、没提 DolphinDB 特性说明 Skill 没被调用回去查/dolphindb指令是否真的命中。5. 本篇常见错排查配置过程中最容易卡在几个点上我按出现频率排一下。5.1/dolphindb指令找不到九成是目录层级错了。SKILL.md必须在dolphindb_skill/正下方不能是dolphindb_skill/dolphindb_skill/SKILL.md。另外确认放的是~/.copilot/skills/而不是~/.copilot/skill/少个 s。5.2 补全不触发先看文件语言模式。右下角如果显示的是Plain Text点一下改成DolphinDB。再确认github.copilot.enable里dolphindb是true。还有一种情况是网络请求超时检查 TaoToken 的base_url有没有多写斜杠或 UTM 参数。5.3 TaoToken 请求 401api_key填错或过期。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个替换config.toml和环境变量。注意 Key 前后不要有空格。5.4 模型返回乱码或截断max_tokens太小。脚本类请求建议 4096 起步复杂流计算脚本可以调到 8192。timeout_seconds也适当放宽到 90。5.5 Skill 调用了但答案不对可能是 Skill 版本旧了。DolphinDB 语法更新较快去仓库拉最新版 Skill 覆盖。另外确认SKILL.md里的文档版本和你本地 DolphinDB 版本匹配。6. 把通道和 Skill 用顺手的几个入口配置跑通之后日常用起来其实就三件事拿 Key、调模型、写脚本。TaoToken 这边模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 需要长期跑编码任务或 Agent 的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。如果你用的是 Claude Code 那套工作流Anthropic 兼容入口在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 配置逻辑和本文的config.toml类似把base_url指过去就行。最后说个实际体会Skill 配好之后最省时间的不是让它从零写脚本而是「改脚本」。你贴一段报错的 DolphinDB 代码加/dolphindb问它哪里语法不对它结合官方文档给的修正往往比通用模型准得多。这个用法建议你配完立刻试一次比单纯生成新脚本更能感受到差别。
