TypeScript工具站

jdf — TypeScript 工具站模板

作者 uurtech

面向 AI 时代的 JSON 文档标准，含桌面阅读器、JS 渲染库与 CLI，可导入 PDF/MD。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图

演示站首页的真实桌面布局。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。本截图因高度限制未包含整页。

采集于 2026-09-27查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

纯 JSON 文档格式，可用文本编辑器查看，git diff 友好

三端覆盖：macOS 桌面编辑器、网页渲染库、CLI 转换工具

PDF 导入宣称全保真，提取位置、字体、颜色等细节

桌面端支持实时 JSON 视图与双向绑定

CLI 支持无头转换，适合 RAG 摄取或 CI 流程

jdf.js 可通过单标签嵌入任意网页

模板详细介绍

jdf 是一个围绕 JSON Document Standard 构建的开源项目，目标是为 AI 时代重新定义文档格式。它提供三种运行形态：原生 macOS 桌面应用 JDF Reader（支持编辑、导入 PDF/MD、导出 PDF）、可嵌入网页的 JavaScript 库 jdf.js（用于渲染 .jdf 文件），以及命令行工具 @uurtech/jdf-cli（用于校验和格式转换）。项目核心是 .jdf 文件——一种纯 JSON 文档格式，可用任何文本编辑器查看源码，也能在阅读器中渲染成页面，两边双向同步。当文档包含图片、字体等资源时，会打包成 .jdfx 文件，仍保持单一文件自包含。

JDF 的定位是让文档从静态存储变成可交互的界面。它强调 JSON 带来的通用性：git diff 能显示行级变更、JSON Schema 可校验结构、文本搜索即可检索内容。桌面阅读器支持双击编辑、悬停工具栏、插入栏、页面缩略图等操作，并提供实时 JSON 视图与双向绑定。PDF 导入宣称达到全保真，能从 PDF 中提取文本位置、字体、颜色、透明度等信息，生成视觉上一致的 JDF 副本。CLI 支持无头转换，适合 RAG 摄取或 CI 流程。

需要留意的是，项目仍处于早期阶段（GitHub 34 stars），macOS 应用未签名，首次启动需手动绕过 Gatekeeper。Linux 和 Windows 构建产物虽由 CI 生成，但桌面编辑功能仅在 macOS 上完整可用，jdf.js 仅负责渲染，CLI 不提供交互式编辑。若你考虑在生产环境使用，建议先核对许可证状态（README 未明确）、验证 PDF 导入的保真度是否满足需求，并评估 .jdf 格式的生态成熟度。

可直接运行在线工具表单交互文本处理文件处理

适合你的项目吗？

适用场景

需要将 PDF 或 Markdown 转换为可编辑、结构化的 JSON 文档
构建 AI 驱动的文档处理流程，希望文档天然可被程序解析
在网页中嵌入渲染 .jdf 文档，并希望保持视觉一致性
探索 AI 原生文档格式，用于知识库或内容管理系统

适合人群

对 JSON 文档格式感兴趣的技术团队
需要 PDF 转可编辑格式的开发者
希望文档可被 AI 直接读取和推理的项目
愿意尝试新格式并接受早期阶段风险的用户

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
桌面端推荐通过 Homebrew 安装（brew tap uurtech/jdf && brew install jdf），需注意应用未签名，首次启动需右键打开或运行 xattr -cr 命令。
2
网页端可通过 npm 安装 @uurtech/jdf 或使用 unpkg 的 script 标签。
3
CLI 可通过 Homebrew、npm 或 npx 使用。
4
从源码构建需要 Node 20+、pnpm 9+、Rust stable 和 Xcode CLT。
5
许可证状态需在仓库中进一步确认。

查看仓库使用说明

授权与来源资料

使用条件与限制

使用条件待确认

资料或可核对的引用不完整，暂不能确认完整使用条件。

使用时需要遵守

保留原作者版权声明和 MIT 许可证声明。
在软件副本或实质部分中保留版权声明与许可声明

额外费用与待核对事项

README未单独说明演示素材或第三方资源的授权范围

查看原文依据

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction
许可证原文