LOCAL WORKFLOW / 不上传个人数据

把地图带进
你的工作流。

PDF 是权威正文，概念卡负责导航；本地 CLI 提供检索、引用、课程、自测与工程任务。公开网页不读取你的索引或学习进度。

01 / GET STARTED

五分钟开始

在仓库根目录执行；需要 Python 3.10+ 与系统命令 pdftotext。

python3 tools/recsys_agent.py index
python3 tools/recsys_agent.py doctor
python3 tools/recsys_agent.py search "双塔召回的负采样偏差"
python3 tools/recsys_agent.py page --chapter 10 --page 60

doctor 应显示 index=ready。PDF 更新后重新执行 index；索引只写入本地被 Git 忽略的 .recsys-agent/。用 python3 tools/recsys_agent.py --help 查看所有参数。

02 / WORKFLOWS

按任务进入

先找到 PDF 证据，再做学习或工程判断；导航卡不代替原书。

查书与引用

检索 · 阅读 · 讲解

ask --session reading 可本地连续提问，search 返回 PDF 页，page 核对原页；概念卡详情提供可复制提问命令。回答要区分「本书依据」与「扩展说明」。

打开站内 PDF →

学习闭环

课程 · 练习 · 复习

course list、course start new-engineer、course today 开始课程；提交证据后使用 course review 延迟复习。

查看两条课程 →

章节代码

概念 · 示例 · 源码

code "HNSW" 定位章节示例；网页逐文件展示 README 说明、函数入口与完整源码。书中论断仍须核对 PDF 页。

浏览代码目录 →

工程任务

设计 · 评审 · 排障

design 输出约束和容量预算，review 指出代码风险，debug 按证据排序假设；没有遥测不臆断根因。

查看命令示例 →

03 / INSTALL & BOUNDARY

在 Agent 客户端使用

Canonical Skills 位于 .agents/skills/，可安装到目标项目，或直接在本仓库会话中用自然语言调用。

python3 tools/install_skills.py --client claude --target /path/to/project
python3 tools/install_skills.py --client agents --target /path/to/project

Skills 不会复制 PDF 或个人索引；课程状态仅写入本地被 Git 忽略的 .recsys-workspace/。公开站点没有全文检索，也不采集学习证据。

阅读完整 Agent 指南 ↗返回知识地图

把地图带进你的工作流。