兑所 · Extore

一个商家的卡密兑换与交付网站。
输入卡密，填写信息，领取商品或查看服务结果。

在线站点 · 使用文档 · 问题反馈 · 赞助项目

Extore 接手支付之后的兑换与交付：验证卡密，将顾客带到对应商品，收集必要信息，再交给商品队列、官方处理器或外部服务。支付与支付订单管理留在上游平台，两边通过制卡接口、Webhook 和签名回调通信。

能做什么

顾客上传的是兑换材料，管理者上传的是交付文件。官方处理器来自审核后固定版本的开源子模块，商家在预设中选择并填写配置。浏览器 AI 需要原生 WebMCP 支持及实际授权，具体兼容性见工具文档。

兑换流程

卡密 → 对应商品与规格 → 填写参数 / 上传材料 → 处理任务 → 领取内容 / 查看结果

1. 商家创建商品，配置输入、输出、处理方式和查看规则，按规格发行卡密。
2. 顾客输入有效卡密。非公开商品在验证成功后才显示。
3. 提交参数后创建唯一任务，重复提交返回同一个任务。
4. 队列管理者、官方处理器或外部平台完成任务，顾客通过领取链接查看进度和结果。

队列商品可修改未来任务的输入输出，已有任务保留各自的结构快照。自动商品发行卡密后锁定处理器和输入输出结构。SKU 价格用于商品定义，上游平台负责实际定价、收款和销售库存。

快速运行

从 PyPI 安装后，可直接使用 extore 命令：

uv tool install extore
export EXTORE_DATA="$HOME/.local/share/extore"
extore init
extore serve

另开一个终端，设置相同的 EXTORE_DATA 后运行 extore worker。extore --help 查看全部命令，extore --version 查看版本。生产环境还须配置 EXTORE_ORIGIN 并提供 HTTPS，见运行指南。

也可以从源码运行：

需要 Python 3.12+、uv 和 Linux。完整环境、部署和备份说明见运行指南。

git clone --recurse-submodules https://github.com/TokenNotIncluded/extore.git
cd extore
uv sync --frozen
uv run extore init
uv run extore serve

另开一个终端，在项目目录启动 worker，处理自动发货和 Webhook 投递：

uv run extore worker

打开 http://localhost:8000。在 2.5 秒内点击左上角 Logo 5 次，或直接访问 /admin。首次使用初始化密码注册 Passkey，注册成功后密码登录立即禁用；后续可添加多个 Passkey。

命令行处理商品队列

安装后执行 extore manage login，在隐藏输入中粘贴完整商品管理链接；也可用 --link-stdin 从标准输入接收。客户端保存设备密钥，8 小时会话到期后通过设备签名续签，直到授权过期或撤销。商家可复制一段机器人接入提示词，其中的 CLI 专用票据有效 5 分钟，用于首次绑定。

extore manage products
extore manage queues --all
extore manage jobs --product PRODUCT_ID

多个商品来自各自独立授权，聚合发生在客户端，任何写操作仍明确选择单个商品。完整命令与权限说明见CLI 文档。CLI 提供管理操作，运行持续处理机器人由接入方安排。

文档

服务运行后，/docs 提供交互式 OpenAPI 文档。事件与回调协议版本为 v1。

贡献

欢迎通过 Issues 提交可复现的问题或功能建议，也欢迎提交 Pull Request。修改前请阅读产品定义与设计说明，保持单商家范围、商品权限隔离和既有视觉语言。

常用检查如下；完整检查项以 CI 工作流为准：

uv run ruff check extore scripts tests
uv run ruff format --check extore scripts tests
uv run pytest -q
node --test tests/*.test.cjs

Pull Request 请说明行为变化和验证结果。官方预设处理器在独立仓库维护，主项目通过子模块固定版本。反馈或示例中请删除卡密、管理链接、领取凭证、密钥和顾客资料。

赞助

如果 Extore 帮到了你，可以通过 donate.lmm.best 支持项目维护。

许可证

Extore 使用 MIT License。官方处理器子模块的许可见其仓库。