前言¶

在 DeepSeek Harness（DSH）里做企业尽调或合规核对时，常见做法是让模型「自己上网搜」，或手写脚本调第三方 API，再把 JSON 贴回对话。前者来源不稳定，后者每次都要拼参数、记主体标识，Agent 也不一定能直接调用。风鸟（Riskbird）提供面向中国企业的工商与司法、经营风险类接口；维护者 keyblues 把这套能力封装成 DSH 插件 dsh-fengniao-company-search，注册两个原生 Agent 工具，Key 在插件页写入本机 Harness 凭据库。下面介绍它是什么、怎么装、Agent 怎么用。

这是什么¶

dsh-fengniao-company-search 是分类为「联网工具」的 DSH 插件，数据来自风鸟企业查询 API。装好后 Agent 可调用 fengniao_search_company 按中文名称解析企业并拿到 entid，再调用 fengniao_company_dimension 按 entid 查询 11 个维度之一：工商基本信息、股东、高管、对外投资、工商变更，以及被执行、失信、限高、经营异常、严重违法、行政处罚。API Key 在 DSH「插件」页配置卡片里保存，写入凭据库，不回显、不写入 profile 配置文件。仓库：https://github.com/keyblues/dsh-fengniao-company-search；社区目录页：https://www.skillhub.cn/plugins/keyblues/dsh-fengniao-company-search。当前 npm 包版本为 1.1.0，许可证 MIT，零 npm 依赖。

核心功能¶

1. 两步查询：先名称检索（最多 20 条候选，含 entid），再选维度拉取详情；查维度前必须先有正确的 entid。
2. 11 个维度：与风鸟上游接口一一对应（如 basic_info、shareholders、executed、dishonest 等），每次维度调用消耗账号一次额度，不宜对同一维度重复查。
3. 插件页配置 Key（推荐）：保存即生效；若 Key 仍在环境变量 FN_API_KEY 中，卡片可提供「从环境变量导入到凭据库」，Host 侧写入，Key 不经过页面。
4. 对话卡片：两个工具在 Web 端各有默认收起的卡片，样式与 DSH 内置工具卡一致；结果过大时 Harness 可能 spill 落盘，卡片仍保留维度与记录数摘要。
5. Key 解析优先级（资料原文）：config.apiKey（profile 内，最高）→ Harness 凭据库（默认引用名 FENGNIAO_API_KEY）→ 环境变量 FN_API_KEY（可用 allowEnvFallback: false 关闭）。

安装与启用¶

需 Node.js ≥ 20，DSH 版本需满足 >=0.2.1-rc.5 <0.3.0-0，装错版本时 DSH 会拒绝安装。

从 npm 安装（推荐）：在 Harness 插件管理器里指定 npm 包名：

plugin_manager install_bundle  target: dsh-fengniao-company-search
# 或固定版本
plugin_manager install_bundle  target: dsh-fengniao-company-search@1.1.0

从 GitHub Release 安装：下载 Releases 中的 dsh-fengniao-company-search-<version>.tgz，再：

plugin_manager install_bundle  target: <下载的 .tgz 绝对路径>

从 GitHub 仓库安装（DSH Desktop）：侧边栏「插件」→「添加插件」→「安装第三方插件」，在「包名或地址」填：

https://github.com/keyblues/dsh-fengniao-company-search

安装完成后进入插件详情页保存 API Key；工具 fengniao_search_company / fengniao_company_dimension 随插件自动注册。新安装无需重启；更新已安装插件后需重启 DSH（运行中进程不会重新加载 Host 模块）。

配置 API Key¶

1. 登录风鸟 Web 端，在「账户设置 → API Key」生成（完整 Key 只展示一次）。
2. 打开 DSH「插件」页 → 本插件详情 → 配置卡片粘贴 Key 并保存。

可选地在 profile 的 cordis.patch.yml 里按 id: fengniao-company-search 覆盖 baseUrl、timeoutMs（默认 30000 ms）等；一般只需插件页配置即可。

典型用法¶

Agent 侧流程与 README 一致：先用名称工具，再用维度工具。

fengniao_search_company：必填 keyword（企业中文名称或简称；风鸟按中文名检索）。返回 candidates[] 中的 name、entid 等。

fengniao_company_dimension：必填 entid（来自上一步）、dimension（枚举，如 basic_info、shareholders、executed）。返回 state（records / empty / unknown）、data 等；state: empty 表示该维度无记录。

在对话里可直接说明意图，例如让 Agent「查某某公司的股东和失信被执行人」，由 Agent 依次调用上述两个工具并选用对应 dimension。错误码参考： 9999 多为 Key 无效或当日额度用完；8888 多为 entid 或参数错误，应重新搜索拿 entid；20000 为成功。

适用场景与注意¶

适合需要在 DSH 对话内完成中国企业工商与风险维度核对、尽调辅助的开发者或分析人员；不适合期望离线、无 API 额度或仅查英文公司名的场景。

安装前请自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，Key 仅来自配置、凭据库或声明的环境变量，不写日志、页面只显示尾号。风鸟接口要求 Key 出现在 URL 查询参数中，上游或代理访问日志中可能留有 Key，这是上游限制。DSH 社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-fengniao-company-search 把风鸟企业查询收成两个 Harness 原生工具，插件页配 Key、凭据库托管，Agent 可按名称到维度完成链式查询。详情见社区目录 https://www.skillhub.cn/plugins/keyblues/dsh-fengniao-company-search 与 GitHub https://github.com/keyblues/dsh-fengniao-company-search。