前言¶
在 DeepSeek Harness(DSH)里做 A 股相关对话时,模型往往缺少可核验的选股与条件筛选结果:公开 API 要么要单独申请,要么和问财的自然语言口径不一致。同花顺问财(iwencai)是很多人日常用的筛选入口,但它本来是为网页设计的,并没有直接挂进 DSH agent 工具链。
dsh-ths-ai 是社区维护的 DSH 原生插件(维护者 buyou-claw,分类:联网工具,非官方)。它不走独立 API 或 MCP,而是复用你本机已登录的浏览器 profile,用 Playwright 打开问财页面并抽取表格,把结果接到 DSH 右侧面板、/ths skill,以及 ths_query / ths_status 两个 agent 工具上。下面介绍它的定位、能力与安装用法。
这是什么¶
一句话:把同花顺问财接进 DSH,数据仍来自问财页面,登录态留在本机。
插件在 package.json 中声明版本 0.1.0,许可证 MIT;与同花顺/问财无官方关联。README 明确说明:没有 API Key、没有服务端、查询过程不依赖插件自建后端上传数据;代价是账号、登录态与平台使用协议均由使用者自行承担,使用前应阅读仓库内 合规与免责声明。
依赖关系上,需要 DeepSeek Harness >= 0.2.0-rc.2(0.2.x 起 agent 工具需声明 output { schema, render }),Node.js >= 20,浏览器默认走系统已安装的 Edge(Playwright channel: 'msedge')。Windows + Edge 为 README 中的实测路径;macOS / Linux 可通过环境变量调整浏览器 channel,README 标注为未充分实测。
核心功能¶
| 能力 | 说明 |
|---|---|
| 右侧面板「同花顺 AI」 | 输入自然语言问题,直接渲染问财表格;显示登录状态,支持一键登录与刷新状态 |
/ths <问题> |
对话中由模型调用工具查问财,并按 skill 约束组织为结论、精简表格、口径与异常项说明 |
ths_query |
模型工具,例如 {"query": "最近一周涨幅最大的个股"} |
ths_status |
只读判断当前 profile 是否已登录,不猜测、不编造 |
| 状态缓存 | 状态检查需拉起浏览器(约 10–20 秒),结果缓存 5 分钟并后台预热,面板打开后多数情况可快速响应 |
| 查询节流 | 两次查询默认最小间隔 ≥3 秒,降低触发问财限流的风险 |
README 同时划清边界:不是行情数据源(无内置缓存、不保证完整或实时);不是投资建议工具;不绕过登录、验证码或付费墙;仅依赖 playwright-core,npm install 不会下载浏览器二进制。
安装与启用¶
安装需将仓库置于 DSH 插件目录 ~/.dsh/plugins/dsh-ths-ai,并在桌面 profile 中登记 bundle。完整校验与卸载见仓库 docs/INSTALL.md。
方式 A:一键脚本(Windows,README 推荐)¶
在 PowerShell 中按 README 顺序执行:克隆到插件目录、安装依赖、运行安装脚本,然后重启 DSH 桌面端。
git clone https://github.com/buyou-claw/dsh-ths-ai "$env:USERPROFILE\.dsh\plugins\dsh-ths-ai"
cd "$env:USERPROFILE\.dsh\plugins\dsh-ths-ai"
npm install --omit=dev
powershell -ExecutionPolicy Bypass -File install\install.ps1
install\install.ps1 会在 ~/.dsh/profiles/desktop/package.json 登记依赖与 bundle(备份为 package.json.bak-ths-ai)、建立 node_modules/dsh-ths-ai 目录联接,并可重复执行。
方式 B:手工(任意平台)¶
- 将仓库放到
~/.dsh/plugins/dsh-ths-ai,执行npm install --omit=dev。 - 编辑
~/.dsh/profiles/desktop/package.json,在dependencies与dsh.profile.bundles中加入dsh-ths-ai(README 中有 JSON 示例)。 - 在
~/.dsh/profiles/desktop/node_modules/下建立指向插件目录的联接(Windows 用 Junction,macOS/Linux 用ln -s)。 - 重启 DSH。
验证¶
- 右侧栏出现「同花顺 AI」面板。
- 对话发送
/ths 今日涨幅前10的股票,应能返回结果。 - 查看
~/.dsh/logs/dsh-ths-ai.log,应出现ths_query registered与ths_status registered。
若面板可用但模型报无 ths_query,README 建议先确认 DSH 版本并重开桌面端。
首次使用与典型用法¶
登录问财¶
- 打开右侧「同花顺 AI」面板,点击 登录问财。
- 在弹出的可见浏览器窗口中用本人账号完成登录。
- 登录完成后关闭该窗口(登录态写入本地
profile/)。 - 在面板点击 刷新状态,显示「已登录」后即可查询。
同一 profile 同时只能被一个浏览器进程占用:登录窗口未关时不要查询,否则会报 profile 被占用。
面板与对话¶
面板适合随手查,结果直接以表格展示。
对话中使用 /ths:
/ths 最新一周涨幅最大的个股
/ths 低市盈率且主力净流入的股票
/ths status
ths status 仅查看登录状态。模型通过 ths_query 取数后,按 skill 要求归纳,而不是只粘贴原始大表。
配置项(可选)¶
均通过环境变量覆盖,不设置时与默认一致:
| 变量 | 默认 | 作用 |
|---|---|---|
DSH_THS_PROFILE_DIR |
<插件目录>/profile |
浏览器持久化配置目录 |
DSH_THS_BROWSER |
msedge |
Playwright channel;非 Windows 可试 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) |
DSH_THS_NODE |
自动探测 | 指定运行子进程的 node 可执行文件 |
适用场景与注意¶
适合谁: 已在本机使用同花顺问财、希望在 DSH 对话或右侧面板里用自然语言复用问财筛选能力、并接受「页面抓取 + 本机登录态」方案的开发者或进阶用户。
运行与权限: 插件以当前 DSH 进程权限运行,会启动子进程(node + 浏览器)、读写本机浏览器 profile,并注册 webServer 路由 /ths-ai/*。安装前应自行审阅源码与 MIT 许可证,并阅读 docs/LEGAL.md。
隐私: 登录态(含 Cookie)仅保存在本机 profile/;彻底清除可关闭 DSH 后删除该目录。不要在 issue 或截图中暴露 Cookie、手机号或验证码。
排错: 限流或风控可能返回 blocked,可调大 DSH_THS_MIN_INTERVAL_MS;问财前端改版可能导致表格为空,需结合日志向仓库提 issue。完整排查见 docs/TROUBLESHOOTING.md。
DSH 生态强调「一切皆插件」;SkillHub 目录页 为社区收录站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-ths-ai 把问财接到 DSH 的原生扩展点上:面板、/ths、以及 ths_query / ths_status,核心是复用本机 Edge profile 读问财页面,而不是另建数据 API。若你已在 Windows 上使用 DSH 桌面端并持有问财账号,可按 README 安装、登录一次后即可在对话里做条件筛选类查询。