← Back to Skills Marketplace
cp3d1455926-svg

Book Recommender - 书籍推荐

by cp3d1455926-svg · GitHub ↗ · v2.0.1 · MIT-0
cross-platform ⚠ suspicious
123
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install book-recommender
Description
Recommend books based on interests or history, check Douban ratings and reviews, and manage reading notes and book lists.
README (SKILL.md)

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

\r

触发规则\r

\r 关键词:\r

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

功能描述\r

\r

核心功能\r

\r

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

权限需求\r

\r

  • 网络访问(豆瓣 API)\r
  • 文件读写(笔记存储)\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
Usage Guidance
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install book-recommender
  3. After installation, invoke the skill by name or use /book-recommender
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.1
Update to 2.0.1
v2.0.0
v2.0 - 20本书籍库 + 心情推荐算法
Metadata
Slug book-recommender
Version 2.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Book Recommender - 书籍推荐?

Recommend books based on interests or history, check Douban ratings and reviews, and manage reading notes and book lists. It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.

How do I install Book Recommender - 书籍推荐?

Run "/install book-recommender" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Book Recommender - 书籍推荐 free?

Yes, Book Recommender - 书籍推荐 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Book Recommender - 书籍推荐 support?

Book Recommender - 书籍推荐 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Book Recommender - 书籍推荐?

It is built and maintained by cp3d1455926-svg (@cp3d1455926-svg); the current version is v2.0.1.

💬 Comments