Skip to content

安装

hipmmcode 以预编译二进制发行,覆盖 macOS(Apple Silicon 与 Intel)、Linux(x64 与 arm64)、Windows(x64)。

curl(macOS / Linux,推荐)

bash
curl -fsSL https://github.com/HiPMMAI/hipmmcode/releases/latest/download/install.sh | bash

安装到 ~/.local/bin/hipmmcode,必要时提示 PATH 配置。v0.14.1+ 会同步 L1 默认技能包~/.hipmmcode/skills/(见 技能 — 默认包)。

Homebrew(macOS)

bash
brew tap hipmmai/hipmmcode https://github.com/HiPMMAI/hipmmcode
brew install hipmmcode

npm

bash
npm install -g @hipmmai/hipmmcode

npm 包装器会在安装时下载对应平台二进制,并在 tarball 含 default-skills/ 时执行 skill install-defaults(v0.14.1+)。

Windows(PowerShell)

powershell
irm https://github.com/HiPMMAI/hipmmcode/releases/latest/download/install.ps1 | iex

需要 Windows 10+ 与 PowerShell 5.1+。安装到 %USERPROFILE%\.local\bin\hipmmcode.exe —— 与 macOS/Linux 的相对位置一致。

如果安装成功后,当前 PowerShell 仍提示找不到 hipmmcode 或无法执行 hipmmcode model,有两种处理方法:

  1. 关闭当前终端并重新打开;
  2. 不关闭窗口,在当前 PowerShell 中手动刷新 PATH,让本会话立即读取系统与用户的最新配置:
powershell
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
hipmmcode --version
hipmmcode model

Windows 终端

hipmmcode 在老式控制台也能跑,但 Windows Terminal 的全屏 TUI 体验最佳(正确的 VT 渲染、字体与鼠标支持)。

手动安装

Releases 页面下载压缩包,用 SHA256SUMS 校验,解压后把 hipmmcode 放进 PATH

资产平台
hipmmcode-darwin-universal.tar.gzmacOS —— Apple Silicon 与 Intel 通用
hipmmcode-darwin-arm64.tar.gz仅 macOS Apple Silicon
hipmmcode-darwin-x64.tar.gz仅 macOS Intel
hipmmcode-linux-x64.tar.gzLinux x86-64(musl 静态链接,无 libc 依赖)
hipmmcode-linux-arm64.tar.gzLinux arm64(musl 静态)
hipmmcode-windows-x64.tar.gzWindows x64
bash
shasum -a 256 -c SHA256SUMS      # 校验
tar -xzf hipmmcode-<platform>.tar.gz
# 保留 default-skills/ 与二进制同级(v0.14.1+)—— 不要只安装可执行文件
mv hipmmcode ~/.local/bin/

发布包布局(v0.14.1+):

text
hipmmcode              # 可执行文件
default-skills/        # L1 包(docx、pptx、设计类技能等)
LICENSE.txt

任意安装渠道之后都可强制同步技能:

bash
hipmmcode skill install-defaults

验证

bash
hipmmcode --version    # 例如 hipmmcode 0.18.0
hipmmcode doctor       # 环境诊断:密钥、配置路径、MCP/技能计数
hipmmcode skills       # 列出技能(L0 + 用户目录 L1 + 项目)

首次启动若没有 ~/.hipmmcode/settings.json,会 seed permissions.defaultMode: "auto"(见 权限)。

升级

bash
hipmmcode update           # 自更新到最新版(校验后原子替换)
hipmmcode update --check   # 只查是否有新版

brew upgrade hipmmcode 或重跑 curl 安装命令同样有效。

升级保留用户配置(config.jsonsettings.json、会话)。新默认(Auto seed、默认技能同步)不会清空密钥,也不会从安装包再注入历史一次性 allow 列表。

卸载

bash
rm ~/.local/bin/hipmmcode                    # curl / 手动安装
brew uninstall hipmmcode                     # Homebrew
npm uninstall -g @hipmmai/hipmmcode      # npm
rm -rf ~/.hipmmcode                          # 可选:清除全部用户数据(配置、会话、记忆)