extore 0.4.0__tar.gz

extore-0.4.0/.dockerignore

@@ -0,0 +1,8 @@
+.git
+.venv
+data
+.env
+output
+.playwright-cli
+.pytest_cache
+__pycache__

extore-0.4.0/.env.example

@@ -0,0 +1,3 @@
+EXTORE_ORIGIN=http://localhost:8000
+EXTORE_DATA=data
+EXTORE_SCRIPTS=scripts

extore-0.4.0/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+custom:
+  - https://donate.lmm.best/?project=extore

extore-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          submodules: recursive
+      - uses: astral-sh/setup-uv@94527f2e458b27549849d47d273a16bec83a01e9 # v7
+        with:
+          version: "0.12.20"
+      - run: uv sync --frozen --python 3.12
+      - run: uv run ruff check extore scripts tests
+      - run: uv run ruff format --check extore scripts tests
+      - run: uv run pytest -q
+      - run: uv run python -m compileall -q extore scripts
+      - run: node --check extore/static/app.js
+      - run: node --check extore/static/preferences.js
+      - run: node --check extore/static/products.js
+      - run: node --check extore/static/cards.js
+      - run: node --check extore/static/webmcp.js
+      - run: node --check extore/static/product-export.js
+      - run: node --check extore/static/customer-motion.js
+      - run: node --check extore/static/source-link.js
+      - run: node --test tests/*.test.cjs
+      - run: uv run pytest -q processors/official/tests
+      - run: uv build
+      - run: uv run extore --help
+      - run: uv run extore --version

extore-0.4.0/.gitignore

@@ -0,0 +1,13 @@
+.venv/
+data/
+__pycache__/
+.pytest_cache/
+.env
+*.sqlite3*
+output/
+.playwright-cli/
+.impeccable/config.local.json
+
+dist/
+
+.ruff_cache/

extore-0.4.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "processors/official"]
+	path = processors/official
+	url = https://github.com/TokenNotIncluded/extore-processors.git

extore-0.4.0/.python-version

@@ -0,0 +1 @@
+3.12

extore-0.4.0/DESIGN.md

@@ -0,0 +1,31 @@
+# Extore 设计
+
+## 使用场景
+顾客在拿到卡密后，快速完成兑换。商家与管理者在桌面或手机上处理任务。页面以完成操作为主。
+
+## 视觉语言
+浅色采用温白纸面、深绿色文字与主按钮；暗色采用中性灰黑背景 `#141414`、卡片 `#212121`，保留绿色操作与状态强调。Logo 是入口与交付格组成的几何 E，标题为「Extore · 兑所」。界面参考撕开的纸：面板底边以简化折线形成撕裂边缘，分隔线为 `-- -- --` 分段虚线。无营销插图和虚构商品。
+
+首页由两张纸卡构成。左卡标题为「公开商品」，商品 Logo、名称和详情入口直接排列在这张纸内；没有公开商品时显示「暂无公开商品」。商品较多时，列表在纸卡内上下滚动，可视高度按窗口限制，保留标题、分段虚线与撕纸底边。右卡是卡密兑换表单。纸卡以柔和的偏移阴影和轻微透视表现层次；直接点击纸面或聚焦卡内控件时，该纸放大，另一张明显缩小，以 440ms 自然减速过渡交接焦点，不另设切换按钮。输入、按钮、链接与列表滚动保持原生交互，不抢输入焦点。两张纸卡可通过 Tab 聚焦，在纸卡本身使用左右方向键切换；商品列表也可单独聚焦后上下滚动。手机默认显示兑换纸卡，采用原生横向滑动与滚动吸附，纵向浏览商品与横向换纸同时可用。减少动态时直接呈现选择状态。
+
+## 显示偏好
+页头提供主题 `auto / light / dark` 和语言 `auto / zh-CN / en` 选择，默认均为 `auto`。自动主题实时响应系统明暗变化；自动语言按 `navigator.languages` 的顺序选择首个支持的中文或英文，无匹配时回退中文。手动选择保存在本浏览器。浅色与深色均保留撕纸折线和分段虚线的视觉语言。
+
+## 字体与布局
+中文优先 Noto Sans CJK SC / PingFang SC / Microsoft YaHei；正文 15px，标题 34–48px。卡密与任务 ID 使用等宽字体。主内容最大 1160px，兑换后页面最大 640px。760px 以下一般内容单列，首页双纸卡保留横向滑动；卡密表在手机上按卡密排列，其他后台表格可横向滚动。
+
+## 状态与交互
+验证、填写、领取三个步骤。卡密验证成功时，旧兑换纸卡沿折线分成上下两半，以 350ms 的位移和透明度过渡进入填写页；过期或被取消的过渡不继续渲染旧流程。减少动态、页面隐藏或动画 API 不可用时直接呈现下一步。
+
+等待页显示实际队列位置、前方任务数、处理说明、已完成与当前步骤，以及处理者上报的百分比。队列由人或 AI 按相同权限规则处理。上下分段虚线分别向右、向左移动，几何纸条作传送装饰；装饰不生成处理进度。用户可暂停动画，减少动态设置、页面隐藏和等待内容离屏时自动停止循环。同一任务的轮询只更新说明、位置、步骤与进度，不反复重建动画。前台轮询间隔为 2.5 秒，隐藏页面降为 15 秒。配置联系邮箱后，「催一下」提供带任务号的 `mailto` 链接，由顾客在自己的邮件应用里确认发送，网站不自动发出催办邮件。
+
+管理后台先选择商品，再查看该商品的任务；批量操作始终限定当前商品。商品管理链接只显示授权商品及权限允许的管理标签；店长通过严格缩权的下级链接继续委派。管理链接默认允许一次新登录，次数耗尽不会结束已登录会话；会话可以单独注销，登录、链接使用、委派和注销有访问审计。完成时按任务保存的输出结构填写结果，顾客逐字段领取；服务商品只显示状态。一次领取和销毁需明确确认。控件有焦点样式，错误由 role=alert 输出。左上角 2.5 秒内连续点击 5 次进入后台；这个入口不承担安全认证。
+
+队列商品可编辑输入和输出字段，新任务采用新定义；已创建的任务保存自己的输入输出与处理步骤快照，重试和交付继续按该任务定义执行。输出结构不同的任务分别处理。自动商品先选择官方预设，输入输出由代码定义，界面只显示它声明的配置项；发行卡密后仍锁定自动商品的字段结构、处理方式、交付与查看规则、处理器及签名密钥。
+
+输入和输出可定义 `file` 字段，分别接收顾客材料和处理者的交付附件，每个文件最多 20 MiB。附件按卡密、任务、字段与权限校验，作为下载文件提供；文件上传不执行程序，也不用于安装处理器代码。界面不提供任意脚本名、代码上传或处理器仓库地址入口。
+
+卡密页按商品、规格与批次显示库存和处理统计，支持状态、规格、批次、内部 ID 与尾号筛选。剩余只统计未兑换且未到期的卡密，可重试卡密另列，销售状态由支付平台负责。制卡必须选择启用的规格，卡密绑定规格，顾客兑换时不能改选。规格汇总计入商品总量，旧卡密归默认规格。原文仅在发行返回时展示，可复制整批、选择单条或下载；更改制卡输入会清除当前原文。详情用不含参数、交付内容或原卡密的时间线追踪领取过程。
+
+## 内容
+Markdown 用本地 Marked + DOMPurify 渲染，不允许脚本、嵌入、表单或图片。参数名称与教程按语言取值并有默认回退。后台维护界面使用中文。

extore-0.4.0/Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.12-slim
+RUN pip install --no-cache-dir uv==0.12.20 && useradd --uid 10001 --create-home extore
+WORKDIR /app
+COPY pyproject.toml uv.lock ./
+COPY extore ./extore
+COPY scripts ./scripts
+RUN uv sync --frozen --no-dev && chown -R extore:extore /app
+ENV PATH="/app/.venv/bin:$PATH" EXTORE_DATA=/data EXTORE_SCRIPTS=/app/scripts PYTHONUNBUFFERED=1
+USER extore
+EXPOSE 8000
+CMD ["uvicorn", "extore.app:app", "--host", "0.0.0.0", "--port", "8000", "--proxy-headers", "--forwarded-allow-ips=127.0.0.1"]

extore-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Extore contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

extore-0.4.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.5
+Name: extore
+Version: 0.4.0
+Summary: Single-merchant redemption and fulfillment with product queues, Passkeys, and native WebMCP
+Project-URL: Homepage, https://extore.lmm.best
+Project-URL: Repository, https://github.com/TokenNotIncluded/extore
+Project-URL: Documentation, https://github.com/TokenNotIncluded/extore/tree/main/docs
+Project-URL: Issues, https://github.com/TokenNotIncluded/extore/issues
+Project-URL: Funding, https://donate.lmm.best/?project=extore
+License-Expression: MIT
+License-File: LICENSE
+Keywords: fulfillment,passkeys,redemption,sqlite,webmcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.12
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: cryptography>=50.0.2
+Requires-Dist: fastapi>=0.142.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: python-multipart>=0.0.22
+Requires-Dist: uvicorn[standard]>=0.54.0
+Requires-Dist: webauthn>=3.0.1
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://extore.lmm.best">
+    <img src="https://raw.githubusercontent.com/TokenNotIncluded/extore/main/extore/static/logo.svg" width="88" height="88" alt="Extore Logo">
+  </a>
+</p>
+
+<h1 align="center">兑所 · Extore</h1>
+
+<p align="center">
+  一个商家的卡密兑换与交付网站。<br>
+  输入卡密，填写信息，领取商品或查看服务结果。
+</p>
+
+<p align="center">
+  <a href="https://github.com/TokenNotIncluded/extore/actions/workflows/ci.yml"><img src="https://github.com/TokenNotIncluded/extore/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href="https://pypi.org/project/extore/"><img src="https://img.shields.io/pypi/v/extore?color=245449" alt="PyPI version"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/pyproject.toml"><img src="https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&amp;logoColor=white" alt="Python 3.12+"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md"><img src="https://img.shields.io/badge/WebMCP-native-245449" alt="Native WebMCP"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="https://extore.lmm.best">在线站点</a> ·
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md">使用文档</a> ·
+  <a href="https://github.com/TokenNotIncluded/extore/issues">问题反馈</a> ·
+  <a href="https://donate.lmm.best/?project=extore">赞助项目</a>
+</p>
+
+---
+
+Extore 接手支付之后的兑换与交付：验证卡密，将顾客带到对应商品，收集必要信息，再交给商品队列、官方处理器或外部服务。支付与支付订单管理留在上游平台，两边通过制卡接口、Webhook 和签名回调通信。
+
+## 能做什么
+
+| 能力 | 说明 |
+| --- | --- |
+| 商品与规格 | 多商品、SKU 档位、价格与属性；卡密绑定商品和规格。支持私有商品、快速模板、中英文参数名称与 Markdown 教程。 |
+| 卡密管理 | 使用密码学安全随机数生成卡密，批量发行、复制与下载；按商品、规格、批次和状态跟踪库存与生命周期。原卡密只在发行时显示。 |
+| 独立商品队列 | 每个商品独立领取、筛选和批处理任务，显示真实步骤、处理消息与商品内排位。人或获授权的 AI 使用同一套接口。 |
+| 灵活交付 | 链接、文本、账户信息或文件，也可只返回服务状态。支持一次领取、重复查看、明确失败后的重试，以及顾客主动销毁内容。 |
+| 权限与认证 | 商家后台支持多个 Passkey。商品管理链接默认可登录 1 次，按权限授权、向下委派，并记录会话与操作审计。 |
+| 自动化与二次开发 | 官方开源预设处理器、Python SDK、签名事件与回调；原生定义 **47 个 WebMCP 工具**，按页面、身份与权限动态提供。 |
+| 界面与存储 | SQLite 持久化任务、事件和投递重试；撕纸与分段虚线界面，灰黑暗色主题、中英文语言，默认跟随系统与浏览器。 |
+
+顾客上传的是兑换材料，管理者上传的是交付文件。官方处理器来自审核后固定版本的[开源子模块](https://github.com/TokenNotIncluded/extore-processors)，商家在预设中选择并填写配置。浏览器 AI 需要原生 WebMCP 支持及实际授权，具体兼容性见[工具文档](https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md#浏览器兼容性)。
+
+## 兑换流程
+
+```text
+卡密 → 对应商品与规格 → 填写参数 / 上传材料 → 处理任务 → 领取内容 / 查看结果
+```
+
+1. 商家创建商品，配置输入、输出、处理方式和查看规则，按规格发行卡密。
+2. 顾客输入有效卡密。非公开商品在验证成功后才显示。
+3. 提交参数后创建唯一任务，重复提交返回同一个任务。
+4. 队列管理者、官方处理器或外部平台完成任务，顾客通过领取链接查看进度和结果。
+
+队列商品可修改未来任务的输入输出，已有任务保留各自的结构快照。自动商品发行卡密后锁定处理器和输入输出结构。SKU 价格用于商品定义，上游平台负责实际定价、收款和销售库存。
+
+## 快速运行
+
+从 [PyPI](https://pypi.org/project/extore/) 安装后，可直接使用 `extore` 命令：
+
+```sh
+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](https://docs.astral.sh/uv/) 和 Linux**。完整环境、部署和备份说明见[运行指南](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md)。
+
+```sh
+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 投递：
+
+```sh
+uv run extore worker
+```
+
+打开 <http://localhost:8000>。在 2.5 秒内点击左上角 Logo 5 次，或直接访问 `/admin`。首次使用初始化密码注册 Passkey，注册成功后密码登录立即禁用；后续可添加多个 Passkey。
+
+<details>
+<summary>首次登录、认证恢复与运行边界</summary>
+
+- Passkey 需要 HTTPS 或 localhost；部署前确定固定域名。首次密码会话只能注册 Passkey，不能管理商品。
+- 丢失全部 Passkey 时，须在服务器终端执行 `uv run python -m extore.cli reset-auth`。它撤销全部 Passkey 和登录会话，保留商品、卡密与任务；商品管理链接须另行撤销。详见[认证恢复](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#认证恢复)。
+- API 与 worker 共享数据目录和配置，一个数据库只运行一个 worker。数据目录、数据库和 `issuance.key` 都要妥善保护和备份。详见[生产运行](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#生产运行)。
+- 领取链接是凭证。一次领取会消耗查看机会；销毁不能撤回已下载的副本、外部内容或历史备份。未知、超时或崩溃的交付默认等待核实，下游须用稳定任务 ID 去重。详见[自动处理与领取](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#自动处理与领取)。
+
+</details>
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [快速入门与运行指南](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md) | 本地运行、管理权限、认证恢复、生产配置、Docker 与 Arch Linux 部署 |
+| [接口与事件协议](https://github.com/TokenNotIncluded/extore/blob/main/docs/protocol.md) | 商品、SKU、卡密、队列、附件、完整事件定义与签名回调 |
+| [原生 WebMCP](https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md) | 47 个工具、浏览器支持、权限范围与确认要求 |
+| [Python SDK](https://github.com/TokenNotIncluded/extore/blob/main/docs/python-sdk.md) | 官方处理器协议、任务结果、外部验签与回调示例 |
+| [验收记录](https://github.com/TokenNotIncluded/extore/blob/main/docs/acceptance.md) | 已记录的验证结果、对接边界与限制 |
+| [产品定义](https://github.com/TokenNotIncluded/extore/blob/main/PRODUCT.md) · [设计说明](https://github.com/TokenNotIncluded/extore/blob/main/DESIGN.md) | 项目范围、交互和视觉原则 |
+
+服务运行后，`/docs` 提供交互式 OpenAPI 文档。事件与回调协议版本为 **v1**。
+
+## 贡献
+
+欢迎通过 [Issues](https://github.com/TokenNotIncluded/extore/issues) 提交可复现的问题或功能建议，也欢迎提交 Pull Request。修改前请阅读[产品定义](https://github.com/TokenNotIncluded/extore/blob/main/PRODUCT.md)与[设计说明](https://github.com/TokenNotIncluded/extore/blob/main/DESIGN.md)，保持单商家范围、商品权限隔离和既有视觉语言。
+
+常用检查如下；完整检查项以 [CI 工作流](https://github.com/TokenNotIncluded/extore/blob/main/.github/workflows/ci.yml)为准：
+
+```sh
+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 请说明行为变化和验证结果。官方预设处理器在[独立仓库](https://github.com/TokenNotIncluded/extore-processors)维护，主项目通过子模块固定版本。反馈或示例中请删除卡密、管理链接、领取凭证、密钥和顾客资料。
+
+## 赞助
+
+如果 Extore 帮到了你，可以通过 [donate.lmm.best](https://donate.lmm.best/?project=extore) 支持项目维护。
+
+<p align="center">
+  <a href="https://donate.lmm.best/?project=extore">
+    <img src="https://donate.lmm.best/badge.svg?project=extore&amp;currency=CNY&amp;lang=zh-CN&amp;period=all&amp;layout=compact&amp;theme=dark&amp;width=440&amp;title=Extore" width="440" alt="Extore 项目累计赞助">
+  </a>
+</p>
+
+## 许可证
+
+Extore 使用 [MIT License](https://github.com/TokenNotIncluded/extore/blob/main/LICENSE)。官方处理器子模块的许可见[其仓库](https://github.com/TokenNotIncluded/extore-processors/blob/main/LICENSE)。

extore-0.4.0/PRODUCT.md

@@ -0,0 +1,45 @@
+# Extore · 兑所
+<!-- impeccable:product-schema 1 -->
+
+## Platform
+web
+
+## Stack
+Python FastAPI、SQLite、原生 HTML/CSS/JavaScript。根据脚本 SDK 需求选择，部署目标为用户指定的 archczy，域名 extore.lmm.best。
+
+## Users
+单个商家、通过商品管理链接获得指定权限的店长与处理人员，以及持有卡密的顾客。顾客无需注册。
+
+## Product Purpose
+顾客输入卡密、填写商品参数，完成一次兑换，领取交付内容或查看服务状态。支付、外部订单和支付平台交付职责归另一网站。
+
+## Operating Context
+队列按商品分开，人和 AI 通过同一套权限接口处理任务；AI 可使用原生 WebMCP。自动处理使用固定版本的官方白名单处理器，或独立外部服务的签名 webhook / 回调。管理者通过限一个商品、可撤销、有期限及登录次数限制的管理链接工作。
+
+## Capabilities and Constraints
+SQLite。安全随机且唯一的卡密、一次兑换、可选重复查看或一次查看、可核实后重试。商品可公开或仅持卡可见；队列商品自定义输入参数与多个交付输出字段，支持多语言名称、URL 与 Markdown 教程。服务商品仅显示状态。任务创建时保存输入输出与处理步骤快照；队列商品可调整新任务的字段，已有任务及其重试按原快照处理。自动商品发行卡密后仍冻结字段结构与处理器，以及处理方式、交付和查看规则；字段名称与说明可改善。商家用 Passkey 登录，支持多个 Passkey；首次密码引导注册，SSH 命令恢复。
+
+商品支持多个规格，每个规格有稳定 ID、名称、说明、可选参考价格、币种、属性与启用状态。发行卡密时选定规格并保存快照，顾客持卡兑换对应规格，无需自行选规格；已发行规格可以停用，不能删除。卡密支持批次、到期时间、尾号定位、商品和规格统计及不含秘密的时间线。剩余只统计未兑换且未到期的卡密，与原顾客可重试卡密分别计数；销售状态归支付平台。卡密原文只在本次发行返回，可整批或单条复制与下载，历史查询不恢复原文。
+
+`file` 输入接收顾客材料，`file` 输出交付处理者上传的附件，每个文件最多 20 MiB。上传与下载限定卡密、任务、字段和对应权限，附件作为下载文件提供；文件不在站点执行，也不是处理器代码上传入口。交付附件同样遵循查看规则和销毁操作，已下载到顾客设备的副本不能撤回。
+
+等待页显示实际任务步骤、处理说明、百分比和商品队列排位。纸条与反向滚动虚线仅作装饰，可由用户暂停，并遵循减少动态设置、页面隐藏及离屏暂停。同一任务轮询更新状态，保持已有动画。商品可配置联系邮箱，「催一下」用预填任务信息的 `mailto` 链接打开用户邮件应用，由用户自行发送，网站不自动发邮件。
+
+主题和语言默认自动，可分别选择浅色/深色与中文/英文。自动主题实时跟随系统；自动语言按浏览器偏好顺序选择中文或英文，无匹配时回退中文。手动偏好保存在本浏览器。
+
+商品管理链接可分别授权队列查看、处理、放行重试、展示与顾客参数编辑、自动发货配置、卡密管理、事件管理与向下委派。自动发货配置须同时获得商品编辑权限，可读写签名密钥、官方处理器配置和重试规则，具有控制该商品外部发货的能力；仅负责商品展示编辑的管理者不获此权限。店长可完全管理指定商品；子链接的权限必须比父链接少，期限不超过父链接，父链接失效则后代也失效。链接不能访问全店设置或管理商家 Passkey。
+
+管理链接 `max_uses` 默认 1，限制成功建立新登录的次数，次数耗尽不注销已有会话。子链接次数上限不能超过父链接设定上限。商家管理全店会话；商品管理者可管理自己的会话，拥有向下委派权限时还可管理授权商品的下级会话。登录、链接使用、委派、退出和注销保留审计记录；会话列表显示设备、地址、登录与活动时间，不显示授权凭证。
+
+自动处理器来自公开仓库 TokenNotIncluded/extore-processors，在 processors/official 子模块固定到审核过的提交。仅支持官方预设及其代码定义的输入输出；商家不能安装任意程序、上传代码或配置 Git 地址。固定代码按 worker 权限运行，不提供恶意代码沙箱。
+销毁立即撤除应用内交付内容和相关参数；无法撤回他人已下载的内容。
+
+## Brand Commitments
+品牌名称为 Extore · 兑所，采用几何 E Logo 与撕纸折线、分段虚线。浅色温白，暗色中性灰黑。首页两张有柔和阴影和轻透视的纸卡，左纸内展示公开商品，右纸输入卡密；桌面点击放大焦点纸卡，手机原生左右滑动且默认兑换卡。卡密验证成功以短暂撕纸过渡进入填写页，减少动态或动画不可用时直接切换。
+
+## Product Principles
+- 兑换一次，重试不等于重新发货。
+- 成功必须有可信处理结果，未知状态等待核实。
+- 非公开商品只向持有效卡密的顾客展示。
+- 顾客专注领取，管理者按商品和权限工作，商家管理全店。
+- 店长可以委派更小的权限，不能越过自己的商品、权限或期限。

extore-0.4.0/README.md

@@ -0,0 +1,143 @@
+<p align="center">
+  <a href="https://extore.lmm.best">
+    <img src="https://raw.githubusercontent.com/TokenNotIncluded/extore/main/extore/static/logo.svg" width="88" height="88" alt="Extore Logo">
+  </a>
+</p>
+
+<h1 align="center">兑所 · Extore</h1>
+
+<p align="center">
+  一个商家的卡密兑换与交付网站。<br>
+  输入卡密，填写信息，领取商品或查看服务结果。
+</p>
+
+<p align="center">
+  <a href="https://github.com/TokenNotIncluded/extore/actions/workflows/ci.yml"><img src="https://github.com/TokenNotIncluded/extore/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href="https://pypi.org/project/extore/"><img src="https://img.shields.io/pypi/v/extore?color=245449" alt="PyPI version"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/pyproject.toml"><img src="https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&amp;logoColor=white" alt="Python 3.12+"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md"><img src="https://img.shields.io/badge/WebMCP-native-245449" alt="Native WebMCP"></a>
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="https://extore.lmm.best">在线站点</a> ·
+  <a href="https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md">使用文档</a> ·
+  <a href="https://github.com/TokenNotIncluded/extore/issues">问题反馈</a> ·
+  <a href="https://donate.lmm.best/?project=extore">赞助项目</a>
+</p>
+
+---
+
+Extore 接手支付之后的兑换与交付：验证卡密，将顾客带到对应商品，收集必要信息，再交给商品队列、官方处理器或外部服务。支付与支付订单管理留在上游平台，两边通过制卡接口、Webhook 和签名回调通信。
+
+## 能做什么
+
+| 能力 | 说明 |
+| --- | --- |
+| 商品与规格 | 多商品、SKU 档位、价格与属性；卡密绑定商品和规格。支持私有商品、快速模板、中英文参数名称与 Markdown 教程。 |
+| 卡密管理 | 使用密码学安全随机数生成卡密，批量发行、复制与下载；按商品、规格、批次和状态跟踪库存与生命周期。原卡密只在发行时显示。 |
+| 独立商品队列 | 每个商品独立领取、筛选和批处理任务，显示真实步骤、处理消息与商品内排位。人或获授权的 AI 使用同一套接口。 |
+| 灵活交付 | 链接、文本、账户信息或文件，也可只返回服务状态。支持一次领取、重复查看、明确失败后的重试，以及顾客主动销毁内容。 |
+| 权限与认证 | 商家后台支持多个 Passkey。商品管理链接默认可登录 1 次，按权限授权、向下委派，并记录会话与操作审计。 |
+| 自动化与二次开发 | 官方开源预设处理器、Python SDK、签名事件与回调；原生定义 **47 个 WebMCP 工具**，按页面、身份与权限动态提供。 |
+| 界面与存储 | SQLite 持久化任务、事件和投递重试；撕纸与分段虚线界面，灰黑暗色主题、中英文语言，默认跟随系统与浏览器。 |
+
+顾客上传的是兑换材料，管理者上传的是交付文件。官方处理器来自审核后固定版本的[开源子模块](https://github.com/TokenNotIncluded/extore-processors)，商家在预设中选择并填写配置。浏览器 AI 需要原生 WebMCP 支持及实际授权，具体兼容性见[工具文档](https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md#浏览器兼容性)。
+
+## 兑换流程
+
+```text
+卡密 → 对应商品与规格 → 填写参数 / 上传材料 → 处理任务 → 领取内容 / 查看结果
+```
+
+1. 商家创建商品，配置输入、输出、处理方式和查看规则，按规格发行卡密。
+2. 顾客输入有效卡密。非公开商品在验证成功后才显示。
+3. 提交参数后创建唯一任务，重复提交返回同一个任务。
+4. 队列管理者、官方处理器或外部平台完成任务，顾客通过领取链接查看进度和结果。
+
+队列商品可修改未来任务的输入输出，已有任务保留各自的结构快照。自动商品发行卡密后锁定处理器和输入输出结构。SKU 价格用于商品定义，上游平台负责实际定价、收款和销售库存。
+
+## 快速运行
+
+从 [PyPI](https://pypi.org/project/extore/) 安装后，可直接使用 `extore` 命令：
+
+```sh
+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](https://docs.astral.sh/uv/) 和 Linux**。完整环境、部署和备份说明见[运行指南](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md)。
+
+```sh
+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 投递：
+
+```sh
+uv run extore worker
+```
+
+打开 <http://localhost:8000>。在 2.5 秒内点击左上角 Logo 5 次，或直接访问 `/admin`。首次使用初始化密码注册 Passkey，注册成功后密码登录立即禁用；后续可添加多个 Passkey。
+
+<details>
+<summary>首次登录、认证恢复与运行边界</summary>
+
+- Passkey 需要 HTTPS 或 localhost；部署前确定固定域名。首次密码会话只能注册 Passkey，不能管理商品。
+- 丢失全部 Passkey 时，须在服务器终端执行 `uv run python -m extore.cli reset-auth`。它撤销全部 Passkey 和登录会话，保留商品、卡密与任务；商品管理链接须另行撤销。详见[认证恢复](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#认证恢复)。
+- API 与 worker 共享数据目录和配置，一个数据库只运行一个 worker。数据目录、数据库和 `issuance.key` 都要妥善保护和备份。详见[生产运行](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#生产运行)。
+- 领取链接是凭证。一次领取会消耗查看机会；销毁不能撤回已下载的副本、外部内容或历史备份。未知、超时或崩溃的交付默认等待核实，下游须用稳定任务 ID 去重。详见[自动处理与领取](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md#自动处理与领取)。
+
+</details>
+
+## 文档
+
+| 文档 | 内容 |
+| --- | --- |
+| [快速入门与运行指南](https://github.com/TokenNotIncluded/extore/blob/main/docs/getting-started.md) | 本地运行、管理权限、认证恢复、生产配置、Docker 与 Arch Linux 部署 |
+| [接口与事件协议](https://github.com/TokenNotIncluded/extore/blob/main/docs/protocol.md) | 商品、SKU、卡密、队列、附件、完整事件定义与签名回调 |
+| [原生 WebMCP](https://github.com/TokenNotIncluded/extore/blob/main/docs/webmcp.md) | 47 个工具、浏览器支持、权限范围与确认要求 |
+| [Python SDK](https://github.com/TokenNotIncluded/extore/blob/main/docs/python-sdk.md) | 官方处理器协议、任务结果、外部验签与回调示例 |
+| [验收记录](https://github.com/TokenNotIncluded/extore/blob/main/docs/acceptance.md) | 已记录的验证结果、对接边界与限制 |
+| [产品定义](https://github.com/TokenNotIncluded/extore/blob/main/PRODUCT.md) · [设计说明](https://github.com/TokenNotIncluded/extore/blob/main/DESIGN.md) | 项目范围、交互和视觉原则 |
+
+服务运行后，`/docs` 提供交互式 OpenAPI 文档。事件与回调协议版本为 **v1**。
+
+## 贡献
+
+欢迎通过 [Issues](https://github.com/TokenNotIncluded/extore/issues) 提交可复现的问题或功能建议，也欢迎提交 Pull Request。修改前请阅读[产品定义](https://github.com/TokenNotIncluded/extore/blob/main/PRODUCT.md)与[设计说明](https://github.com/TokenNotIncluded/extore/blob/main/DESIGN.md)，保持单商家范围、商品权限隔离和既有视觉语言。
+
+常用检查如下；完整检查项以 [CI 工作流](https://github.com/TokenNotIncluded/extore/blob/main/.github/workflows/ci.yml)为准：
+
+```sh
+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 请说明行为变化和验证结果。官方预设处理器在[独立仓库](https://github.com/TokenNotIncluded/extore-processors)维护，主项目通过子模块固定版本。反馈或示例中请删除卡密、管理链接、领取凭证、密钥和顾客资料。
+
+## 赞助
+
+如果 Extore 帮到了你，可以通过 [donate.lmm.best](https://donate.lmm.best/?project=extore) 支持项目维护。
+
+<p align="center">
+  <a href="https://donate.lmm.best/?project=extore">
+    <img src="https://donate.lmm.best/badge.svg?project=extore&amp;currency=CNY&amp;lang=zh-CN&amp;period=all&amp;layout=compact&amp;theme=dark&amp;width=440&amp;title=Extore" width="440" alt="Extore 项目累计赞助">
+  </a>
+</p>
+
+## 许可证
+
+Extore 使用 [MIT License](https://github.com/TokenNotIncluded/extore/blob/main/LICENSE)。官方处理器子模块的许可见[其仓库](https://github.com/TokenNotIncluded/extore-processors/blob/main/LICENSE)。

extore-0.4.0/compose.yaml

@@ -0,0 +1,32 @@
+services:
+  api:
+    build: .
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:8000:8000"
+    environment: &env
+      EXTORE_ORIGIN: ${EXTORE_ORIGIN:-http://localhost:8000}
+      EXTORE_DATA: /data
+      EXTORE_SCRIPTS: /app/scripts
+    volumes: &volumes
+      - ./data:/data
+      - ./scripts:/app/scripts:ro
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "python",
+          "-c",
+          "import urllib.request; urllib.request.urlopen('http://localhost:8000/health', timeout=5)",
+        ]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+    stop_grace_period: 30s
+  worker:
+    build: .
+    restart: unless-stopped
+    command: ["python", "-m", "extore.worker"]
+    environment: *env
+    volumes: *volumes
+    stop_grace_period: 150s

extore-0.4.0/deploy/arch/PKGBUILD

@@ -0,0 +1,34 @@
+pkgname=extore
+pkgver=0.4.0
+pkgrel=3
+pkgdesc='Single-merchant redemption and fulfillment service'
+arch=('x86_64')
+url='https://github.com/TokenNotIncluded/extore'
+license=('MIT')
+depends=('python')
+makedepends=('uv')
+options=('!strip' '!debug')
+backup=('etc/extore/extore.env')
+source=('extore-source.tar.gz')
+sha256sums=('SKIP')
+
+build() {
+  cd "$srcdir/extore-source"
+  uv sync --frozen --no-dev --no-editable --python /usr/bin/python --no-managed-python
+}
+
+package() {
+  cd "$srcdir/extore-source"
+  install -d "$pkgdir/usr/lib/extore"
+  cp -a .venv "$pkgdir/usr/lib/extore/"
+  # Services and scripts launch via python -m; omit source-bound entrypoints.
+  find "$pkgdir/usr/lib/extore/.venv/bin" -type f -delete
+  rm -f "$pkgdir"/usr/lib/extore/.venv/lib/python*/site-packages/extore-*.dist-info/direct_url.json
+  install -Dm644 deploy/arch/extore-api.service "$pkgdir/usr/lib/systemd/system/extore-api.service"
+  install -Dm644 deploy/arch/extore-worker.service "$pkgdir/usr/lib/systemd/system/extore-worker.service"
+  install -Dm644 deploy/arch/extore.sysusers "$pkgdir/usr/lib/sysusers.d/extore.conf"
+  install -Dm644 deploy/arch/extore.env "$pkgdir/etc/extore/extore.env"
+  install -Dm755 deploy/arch/extore-admin "$pkgdir/usr/bin/extore-admin"
+  install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
+  install -Dm644 processors/official/LICENSE "$pkgdir/usr/share/licenses/$pkgname/official-processors-LICENSE"
+}

extore-0.4.0/deploy/arch/extore-admin

@@ -0,0 +1,6 @@
+#!/bin/sh
+set -eu
+set -a
+. /etc/extore/extore.env
+set +a
+exec /usr/lib/extore/.venv/bin/python -m extore.cli "$@"

extore-0.4.0/deploy/arch/extore-api.service

@@ -0,0 +1,24 @@
+[Unit]
+Description=Extore redemption API
+After=network.target
+
+[Service]
+User=extore
+Group=extore
+EnvironmentFile=/etc/extore/extore.env
+WorkingDirectory=/var/lib/extore
+ExecStart=/usr/lib/extore/.venv/bin/python -m uvicorn extore.app:app --host 127.0.0.1 --port 8095 --forwarded-allow-ips=127.0.0.1
+Restart=on-failure
+RestartSec=5
+StateDirectory=extore
+StateDirectoryMode=0700
+UMask=0077
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=strict
+ProtectHome=true
+ReadWritePaths=/var/lib/extore
+TimeoutStopSec=30
+
+[Install]
+WantedBy=multi-user.target