同花顺行情 Xiaobai01/dsh-tool-ths

dsh-tool-ths — 同花顺连接插件（DeepSeek Harness）

为 DeepSeek Harness 提供同花顺（Tonghuashun）行情与数据连接能力，注册 ths_* 工具族、系统提示词指导，以及 GUI 设置页中的连接配置项。

文档

| 文档 | 内容 |
| docs/architecture.md | 架构设计、双通道对比、DSH 加载机制、代码结构、扩展指南 |
| docs/tool-reference.md | 配置项与全部 7 个工具的完整参数/输出参考 |
| docs/protocol.md | public 接口与 iFinD HTTP API 的协议细节、字段格式、错误码表 |
| docs/troubleshooting.md | 故障排查（加载失败/登录失败/行情异常/限流等） |

双通道架构

| 通道 | 说明 | 账号要求 | 能力 |
| public（默认） | 同花顺公开行情接口 d.10jqka.com.cn（免登录） | 无 | 实时行情（最新价/涨跌幅/当日OHLC/均价/量额）、日/周/月 K线 |
| ifind | 官方 iFinD HTTP API quantapi.51ifind.com | iFinD 账号 refresh_token | 实时行情（含估值/市值指标）、历史行情（任意周期+复权）、基础财务数据、交易日历、公告、代码转换 |

public 通道使用同花顺网页公开行情接口，非官方承诺接口，仅适合个人研究；生产/合规场景请使用 ifind 通道。

安装

方式一：一键安装（推荐，bundle 方式）

dsh plugin --profile web add github:Xiaobai01/dsh-tool-ths
重启 dsh web 生效

方式二：本地包安装（bundle 方式）

cd /path/to/dsh-tool-ths
dsh plugin --profile web add .

包内 package.json 声明了 dsh.bundle.patch，dsh plugin add 会自动把插件行插入 profile 的加载树（需要已安装 pnpm）。

方式三：手动安装（不依赖 pnpm）

bash
1) 把插件复制到 profile 的 plugins 目录
mkdir -p ~/.dsh/profiles/web/plugins
cp -R /path/to/dsh-tool-ths ~/.dsh/profiles/web/plugins/

2) 在 profile 的用户补丁层追加插件行
cat >> ~/.dsh/profiles/web/cordis.patch.yml = 22.19.0 |
| 宿主服务 | tools、systemPrompt、settings（均随 dsh-base 默认装载） |

插件使用 ctx.settings.installSection(ctx, ns, schema, entry, hooks) 注册设置段；该 API 属于 0.1.2-rc.1 及以后的设置接口线。

数据来源与免责声明

- public 通道访问的是同花顺网页公开行情接口（d.10jqka.com.cn），非官方承诺接口，仅适合个人研究学习；接口结构可能随时变动，也请自行控制请求频率。
- ifind 通道使用你自己的 iFinD 账号换取 token，请遵守 iFinD 服务条款。
- 行情与财务数据的版权归数据提供方（同花顺 / iFinD）所有；本插件只是访问客户端，不附带任何数据，也不得用于数据的二次分发或商业转售。
- 本插件输出的是数据与工具结果，不构成任何投资建议；据此做出的投资决策风险自负。

许可

Apache License 2.0 —— 允许免费商用、修改与再分发；要求保留版权与许可声明、标注修改，并保留 NOTICE 文件。贡献指南见 CONTRIBUTING.md。

更新日志

见 CHANGELOG.md。