@arcanemachine/pi-read
Pi AI 原生文件读取工具，可配置行数与字节限制。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@arcanemachine/pi-read。 它的用途是：Pi AI 原生文件读取工具，可配置行数与字节限制。 完整的 Skill 内容见：https://321skill.com/skills/arcanemachine-pi-read/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘使用 pi-read 读取 /var/log/app.log 的前 20 行，看看最近的错误信息。’，它会调用该技能，安全地截取指定日志文件的前20行内容并呈现给你，方便你快速定位问题。
介绍
Pi’s native read tool 解决了在 Pi AI 环境中安全、可控地读取本地文件内容的需求。用户在处理代码、日志或文档时，常常需要将文件内容提供给 AI 进行分析，但直接读取可能涉及隐私或性能问题。该工具通过提供行数和字节数限制，允许用户精确控制输入到 AI 上下文中的文件内容量，避免因文件过大导致上下文窗口溢出或处理缓慢。
使用时，用户只需在 Pi 的对话中调用该技能，并指定目标文件路径及可选的行数或字节数上限。例如，可以要求“读取 project.log 的前 50 行”或“查看 config.json 的前 1024 字节”。技能会按配置截取文件内容并返回，方便用户进行后续的查询或分析。
该技能主要面向开发者、运维人员和技术写作者。他们在日常工作中需要频繁查看和分析代码文件、系统日志、配置文件或技术文档，但又希望避免将整个大文件一次性载入 AI 对话，以提升交互效率和聚焦关键信息。
建议在使用前明确读取范围，对于超大型文件，优先使用行数限制而非字节限制，因为行数更易于预估内容的相关性。注意，该工具依赖于 Pi 对本地文件系统的访问权限，且读取内容受限于配置，可能无法获取文件的完整上下文，因此不适合需要全文深度分析的任务。
核心特点
作为 Pi 的原生工具，它深度集成于 Pi 环境，无需额外安装依赖即可直接调用；其核心区别在于提供了行数与字节数双重粒度控制，允许用户更精细地管理输入到 AI 的上下文数据量，而非简单的“有”或“无”文件读取功能。
注意事项
不适合需要完整、无截断地分析整个大型文件内容的场景。
常见问题
如何限制读取文件的行数？
在调用时指定 `--lines` 或 `-l` 参数，后接数字，例如 `read file.txt --lines 100`。
能同时限制行数和字节数吗？
通常行数和字节数限制是互斥的，具体取决于实现，请参考具体命令参数说明。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/arcanemachine-pi-read/raw/index.md 读取 @arcanemachine/pi-read 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/arcanemachine-pi-read/raw/index.md（查看排版版本）