← 返回 Skills 市场

Book Recommender - 书籍推荐

Name: Book Recommender - 书籍推荐
Author: cp3d1455926-svg

作者 cp3d1455926-svg · GitHub ↗ · v2.0.1 · MIT-0

cross-platform ⚠ suspicious

123

总下载

当前安装

版本数

在 OpenClaw 中安装

/install book-recommender

功能描述

Recommend books based on interests or history, check Douban ratings and reviews, and manage reading notes and book lists.

使用说明 (SKILL.md)

📚 Book Recommender - 书籍推荐助手\r

触发规则\r

\r 关键词：\r

推荐书籍、书单推荐、看什么书\r
豆瓣评分、书籍评分\r
读书笔记、读后感\r \r 场景：\r
用户想找书看但不知道选什么\r
用户查询某本书的评分\r
用户想记录读书笔记\r \r

功能描述\r

核心功能\r

书籍推荐\r
- 根据兴趣推荐\r
- 根据阅读历史推荐\r
- 热门书单\r \r
豆瓣对接\r
- 评分查询\r
- 书评查看\r
- 作者信息\r \r
读书笔记\r
- 记录阅读进度\r
- 摘录金句\r
- 写读后感\r \r
书单管理\r
- 想读清单\r
- 已读清单\r
- 在读清单\r \r

权限需求\r

网络访问（豆瓣 API）\r
文件读写（笔记存储）\r \r

示例对话\r

用户：推荐几本好看的小说\r
助手：好的！根据你的兴趣推荐：\r
\r
📚 **小说推荐**\r
\r
1. 《活着》- 余华 ⭐9.4\r
   📝 简介：讲述一个人一生的苦难与坚强\r
   🏷️ 标签：中国文学、人生、经典\r
\r
2. 《百年孤独》- 马尔克斯 ⭐9.3\r
   📝 简介：布恩迪亚家族七代人的传奇故事\r
   🏷️ 标签：魔幻现实主义、拉美文学\r
\r
3. 《追风筝的人》- 卡勒德·胡赛尼 ⭐9.2\r
   📝 简介：关于救赎与成长的感人故事\r
   🏷️ 标签：成长、友情、救赎\r
\r
想深入了解哪一本？或者告诉我你喜欢的类型~\r
\r
用户：查一下《三体》的评分\r
助手：📖 《三体》- 刘慈欣\r
\r
⭐ 豆瓣评分：9.5 (50 万人评分)\r
📝 简介：地球文明与三体文明的生死较量\r
🏆 奖项：雨果奖最佳长篇小说\r
📚 系列：三体三部曲第一部\r
\r
用户：记录读书笔记：《活着》\r
助手：✅ 已添加读书笔记：\r
\r
📖 《活着》- 余华\r
📅 阅读日期：2026-03-16\r
⭐ 评分：★★★★★\r
💭 感想：...\r
```\r
\r
## 数据存储\r
\r
```json\r
// ~/.openclaw/workspace/book-recommender/library.json\r
{\r
  "want_to_read": [],\r
  "reading": [],\r
  "read": [\r
    {\r
      "title": "活着",\r
      "author": "余华",\r
      "rating": 5,\r
      "notes": "...",\r
      "finished_date": "2026-03-16"\r
    }\r
  ]\r
}\r
```\r
\r
## 待办事项\r
\r
- [ ] 豆瓣 API 对接\r
- [ ] 推荐算法\r
- [ ] 读书笔记系统\r
- [ ] 书单管理\r
\r
---\r
\r
**版本：** 1.0.0\r
**创建日期：** 2026-03-16\r
**作者：** 小鬼 👻\r

安全使用建议

This skill appears to implement offline recommendations and local note storage, but SKILL.md and the Python code disagree about two important things: (1) SKILL.md says it will use the Douban API (network) while the shipped code shows no obvious network calls in the visible portion; (2) SKILL.md shows data stored under ~/.openclaw/workspace/... but the code writes JSON files next to the skill (DATA_DIR = skill folder). Before installing or granting network/file permissions: 1) Request or inspect the full book_recommender.py (the listing is truncated) to confirm there are no hidden network endpoints or unexpected behavior; 2) Confirm where data will actually be written at runtime and whether it will touch your home directory; 3) If the skill will use Douban, ask how it authenticates (any API keys) and ensure required credentials are declared and scoped; 4) Run the skill in a sandboxed environment or with confined filesystem permissions first; 5) If you expect no network access, disable network permissions until the Douban integration is implemented and audited.

能力评估

ℹ Purpose & Capability

The skill name and description (recommend books, Douban ratings, notes, lists) align with the included Python code which implements an offline book DB, recommendation/search functions, and JSON-backed bookshelf/notes. However, SKILL.md promises Douban API integration and places data under ~/.openclaw/workspace/book-recommender/library.json, while the code writes/reads JSON files in the skill directory (DATA_DIR = Path(__file__).parent). The declared capabilities (network access to Douban) are not implemented in the visible portion of the code, which is an inconsistency.

ℹ Instruction Scope

SKILL.md requests network access and file read/write and shows a specific storage path in the user's home directory. The instructions otherwise are narrowly scoped to recommendation, rating lookup, and note-taking. No instructions ask the agent to read arbitrary system files or other credentials. The mismatch between the documented storage path and the code's DATA_DIR usage is concerning: it affects where user data will actually be stored and whether user-home files will be touched.

✓ Install Mechanism

There is no install spec and no external downloads; the skill is instruction-only with one bundled Python file. This is lower risk than fetching remote code. The shipped code will be executed locally if the platform invokes it, but no install-time network fetches or archive extraction are present.

ℹ Credentials

The skill declares no required environment variables or credentials, and the visible code does not reference env vars. SKILL.md mentions Douban API access but there is no API key or credential declared—either the integration isn't implemented yet (TODO) or the skill would use unauthenticated scraping (not declared). Lack of declared credentials is plausible but worth confirming before granting network access.

✓ Persistence & Privilege

The skill does not request 'always: true' or elevated privileges. It reads/writes JSON files (bookshelf/library/reading_log) in the skill's directory according to the code; SKILL.md suggests a different user-home path. The file operations are expected for this functionality, but you should confirm the exact paths used at runtime so no unexpected user files are overwritten.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install book-recommender
安装完成后，直接呼叫该 Skill 的名称或使用 /book-recommender 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v2.0.1

Update to 2.0.1

v2.0.0

v2.0 - 20本书籍库 + 心情推荐算法

元数据

Slug book-recommender

版本 2.0.1

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 2

常见问题