同花顺问财 buyou-claw/dsh-ths-ai

dsh-ths-ai · 同花顺问财 DSH 插件

把同花顺问财（iwencai）接进 DeepSeek Harness（DSH）：右侧多一个「同花顺 AI」面板，对话里多一个 /ths 命令，模型手里多两个工具 ths_query / ths_status。

它不是 API，也不是 MCP。 它复用你本机已经登录的浏览器 profile，像你本人一样打开问财页面读取结果。
因此没有 API Key、没有服务端、没有任何数据离开你的电脑 —— 代价是你的账号、你的登录态、你所在平台的使用协议，责任都在你这边。使用前请先读 合规与免责声明。

面板截图

目录

- 它能做什么
- 环境要求
- 安装
- 首次使用
- 两种使用方式
- 配置项
- 常见问题
- 隐私与安全
- 项目结构
- 开发与测试
- Roadmap
- 许可

它能做什么

| 能力 | 说明 |
| 右侧面板 | 输入自然语言问题 → 直接拿回问财表格；显示登录状态、可一键登录、可刷新状态 |
| /ths <问题> | 对话里让 AI 调用工具查问财，并把结果总结成「结论 + 精简表格 + 口径 + 异常项」，而不是甩一张原始表格 |
| ths_query 工具 | 模型可直接调用：{"query": "最近一周涨幅最大的个股"} |
| ths_status 工具 | 只读判断当前 profile 是否已登录（不猜、不编） |
| 状态缓存 | 状态检查要拉起一次浏览器（10–20 s），因此结果缓存 5 分钟并启动后台预热，面板打开基本秒回 |
| 查询节流 | 两次查询之间默认强制 ≥3 秒间隔，避免把问财打到限流 |

它不是什么：

- 不是行情数据源：没有内置数据、没有行情缓存，不保证数据完整或实时；
- 不是投资建议工具：结果来自问财页面，内容由 AI 生成，请自行甄别；
- 不绕过登录 / 验证码 / 付费墙，也不内置任何反检测隐身参数；
- 不承诺跨平台：Windows + Edge 是实测路径，其它平台见 配置项。

环境要求

| 依赖 | 要求 | 说明 |
| DeepSeek Harness | >= 0.2.0-rc.2 | 0.2.x 起 agent 工具必须声明 output { schema, render } |
| Node.js | >= 20 | 用 DSH 自带运行时即可，无需单独安装 |
| 浏览器 | Edge（默认） | 走 Playwright channel: 'msedge'，用系统已安装的 Edge，不下载内核 |
| 账号 | 你自己的同花顺问财账号 | 登录在可见窗口里由你本人完成 |
| 平台 | Windows（实测） | macOS / Linux 见 DSH_THS_BROWSER |

只依赖 playwright-core（约 13 MB，不含浏览器二进制），npm install 不会触发浏览器下载。

安装

方式 A：一键脚本（Windows，推荐）

1. 把仓库放到 DSH 插件目录
git clone https://github.com/buyou-claw/dsh-ths-ai "$env:USERPROFILE\.dsh\plugins\dsh-ths-ai"

2. 装依赖并接进 DSH 桌面端 profile
cd "$env:USERPROFILE\.dsh\plugins\dsh-ths-ai"
npm install --omit=dev
powershell -ExecutionPolicy Bypass -File install\install.ps1

3. 重启 DSH 桌面端

脚本做三件事：① 在 ~/.dsh/profiles/desktop/package.json 登记依赖与 bundle（先备份为 package.json.bak-ths-ai）；② 建 node_modules/dsh-ths-ai 目录联接；③ 打印下一步。可重复运行（幂等）。

方式 B：手工（任何平台）

1. 把仓库放到 ~/.dsh/plugins/dsh-ths-ai，执行 npm install --omit=dev；
2. 编辑 ~/.dsh/profiles/desktop/package.json： {
"dependencies": { "dsh-ths-ai": "file:../../plugins/dsh-ths-ai" },
"dsh": { "profile": { "bundles": [ "...原有项", "dsh-ths-ai" ] } }
}

3. 建联接：Windows New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-ths-ai" -Target "$env:USERPROFILE\.dsh\plugins\dsh-ths-ai"；macOS/Linux 用 ln -s；
4. 重启 DSH。

完整步骤（含校验与卸载回滚）见 docs/INSTALL.md。

验证安装

1. 右侧栏应出现「同花顺 AI」面板；
2. 对话里发 /ths 今日涨幅前10的股票，应直接返回结果；
3. 工具注册情况见 ~/.dsh/logs/dsh-ths-ai.log：应有 ths_query registered / ths_status registered。

工具没出现？先看下面「常见问题」，90% 是 DSH 版本或没重启。

首次使用

1. 打开右侧「同花顺 AI」面板 → 点 登录问财；
2. 弹出的浏览器窗口里用你自己的账号完成登录；
3. 登录完成后关闭那个窗口（登录态已写入本地 profile）；
4. 回面板点 刷新状态，出现「已登录」即可查询。

同一个 profile 同时只能被一个浏览器进程使用。登录窗口开着时不要查询，会报 profile 被占用。

两种使用方式

面板：随手查，结果直接渲染成表格。

对话 /ths：

/ths 最新一周涨幅最大的个股 /ths 低市盈率且主力净流入的股票 /ths status # 只看登录状态

AI 会调用 ths_query 取数，再按「结论 → 精简表格 → 口径 → 异常项（ST/新股/北交所/单日大跌但区间大涨）」组织回答，不编数据。

配置项

全部通过环境变量覆盖，不设置时行为与默认完全一致：

| 变量 | 默认 | 作用 |
| DSH_THS_PROFILE_DIR | <插件目录>/profile | 浏览器持久化配置目录。装到只读目录时改成可写路径 |
| DSH_THS_BROWSER | msedge | Playwright channel。macOS/Linux 可试 chrome / chromium（未实测，欢迎反馈） |
| DSH_THS_WAIT_MS | 12000 | 结果页渲染等待毫秒数。网络慢/表格空可上调 |
| DSH_THS_STATUS_WAIT_MS | 3500 | 状态检查页等待毫秒数 |
| DSH_THS_MIN_INTERVAL_MS | 3000 | 两次查询的最小间隔（节流） |
| DSH_THS_LOG_DIR | ~/.dsh/logs | 诊断日志目录（dsh-ths-ai.log，超过 512 KB 自动清空） |
| DSH_THS_NODE | 自动探测 | 指定用哪个 node 跑子进程（默认用 DSH 自带运行时） |

常见问题

| 现象 | 最可能的原因 | 处理 |
| 面板能用，但模型说没有 ths_query 工具 | DSH 版本不匹配 / 未重启 | 确认 DSH >= 0.2.0-rc.2；重启桌面端；看 ~/.dsh/logs/dsh-ths-ai.log |
| 登录状态一直「检查中…」很久 | 首次检查要拉起浏览器（10–20 s），之后走缓存 | 等一次即可；之后 5 分钟内秒回 |
| 提示「未登录」但明明登录过 | 查询与登录用的不是同一个 profile | 统一 DSH_THS_PROFILE_DIR；登录后关闭窗口再刷新状态 |
| browser has been closed / profile 被占用 | 登录窗口还开着，或并发查询 | 关掉登录窗口；不要并发 |
| 返回 blocked / 访问受限 | 触发问财限流或风控 | 调大 DSH_THS_MIN_INTERVAL_MS，过段时间再试 |
| 表格列为空 / 结构错乱 | 问财前端改版 | 带日志开 issue |
| macOS/Linux 报 browser not found | 默认 channel 是 msedge | DSH_THS_BROWSER=chrome 或 chromium |

完整排查树见 docs/TROUBLESHOOTING.md。

提 issue 请附：DSH 版本、操作系统、~/.dsh/logs/dsh-ths-ai.log 相关片段、复现用问句。不要贴 Cookie / 账号信息。

隐私与安全

- 登录态（Cookie，含 u_ukey）只存在本机 profile/ 目录，插件不上传任何数据；.gitignore 已排除 profile/。
- 想彻底清除登录态：关掉 DSH → 删除 profile/ 目录（下次重新登录）。
- 不要在 issue / 截图里暴露 Cookie、手机号、验证码。
- 安全问题的报告流程见 SECURITY.md。

项目结构

dsh-ths-ai/
├── index.js # 宿主侧：路由 /ths-ai/*、2 个 agent 工具、子进程桥、状态缓存 ├── client.js # 客户端侧：右侧「同花顺 AI」面板 ├── config.mjs # 运行期配置（目录 / 浏览器 channel / 等待时间 / 日志） ├── login.mjs # 打开可见窗口让你本人登录 ├── query.mjs # 无头打开问财、抽取表格、输出 THS_RESULT ├── status.mjs # 只读判断登录态、输出 THS_STATUS ├── cordis.patch.yml # DSH bundle patch：注册插件 ├── skills/ths/SKILL.md # /ths skill 指令（模型侧行为约束） ├── docs/ # 安装 / 排查 / 架构 / 合规 └── install/ # 一键安装与卸载脚本

细节见 docs/ARCHITECTURE.md。

开发与测试

npm install --omit=dev
npm run check # 6 个文件语法检查（CI 跑这个）
npm run verify:status # 真实检查登录态（会拉起浏览器）
THS_QUERY="今日涨幅前10的股票" npm run verify:query # 真实查询一次

CI 只做语法检查，不做联网测试（不在 CI 里使用任何账号）。改动问财选择器时请本地跑 verify:query 并附日志。

贡献流程见 CONTRIBUTING.md，Issue/PR 约定见 AGENTS.md，版本发布与市场提交见 docs/PUBLISHING.md。

Roadmap

- [ ] macOS / Linux 浏览器探测实测（当前靠 DSH_THS_BROWSER 手动指定）
- [ ] 用 waitForSelector 替换固定 12 s 等待，缩短查询耗时
- [ ] 表格结构适配层：问财改版时集中改一处
- [ ] 结构化输出（ths_query 返回 JSON，便于二次加工）
- [x] 上架 DSH 插件市场（GitHub topic dsh-plugin，见 docs/PUBLISHING.md）

许可

代码以 MIT 发布。项目与浙江核新同花顺网络信息股份有限公司无任何关联，不含任何同花顺/问财的商标、数据或静态资源；「同花顺」「问财」等名称仅作描述性使用。使用前请阅读 合规与免责声明。