前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在智能体开发或个人投资管理中，通常需要在不同应用间切换：Excel 记录交易，券商 App 查看行情，数据难以互通。shuiiiiimu/dsh-stock-portfolio 插件将股票持仓管理功能整合进 DSH，通过本地 SQLite 存储数据，利用对话界面作为主要交互入口，实现了交易记录、盈亏统计、日线行情检索与持仓复盘的一体化。
插件介绍¶
- 名称：
shuiiiiimu/dsh-stock-portfolio - 维护者：shuiiiiimu
- 分类：记忆
- 定位：DSH 中管理股票持仓的插件，支持交易记录、盈亏统计、日线行情、离线代码检索与持仓复盘。
核心能力¶
该插件将所有数据存储在本地 SQLite 数据库中，读写同一份数据源。
覆盖范围¶
支持 A 股（沪深京）、港股、美股，以及 ETF、指数、可转债。
三大交互入口¶
- 侧边栏「股票持仓」：位于右侧栏「设置」上方，提供概览、持仓明细、交易管理、分析面板和设置入口。显示当日盈亏，支持表头排序。
- 对话中读写：通过注册的 Tool 进行操作。
- 右侧栏「持仓提及」：当对话中出现持仓标的的代码或名称时，自动展开，显示走势与持仓统计。
数据与 Tool¶
插件向会话注册了七个 Tool，涵盖读写操作：
| Tool | 权限 | 功能 |
|---|---|---|
stock_add_trade |
直接写入 | 将自然语言转化为交易记录 |
stock_portfolio_overview |
自动读 | 持仓明细、市值、浮动/已实现/当日盈亏 |
stock_symbol_detail |
自动读 | 单个标的的本地日线与指标，及持仓历史 |
stock_analysis |
自动读 | 按动机或市场的盈亏分布，标的表现排行 |
stock_portfolio_review |
自动读 | 组合复盘与未来研究清单 |
stock_search_symbols |
自动读 | 本地代码索引检索（离线） |
stock_list_trades |
需授权 | 单笔交易明细列表 |
安装与启用¶
安装需提供插件的本地绝对路径。
dsh plugin --profile web add <checkout 的绝对路径>
典型用法¶
记录交易¶
在对话中直接输入，例如“昨天买了 100 腾讯”。若字段缺失，会弹出卡片询问。系统自动将数据写入本地 SQLite。
查询行情¶
直接询问标的状况，例如“腾讯最近怎么样”。系统会读取本地 SQLite 回答，无需联网查询行情接口。
持仓复盘¶
询问“我的股票表现怎么样”，或直接敲命令 /portfolio-review。系统会基于本地数据计算当下的盈亏、波动等指标，并生成未来一个月的研究清单。
持仓提及¶
对话中出现持仓代码（如 700 或腾讯控股）时，右侧栏自动展开对应的走势图与统计卡片。
数据口径与限制¶
- 数据源：TickFlow。
- 更新频率：按交易日更新。美股与港股收盘时间不同，面板顶部显示最新日期。
- 成本计算：移动加权平均，卖出按摊薄成本结转锁定已实现盈亏。不含手续费。
- 汇率：基准货币默认人民币，一天取一次。不做汇率的历史回溯，市值走势图使用当前汇率折算。
- 指数代码：指数类裸代码有歧义（如
000300），需后缀或搜索。 - 交易明细读取：每次都需要用户点一次同意，没有明确同意则不返回数据。
- 改删交易：只能在面板里进行修改或删除操作，对话中只能新增交易。
开发与调试¶
如需本地开发，可运行以下命令：
- 构建与类型检查：npm run build、npm run typecheck
- 监听模式：npm run watch
- 热重载（无需重启 DSH）：npm run reload
注意事项¶
- 本插件仅供个人参考，数据来自 TickFlow，不构成任何投资建议，据此操作风险自负。
- DSH 理念为“一切皆插件”，此插件为社区维护项目，与 DeepSeek / 幻方无官方从属关系。
- 安装前应检查源码与许可证（MIT）。
