Licentia

Licentia 是一款捷克语 Web 和桌面应用程序，用于处理 SPDX License List 3.28.0 目录。它可以帮助您快速查找许可证、比较其元数据，并了解相关义务，而无需手动翻阅数百份文本。

本指南是参考性的决策辅助工具，并非法律建议。

功能

• 离线目录，包含 727 个许可证和 84 个许可证例外；

• 支持按名称、SPDX ID 和完整文本进行全文搜索；

• 可按记录类型、时效性、OSI/FSF 元数据和许可证配置文件进行筛选；

• 详细展示规范文本和义务；

• 许可证比较以及将条目保存到个人工作区；

• 六步式常见许可方向选择向导；

• 公共 REST API /v1；

• Streamable HTTP MCP 端点 /mcp；

• SPDX 表达式验证、参考性兼容性检查以及 SPDX/CycloneDX SBOM 分析；

• Web、Tauri 桌面版以及共享 Apache/PHP 变体。

Related MCP server: mcp-spdx-license

应用截图

许可证目录

选择向导

目录搜索

Web 应用开发

所需 Node.js 版本：>=22.13.0。

npm install
npm run dev

生产构建：

npm run build

样式和静态规则检查：

npm run lint

桌面版：Linux、Windows 和 macOS

桌面版使用 Tauri 2 和独立的静态 Vite 构建，包含相同的 React 组件以及所有数据的本地副本。

npm run dev:desktop
npm run tauri:dev
npm run tauri:build

安装程序在目标系统上构建。Linux 需要 WebKitGTK 4.1，macOS 需要 Xcode Command Line Tools，Windows 需要 Microsoft C++ Build Tools 以及 WebView2。准确的最新要求请参阅 Tauri 官方文档。

共享 Apache 托管

要求：Apache 2.4（带 mod_rewrite）、HTTPS、PHP 8.2+、PDO SQLite（或 PDO MySQL）扩展、cURL 和 JSON。

npm run build:apache

将生成的 apache-dist/ 目录上传到网站根目录。如需 Google/GitHub 登录，请将 api/config.example.php 复制为 api/config.php，填写 OAuth 密钥并将回调设置为：

https://vase-domena.cz/api/auth/oauth/callback

未配置 OAuth 时，可通过邮箱和密码使用账户。数据库会在首次请求时在 api/var/ 中创建；该目录必须对 PHP 可写。

上传后请验证 /v1、/v1/licenses?q=MIT 以及通过 POST /mcp 进行的 MCP 初始化。checksums.sha256 文件可用于验证传输完整性。

数据更新

生成器需要固定版本 spdx/license-list-data 和 github/choosealicense.com 的检出：

node scripts/build-app-data.mjs /cesta/license-list-data /cesta/choosealicense public/data

输出包含元数据目录、每个条目的详细 JSON 以及全文索引。桌面版将其直接打包到应用程序中；Web 版则将其作为带版本号的静态数据提供。

结构

• app/ — Sites/Vinext 的 Web 入口；

• components/ 和 lib/ — 共享用户界面和规则引擎；

• desktop/ — Tauri 的静态 Vite 入口；

• src-tauri/ — 原生外壳和打包配置；

• public/data/ — 离线目录；

• docs/ECOSYSTEM.md — API、MCP 及相关工具；

• docs/screenshots/ — 当前桌面 Web 构建的截图；

• apache-server/ — 用于共享托管的 PHP 运行时和安全配置；

• apache-dist/ — 由 npm run build:apache 命令生成的产物。