dsh-ths-holdings

English | 中文

DeepSeek Harness（DSH）网页 GUI 上的持仓盈亏悬浮卡片。自动从同花顺投资账本同步你的真实持仓数据——无需手动添加股票。实时显示今日盈亏、上证指数和当日分时走势图，遵循 A 股红涨绿跌惯例。

与自选股盯盘工具不同，这个插件读取的是你的真实持仓，显示真实盈亏——百分比和金额都支持——每 20 秒自动刷新。

截图

安装

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

安装实际上是在 web profile 里执行 pnpm add：包的 dsh.bundle.patch 会自动并入 profile 层。然后重启 dsh web，右下角出现悬浮卡片。

不用 dsh plugin 手动安装：编辑 $DSH_HOME/profiles/web/package.json：

{
  "dependencies": {
    "dsh-ths-holdings": "^0.1.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        // ...原有 bundles，
        "dsh-ths-holdings"
      ]
    }
  }
}

然后 cd $DSH_HOME/profiles/web && pnpm install 并重启 dsh web。插件行由包的 cordis.patch.yml 提供，不需要手写。

使用

推荐方式（自动获取）：

1. 打开 DSH 网页 GUI，点击卡片上的 ⚙。
2. 点击 🖥 自动获取 Cookie（推荐）——会弹出系统浏览器窗口（Edge / Chrome，自动选择已安装者）。
3. 在弹出的窗口里完成同花顺投资账本登录（扫码 / 账号密码）。
4. 登录成功后窗口自动关闭，Cookie 自动保存，卡片立即刷新并显示你的持仓。
5. 插件自动发现你的组合——如有多个，从下拉框选一个即可。

自动获取的 Edge 窗口带有反自动化伪装（隐藏 navigator.webdriver、关闭 AutomationControlled 特性）以通过同花顺风控。若个别网络/时段下页面仍显示 Nginx forbidden，在弹出窗口里按 F5 刷新或手动访问 https://tzzb.10jqka.com.cn 即可，登录完成后点卡片上的「我已登录，继续 →」；Cookie 仅保留 10jqka 域字段，不会整段明文落盘。

手动方式（如偶尔需要）：

1. 打开 https://tzzb.10jqka.com.cn 并登录。
2. 按 F12 → 控制台，运行：

   copy(document.cookie)
   

3. Cookie 已复制到剪贴板。
4. 打开 DSH 网页 GUI，点击卡片上的 ⚙，把 Cookie 粘贴进 STOCK_PNL_COOKIE → 保存。
5. 保存后卡片会当场校验 Cookie——显示 ✓ 有效 或 ✗ 无效（无效会给出原因与提示）。

会话 Cookie 会过期——过期时卡片显示 Token 已过期 横幅，重开 ⚙ 点 自动获取（或重复手动步骤 1–4）即可（v 反爬令牌自动处理，无需关心）。

💡 完成一笔新交易后，请在投资账本 APP 上重新上传数据到网页版，避免两端持仓不一致。

特性

• 📊 实时持仓盈亏 — 每 20 秒（可配置）轮询你的真实组合
• ¥ / % 切换 — 今日盈亏可按金额、百分比或两者同时显示
• 📈 当日走势图 — 迷你折线 + 零轴虚线，红涨绿跌
• 🇨🇳 上证指数 — 与你的盈亏并列显示
• 🔄 自动发现 — fund_key 从组合列表自动获取；多账户可通过下拉框选择
• 🖥 自动获取 Cookie — 一键弹出 Edge 登录窗口，登录即自动保存，无需 F12
• ✓ 保存即校验 — 粘贴或自动获取后当场验证 Cookie 是否被账本接受
• ↕ 可拖动 — 沿右侧边缘上下拖动标题栏（位置存 localStorage）
• ⚙ 就地设置 — 粘贴 Cookie、选择组合，全在卡片上完成
• 🔒 凭据安全 — Cookie 始终留在宿主进程

工作原理

┌─────────────── Web 浏览器 ───────────────┐
│  lib/client.js（浏览器端模块）            │
│  · shell.overlay 槽位 → 悬浮卡片          │
│  · React + CSS Modules                    │
│  · 配置存 localStorage                    │
│          │ fetch（同源）                  │
└──────────┼────────────────────────────────┘
           ▼
┌─────────────── DSH 宿主（lib/index.js）──┐
│  cordis 插件：webServer 路由             │
│  · GET /api/stock-pnl          快照      │
│  · GET /api/stock-pnl/portfolios 账户列表 │
│  · GET /api/stock-pnl/verify    Cookie 校验 │
│  · POST /api/stock-pnl/acquire*  自动登录 │
│  通过 ctx.credentials 解析 Cookie        │
│  自动发现 user_id + fund_key             │
│  POST 同花顺账本 API                     │
└───────────────────────────────────────────┘

node 半区每次请求通过凭据引用通道（ctx.credentials）读取登录 Cookie——浏览器端永远看不到它。携带凭据的请求不跟随重定向。v 反爬令牌按 User-Agent 每次现算，存储的 Cookie 只需会话字段。

「自动获取 Cookie」走宿主进程内的 acquire.ts 状态机：点按钮 → 弹出反自动化的 Edge 窗口打开投资账本 → 检测到登录态（userid cookie）后自动收集该域 Cookie、写入凭据并关闭窗口；超时 / 用户关窗 / 页面被风控拦截都会在卡片上显示可操作提示。

配置

键	默认值	含义
cookieEnv	STOCK_PNL_COOKIE	存放账本 Cookie 的凭据引用。
fundKeyEnv	STOCK_PNL_FUND_KEY	存放组合 key 的凭据引用（从卡片 ⚙ 表单保存）。
user_id	Cookie 的 userid	账本用户 id，表单载荷中都会包含；为空时回退到 Cookie 自身的 userid。
fund_key	自动发现	选择所管理组合的账本 fund key；设置了 fundKeyEnv 凭据时覆盖，为空时从组合列表自动发现。
pnlUrl	同花顺 time_share 端点	盈亏端点覆盖（测试指向脚本化服务器）。
indexUrl	同花顺 getQuotes 端点	指数端点覆盖（测试指向脚本化服务器）。
pollMs	20000	卡片使用的轮询间隔（毫秒）；随每次响应的 poll_ms 上报给浏览器。

目录结构

dsh-ths-holdings/
├── src/
│   ├── index.ts            # node 半区：webServer 路由 + 凭据解析
│   ├── fetch.ts            # 同花顺账本 API 调用 + 自动发现 + Cookie 校验
│   ├── acquire.ts          # 自动获取 Cookie（playwright-core 驱动 Edge）
│   └── client/
│       ├── index.ts        # 浏览器半区：shell.overlay 注册
│       └── StockPnlCard.tsx
├── lib/                    # 构建产物（index.js + client.js）
├── cordis.patch.yml        # dsh.bundle 补丁层
├── package.json            # dsh.bundle + dsh.client 清单
├── tests/                  # 账本获取 / 校验 / 自动获取单元测试
└── README.md

FAQ / 故障排查

现象	原因与解决
卡片显示 请配置 Cookie	STOCK_PNL_COOKIE 为空——在 ⚙ 面板点「自动获取」或手动粘贴。
卡片显示 Token 已过期	会话 Cookie 过期——在 ⚙ 面板点「自动获取」重新登录，或手动重新 copy(document.cookie) 粘贴。
点「自动获取」提示缺少 playwright-core	playwright-core 未随包装入（通常是历史安装或手动剔除依赖导致）——重新 pnpm add dsh-ths-holdings（或 npm i playwright-core）后重启 dsh web 再试。
自动获取弹出窗口后没有反应	在弹出窗口完成登录（扫码 / 账号），登录后窗口会自动关闭并保存。
弹出窗口显示 Nginx forbidden	同花顺风控偶发拦截——在窗口里 F5 刷新或手动访问登录页重试；登录完成后点「我已登录，继续 →」。
保存后徽标显示 ✗ 无效	粘贴的 Cookie 已失效或不是投资账本会话——重新登录获取后再试；面板会给出具体原因。
下拉框没有组合	组合列表需要有效的 Cookie——先保存有效 Cookie，再点 ↻ 刷新。
有多个组合	从下拉框选一个——选择会保存为 STOCK_PNL_FUND_KEY。
粘贴的 Cookie 带换行	插件保存时会去掉空白，换行粘贴也没问题。

Model Experience

无——卡片是宿主数据路由上的浏览器端叠加层，不注册任何面向模型的内容。

KV Cache 影响

无——插件不贡献任何 prompt、schema 或结果。

已知限制

• 账本 API 是未公开的、需登录的端点 — 响应格式可能变化，Cookie 会过期；插件以错误呈现，而不是重试或缓存。
• 组合列表端点（account_list）需要先保存 Cookie — 粘贴有效 Cookie 后组合选择器才会出现。
• 自动获取复用系统浏览器 — 依赖随包安装的 playwright-core，自动选择已安装的 Edge / Chrome；机器上两者都没有时自动获取不可用（退化为手动粘贴），卡片会给出明确提示。
• 无服务端轮询 — 路由按请求拉取，卡片按配置的 pollMs 间隔轮询；没有共享缓存或推送通道。

License

MIT