← 返回 Skills 市场
203
总下载
2
收藏
1
当前安装
5
版本数
在 OpenClaw 中安装
/install puzle-read
功能描述
Connect to Puzle Read — an intelligent reading workbench that helps users turn articles and documents into searchable personal knowledge. Save web articles (...
安全使用建议
This skill implements a normal client/CLI for the Puzle Read service. Before installing: (1) Confirm you trust the external host (https://read-web.puzle.com.cn) and review its privacy/retention policy — uploaded files (PDFs, images, audio, etc.) are sent to that service. (2) Do not upload sensitive or regulated data unless you accept that external processing and storage. (3) The device-auth flow requires you to paste a short authorization code; the resulting JWT is stored locally at ~/.config/puzle/config.json (file is created with 0600 perms). (4) Note a minor metadata inconsistency: the SKILL.md documents this token flow but the registry entry did not declare a primary credential. If you need higher assurance, inspect scripts/puzle_reading.py yourself or avoid uploading confidential files.
功能分析
Type: OpenClaw Skill
Name: puzle-read
Version: 0.1.5
The skill provides a legitimate integration with the Puzle Read service for saving articles, uploading documents, and performing semantic searches. The Python SDK (puzle_reading.py) implements standard API interactions and follows security best practices for credential management, such as storing JWT tokens with restricted file permissions (0o600) and avoiding exposure in logs or environment variables. The instructions in SKILL.md are well-structured, providing clear guidance for the agent on authentication flows and data privacy warnings without any evidence of malicious intent or prompt injection attacks.
能力评估
Purpose & Capability
The skill name, SKILL.md, and bundled Python SDK implement a reading library client (save URLs, upload files, search) and are consistent with the description. Minor metadata mismatch: registry metadata lists no primary credential, but SKILL.md documents a device-auth JWT stored in ~/.config/puzle/config.json as the primary credential — this is implementation-local (file-based) rather than an environment variable.
Instruction Scope
Runtime instructions are scoped to: checking/setting a local token, instructing the user through a device-auth flow, and saving/processing URLs or local files. The skill reads local files only when the user asks to upload them and sends them to the Puzle service. There are no instructions to read unrelated system files, environment variables, or to transmit data to unexpected endpoints.
Install Mechanism
No install spec or external downloads; the SDK is bundled as scripts/puzle_reading.py. It requires Python and the requests library (documented). Nothing is written to the system beyond the client’s own config file when authorizing.
Credentials
The skill does not request environment variables or external credentials. It does require a user JWT obtained via device-auth; that token is saved to ~/.config/puzle/config.json (the code sets file permissions to 0600). The token handling is local (not placed into env vars or logs) per SKILL.md and code. Users should note the registry metadata did not declare this credential even though the SKILL.md explains the device-auth token flow.
Persistence & Privilege
always:false (default). The skill writes only its own config file (~/.config/puzle/config.json) to store the token and does not request system-wide privileges or modify other skills. Autonomous invocation is allowed by default but not combined with elevated privileges here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install puzle-read - 安装完成后，直接呼叫该 Skill 的名称或使用
/puzle-read触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.5
No user-facing changes in this release.
- No file changes detected between previous and current versions.
v0.1.4
puzle-read version 0.1.4
- Documentation now covers CLI usage: explains how to use the SDK as a command-line tool in addition to a library.
- CLI commands are documented with syntax, available options, and usage examples.
- Prerequisites section expanded to clarify library and CLI invocation.
- No code changes detected; this release is documentation-only.
v0.1.3
Puzle Read Skill 0.1.2
- Updated metadata to clarify token acquisition, privacy, and publisher info.
- Removed support for environment variable token configuration; token is now managed only via device code flow and internal storage.
- Added explicit rules to never display or accept JWT tokens from users.
- Improved documentation on data handling and privacy, warning users not to upload sensitive data without Puzle policy review.
- Enhanced SKILL.md with clearer instructions for first-time setup and token flow.
v0.1.1
- Switched user authentication from manual JWT copy-paste to a secure device authorization code flow.
- Updated setup instructions to use https://read-web.puzle.com.cn/device-auth for easy login and code exchange.
- Added metadata documenting environment variables for token and API endpoint overrides.
- Clarified that tokens are exchanged and saved automatically after device code authorization—no token ever appears in chat.
- Improved security guidance regarding `PUZLE_BASE_URL` override.
- Updated all token expiration and renewal instructions to use the device authorization flow.
v0.0.1
Initial release of Puzle Read Skill: Seamlessly save, organize, and analyze web articles and documents with Puzle's intelligent reading library.
- Guides users through first-time setup and token configuration.
- Supports saving, summarizing, searching, and organizing articles, PDFs, and files.
- Handles authentication tokens, including expiration and renewal.
- Offers two modes: quick "save for later" and deeper content analysis.
- Step-by-step instructions for integration and token management included.
元数据
常见问题
puzle-read 是什么？
Connect to Puzle Read — an intelligent reading workbench that helps users turn articles and documents into searchable personal knowledge. Save web articles (... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 203 次。
如何安装 puzle-read？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install puzle-read」即可一键安装，无需额外配置。
puzle-read 是免费的吗？
是的，puzle-read 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
puzle-read 支持哪些平台？
puzle-read 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 puzle-read？
由 ZinkLu（@zinklu）开发并维护，当前版本 v0.1.5。
推荐 Skills