前言¶
在 DeepSeek Harness（DSH）里做供应商尽调、主体核验或合规排查时，常见做法是手动打开第三方企业信息网站，或自己写脚本对接工商与司法类 API，再把结果贴回对话。前者打断 Agent 工作流，后者要维护 Key、路由和字段映射。风鸟（Riskbird）提供国内企业查询能力；keyblues/dsh-plugin-fengniao-company-search 把它封装成两个原生 Agent 工具，安装后在插件页保存 API Key 即可，由 Agent 按企业名称解析主体并按维度拉取数据。
下面介绍插件定位、能力边界、安装配置与典型用法。事实以仓库 README 与 package.json 为准；社区目录页见文末链接，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
风鸟企业查询 是 DSH 社区插件，维护者为 keyblues，分类为 联网工具，当前版本 1.0.1（MIT 许可证）。它对接风鸟（Riskbird）上游接口，覆盖工商登记、股东与高管、对外投资、变更，以及被执行、失信、限高、经营异常、严重违法、行政处罚等 11 个企业维度。Agent 不依赖额外 npm 运行时依赖，仅通过 Host 侧注册的工具调用上游 HTTP。
核心功能¶
两个原生工具¶
安装并配置 Key 后，Agent 可直接调用：
fengniao_search_company：按中文企业名称或简称模糊搜索，返回候选企业的工商全称与entid（英文名称无效；最多 20 条候选）。fengniao_company_dimension：用entid与dimension枚举查询单一维度；查维度前必须先取得entid。
名称有歧义时，Agent 会先向你确认主体，再按需拉取各维度。
支持的 dimension¶
| dimension | 名称 |
|---|---|
basic_info |
企业基本信息 |
shareholders |
企业股东信息 |
executives |
企业高级职员 |
investments |
企业对外投资 |
changes |
企业工商变更 |
executed |
被执行人 |
dishonest |
失信被执行人 |
limit_consumption |
限制高消费 |
abnormal_operation |
经营异常 |
serious_illegal |
严重违法 |
admin_penalty |
行政处罚 |
每次维度调用消耗账号额度；同一维度不要重复查询。结果过长时界面可能截断展示，工具返回的 data 仍保留完整上游 JSON。
Key 与配置¶
- 插件页配置（推荐）：在「插件」页进入本插件详情，在配置卡片粘贴 Key 并保存；写入 Harness 凭据库（默认引用名
FENGNIAO_API_KEY），不回显、不写入 profile 文件。 - 三级回退：
config.apiKey（profile 内cordis.patch.yml）→ 凭据库 → 环境变量（默认FN_API_KEY；Windows 下可读注册表，setx后通常无需重启 DSH）。
可选配置项（均有默认值）：baseUrl（默认 https://m.riskbird.com/prod-qbb-api）、timeoutMs（5000–120000，默认 30000）等，见仓库 README「配置项」表。
实现要点（选用时了解）¶
- 零额外 npm 依赖，使用 Node 内置
fetch。 - 配置保存路由注册在本机 DSH Web 服务，并要求自定义请求头
x-fengniao-plugin: 1，降低跨站伪造改 Key 的风险。 - 兼容 Node.js ≥ 20，DSH
>=0.2.1-rc.3 <0.3.0-0（装错版本时 DSH 会拒绝安装）。
安装与启用¶
DSH 侧边栏「插件」页可从 GitHub 安装，无需手动下载仓库（除非网络不通）。
- 打开「插件」页；
- 点右上角「添加插件」（菜单中为「安装第三方插件」）；
- 在「包名或地址」输入框粘贴：
https://github.com/keyblues/dsh-plugin-fengniao-company-search
- 点「安装」，等待完成（本机需能访问 github.com）；
- 进入插件详情页，在配置卡片保存风鸟 API Key。
GitHub 连不上时，README 说明可改用本地目录绝对路径以 link: 方式安装；亦可在对话中说「安装插件 https://github.com/keyblues/dsh-plugin-fengniao-company-search」由 Agent 代劳。新安装一般无需重启；更新已安装插件后需重启 DSH 才会重新加载 Host 模块。
获取 API Key：登录风鸟 Web 端，在「账户设置 → API Key」生成；完整 Key 只展示一次。多个 Key 共用同一账号每日额度，额度以风鸟 API Key 页面为准。
典型用法¶
配置完成后，用自然语言提问即可，例如：
- 「帮我查一下比亚迪的企业尽调和风险」
- 「信数科技的法人是谁、股东有哪些」
- 「这家供应商有没有被执行/失信记录」
Agent 会先调用 fengniao_search_company 解析主体，再按需调用 fengniao_company_dimension。若遇 9999 且提示 Key 无效，到插件页重新保存 Key；当日额度用尽需隔天再试，不要反复重试。
适用场景与注意¶
适合：在 DSH 对话内做国内企业名称检索、尽调信息汇总、司法与经营风险初筛的开发者或分析人员；希望 Key 留在本机凭据库、由 Agent 编排多维度查询的场景。
务必注意：
- 插件以 当前 DSH 进程权限 运行，Key 经上游要求的
apikey查询参数发出；安装前应阅读源码与 MIT 许可证，确认信任维护者与上游服务条款。 - 依赖 DSH
tools服务；webServer、credentials缺失时，对应 Web 配置或凭据能力可能不可用。 - 常见错误：
8888多为entid或参数错误，应重新搜索企业；20000成功但state=empty表示该维度无记录。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/keyblues/dsh-plugin-fengniao-company-search
- 源码与完整工具参数、错误码、故障排查：https://github.com/keyblues/dsh-plugin-fengniao-company-search
经过上面的步骤，你可以在 Harness 里用对话完成风鸟侧的企业主体解析与多维度查询，而无需在 Agent 外切换站点或自建对接层。
