前言¶
赛事照片往往分散在图片直播页里，相册还会随赛程不断更新。选手或工作人员想按号码牌、骑行服和装备筛出清晰候选图，并和已有清单比对、只处理新增条目，若全靠手工翻页和表格对照，成本高且容易漏图。DeepSeek Harness（DSH）支持通过插件注册 Agent Skill，把查找与复核流程交给当前会话执行。下面介绍维护者 bananaive 发布的联网工具类插件 bananaive/qianDao-photo-finder-skill（包名 dsh-qiandao-photo-finder），其面向 2026 届千岛湖自行车比赛，在 Codex 与 DSH 中均可使用。
这是什么¶
qianDao-photo-finder-skill 是一个 DSH 插件，在技能列表中提供 qiandao-photo-finder Skill。插件按号码牌、骑行服和装备查找照片，并能逐张比较相册快照，找出需要复筛的新照片。仓库许可证为 MIT；npm 包版本为 0.1.0。社区目录页：https://www.skillhub.cn/plugins/bananaive/qianDao-photo-finder-skill；源码：https://github.com/bananaive/qianDao-photo-finder-skill。
插件只注册随包提供的技能及资源；照片读取、脚本执行和模型下载仍由当前 DSH 会话按用户要求进行。包不包含安装时自动执行的脚本。安装与运行前宜自行查看仓库源码与许可证；插件在 DSH 进程的权限下工作，访问相册或导出数据须符合你对该页面或 API 的使用授权。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明。
- 按条件找图：在用户提供本届赛事图片直播链接的前提下，可按号码牌、装备特征及希望保留的拍摄角度筛选候选照片。
- 相册清单比对：使用 Python 3.10+ 脚本，仅依赖标准库，用于对比相册快照与既有清单，定位新增照片。
- 号码识别（可选）：附带 macOS 本地 Swift / Apple Vision 工具，适用于在苹果平台上做 OCR 类辅助；Windows / Linux 可使用清单比对与装备排序路径，Apple Vision 脚本不适用于非 macOS。
- 装备排序（可选）：可选用 Pillow、PyTorch、Transformers 及本地 DINOv2 模型，对已定位的装备区域输出待人工复核的排序结果。
流程由 Agent 执行查找与复核，不承诺任意直播站点均可自动抓取；遮挡或号码不可读的照片可能遗漏，候选仍需人工确认。清单格式与筛选交付说明见仓库内 skills/qiandao-photo-finder/references/manifests.md 与 review.md。
安装与启用¶
DSH 版本要求见 package.json：dsh 为 >=0.2.1-rc.2 <0.2.2 或 >=0.2.2-0 <0.3.0-0；README 写明支持 DSH 0.2.1-rc.2 及后续 0.2.x（含 0.2.2 预发布），验证环境为 0.2.1-rc.2。Node 需 >=22。
在 DeepSeek Harness 中安装时，将示例里的 web 换成你自己的 profile：
dsh plugin --profile web add github:bananaive/qianDao-photo-finder-skill
安装后在技能列表选择 qiandao-photo-finder。也可将 skills/qiandao-photo-finder 目录复制到 ~/.dsh/skills/，由 Harness 的文件系统技能提供方发现；两种方式任选其一。
若使用 Codex，可将 skills/qiandao-photo-finder 复制到 Codex 的 skills 目录，在任务中调用 $qiandao-photo-finder。
典型用法¶
必填参数为 live_album_url：传入本届赛事的图片直播链接。未提供时，Skill 会先向用户询问；仓库不预设相册链接。可同时提供号码牌、装备特征和想保留的拍摄角度。
README 中的调用示例（链接与号码为虚构）：
$qiandao-photo-finder：live_album_url=https://example.com/event-photo-live。帮我从正赛日相册找号码 0427 的清楚正面或侧面照片；如果已经有清单，只筛新增照片。
读取直播相册须使用你有权访问的页面、导出或 API。仓库中的示例清单为合成数据；实际照片、号码、账号与相册导出应保留在本地工作目录。
适用场景与注意¶
适合在 DSH 或 Codex 中处理千岛湖赛事实拍检索、与本地清单增量复核的场景。需要联网或可访问的相册资源，并归类为社区目录中的「联网工具」。
使用前注意：
- 可选依赖（Pillow、PyTorch、Transformers、DINOv2 或 macOS Vision 工具）由你在会话中按需安装，不由插件包自动完成。
- 开发侧可安装开发依赖后运行
npm test，检查技能在真实 DSH 注册表中的发现、资源读取与卸载；npm pack --dry-run可检查分发文件。
结尾¶
qiandao-photo-finder-skill 把赛照按号码与装备查找、清单增量比对封装为可注册的 Skill，便于在 DSH 0.2.x 会话里重复发起同类任务。进一步了解可访问社区目录 https://www.skillhub.cn/plugins/bananaive/qianDao-photo-finder-skill 与 GitHub 仓库 https://github.com/bananaive/qianDao-photo-finder-skill。DSH 插件生态由社区目录聚合，与 DeepSeek / 幻方无官方从属关系；选用插件时以仓库文档与源码为准。
