@arcanemachine/pi-read
Pi 原生 read 工具的替代，支持自定义行/字节限制
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@arcanemachine/pi-read。 它的用途是：Pi 原生 read 工具的替代，支持自定义行/字节限制 完整的 Skill 内容见：https://321skill.com/skills/arcanemachine-pi-read/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请读取项目日志文件，限制前50行和2KB'，它会使用 pi-read 的配置读取文件，返回前50行或不超过2KB的内容，并显示精确的续行提示（如'输出已截断，剩余 120 行未显示'）。如果需要对文件进行字节级定位，可以说'从第100字节开始读取，限制200字节'，它会利用 offsetBytes 和 limitBytes 参数精确分页。
介绍
这个 Skill 解决了 Pi 内置 read 工具截断文本时默认限制过高（2000 行或 50KB）导致大量占用上下文窗口的问题。在实际开发中，AI 代理读取文件时经常输出过多无关内容，浪费宝贵的 Token 空间，而这个工具允许你将限制降到更合理的范围（默认 100 行、5KB），从而优化上下文利用率。
使用方式很简单，你只需要通过 Pi 的包管理器安装此扩展，然后在全局或项目 settings.json 中配置 readTool 对象，设置 maxLines、maxBytes 等参数。之后，当你通过 Pi 的 read 命令读取文件时，它会自动按照你设定的限制返回内容，并显示精确的续行提示。它还支持可选的字节级分页（offsetBytes/limitBytes），以及全局与项目配置的优先级覆盖。
它非常适合需要精细控制 AI 上下文窗口的开发者，尤其是那些使用 Pi 进行大量文件读取、分析业务数据集、精读行业报告或处理长文档对话的用户。对于团队协作场景，可以通过项目级配置统一限制，避免成员误用默认大截断消耗上下文。
建议在全局设置中统一使用此工具，并为特定项目设置更严格的限制以节省 Token。需要注意的是，它通过先执行原生读取作为探测再重新读取来实现限制，因此会额外产生一次文件读取开销；同时，由于它替换了 Pi 内置的 read 工具，如果多个扩展同时覆盖该工具，加载顺序将决定最终生效的实现。
常见问题
如何安装 pi-read？
可通过 pi install git:github.com/arcanemachine/pi-read 或 pi install npm:@arcanemachine/pi-read 安装，更新时使用 pi update 命令。
能否同时使用多个不同的配置？
可以，支持全局 settings.json 和项目 settings.json 的配置，项目级配置会覆盖全局配置，从而实现不同项目使用不同限制。
给 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（查看排版版本）