dsh-stock-portfolio
在 DeepSeek Harness 中管理股票持仓：交易记录（含交易动机）、盈亏计算与统计、日线行情、离线代码检索与持仓分析。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:shuiiiiimu/dsh-stock-portfolio#51275c9d73f5a4cd5832c1bc1e01af68e973738c
Stock Portfolio 以 dsh-stock-portfolio 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness（DSH）里管理股票持仓：交易记录、盈亏统计、按日线保存的行情、离线代码检索与持仓复盘，全部落在本地 SQLite。覆盖 A 股（沪深京）、港股、美股，以及 ETF、指数、可转债。
三个入口，读写同一份数据：
界面只用 DSH 自己的主题变量（--dsw-alias-*），自动跟随浅色 / 深色主题。
持仓：展开一行看走势与指标 交易记录与动机 面板与侧边栏入口
截图仅为效果预览，不构成投资建议。
| 分区 | 内容 |
|---|---|
| 概览 | 持仓市值、总盈亏、未实现盈亏（带浮盈 / 浮亏家数）、当日盈亏、已实现盈亏、胜率、持仓集中度、平均持有天数；按每日收盘价回溯的市值走势图；市场分布与分币种小计 |
| 持仓 | 数量、成本价、最新收盘价（带日期）、当日盈亏、市值、浮动盈亏、已实现盈亏、仓位占比；表头可排序。每行可展开：左边是这只标的的收盘价 + 成交量走势（虚线是成本价、三角形是这段区间里的买卖点），右边是 3/5/15/30/60 日涨跌幅、20 日波动率、量比、60 日区间与最大回撤、均线偏离、连续涨跌，以及持有天数、首笔买入、交易笔数、已实现盈亏。窗口按交易日数（假期不占格子），比手里的日线长就显示「—」而不缩窗口，指标全部由本地日线现算、不额外请求接口。每行按标的自己的币种显示 |
| 交易 | 增 / 改 / 删；表单默认折叠，动机字段旁按方向给出常用速选词，点一下即填入，也可自由输入 |
| 分析 | 已实现盈亏记在卖出动机上、浮动盈亏按买入动机的成本占比分摊，另有交易所分布、标的表现排行、清仓历史 |
| 设置 | API Key、基准货币、自动获取的汇率、后台行情检查间隔、会话提及是否展开右侧栏、本地代码索引状态 |
对话里出现持仓标的的代码或名称时，右侧栏的「持仓提及」自己展开，一个标的一张卡片：和持仓行展开后同一块细节（线柱图 + 区间指标），下面接它的持仓统计（成本、现价、当日与浮动盈亏、占比、已实现、持有天数）和组合当前的盈 / 亏家数；已清仓或只有交易记录的照常显示走势与历次交易。换到有提及的会话——包括历史会话——会展开，后续的新提及也会；已经在显示时就只更新内容，不会把用户收起的右栏重新顶开。自动展开可在「股票持仓 → 设置」里关掉，之后从右侧栏「指引」页的「持仓提及」入口打开。
提及由一个会话投影（stockPortfolioMentions）折出：用户输入与助手回复都算，从磁盘恢复的历史会话在首次读取时把整段日志折一遍；浏览器每 2 秒问一次当前会话的状态（页面不可见时不问）。命中规则按歧义分级，因为误报比漏报更烦人：
1600519 里的那一段不算。aapl 也认），两三位只认大写（否则 it、on、all 会命中 Gartner、ON Semiconductor、Allstate），单字母只认 F.US 或名称。Applebee 不会命中 Apple）；子代理自己的会话不参与。同一个插件还向会话注册两个 Tool，读写同一份 SQLite：stock_add_trade 把一句话变成一笔交易记录，stock_portfolio_overview 读持仓、市值、浮动 / 已实现盈亏与分币种小计。
说「昨天买了 100 股腾讯」就够了。没说的字段不会被猜：缺什么就在同一次调用里通过 ctx.userQuestions 弹一张卡片问什么——标的选项来自本地代码索引，价格首选本地最新收盘价并注明不是你自己的成交价，日期给今天 / 昨天，动机给按方向的速选词——已经说过的不会再问，说全了一张都不弹。写入走 PortfolioService.addTrade，和面板保存同一条校验路径；按形状推断的交易所（002594 → 002594.SZ）写在返回值的 notes 里。子代理没有人类回答者、或组合里没挂 ctx.userQuestions 时，Tool 不写入任何东西，而是把还缺的字段和原本要问的问题（含选项）原样返回；两个 Tool 都随插件卸载。
start_time = 上次更新次日），几只股票合成一次批量请求；数据源滞后（假期、停更）时记「今天已经问过」的水印。新标的（含 chat 里刚记的）写入时当场取最近 90 天，最多等 2.5 秒，超时先返回、行情在后台继续落地。ctx.web.fetch 优先，失败退回 ctx.web.search），基准货币默认人民币，也可在设置页手动覆盖。.env > 插件行，设置页只回传「已配置 / 未配置」；全市场约 23,500 条标的抓在本地、每周更新，搜索即时、可离线——写法 600000.SH / 00700.HK（补足五位）/ AAPL.US，裸代码按形状推断并显示结果。插件是标准的 DSH bundle + dual-face client：
npm install && npm run build
dsh plugin --profile web add ~/codespaces/dsh-stock-portfolio # 方式一
# 方式二：profile 的 patch 层直接挂载本地 checkout（name 相对 patch 文件解析）
# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: stock-portfolio
name: ../../../codespaces/dsh-stock-portfolio/lib/index.js
web profile 是 patchReload: live，保存后 Host 半边会重组；浏览器需要刷新一次页面。改完代码不用重启 dsh：
npm run build # 额外写一份内容寻址的 lib/index.dev.<digest>.js
npm run reload # 把 profile 的行指向最新 dev 副本 → 触发重载
可选配置写在 patch 行里：dataDir（默认 $DSH_HOME/storages/stock-portfolio）、apiBase、apiKey。
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 半边
浏览器半边有三类用例：client-bundle.test.mjs 用桩模块表加载 lib/client.js 并真正执行 apply；client-render.test.mjs 用真实 React 渲染各分区；client-mount.test.mjs 在 jsdom 里挂载真实组件、让 effect 与请求跑完，断言点开一行之后线柱图与指标确实画了出来。
npm run reload 按「写同目录临时文件 → rename 覆盖 → 回读校验」替换 patch，并先确认目标 bundle 存在且非空，所以一次断电不会留下半截 YAML 把 dsh 卡在启动阶段。数据目录、.env 位置、dev 副本路径都在运行时按 $DSH_HOME / import.meta.url 推导，仓库里没有硬编码的绝对路径。
000300 既是沪深 300 的形状、也是深市股票的形状），需要后缀或搜索。LICENSE。api.tickflow.org / free-api.tickflow.org）。 本项目是第三方客户端，与 TickFlow 无隶属或合作关系，相关名称与商标归其各自所有者；接口行为可能随时变化。行情数据仅供个人参考，不构成任何投资建议，据此操作风险自负。0.1.5-rc.2（本地构建）上开发与验证。浏览器半边通过 shell 冻结的平台模块表解析 react / @deepseek-ai/dsh-client-ui-*，升级 DSH 后若该表有变动，需同步 scripts/build.mjs 里的 externals 列表。