wxkingstar/SpecFusion

通过五个只读工具和一个运行时 Skill，搜索 20 个中国开放平台的 65,600+ 篇 API 文档。

工具与能力ai-agentsalipayapi-documentation

SpecFusion

🌐 官网：specfusion.kingstar.xin

在 Claude Code 里直接搜企业微信、飞书、钉钉、淘宝开放平台、小红书、抖音电商开放平台、微信小程序、微信小店、拼多多开放平台、有赞开放平台、微信支付、支付宝开放平台、京东商家开放平台、SHEIN开放平台、得物开放平台、火山引擎、阿里云百炼、泛微 e-teams 开放平台、北森 iTalent 开放平台的 API 文档。

不用切浏览器，不用翻文档站——输入问题，拿到接口参数，继续写代码。

> 企业微信怎么发应用消息？

  搜索到 3 篇相关文档：
  1. 发送应用消息 — POST /cgi-bin/message/send
  2. 接收消息与事件 — 被动回复消息
  3. 消息类型及数据格式 — text/image/voice/...

为什么用 SpecFusion

不离开终端 — 写代码时直接问，Claude 帮你查文档、给出接口参数和示例
中文搜索准确 — jieba 分词 + FTS5 全文索引，发送应用消息、access_token、40001 都能搜到
67,000+ 篇文档 — 企业微信 ~2,800 篇 + 飞书 ~4,280 篇 + 钉钉 ~3,610 篇 + 淘宝 ~7,020 篇 + 小红书 ~110 篇 + 抖音电商 ~1,440 篇 + 微信小程序 ~470 篇 + 微信小店 ~490 篇 + 拼多多 ~290 篇 + 有赞 ~1,250 篇 + 微信支付 ~560 篇 + 支付宝 ~600 篇 + 京东 ~5,450 篇 + SHEIN ~260 篇 + 得物 ~270 篇 + 火山引擎ECS ~121 篇 + 火山引擎 ~35,170 篇 + 阿里云百炼 ~1,880 篇 + 泛微 ~560 篇 + 北森 ~1,090 篇，接口参数、错误码、事件订阅全覆盖
零配置 — 云端服务已部署好，安装 Skill 后即可使用，无需自建后端

安装

方式一：skills CLI（推荐）

自动检测已安装的 Agent，一键全局安装到 Claude Code、Codex、Gemini CLI 等：

npx skills add wxkingstar/SpecFusion -g -y

⚠️ 必须加 `-g` 参数！ 不加 -g 会安装到当前目录，只在该目录下生效。加 -g 安装到 ~/.claude/skills/，所有项目都能用。

仅安装到 Claude Code：

npx skills add wxkingstar/SpecFusion -g -a claude-code -y

也可以按平台名搜索安装：

npx skills find "feishu"      # 搜索飞书相关技能
npx skills find "taobao"      # 搜索淘宝相关技能
npx skills find "wecom"       # 搜索企业微信相关技能
npx skills find "dingtalk"    # 搜索钉钉相关技能
npx skills find "alipay"      # 搜索支付宝相关技能
npx skills find "jd"          # 搜索京东相关技能
# ... 支持所有已接入平台的英文名搜索

方式二：DeepSeek Harness 插件

在 DeepSeek Harness 中安装 SpecFusion 插件（自动注册 skill + 5 个原生搜索工具，无需 Bash + curl）：

dsh plugin --profile web add @wxkingstar/specfusion-dsh

安装后重启 dsh web 即可。插件目录见 dsh-plugin/。

方式三：手动安装

Claude Code（macOS / Linux）：

curl -fsSL --create-dirs -o ~/.claude/skills/specfusion/SKILL.md \
  https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md

Claude Code（Windows PowerShell）：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\specfusion" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
  -OutFile "$env:USERPROFILE\.claude\skills\specfusion\SKILL.md"

Cursor（macOS / Linux）：

curl -fsSL --create-dirs -o ~/.cursor/rules/specfusion.mdc \
  https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md

Cursor（Windows PowerShell）：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor\rules" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
  -OutFile "$env:USERPROFILE\.cursor\rules\specfusion.mdc"

安装完成。打开 Claude Code 或 Cursor，开始提问即可。

安装后找不到 Skill？

问题 · 原因 · 解决方案 Claude Code 找不到 · 安装时没加 -g，只装到了当前目录 · 重新运行 npx skills add wxkingstar/SpecFusion -g -y Cursor 找不到 · skills CLI 目前不会为 Cursor 创建规则文件 · 用上面的手动安装命令验证是否安装成功 · — · Claude Code: ls ~/.claude/skills/specfusion/SKILL.mdCursor: ls ~/.cursor/rules/specfusion.mdc

使用方式

方式一：直接提问（提到企业微信、飞书、钉钉、淘宝、小红书、抖音电商、微信小程序、微信小店、拼多多、有赞、微信支付、支付宝、京东、SHEIN、得物、火山引擎、百炼、泛微、北森等关键词时自动触发）

> 飞书如何创建审批实例？
> 企业微信的 access_token 怎么获取？
> 钉钉怎么发工作通知？
> 淘宝商品发布接口怎么用？
> 抖音电商怎么查询订单列表？
> 微信小程序怎么获取手机号？
> 微信小店怎么获取订单列表？
> 拼多多怎么同步订单？
> 有赞怎么查询交易订单？
> wecom webhook 怎么发消息？
> 微信支付JSAPI下单接口怎么调？
> 支付宝当面付接口怎么用？
> SHEIN商品发布接口怎么调？
> 得物开放平台怎么查询订单？
> 火山引擎ECS怎么创建实例？
> 百炼千问API怎么调用？
> 泛微 e-teams 怎么免登获取 accessToken？
> 北森 iTalent 怎么查询组织单元？

方式二：使用 `/specfusion` 命令

> /specfusion 企业微信发送应用消息
> /specfusion feishu 获取用户列表

已接入平台

平台 · 文档数量 · 覆盖范围企业微信 · ~2,800 · 服务端 API、客户端 API、应用开发飞书 · ~4,280 · 服务端 API、事件订阅、小程序钉钉 · ~3,610 · 服务端 API、客户端 JSAPI、事件订阅、开发指南、连接平台、AI PaaS、互动卡片、专属版插件、硬件接入等淘宝开放平台 · ~7,020 · 商品、交易、物流、店铺、用户等 API 小红书 · ~110 · 电商开放平台 API（订单、商品、售后、物流等）抖音电商开放平台 · ~1,440 · 商品、订单、物流、售后、精选联盟、即时零售等 API 微信小程序 · ~470 · 服务端 API（登录、用户信息、小程序码、客服、数据分析、安全、物流等）微信小店 · ~490 · 商品管理、订单管理、售后管理、物流发货、资金结算、营销优惠券等 API 拼多多开放平台 · ~290 · 订单、商品、物流、售后、营销、店铺、虚拟类目、多多进宝等 API 有赞开放平台 · ~1,250 · 用户、会员、商品、交易、物流、营销、店铺、分销、财务、美业等 API 微信支付 · ~560 · JSAPI/APP/H5/Native/小程序支付、退款、分账、合单支付、代金券、商家转账等 API 支付宝开放平台 · ~600 · 当面付、APP支付、手机网站支付、电脑网站支付、资金、会员、营销、安全等 API 京东商家开放平台 · ~5,450 · 商品、订单、售后、营销会员、门店、财务、供应链、秒送、政企、广告、京东健康、拍拍、物流等 API SHEIN开放平台 · ~260 · 密钥授权、商品、订单、退货退款、采购单、库存、财务、物流、Webhook 等 API 得物开放平台 · ~270 · 商品、订单、售后、出价、入仓、开票、文件、对账单等 API 火山引擎云服务器 · ~121 · 实例、镜像、密钥对、安全组、地域、部署集、专有宿主机、云助手等 API 火山引擎 · ~35,170 · 181 个云产品文档：计算、AI、网络、存储、数据库、容器、安全、CDN、视频云、大数据等阿里云百炼 · ~1,880 · 千问大模型、DashScope SDK、OpenAI兼容接口、语音合成/识别、图像/视频生成、应用开发等泛微 e-teams 开放平台 · ~560 · 认证免登、组织架构、人员、工作流程、业务表单、任务、考勤、CRM、订单、文档、日程等 API 北森 iTalent 开放平台 · ~1,090 · 招聘、组织员工、假勤、薪酬、绩效、目标、学习云、干部管理、360评估、PaaS 平台等 API

仅在当前项目安装

如果只想在某个项目中使用，可以安装到项目目录（不加 -g）：

# 在项目根目录下运行
npx skills add wxkingstar/SpecFusion -y

或手动安装（将 ~ 换成 .）：

Claude Code（macOS / Linux）：

curl -fsSL --create-dirs -o .claude/skills/specfusion/SKILL.md \
  https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md

Claude Code（Windows PowerShell）：

New-Item -ItemType Directory -Force -Path ".claude\skills\specfusion" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
  -OutFile ".claude\skills\specfusion\SKILL.md"

Cursor：

curl -fsSL --create-dirs -o .cursor/rules/specfusion.mdc \
  https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md

自部署

默认使用公共云端服务，无需自部署。如果需要私有化部署或自定义数据源，可以自建。

Docker 部署

docker build -t specfusion .

docker run -d \
  -p 3456:3456 \
  -v $(pwd)/data:/app/data \
  -e ADMIN_TOKEN=your-secret-token \
  --name specfusion \
  specfusion

启动后将 Skill 中的 API 地址替换为你的实例：

# macOS
sed -i '' 's|https://specfusion.inagora.org/api|http://your-host:3456/api|g' \
  ~/.claude/skills/specfusion/SKILL.md

# Linux
sed -i 's|https://specfusion.inagora.org/api|http://your-host:3456/api|g' \
  ~/.claude/skills/specfusion/SKILL.md

环境变量

变量 · 默认值 · 说明 PORT · 3456 · 服务端口 DB_PATH · ./data/specfusion.db · SQLite 数据库路径 ADMIN_TOKEN · dev-token · Admin API 认证令牌

文档同步

npm install
npm run sync -- --source feishu    # 同步飞书文档
npm run sync -- --source wecom     # 同步企业微信文档（需要 ego lite 桥接）
npm run sync -- --source dingtalk  # 同步钉钉文档（需要 ego lite 桥接）
npm run sync -- --source taobao    # 同步淘宝开放平台文档
npm run sync -- --source xiaohongshu  # 同步小红书文档（需要 ego lite 桥接）
npm run sync -- --source douyin    # 同步抖音电商开放平台文档
npm run sync -- --source wechat-miniprogram  # 同步微信小程序文档
npm run sync -- --source wechat-shop  # 同步微信小店文档
npm run sync -- --source pinduoduo   # 同步拼多多开放平台文档（需先跑 scripts/pdd-refresh.sh）
npm run sync -- --source youzan      # 同步有赞开放平台文档
npm run sync -- --source wechat-pay  # 同步微信支付文档
npm run sync -- --source alipay      # 同步支付宝开放平台文档
npm run sync -- --source jd          # 同步京东商家开放平台文档（需要 ego lite 桥接）
npm run sync -- --source shein       # 同步SHEIN开放平台文档
npm run sync -- --source dewu        # 同步得物开放平台文档（需要 ego lite 桥接）
npm run sync -- --source volcengine-ecs  # 同步火山引擎云服务器文档
npm run sync -- --source volcengine  # 同步火山引擎文档中心
npm run sync -- --source bailian     # 同步阿里云百炼文档
npm run sync -- --source weaver      # 同步泛微 e-teams 开放平台文档
npm run sync -- --source beisen      # 同步北森 iTalent 开放平台文档

同步完成后数据库文件位于 data/specfusion.db。

本地开发

npm install
npm run dev     # 启动开发服务器（热重载）
npm run build   # 构建

API 参考

所有 API 返回 Markdown 纯文本（Content-Type: text/markdown），可直接阅读。

Base URL: http://localhost:3456/api（自部署）

端点 · 说明 GET /api/search?q=关键词&source=wecom&limit=5 · 搜索文档 GET /api/doc/{doc_id} · 获取文档全文 GET /api/doc/{doc_id}?summary=true · 获取文档摘要 GET /api/sources · 查看已接入文档源 GET /api/categories?source=wecom · 浏览文档分类 GET /api/recent?source=wecom&days=7 · 最近更新的文档 GET /api/health · 健康检查（返回 JSON）

搜索参数

参数 · 必填 · 说明 q · 是 · 搜索关键词（接口名、API 路径、错误码、功能概念） source · 否 · 文档来源：wecom / feishu / dingtalk / taobao / xiaohongshu / douyin / wechat-miniprogram / wechat-shop / pinduoduo / youzan / wechat-pay / alipay / jd / shein / dewu / volcengine-ecs / volcengine / bailian / weaver / beisen mode · 否 · 开发模式（仅企业微信）：internal / third_party / service_provider limit · 否 · 返回数量，默认 5，最大 20

技术栈

API: Node.js + Fastify + better-sqlite3 + FTS5
中文分词: nodejieba
Scraper: cheerio + ego lite（浏览器抓取）
构建: tsup + tsx

贡献

欢迎提交 Issue 和 Pull Request。

Fork 本仓库
创建特性分支 (git checkout -b feature/xxx)
提交更改 (git commit -m 'Add xxx')
推送分支 (git push origin feature/xxx)
创建 Pull Request

站点导航

SpecFusion

为什么用 SpecFusion

安装

方式一：skills CLI（推荐）

方式二：DeepSeek Harness 插件

方式三：手动安装

安装后找不到 Skill？

使用方式

已接入平台

仅在当前项目安装

自部署

Docker 部署

环境变量

文档同步

本地开发

API 参考

搜索参数

技术栈

贡献

License

dsh-weknora

dsh-plugin

superdesigndev/treg

wxkingstar/SpecFusion

SpecFusion

为什么用 SpecFusion

安装

方式一：skills CLI（推荐）

方式二：DeepSeek Harness 插件

方式三：手动安装

安装后找不到 Skill？

使用方式

已接入平台

仅在当前项目安装

自部署

Docker 部署

环境变量

文档同步

本地开发

API 参考

搜索参数

技术栈

贡献

License

同类插件

dsh-weknora

dsh-plugin

superdesigndev/treg