dsh-fengniao-company-search
DeepSeek Harness (DSH) 插件：Fengniao (Riskbird) 中国企业查询，涵盖工商登记、股东、高管、对外投资、变更以及司法和经营风险维度，可在插件页面配置 API Key。DSH 插件：风鸟企业查询（工商/股东/高管/对外投资/变更/司法与经营风险），插件页内配置 API Key。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-fengniao-company-search@1.1.0Fengniao Company Search 以 dsh-fengniao-company-search 发布，当前版本为 1.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English — Riskbird (风鸟) China company lookup for DeepSeek Harness (DSH). Two native agent tools resolve a Chinese company name to a Riskbird
entidand fetch one of 11 dimensions for it: business registration, shareholders, executives, outbound investments, registration changes, court enforcement, dishonest judgment debtor, consumption restriction, abnormal operation, serious illegality and administrative penalties. The API key is configured on the plugin page and stored in the Harness credential store. Zero npm dependencies.
风鸟企业查询的 DSH 插件。装好后 Agent 可以直接调用两个工具查中国企业：先按名称解析主体拿到 entid，再按 entid 取一个维度。API Key 在「插件」页的配置卡片里保存，写入本机 Harness 凭据库，不打进 profile 配置文件、不回显。
dsh-plugin deepseek-harness fengniao riskbird company-search 企业查询 工商查询 企业尽调fengniao_search_company 解析主体，fengniao_company_dimension 按 entid 查维度，由 Agent 直接调用，不用拼 shell 命令FN_API_KEY 里时，卡片提供「从环境变量导入到凭据库」，Host 侧直接写入（Key 不经过页面）fetch、node:test，Windows 下用 child_process 读环境变量注册表），无依赖、无构建步骤已发布到 npm：dsh-fengniao-company-search。
在 Harness 里用插件管理器安装这个 bundle，target 写 npm 包名（可带版本）：
plugin_manager install_bundle target: dsh-fengniao-company-search
# 或固定版本
plugin_manager install_bundle target: dsh-fengniao-company-search@1.1.0
从 Releases 下载 dsh-fengniao-company-search-<version>.tgz，在插件管理器里填该文件的绝对路径，或：
plugin_manager install_bundle target: <下载的 .tgz 绝对路径>
DSH Desktop 支持直接从 GitHub 仓库安装：
打开侧边栏「插件」页；
点右上角「添加插件」→「安装第三方插件」；
在「包名或地址」里输入本仓库地址：
https://github.com/keyblues/dsh-fengniao-company-search
安装完成后进入本插件详情页，在配置卡片里保存 API Key；
工具随插件自动注册：fengniao_search_company / fengniao_company_dimension。
不同网络环境下的填法：
| 场景 | 「包名或地址」怎么填 |
|---|---|
| 能正常访问 GitHub（推荐） | https://github.com/keyblues/dsh-fengniao-company-search |
| GitHub 连不上 | 先 git clone 本仓库，再填本地目录的绝对路径（DSH 以 link: 方式安装） |
| 想让 Agent 代劳 | 在对话框里直接说「安装插件 https://github.com/keyblues/dsh-fengniao-company-search」 |
新安装无需重启即可生效；更新已安装插件后需要重启 DSH（运行中的进程不会重新加载已修改的 Host 模块）。卸载：插件页 → 本插件详情 → 卸载。
打开「插件」页 → 本插件详情 → 在配置卡片里粘贴 Key 并保存。推荐用这种方式，Key 落在 Harness 凭据库。
Key 的解析优先级：
| 顺序 | 来源 | 说明 |
|---|---|---|
| 1 | config.apiKey | profile cordis.patch.yml 内直接写入，优先级最高 |
| 2 | Harness 凭据库 | 插件页保存，引用名由 credentialRef 指定（默认 FENGNIAO_API_KEY）；推荐 |
| 3 | 环境变量 | 变量名由 apiKeyEnv 指定（默认 FN_API_KEY）；旧方式，可用 allowEnvFallback: false 关闭 |
Key 不要长期放在环境变量里。 若 Key 之前通过
FN_API_KEY配置，插件页状态会显示「环境变量」，卡片上出现「从环境变量导入到凭据库」按钮：Host 侧读取并写入凭据库，Key 不经过页面；导入后即可删除环境变量。Windows 下可执行reg delete HKCU\Environment /v FN_API_KEY /f，插件对持久化环境变量有 30 秒缓存。
获取 Key：登录风鸟 Web 端，在「账户设置 → API Key」生成（完整 Key 只展示一次）。多个 Key 共用同一账号的每日额度。
fengniao_search_company按中文名称模糊搜索企业，返回候选企业的工商全称与 entid。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 企业中文名称或简称；风鸟按中文名检索，英文名查不到 |
返回 query、count 与 candidates[]（name、entid、status、raw），最多 20 条。查维度前必须先用它拿到 entid。
fengniao_company_dimension按 entid 查询一个企业维度。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
entid | string | 是 | 来自 fengniao_search_company 的企业标识 |
dimension | string | 是 | 维度枚举，见下表 |
返回 dimension、label、apiCode、success、state（records / empty / unknown）、message、data（上游原始 JSON）与 truncated。
每次调用消耗一次账号额度，不要重复查询同一维度。结果很大时 Harness 会把模型侧内容落盘（spill）并给出路径，对话卡片仍会显示维度与记录数摘要。
| dimension | 名称 | 上游 version |
|---|---|---|
basic_info | 企业基本信息 | B1 |
shareholders | 企业股东信息 | B2 |
executives | 企业高级职员 | B3 |
investments | 企业对外投资 | B4 |
changes | 企业工商变更 | B5 |
executed | 被执行人 | C2 |
dishonest | 失信被执行人 | C3 |
limit_consumption | 限制高消费 | C4 |
abnormal_operation | 经营异常 | D1 |
serious_illegal | 严重违法 | D2 |
admin_penalty | 行政处罚 | D11 |
两个工具在 Web 端各有一张对话卡片，默认收起、点击行头展开：检索卡是「关键词 + 匹配 N 家」加候选列表；维度卡是「维度 + N 条记录」加字段与原始 JSON 预览。行头、展开体和运行态样式都照抄 DSH 内置工具卡（仅用主题 token 上色），结果被 spill 时卡片仍能回放维度、记录数与预览。
全部可选，代码内有默认值；可在 profile 的 cordis.patch.yml 里按 id: fengniao-company-search 覆盖：
| 字段 | 默认 | 说明 |
|---|---|---|
apiKey | 空 | 直接写入的 Key，优先级最高；建议改用插件页或凭据库 |
credentialRef | FENGNIAO_API_KEY | Harness 凭据库引用名（插件页保存的位置） |
apiKeyEnv | FN_API_KEY | 旧方式的环境变量名；仅作兜底 |
allowEnvFallback | true | 设为 false 时插件不再读自己的 apiKeyEnv 环境变量 |
baseUrl | https://m.riskbird.com/prod-qbb-api | 接口地址，仅内部联调需要修改 |
timeoutMs | 30000 | 单次接口超时（毫秒，5000–120000） |
FN_API_KEY，点卡片上的导入按钮迁移到凭据库即可。FN_API_KEY 却显示未配置：插件先读进程环境，再读 Windows 用户/系统环境变量注册表（30 秒缓存）；仍读不到时重开一次 DSH。9999 表示 Key 无效或当日额度用完；8888 表示 entid 或参数错误，重新调用 fengniao_search_company 获取 entid；20000 为成功，此时 state: empty 表示该维度没有记录。package.json 的 engines.dsh 声明（>=0.2.1-rc.5 <0.3.0-0），装错版本时 DSH 会直接拒绝安装。apikey=...）里，这是上游限制；因此 Key 可能出现在上游/代理的访问日志中。x-fengniao-plugin: 1，跨站页面无法在不触发 CORS 预检的情况下伪造请求。npm test # 等价于 node --test；只用 Node 内置 test runner，无需安装依赖
覆盖：两个工具 execute() 返回值与声明的 output.schema 一致性（DSH 按 additionalProperties: false 校验）、上游错误码映射、Windows 注册表环境变量解析、设置路由的请求头校验与「不回显 Key」断言、环境变量导入凭据库、allowEnvFallback 开关、presentationMeta 有界性，以及 Client 半的配置卡片与对话卡片渲染。
index.js Host 半：工具注册 + 上游 HTTP + 同源配置路由 + 凭据读写/环境变量导入
client.js Client 半：插件页配置卡片（含环境变量导入）+ 两张对话卡片
cordis.patch.yml bundle 清单（插入 fengniao-company-search 行）
locale/{zh,en}.json 插件管理器里的标题与描述
icon.svg 插件图标
test/plugin.test.js 输出契约、错误码、凭据与设置路由的回归测试
test/client-card.test.js 配置卡片与对话卡片的渲染测试
发布到 npm 走 GitHub 联动：.github/workflows/publish.yml 在推送 v* tag 时用 OIDC（npm Trusted Publishing）执行 npm publish --provenance，并把打好的 .tgz 附到对应的 GitHub Release。
Trusted Publishing 配置（npm trust github：仓库 keyblues/dsh-fengniao-company-search、workflow publish.yml、权限 publish）；之后每次发版只需：
npm version patch|minor|major
git push --follow-tags
首次发布是在包还不存在时手动做的（此时无法配置 Trusted Publishing）：
npm login
npm publish --access public # prepublishOnly 会先跑 node --test
MIT © keyblues