[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-aim-uofa--Matcher":3,"tool-aim-uofa--Matcher":62},[4,18,26,35,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,2,"2026-04-10T11:39:34",[14,15,13],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":32,"last_commit_at":41,"category_tags":42,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[43,13,15,14],"插件",{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[52,15,13,14],"语言模型",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,61],"视频",{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":78,"languages":79,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":100,"env_os":101,"env_gpu":102,"env_ram":101,"env_deps":103,"category_tags":111,"github_topics":112,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":118,"updated_at":119,"faqs":120,"releases":156},8649,"aim-uofa\u002FMatcher","Matcher","[ICLR'24 & IJCV‘25] Matcher: Segment Anything with One Shot Using All-Purpose Feature Matching","Matcher 是一款基于通用特征匹配的创新视觉感知工具，旨在让现有的视觉基础模型无需额外训练即可直接解决各类图像分割任务。传统视觉模型往往需要针对特定任务设计结构并进行微调，而 Matcher 突破了这一限制，它只需用户提供一张参考图片（即“一次样本”），就能自动识别并分割出目标物体或其局部细节，真正实现了“举一反三”的零样本学习能力。\n\n该工具有效解决了视觉模型在开放世界中泛化能力不足及部署成本高的问题，特别适用于需要快速适应新场景的研究人员、算法开发者以及计算机视觉工程师。无论是语义分割、物体部件分割，还是视频对象追踪，Matcher 均展现出卓越的灵活性。其核心技术亮点在于设计了三个高效组件，能够充分释放预训练大模型的潜力，支持跨风格图像处理及可控掩码输出。目前，Matcher 已开源代码并提供在线演示，为探索免训练的通用视觉感知范式提供了强有力的支持。","\u003Cdiv align=\"center\">\n\n\u003Ch1>Matcher: Segment Anything with One Shot Using All-Purpose Feature Matching \u003C\u002Fh1>\n\n[Yang Liu](https:\u002F\u002Fscholar.google.com\u002Fcitations?user=9JcQ2hwAAAAJ&hl=en)\u003Csup>1*\u003C\u002Fsup>, &nbsp; \n[Muzhi Zhu](https:\u002F\u002Fscholar.google.com\u002Fcitations?user=064gBH4AAAAJ&hl=en)\u003Csup>1*\u003C\u002Fsup>, &nbsp; \nHengtao Li\u003Csup>1*\u003C\u002Fsup>, &nbsp;\n[Hao Chen](https:\u002F\u002Fstan-haochen.github.io\u002F)\u003Csup>1\u003C\u002Fsup>, &nbsp;\n[Xinlong Wang](https:\u002F\u002Fwww.xloong.wang\u002F)\u003Csup>2\u003C\u002Fsup>, &nbsp;\n[Chunhua Shen](https:\u002F\u002Fcshen.github.io\u002F)\u003Csup>1\u003C\u002Fsup>\n\n\u003Csup>1\u003C\u002Fsup>[Zhejiang University](https:\u002F\u002Fwww.zju.edu.cn\u002Fenglish\u002F), &nbsp;\n\u003Csup>2\u003C\u002Fsup>[Beijing Academy of Artificial Intelligence](https:\u002F\u002Fwww.baai.ac.cn\u002Fenglish.html)\n\nICLR 2024\n\n\u003C\u002Fdiv>\n\n## 🚀 Overview\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_ba26c6e7791f.png\">\n\u003C\u002Fdiv>\n\n## 📖 Description\n\n\nPowered by large-scale pre-training, vision foundation models exhibit significant potential in open-world image understanding. However, unlike large language models that excel at directly \ntackling various language tasks, vision foundation models require a task-specific model structure followed by fine-tuning on specific tasks. In this work, we present **Matcher**, \na novel perception paradigm that utilizes off-the-shelf vision foundation models to address various perception tasks. Matcher can segment anything by using an in-context example without training. \nAdditionally, we design three effective components within the Matcher framework to collaborate with these foundation models and unleash their full potential in diverse perception tasks. \nMatcher demonstrates impressive generalization performance across various segmentation tasks, all without training. Our visualization results further showcase the open-world generality and flexibility of Matcher when applied to images in the wild.\n\n[Paper](https:\u002F\u002Farxiv.org\u002Fabs\u002F2305.13310)\n\n## ℹ️ News\n\n- 2024.1 Matcher has been accepted to ICLR 2024!\n- 2024.1 Matcher supports [Semantic-SAM](https:\u002F\u002Fgithub.com\u002FUX-Decoder\u002FSemantic-SAM) for better part segmentation.\n- 2024.1 We provide a Gradio Demo.\n- 2024.1 Release code of one-shot semantic segmentation and one-shot part segmentation tasks.\n\n\n## 📖 Recommanded Works\n\n- SINE: A Simple Image Segmentation Framework via In-Context Examples. [GitHub](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FSINE).\n- DiffewS: Unleashing the Potential of the Diffusion Model in Few-shot Semantic Segmentation. [GitHub](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FDiffewS).\n## 🗓️ TODO\n- [x] Gradio Demo \n- [x] Release code of one-shot semantic segmentation and one-shot part segmentation tasks\n- [x] Release code and models for VOS (see [vos-dev branch](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fblob\u002Fvos-dev\u002Fmatcher_vos\u002FEVALUATION.md))\n\n\n## 🏗️ Installation\n\nSee [installation instructions](INSTALL.md).\n\n## 👻 Getting Started\n\nSee [Preparing Datasets for Matcher](datasets\u002FREADME.md).\n\nSee [Getting Started with Matcher](GETTING_STARTED.md).\n\n\n## 🖼️ Demo\n\n### One-Shot Semantic Segmantation\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_78c8e7764fb9.png\">\n\u003C\u002Fdiv>\n\n### One-Shot Object Part Segmantation\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_4df379168709.png\">\n\u003C\u002Fdiv>\n\n### Cross-Style Object and Object Part Segmentation\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_826592f044e8.png\">\n\u003C\u002Fdiv>\n\n### Controllable Mask Output\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_e52ddf9362ed.png\">\n\u003C\u002Fdiv>\n\n\n### Video Object Segmentation\n\nhttps:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fassets\u002F119775808\u002F9ff9502d-7d2a-43bc-a8ef-01235097d62b\n\n\n## 🎫 License\n\nFor academic use, this project is licensed under [the 2-clause BSD License](https:\u002F\u002Fopensource.org\u002Flicense\u002Fbsd-2-clause). \nFor commercial use, please contact [Chunhua Shen](mailto:chhshen@gmail.com).\n\n\n## 🖊️ Citation\n\n\nIf you find this project useful in your research, please consider to cite:\n\n\n```BibTeX\n@article{liu2023matcher,\n  title={Matcher: Segment Anything with One Shot Using All-Purpose Feature Matching},\n  author={Liu, Yang and Zhu, Muzhi and Li, Hengtao and Chen, Hao and Wang, Xinlong and Shen, Chunhua},\n  journal={arXiv preprint arXiv:2305.13310},\n  year={2023}\n}\n```\n\n## Acknowledgement\n[SAM](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fsegment-anything), [DINOv2](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fdinov2), [SegGPT](https:\u002F\u002Fgithub.com\u002Fbaaivision\u002FPainter\u002Ftree\u002Fmain\u002FSegGPT), [HSNet](https:\u002F\u002Fgithub.com\u002Fjuhongm999\u002Fhsnet), [Semantic-SAM](https:\u002F\u002Fgithub.com\u002FUX-Decoder\u002FSemantic-SAM) and [detectron2](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fdetectron2).\n","\u003Cdiv align=\"center\">\n\n\u003Ch1>Matcher：利用通用特征匹配实现单样本万物分割\u003C\u002Fh1>\n\n[刘洋](https:\u002F\u002Fscholar.google.com\u002Fcitations?user=9JcQ2hwAAAAJ&hl=en)\u003Csup>1*\u003C\u002Fsup>, &nbsp; \n[朱牧之](https:\u002F\u002Fscholar.google.com\u002Fcitations?user=064gBH4AAAAJ&hl=en)\u003Csup>1*\u003C\u002Fsup>, &nbsp;\n李恒涛\u003Csup>1*\u003C\u002Fsup>, &nbsp;\n[陈浩](https:\u002F\u002Fstan-haochen.github.io\u002F)\u003Csup>1\u003C\u002Fsup>, &nbsp;\n[王鑫龙](https:\u002F\u002Fwww.xloong.wang\u002F)\u003Csup>2\u003C\u002Fsup>, &nbsp;\n[沈春华](https:\u002F\u002Fcshen.github.io\u002F)\u003Csup>1\u003C\u002Fsup>\n\n\u003Csup>1\u003C\u002Fsup>[浙江大学](https:\u002F\u002Fwww.zju.edu.cn\u002Fenglish\u002F), &nbsp;\n\u003Csup>2\u003C\u002Fsup>[北京人工智能研究院](https:\u002F\u002Fwww.baai.ac.cn\u002Fenglish.html)\n\nICLR 2024\n\n\u003C\u002Fdiv>\n\n## 🚀 概述\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_ba26c6e7791f.png\">\n\u003C\u002Fdiv>\n\n## 📖 描述\n\n\n得益于大规模预训练，视觉基础模型在开放世界图像理解方面展现出巨大潜力。然而，与能够直接应对各种语言任务的大型语言模型不同，视觉基础模型需要特定的任务结构，并在其上进行微调。在本工作中，我们提出了**Matcher**，一种新颖的感知范式，它利用现成的视觉基础模型来解决各类感知任务。Matcher无需训练即可通过一个上下文示例实现任何物体的分割。此外，我们在Matcher框架中设计了三个有效组件，与这些基础模型协同工作，从而充分发挥它们在多样化感知任务中的潜力。Matcher在多种分割任务中均表现出色的泛化能力，且完全无需训练。我们的可视化结果进一步展示了Matcher在实际场景图像中的开放世界通用性和灵活性。\n\n[论文](https:\u002F\u002Farxiv.org\u002Fabs\u002F2305.13310)\n\n## ℹ️ 最新消息\n\n- 2024.1 Matcher已被ICLR 2024接收！\n- 2024.1 Matcher支持[Semantic-SAM](https:\u002F\u002Fgithub.com\u002FUX-Decoder\u002FSemantic-SAM)，以更好地进行部件分割。\n- 2024.1 我们提供了Gradio演示。\n- 2024.1 发布了一次性语义分割和一次性部件分割任务的代码。\n\n\n## 📖 推荐作品\n\n- SINE：基于上下文示例的简单图像分割框架。[GitHub](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FSINE)。\n- DiffewS：释放扩散模型在少样本语义分割中的潜力。[GitHub](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FDiffewS)。\n## 🗓️ 待办事项\n- [x] Gradio演示 \n- [x] 发布一次性语义分割和一次性部件分割任务的代码\n- [x] 发布用于视频对象分割的代码和模型（详见[vos-dev分支](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fblob\u002Fvos-dev\u002Fmatcher_vos\u002FEVALUATION.md)）\n\n\n## 🏗️ 安装\n\n请参阅[安装说明](INSTALL.md)。\n\n## 👻 入门指南\n\n请参阅[为Matcher准备数据集](datasets\u002FREADME.md)。\n\n请参阅[Matcher入门指南](GETTING_STARTED.md)。\n\n\n## 🖼️ 演示\n\n### 一次性语义分割\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_78c8e7764fb9.png\">\n\u003C\u002Fdiv>\n\n### 一次性物体部件分割\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_4df379168709.png\">\n\u003C\u002Fdiv>\n\n### 跨风格物体及部件分割\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_826592f044e8.png\">\n\u003C\u002Fdiv>\n\n### 可控掩码输出\n\n\u003Cdiv align=\"center\">\n\u003Cimg width=\"800\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_readme_e52ddf9362ed.png\">\n\u003C\u002Fdiv>\n\n\n### 视频对象分割\n\nhttps:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fassets\u002F119775808\u002F9ff9502d-7d2a-43bc-a8ef-01235097d62b\n\n\n## 🎫 许可证\n\n对于学术用途，本项目采用[两条款BSD许可证](https:\u002F\u002Fopensource.org\u002Flicense\u002Fbsd-2-clause)授权。  \n如需商业用途，请联系[沈春华](mailto:chhshen@gmail.com)。\n\n\n## 🖊️ 引用\n\n\n如果您在研究中使用了本项目，请考虑引用以下内容：\n\n\n```BibTeX\n@article{liu2023matcher,\n  title={Matcher: Segment Anything with One Shot Using All-Purpose Feature Matching},\n  author={Liu, Yang and Zhu, Muzhi and Li, Hengtao and Chen, Hao and Wang, Xinlong and Shen, Chunhua},\n  journal={arXiv preprint arXiv:2305.13310},\n  year={2023}\n}\n```\n\n## 致谢\n[SAM](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fsegment-anything), [DINOv2](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fdinov2), [SegGPT](https:\u002F\u002Fgithub.com\u002Fbaaivision\u002FPainter\u002Ftree\u002Fmain\u002FSegGPT), [HSNet](https:\u002F\u002Fgithub.com\u002Fjuhongm999\u002Fhsnet), [Semantic-SAM](https:\u002F\u002Fgithub.com\u002FUX-Decoder\u002FSemantic-SAM)以及[detectron2](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Fdetectron2)。","# Matcher 快速上手指南\n\nMatcher 是一个基于通用特征匹配的视觉感知框架，能够利用现成的视觉基础模型（如 SAM、DINOv2），通过**单样本**（One-Shot）示例实现无需训练的图像分割。它支持语义分割、部件分割及视频对象分割等任务。\n\n## 1. 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Linux (推荐 Ubuntu 18.04+)\n*   **Python**: 3.8 或更高版本\n*   **GPU**: 支持 CUDA 的 NVIDIA 显卡（建议显存 ≥ 8GB）\n*   **前置依赖**:\n    *   PyTorch (建议 1.10+)\n    *   torchvision\n    *   detectron2\n\n> **💡 国内加速建议**\n> 安装 PyTorch 时，推荐使用清华或中科大镜像源以提升下载速度：\n> ```bash\n> pip install torch torchvision --index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n> ```\n\n## 2. 安装步骤\n\n请按照以下步骤克隆代码并安装依赖。\n\n### 2.1 克隆仓库\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher.git\ncd Matcher\n```\n\n### 2.2 创建虚拟环境并安装依赖\n建议使用 `conda` 创建独立环境：\n\n```bash\nconda create -n matcher python=3.8 -y\nconda activate matcher\n\n# 安装 PyTorch (根据实际 CUDA 版本选择，此处以 cu118 为例)\npip install torch torchvision --index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n\n# 安装 detectron2 (国内镜像加速)\npip install detectron2 -f https:\u002F\u002Fdl.fbaipublicfiles.com\u002Fdetectron2\u002Fwheels\u002Fcu118\u002Ftorch1.13\u002Findex.html\n\n# 安装 Matcher 其他依赖\npip install -r requirements.txt\n```\n\n### 2.3 下载预训练模型\nMatcher 依赖预训练的视觉基础模型。请参考官方 [INSTALL.md](INSTALL.md) 文档下载权重文件（如 SAM ViT-H, DINOv2 等），并将其放置在项目指定的 `weights\u002F` 目录下。\n\n## 3. 基本使用\n\nMatcher 的核心优势在于**无需训练**，仅需提供一张参考图（含标注）即可对查询图进行分割。\n\n### 3.1 数据准备\n在使用前，需按照 [datasets\u002FREADME.md](datasets\u002FREADME.md) 的说明整理数据集格式。对于简单的测试，您可以准备两张图片：\n1.  **Support Image**: 包含目标的参考图及其对应的 Mask。\n2.  **Query Image**: 需要分割的目标图。\n\n### 3.2 运行单样本语义分割示例\n以下命令演示如何运行一次单样本语义分割推理（具体脚本路径请以 `GETTING_STARTED.md` 为准）：\n\n```bash\npython demo\u002Fdemo_one_shot.py \\\n    --config-file configs\u002Fmatcher_r50.yaml \\\n    --support-image path\u002Fto\u002Fsupport.jpg \\\n    --support-mask path\u002Fto\u002Fsupport_mask.png \\\n    --query-image path\u002Fto\u002Fquery.jpg \\\n    --output-dir output\u002Fresults \\\n    --opts MODEL.WEIGHTS weights\u002Fmatcher.pth\n```\n\n### 3.3 启动 Gradio 演示界面\n项目提供了交互式的 Gradio Demo，方便直观体验“点击即分割”的效果：\n\n```bash\npython demo\u002Fgradio_app.py\n```\n运行后，终端会显示本地访问地址（通常为 `http:\u002F\u002F127.0.0.1:7860`），在浏览器中打开即可上传参考图和查询图进行实时测试。\n\n### 3.4 视频对象分割 (VOS)\n如需处理视频序列，可切换至 `vos-dev` 分支并使用相应的评估脚本：\n```bash\ngit checkout vos-dev\npython matcher_vos\u002Finference_video.py --video_path path\u002Fto\u002Fvideo.mp4 --reference_frame 0\n```\n\n---\n*更多高级用法（如部件分割、跨风格分割）请参阅项目根目录下的 [GETTING_STARTED.md](GETTING_STARTED.md)。*","某电商平台的视觉算法团队需要快速上线一个功能，自动从海量商品图中提取特定款式（如“泡泡袖”或“破洞牛仔裤”）的精细掩码，以支持新一代的虚拟试衣和局部搜索业务。\n\n### 没有 Matcher 时\n- **数据标注成本高昂**：每新增一种服装部件或风格，都需要人工逐帧标注大量训练数据，耗时数周且费用昂贵。\n- **模型迭代周期漫长**：针对新类别必须重新设计网络结构并进行微调训练，从需求提出到模型上线往往需要一个月以上。\n- **泛化能力严重不足**：训练好的模型难以适应不同拍摄风格、光照条件或未见过的服装变体，导致在真实场景下准确率大幅下降。\n- **多任务维护复杂**：物体分割、部件分割和视频跟踪需要维护多套独立的模型系统，增加了工程部署和维护的难度。\n\n### 使用 Matcher 后\n- **实现零样本即时适配**：只需提供一张包含目标特征的参考图（One Shot），Matcher 即可利用通用特征匹配直接生成分割结果，完全无需额外训练。\n- **上线速度提升至分钟级**：面对新的细分需求（如识别特定领口形状），算法工程师可立即通过示例图完成配置，大幅缩短业务响应时间。\n- **跨域泛化表现卓越**：凭借强大的预训练基础模型能力，Matcher 能轻松处理写实、手绘甚至低质量监控视频中的复杂场景，保持高鲁棒性。\n- **统一架构简化部署**：单一框架同时支持静态图像语义分割、细粒度部件分割及视频对象跟踪，显著降低了系统复杂度。\n\nMatcher 通过将“训练驱动”转变为“示例驱动”，让视觉感知模型具备了像大语言模型一样的即时任务适应能力，彻底打破了传统计算机视觉对新数据标注和重训练的依赖。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faim-uofa_Matcher_78c8e776.png","aim-uofa","Advanced Intelligent Machines (AIM)","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Faim-uofa_27466af8.png","A research team at Zhejiang University, focusing on Computer Vision and broad AI research ...",null,"https:\u002F\u002Fgithub.com\u002Faim-uofa",[80,84,88,92],{"name":81,"color":82,"percentage":83},"Python","#3572A5",94,{"name":85,"color":86,"percentage":87},"Cuda","#3A4E3A",5,{"name":89,"color":90,"percentage":91},"C++","#f34b7d",0.6,{"name":93,"color":94,"percentage":95},"Shell","#89e051",0.4,556,43,"2026-04-11T05:57:15","NOASSERTION",4,"未说明","未说明 (基于 SAM 和 DINOv2 等视觉基础模型，通常建议配备 NVIDIA GPU)",{"notes":104,"python":101,"dependencies":105},"README 中未直接列出具体的版本依赖和环境配置，详细安装步骤请参考项目中的 INSTALL.md 文件。该工具依赖多个大型视觉基础模型（如 SAM, DINOv2），首次运行可能需要下载较大的模型文件。支持一次性语义分割、部件分割及视频对象分割任务。",[106,107,108,109,110],"detectron2","SAM (segment-anything)","DINOv2","Semantic-SAM","Gradio",[15],[113,114,115,116,117],"dinov2","generalist-model","matcher","sam","in-context-segmentation","2026-03-27T02:49:30.150509","2026-04-18T03:34:28.258215",[121,126,131,136,141,146,151],{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},38739,"源代码和预训练模型何时发布？","代码已经发布。该项目基于预训练的 SAM 和 DINOv2 模型，方法本身是无需训练（training-free）的，因此不需要额外的训练代码或专门的预训练权重文件。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F1",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},38740,"如何推理自己的图片或视频？支持视频推理吗？","当前版本仅支持对图片进行推理。视频推理功能计划在近期发布。请参照 README 中的说明使用图片推理功能。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F27",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},38741,"运行 COCO-20 数据集测试时出现 FileNotFoundError 错误怎么办？","该错误是因为代码需要图像格式（image format）的掩码标注，而官方提供的是 JSON 格式。作者已提供转换好的图像格式标注下载链接：\n1. 训练集标注：[train2014.zip](https:\u002F\u002Fdrive.google.com\u002Ffile\u002Fd\u002F1cwup51kcr4m7v9jO14ArpxKMA4O3-Uge\u002Fview?usp=sharing)\n2. 验证集标注：[val2014.zip](https:\u002F\u002Fdrive.google.com\u002Ffile\u002Fd\u002F1PNw4U3T2MhzAEBWGGgceXvYU3cZ7mJL1\u002Fview?usp=sharing)\n请将下载的文件解压并放置在 `annotations\u002F` 目录下（即确保 `train2014\u002F` 和 `val2014\u002F` 文件夹位于 `annotations\u002F` 内）。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F16",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},38742,"数据集的 splits fold 文件在哪里？需要手动下载吗？","是的，需要手动获取。作者已在仓库中提供了 splits 文件，您可以直接在此处下载：[https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Ftree\u002Fmain\u002Fdatasets\u002FCOCO2014\u002Fsplits](https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Ftree\u002Fmain\u002Fdatasets\u002FCOCO2014\u002Fsplits)。代码不会自动创建这些文件夹。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F14",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},38743,"Patch-level 特征是如何生成的？Center prompt 是什么意思？","1. **Patch-level 特征**：以大小为 (518, 518) 的图像为例，默认采用 DINOv2（预训练的 ViT 模型），其 patch_size 为 14x14。图像编码器会将图像编码为大小为 (518\u002F14, 518\u002F14) 的 patch-level 特征。\n2. **Center prompt**：这是一种点提示（point prompt），旨在鼓励 SAM 分割覆盖整个图像的物体。生成过程为：首先通过 Patch-level 匹配获得匹配点；然后使用 k-means++（或其他聚类算法）将这些点聚类为 K 个簇；最后在这些簇中心附近采样得到 Center prompts。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F6",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},38744,"可以在 Windows 系统上使用 Anaconda 部署吗？","作者未在 Windows 系统上进行过测试，虽然您可以尝试对齐环境自行测试，但官方强烈建议使用 Linux 环境以避免兼容性问题。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F18",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},38745,"为什么没有提供训练代码？","该方法设计为无需训练（training-free）。它直接利用预训练的 SAM（Segment Anything Model）和 DINOv2 模型进行推理，因此不存在需要发布的训练代码。","https:\u002F\u002Fgithub.com\u002Faim-uofa\u002FMatcher\u002Fissues\u002F21",[]]