READMESource: main@f99ec567
dsh-stock-kanban
DSH 0.2.2-rc1 轻量多市场盯盘与持仓查看插件：悬浮胶囊 + A股/港股/美股/加密货币分组自选 + 持仓盈亏 + 目标价 + 分时/日/周/月K。
功能一览
- 悬浮胶囊：显示自选标的名称/现价/涨跌幅；拖动后吸附屏幕边缘并按访问端记忆位置；达到目标价显示 Ⓑ/Ⓢ 标记（行情过期时明确暂停而非伪装）；点击展开面板。
- 四市场分组：A 股 / 港股 / 美股 / 加密货币 固定分组（ETF 归入上市市场，是类型不是分组）；同一标的只在一处。
- 列表：名称/代码、现价、涨跌幅、持仓标记 ★、目标价状态；「只看持仓」额外显示盈亏金额与比例。
- 详情：分时 / 日K / 周K / 月K（自绘 SVG，含成交量与 MA5/10/20/60，无 CDN 依赖）；持仓数量/平均成本编辑，自动计算市值/浮动盈亏/比例；买卖目标价设置（阈值重叠显式确认）；行情时间与拉取时间分开标注。
- 持仓汇总：按报价币种独立汇总（USD 与 USDT 不合并）；部分缺行情时明确标注"不完整"。
- 隐私开关：实例级开关，遮挡持仓数量/成本/市值/盈亏金额与比例（仅展示层遮挡，非加密）。
- 备份：结构化导出（schemaVersion 1）与覆盖式导入（双重校验、显式确认）。
- 数据边界：业务数据（自选/持仓/目标价/隐私开关）存 DSH 实例（跨浏览器共享）；界面偏好（胶囊位置/面板位置/上次市场/筛选/均线显隐/胶囊标的）按访问端浏览器保存。
安装（web profile，Linux/Windows 浏览器访问远端 DSH 同此）
# 在能访问 DSH runtime 的机器上（开发态链接安装；正式部署可 npm pack 后 add 包）
dsh plugin --profile web add "link:/path/to/dsh-stock-kanban"
# 或 tarball：
# npm pack && dsh plugin --profile web add ./dsh-stock-kanban-0.1.0.tgz
# 随后重启 DSH 服务使 host 端路由激活：
sudo systemctl restart deepseek-harness.service
- 从源码构建客户端（如改动 client/ 后）：
npm install && npm run build - 运行测试：
npm test（67 用例，全部离线 mock，不依赖外网）
验证插件已激活：浏览器打开 DSH → 应看到右上角"盯盘"胶囊；或 curl http://<dsh>/stock-kanban/health 返回 {"driver":...}。
升级 / 卸载
dsh plugin --profile web add "link:/path/to/dsh-stock-kanban" # 覆盖同路径升级（link 安装）
dsh plugin --profile web remove dsh-stock-kanban # 卸载（数据保留）
卸载不删除业务数据：DSH storage 单元在 ~/.dsh/storages/stock_kanban.json（文件回退驱动在 ~/.dsh/stock-kanban/data.json），重装后自动读回。建议卸载前先在 UI 导出备份。
数据保存位置与共享关系
| 数据 | 位置 | 共享范围 |
|---|---|---|
| 自选/持仓/目标价/隐私开关 | DSH 服务端 ~/.dsh/storages/stock_kanban.json（DSH storage hub json 后端；缺失该服务时回退 ~/.dsh/stock-kanban/data.json，health 路由的 driver 字段可查当前驱动） |
同一 DSH 实例的全部浏览器（Windows/Linux 访问同一远端 DSH 看到同一份） |
| 胶囊位置、面板位置、上次市场、只看持仓、均线显隐、胶囊展示标的 | 各访问端浏览器 localStorage["stock-kanban:ui:v1"] |
按浏览器独立 |
不同 DSH 实例（如 Windows 本机 desktop 与远端 web）数据完全独立，迁移用手动导出/导入。
多页面一致性
每次变更带版本号（rev）：旧页面用过期状态提交会收到 409 与最新数据，UI 明确提示"数据已被其他页面更新，已刷新，请重试"——不静默覆盖、不静默丢失。行情轮询在服务端做 TTL 缓存合并（默认 10s），多页面/多视图同时轮询不会放大上游请求；上游失败按提供方指数退避（30s→5min）。
行情来源与限制（免费、无 Key、无注册）
| 市场 | 快照/列表 | 分时 | K线 | 复权口径 |
|---|---|---|---|---|
| A 股/ETF | 腾讯 qt.gtimg.cn（批量） | 腾讯 minute/query（proxy 域主、web 域备） | 腾讯 fqkline | 前复权（qfq） |
| 港股 | 同上（同批） | 同上 | 同上 | 不复权（接口无 qfq 键，图表如实标注） |
| 美股 | 东方财富 ulist（批量）/stock/get | trends2（北京时间为轴） | kline klt=101/102/103 | 前复权（fqt=1） |
| 加密货币 | OKX 现货公开 REST（ticker/tickers） | 5m×288 ≈ 24h | candles 1D/1W/1M | 无复权概念 |
- 全部免费接口有延迟与限流可能；插件显示数据时间（行情时间/拉取时间）、失败与过期状态，不承诺实时行情，不缓存伪装最新。
- 搜索：A股/港股/ETF 用本地标的池（
data/*.json，约 1 万条，来自参考项目）+ 腾讯 smartbox；美股 smartbox；加密 OKX 交易对清单。搜索源不可用时明确提示，不展示虚构结果。 - 直连代码添加必须通过行情校验（实际取到有效价格才收）。
隐私与安全边界
- 行情请求只携带市场代码，不发送任何持仓数据给行情提供方。
- 写操作路由强制同源（Origin/Sec-Fetch-Site 双校验）+ JSON 体积上限。
- 隐私开关是展示层遮挡（••••），不是加密；导出备份包含持仓明文，请自行妥善保管。
- 传入备份逐条校验身份与数值，非法文件被整体拒绝或计入 rejected，不破坏现有数据。
已知限制
见 docs/verification.md 的「未验证与降级」章节（Windows desktop profile 未实测、备份导入的文件选择器在部分嵌入式浏览器需手动路径、腾讯接口曾有 WAF 前科等）。
License
MIT（含第三方 MIT 复用声明，见 NOTICE.md）。运行时零 npm 依赖；devDependencies 仅构建期 esbuild。
No comments yet. Be the first to write one.