dsh-tool-ths
同花顺 (Tonghuashun / iFinD) 行情与数据连接插件 for DeepSeek Harness —— public 免登录行情通道 + 官方 iFinD HTTP API 通道，注册 ths_* 工具族
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Xiaobai01/dsh-tool-ths#22c7a16387ed9d5f56daa9ed6b8b3dec13656f8aTool Ths 以 dsh-tool-ths 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A Cordis plugin that connects DeepSeek Harness agents to Tonghuashun market data through two channels:
public (default, no account): the 10jqka public quote API
(d.10jqka.com.cn) — realtime quotes and daily/weekly/monthly K-lines.ifind (official): the iFinD HTTP API (quantapi.51ifind.com) —
realtime quotes with valuation metrics, history with adjustment, fundamental
data, trading calendars, announcements, and code conversion. Requires an
iFinD refresh_token.| Doc | Contents |
|---|---|
| docs/architecture.md | Architecture, channel comparison, DSH loading, extension guide |
| docs/tool-reference.md | Full reference for config and all 7 tools |
| docs/protocol.md | Wire protocol details, field formats, error codes |
| docs/troubleshooting.md | Troubleshooting guide |
| Tool | Channel | Purpose |
|---|---|---|
ths_status | both | connection status, token expiry, last error, connectivity probe |
ths_quote | both | realtime quote snapshot (custom indicators on ifind) |
ths_kline | both | history K-line (D/W/M on public; D/W/M/Q/S/Y + adjust on ifind) |
ths_basic | ifind | fundamental indicators (ths_roe_stock:20241231) |
ths_trade_dates | ifind | exchange trading calendar |
ths_announcement | ifind | announcement search (with PDF links) |
ths_code | ifind | code/name → THS code conversion |
Bundle install (needs pnpm):
dsh plugin --profile web add github:Xiaobai01/dsh-tool-ths # from GitHub
# restart dsh web
Or from a local checkout (needs pnpm):
dsh plugin --profile web add .
Manual install (no pnpm) — copy the package to the profile and insert the
entry in ~/.dsh/profiles/web/cordis.patch.yml:
- insert:
- id: tool-ths
name: ./plugins/dsh-tool-ths/index.js
config:
channel: public
refreshToken: ''
baseUrl: https://quantapi.51ifind.com/api/v1
timeoutMs: 30000
retries: 2
maxCodes: 20
maxRows: 120
The profile patch layer is hot-reloaded by the running GUI (HMR); otherwise
restart dsh --profile web.
Security codes: 600519, 600519.SH, sh600519, 300750, 830799 (BSE),
399001 (SZ index). Bare codes infer the market: 6/5/9 → SH, 0/1/2/3 → SZ,
4/8 → BJ. SH indexes are not available on the public channel.
node scripts/smoke.mjs 600519 # channel smoke test (public)
IFIND_REFRESH_TOKEN=xxx node scripts/smoke.mjs 600519
node scripts/harness.mjs 600519 # apply() with stub registries, calls every tool
| Item | Requirement |
|---|---|
| DeepSeek Harness | 0.1.2-rc.1 ~ 0.1.5-rc.1 (verified on 0.1.5-rc.1 and 0.1.2-rc.1) |
| Node.js | >= 22.19.0 |
| Host services | tools, systemPrompt, settings (all shipped by dsh-base) |
public channel uses Tonghuashun's public web quote endpoint
(d.10jqka.com.cn) — not an officially supported API. It is intended for
personal research only; endpoint shapes may change without notice.ifind channel uses your own iFinD account; follow iFinD's terms.Apache License 2.0 — free for commercial use, modification and redistribution; keep the copyright/license notices, state your changes, and retain the NOTICE file. See CONTRIBUTING.md.