SpecFusion

在 Claude Code 里直接搜企业微信、飞书、钉钉、淘宝开放平台、小红书、抖音电商开放平台、微信小程序、微信小店、拼多多开放平台、有赞开放平台、微信支付、支付宝开放平台、京东商家开放平台、SHEIN开放平台、得物开放平台的 API 文档。

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

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

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

为什么用 SpecFusion

不离开终端 — 写代码时直接问，Claude 帮你查文档、给出接口参数和示例
中文搜索准确 — jieba 分词 + FTS5 全文索引，发送应用消息、access_token、40001 都能搜到
26,840+ 篇文档 — 企业微信 ~2,680 篇 + 飞书 ~4,070 篇 + 钉钉 ~2,020 篇 + 淘宝 ~6,740 篇 + 小红书 ~100 篇 + 抖音电商 ~1,280 篇 + 微信小程序 ~280 篇 + 微信小店 ~480 篇 + 拼多多 ~280 篇 + 有赞 ~1,240 篇 + 微信支付 ~540 篇 + 支付宝 ~600 篇 + 京东 ~6,100 篇 + SHEIN ~190 篇 + 得物 ~260 篇，接口参数、错误码、事件订阅全覆盖
零配置 — 云端服务已部署好，安装 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"          # 搜索京东相关技能
# ... 支持所有已接入平台的英文名搜索

方式二：手动安装

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.md` Cursor: `ls ~/.cursor/rules/specfusion.mdc`

使用方式

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

> 飞书如何创建审批实例？
> 企业微信的 access_token 怎么获取？
> 钉钉怎么发工作通知？
> 淘宝商品发布接口怎么用？
> 抖音电商怎么查询订单列表？
> 微信小程序怎么获取手机号？
> 微信小店怎么获取订单列表？
> 拼多多怎么同步订单？
> 有赞怎么查询交易订单？
> wecom webhook 怎么发消息？
> 微信支付JSAPI下单接口怎么调？
> 支付宝当面付接口怎么用？
> SHEIN商品发布接口怎么调？
> 得物开放平台怎么查询订单？

方式二：使用 /specfusion 命令

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

已接入平台

平台	文档数量	覆盖范围
企业微信	~2,680	服务端 API、客户端 API、应用开发
飞书	~4,070	服务端 API、事件订阅、小程序
钉钉	~2,020	企业内部应用、服务端 API、客户端 JSAPI
淘宝开放平台	~6,740	商品、交易、物流、店铺、用户等 API
小红书	~100	电商开放平台 API（订单、商品、售后、物流等）
抖音电商开放平台	~1,280	商品、订单、物流、售后、精选联盟、即时零售等 API
微信小程序	~280	服务端 API（登录、用户信息、小程序码、客服、数据分析、安全、物流等）
微信小店	~480	商品管理、订单管理、售后管理、物流发货、资金结算、营销优惠券等 API
拼多多开放平台	~280	订单、商品、物流、售后、营销、店铺、虚拟类目、多多进宝等 API
有赞开放平台	~1,240	用户、会员、商品、交易、物流、营销、店铺、分销、财务、美业等 API
微信支付	~540	JSAPI/APP/H5/Native/小程序支付、退款、分账、合单支付、代金券、商家转账等 API
支付宝开放平台	~600	当面付、APP支付、手机网站支付、电脑网站支付、资金、会员、营销、安全等 API
京东商家开放平台	~6,100	商品、订单、物流、售后、促销、店铺、数据、发票、供应商等 API
SHEIN开放平台	~190	密钥授权、商品、订单、退货退款、采购单、库存、财务、物流、Webhook 等 API
得物开放平台	~260	商品、订单、售后、出价、入仓、开票、文件、对账单等 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|http://specfusion.inagora.org/api|http://your-host:3456/api|g' \
  ~/.claude/skills/specfusion/SKILL.md

# Linux
sed -i 's|http://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     # 同步企业微信文档
npm run sync -- --source dingtalk  # 同步钉钉文档（需要 playwright）
npm run sync -- --source taobao    # 同步淘宝开放平台文档
npm run sync -- --source xiaohongshu  # 同步小红书文档
npm run sync -- --source douyin    # 同步抖音电商开放平台文档
npm run sync -- --source wechat-miniprogram  # 同步微信小程序文档
npm run sync -- --source wechat-shop  # 同步微信小店文档
npm run sync -- --source pinduoduo   # 同步拼多多开放平台文档（需先导出 JSON）
npm run sync -- --source youzan      # 同步有赞开放平台文档
npm run sync -- --source wechat-pay  # 同步微信支付文档
npm run sync -- --source alipay      # 同步支付宝开放平台文档
npm run sync -- --source jd          # 同步京东商家开放平台文档
npm run sync -- --source shein       # 同步SHEIN开放平台文档
npm run sync -- --source dewu        # 同步得物开放平台文档（需要 playwright）

同步完成后数据库文件位于 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`
`mode`	否	开发模式（仅企业微信）：`internal` / `third_party` / `service_provider`
`limit`	否	返回数量，默认 5，最大 20

技术栈

API: Node.js + Fastify + better-sqlite3 + FTS5
中文分词: nodejieba
Scraper: cheerio + playwright
构建: tsup + tsx

贡献

欢迎提交 Issue 和 Pull Request。

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

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
api		api
data		data
scrapers		scrapers
scripts		scripts
specfusion		specfusion
.dockerignore		.dockerignore
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
SPECFUSION_PLAN.md		SPECFUSION_PLAN.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.base.json		tsconfig.base.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

SpecFusion

为什么用 SpecFusion

安装

方式一：skills CLI（推荐）

方式二：手动安装

安装后找不到 Skill？

使用方式

已接入平台

仅在当前项目安装

自部署

Docker 部署

环境变量

文档同步

本地开发

API 参考

搜索参数

技术栈

贡献

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

SpecFusion

为什么用 SpecFusion

安装

方式一：skills CLI（推荐）

方式二：手动安装

安装后找不到 Skill？

使用方式

已接入平台

仅在当前项目安装

自部署

Docker 部署

环境变量

文档同步

本地开发

API 参考

搜索参数

技术栈

贡献

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages