Skip to main content
Z

dsh-stocklab

zsimeon/dsh-stocklab

Stock analysis workspace for A-shares. Sidebar panel embeds the local stocklab web UI (quotes, LLM stock analysis, market review, hotspots) with a service status light and manual start button, plus a `stocklab` agent tool, FastAPI service supervision, and credential-safe API key injection via the DSH credential store.

Install

dsh plugin --profile web add github:zsimeon/dsh-stocklab

README

dsh-stocklab — 股票智能分析插件 for DeepSeek Harness

📈 把本地 stocklab 股票分析服务接入 DeepSeek Harness(DSH):左侧栏入口 + 对话工具 + 服务自守护 + 凭据安全注入

项目渊源

本插件的宿主服务 stocklab 综合整理自两个上游项目:

上游路径贡献
abu 阿布量化系统(abu-master)D:\stock-web\abu\abu-master量化方法论:ABU量化系统源码(abupy)、技术指标公式(MA/MACD/BOLL/RSI/ATR)、趋势/形态判定思路,以及《量化交易之路》《机器学习之路》示例代码
daily_stock_analysis(daily_stock_analysis-main)D:\stock-web\abu\daily_stock_analysis-main工程主体:AI 决策报告(核心结论/评分/买卖点位/风险警报)、多市场数据聚合(A股/港股/美股/日股/韩股/台股/ETF)、FastAPI 服务、Web 工作台、Agent 策略问股(15种内置策略)、多渠道推送、量化工具 quantkit

在 D:\stock-web\stocklab 中整合为统一的 FastAPI 服务(python main.py --serve-only),本插件(D:\2026work\stock\dsh-stocklab-plugin)负责把它接入 DSH。

功能

1. 左侧栏「股票行情」面板

  • 侧栏导航行(红绿K线图标,sidebar.panellist)+ 全局面板(main keyed slot)
  • 面板直接内嵌 stocklab 原版 Web 工作台(iframe,含剪贴板权限 allow="clipboard-write; clipboard-read")——自选股、手动分析、历史报告、回测、持仓、配置管理全部可用
  • 工具栏:服务状态灯(绿=运行/黄=检查中/红=未运行,10秒轮询)+ 快捷按钮(行情/个股分析/大盘复盘/今日热点)+ 刷新页面
  • 服务未运行时显示「▶ 启动服务」按钮,一键拉起后自动加载界面

2. 对话工具 stocklab

注册给对话 AI,5 个 action:quote(实时行情)、analyze(LLM 全量分析仪表盘)、market_review(大盘复盘)、hotspots(今日热点板块)、credential_status(凭据配置状态,永不返回值)。首次调用自动启动服务。

3. 输入框 dock

聊天输入框下方紧凑卡片:状态灯 + 代码输入 + 行情/分析按钮,弹层展示结果。

4. 服务守护

插件激活时自动 spawn(python, main.py --serve-only --port 8010) 并健康检查;停用时清理子进程。同时在本机 127.0.0.1:8011 提供控制/代理端口。

5. 控制/代理端口(8011)

  • GET /ctl/status — 服务是否运行(状态灯数据源)
  • POST /ctl/start — 手动启动服务(按钮后端)
  • GET|POST /api/* — 代理到 8010,CORS 通配,解决 DSH GUI 端口漂移导致的跨域失败(stocklab 自身 CORS 白名单只认 5173/3000)

配置(用户本机 cordis.patch.yml)

键默认值说明
pythonPathpython启动用 Python 解释器(建议配成专属 conda 环境)
projectDirD:/stock-web/stocklabstocklab 项目目录
port8010stocklab API 端口
controlPort8011控制/代理端口
autoStarttrue插件激活时自动启动服务
startupTimeoutMs120000启动健康检查超时
credentialRefs内置19个常见key从 DSH 凭据服务解析并注入的 key 名列表(只有名字,没有值)
extraEnv空追加环境变量(勿放密钥)

API Key 安全方案(发布安全)

配置文件里永远只有 key 名,值存放在 DSH 凭据服务(dsh-credentials):

  1. 用户在 DSH 凭据管理中存 key(如 DEEPSEEK_API_KEY)
  2. 插件每次启动服务时 ctx.get('credentials').resolve(name) 逐个解析,注入子进程 env
  3. 优先级:凭据服务 > extraEnv > 进程环境 > stocklab 自己的 .env
  4. credential_status 只报 {configured, source, writable};日志只打 key 名
  5. 发布包不含任何 .env 与密钥;用户也可完全用 stocklab 自己的 .env(由 .env.example 复制)

前置条件

  • DSH ≥ engines.dsh 声明的版本(见 package.json)
  • 本机已部署 stocklab 项目(数据抓取免费源可零配置运行;LLM 分析需至少一个模型 key)
  • Python 环境含 stocklab 依赖(requirements.txt)

安装(本地)

# DSH 插件页 → 添加插件 → 本地目录
D:\2026work\stock\dsh-stocklab-plugin

或命令行:dsh plugin --profile <profile> add <目录>

已知限制

  • LLM 完整分析依赖至少一个模型 key(凭据注入 或 .env 二选一)
  • market-review 为异步接口(202 任务受理),报告在原版界面的报告区查看
  • 凭据在服务进程启动时快照注入,运行中轮换需重启服务(停用→启用插件)
  • 面板 iframe 直连 8010,stocklab 需监听 127.0.0.1

License

MIT(与上游 daily_stock_analysis 一致);上游代码版权见其 THIRD_PARTY_NOTICES.md。

Related plugins