核心用法
harrypotter 是一个轻量级 CLI 工具，面向 AI 代理及其用户提供《哈利·波特》宇宙信息查询服务。它封装了 HP-API（hp-api.onrender.com），支持通过简单命令获取角色、学院成员、咒语等数据。
主要功能：
- 角色查询：
harrypotter characters [limit]列出角色，harrypotter search <query>模糊搜索 - 分类筛选：
students/staff按身份筛选，house <name>按四大学院筛选 - 咒语列表：
harrypotter spells [limit]获取魔法咒语及效果说明 - 友好输出：自动添加 🧙/✨ emoji，格式化关键信息（血统、守护神、演员、魔杖等）
技术依赖：仅需 bash、curl、jq，零配置运行，无需身份验证。
显著优点
1. 零门槛接入：无需注册账号或 API 密钥，调用即得结果
2. 输出精致：结构化展示角色属性，兼顾简洁与详细两种模式
3. 场景明确：专为 AI 助手设计，自然语言意图可直接映射到命令
4. 开源 API 背书：基于公开的 HP-API，数据覆盖主要角色与设定
潜在局限
- 数据源单一：完全依赖 HP-API，若服务下线或限流则功能失效
- 内容范围有限：仅覆盖原著/电影主要角色与咒语，不含神奇动物、Pottermore 扩展等
- 无本地缓存：每次查询均发起网络请求，离线不可用
- 更新滞后：第三方 API 数据更新频率不可控
适合人群
- 希望为 AI 助手添加娱乐功能的开发者
- 哈利·波特粉丝社区工具、聊天机器人构建者
- 需要快速验证角色设定的同人创作者
常规风险
- 网络依赖：服务托管于 Render 免费层，可用性与响应速度无 SLA 保障
- 数据准确性：第三方维护的 API 可能存在角色信息错误或过时许愿
- 隐私安全：虽无需认证，但查询内容会传输至外部服务器，敏感场景需谨慎
- 功能可持续性：非官方 API 存在随时关闭或变更接口的风险