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.

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/[email protected]

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="[email protected]" 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="[email protected]" \
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.9 · T6 · 135 plugin components