Endfield Docmaker
用于生成《明日方舟：终末地》游戏世界观中各机构签发的红头公文的工具
[!IMPORTANT] 该工具仅供娱乐与学习交流之用，请在合理、合法的范围内使用。
该工具本身无法在不修改代码的前提下仿造真实文件或真实存在的机构签发的文件。
因对该工具的不合理使用而产生的任何直接或间接责任、损失或纠纷，使用者自行承担。
他人对该仓库代码作出的任何改动、由此产生的风险或后果均与该仓库所有者无关。
功能特性
- 在浏览器中实时生成红头公文风格的 PDF 文件，无需后端服务
- 支持自定义签发机构、文件标题、发文字号、签发日期等参数
- 自动生成带有随机偏移和旋转的圆形公章
- 基于 Typst 排版引擎，内容区域支持 Typst 标记语法
- PDF 实时预览、在新标签页中打开、下载
- 表单内容自动持久化至浏览器本地存储
- 明暗主题切换
- 中英双语界面
部署
- GitHub Pages: https://naptie.github.io/endfield-docmaker/
- Cloudflare: https://endfield-docmaker.phi.zone/
- Vercel: https://endfield.phi.zone/docmaker/
技术栈
| 层级 | 技术 |
|---|---|
| 框架 | SvelteKit + Svelte 5 (Runes 模式) |
| 排版引擎 | Typst (通过 WebAssembly 在浏览器中运行) |
| 组件库 | shadcn-svelte + Bits UI |
| 样式 | Tailwind CSS 4 |
| 国际化 | Paraglide JS (Inlang) |
| 图标 | Phosphor + Lucide |
| 构建工具 | Vite |
| 部署 | 静态站点 (@sveltejs/adapter-static) |
项目结构
endfield-docmaker/
├── messages/
│ ├── en.json # 英文本地化文本
│ └── zh.json # 中文本地化文本
├── scripts/
│ └── manage-messages.ts # i18n 文案管理脚本
├── src/
│ ├── routes/
│ │ ├── +layout.svelte # 根布局
│ │ ├── +layout.ts # 根布局加载逻辑
│ │ ├── +page.svelte # 主页面（表单 + PDF 预览）
│ │ └── layout.css # 全局样式与主题变量
│ └── lib/
│ ├── constants.ts # 常量定义
│ ├── index.ts # 公共导出
│ ├── tint.ts # 颜色处理
│ ├── typst.svelte.ts # Typst WASM 初始化与编译逻辑
│ ├── utils.ts # 工具函数
│ ├── hooks/ # 业务 hooks
│ ├── assets/
│ │ ├── fonts/ # 字体资源
│ │ ├── logos/ # 机构 Logo
│ │ └── typst/
│ │ ├── official-doc.typ # 红头文件模板
│ │ └── tuzhang.typ # 圆形公章生成器
│ ├── components/
│ │ ├── DateInput.svelte # 日期输入组件
│ │ ├── Footer.svelte # 页脚
│ │ ├── LocaleSwitch.svelte # 语言切换
│ │ ├── ThemeToggle.svelte # 明暗主题切换
│ │ └── ui/ # shadcn-svelte 组件
│ └── paraglide/ # i18n 生成文件
└── package.json
本地开发
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev
# 类型检查
pnpm check
# 格式化 + 检查
pnpm fl
# 构建静态站点
pnpm build
致谢
- ParaN3xus — 红头公文 Typst 模板 (
official-doc.typ) - Lonyou — 圆形公章 Typst 模板 (
tuzhang.typ) - Cuilb — 罗德岛、宏科院、联盟工团、环塔商会矢量复刻 Logo
- typst.ts — Typst WebAssembly 编译器
- shadcn-svelte — UI 组件库
星标历史
