安装

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

第一次同时安装终端版和桌面版的用户，请直接阅读对应的图文教程：

• macOS 首次使用教程：模型渠道配置、桌面版 1.2.0 安装、Developer ID 签名核验，以及会话重命名与 @ 跨会话；
• Windows 首次使用教程：PowerShell 安装、PATH 刷新，以及 SmartScreen 的安全放行步骤。

curl(macOS / Linux,推荐)

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)

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

npm

npm install -g @hipmmai/hipmmcode@latest

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

Windows(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，让本会话立即读取系统与用户的最新配置：

$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.gz	macOS —— Apple Silicon 与 Intel 通用
hipmmcode-darwin-arm64.tar.gz	仅 macOS Apple Silicon
hipmmcode-darwin-x64.tar.gz	仅 macOS Intel
hipmmcode-linux-x64.tar.gz	Linux x86-64(musl 静态链接,无 libc 依赖)
hipmmcode-linux-arm64.tar.gz	Linux arm64(musl 静态)
hipmmcode-windows-x64.tar.gz	Windows x64

shasum -a 256 -c SHA256SUMS      # 校验
tar -xzf hipmmcode-<platform>.tar.gz
# 保留 default-skills/ 与二进制同级(v0.14.1+)—— 不要只安装可执行文件
mv hipmmcode ~/.local/bin/

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

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

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

hipmmcode skill install-defaults

验证

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

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

桌面版 1.2.0

桌面版和命令行各自编号。当前桌面版是 1.2.0，发布标签 desktop-v1.2.0，内置命令行 v1.2.0。从 下载中心 获取，安装前核对随包的 SHA256SUMS。hipmmcode update 只替换命令行，不替换桌面应用。命令行的 GitHub Latest 也是 v1.2.0。这一版没有 Windows 安装包。

系统	安装包	签名
macOS Apple Silicon	aarch64-apple-darwin-HiPMMCode_1.2.0_aarch64.dmg	Developer ID 签名，未公证。安装前核验 SHA-256。首次打开时 Gatekeeper 可能要求确认
macOS Intel	x86_64-apple-darwin-HiPMMCode_1.2.0_x64.dmg	Developer ID 签名，未公证。安装前核验 SHA-256。首次打开时 Gatekeeper 可能要求确认
Linux x64	x86_64-unknown-linux-gnu-HiPMMCode_1.2.0_amd64.AppImage 与同名 .deb	未签名

手机经桌面端要文件时：

• 只对上一个文件，立刻发送。
• 对上两个或更多时先不发。点一个文件名，或回完整文件名，就发那一个。
• 说「所有」「都发」，或写全几个文件名，就发那一批。
• 「其他的也发」「剩下的也发」只发这次还没发出去的。
• 没说清是哪些时先问，确认之前不发。接着说了别的话，就取消这次选择，按普通消息回答。
• 较短的名字包在较长的文件名里面时，只算较长的那个。发送被拒绝时会告诉你。

手机让本机生成的文件，从该智能体的工作目录发回。工具若写到工作目录外面，桌面端先把那个文件拷进工作目录再发送。.ssh、.aws、钥匙串这类敏感路径不会发送。

安装 LocalScribeBot 之后，会议纪要可以直接用，不必再单独点一次配置。回到启动页时，如果本地运行时已经在跑，就接回那个运行时。

升级

hipmmcode update           # 自更新命令行到 GitHub Latest（当前 v1.3.1）
hipmmcode update --check   # 只查命令行是否有新版

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

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

卸载

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