[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-vipstone--faceai":3,"tool-vipstone--faceai":61},[4,18,26,36,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},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"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,52],"视频",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[14,35],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":78,"owner_website":78,"owner_url":79,"languages":80,"stars":85,"forks":86,"last_commit_at":87,"license":88,"difficulty_score":89,"env_os":90,"env_gpu":91,"env_ram":91,"env_deps":92,"category_tags":102,"github_topics":103,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":109,"updated_at":110,"faqs":111,"releases":147},4346,"vipstone\u002Ffaceai","faceai","一款入门级的人脸、视频、文字检测以及识别的项目.","faceai 是一款面向初学者的开源计算机视觉项目，旨在降低人脸分析与图像处理的入门门槛。它整合了 OpenCV、Dlib、Keras 及 Tesseract OCR 等主流技术栈，提供了一站式的解决方案，帮助用户轻松实现人脸检测与识别、性别判断、七种情绪分析、视频对象提取、图片自动上色及去水印修复等复杂功能。此外，faceai 还包含数字化妆、头像特效合成及脸部轮廓绘制等趣味应用，让技术演示更加生动直观。\n\n该项目主要解决了初学者在面对分散的算法库时难以快速搭建完整演示环境的痛点，通过模块化的代码和详尽的中文教程，让用户能迅速理解并复现核心技术。faceai 特别适合编程初学者、高校学生、AI 爱好者以及需要快速验证原型的开发者使用。其独特的亮点在于将严肃的生物特征识别与有趣的图像编辑功能相结合，并提供了从环境配置到模型训练的全流程指导，是学习 Python 图像处理与深度学习应用的理想实践平台。","[English Doc](README_en.md)\n# 功能 #\n\n1. 人脸检测、识别（图片、视频）\n2. 轮廓标识\n3. 头像合成（给人戴帽子）\n4. 数字化妆（画口红、眉毛、眼睛等）\n5. 性别识别\n6. 表情识别（生气、厌恶、恐惧、开心、难过、惊喜、平静等七种情绪）\n7. 视频对象提取\n8. 图片修复（可用于水印去除）\n9. 图片自动上色\n10. 眼动追踪（待完善）\n11. 换脸（待完善）\n\n**查看功能预览↓↓↓**\n\n# 开发环境 #\n\n- Windows 10（x64）\n- Python 3.6.4\n- OpenCV 3.4.1\n- Dlib 19.8.1\n- face_recognition 1.2.2\n- keras 2.1.6\n- tensorflow 1.8.0\n- Tesseract OCR 4.0.0-beta.1\n\n\n# 教程 #\n\n[OpenCV环境搭建](doc\u002Fsettingup.md)\n\n[Tesseract OCR文字识别](doc\u002FtesseractOCR.md)\n\n[图片人脸检测（OpenCV版）](doc\u002FdetectionOpenCV.md)\n\n[图片人脸检测（Dlib版）](doc\u002FdetectionDlib.md)\n\n[视频人脸检测（OpenCV版）](doc\u002FvideoOpenCV.md)\n\n[视频人脸检测（Dlib版）](doc\u002FvideoDlib.md)\n\n[脸部轮廓绘制](doc\u002FfaceRecognitionOutline.md)\n\n[数字化妆](doc\u002FfaceRecognitionMakeup.md)\n\n[视频人脸识别](doc\u002FfaceRecognition.md)\n\n[头像特效合成](doc\u002Fcompose.md)\n\n[性别识别](doc\u002Fgender.md)\n\n[表情识别](doc\u002Femotion.md)\n\n[视频对象提取](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Fhsv-opencv.md)\n\n[图片修复](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Finpaint.md)\n\n\n# 其他教程 #\n\n[Ubuntu apt-get和pip源更换](doc\u002FubuntuChange.md)\n\n[pip\u002Fpip3更换国内源——Windows版](doc\u002FpipChange.md)\n\n[OpenCV添加中文](doc\u002Fchinese.md)\n\n[使用鼠标绘图——OpenCV](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Fopencv\u002Fmouse.md)\n\n\n# 功能预览 #\n\n**绘制脸部轮廓**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_b6ce6870ffa8.png\" width = \"250\" height = \"300\" alt=\"绘制脸部轮廓\" \u002F>\n\n----------\n\n**人脸68个关键点标识**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_5539e9338baa.png\" width = \"230\" height = \"300\" alt=\"人脸68个关键点标识\" \u002F>\n\n----------\n\n**头像特效合成**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_fa71a7e83bb3.png\" width = \"200\" height = \"300\" alt=\"头像特效合成\"  \u002F>\n\n----------\n\n**性别识别**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_e1d43ac8ff70.png\" width = \"430\" height = \"220\" alt=\"性别识别\"  \u002F>\n\n----------\n\n**表情识别**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_c92613116aea.png\" width = \"250\" height = \"300\" alt=\"表情识别\"  \u002F>\n\n----------\n\n**数字化妆**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_e8b19a6027b3.png\" width = \"450\" height = \"300\" alt=\"视频人脸识别\"  \u002F>\n\n----------\n\n**视频人脸检测**\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_3e3e75469fae.gif)\n\n----------\n\n**视频人脸识别**\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_1e750c5b592d.gif)\n\n----------\n\n**视频人脸识别**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Fopencv-hsv.gif)\n\n----------\n\n**图片修复**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Finpaint.png?2)\n\n----------\n\n**图片自动上色**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Fcolorize-faceai.png)\n\n----------\n\n# 技术方案 #\n\n技术实现方案介绍\n\n\t人脸识别：OpenCV \u002F Dlib\n\t\n\t人脸检测：face_recognition\n\t\n\t性别识别：keras + tensorflow\n\t\n\t文字识别：Tesseract OCR\n\n\n### TODO ###\n\n换脸——待完善\n\n眼睛移动方向检测——待完善\n\nDlib性能优化方案\n\nDlib模型训练方法\n\nTesseract模型训练方法\n\n# 贡献者名单（特别感谢）\t\n\n[archersmind](https:\u002F\u002Fgithub.com\u002Farchersmind)\t\n\t\n[rishab-sharma](https:\u002F\u002Fgithub.com\u002Frishab-sharma)\n\n# 微信打赏\n\n![微信打赏](http:\u002F\u002Ficdn.apigo.cn\u002Fmyinfo\u002Fwchat-pay.png)","[英文文档](README_en.md)\n# 功能 #\n\n1. 人脸检测、识别（图片、视频）\n2. 轮廓标识\n3. 头像合成（给人戴帽子）\n4. 数字化妆（画口红、眉毛、眼睛等）\n5. 性别识别\n6. 表情识别（生气、厌恶、恐惧、开心、难过、惊喜、平静等七种情绪）\n7. 视频对象提取\n8. 图片修复（可用于水印去除）\n9. 图片自动上色\n10. 眼动追踪（待完善）\n11. 换脸（待完善）\n\n**查看功能预览↓↓↓**\n\n# 开发环境 #\n\n- Windows 10（x64）\n- Python 3.6.4\n- OpenCV 3.4.1\n- Dlib 19.8.1\n- face_recognition 1.2.2\n- keras 2.1.6\n- tensorflow 1.8.0\n- Tesseract OCR 4.0.0-beta.1\n\n\n# 教程 #\n\n[OpenCV环境搭建](doc\u002Fsettingup.md)\n\n[Tesseract OCR文字识别](doc\u002FtesseractOCR.md)\n\n[图片人脸检测（OpenCV版）](doc\u002FdetectionOpenCV.md)\n\n[图片人脸检测（Dlib版）](doc\u002FdetectionDlib.md)\n\n[视频人脸检测（OpenCV版）](doc\u002FvideoOpenCV.md)\n\n[视频人脸检测（Dlib版）](doc\u002FvideoDlib.md)\n\n[脸部轮廓绘制](doc\u002FfaceRecognitionOutline.md)\n\n[数字化妆](doc\u002FfaceRecognitionMakeup.md)\n\n[视频人脸识别](doc\u002FfaceRecognition.md)\n\n[头像特效合成](doc\u002Fcompose.md)\n\n[性别识别](doc\u002Fgender.md)\n\n[表情识别](doc\u002Femotion.md)\n\n[视频对象提取](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Fhsv-opencv.md)\n\n[图片修复](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Finpaint.md)\n\n\n# 其他教程 #\n\n[Ubuntu apt-get和pip源更换](doc\u002FubuntuChange.md)\n\n[pip\u002Fpip3更换国内源——Windows版](doc\u002FpipChange.md)\n\n[OpenCV添加中文](doc\u002Fchinese.md)\n\n[使用鼠标绘图——OpenCV](https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fblob\u002Fmaster\u002Fdoc\u002Fopencv\u002Fmouse.md)\n\n\n# 功能预览 #\n\n**绘制脸部轮廓**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_b6ce6870ffa8.png\" width = \"250\" height = \"300\" alt=\"绘制脸部轮廓\" \u002F>\n\n----------\n\n**人脸68个关键点标识**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_5539e9338baa.png\" width = \"230\" height = \"300\" alt=\"人脸68个关键点标识\" \u002F>\n\n----------\n\n**头像特效合成**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_fa71a7e83bb3.png\" width = \"200\" height = \"300\" alt=\"头像特效合成\"  \u002F>\n\n----------\n\n**性别识别**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_e1d43ac8ff70.png\" width = \"430\" height = \"220\" alt=\"性别识别\"  \u002F>\n\n----------\n\n**表情识别**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_c92613116aea.png\" width = \"250\" height = \"300\" alt=\"表情识别\"  \u002F>\n\n----------\n\n**数字化妆**\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_e8b19a6027b3.png\" width = \"450\" height = \"300\" alt=\"视频人脸识别\"  \u002F>\n\n----------\n\n**视频人脸检测**\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_3e3e75469fae.gif)\n\n----------\n\n**视频人脸识别**\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_readme_1e750c5b592d.gif)\n\n----------\n\n**视频人脸识别**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Fopencv-hsv.gif)\n\n----------\n\n**图片修复**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Finpaint.png?2)\n\n----------\n\n**图片自动上色**\n\n![](http:\u002F\u002Ficdn.apigo.cn\u002Fcolorize-faceai.png)\n\n----------\n\n# 技术方案 #\n\n技术实现方案介绍\n\n\t人脸识别：OpenCV \u002F Dlib\n\t\n\t人脸检测：face_recognition\n\t\n\t性别识别：keras + tensorflow\n\t\n\t文字识别：Tesseract OCR\n\n\n### TODO ###\n\n换脸——待完善\n\n眼睛移动方向检测——待完善\n\nDlib性能优化方案\n\nDlib模型训练方法\n\nTesseract模型训练方法\n\n# 贡献者名单（特别感谢）\t\n\n[archersmind](https:\u002F\u002Fgithub.com\u002Farchersmind)\t\n\t\n[rishab-sharma](https:\u002F\u002Fgithub.com\u002Frishab-sharma)\n\n# 微信打赏\n\n![微信打赏](http:\u002F\u002Ficdn.apigo.cn\u002Fmyinfo\u002Fwchat-pay.png)","# FaceAI 快速上手指南\n\nFaceAI 是一个基于 Python 的开源人脸识别与图像处理工具库，支持人脸检测、识别、性别\u002F表情分析、数字化妆、图片修复及自动上色等多种功能。\n\n## 1. 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Windows 10 (x64) 或 Linux (Ubuntu 推荐)\n*   **Python 版本**: 3.6.4 (建议 3.6 - 3.8 之间)\n*   **核心依赖**:\n    *   OpenCV 3.4.1+\n    *   Dlib 19.8.1+\n    *   face_recognition 1.2.2+\n    *   Keras 2.1.6 + TensorFlow 1.8.0\n    *   Tesseract OCR 4.0.0-beta.1+\n\n> **注意**：部分功能（如性别识别、表情识别）依赖较旧版本的 TensorFlow (1.x)，若需使用最新特性请注意版本兼容性。\n\n## 2. 安装步骤\n\n### 第一步：配置国内镜像源（推荐）\n为了加速依赖包下载，建议先将 pip 源更换为国内镜像（如清华源）。\n\n**Windows 用户：**\n```bash\npip install pip -U\npip config set global.index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n**Linux\u002FMac 用户：**\n```bash\npip install pip -U\npip config set global.index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 第二步：安装系统级依赖\n**Windows 用户**：\n请下载并安装 **Tesseract OCR** (版本 4.0.0-beta.1 或兼容版)，并将其添加到系统环境变量 PATH 中。\n\n**Ubuntu 用户**：\n```bash\nsudo apt-get update\nsudo apt-get install -y cmake build-essential libgtk-3-dev libboost-all-dev tesseract-ocr libtesseract-dev\n```\n\n### 第三步：安装 Python 依赖库\n克隆项目代码并安装所需库：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai.git\ncd faceai\n\n# 安装核心依赖\npip install opencv-python==3.4.1.15 dlib==19.8.1 face_recognition==1.2.2\npip install keras==2.1.6 tensorflow==1.8.0\npip install pytesseract pillow numpy\n```\n\n> **提示**：如果 `dlib` 编译失败，请确保已安装 C++ 编译环境（Windows 下需安装 Visual Studio Build Tools）。\n\n## 3. 基本使用\n\n以下是最基础的人脸检测与轮廓绘制示例。\n\n### 示例：图片人脸检测与轮廓绘制\n\n创建一个名为 `demo.py` 的文件，输入以下代码：\n\n```python\nimport cv2\nimport face_recognition\n\n# 1. 加载图片\nimage_path = \"test.jpg\"  # 请替换为你的图片路径\nimage = face_recognition.load_image_file(image_path)\n\n# 2. 查找人脸位置\nface_locations = face_recognition.face_locations(image)\n\n# 3. 转换为 BGR 格式以便 OpenCV 显示\nimage_bgr = cv2.cvtColor(image, cv2.COLOR_RGB2BGR)\n\n# 4. 绘制矩形框\nfor (top, right, bottom, left) in face_locations:\n    cv2.rectangle(image_bgr, (left, top), (right, bottom), (0, 255, 0), 2)\n    print(f\"发现人脸：顶部={top}, 右侧={right}, 底部={bottom}, 左侧={left}\")\n\n# 5. 显示结果\ncv2.imshow(\"Face Detection\", image_bgr)\ncv2.waitKey(0)\ncv2.destroyAllWindows()\n```\n\n### 运行其他功能\n项目 `doc` 目录下提供了详细的功能教程脚本，您可以直接运行对应的示例文件来体验更多功能：\n\n*   **性别识别**: 参考 `doc\u002Fgender.md` 相关脚本\n*   **表情识别**: 参考 `doc\u002Femotion.md` 相关脚本\n*   **数字化妆**: 参考 `doc\u002FfaceRecognitionMakeup.md` 相关脚本\n*   **视频处理**: 将上述代码中的图片加载逻辑替换为 `cv2.VideoCapture` 即可处理视频流。\n\n---\n*更多高级功能（如图片修复、自动上色、对象提取）请参考项目仓库中的 `doc` 目录详细文档。*","某短视频运营团队需要为大量用户生成的自拍视频自动添加趣味特效（如戴帽子、数字化妆）并分析观众情绪反馈，以优化内容推荐策略。\n\n### 没有 faceai 时\n- 开发团队需分别集成多个独立库来实现人脸检测、关键点定位和图像合成，环境配置复杂且兼容性冲突频发。\n- 无法实时识别视频中人物的性别与七种细微表情，导致用户画像标签缺失，只能依靠人工抽样标注，效率极低。\n- 给视频中的人物动态“戴帽子”或“画口红”需要编写复杂的坐标追踪算法，开发周期长达数周且效果僵硬。\n- 对于老旧的黑白素材或带有水印的宣传图，缺乏自动上色和修复工具，必须依赖专业设计师手动处理，成本高昂。\n\n### 使用 faceai 后\n- 依托 faceai 集成的 OpenCV 与 Dlib 方案，团队在 Windows 环境下快速搭建好统一的人脸检测与识别流程，大幅降低部署门槛。\n- 直接调用内置的性别与表情识别模块，实时输出用户情绪数据（如开心、惊讶），瞬间完成海量视频的用户情感分析。\n- 利用头像特效合成与数字化妆功能，几行代码即可实现帽子跟随头部移动、自动绘制眉毛口红等效果，特效上线时间从数周缩短至几天。\n- 通过图片修复与自动上色功能，一键去除旧素材水印并将黑白照片还原为彩色，显著降低了内容制作的物料成本。\n\nfaceai 将原本分散且高门槛的计算机视觉能力整合为一站式解决方案，让中小团队也能低成本实现复杂的视频智能处理与互动特效。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvipstone_faceai_f63e0c9a.png","vipstone","磊哥","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fvipstone_3f18027c.jpg","我的网站：www.javacn.site","Java","xi'an, China",null,"https:\u002F\u002Fgithub.com\u002Fvipstone",[81],{"name":82,"color":83,"percentage":84},"Python","#3572A5",100,11091,2499,"2026-04-05T16:26:14","MIT",4,"Windows","未说明",{"notes":93,"python":94,"dependencies":95},"README 明确列出的开发环境为 Windows 10 (x64)。虽然提供了 Ubuntu 源更换的教程，但未明确声明支持 Linux 或 macOS。该项目依赖较旧的深度学习框架（TensorFlow 1.8, Keras 2.1），建议严格匹配版本以避免兼容性问题。部分功能（如换脸、眼动追踪）标记为待完善。","3.6.4",[96,97,98,99,100,101],"OpenCV==3.4.1","Dlib==19.8.1","face_recognition==1.2.2","keras==2.1.6","tensorflow==1.8.0","Tesseract OCR==4.0.0-beta.1",[15,14],[104,105,106,107,108],"dlib","opencv","tesseract-ocr","keras","tensorflow","2026-03-27T02:49:30.150509","2026-04-06T18:53:51.482844",[112,117,122,127,132,137,142],{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},19765,"为什么使用多人脸图片时只能检测出一张人脸？","这是因为检测参数设置过于严格。尝试修改 `minNeighbors` 参数（例如调低该数值），即可成功检测到图片中的多张人脸。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F38",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},19766,"运行代码时报错 'IndexError: list index out of range' 怎么办？","这通常是因为某张图片中未检测到人脸，导致列表为空。请修改代码增加长度判断：\n1. 将获取编码的行改为：`known_face_encodings = face_recognition.face_encodings(face_recognition.load_image_file(path + \"\u002F\" + fn))`\n2. 添加判断：`if len(known_face_encodings) > 0:`，然后再执行 `total_face_encoding.append(known_face_encodings[0])`。\n此外，也可以尝试更换一张清晰的人脸图片。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F30",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},19767,"性别识别（gender.py）在处理包含多人的图片时没有效果或无变化，原因是什么？","这通常是因为图片中的人脸尺寸太小，低于识别模型的最小尺寸限制。脸部识别有一个 `minSize` 属性，建议根据需求调整图片尺寸（放大图片）或修改代码中的 `minSize` 参数后再试。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F12",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},19768,"文字识别结果出现乱码，与 Demo 效果不一致，如何解决？","这是命令行终端编码问题导致的。如果你使用的是 Bash 打开脚本，可能会出现中文乱码。请改用 Windows PowerShell 运行脚本，即可正常显示中文识别结果。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F39",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},19769,"在 Windows 上安装 face_recognition 失败，报错 dlib 编译错误或缺少 cmake，如何解决？","安装失败通常是因为缺少编译依赖。主要解决方法是安装 CMake 和 Visual C++ Build Tools。具体步骤可参考相关技术博客（如 CSDN 上的解决方案），确保系统环境变量中配置好了 cmake，并安装了支持 Python 版本的编译工具链后再重新运行 `pip install face_recognition`。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F25",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},19770,"运行检测代码时报错 'cv2.error: (-215:Assertion failed) !empty() in function cv::CascadeClassifier::detectMultiScale'，怎么处理？","该错误表示 OpenCV 未能加载人脸分类器文件（haarcascade）。你需要手动下载 `haarcascade_frontalface_default.xml` 文件。可以从 OpenCV 官方仓库下载：https:\u002F\u002Fgithub.com\u002Fopencv\u002Fopencv\u002Ftree\u002Fmaster\u002Fdata\u002Fhaarcascades，下载后确保代码中引用的路径正确指向该文件。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F24",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},19771,"项目是否支持 Mac 系统安装和使用？","目前维护者暂未提供专门的 Mac 安装教程，但表示后续会补充相关指南。对于跨平台项目，通常建议在 Mac 上同样使用 pip 安装依赖，若遇到特定库（如 dlib）编译问题，可能需要安装 Xcode Command Line Tools。","https:\u002F\u002Fgithub.com\u002Fvipstone\u002Ffaceai\u002Fissues\u002F4",[]]