MiniBT Charts(VS Code 扩展)当前版本 0.3.12 · CHANGELOG · RELEASE_NOTES 安装渠道:
新入口(0.3.12)
依赖要求(0.3.12 起会检查)
版本不合格时启动看盘终端会弹「升级依赖 / 仍然继续 / 复制升级命令」,
不会闷着打开一个少一半界面的窗口 ✓。只画策略图表不检查 在 VS Code 编辑器页签里运行并查看 MiniBT
的图表 —— 图表、日志和代码在同一个页签组内按标签切换(默认不拆分页面,
不会把编辑区宽度减半);想要左右分屏可把
快速开始
它是怎么做到的
扩展在运行策略前接管
想强制一个引擎就设
扩展只看两类标记,非常直白:
看盘终端(minibt desk)
扩展就是起这个子进程、等
命令
编辑器标题栏会有一个 MiniBT 快速按钮(K 线图标),就在原生「运行 ▾」 按钮右边的同一行里(「运行」是独立图标,不占 VS Code 原生运行按钮 ✓); 图表页签自己则会出现「日志 / 刷新 / 停止」图标按钮。 在图表页里按 设置
看盘终端(
|
| 设置项 | 默认 | 说明 |
|---|---|---|
minibt.desk.account |
空 | 天勤账号(快期);留空 = 不连期货 |
minibt.desk.password |
空 | 明文兜底;推荐用命令「设置天勤密码」(加密存储)。优先级:SecretStorage → 环境变量 MINIBT_TQ_PASSWORD → 这里 |
minibt.desk.futuHost |
127.0.0.1 |
FutuOpenD 地址(Futu 客户端改过地址才需要改) |
minibt.desk.futuPort |
11111 |
FutuOpenD 端口 |
minibt.desk.stocks |
auto |
auto 检测到 FutuOpenD 就连 / on 总是连 / off 只看期货 |
minibt.desk.offline |
false |
离线演示(不连任何网关,只看界面 / 演示数据) |
minibt.desk.theme |
auto |
跟随 VS Code 配色,或固定 dark / light |
minibt.desk.autoStart |
false |
打开工作区就自动起(会常驻一个 Python 进程) |
minibt.desk.port |
0 |
本地服务端口;0 = 自动挑空闲端口 |
工作区示例(.vscode/settings.json):
{
"minibt.pythonPath": ".venv/Scripts/python.exe",
"minibt.desk.account": "你的天勤账号",
"minibt.desk.futuPort": 11111,
"minibt.desk.theme": "auto"
}
密码别写在这里(工作区设置会跟着仓库走)。用命令 「MiniBT: 设置天勤密码」存进加密存储,或设环境变量
MINIBT_TQ_PASSWORD。扩展传给子进程一律走环境变量,命令行 /ps里
$env:MINIBT_TQ_USER = '账号'
$env:MINIBT_TQ_PASSWORD = '密码'
启动前会体检:有账号 + 密码 → 期货(+ 股票);没账号但 FutuOpenD 通
(TCP 探 127.0.0.1:11111)→ 只连股票;都没有会弹提醒,让选
【输入天勤账号】【只连 Futu 股票】【进入离线演示】【打开设置】,
选过就记住,下次不再打扰 ✓。状态栏右侧的「MiniBT 看盘」会显示
● 期货+股票 / ○ 未启动,点一下就能起停。
建议在工作区设置里指定虚拟环境的解释器:
.vscode/settings.json→{"minibt.pythonPath": ".venv/Scripts/python.exe"}。 想让它自动找,就不要显式配 —— 扩展会依次试python.defaultInterpreterPath、py -0p列出的各版本、python/python3, 选第一个能import rich, pylightcharts的(minibt 的依赖齐)。
常见问题
图表页签一直白屏 / 提示"图表服务没起来"
- 打开
MiniBT输出面板看报错; - 确认
minibt.pythonPath的解释器里装了 minibt:python -c "import minibt; print(minibt.__version__)"; - 报
ModuleNotFoundError: No module named 'xxx'说明解释器选错了 —— 输出面板 会告诉你当前用的是哪个python.exe、缺哪个包,并给出可直接复制的"...\python.exe" -m pip install xxx;也可以直接把minibt.pythonPath指向装了 minibt 的那个解释器; - 确认策略里取数据用的是绝对路径或正确的工作目录(
minibt.cwd); - 换一个端口试试(
minibt.port)。
页签里看不到实时刷新 网页版是 SSE 推送、bokeh 是 server 推送,两者都是实时的;bokeh 的回测结果 本来就是一帧定格(静态 HTML),这是正常的。
bokeh 回测为什么是"快照"而不是活图? bokeh 的回测结果是一个静态 HTML 页面(没有 server),扩展会把它作为静态页签嵌 进来;回放/实时才是 bokeh server(活图)。
从源码开发
独立仓库(minibt-charts)的根目录就是扩展目录:
git clone https://github.com/MiniBtMaster/minibt-charts.git
cd minibt-charts
npm run package # 生成 minibt-charts-0.3.12.vsix
code --install-extension minibt-charts-0.3.12.vsix --force
日常调试:在 VS Code 里打开扩展目录按 F5,或直接用目录联接:
powershell -ExecutionPolicy Bypass -File link-dev.ps1
如果当前在 minibt 主仓库里,扩展源码位于 vscode-minibt/,把上面的
cd minibt-charts 换成 cd vscode-minibt 即可。
仓库结构
extension.js 扩展入口:命令 / webview / 子进程
desk.js minibt desk 启动参数、连接体检、状态栏逻辑
runner/vscode_runner.py Python 侧:启动策略 / 图表服务 / 停止进程
media/ 图标(扩展 / 运行 / desk,深浅两套)
package.json 清单:命令、快捷键、设置、VSIX 元数据
CHANGELOG.md 版本历史
RELEASE_NOTES.md 当前版本可粘贴到 GitHub Release 的正文
PUBLISHING.md VSIX / Marketplace / Open VSX 发布教程
GITHUB.md GitHub 首次上传 / tag / Release 流程
.github/workflows/ CI + 自动打包并挂 Release 的工作流
开发 / 打包 / 发布
见 PUBLISHING.md
(本地 VSIX 安装、F5 调试、发布到 Marketplace 全流程、常见报错表)和
GITHUB.md
(GitHub 首次上传、tag、自动 Release)。
本仓库 CI 会执行:
node --check extension.js
node --check desk.js
python -m py_compile runner/vscode_runner.py
npx --yes @vscode/vsce ls
完整 minibt monorepo 里还有 tests/test_vscode_extension.py,会校验清单/代码/
运行器三方一致(命令、设置项、打包白名单;并确认不再占用
editor/title/run ✓)。