天工卡域 · Artificer Deck

天工卡域 · Artificer Deck

让青少年把一个灵感，炼成能玩、能展、能印的原创卡牌世界。

本地优先、主要交互界面全 Canvas 的桌面卡牌创作软件 Tauri 2 · PixiJS 8.19.0 · Rust 1.97+ · WebGL / Canvas · macOS arm64 Preview

核心能力 · 真实套牌 · 动图演示 · 场景画廊 · 卡牌展厅 · 玩法盒装 · 点对点交换 · 印刷导出 · 本地运行 · AI 服务

交互大厅 · 五域共铸。动态画卷、东方粒子、卡牌倾斜与融合转场共同构成创作入口。

天工卡域是一款面向青少年、家庭与桌游创作者的本地优先桌面卡牌创作软件。Tauri 2 承载本机存储、文件导出与点对点交换，PixiJS 通过 WebGL 优先、Canvas 降级的路径绘制主要交互界面；少量 DOM 只承担输入法、无障碍状态与启动错误提示。用户可以从五种经过构成校验的玩法出发，也可以像搭积木一样组合或编写规则；系统据此计算完整盒装、分批生成不重复卡牌、自动编写玩法说明书，并把作品与历史版本保存在本机。

当前版本：v0.1.2 开发预览
已在本机完成 macOS Apple Silicon（arm64）.app 与 DMG 构建验证。当前 .app 采用 ad-hoc 签名，DMG 未签名，二者均尚未经过 Apple 公证；Intel Mac、Windows 与 Linux 安装包尚未完成发布验证。AI 生成不是离线能力，使用时会把相关提示与图像发送到用户自行配置的兼容服务端点。

核心能力

所有运行时静态资源均随桌面包本地提供：PixiJS、WebGL/Canvas 渲染路径、思源黑体与思源宋体、界面纹理、图标、背景和内置样卡均不依赖 CDN。

真实生成套牌

README 现在放入一套真实生成的《星图回响 · 完整配对套牌》。这不是单张样卡拼贴：前 40 张来自本机作品库中已经炼制好的《星图回响 · 炼制中》，再沿用软件的 OpenAI 兼容图像流程补生成 8 张，最终补齐为 24 对 / 48 张 的完整记忆配对盒装。每张牌保留独立卡名、A/B 半契、稀有度、数值与玩法线索。

真实作品库素材继续补齐：48 张完整记忆配对牌，可展览、可印刷、可继续编辑。

动图演示

制卡过程 · 逐张写入完整套牌 从作品库素材到补齐缺口，进度阵列会按卡牌完成顺序点亮，生成结果同步成为可继续编辑的本机作品。

牌桌展览 · 扇形、网格、翻面与散落 2D 引擎展示卡牌扇形展开、网格归位、统一卡背翻转与物理牌桌散落效果。

48 张完整牌面

24 组星痕半契全部齐套；卡图来自本机作品库与补生成素材，卡面由同一套实时卡牌系统渲染。

场景画廊

铸卡台 · 套牌与单卡设计 主题、风格、数值、能力、铭文与完整盒装生成集中在同一工作面；中央卡牌实时响应光照与视角。

统一卡背 · 翻转预览 正面保留大幅角色画面，能力词条仅在需要时浮现；翻面可检查套装纹理、徽记和作者铭牌。

玩法绣机 · 规则积木与说明书 组合机制、参数与自定义牌型，实时计算盒装张数、单局投入和牌面密度，并生成可印刷说明书。

本地作品库 · 多版本归档 套牌、版本、采用状态和创作者信息全部保存在当前系统账户，可继续设计、展览或导出。

牌组展览 · SSR 鉴赏 像真实桌面一样摊开、拖拽和翻转作品，让卡牌质感、稀有标识与全息层成为创作成果的主角。

去中心交换站 · 本机点对点直连 本机身份、附近发现、连接码、待交换套牌和签名交换记录在一个场景中完成。

AI 灵枢 · 本机凭证与服务卡 配置兼容 OpenAI API 的 HTTPS 端点、图像与文本模型；密钥只在桌面本机保存且不会回显。

创作权属 · 原创与个人同人研习 原创世界默认启用；个人同人研习需要逐项确认权利、非商业边界、非官方属性与监护人知情。

卡牌专门展厅

这里展示的是天工卡域自身 CardView 经过 WebGL 合成后的真实卡面，不是另行制作的宣传 mockup。每套原型包含不同角色、不同玩法身份与不同数值，同时共享一套材质、纹样、题名和稀有光层；AI 生成时会沿用所选方向，但不会把样卡角色当成固定模板。

五域同台 · 漆器、绢本、矿彩、剪纸与霓虹工艺通过同一套实时卡面系统呈现。

闪击试炼 · 漆器鎏金

朱漆玄光、鎏金游线与六枚观察符号。任意两张牌仍由确定性配方保证唯一同纹。

同套插画： 02 · 03 · 04

星图回响 · 绢本青绿

青绿流光、星图碎片与互补半印。每一对共享识别核心，但角色画面彼此不同。

同套插画： 02 · 03 · 04

万象棋局 · 敦煌矿彩

沉着矿色、土金边饰与数量类别印记。数值和触发关系直接来自玩法槽位。

同套插画： 02 · 03 · 04

共鸣剧场 · 锦纸剪影

层叠纸纤维、吉祥窗花与语义类别印记。大幅角色画面保留完整动作和线索空间。

同套插画： 02 · 03 · 04

奇趣乱斗 · 霓虹国潮

古纹新电、夜市流光与危机牌标识。功能类型和风险关系会随自定义玩法重新编译。

同套插画： 02 · 03 · 04

卡面插画采用等比 cover 布局填满安全区，不会横向或纵向压扁；完整能力说明保留在悬停详情与印刷说明书中，正面只显示紧凑词条，让角色画面占据主要面积。交互生成向兼容端点请求其支持的快速规格 1024 × 1024 / low，再于本机裁切并保存为 700 × 900 WebP；直接请求非标准的 700 × 900 可能被兼容端点拒绝。

完整套牌管线已完成 56 张、7 批 × 8 张 的离线压力验证：56 个玩法槽位、卡名、能力、风味与卡图结果均保持唯一，进度阵列会按完成顺序逐张点亮，图片优化期间峰值只解码 1 张卡图。该测试拦截远端请求，不消耗 AI 额度；真实生成时间仍取决于所配置端点的排队、限流和模型速度。

从灵感到成品

选择玩法骨架 　→　 搭建规则积木 　→　 计算盒装槽位 　→　 AI 分批创作 　→　 绑定玩法数值 　→　 保存本地版本

最终作品可进入牌组展览、印刷导出；仅原创套牌可进入 P2P 交换。

生成完整套牌时，系统先建立每张牌的玩法槽位，再将任务拆成小批次交给 AI。角色分类、能力词条、双数值和稀有度随后由确定性规则编译并复核；如果张数不符、槽位重复或玩法约束不成立，整套结果不会被当作可游玩的完整牌组保存。

玩法与完整盒装

五种内置模板关注玩法结构，不复刻示例桌游的角色、美术、名称或品牌素材。

自定义玩法支持 12–64 张完整盒装、至少 8 张标准单局投入。玩家可以自行定义牌型和数量，再叠加观察、记忆、数量、协作、风险、回合控制等推荐积木；系统先计算构成和投影密度，再生成卡面与说明书，并拒绝缺槽、重复牌型或过密牌面。

本地优先与 AI 边界

桌面开发版可从项目根目录 .env 注入服务设置；正式发行包不会读取或编译项目 .env。每位用户应在软件的“AI 服务”页面填写自己的密钥，密钥保存在当前系统账户的私有应用配置中，不会进入导出的卡包。

OPENAI_BASE_URL=https://claudegpt.org/v1
OPENAI_API_KEY=replace-with-your-own-key
OPENAI_IMAGE_MODEL=gpt-image-2
OPENAI_TEXT_MODEL=grok-4.5

点对点交换，不是区块链市场

天工卡域不运行平台市场、积分账本、排行榜、中心数据库、DHT 或平台中继。桌面端只有在用户明确点击后才启动 libp2p 节点，以 QUIC 加密连接，使用 mDNS 发现局域网设备，并通过 Identify、Ping 与 Request/Response 完成卡包交换。

每台设备会持久保存 Ed25519 本机身份；卡包使用项目自定义的 BLAKE3 内容 ID（不是 IPFS CID）寻址并签名。本机会先验证数据结构、青少年文本规则、内容 ID、Peer ID 与签名，再由用户决定是否接受。交换记录以原子方式写入当前系统账户的私有目录，应用重启后可恢复最近状态。

真实网络限制
局域网体验最可靠。跨网络可交换连接码，但至少一端需要可路由 IPv6、公网 IPv4 或端口映射；双方均处于运营商级 NAT 或对称 NAT 后时，严格零服务器方案无法保证连接。签名只证明内容未被篡改并来自某个节点密钥，不代表实名、版权、唯一所有权或对方已删除副本；本地日志不是区块链账本，也不构成无信任的绝对原子交换。

“个人同人研习”套牌永远只保留在本机，不能进入 P2P；只有通过创作权属检查的原创套牌可以交换。

印刷导出

完整且通过牌型校验的套牌可以导出：

• 63 × 88 mm 标准卡牌，四边各 3 mm 独立出血与出血区外裁切线；
• 约 300 PPI 的卡面、镜像卡背和印刷风格玩法说明书；
• 低可见度套牌版本标记与用于版权追踪的本地水印信息；
• RGB 快速打样，或桌面端 PDF 1.6 / PDF/X-4 CMYK 印厂文件；
• 随包固定提供的 FOGRA39L Coated ICC、OutputIntent、A4 六拼页框与结构验证。

项目当前不输出 Adobe Illustrator（AI）文件。FOGRA39L 只描述一种涂布纸印刷条件，不能保证匹配具体纸张、油墨、专色、覆膜或印刷机；项目内自动验证也不能替代 Acrobat/callas 预检、印厂软打样与实物打样。

青少年安全与创作权属

AI 路径会在请求前后检查主题、规则和可见文本。新生成或接收的非内置插画必须通过用户所配置端点的实际图像审核，无法确认时按不通过处理。自动审核不能替代监护与人工判断。

“个人同人研习”模式仅允许用户在本机进行个人、非商业的学习、研究和同人创作。用户必须确认对导入、引用及生成所依据的素材拥有合法权利或必要许可，不得销售、收费交换、众筹或用于广告推广；未成年人须由监护人共同阅读并确认。

该模式不会授予或暗示原作授权，免责声明也不能使未经许可的使用当然合法。完成全部确认后，个人同人研习套牌可以在本机展览及个人印刷，导出物会写入“非商业同人创作 / 非官方授权”标记与完整声明；P2P 仍被禁止。公开传播或商业使用前，用户必须另行取得权利人授权。

免责声明

天工卡域按“现状”提供，属于开发预览软件。除 GNU GPL 明确规定的范围外，项目作者和维护者不对软件的准确性、稳定性、持续可用性、数据不丢失、设备兼容性、印刷效果、特定用途适用性或任何直接、间接损失作保证或承担责任。

AI 服务、模型、生成结果、审核结果、第三方端点、网络连接、价格、体验额度与可用性由相应服务提供者决定。使用 AI 功能时，提示词、规则上下文和图像可能会发送到用户选择的服务端点；用户应自行阅读该服务的条款与隐私政策，并自行保管、撤销和轮换 API 密钥。项目维护者不会在仓库中提供或索要用户密钥。

用户对导入、生成、保存、印刷、发布、交换或商业使用的文字、图像、卡牌、字体和其他素材承担全部权利审查责任。用户必须确保拥有必要的著作权、商标许可、肖像许可和其他授权；软件的安全检查、免责声明、原创模式或个人同人研习模式都不构成权利授权、法律意见或对第三方权利的豁免。

P2P 交换只证明传输内容与节点签名的一致性，不证明实名身份、版权归属、唯一所有权、内容安全或对方删除了副本。QQ 群、第三方站点和体验额度均不属于本软件运行所必需的组成部分，相关规则和服务变化以其运营方公告为准。

本地运行

建议使用 Node.js 22 LTS、Rust 1.97+，以及当前平台要求的 Tauri 2 系统依赖；Vite 至少需要 Node.js 20.19 或 22.12。

npm ci
cp .env.example .env  # 仅在开发 AI 能力时需要
npm run desktop

浏览器预览可使用 npm run dev，但 P2P 节点、原生 PDF 保存窗口、桌面 AI 命令和私有应用目录只在 Tauri 应用中可用。

构建与验证

npm test
npm run build
cargo test --manifest-path src-tauri/Cargo.toml
npm run desktop:build
npm run qa:desktop-bundle

macOS 本地构建产物：

src-tauri/target/release/bundle/macos/天工卡域.app
src-tauri/target/release/bundle/dmg/天工卡域_0.1.2_aarch64.dmg

npm run desktop:build 会把安装说明和“一键安装.command”一并写入 DMG 根目录。脚本只会在用户主动打开并确认后运行：将应用复制到 /Applications，请求管理员权限，再执行 sudo xattr -dr com.apple.quarantine。该操作不会替代来源核验、SHA-256 校验或 Apple 公证。

印刷校样与结构验证：

npm run qa:print-proof
npm run qa:print-proof:verify
npm run qa:pdfx4
npm run qa:pdfx4:verify -- "/absolute/path/to/deck--pdfx4.pdf"

GitHub 自动发布

向 main 推送符合 vMAJOR.MINOR.PATCH 格式的版本标签后，GitHub Actions 会在 Apple Silicon macOS runner 上自动构建 .app 与 .dmg，生成 SHA-256 校验文件，并创建 GitHub Release 上传 DMG：

git tag v0.1.2
git push origin v0.1.2

当前发布包采用 ad-hoc 签名。若要启用 Apple 公证，需要在 GitHub Actions secrets 中配置 Apple Developer 的公证凭据；没有这些凭据时，工作流仍会完成 DMG 构建和发布。

许可与第三方材料

项目源代码依据 GNU GPL v3 or later（GPL-3.0-or-later）发布。随包字体、ICC 色彩配置、示例卡图、展示素材与第三方组件分别受其自身许可或权利声明约束，详见 THIRD_PARTY_NOTICES.md 与 本地字体说明。产品名与标准名只用于说明兼容性或目标印刷条件，不表示相关权利人对本项目的认可或背书。

欢迎通过 CONTRIBUTING.md 参与维护；安全问题请先阅读 SECURITY.md，不要在公开 issue 中提交密钥或私人卡包。

AI 服务与交流群

QQ 群：555354813 扫码加入后，可申请一次性体验额度

ClaudeGPT · OpenAI 兼容 AI 服务

天工卡域本体免费开源；AI 文本与图像生成是需要联网和独立额度的可选能力。项目维护者推荐的 ClaudeGPT 提供 OpenAI 兼容接口，可在软件的“AI 服务”页配置。

站点： https://claudegpt.org/

API 端点： https://claudegpt.org/v1

体验额度： 加入 QQ 群 555354813 后，可申请一次性体验额度。

价格、模型、额度和可用性以站点及群公告为准。ClaudeGPT 是第三方服务，并非 OpenAI 官方服务，也不是操作系统必需组件；用户可以改用其他兼容 OpenAI API 的 HTTPS 端点。使用第三方服务时，相关提示与图像会发送给该服务商，请先阅读其条款与隐私说明。

github.com/suifei/artificer-deck

Copyright © 2026 Artificer Deck contributors · Source code licensed under GPL-3.0-or-later