简体中文 | English
面向 DeepSeek Harness 的交互式 K 线分析插件。直接用自然语言查看行情、技术指标、新闻和基本面信息，并在侧栏继续探索图表。
dsh_kline 可通过 DeepSeek Harness 插件市场安装。若市场目录尚未刷新，也可直接从 GitHub 安装：
dsh plugin --profile web add github:FTShare-Lab/dsh_kline首次启动会准备独立的 Python 运行环境。发布新版本后，已从 GitHub 或市场安装的用户可在同一处检查并更新；link: 本地开发安装始终跟随本机目录，不会被线上版本自动覆盖。
- 多市场行情：支持港股、美股和 A 股，可使用股票名称、简称或代码查询。
- 指数行情：接入 FTShare SDK 1.0.3 的 A 股指数日 K，可用“对比”叠加沪深300、上证指数等指数走势（历史分钟级指数为基础版能力）；底部大盘条展示恒生/纳指/上证/沪深300/深成指行情，点击任意指数可直接打开其 K 线图。
- 大盘数据兜底：配置 FTShare Key 时大盘指数全部走官方接口；未配置 Key 或官方不可用时，自动回退到内置免费行情源（东方财富/腾讯公开接口，界面明确标注来源），免费用户也能看到大盘数据。
- 检索与自选：可搜索股票、收藏当前标的，并按分组管理自选；支持行情刷新、排序和批量打开。标的名称右侧的星标可一键收藏/取消当前标的。
- 交互式图表：提供日、周、月、季、年及分钟 K 线，支持缩放、拖动、十字线与响应式布局。
- 技术指标：默认展示 K 线、MA、VOL、MACD；KDJ、RSI、BOLL、ATR、VWAP 可按需切换。
- 关键价位：在明确提出需求时，自动识别并标注支撑位、压力位和触及次数。
- 点位标注：工具栏“点位”可添加任意价格的水平价位线、在任意 K 线上放置文本标注（名称/备注/颜色，可改价改名删除）；自动支撑/压力可改价、改名、删除或“转我的”固化为自定义点位。点位随浏览器本机保存并支持导出/导入。
- 区间统计：依次点击起点和终点 K 线，即可查看区间涨跌、振幅、最大回撤、K 线数、成交情况等统计。
- 信息补充：可切换查看个股新闻、公司简况、财务与股东等基本面信息。
在 DeepSeek Harness 中启用 dsh_kline 后，可像与分析助手对话一样提出需求，也可直接点击右侧的 K 按钮，在搜索框中输入股票名称或代码。无需记住固定代码格式。
调取紫金矿业的 K 线看看腾讯控股的日 K，标注压力位和支撑位分析英伟达最近一个月的成交量、MACD 和 RSI查看这只股票最近的新闻和基本面信息切换到周线，看看趋势是否转强
分析完成后，可在图表侧栏继续切换周期、指标、新闻和简况；不经过对话直接搜索的标的也可使用相同工作台。需要区间统计时，依次点击两根 K 线即可。 搜索框可直接输入股票名称或代码；点击星标可加入自选，自选列表支持分组、排序和批量打开。自选数据保存在当前浏览器本机。
右上角“设置”中的“数据源”可以粘贴 FTShare API Key 并测试连接。FTShare 当前免费套餐包含股票 K 线、公司/财务基础资料、A 股行情列表、基金和指数等接口，但免费套餐同样需要注册并配置 API Key；分钟历史行情、港股 K 线、公告/研报和新闻等能力按当前套餐开放，具体以官方文档为准。Key 仅授予账户已开通的能力。配置会在当前 dsh 进程生效；勾选保存到本机后，重启会自动加载。Key 不回显、不写入图表状态；也可用 FTSHARE_API_KEY 环境变量覆盖。未配置 FTShare 时，仍可使用内置公开行情兜底和 analyze_kline_rows 接入其他数据源。
| 工具 | 用途 |
|---|---|
analyze_kline |
默认入口。一次返回行情、指标、图表数据和可选的支撑/压力位分析。 |
analyze_kline_rows |
对调用方提供的任意标准化 OHLCV 数据完成指标、图表和侧栏会话，不依赖 FTShare。 |
fetch_candles |
获取标准化 OHLCV K 线数据。 |
calc_metrics |
对 OHLCV 数据计算技术指标和统计指标。 |
data_source_status |
返回安全的数据源安装、配置和能力状态，供前端设置页使用。 |
configure_ftshare |
配置或清除 FTShare API Key，可选择保存到本机并发起连接测试；不会返回 Key。 |
test_ftshare_connection |
测试当前 FTShare 匿名/Key 连接，不修改配置。 |
health |
检查服务与数据适配器状态。 |
通常只需调用 analyze_kline；其余工具用于需要原始数据、单独计算或健康检查的场景。
FTShare 是可选的默认数据适配器，不是核心分析引擎的硬依赖。没有 FTShare、没有 API key，或上游暂时不可用时，调用方仍可把自己的 OHLCV 行传给 analyze_kline_rows，继续使用指标计算、支撑/压力位、图表和侧栏工作区。
外部数据源只需要提供 time（Unix 秒或毫秒）、open、high、low、close、volume；插件会排序、去重、校验有限数值，并且不会保存数据源凭据或要求注册特定供应商。data_source_url 仅接受 HTTPS 链接，用于图表中的来源标注。
最小接入示例：先由宿主或数据源适配器取得行数据，再调用 analyze_kline_rows(rows=rows, symbol="BTCUSDT", name="示例标的", data_source="自定义行情源", data_source_url="https://example.com")。这样无需 FTShare 也能使用 K 线、指标、关键点位和图表；新闻、简况、大盘等扩展内容由调用方通过标准化工作区数据提供。
搜索入口由 dsh_kline 自己维护的本地证券目录负责，不调用 FTShare 的搜索接口；目录在后台刷新，用户先快速选中标的，再按需请求 K 线。若需要分钟线、新闻或更完整的市场数据，是否可用取决于当前数据源的接口权限；这些增强能力不会影响外部 OHLCV 分析链路。
FTShare 适配只使用已核对的官方接口契约。日 K 和历史分钟 K 会在已登记的 SDK/官方路径之间有限回退，并记录实际通道；认证、套餐权限和限流不会通过盲目换接口来“碰运气”。SDK 升级前请按“官方文档 → SDK 方法和参数 → 脱敏实测 → 回归测试”的顺序核对，详见 provider adaptation guide。
- 行情可能延迟、处于收盘状态或受上游数据可用性影响。
- 支撑位、压力位和指标均为基于历史价格数据的技术分析结果，不构成投资建议。
- 商业、高频或对时效有严格要求的场景，应使用具备相应授权和服务保障的数据源。
版本更新记录见 Releases。已从源码运行的用户可更新到最新版本后重启 Harness。
本项目采用 MIT License，前端来源说明见 PROVENANCE.md。