前言¶

在 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。