用途:reread 是配合阅读技术书、技术文章、论文等 Markdown/文本资料的“学习伙伴”。用户在本地阅读界面(浏览器)中阅读,对卡住的地方加标记和评论;界面本身没有 AI 功能,所有 AI 请求都交给聊天中的 AI,由它作为导师读取阅读记录,进行讲解、评价、出题、评分,并把结果写回记录,界面会自动显示。
主要能力:支持 unknown(不懂)、explain(自我解释)、quiz(出题)三类标记;自动检测专业术语并在首次出现处加蓝色虚线,点击可查看简要解释;可生成术语表;可基于记录进行复习。核心原则是不直接给答案,而是支持用户自己回忆、用自己的话解释,在用户作答前不展示模范答案或 AI 解释。
使用方式:CLI 位于该技能的 tools/(uv 项目),每次需用完整路径执行:uv run -q --project "<技能目录>/tools" active-reader <子命令>。常用命令包括 open <file> --no-browser 启动阅读界面、export <file> 导出记录、set <file> <ann_id> <key> 写回结果、wait --port <port> 等待界面请求、install-hooks 注册 hooks、listen --port <port> 启用自动等待、terms <file> 获取术语、set-terms <file> 写入术语解释、list/delete/clean 管理记录。若没有 uv,需用户安装:curl -LsSf https://astral.sh/uv/install.sh | sh。
适用场景:阅读技术资料时的即时答疑、自我解释评价、理解确认出题与评分、术语整理、日后复习。
限制:仅支持 .md / .txt,不支持 PDF 等格式;需要本地文件和命令访问权限;记录保存在 ~/.active-reader/docs/,不写入原文档;删除不可撤销,需先不带 -y 确认再执行;请求队列在服务器内存中,重启会清空。