核心用法
SansFiction Library 是一款面向阅读爱好者的个人图书管理技能,通过 MCP over HTTP 协议与 SansFiction 服务交互。用户需先在官网生成个人 Token(SANSFICTION_TOKEN)完成一次性授权,即可实现以下功能:
- 图书管理:通过 ISBN、书名或作者搜索并添加图书,支持多结果模糊匹配时的用户确认流程
- 状态追踪:标记图书为「想读」「在读」「已读完」「暂停」「放弃」等状态
- 进度记录:支持按页数、阅读分钟数或当前页码记录阅读进展
- 动态查询:查看「正在阅读」列表及月度/年度阅读统计数据
- 每日提醒:可配置定时任务,在指定时间询问当日阅读量并自动记录
显著优点
1. 官方生态整合:直接对接 SansFiction 平台,数据同步至云端个人书库
2. 灵活进度维度:同时支持页码、百分比、时长三种记录方式,适应纸质书与电子书不同场景
3. 自动化工作流:OpenClaw 原生 cron 集成,无需第三方工具即可实现习惯追踪
4. 最小权限设计:仅需读写级 Token,明确禁止密码收集与 Token 回显
潜在局限
- Token 管理门槛:用户需手动获取并持久化环境变量,配置流程对非技术用户不够友好
- 服务依赖性:完全依赖 SansFiction 服务可用性,无离线缓存或降级方案
- 模糊匹配风险:书名歧义时需人工介入确认,自动化程度受限
- 时区固定:每日提醒默认 Europe/Warsaw 时区,虽可覆盖但未明确支持夏令时自动切换
适合人群
- SansFiction 现有用户寻求 CLI/AI 代理整合
- 希望建立结构化阅读习惯的深度阅读者
- 偏好开放 API 生态、愿意配置 Token 的技术型用户
常规风险
- Token 泄露:若
~/.openclaw/openclaw.json权限设置不当,可能导致书库数据被未授权访问 - API 限流:高频操作可能触发 SansFiction 速率限制
- 数据同步延迟:进度记录依赖网络,弱网环境可能出现状态不一致