hypercross
40f2190307
Persist name and role to localStorage and URL parameters when received via patch to ensure synchronization. Broadcast full state upon successful connection.
TTTK — Tabletop Toolkit
A TTRPG content preview and compilation tool based on solid.js and rsbuild. Write markdown, preview in browser.
快速开始
# 无需安装，直接使用
npx tttk serve ./content
文档导航
| 文档 | 说明 |
|---|---|
| 📖 CLI 使用说明 | CLI 安装、命令和用法 |
| 📦 npm | npx tttk serve ./content |
| 🛠️ 开发指南 | 项目结构、开发规范和构建 |
| 📝 Markdown 编写说明 | Markdown 语法和组件用法 |
| 📊 CSV 编写说明 | CSV 文件格式、字段定义、变量语法 |
| 🤖 MCP 服务器说明 | AI 助手集成、卡牌生成工具 |
功能概览
- CLI 工具:
tttk serve预览模式 和tttk compile编译模式 - Markdown 解析: 支持指令语法、YAML 标签、mermaid 图表
- TTRPG 组件: 骰子、表格、卡牌、标记、命令追踪器等
核心组件
| 组件 | 语法 | 说明 |
|---|---|---|
| 🎲 骰子 | :dice[2d6+d8] |
掷骰并记录结果 |
| 📊 表格 | :table[./data.csv] |
标签页式表格 |
| 🃏 卡牌 | :md-deck[./cards.csv] |
卡牌布局 |
| 📍 标记 | :md-pin[A]{x=40 y=40} |
图片标记 |
| 📋 追踪器 | :md-commander |
命令历史和状态追踪 |
技术栈
- 前端: Solid.js 1.9+
- 构建: Rsbuild
- 样式: Tailwind CSS 4
- Markdown: marked + marked-directive
- 测试: Jest
许可证
MIT