在鸿蒙PC上运行 iFlow CLI:Node环境配置实战

前言

随着鸿蒙PC的普及,开发者们开始在全新的平台上探索各种开发可能性。最近,我在鸿蒙PC上尝试运行一些大模型相关的CLI工具时,遇到了一些环境配置的挑战。经过一番探索,我找到了一个相对优雅的解决方案,今天就和大家分享一下我的实践经验。

环境准备

在开始之前,请确保你的鸿蒙PC已经安装了以下工具:

  • CodeArts IDE
  • DevNodeOH

问题背景

在鸿蒙PC上,由于系统权限和路径管理的特殊性,直接通过 npm install -g 安装的CLI工具往往无法正常在系统终端或CodeArts IDE中运行。特别是对于大模型相关的CLI工具,如 iflow 等,它们通常依赖于特定的环境变量配置。

解决方案

第一步:创建自定义npm安装路径

为了避免权限问题,我们可以创建一个用户级的npm安装目录:

# 在CodeArts IDE终端中执行
mkdir -p /storage/Users/currentUser/npm
npm config set prefix /storage/Users/currentUser/npm

这个命令会将npm的全局安装路径设置为用户目录下的自定义位置,避免了需要系统权限的问题。

第二步:安装目标CLI工具

以iflow cli为例,安装大模型相关的CLI工具:

# 安装iflow cli
npm install -g @iflow/cli

# 或者安装其他大模型CLI工具
# npm install -g ollama
# npm install -g llama-cli

安装完成后,工具会被安装到 /storage/Users/currentUser/npm/bin 目录下。

第三步:配置环境变量

这是最关键的一步。我们需要修改shell配置文件,将自定义的npm路径添加到系统PATH中。

  1. 使用vim编辑配置文件
vim /storage/Users/currentUser/.zshrc
  1. 在文件末尾添加以下内容
# Custom npm bin directory for HarmonyOS PC
export NPM_PREFIX="/storage/Users/currentUser/npm"
export PATH="$NPM_PREFIX/bin:$PATH"
  1. 保存并退出vim
    • ESC
    • 输入 :wq
    • 按回车

第四步:使配置生效

# 重新加载配置文件
source /storage/Users/currentUser/.zshrc

# 验证配置是否生效
echo $PATH

你应该能在输出中看到 /storage/Users/currentUser/npm/bin 路径。

第五步:验证安装

# 验证iflow cli是否可用
iflow --version

# 或者测试其他已安装的CLI
which iflow

1cc51153-9211-4d99-9368-7e5deb09106a.png

结语

通过这种配置方式,我们在鸿蒙PC上成功搭建了一个灵活且可控的CLI工具环境。这不仅适用于大模型CLI工具,也适用于其他npm全局安装的工具。鸿蒙生态正在快速发展,作为开发者,我们需要不断探索和适应新的开发环境。

希望这篇博客能帮助你在鸿蒙PC上顺利运行大模型CLI工具。如果你有更好的方法或遇到了其他问题,欢迎在评论区分享交流!