hypercross
/
ttrpg-tools
2
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
371 Commits 1 Branch 0 Tags 4.6 MiB
TypeScript 99.2%
CSS 0.4%
JavaScript 0.3%
Go to file
hypercross 749b1a6a4b feat: support multiple attributes and `as` directive in inline blocks 
Update the inline block parser to support arbitrary key-value pairs.
If an `as` attribute is provided, the block is replaced with a
directive (e.g., `:directive[path]{attrs}`) instead of being
stripped. If no `as` attribute is present, the block is removed.
Additionally, filenames are now automatically generated using a
content hash if the `file` attribute is missing.
 		2026-07-08 16:02:19 +08:00
.husky feat(husky): Add post-merge hook and prepare script 2026-06-26 11:22:15 +08:00
.idea chore: todo clean up 2026-02-28 17:40:02 +08:00
content fix(layer-editor): use stable _key for drag-and-drop sorting 2026-07-03 21:49:18 +08:00
docs refactor: remove token and token-viewer components 2026-07-08 15:09:22 +08:00
src feat: support multiple attributes and `as` directive in inline blocks 2026-07-08 16:02:19 +08:00
.gitignore fix: inline-schema type file write 2026-03-31 16:20:42 +08:00
QWEN.md refactor: qwen 2026-03-01 11:38:19 +08:00
README.md docs: update 2026-03-26 11:24:28 +08:00
jest.config.js chore: test suite 2026-03-15 11:44:23 +08:00
package-lock.json feat: add bundle analysis support 2026-07-08 15:16:12 +08:00
package.json feat: add bundle analysis support 2026-07-08 15:16:12 +08:00
rsbuild.config.ts feat: add bundle analysis support 2026-07-08 15:16:12 +08:00
todo.md feat: details 2026-03-01 09:49:01 +08:00
tsconfig.cli.json feat: ai's first take... 2026-02-26 00:17:23 +08:00
tsconfig.json refactor(markdown): Replace `using` with try-finally 2026-06-25 20:33:08 +08:00

README.md

TTRPG Tools

一个基于 solid.js 和 rsbuild 的 TTRPG 工具箱，支持 Markdown 解析、自定义组件和 CLI 工具。

快速开始

# 安装依赖
npm install

# 全局安装 CLI
npm link

# 预览内容
ttrpg serve ./content

文档导航

文档 说明
📖 CLI 使用说明 CLI 安装、命令和用法
🛠️ 开发指南 项目结构、开发规范和构建
📝 Markdown 编写说明 Markdown 语法和组件用法
📊 CSV 编写说明 CSV 文件格式、字段定义、变量语法
🤖 MCP 服务器说明 AI 助手集成、卡牌生成工具

功能概览

  • CLI 工具: serve 预览模式 和 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