dsh-plugin-qcc — 企查查数据源插件（DeepSeek Harness）

🌐 在线宣传页 — 可视化了解功能特性与安装流程

⚠️ 非官方插件声明：本项目与企查查（苏州企查查科技有限公司）、BizOwl / 企查查 Claw 平台无任何关联，未获其授权、背书或支持。 仅供个人学习与技术研究用途。详见下方免责声明。

把 BizOwl 客户端的企查查数据源能力提取为 DeepSeek Harness（DSH，Cordis 插件体系）的运行时插件：在一个 DSH 会话里获得企业信息查询工具链和设置页图形化账号管理。v2.0 起支持持久化安装（装一次，重启后仍在），同时保留动态试用形态。

功能一览

模型工具（5 个）

工具	用途
qcc_auth	账号认证管理：状态 / 扫码登录 / 轮询结果 / 手动 Token / 校验 / 积分 / 邀请码 / 登出 / 诊断
qcc_search_companies	企业快搜：名称、keyNo、法人、经营状态、注册资本
qcc_knowledge_search	企业知识库向量搜索（查询第一步）
qcc_tool_search	检索可用的 MCP 数据工具及参数 schema（查询第二步）
qcc_execute_tool	执行 MCP 工具获取数据：工商、股东、司法、知识产权等 100+ 维度（查询第三步）

典型查询链：qcc_knowledge_search（判断知识库能否直接回答）→ qcc_tool_search（找工具）→ qcc_execute_tool（取数）。

GUI 界面（2 处）

• 设置页：设置 → 企查查数据源 —— 账号状态/积分展示、扫码登录、手动 Token 设置、邀请码绑定、Token 校验、登出
• 会话内卡片：插件运行卡片内的紧凑管理面板

工作原理（v2.0 持久化形态）

• 以标准 Cordis 插件包形态常驻 DSH profile（~/.dsh/profiles/web/）：Host 半注册 5 个工具 + 一个同源 HTTP API（/qcc/v1/api，设置页用），Client 半经 dsh.client manifest 自动发现并注册设置页
• 运行于 DSH 主进程内，直接使用 node:fs 与全局 fetch——无沙箱绕行（v1 动态形态所需的 subprocess 方案已不再需要，但仍保留于 plugin/ 目录供快速试用）
• 凭证存于 ~/.BizOwl/auth.json，与本地 BizOwl 客户端互通；API 基址 https://qclaw-api.qcc.com
• 重启 DSH 后插件仍在：安装一次，永久生效

环境要求

1. DeepSeek Harness ≥ 0.1.0-rc.5（含 dsh plugin 命令的版本）
2. Node.js ≥ 22
3. 一个企查查账号（自行注册；部分查询消耗积分）——没有积分？到 Claw 平台（claw.qcc.com） 申请获取

安装

两种形态任选：持久化安装（v2 推荐） 装一次永久生效、随 DSH 自动加载；动态试用 一条消息即装即用，但随进程重启消失。

方式一：持久化安装（推荐）

# 从 GitHub 直接安装到 web profile（headless 用 --profile headless）
dsh plugin --profile web add github:Samge0/dsh-plugin-qcc

# 或从本地克隆安装（便于改代码调试）
git clone https://github.com/Samge0/dsh-plugin-qcc.git
dsh plugin --profile web add file:/F:/Space/PRO/dsh-plugin-qcc   # 路径按实际修改

💡 找不到 dsh 命令？ 如果你的 Harness 是源码方式运行（git clone 后用 pnpm 启动），dsh 尚未全局安装，需在源码仓库根目录加 pnpm 前缀调用，例如：

pnpm dsh plugin --profile web add github:Samge0/dsh-plugin-qcc

然后重启 DSH（bundle 层变更需重启生效）。启动后：

• 新会话中 agent 自动获得 5 个 qcc_* 工具
• 设置页出现 设置 → 企查查数据源

卸载：dsh plugin --profile web remove dsh-plugin-qcc（源码运行则是 pnpm dsh plugin --profile web remove dsh-plugin-qcc），然后立即重启 DSH。

⚠️ 卸载后、重启前，运行中的 DSH 实例内存里仍保留已删除插件的加载项，此时刷新浏览器页面会提示 Failed to load plugins — bundle script /plugins/dsh-plugin-qcc/client.js failed to load——这是预期现象，不是卸载失败；重启 DSH 后提示即消失。

方式二：动态试用（免重启，会话级）

git clone https://github.com/Samge0/dsh-plugin-qcc.git
cd dsh-plugin-qcc
./install.ps1          # 校验环境，并把"安装提示词"复制到剪贴板

打开 DSH Web GUI（http://127.0.0.1:3080），新建会话，把剪贴板内容粘贴发送即可。agent 会读取 plugin/host.js 与 plugin/client.js，经 cordis_define/cordis_run 激活；首次激活可能弹出授权提示，确认即可。注意：动态插件是会话级的，DSH 重启后需重新发送提示词。

使用

1. 登录

任选其一：

• 图形化（推荐）：DSH 侧边栏 设置 → 企查查数据源 → "生成二维码" → 页面直接显示二维码图片，用企查查 App 扫码授权 → 回到设置页点"查询扫码结果"（二维码过期或扫不了时点"刷新二维码"重新生成）
• 对话式：直接对 agent 说 "用 qcc_auth 生成扫码登录会话"，然后 "查询扫码结果"
• 复用 BizOwl：若本机 BizOwl 客户端已登录，凭证自动互通，无需重复登录

2. 获取积分（没有积分的用户）

部分查询会消耗企查查积分。没有积分的用户可前往 企查查 Claw 平台 申请获取积分：注册 / 登录账号后，按平台指引领取或购买积分套餐即可。

3. 查询示例

登录后直接用自然语言提问：

查一下华为技术有限公司的工商信息

agent 会自动走三步链并返回结构化结果（统一社会信用代码、法人、注册资本、经营范围、联系方式、100+ 维度数据计数等）。也可以问股东结构、司法风险、专利、年报、招投标等维度。

4. 停止 / 卸载

…