dsh-stock-portfolio

dsh-stock-portfolio

对话是主要交互界面，面板只是必要时的管理入口。

在 DeepSeek Harness（DSH）里管理股票持仓：交易记录、盈亏统计、按日线保存的行情、离线代码检索与持仓复盘，全部落在本地 SQLite。覆盖 A 股（沪深京）、港股、美股，以及 ETF、指数、可转债。

三个入口，读写同一份数据：

• 侧边栏「股票持仓」（「设置」上方，右侧直接带当日盈亏）→ 管理面板。
• 对话里读数据、记交易、复盘：说「昨天买了 100 股腾讯」就写入，缺的字段当场弹一张问题卡片问；问「腾讯最近怎么样」「我在哪个动机上赚得多」时直接读本地 SQLite 回答；问「我的股票表现怎么样」会触发一次复盘（也可以直接敲 /portfolio-review）。读持仓、行情与聚合分析不用授权，读交易记录明细每次都会先弹一张授权卡片。
• 对话右侧栏「持仓提及」：对话里出现持仓标的的代码或名称时自动展开，列出它的走势与持仓统计。

界面只用 DSH 自己的主题变量（--dsw-alias-*），自动跟随浅色 / 深色主题。

_{截图仅为效果预览，不构成投资建议。}

面板

对话里提到持仓标的

对话里出现持仓标的的代码或名称时，右侧栏的「持仓提及」自己展开，一个标的一张卡片。

提及由一个会话投影折出：用户输入与助手回复都算，从磁盘恢复的历史会话在首次读取时把整段日志折一遍；浏览器每 2 秒问一次当前会话的状态（页面不可见时不问）。

在 chat 里读数据、记交易

同一个插件还向会话注册七个 Tool，读写同一份 SQLite：

读持仓、读行情、读聚合分析、读复盘都不打断用户；交易明细是唯一需要授权的读。

复盘

问「我的股票表现怎么样」就会做一次持仓复盘：一次给全当下的数——盈亏、波动、集中度、浮盈浮亏家数、行情陈旧度，同时给出一份未来约一个月的研究清单。

复盘分两半：数字由插件从本地日线与交易记录算出，不请求行情接口；未来一个月的走势与催化（行业竞争、券商预期 / 研报、业务进展、管理层变动、新闻）插件不抓，由对话里的模型用自己的搜索 / 抓取工具按清单逐只查，并标出信息日期与来源。

也可以走斜杠菜单的「复盘持仓」（/portfolio-review，想只看一只就直接打 /portfolio-review 腾讯控股）。

口径

• 只按日线。 每标的每交易日一行；估值用最新收盘价，「当日盈亏」对比前一日收盘价，界面上的价格永远带日期。
• 按需取数。 最新一根已是数据源能给的最后交易日时不发请求，落后的只补缺口（start_time = 上次更新次日）。新标的（含 chat 里刚记的）写入时当场取最近 90 天。
• 成本与盈亏不含手续费：移动加权平均，卖出按摊薄成本结转并锁定已实现盈亏。
• 汇率一天取一次，基准货币默认人民币，也可在设置页手动覆盖。
• 数据源与代码索引：不填 Key 也能用（免费端点提供日线），Key 的优先级为设置 > 环境变量 > .env > 插件行，设置页只回传「已配置 / 未配置」。

安装

插件是标准的 DSH bundle + dual-face client，按普通插件安装（插件管理器或 CLI 是同一套）：

npm install && npm run build
dsh plugin --profile web add <checkout 的绝对路径>

也可以在 Web 侧边栏的 插件 页安装（插件页显示的就是本包的 logo.svg 与 description）。安装会写 profile 的 dsh.profile.bundles 并把 checkout 链接进 profile 的 node_modules，插件行由本包自带的 cordis.patch.yml 提供：Host 半边是 lib/index.js，浏览器半边由包清单里的 dsh.client 声明发现。

开发

npm run build      # lib/index.js（Host）+ lib/client.js（浏览器）+ 类型
npm run watch      # 监听 src/ 重建
npm run typecheck  # tsc --noEmit
npm test           # node --test，全部离线
npm run reload     # 让运行中的 dsh 换用刚构建的 Host 半边（见下）

开发时的热重载

npm run reload 让已经在运行的 dsh 换用刚构建的 Host 半边，不用重启。它维护 profile cordis.patch.yml 里一块带哨兵的「dev 覆盖」：停用 bundle 自带的 stock-portfolio 行，再另插一行指向内容寻址的 lib/index.dev.<digest>.js。四个理由各占一环：

• 不能改成给 bundle 行改名：Loader 会跳过 name 与目标行不一致的非 insert 补丁（patch: name mismatch ... skipping），所以在 - id: stock-portfolio 上加 name: 是静默无效的——行照旧加载 lib/index.js，只有重启才换模块。
• 停用不等于卸载：bundle 仍留在 dsh.profile.bundles，浏览器半边照旧被发现；但那一行不能再挂载已发布的 bundle，否则插件会挂两遍（两个 store、两次路由注册）。
• 插入的行必须跟着 bundle 的开关走：profile patch 插入的行不受 dsh.profile.bundles 约束，所以它带一条 !!js 挂载守卫，只在 bundle 那一行「存在且被停用」时才挂载。没有守卫时，插件管理器里关掉这个 bundle 只会让 bundle 那一行消失，dev 行仍把插件挂着：侧栏的「股票持仓」和当日盈亏照旧，开关看起来失灵。守卫读的是本轮组合好的 entry 列表（entry.parent.tree.root.data），而不是 Live store——同一轮里新出现的 id 会被最后创建，读 store 会在「重新开启」的那一轮看不到 bundle 行，把 dev 行卸掉之后不再重挂。
• digest 才是热重载的关键：Node 按解析后的 URL 缓存 ES 模块，只有 Loader 从没导入过的名字才会读到新构建。

npm run build 产出新 digest，npm run reload 把覆盖行指过去，profile 的 patchReload: live 让它立即生效。删掉那块覆盖（或重跑插件安装）就回到 bundle 自带的 lib/index.js。

已知边界

• 会话里能读持仓、行情、聚合分析与交易记录，但只能新增交易：改一笔、删一笔仍在面板里做。读交易明细每次都要用户点一次同意，没有明确同意就一条记录也不返回。
• 指数类裸代码有歧义（000300 既是沪深 300 的形状、也是深市股票的形状），需要后缀或搜索。
• 批量日线权限因套餐而异；没有权限时刷新会改为逐个代码请求，代码多时更慢。
• 不做汇率的历史回溯：市值走势图用当前汇率折算。
• 行情按交易日更新，美股与港股收盘时点不同，面板顶部显示行情的最新日期。

开源协议与声明

• License: MIT — 见 LICENSE。
• DSH 版本：在 DSH 0.1.7-rc.2（本地构建）上验证。
• 行情数据来自 TickFlow。 本项目是第三方客户端与 TickFlow 无隶属或合作关系，相关名称与商标归其各自所有者；个人用户注册可获取免费 API Key，行情数据仅供个人参考，不构成任何投资建议，据此操作风险自负。