前言¶

在 DeepSeek Harness（DSH）左侧快捷栏增加「模拟持仓」和「回测回放」两个入口，展示同花顺模拟账户总资产、可用资金、持仓市值、持仓浮盈，以及持仓列表、分钟/日线 K 线、MACD、资金流、五档盘口等。插件自动启动内置的 Python 服务，通过同源代理将数据转发给浏览器面板。

是什么¶

这是一个 DSH 客户端插件，用于在 DSH 左侧栏展示同花顺模拟账户和本地回测回放的数据。插件维护者为 zhangchenyuan21-create，通过同源 API 代理，将宿主插件启动的 Python 后端（ths_sim.dashboard_server）与浏览器前端连接起来，实现账户、持仓、K 线、资金流、盘口和回放回放的可视化。

核心功能¶

• 模拟持仓展示：总资产、可用资金、持仓市值、持仓浮盈；持仓列表包含名称/代码、持仓/可用、成本/现价、市值、浮盈。
• K 线图表：分钟 K 线（1/5/15/30/60 分钟）和日线，支持 MA5/MA10、MACD、成交量；日线支持 MA5/MA10、MACD。
• 资金流：今日主力/超大单/大单/中单/小单，近 5 日主力与超大单。
• 五档盘口：买卖五档价格、挂单量、价差。
• 回测回放：选择本地回测、日期区间和回放日期，查看权益曲线、回放持仓、逐笔交易和个股历史日线 K 线。

架构¶

插件通过以下层级组织数据流：

DSH 左侧栏入口 + 主面板（lib/client.js）
        |
        |  /ths-dashboard/api  （同源代理）
        v
宿主插件（lib/index.js）
        |
        |  启动并转发到 127.0.0.1:8766
        v
ths_sim.dashboard_server  （Python 后端，源码已随包放在 python/ths_sim）
        |
        +-- 同花顺模拟盘：账户 / 持仓 / 五档盘口
        +-- 新浪：分钟/日线 K 线，资金流
        +-- 腾讯：盘口与名称兜底

宿主插件会自动启动包内自带的 Python 服务；DSH 关闭时停止它。若服务没有启动，面板错误区会提示，也可以手动运行：

cd <package-root>
$env:PYTHONPATH = "$PWD\python"
python -m ths_sim.dashboard_server --port 8766

安装与启用¶

从 npm 安装：

dsh plugin --profile desktop add dsh-ths-dashboard

本地开发时用 link: 安装当前目录：

dsh plugin --profile desktop add "link:<this-directory>"

新增客户端 bundle 后需要重启 DSH 桌面客户端，左侧栏才会出现「模拟持仓」。

典型用法¶

• 安装插件后，左侧栏会出现「模拟持仓」和「回测回放」两个入口。
• 在「模拟持仓」面板中，查看总资产、可用资金、持仓列表、分钟/日线 K 线、MACD、资金流和五档盘口。
• 在「回测回放」面板中，选择本地回测目录、日期区间和回放日期，查看权益曲线、回放持仓、逐笔交易和个股历史日线 K 线。
• 回测目录通过用户目录 .ths_sim/dashboard.json 的 backtest_root 配置，或环境变量 THS_BACKTEST_ROOT：

{"backtest_root": "C:\\path\\to\\local_backtest\\out"}

适用场景与注意¶

• 适合需要在 DSH 中查看同花顺模拟账户和本地回测回放数据的开发者。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 当前只读展示，不下单；交易仍通过 ths_sim CLI 或后续策略执行器。
• 回测回放不提供历史分钟 K、逐笔盘口或 L2；这些数据无法从历史存档复原。
• Cookie 和账户号不会发送到浏览器面板，也不会出现在前端 JSON 中。

结尾¶

该插件在 DSH 中提供同花顺模拟持仓与本地回测回放的可视化能力，适合需要集成交易与回放数据的智能体开发者。更多信息与源码见：https://github.com/zhangchenyuan21-create/dsh-ths-dashboard