[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-facebookresearch--ocean":3,"tool-facebookresearch--ocean":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 真正成长为懂上",148568,2,"2026-04-09T23:34:24",[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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"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",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"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":76,"owner_email":76,"owner_twitter":76,"owner_website":77,"owner_url":78,"languages":79,"stars":119,"forks":120,"last_commit_at":121,"license":122,"difficulty_score":123,"env_os":124,"env_gpu":125,"env_ram":125,"env_deps":126,"category_tags":133,"github_topics":76,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":135,"updated_at":136,"faqs":137,"releases":166},6151,"facebookresearch\u002Focean","ocean","Ocean is the in-house framework for Computer Vision (CV) and Augmented Reality (AR) applications at Meta. It is platform independent and is mainly implemented in C\u002FC++.","Ocean 是 Meta 内部研发并开源的计算机视觉（CV）与增强现实（AR）应用框架。它主要致力于解决跨平台开发中的兼容性与性能难题，让开发者能够使用同一套代码逻辑，轻松构建运行于 Android、iOS、Linux、Windows 以及 Meta Quest 头显等多种设备上的高质量视觉应用。\n\n这款框架非常适合从事底层图形开发、AR 内容创作的研究人员及工程师使用。由于 Ocean 采用 C\u002FC++ 编写并全面支持 C++20 标准，它在处理复杂的图像算法和实时渲染任务时表现出极高的执行效率。其最大的技术亮点在于“平台无关性”架构设计，屏蔽了不同操作系统的底层差异，同时提供了详尽的分平台构建指南。需要注意的是，Ocean 不提供预编译包，使用者需根据官方文档从源码进行编译，这虽然提高了一定的上手门槛，但也赋予了开发者对底层逻辑完全的掌控权。作为基于 MIT 协议开源的项目，Ocean 为构建下一代沉浸式体验提供了坚实且灵活的技术基石。","# Ocean\n\nOcean is a C++ framework for Computer Vision (CV) And Augmented Reality (AR) Applications.\n\n[![Build and test Ocean](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_test_linux.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_test_linux.yml)\n[![Build and deploy website](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_deploy_website.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_deploy_website.yml)\n\n# Contributing\n\nPlease read the [contribution guidelines](CONTRIBUTING.md) before submitting any code changes.\n\n# Getting Started\n\nFor a general overview, the [project website](https:\u002F\u002Ffacebookresearch.github.io\u002Focean\u002F) is a good starting point. For instructions to build Ocean, continue to read below.\n\n## General Prerequisites\n\n- [Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F) 3.8 or higher (for the build scripts)\n- [CMake](https:\u002F\u002Fcmake.org\u002Fdownload\u002F) 3.26 or higher\n- Ocean requires C++20\n- Ensure that the [Git](https:\u002F\u002Fwww.git-scm.com\u002Fdownloads) executable is available in your path.\n\n## Building\n\nPlease refer to the platform-specific instructions when building Ocean:\n\n* [Android](doc\u002Fbuilding_for_android.md)\n* [iOS](doc\u002Fbuilding_for_ios.md)\n* [Linux](doc\u002Fbuilding_for_linux.md)\n* [macOS](doc\u002Fbuilding_for_macos.md)\n* [Meta Quest](doc\u002Fbuilding_for_meta_quest.md)\n* [Windows](doc\u002Fbuilding_for_windows.md)\n* [Visual Studio](doc\u002Fbuilding_with_visual_studio.md) (Windows, Android, and OpenXR from VS)\n\nNote that we provide no pre-built binaries. To use Ocean, you must build it from source.\n\n# License\n\nOcean is released under the [MIT License](LICENSE).\n\n## License Exceptions\n\nNote that all files in the directory [`res\u002Focean\u002F...\u002Fcontroller`](res\u002Focean\u002Fplatform\u002Fmeta\u002Fquest\u002Fapplication\u002Fassets\u002Focean_meta_quest_application\u002Fcontroller\u002F)\nare licensed under the [Art Attribution License 1.0](res\u002Focean\u002Fplatform\u002Fmeta\u002Fquest\u002Fapplication\u002Fassets\u002Focean_meta_quest_application\u002Fcontroller\u002FLICENSE).\nPlease review the individual files for specific licensing details.\n","# 海洋\n\nOcean 是一个用于计算机视觉 (CV) 和增强现实 (AR) 应用的 C++ 框架。\n\n[![构建并测试 Ocean](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_test_linux.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_test_linux.yml)\n[![构建并部署网站](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_deploy_website.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Factions\u002Fworkflows\u002Fbuild_and_deploy_website.yml)\n\n# 贡献\n\n在提交任何代码更改之前，请阅读 [贡献指南](CONTRIBUTING.md)。\n\n# 开始使用\n\n如需了解总体概览，[项目官网](https:\u002F\u002Ffacebookresearch.github.io\u002Focean\u002F) 是一个不错的起点。有关如何构建 Ocean 的说明，请继续阅读下文。\n\n## 一般先决条件\n\n- [Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F) 3.8 或更高版本（用于构建脚本）\n- [CMake](https:\u002F\u002Fcmake.org\u002Fdownload\u002F) 3.26 或更高版本\n- Ocean 需要 C++20 标准\n- 确保 [Git](https:\u002F\u002Fwww.git-scm.com\u002Fdownloads) 可执行文件已在您的 PATH 中。\n\n## 构建\n\n构建 Ocean 时，请参阅特定平台的说明：\n\n* [Android](doc\u002Fbuilding_for_android.md)\n* [iOS](doc\u002Fbuilding_for_ios.md)\n* [Linux](doc\u002Fbuilding_for_linux.md)\n* [macOS](doc\u002Fbuilding_for_macos.md)\n* [Meta Quest](doc\u002Fbuilding_for_meta_quest.md)\n* [Windows](doc\u002Fbuilding_for_windows.md)\n* [Visual Studio](doc\u002Fbuilding_with_visual_studio.md)（适用于 Windows、Android 和通过 Visual Studio 使用 OpenXR）\n\n请注意，我们不提供预编译的二进制文件。要使用 Ocean，您必须从源代码进行构建。\n\n# 许可证\n\nOcean 采用 [MIT 许可证](LICENSE) 发布。\n\n## 许可证例外\n\n请注意，目录 [`res\u002Focean\u002F...\u002Fcontroller`](res\u002Focean\u002Fplatform\u002Fmeta\u002Fquest\u002Fapplication\u002Fassets\u002Focean_meta_quest_application\u002Fcontroller\u002F) 下的所有文件均采用 [Art Attribution License 1.0](res\u002Focean\u002Fplatform\u002Fmeta\u002Fquest\u002Fapplication\u002Fassets\u002Focean_meta_quest_application\u002Fcontroller\u002FLICENSE) 许可。请查看各个文件以获取具体的许可详情。","# Ocean 快速上手指南\n\nOcean 是一个用于计算机视觉（CV）和增强现实（AR）应用的 C++ 框架。由于该项目不提供预编译二进制文件，使用者必须从源代码进行构建。\n\n## 环境准备\n\n在开始构建之前，请确保您的开发环境满足以下基本要求：\n\n*   **操作系统**：支持 Linux, macOS, Windows, Android, iOS 或 Meta Quest。\n*   **Python**：版本 3.8 或更高（用于构建脚本）。\n    *   *国内建议*：安装时可配置使用清华源或阿里源加速依赖下载。\n*   **CMake**：版本 3.26 或更高。\n*   **编译器**：必须支持 **C++20** 标准。\n*   **Git**：确保 `git` 命令已添加到系统环境变量路径中。\n\n## 安装步骤\n\n由于 Ocean 针对不同平台有特定的构建依赖和配置，请根据您的目标平台选择对应的官方文档进行操作。以下是通用流程：\n\n1.  **克隆仓库**\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean.git\n    cd ocean\n    ```\n\n2.  **选择平台构建指南**\n    请查阅 `doc` 目录下对应平台的详细构建说明文档：\n\n    *   **Linux**: `doc\u002Fbuilding_for_linux.md`\n    *   **macOS**: `doc\u002Fbuilding_for_macos.md`\n    *   **Windows**: `doc\u002Fbuilding_for_windows.md`\n    *   **Android**: `doc\u002Fbuilding_for_android.md`\n    *   **iOS**: `doc\u002Fbuilding_for_ios.md`\n    *   **Meta Quest**: `doc\u002Fbuilding_for_meta_quest.md`\n    *   **Visual Studio** (适用于 Windows\u002FAndroid\u002FOpenXR): `doc\u002Fbuilding_with_visual_studio.md`\n\n    > **注意**：构建过程通常涉及运行平台特定的脚本或配置 CMake 参数，请务必严格遵循上述文档中的指令。\n\n## 基本使用\n\n构建成功后，您可以通过集成 Ocean 库到您的 C++ 项目中来开发 CV 或 AR 应用。\n\n*   **项目概览**：建议访问 [项目官网](https:\u002F\u002Ffacebookresearch.github.io\u002Focean\u002F) 查看架构概述和功能演示。\n*   **代码集成**：在您的 `CMakeLists.txt` 中链接编译生成的 Ocean 库，并包含相应的头文件即可开始开发。\n\n**许可证提示**：\n本项目主体基于 **MIT License** 发布。但请注意，目录 `res\u002Focean\u002F...\u002Fcontroller` 下的文件受 **Art Attribution License 1.0** 约束，使用时请单独核对相关文件的许可详情。","某元宇宙初创团队正在开发一款跨平台（Android、iOS 及 Meta Quest）的工业级 AR 远程协作应用，需实时识别设备零件并叠加三维操作指引。\n\n### 没有 ocean 时\n- **多端重复造轮子**：团队需分别为 Android、iOS 和 Quest 编写三套独立的 C++ 视觉算法代码，维护成本极高且容易引入不一致的 Bug。\n- **性能优化困难**：在 Quest 等算力受限设备上，自研的 AR 追踪模块帧率不稳定，导致虚拟模型“漂移”，严重影响用户沉浸感。\n- **环境配置繁琐**：新成员搭建开发环境耗时数天，需手动解决不同平台下 CMake 版本、C++20 标准支持及依赖库的兼容性问题。\n- **迭代周期漫长**：每次调整核心视觉逻辑，都需要重新编译多个平台的工程，验证一次完整功能往往需要一整天。\n\n### 使用 ocean 后\n- **一套代码通吃全平台**：利用 ocean 平台无关的 C++ 框架特性，团队只需维护单一代码库，即可自动适配 Android、iOS 及 Meta Quest 等多个系统。\n- **出厂即享高性能**：直接复用 Meta 内部验证过的高精度 CV 与 AR 算法，在 Quest 设备上也能稳定运行高帧率追踪，彻底消除模型漂移问题。\n- **标准化快速启动**：借助 ocean 成熟的构建脚本和清晰的文档，开发者可在几小时内完成从源码编译到真机调试的全流程。\n- **敏捷开发闭环**：修改核心算法后，可快速在各目标平台同步构建测试，将功能验证周期从“天”级缩短至“小时”级。\n\nocean 通过提供统一、高效且经过大规模实战验证的底层框架，让开发者能专注于业务创新而非被碎片化的平台适配和低效的基础设施所拖累。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ffacebookresearch_ocean_43555df6.png","facebookresearch","Meta Research","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Ffacebookresearch_449342bd.png","",null,"https:\u002F\u002Fopensource.fb.com","https:\u002F\u002Fgithub.com\u002Ffacebookresearch",[80,84,88,92,96,100,104,108,112,116],{"name":81,"color":82,"percentage":83},"C++","#f34b7d",93,{"name":85,"color":86,"percentage":87},"Objective-C++","#6866fb",1.7,{"name":89,"color":90,"percentage":91},"CMake","#DA3434",1.5,{"name":93,"color":94,"percentage":95},"C#","#178600",1.1,{"name":97,"color":98,"percentage":99},"C","#555555",1,{"name":101,"color":102,"percentage":103},"Python","#3572A5",0.7,{"name":105,"color":106,"percentage":107},"Java","#b07219",0.5,{"name":109,"color":110,"percentage":111},"Objective-C","#438eff",0.2,{"name":113,"color":114,"percentage":115},"Swift","#F05138",0.1,{"name":117,"color":118,"percentage":115},"PowerShell","#012456",777,89,"2026-04-09T22:38:31","MIT",4,"Linux, macOS, Windows, Android, iOS, Meta Quest","未说明",{"notes":127,"python":128,"dependencies":129},"该项目是一个用于计算机视觉 (CV) 和增强现实 (AR) 的 C++ 框架，不提供预编译二进制文件，必须从源代码构建。针对不同平台（如 Android, iOS, Meta Quest 等）有专门的构建文档。部分控制器资源文件采用 Art Attribution License 1.0 许可，需注意具体文件的授权细节。","3.8+",[130,131,132],"CMake>=3.26","Git","C++20 编译器",[15,14,134],"其他","2026-03-27T02:49:30.150509","2026-04-10T15:54:21.721026",[138,143,148,153,158,162],{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},27841,"在 iOS 上链接时遇到未定义符号（如 _hb_blob_create 等）的编译错误怎么办？","这是因为依赖了 HarfBuzz 库导致的链接错误。解决方法是修改 CMake 配置，禁用 HarfBuzz 依赖。\n\n具体步骤：\n1. 找到文件 `build\u002Fcmake\u002Fthird-party\u002Ffreetype.cmake`。\n2. 将 `set(FT_REQUIRE_HARFBUZZ FALSE)` 改为 `set(FT_DISABLE_HARFBUZZ TRUE)`。\n3. 重新构建整个项目。\n\n确保第三方库的安装路径在构建第三方库和构建 Ocean 项目之间保持一致。维护者已提交补丁以完全禁用对 HarfBuzz 的依赖。","https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Fissues\u002F37",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},27842,"为什么校准图案检测失败，或者需要图案占据画面的大部分才能检测到？","当前的校准图案检测器基于一个强假设：场景中必须有一个单一且连贯的校准图案占据主导地位。如果图案太远、太小或被分割，检测可能会失败。\n\n对于多图案或复杂背景的情况，早期版本可能无法处理。但维护者已在提交 `f41f9bd401514f5c424c3f983fe547ecfad819a4` 中修复了配置疏忽，现在可以支持更复杂的场景（包括用户提供的测试图像）。请拉取最新代码重试。\n\n注意：虽然原理上可以将多个纸张拼接成一个大图案，但这通常不切实际。建议尽量保证单个图案清晰且占据画面主要部分。","https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Fissues\u002F41",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},27843,"在 Linux\u002FUnix 上运行第三方构建脚本时，protozero 构建失败或出现路径错误怎么办？","该问题通常由相对路径处理不当引起。\n\n临时解决方案：\n在执行 `build_thirdparty_linuxunix.sh` 脚本时，为 `-b` (build directory) 和 `-i` (install directory) 参数提供完整的绝对路径，而不是相对路径。\n\n示例命令：\n`..\u002Fbuild\u002Fcmake\u002Fbuild_thirdparty_linuxunix.sh -c release -l shared -b \u002Fabsolute\u002Fpath\u002Fto\u002Fbuild -i \u002Fabsolute\u002Fpath\u002Fto\u002Finstall`\n\n永久修复：\n维护者已通过提交 `0e981b46952855db6ba491a76fc7d0b57cd42e80` 和 `a6d97550494f5fc5d67fe93d4710b31ba0b1eed2` 修复了 protozero 的构建失败及相对路径问题。建议更新到包含这些修复的最新版本。","https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Fissues\u002F39",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},27844,"在 macOS 上构建和安装 Ocean 时因缺少依赖而失败怎么办？","在 macOS 上构建时，需确保正确设置了构建目录、安装目录和第三方库目录的路径，并使用正确的 CMake 参数。\n\n关键配置点：\n1. 使用 `build_ocean_linuxunix.sh` 脚本（尽管名字含 linuxunix，也适用于 macOS）。\n2. 明确指定 `-t` 参数指向第三方库的安装位置，例如：`-t \"${HOME}\u002Finstall_ocean_thirdparty\"`。\n3. 确保 CMAKE_PREFIX_PATH 正确指向第三方库的安装目录，以便 CMake 能找到依赖项。\n4. 检查是否安装了必要的编译器工具链（如 Xcode Command Line Tools）。\n\n如果日志显示找不到编译器或特定库，请先通过 Homebrew 或 Xcode 安装缺失的组件（如 cmake, git, protobuf 等）。","https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Fissues\u002F15",{"id":159,"question_zh":160,"answer_zh":161,"source_url":142},27845,"如何禁用 HarfBuzz 依赖以避免 iOS 构建问题？","为避免 iOS 构建中因 HarfBuzz 引起的未定义符号错误，可以在 CMake 配置中显式禁用它。\n\n操作方法：\n在 `build\u002Fcmake\u002Fthird-party\u002Ffreetype.cmake` 文件中，添加或修改以下行：\n`set(FT_DISABLE_HARFBUZZ TRUE)`\n\n然后清理构建缓存并重新运行构建流程。这将使 FreeType 不使用 HarfBuzz 进行字体整形，从而绕过相关的链接错误。此方法已由维护者确认有效，并计划合并到主分支以默认禁用该依赖。",{"id":163,"question_zh":164,"answer_zh":165,"source_url":147},27846,"校准检测在图像旋转或增加角落颜色后失败，是否有更鲁棒的解决方案？","早期版本的校准检测器对图案的完整性和单一性要求较高，导致在图案被裁剪、旋转或背景复杂时失败。\n\n最新进展：\n维护者已发布修复提交 `f41f9bd401514f5c424c3f983fe547ecfad819a4`，解决了配置中的疏忽，显著提升了对非理想图案（如包含额外角落、颜色变化或部分遮挡）的检测能力。\n\n建议操作：\n1. 更新代码库至包含该提交的最新版本。\n2. 重新测试之前失败的图像。\n3. 若仍存在问题，请提供具体的相机视场角（FOV）、分辨率及光照条件信息以便进一步调试。\n\n目前算法仍假设场景中主要存在一个连贯图案，但在合理范围内已具备更好的鲁棒性。",[167,171,176],{"id":168,"version":169,"summary_zh":76,"released_at":170},188807,"v2.0.0","2026-04-09T21:48:40",{"id":172,"version":173,"summary_zh":174,"released_at":175},188808,"v1.0.1","本次发布包含多项小幅改进。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Ffacebookresearch\u002Focean\u002Fcompare\u002Fv1.0.0...v1.0.1","2024-08-29T16:50:17",{"id":177,"version":178,"summary_zh":179,"released_at":180},188809,"v1.0.0","这是 Ocean 的 v1.0.0 版本。","2024-07-08T20:36:20"]