npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-skills-stock

v1.3.1

Published

DSH 原生 A 股量化投研技能包:适配自 KStock 2.0 桌面端精选技能体系(41 个技能:个股研究 / 选股与策略 / 场景编排 / 品种专项 / 市场全景 / 数据查询 / 图表呈现),激活即注册为 runtime skill,配 workspace 侧边栏「投研工作台」(策略/因子/选股/报告四库 + 数据源凭据配置)。

Readme

dsh-skills-stock

DSH 原生 A 股量化投研技能包:把本地桌面产品 KStock(2.0+) 的核心产品能力适配为 dsh(deepseek-harness)插件 —— 41 个 runtime skill (个股研究 / 选股与策略 / 场景编排 / 品种专项 / 市场全景 / 数据查询 / 图表 呈现)、策略库 / 因子库 / 选股库 / 报告库四库工作区(18 个 agent 工具 + 侧边栏工作台 UI)、设置页数据源凭据配置。

形态对齐家族插件(dsh-super-ppts / dsh-kylin-automation):不用插件自造 Agent 预设(DSH 0.1.16 起 agent-presets 按 agent.cordis.yml 组合挂载,插件 自造预设已失效),人设路由经 systemPrompt 能力通告承载;激活时幂等清理 历史版本写入的预设目录。

插件清单

| 类别 | 技能 | |---|---| | 个股研究(6) | stock-analysis(十四维分析引擎 + 缠论 v2 动力学)、financial-statement(三表勾稽/造假红旗/杜邦)、earnings-forecast(盈利预测/SUE)、earnings-revision(盈利修正)、valuation-model(PE-Band/PB-ROE/估值陷阱)、dcf(DCF 建模 + Excel) | | 选股与策略(5) | a-stock-screener(自然语言选股编排)、selection-strategies(十大策略)、factor-research(IC/IR/分层回测/六因子)、strategy-research(策略设计/参数扫描/walk-forward)、backtrader-strategies(8 策略适配器库) | | 场景编排(10,KStock 2.0 新增) | stock-due-diligence(个股尽调全景)、stock-screening-theme(选股流水线)、strategy-backtest-theme(策略回测)、factor-analysis-theme(因子研究流程)、chan-stock-theme(缠论个股与选股)、cb-panorama(可转债全景)、market-linkage(市场联动看板)、index-futures-theme(期指专题)、option-etf-theme(期权 ETF)、option-futures-linkage-theme(期指期权联动交叉验证)——多引擎并行 + html-report 看板 + 四库归档 | | 品种专项(6) | cb-analysis(可转债全链路)、etf-analysis(13 维)、futures-analysis(股指期货四维)、option-futures-linkage(期指期权联动)、options-payoff(BS 定价/Greeks/多腿盈亏)、options-volatility(波动率曲面) | | 市场全景(2) | market-linkage-engine(8 维市场联动)、industry-analysis(行业六维画像/产业链) | | 数据查询(9) | tushare-data(Tushare 官方适配层)+ 问财八件套:zhishu-query / announcement-search / news-search / report-search / business-query / macro-query / event-query / hithink-futures | | 呈现与基建(3) | html-report(报告 JSON → 纯标准库渲染器 → 单文件自包含 HTML 看板 + report_archive 归档)、chart-visualization(26 种 ECharts 图表,Node.js)、common(kk_common 公共数据网关库,被其他技能自动引用) |

安装

# npm registry(推荐:版本可被插件管理检测,用户手动更新)
dsh plugin --profile web add dsh-skills-stock

# GitHub 直装 / install straight from GitHub
dsh plugin --profile web add github:kkutysllb/dsh-skills-stock

# 本地路径安装 / install from a local checkout
git clone [email protected]:kkutysllb/dsh-skills-stock.git
dsh plugin --profile web add ./dsh-skills-stock

数据源配置(必读):多数分析/数据技能需要 Tushare Token(tushare.pro 个人主页获取)与同花顺问财 API Key(问财开放平台控制台获取)——装后在 宿主设置页「数据源」填入(只写本机 <数据根>/secrets.env,0600,不上传); 未配置时相关技能会明确报缺密钥而非编造数据。纯本地计算的技能 (options-payoff / options-volatility / chart-visualization 及全部方法论章节) 与 akshare 兜底路径无需密钥。

安装后重启 dsh 生效:

  • 41 个技能注册为 runtime skill(rank 250,项目级 .dsh/skills 同名技能可 覆盖),所有 agent 会话可见,/技能名 可显式激活;
  • 18 个四库工具(strategy_* / factor_* / selection_* 各 5 件套 + report_archive / report_list / report_get)注册为 agent 原生工具, 宿主全局可用(registerTools: false 可关闭);
  • workspace 侧边栏出现「投研工作台」独立面板(四库 tab);
  • 设置页出现「数据源」菜单项(凭据配置);
  • systemPrompt 注入一段有界能力通告(需求路由 + 四库纪律 + 跨技能约定, announceToAgent: false 可关闭)。

QiLin(麒麟)双通道适配(v1.2.2 起)

manifest 同时声明 qilin 与 dsh 两个通道的 bundle.patch / client: QiLin(dsh 0.1.6-alpha.2 合并后)的插件管理器只认原生键 qilin.bundle.patch(缺失会报「没有声明组合包」),DSH 宿主仍读 dsh.*;两通道指向同一份 cordis.patch.yml 与 client 交付物, 行为完全一致。

麒麟(QiLin)引擎安装

# npm registry(推荐:版本可被插件管理检测,用户手动更新)
qilin plugin --profile qilin add dsh-skills-stock

# GitHub 直装 / install straight from GitHub
qilin plugin --profile qilin add github:kkutysllb/dsh-skills-stock

装完在 QiLin 设置 → 插件里可见、可启停;数据目录(库/凭据/缓存,stock/library/secrets) 数据根按 $QILIN_HOME → $DSH_HOME → ~/.dsh 解析,与 QiLin/KStock 语义映射表(本仓已有)一致。

注意事项(QiLin)

  • 必须经 qilin plugin add 装进 profile:包会落到 profile 私有的 ~/.qilin/profiles/<name>/node_modules——裸包名原生解析的第一跳。 不要手工把包目录放进共享的 ~/.qilin/profiles/node_modules: dsh alpha.2 合并后的 runtime+enforce 解析把该目录划为安装保留区, 放那里的 bundle 层包激活时直接 failed to import。
  • 引擎版本:运行需要带 dsh 兼容层的 QiLin 3.0.0+;插件管理 (设置页展示/启停)要求 3.0.2+(alpha.2 合并后只认 qilin.bundle.patch 原生键)。
  • 运行时解析:dsh alpha.2 起依赖解析默认运行时模式(PR #4471), 插件运行期导入由 profile 安装图经进程内 generation 解析;引擎包按 框架契约声明于 peerDependencies,由宿主安装副本统一解析。

投研工作台(侧边栏面板)

工作台是 dsh agent 能力的作业界面,沿用 KStock 产品闭环——库内容由 agent 入库,面板只读 + 驱动:

  • 四个 tab:策略库 / 因子库 / 选股库 / 报告库(报告库为 KStock 2.0 quant-reports 同构:无版本链、同 report_id 覆盖更新、内嵌 HTML 看板预览 + 新窗口打开;单份上限 8MB)。三库列表显示名称、状态徽章、当前版本 与最近运行核心指标(收益/夏普、IC/IR、命中数);详情含身份卡(投资假设 / 选股口径)、版本时间线(逐版本 change_note + 最新标记)、运行归档表 (勾选 2-4 个做指标并排对比 + 曲线叠加:策略库叠加净值曲线——各运行 归一到同起点 1,因子库叠加累计 IC 曲线——逐期累加,KStock 桌面端 EquityOverlay/IcOverlay 同款几何与配色;曲线负载不随详情常驻传输,勾选后 经 library_runs 端点按需拉取)。
  • 新建研究任务 / 重跑本版本:把预填好的任务 prompt 经会话桥 (setDraft → submit,super-ppts v3 同款,剪贴板降级)投递到 dsh 会话, agent 读技能 → 跑回测/检验/选股 → 用工具登记入库 → 用户在面板看结果, 再一键重跑迭代。
  • 存储在数据根 <宿主 home>/dsh-skills-stock/product/{strategies,factors,selections,reports}/ (object.json 身份 + versions/ 版本链 + runs/ 运行归档;报告库为 report.json meta + content.html,同 id 覆盖。纯 JSON/HTML、agent 的文件工具可直接读取), 容量上限与乐观锁纪律同 KStock。
  • 数据根跟随宿主 home:$QILIN_HOME → $DSH_HOME → ~/.dsh(super-ppts 同款解析,不写死用户 home 字面量;KCoder 桌面端 DSH_HOME=~/.kcoder 时 数据即在 ~/.kcoder/dsh-skills-stock/)。v1.0–1.1 的 ~/.dsh-stock 旧数据 在插件加载时自动迁移(整项搬移、绝不覆盖目标既有文件)。

四库 agent 工具(18 个,注册名与 KStock 对齐)

| 库 | 工具 | |---|---| | 策略库 | strategy_list / strategy_create / strategy_get_latest / strategy_save_version / strategy_record_backtest | | 因子库 | factor_list / factor_create / factor_get_latest / factor_save_version / factor_record_run | | 选股库 | selection_list / selection_create / selection_get_latest / selection_save_version / selection_record_run | | 报告库(2.0 新增) | report_archive(HTML 看板归档,同 report_id 覆盖更新,≤8MB)/ report_list / report_get(全文按需拉取) |

版本纪律(沿袭 KStock lead_soul):代码/口径必须经 *_save_version 入库 (禁止只留在会话工作区),运行后必须 *_record_* 归档(rules/config 原样 抄录,跨版本对比口径才成立;rules 可带 report_id 与报告库建看板链); 新版本劣于旧版本如实呈现并在 change_note 写「证伪」。选股库 criteria_json.summary 必填,create 自动落 v1。报告库无版本链——研究交付 即归档,同 id 幂等覆盖。

设置页「数据源」

TUSHARE_TOKEN / IWENCAI_API_KEY 的配置状态徽章 + 受控保存表单。密钥只 写入本机数据根 <宿主 home>/dsh-skills-stock/secrets.env(权限 0600,原子覆写、合并语义、不回显 不上传),走 /dsh-skills-stock RPC 通道(与 /api 同一套 Host/Origin + 浏览器认证围栏,POST-only JSON)。

dsh 宿主会把名字含 TOKEN/KEY/SECRET/PASSWORD 的进程环境变量从 bash 子进程 剥离,因此技能脚本统一走凭据文件约定:Agent 运行脚本前在同一条 bash 命令里 set -a; source <数据根>/secrets.env; set +a 再执行(各技能 SKILL.md 的 「凭据配置」节已写明)。无密钥也能用的技能:options-payoff / options-volatility / chart-visualization 及全部纯方法论章节;akshare 兜底无需密钥。Python 依赖 (pandas / numpy / scipy / tushare / akshare 等)按脚本报错提示 pip install; common 公共库由技能脚本自动 pip install -e 安装。

能力通告(原「股票分析专家」预设的替代)

systemPrompt 通告按需求形态路由到技能线,并固化:数据纪律(Tushare > 问财 > 免费源兜底,缺失如实标注禁止编造)、交付形态(研究报告 = 单文件离线 HTML 落当前工作目录)、四库入库纪律与合规边界(仅供研究参考,不构成投资建议)。

与 KStock 的适配关系

真源:KStock 仓 vendor/skills/public/(上游 KSkills 精选子集 + 本地补丁, QiLin 沙箱语义)与四库产品模型(strategies/factors/selections/reports)。本仓由 scripts/adapt-kstock-skills.mjs 单向适配物化技能层,四库为同构重建 (SQLite → JSON 文件):

| QiLin/KStock 语义 | dsh 适配 | |---|---| | 技能挂载于 /mnt/skills/public/<name> 沙箱路径 | 相对路径以 resourceBase(技能包根)解析;cd 命令用 <本技能包根> 占位符 | | 密钥由 required-secrets 声明、沙箱激活时注入环境 | <数据根>/secrets.env 凭据文件 + 运行前 source(dsh 剥离敏感进程环境变量) | | render_html_report 内置看板工具(1.x)/ html-report 技能自带渲染器(2.0) | html-report 渲染器为纯标准库 Python,直用;curl 归档步骤改写为 report_archive 工具 | | 场景手册 curl POST 127.0.0.1:18001/kstock-api/* 三步入库 | 同名 agent 工具调用(*_create / *_save_version / *_record_*) | | 报告库 SQLite(report_library 表)+ reports/{Y}/{M}/{D} 落盘 | <数据根>/product/reports/<id>/(report.json meta + content.html),同构语义(白名单/覆盖/sha256/8MB 上限) | | 三库 SQLite 索引(kstock.db)+ /mnt 挂载 | <数据根>/product/ 纯 JSON 文件(agent fs 工具可直接读),语义同构(乐观锁/版本链/运行归档/容量上限) | | 桌面端策略库/因子库/选股库/报告库视图 | 侧边栏投研工作台四 tab(列表/版本时间线/运行对比/报告看板/会话桥重跑) | | *_store LangChain 工具(引擎侧) | 同名 agent 工具(dsh 原生 tool 定义,全局注册) | | 沙箱路径规范技能 sandbox-path-guide | 不适配(dsh 无此语义),引用处改写为内联产物分区纪律 | | market-scan-workflow(QiLin workflow 编排工具) | 不适配(dsh 无此编排原语),待 dsh 提供后再评估 |

脚本级修补仅 5 处硬编码路径(两个 *_cli.py 的 common 候选路径改为按脚本 位置解析、strategy-research 两个 analysis 模块的 docstring 示例、common 的 行情缓存持久候选改为 <数据根>/cache/market-data);适配规则与技能清单 (SPEC)都集中在 adapt 脚本内,KStock 上游更新后重跑即可再生成。

开发

pnpm install
npm run adapt      # 从 KStock 重新适配技能(KSTOCK_REPO 可指定仓路径)
npm run check      # tsc 类型检查 + esbuild 构建(lib/ 随仓提交)
npm run smoke      # 冒烟:清单 / 适配纯度 / host apply / RPC / 四库 / 工具 / 通告 / client
npm run sync:mirror   # 镜像到 dsh-plugins 仓(--check 对账)

发版约定(同家族插件):本仓为开发真源,改动推送前先 sync:mirror 同步到 dsh-plugins 仓并提交,保证两个安装入口一致。

免责声明

本插件全部技能输出仅供研究与教育参考,不构成任何投资建议;数据来源为第三方 接口(Tushare / 同花顺问财 / akshare),准确性与时效性不作保证;投资决策及 其风险由使用者自行承担。

License

MIT