# 拾理字体库 · Li Type Library

> Search, inspect licences, preview and download verified fonts free for commercial use.
> 面向 AI / Agent：搜索已发布字体、核对许可及来源、试排并下载原文件。

## Discover
- [Public API description](./openapi.json): OpenAPI 3.1; stable operation IDs and field schemas.
- [中文调用指南](./zh/agents): 流程、DOM 标记与校验说明。
- [English agent guide](./en/agents): Workflow, DOM selectors and checksum rules.
- [Live catalogue](./api/fonts): Authoritative current published data.

## Workflow
1. Resolve every relative link against the current origin, including its port. The production domain may not be deployed during local development.
2. GET /api/fonts?q={URL-encoded keyword}&script={cjk|latin}; parameters are optional. Empty results: total=0, items=[]. No pagination.
3. Use each item's stable id, localizedNames.zh/en, links.self and links.details.zh/en. Do not infer names or versions from screenshots.
4. Check commercialUse=free, redistribution=permitted, licenseId=OFL-1.1; read links.license for the full notice and conditions. sourceReview identifies the pinned official version/commit.
5. GET links.download and verify ZIP bytes against packageSha256. sha256 is for the original OTF/TTF; licenseSha256 is for the licence. Preserve OFL.txt, copyright and SOURCE.txt with the font.
6. Refresh live data before use. 404 means unavailable or unpublished; old links are not an availability guarantee.

## Browser controls
- #search-form input[name="q"]: search; #search-submit: submit.
- [data-action="filter-script"][data-filter]: script filter; data-filter is cjk, latin or an empty string.
- #results: wait until aria-busy is not true; #result-summary exposes data-result-count, data-query and data-script.
- [data-action="open-font"][data-font-id]: open a font. data-api-url points to its current JSON record.
- #font-detail: stable data-font-id and data-api-url; #font-name is the display name.
- [data-action="search-all-scripts"]: from filtered empty results, keep q and search all writing systems.
- #trial: enter up to 1000 characters of multiline preview text; #size: font size. #specimen[data-state] becomes ready, sample, loading or error.
- #download-font: ZIP; #packaged-license: licence text; #license-full: expandable original text.
- #font-provenance: official source and version; #font-checksums: SHA-256 and Git blob SHA-1.
- [data-action="change-language"]: language control. Appearance follows the system automatically; there is no public appearance control.

Public reads need no login or API key. Only currently published data is exposed. Font OFL conditions still apply: keep notices and the full licence, do not sell fonts by themselves or relicense them, respect Reserved Font Names for modified fonts and do not imply author endorsement. Documents and designs made with the fonts do not need OFL licensing.