Sparkles for DeepSeek Harness
Turn DeepSeek Harness into a
finance research assistant for mainland China, Hong Kong, and US markets.
This is the DSH distribution of
Sparkles. Pi users should install the sibling
@pi-sparkles/pi-sparkles
package, which reuses the same finance cores but owns separate Pi lifecycle and
terminal presentation.
Requires DSH 0.1.5-rc.1, the DSH 0.1.5 API.
The host and service peers are pinned exactly; DSH 0.1.1 is unsupported.
Ask about a stock or ETF in everyday language. DSH Sparkles brings current market
data, price history, company filings, fundamentals, and financial calculations
into the conversation.
What it gives you
- Current quotes and recent price history for supported CN, HK, and US sources.
- Trend, momentum, and volatility analysis with SMA, RSI, and ATR.
- SEC, CNINFO, and HKEXnews filing and disclosure research.
- Fundamental, valuation, portfolio-risk, scenario, event-study, and backtest
calculations when the required data is available.
- Bounded CN/HK/US transaction-tape packet review, local possible-fill
simulation, read-only broker evidence review, compound compliance checks,
non-executable handoffs, and receipt reconciliation.
- Clear source, timestamp, currency, freshness, and data-limit context in answers.
- Responsive inline SVG OHLCV charts rendered as ordinary DSH tool output.
DSH automatically looks up current evidence for questions about price, trend,
buying now, or when to sell. You do not need to ask it to "use tools" first.
Quick start
dsh plugin --profile <name> add @dsh-sparkles/dsh-sparkles@0.1.13
The bundle patch layer is applied on the next dsh --profile <name> boot.
Uninstall with dsh plugin --profile <name> remove @dsh-sparkles/dsh-sparkles.
For most mainland China and Hong Kong quote/history research, and for SEC filing
research, the only setup is a contact address used to identify requests to public
data services:
AGENT_CONTACT="you@example.com" dsh --profile <name>
Then ask naturally:
Get a current quote for AAPL.分析一下科创50ETF的走势588000 如果现在买，什么时候卖比较好？分析腾讯 00700.HK 最近半年的趋势、动量和波动Summarize AAPL's latest SEC fundamentals and cite the evidence.Compare this portfolio with its benchmark and explain the largest risks.
Optional data-service setup
The package loads without provider credentials. Add only the services you want;
you do not need every variable below.
| Variable | What it enables |
|---|
AGENT_CONTACT | Identified access to supported public services, including Eastmoney, CNINFO, SEC, and HKEXnews. Use one email address everywhere. |
TUSHARE_TOKEN | Optional, rate- and entitlement-limited mainland China stock-identity fallback. It is never required or the first route. Tushare permissions and points apply. |
ALPACA_API_KEY_ID, ALPACA_API_SECRET_KEY | Optional Alpaca US prices, bars, news, corporate actions, and assets. Feed permissions apply. |
OPENFIGI_API_KEY | Optional OpenFIGI identity mapping. |
TWELVE_DATA_API_KEY | Optional Twelve Data company profiles. |
FRED_API_KEY | Optional FRED macroeconomic series. |
Example:
AGENT_CONTACT="you@example.com" \
ALPACA_API_KEY_ID="..." \
ALPACA_API_SECRET_KEY="..." \
dsh --profile <name>
Credentials stay in your runtime environment; this package does not write, log,
or persist them. Restart DSH after changing environment configuration because
some adapters initialize at boot.
Boundaries
Sparkles for DSH is read-only research software: it cannot place, change, or
cancel broker orders. External providers, gateways, SDKs, credentials, and
entitlements remain caller-owned; Sparkles never silently selects or falls back
to another provider. It is not investment, legal, accounting, or tax advice.
See CONFIGURATION.md for the complete source and configuration reference.
Version 0.1.13 · T6 · 135 plugin components
