863683348/dsh-plugin-finance-data

面向DeepSeek Harness代理的金融数据工具包:数字/货币格式化(包括中文万/亿单位)、回报率与复合年增长率计算、估值与盈利能力比率、现值/终值、风险指标,以及数据质量检查清单

Project Overview项目介绍

dsh-plugin-finance-data is a native plugin built exclusively for DeepSeek Harness (DSH) agents, designed to offload accurate arithmetic calculation for finance-related tasks that can trip up large language models when they attempt to calculate on their own. It follows DSH plugin packaging conventions and ships with a valid bundle manifest for Cordis, DSH’s official plugin runtime. To install the plugin, you can run the one-line command dsh plugin --profile <profile> add dsh-plugin-finance-data in your terminal, then restart your DSH instance to automatically register the finance_data tool host-wide. It currently provides 10 distinct finance-focused tools covering everything from standard number and currency formatting to portfolio rebalancing order calculations.

The plugin is intended for any DSH user that needs to run reliable financial calculations or analysis within their DSH agent workflow, regardless of their level of expertise with finance or coding. When a user asks a question that requires financial arithmetic, the DSH agent will automatically select and call the appropriate tool from this plugin to get a guaranteed-correct result. The agent then uses that accurate calculation to build its final answer for the user, eliminating the common problem of LLMs making silly arithmetic errors during manual financial analysis. This makes the plugin a useful addition for anyone doing personal investment planning or basic financial research via DSH.

The plugin’s core finance calculation logic is isolated from DSH and Cordis, with zero imports from either framework, and it has been fully unit tested to ensure accuracy. It does not access the local filesystem at any point, so all calculations are deterministic and completely free of side effects. Older releases of the plugin had a JSON schema compatibility issue that could prevent DSH from starting correctly, but this has been fixed in the current version; if you run into startup issues after installing an older release, simply remove the plugin or upgrade to the latest version, and no user data will be lost. The plugin is released under the permissive open source MIT license.

这是一个专为DeepSeek Harness(DSH)打造的原生插件,是面向DSH代理的金融数据工具包,核心能力是为大语言模型提供准确的金融计算逻辑,让模型负责解释分析,插件负责完成标准化的算术计算。它支持十余种不同的金融相关工具动作,包括数字格式化、收益计算、金融比率、时间价值、风险指标等。你可以通过命令行dsh plugin --profile <profile> add dsh-plugin-finance-data完成安装,安装后重启DSH即可使用。

该插件适合所有需要在DSH中进行金融数据分析、投资计算的用户使用。典型工作流程是,当用户向DSH代理提出金融相关的问题或计算需求时,代理会根据需求调用插件提供的对应工具,快速获得经过验证的准确计算结果,再将结果结合分析整理后反馈给用户。它能够有效避免大模型直接计算出现的算术错误,提升金融分析结果的准确性和可信度。

该插件的核心金融计算逻辑独立于DSH和Cordis,不依赖额外的外部依赖,逻辑部分已经过单元测试,不访问文件系统,运行确定无副作用。旧版本存在JSON schema兼容问题,会导致DSH启动失败,当前版本已经修复该问题,如果遇到启动失败可以移除旧版本插件或升级,不会丢失数据。插件采用MIT许可证开源,允许免费使用和修改,后续还规划新增更多功能。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-plugin-finance-data

把 863683348/dsh-plugin-finance-data 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-finance-data

A finance data toolkit for DeepSeek Harness agents: guaranteed-correct number formatting, return math, ratios, time value, and risk metrics. The model explains; the plugin does the arithmetic.

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

Install

dsh plugin --profile <profile> add dsh-plugin-finance-data

Restart DSH. The finance_data tool is registered host-wide.

Tool

action purpose
format Number/currency/percent formatting with thousands separators and Chinese 万/亿 units
return Simple, log, and annualized (CAGR-style) returns
ratio PE, PB, ROE, ROA, gross/net margin, debt-to-equity
value Present value, future value, implied rate
risk Mean, volatility, max drawdown, historical VaR(95), Sharpe from a return series
checklist Data-quality checklist (source, as-of date, units, definitions)
plan DCA / compound-interest projection — future value schedule, inflation-adjusted real value
portfolio Portfolio weights, drift vs targets, and rebalance buy/sell orders
trend Metric time series — mean, extremes, direction (slope), volatility
peer Value vs peer group — P10/P50/P90 and percentile rank

Config

All optional, on the composition row's config:

key default meaning
personaSection true register the finance prompt-guidance section
sectionOrder 6 prompt section order (persona is 0, ascending)

Design

Pure logic (lib/finance.js) has zero DSH/Cordis imports and is unit-tested in isolation; lib/index.js is the thin Cordis plugin wiring the tool and the prompt section. No filesystem access — deterministic and side-effect free.

License

MIT

Roadmap

See ROADMAP.md — next five versions (v0.2.0 – v0.6.0): planning & portfolio, trends & peer comparison, cash-flow & sensitivity, bonds & FX/inflation, backtest & report export.

← 上一个 Prev SpecWave 下一个 Next dsh-cron →