oheco 是一个面向 OpenHarmony 开源生态建设的 GitHub 组织。我们的核心目标是将众多开源软件移植到 OpenHarmony 系统中，覆盖 HarmonyOS 等使用场景，让用户能够方便地获取软件，也让开发者能够共同参与适配与长期维护。

组织负责协调项目接入、打包和发布；项目维护者负责具体软件的适配与维护。适配完成的软件通过 GitHub Releases 发布，并收录到统一的软件目录，供所有人使用。

你可以通过下载站查找软件、直接下载发行包，也可以使用 oheco 包管理器在终端完成搜索、下载、安装和版本切换。

组织面向 OpenHarmony 生态持续扩展；当前包管理器支持 HarmonyOS arm64，软件包平台标识为 ohos-arm64。具体软件的支持范围以下载站和项目说明为准。

安装 oheco 前，请先完成以下系统设置：

1. 开启开发者模式：前往“设置 → 关于本机 → 软件版本”，连续点击 7 次，打开开发者模式。
2. 允许运行来自非应用市场的扩展程序：前往“设置 → 隐私和安全 → 高级 → 运行来自非应用市场的扩展程序”，开启该选项。

请在 HarmonyOS 原生 zsh 终端中执行安装命令；安装器会检查系统类型与架构。

安装需要能够访问 GitHub Releases 和下载站，并具备 curl、tar、sha256sum（或 shasum）及基础文件命令；无需预先安装 Go、Git 或 jq。

curl -fsSL https://oheco.org/install.sh | zsh

默认安装目录为 ~/.oheco。安装脚本会向 zsh 配置文件（通常为 ~/.zshrc）添加命令路径。安装成功后，重新打开终端，或者在当前终端执行：

export PATH="$HOME/.oheco/bin:$PATH"
oo --version

使用自定义安装目录时，请先在 zsh 配置文件中添加 export OHECO_ROOT="/实际安装目录的绝对路径"，加载配置后再执行安装命令。安装器会配置对应的 PATH；后续终端也需要保留该 OHECO_ROOT 配置，才能管理同一目录中的软件。

以下以 Go 工具链为例，演示从查找软件到开始使用的完整过程。

oo update
oo search go
oo info go

oo update 将远端软件索引同步到本地；oo search go 查找相关软件；oo info go 查看 Go 的可用版本、下载地址和软件说明。可用版本以最新索引为准。

oo install go

这条命令会下载当前平台在索引中标记为最新的 Go 发行包，校验文件大小和 SHA-256，解压到 ~/.oheco/packages/go/<版本>/，并启用该版本的 go 和 gofmt 命令。

也可以指定包版本。Go 的鸿蒙适配包 1.27.1-ohos.1 对应上游 Go 1.27.1：

oo install go@1.27.1-ohos.1

go version
oo list

go version 显示已启用的 Go 版本；oo list 列出已安装的软件和版本，其中 * 表示当前启用的版本。

安装 Go 工具链后，编译新程序还需要 PATH 中的 binary-sign-tool（由 ohos-sdk-toolchains 包提供，可用 oo install ohos-sdk-toolchains 安装）；使用 cgo 还需要 OHOS LLVM/SDK，可通过 oo install ohos-sdk-native 安装。请按 Go 适配说明配置工具链，并将 TMPDIR 指向当前应用的私有可写目录。这些依赖需要单独安装。

如果希望自行保存发行包，可在软件下载站搜索 go，选择版本，点击“下载软件包”，并展开 SHA-256 信息用于核验文件。也可以直接打开 Go Releases，在对应版本的 Assets 中下载适配包，例如 go1.27.1.ohos-arm64.tar.gz。

下载预编译软件时请选择适配包；GitHub 自动提供的 Source code 是源码归档。浏览器下载后，软件尚未安装，也不会自动配置命令路径；希望自动完成这些步骤时，使用 oo install go。

oo update 只更新目录，不升级已安装的软件。要获取新版软件，先执行 oo update，再执行 oo install <包名>。切换版本只对已安装版本生效；卸载当前启用版本后，需要手动切换到其他已安装版本。

如果你是开发者和开源维护者，愿意适配并持续维护一个开源项目，欢迎阅读参与指南，选定项目及其 Release 版本后，在本组织的 .github 仓库提交 Issue。