菜单
Use when browsing, searching, or downloading books from a Calibre library through its read-only AJAX API. Covers search, category browsing, book details, downloads, and the explicit no-write boundary.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/jianyun8023/my-skills --skill calibre-library命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | calibre-library |
| description | Use when browsing, searching, or downloading books from a Calibre library through its read-only AJAX API. Covers search, category browsing, book details, downloads, and the explicit no-write boundary. |
通过 Calibre Content Server AJAX API 搜索、浏览和下载书籍。
严禁任何写入、修改、删除操作。仅允许搜索、浏览和下载。
配置文件路径：~/.config/calibre-library/config.json
首次使用前，检查配置文件是否存在：
cat ~/.config/calibre-library/config.json
若不存在，提示用户创建：
mkdir -p ~/.config/calibre-library
cat > ~/.config/calibre-library/config.json << 'EOF'
{
"base_url": "https://lib.pve.icu",
"library_id": "library",
"username": "",
"password": ""
}
EOF
| 字段 | 说明 |
|---|---|
base_url | Calibre Content Server 地址，不带尾部斜杠 |
library_id | 书库 ID，通常为 library |
username | Basic Auth 用户名，无认证留空 |
password | Basic Auth 密码，无认证留空 |
读取配置后根据 username/password 决定认证方式：
-u username:password实际使用时，先读配置文件得到 BASE_URL、LIB_ID、USERNAME、PASSWORD，再按是否启用 Basic Auth 拼接 curl 请求。
禁止将密码写入 SKILL.md 或提交到版本控制。
详细接口、查询参数、高级搜索语法和响应字段见 reference.md。主技能只保留高频工作流：
/ajax/search/ajax/book/{id}/{library}、/ajax/books?ids=.../ajax/categories/{library}、/ajax/category/{hex}/{library}date: 搜索过滤/get/{format}/{id}/{library}、/get/cover/...BASE_URL 和 LIB_IDcurl -sL $AUTH "$BASE_URL/ajax/search?query=关键词&num=10&library_id=$LIB_ID"book_idscurl -sL $AUTH "$BASE_URL/ajax/books?ids=ID1,ID2&library_id=$LIB_ID"author:"刘慈欣" 找到书籍category_urls.authors 获取作者 URLbook_ids或直接浏览分类：
items[].url 获取目标条目的书籍列表formats 和 main_format 路径curl -sL $AUTH "$BASE_URL/get/epub/{book_id}/$LIB_ID" -o ~/Downloads/书名.epubformat_metadata.{format}.sizecurl -sL $AUTH "$BASE_URL/ajax/search?query=date:>7daysago&num=20&sort=date&sort_order=desc&library_id=$LIB_ID"book_ids，批量获取详情并展示7daysago、30daysago、具体日期等）列表展示使用 bullet list：
- **三体三部曲** — 刘慈欣 (ID: 267085)
格式: epub | 标签: 科幻, 经典 | ISBN: 9787229042066
单本详情包含：书名、作者、出版社、出版日期、丛书、标签、可用格式、ISBN、评分，以及从 comments 截取的简介（过长时截断）。
使用前：
~/.config/calibre-library/config.json 存在且内容正确base_url 可访问（curl 返回 HTTP 200）使用后：
format_metadata 一致| 错误做法 | 正确做法 |
|---|---|
| 在 SKILL.md 中硬编码 base_url 或密码 | 从 ~/.config/calibre-library/config.json 读取 |
直接用 /mobile HTML 端点解析 | 用 /ajax/ JSON 端点，结构化可靠 |
| 搜索后直接拼下载 URL | 先获取详情确认 formats 和 main_format 再下载 |
| 一次请求大量书籍详情 | 批量接口 ids= 每次不超过 50 个，分批请求 |
| 尝试通过 API 修改书籍元数据 | 严禁写操作，此技能仅支持只读访问 |
| 配置文件不存在时直接报错 | 提示用户创建配置文件并填写参数 |
Use when the user asks to check disk status, report on hard disk health, temperature, or SMART data, or when performing routine server maintenance.
Use when containerizing VPN clients into Docker, supporting both GUI (VNC) and CLI (Web management) modes with danted SOCKS5 proxy
Use when editing `.alloy` files, configuring Grafana Alloy pipelines, or debugging log collection and relabeling behavior. Covers HCL syntax, common Loki/Prometheus components, processing stages, Docker discovery, and FnOS-specific patterns.