能力入口 · 个人维护的能力入口
非媒体原件与文内位置查找
让我既能找到真实原件，也能知道某句话在选中文件的哪页、哪段或哪行。AI 读取先只读核验，不为了看文件就弹桌面应用或改索引。
只读核验与文内定位已经实现并有合成回归；这次网页修复没有读取私人原件，具体文件能否找到、文字覆盖到哪里要在实际请求中确认。先看怎么用
你不需要记住 Skill 名，直接说需求就行
什么时候用
- 非媒体原件位置未知、原有定位失效，或需要在登记来源内有界查找
- 已经选定一份文件，需要定位特定内容的 PDF 页、Word 段落/表格或文本行
- 需要给 AI 一条现场核验过的原件路径，而无需启动桌面阅读器
可以直接这样说
我可以说“找一下那份维修合同，再指出保修期限在哪一页”。它会选中并核对当前原件，只读该文件，给出实际 PDF 页码和一小段相关文字；扫描页需要识别时只处理这一份。
最后会得到什么
我得到少量可信候选、已核验原件路径，或绑定当前版本的页/段落/表格/行位置与摘录。打不开、文字未覆盖或格式不支持会分别说明；只有我要求在桌面展示才启动应用。
不适合这样用
- 照片、视频、录音或其他视听媒体
- 已知可靠文件位置而且只需直接阅读；要找选中文件的页、段或行时仍可使用本能力
- 需要判断材料专业含义或执行领域动作，而不是找原件或文内位置
- 要求全盘扫描、后台索引或批量复制原件
正常时
当前原件核验通过后只读取选中文件，返回真实位置、摘录和覆盖；本人明确要求时再打开应用。
发现问题时
文件漂移、局部文本缺失或结果截断时保留限制，重新核验或仅对选中原件补识别。
入口不可用或证据不足时
来源根、读取器或 OCR（光学字符识别） 不可用时只报告对应缺口，不全盘扫描、不猜文内位置，也不把指导下一步冒充已找到。
从哪里开始
在当前 AI 对话说要找哪份非媒体原件，或指出选中文件里的某句话。已有可靠文件位置时可直接让 AI 阅读；位置不明或失效时才进入登记来源查找。
需要准备什么
- 材料名称、版本、时间、用途、内容或原生目录中至少一条可用线索
- 要找文内位置时，给出选中的文件或足以选定它的线索，以及要定位的文字
为什么需要这个能力
只给文件名还不够：版本可能变了，内容可能在表格里，扫描页也可能没有文本层。先核验当前原件，再报告实际位置和覆盖，才能避免拿旧材料或局部搜索猜全貌。
从需求到结果
给出材料名称、日期、版本、用途或内容线索即可。已经有可靠文件位置时，AI 直接读原件；位置未知或失效时才在已登记来源内查找。
先返回少量候选和实际查过的范围，选中后核对当前文件、大小与内容指纹，再把可用原件位置交给 AI 阅读。
问某句话在哪里时，只检查选定文件：PDF 返回实际页码，Word 返回段落或表格位置，文本文件返回行号；Word 段落编号不是打印页码。
扫描页没有文字层或只读到部分内容时，按需要仅对这一份原件补识别。局部没命中不能证明全文没有，更不能用猜测填写页码。
只读核验不会启动桌面阅读器或修改登记；明确要求在桌面展示时才打开应用。读取过程不复制、移动或改写原件。
线索不匹配时先在原范围尝试有依据的同义词、名称或来源；达到查找边界后说明覆盖与缺口，不全盘扫描。照片、视频与录音仍由媒体入口处理。
失败时会怎样恢复
查找未命中或达到上限
系统反应：只说明本次登记/来源范围，没有证明所有设备和账号都不存在。
恢复方式：已有线索支持换词、文件名或来源提示时，在原范围继续有界搜索，不要求重新提供所有线索；没有有效新线索或达到边界后，再列实际来源、文字覆盖、检查数量、截止原因和缺口。
选中的文件与上次记录不一致
系统反应：不把旧版本当成当前原件，也不启动桌面应用。
恢复方式：重新找到并核对当前文件；如果已经开始登记改动，就沿原操作处理或退回，保留后续他人修改。
选中文件里没找到那句话
系统反应：先说明实际查到的格式、页和文字范围；只查过一部分就不能断言整份文件都没有。
恢复方式：需要时仅给这份文件补扫描识别，再把结果对应回真实页码；未能识别就保留位置缺口。
交来的其实是照片、视频或录音
系统反应：这项非媒体查找不处理视听原件。
恢复方式：改由媒体检索找到原件；录音中的一句话可再走该媒体入口的时间定位。
技术身份与验证证据
Skill · personal-materials · 成熟度 A（稳定）
这个 Skill 用到的名词
- Registered lookup（登记查询）
- find 在现有最小 SQLite 中查非媒体定位与绑定文字，返回少量候选；未索引正文没有被搜索。
- Inspect（只读核验）
- inspect / inspect-discovered 重新核对已选原件并给出路径、大小和 SHA-256，不写索引、不启动桌面应用；AI 使用文件原生 reader 继续阅读。
- Discover（有界发现）
- 位置确实未知且登记不足时，只看获准目录的文件名、原生目录和 stat；不预读正文或计算整批文件哈希。
- Locate-content（文内定位）
- 只核验并读取已经选定的一份原件，返回 PDF 页码、DOCX 正文段落或表格位置、TXT/Markdown 行号及小段摘录；不登记候选或启动应用。
- Coverage（文字覆盖）
- PDF 文本层不包括页面图片内文字，Word 段落编号不是打印页码；区域、格式、编码和截断都限制了零命中能说明什么。
- Open（桌面打开）
- 本人明确要求在应用中打开时才使用 open/open-discovered；--no-launch 仍会记录核验或登记状态，不是只读替代。
专业定义
忘了合同、报告放在哪里，或想知道某句话在第几页、哪一段时，它先找到并核对选中的真实原件，再给路径或带位置的小段摘录。AI 阅读默认不弹桌面应用；本人要求打开时才打开。
执行参考
下面保留 AI 和工具实际使用的参数、步骤与依赖。日常使用可以直接提出需求，不需要先手工准备这些协议。
输入
- 对材料名称、时间、版本角色、用途或原生目录的普通描述
- 可选的已登记来源提示；不要求用户重复系统已经知道的本机路径或内部 ID
输出
- find/discover 的少量候选和真实覆盖范围
- inspect/inspect-discovered 返回现场核验路径、大小与 SHA-256，不写索引或启动应用
- locate-content 返回绑定当前原件版本的页码、段落/表格位置或行号，以及有界摘录、格式与覆盖限制
- 本人明确要求打开时，才记录核验/登记状态并启动默认应用
执行顺序
- 1
可靠原件定位已知时直接用原生 reader（文件读取器），跳过再次查找
- 2
没有候选时才用 find；已有候选直接核验，位置确实未知且登记不足才在获准来源执行 discover
- 3
选中后用 inspect 或 inspect-discovered 只读核验路径；AI 从该精确原件继续读取
- 4
问某段内容在哪里时直接对已选原件运行 locate-content，不额外重复 inspect
- 5
PDF 文本层返回页码，DOCX 返回正文段落或表格单元格，TXT/Markdown 返回行号
- 6
没有可提取文字时，仅针对这个原件复用 PDF/LocalOCR；不能执行就明确定位缺口
- 7
只有本人要求在桌面打开才运行 open/open-discovered；需要登记但不弹窗时显式 --no-launch
操作边界
- 措辞不匹配时，依据本人已有线索换用内容词、文件名词或来源提示，在同一获准范围继续有界搜索；不编造事实、不扩大账号/设备/根、不重复原查询，无剩余有效线索就报告实际覆盖和缺口
- 照片、视频、录音及其他视听媒体始终交给 personal-media
- 候选 token、material key 和内部来源 ID 不进入面向用户的回答
- 项目只保存最小 locator（原件定位记录）/metadata（元数据） SQLite（定位与元数据数据库）及与原件绑定、可删除重建的文字，不保存原件字节、人物事件或跨领域画像
- discover 最多选择 8 个来源，全部来源共享 2500 个文件和总计 8 秒的预算，每来源最多 12 层，并且不跟随链接
- 不复制、移动、改写或删除原件；hash（内容指纹） 漂移、来源根变化或文件状态变化都失败关闭
- inspect 与 inspect-discovered 是零写核验；open --no-launch 仍写状态，不能当只读替代
- locate-content 自行核验被选原件，不登记发现候选、不启动应用，也不建全库正文索引
- Word 段落编号不是打印页码；PDF 文本层不覆盖图片内文字，局部零命中不能证明全文件没有内容
- 提取/OCR（光学字符识别） 结果须绑定当前原件 hash（内容指纹） 和实际页/区域，已有绑定结果可复用
依赖
- 个人材料查找项目（私有源码）
- personal-materials.handoff.v1 与项目最小 locator（原件定位记录）/metadata（元数据） SQLite（定位与元数据数据库）
验证状态
源码、安装、供应检查、当前任务、新任务和真实使用分别列出；一层通过不自动提升另一层。
- Source（源码）
- 当前 .agents source e734251 中的唯一源码已核对
- Install（安装）
- canonical junction（目录联接） 已安装
- Transaction（供应事务）
- 供应事务检查通过；0 个坏事务
- Current task（当前任务）
- 本轮宿主回执未知
- Fresh task（全新任务）
- 新任务回执未知
- End to end（端到端）
- 默认只读核验与文内定位由当前源码合同证明；本网页任务没有打开或提取私人原件，真实具体文件结果不在此宣称通过
2026-09-07 来源 main 1425c7f；tests/test_materials.py 的 66 项回归通过，用时 57.35 秒，覆盖只读核验和选定文件定位。本网站任务没有访问私人原件，实际文件/默认应用结果仍独立。
证据时间与来源
- Observed at（观察时间）
- 供应链现场：2026-09-24 12:56（中国时间）；项目场景按各项记录
- Source commit（来源提交）
e734251081dc48bdd86765372ce225b3929ce9ae- Supply command（供应验证命令）
E:\.agents\tools\Test-PersonalSkillSupply.ps1 -RequireInstalled -NoExternalEvidence -Json- Evidence basis（证据来源）
- .agents E171 release 1aa0b0a、当前 Personal Skill supply（个人能力供应链），以及本页明确标注的既有项目/Provider（固定服务入口）证据；source/install/transaction 通过不冒充 current（当前状态）/fresh/E2E
Canonical source（唯一维护源）
E:\.agents\skills\personal-materials\SKILL.md该路径是维护源；用户目录中的发现入口不是第二份源码。