前言¶

在 DSH web GUI 里，如果只把股票作为查询对象或自选股，看到的通常是自己手动维护的列表。对已经在同花顺投资账本里记录真实持仓的人，更直接的需求是把真实持仓盈亏放到当前工作界面里，减少来回切换页面。

下面介绍 DSH 插件 dsh-ths-holdings。它读取同花顺投资账本的真实持仓数据，在 DSH web GUI 右下角展示今日盈亏、上证指数和当日走势图，不需要手动添加股票。

这是什么¶

dsh-ths-holdings 是一个 DSH 插件，定位为“持仓盈亏悬浮卡片”。

• 插件名：dsh-ths-holdings
• 维护者：PM25000
• 许可证：MIT
• 解决的问题：自动同步同花顺投资账本中的真实持仓数据，在 DSH web GUI 中显示今日盈亏、上证指数和当日走势图。

这个插件不是简单的自选股工具，它读取的是真实持仓和盈亏数据。

核心功能¶

已核实的功能包括：

• 实时持仓盈亏：默认每 20 秒轮询一次，可从真实投资组合获取数据。
• 今日盈亏显示：可显示元金额、百分比或两者。
• 当日走势图：带零轴的迷你折线，遵循红涨绿跌。
• 上证指数：与盈亏一起展示。
• 多账户支持：自动发现 fund_key，支持从投资组合列表下拉选择。
• 自动获取 Cookie：一键弹出系统浏览器登录窗口，并自动保存 Cookie。
• 保存时校验：粘贴或自动获取后立即校验 Cookie 是否有效。
• 可拖动：沿右侧边缘垂直拖动标题栏，位置保存在 localStorage。
• 卡片内设置：可在卡片中粘贴 Cookie 并选择投资组合。
• 凭证安全：Cookie 不离开宿主进程。

另外，插件仅保留 10jqka 域名的 Cookie，且不以明文存储。

安装与启用¶

先确认运行环境。资料显示 Node 要求为：

^22.19.0 || >=24.0.0

安装到 DSH web profile：

dsh plugin --profile web add dsh-ths-holdings

安装完成后重启 web 服务：

dsh web

启动后，DSH web GUI 右下角会出现悬浮卡片。

典型用法¶

自动获取 Cookie¶

推荐先使用自动获取流程：

1、打开 DSH web GUI。

2、打开卡片设置，选择「自动获取 Cookie（推荐）」。

3、在弹出的系统浏览器窗口登录同花顺投资账本。

4、登录成功后，窗口自动关闭，Cookie 自动保存，卡片刷新持仓。

5、如果存在多个投资组合，从下拉框中选择目标投资组合。

自动获取窗口包含反自动化伪装，用于通过同花顺 WAF。如果页面遇到 WAF 或 Nginx forbidden，可以在窗口按 F5，或手动打开：

https://tzzb.10jqka.com.cn

登录后点击「我已登录，继续 →」。

手动粘贴 Cookie¶

如果自动获取失败，可以手动粘贴：

1、打开同花顺投资账本网页并登录：

https://tzzb.10jqka.com.cn

2、打开浏览器开发者工具，在 F12 Console 中执行：

copy(document.cookie)

3、回到 DSH 卡片设置，将 Cookie 粘贴到配置项：

STOCK_PNL_COOKIE

4、保存。

插件保存后会立即校验 Cookie，显示有效或无效状态。

Cookie 过期处理¶

会话 Cookie 会过期。过期后卡片会显示 Token 已过期，需要重新自动获取，或手动粘贴新的 Cookie。

持仓数据更新¶

完成新交易后，从投资账本 app 重新上传数据到网页版，以保持持仓一致。

适用场景与注意¶

适合已经使用同花顺投资账本，并且希望在 DSH web GUI 中查看真实持仓盈亏的 DSH 用户。

使用前注意：

• 该插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• Cookie 是会话凭证，会过期，过期后需要重新获取或手动粘贴。
• 本文功能描述基于已核实资料；资料末尾存在截断，可能还有未列出的能力、依赖或限制。

链接¶

GitHub：

https://github.com/PM25000/dsh-ths-holdings