OpenCard 是一个面向桌游设计师和内容创作者的桌面卡牌工作台。
它把 版式设计、卡牌内容和批量实例 放在同一个项目里：先用蓝图定义一套可复用的卡牌结构，再创建多个实例填入不同内容，最后统一处理字体、图标和字典文本。
0.4.0 Early Access：核心编辑工作流已经可以体验，但 OpenCard 仍在早期开发阶段。发布、项目版本管理和协作能力尚未达到完整产品的状态，请在升级前备份项目文件。
- 制作卡牌、角色卡、道具卡和其他固定版式的图文组件
- 用一套蓝图生成多张内容不同、外观一致的卡牌
- 在可视化编辑器中调整文字、图片、布局、颜色和字体
- 注册项目字体与精灵图图标集，作为可复用资源
- 用全局字典集中维护名称、描述和其他重复文本
OpenCard 适合“同一套设计需要反复填充”的项目。它不是通用的图片编辑器，也不是在线协作平台；它更像一份能持续维护的卡牌项目文件。
| 概念 | 解决的问题 | 对用户的意义 |
|---|---|---|
| 蓝图 | 哪些结构和版式应该共享 | 修改一次，可以影响同一套卡牌的共同设计 |
| 实例 | 每张卡具体填入什么内容 | 在保持统一版式的同时，维护每张卡的差异 |
| 项目资源 | 字体、图标和重复文本如何复用 | 把资源集中管理，减少重复导入和手工修改 |
从工作区进入项目文件。项目树负责定位文档，主编辑区负责查看和修改当前内容。
截图占位：工作区
待补一张能同时展示项目树、文档入口和主编辑区域的画面。截图应说明“打开项目后从哪里开始”，而不是只展示界面全貌。
先搭建卡牌的结构和共享版式，再决定哪些内容由实例提供。这样可以把“设计一次”和“填充很多次”分开。
截图占位：蓝图编辑器
待补一张能看出结构树、画布和属性面板关系的画面，并在图注中解释用户下一步该做什么。
从蓝图创建实例后，每张卡都可以单独选择和编辑。共享设计留在蓝图中，单卡差异留在实例中，适合批量制作同款卡牌。
截图占位：实例列表与单卡编辑
待补一张能清楚展示“蓝图 → 实例”的关系和实例数量变化的画面。
把项目字体、图标集和全局字典作为项目的一部分维护。精灵图可以在图标集编辑器中裁剪成可复用图标；重复出现的文案可以放入字典，后续集中修改。
截图占位：项目资源工作流
待补一组经过策划的资源画面：图标集编辑器和全局字典各一张，图注要分别说明“资源如何登记”和“文本如何复用”。
OpenCard 当前更适合作为编辑和维护工作台。完成一轮设计后，可以继续调整蓝图、实例和项目资源；正式发布流程仍在完善中。
- 卡牌文档与项目工作区
- 蓝图、实例树和实例覆写
- 画布、结构树和属性面板协同编辑
- 文本、图片、布局、颜色和字体编辑
- 项目字体登记与复用
- 精灵图图标集的登记、裁剪和配置
- 全局字典记录的查看与编辑
- 深色和浅色主题
- 面向最终使用者的发布流程
- 完整的项目版本管理与历史管理
- 更成熟的导出和交付流程
- 网络联机式项目测试
- 在线协作与云端同步
这些项目不是 0.4.0 的隐藏承诺。重要项目请使用外部备份或 Git 等版本控制工具保存可回退副本。
0.4.0 的目标是把“组织项目 → 设计蓝图 → 创建实例 → 管理资源”这条主线做成可以实际使用的桌面工作流。早期体验阶段意味着：
- 文件格式和交互细节可能在后续版本调整
- 现有功能可能继续收紧边界或改变入口
- 发布与版本管理尚未形成完整的发行管线
- 项目当前以单机工作流为主，不承诺在线协作和云端同步
建议在体验新版本前复制项目目录，并保留可以重新打开的旧版本。
OpenCard 当前主要通过源码运行。需要 Node.js、npm，以及 Tauri 2 的本地开发环境。
git clone https://github.com/OpenC4rd/OpenCard.git
cd OpenCard/opencard-app
npm install
npm run tauri dev常用命令：
# 启动 Vite 开发服务器
npm run dev
# 类型检查并构建前端
npm run build
# 运行测试
npm testOpenCard/
├─ opencard-app/ # Vue + Tauri 应用
├─ docs/ # 项目文档
└─ README.md # 项目入口说明
- 版本变化：
opencard-app/RELEASE_NOTES.md - 工程约定：
docs/工程规则.md - UI 组件规范：
docs/UI_RULES.md - 架构与数据流：
docs/架构.md - 问题反馈：GitHub Issues
OpenCard 目前以 Early Access 形式持续迭代。使用、修改或分发前，请以仓库中的许可证文件和最新发布说明为准。