Tools & Capabilities

SpecFusion

wxkingstar/SpecFusion · ★ 77

wxkingstar

Search 65,600+ API docs from 20 Chinese open platforms through five read-only tools and a runtime skill.

README body is shown in Chinese.

License
MIT
Added
2026-08-21
Maintenance
active
Install kind
github

No manifest check is available; listing does not imply compatibility or security review.

安装

dsh plugin --profile web add github:wxkingstar/SpecFusion

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. 为什么用 SpecFusion
  2. 安装
  3. 方式一:skills CLI(推荐)
  4. 方式二:DeepSeek Harness 插件
  5. 方式三:手动安装
  6. 安装后找不到 Skill?
  7. 使用方式
  8. 已接入平台
  9. 仅在当前项目安装
  10. 自部署
  11. Docker 部署
  12. 环境变量
  13. 文档同步
  14. 本地开发
  15. API 参考
  16. 搜索参数
  17. 技术栈
  18. 贡献
  19. License

GitHub stars License: MIT DSH plugin 官网

🌐 官网: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。

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

License

MIT