前言¶
在 DeepSeek Harness（DSH）里做研究和写代码时，经常需要顺便看一眼持仓：个股现价、成本与盈亏、基金净值是否在更新。单独开交易客户端或再开一个浏览器标签，窗口之间来回切，数据和对话上下文是割裂的。持仓看板（dsh-portfolio）把 A 股实时行情、自选与预警、选股与快讯，以及 HPNY 在上游 SuCriss/dsh-leekbox 基础上新增的场外基金看板，收进 DSH web profile 左侧边栏的一个入口；行情请求由插件在本机代理，浏览器同源访问 /api/leekbox/*，只监听 loopback。公开行情接口开箱可用，一般不需要 API key（AI 个股分析除外，模型密钥由用户自行配置）。
下面介绍插件定位、核心能力、安装步骤和典型用法，并说明适用边界。
这是什么¶
持仓看板是 maintainer HPNY 维护的 DSH Web 客户端插件，仓库为 HPNY/dsh-portfolio，许可证 MIT；基于 SuCriss/dsh-leekbox 扩展，保留上游能力并新增基金子系统。形态上它不是独立 App，而是嵌在 AI 工作台里的标签页集群：看盘、选股、快讯、AI 分析与基金净值跟踪在同一窗口，服务端适配器在 lib/ 中可审计。
- 面向标的：沪深京 A 股、ETF / 场内基金、可转债、LOF；不含港股、美股、期货。
- 数据：腾讯财经、东方财富、新浪财经、金十等公开接口，由插件服务端抓取并标准化。
- 本机边界：写接口对跨站请求有 Origin / Content-Type 校验；密钥类配置仅落盘在服务端，界面显示脱敏值。
社区目录页：skillhub.cn 插件条目（分类：联网工具）。目录站为社区收录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
已核实能力按界面组织如下（装好后侧边栏为线框柱状图图标的「持仓看板」入口）。
大盘与情绪¶
上证 / 深成 / 创业板 / 科创50 等指数实时展示；交易时段内约 30～60 秒自动刷新。大盘页含市场情绪温度计（综合宽度、涨停强度、封板率、连板高度等维度），以及涨跌家数、涨跌停、炸板率等指标。
行情、搜索与龙虎榜¶
本地约八千只标的索引，支持代码、名称、拼音首字母毫秒级搜索。行情页提供多池榜单、板块榜与龙虎榜；龙虎榜按日期回溯到最近已发布交易日，不把「当日未发布」伪装成无数据。
自选、成本与价格预警¶
自选股支持分组；可填持仓成本并实时计算浮动盈亏与收益率。行内可设「涨到 / 跌破 / 涨跌幅达到」预警，交易时段自动盯盘，触发后 toast、浏览器通知与蜂鸣。数据持久化在 $DSH_HOME/.leekbox-watchlist.json、.leekbox-alerts.json，支持 JSON / CSV 导入导出。
选股与快讯¶
选股含技术信号加权评分与多策略交叉两种模式。快讯聚合新浪、东财、金十三源，跨源去重，重要资讯高亮。
AI 个股分析（可选）¶
服务端汇总实时行情、近 60 日 K 线与 F10 财务摘要后调用用户配置的模型，输出结构化中文分析。全局设置在面板头部；多服务商与模型列表，配置持久化在 $DSH_HOME/.leekbox-analysis.json。
场外基金（相对上游新增）¶
基金标签页跟踪场外基金净值与估值：成本与份额内联编辑，展示盈亏百分比、浮盈与历史净值曲线（叠加成本线），汇总基金市值与总浮盈。持久化在 $DSH_HOME/.leekbox-otc-fund.json；披露窗口内按文档约定分段轮询，详见仓库 docs/otc-fund.md。
交易时段与请求治理¶
交易日历由指数日 K 反推，非简单「周一至周五」；非交易时段与页面不可见时客户端停止无效轮询。热路由走 TTL 缓存与 in-flight 去重，上游抖动时可 stale-if-error。可观测性：GET /api/leekbox/metrics、/health 等。
个股详情弹窗含分时、前复权 K 线、主力资金与 F10 摘要等，交互细节见 README「七个标签页」表格。
安装与启用¶
环境要求：DSH ≥ 0.1.1-rc.1、web profile。仓库已提交客户端 bundle，通过官方命令安装时无需本地构建，dsh plugin add 会处理 manifest 与 cordis 重组合。
一条命令安装到 web profile：
dsh plugin --profile web add github:HPNY/dsh-portfolio
装完后刷新浏览器，左侧边栏出现「持仓看板」入口。若日后发布 npm 包，README 说明命令可改为 dsh plugin --profile web add dsh-portfolio；当前无 npm 包，须使用 github: 前缀。
典型用法¶
1、按上面命令安装并刷新 DSH Web 界面。
2、在「自选」中添加标的并填写持仓成本，按需设置价格预警；交易时段保持页面在前台即可自动盯盘。
3、在「基金」中录入场外基金成本与份额，查看净值、估值徽标与解套进度曲线。
4、若使用「分析」页，先在全局设置中配置模型服务商与密钥（仅此功能需要自备 API key）。
5、开发本地副本时，可按 README 将仓库软链到 $DSH_HOME/profiles/web/node_modules/dsh-portfolio 后刷新（Windows 用 mklink /J，macOS / Linux 用 ln -s）。
适用场景与注意¶
适合谁：已在用 DSH web profile、希望在本机工作台内完成轻量看盘、持仓记账与基金净值跟踪的开发者或研究者；重视开源可自托管、数据链路可对照 lib/ 适配器阅读的场景。
安装前建议：插件以当前 DSH 进程权限运行，会代您请求第三方财经接口并读写 $DSH_HOME 下 .leekbox-*.json 等文件；安装前应浏览仓库源码与 MIT 许可证，并阅读 README 免责声明——数据仅供研究参考，不构成投资建议。
分类：社区目录将其归为「联网工具」，与本地纯文件类插件不同，会持续访问公网数据源（交易时段内尤为明显）。
结尾¶
持仓看板把 A 股实时行情、自选预警、选股快讯、可选 AI 分析与场外基金看板收到 DSH 同一侧边栏入口，适合不想在 AI 工作台与独立行情客户端之间来回切换的用户。进一步了解功能细节与常见问题，见 GitHub 仓库 README 与 SkillHub 目录页。
