Windows 首次使用教程

本教程面向第一次使用 Windows 和 HiPMMCode 的用户。完整流程分为两部分：先安装并验证终端智能体，再安装桌面智能体。

适用范围

• Windows 10 / 11 64 位
• 终端版 v1.3.1
• 桌面版 1.2.0 这一版没有 Windows 安装包。Windows 上先用终端版 v1.3.1。

一、安装终端智能体

打开 HiPMMCode 下载中心，进入终端版区域。选择 Windows 时，页面也会给出对应的 PowerShell 安装方式。

1. 打开 PowerShell

右键单击 Windows 开始按钮，选择 终端、Windows Terminal 或 PowerShell。终端版默认安装到当前用户目录，通常不需要以管理员身份打开。

2. 执行安装命令

复制下面整行命令到 PowerShell，然后按回车：

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

安装脚本会下载 Windows x64 版本、执行校验，并安装到 %USERPROFILE%\.local\bin\hipmmcode.exe。

验证安装：

hipmmcode --version

正常情况下会显示：

hipmmcode 1.3.1

3. 如果提示找不到 hipmmcode

先关闭当前终端并重新打开。如果不想关闭窗口，可在当前 PowerShell 刷新 PATH：

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
hipmmcode --version

公司或学校设备

如果 PowerShell 脚本、GitHub 下载或程序执行被组织策略拦截，请联系管理员。不要为了安装而永久关闭 Defender、SmartScreen 或组织安全策略。

二、配置模型渠道

在 PowerShell 中执行：

hipmmcode model

推荐：DeepSeek（Anthropic）

1. 使用上下方向键选择 DeepSeek (Anthropic) ★ Recommended，按回车；
2. Base URL 已经预填时，直接按回车确认；
3. 粘贴自己的 DeepSeek API Key，按回车保存；
4. 在模型列表选择 deepseek-flash（日常任务，原生识图）或 deepseek-v4-pro。图片走 Files API，由当前选中的 Flash 直接看，不再绕行。

deepseek-anthropic 使用 Anthropic Messages 协议，并支持渠道原生联网搜索。其他渠道也可按照向导依次填写服务地址和 API Key。

保护 API Key

不要把 API Key 发到聊天群、截图、教程或工单中。密钥输入框可能不显示输入内容，这是正常的安全设计。

三、启动并测试终端智能体

执行：

hipmmcode

如果启动时需要选择模型，可选择：

• deepseek-flash：更快，日常任务，原生识图；
• deepseek-v4-pro：适合复杂任务；不接受图片。

输入一句测试消息，例如：

你好，请介绍一下你自己。

智能体正常回复，即代表终端版和模型渠道已经配置成功。建议完成这一步后再安装桌面版。

四、桌面版

回到 下载中心的桌面版区域。

当前桌面版 1.2.0（标签 desktop-v1.2.0）没有 Windows 安装包。Windows 上先继续用上面装好的终端版 v1.3.1。macOS 和 Linux 的桌面包在下载中心。以后如果发布 Windows 安装包，请只从官方下载页获取，并先核对 SHA-256。

五、关于未签名的 Windows 安装包

以后的 Windows 桌面安装包如果仍未使用受信任的代码签名证书，双击时 Microsoft Defender SmartScreen 可能显示“Windows 已保护你的电脑”。

仅对官方可信文件放行

请确认安装包来自 HiPMMAI 官方下载页，文件名和 SHA-256 校验结果正确。不要放行来源不明的 .exe 文件。

1. 打开详细信息

在 SmartScreen 窗口中点击 更多信息（英文系统为 More info）。

2. 再次核对文件

确认显示的应用名称与刚下载的 HiPMMCode 安装包一致。当前未签名版本的发布者可能显示为“未知发布者”，这正是 SmartScreen 提示出现的原因。

3. 仅本次运行

确认来源与哈希无误后，点击 仍要运行（英文系统为 Run anyway）。如果随后出现“用户帐户控制”提示，请确认目标仍是 HiPMMCode 安装程序，再点击“是”。

这只会放行本次安装，不需要关闭整台电脑的 SmartScreen 或 Defender。

看不到“仍要运行”

公司或学校管理的设备可能禁止用户放行未知发布者。此时请停止安装并联系管理员，不要尝试绕过组织策略。

六、完成安装并启动

1. 按安装向导选择安装位置并完成安装；
2. 从“开始”菜单搜索 HiPMMCode；
3. 打开桌面应用；
4. 确认桌面端能够连接并使用前面已经配置好的本地终端智能体。

打开两个会话后，可在侧边栏把会话重命名成可 @ 的别名（字母开头，例如 alpha）。重命名后输入 @ 就会立刻出现这个名字，不必再执行额外命令。@ 列表不会倒出全部历史会话。生成中再发消息会保留已生成内容并优先执行新消息；切换会话也不会丢掉正在生成的回复。添加 MCP 时，HTTP/SSE 可填 Authorization 和自定义头，STDIO 可填命令、参数和环境变量。

七、手机发文件与会议纪要

桌面版 1.2.0 内置命令行 v1.2.0，但这一版没有 Windows 安装包。hipmmcode update 只更新终端里的命令行。

手机要文件时：点名一个就发那一个；说「所有」或「都发」，或写全几个文件名，就发那一批。对上多个又没说清时先问，确认之前不发。「其他的也发」只发这次还没发出去的。接着说别的话，就取消选择。生成的文件从该智能体的工作目录发回；写到目录外面的，先拷进工作目录再发。

安装 LocalScribeBot 之后，会议纪要可以直接用。回到启动页时，已经在跑的本地运行时会被接上。

完成检查

• [ ] hipmmcode --version 显示 1.3.1
• [ ] 模型渠道、Base URL 和 API Key 已配置
• [ ] deepseek-flash 或 deepseek-v4-pro 能正常回复
• [ ] 桌面安装包来自官方下载页，SHA-256 已核对
• [ ] SmartScreen 只对已核验的 HiPMMCode 安装包执行“仍要运行”
• [ ] HiPMMCode 桌面应用可以正常启动
• [ ] 侧边栏重命名后，另一个会话可以用 @名字 点到它

常见问题

PowerShell 提示脚本被禁止怎么办？

先确认正在使用普通 PowerShell，而不是受限制的组织终端。个人设备仍被拦截时，请重新打开 PowerShell 后再试；组织设备请联系管理员，不建议永久修改全局执行策略。

提示 hipmmcode 不是命令怎么办？

关闭终端并重新打开，或按本文的 PATH 刷新命令操作。也可以确认 %USERPROFILE%\.local\bin\hipmmcode.exe 是否存在。

SmartScreen 为什么提示未知发布者？

当前桌面版 1.2.0 没有 Windows 安装包。请不要安装来源不明的 .exe。以后若发布 Windows 包，只从官方下载页获取，并在放行前核对 SHA-256。有 Authenticode 签名后再优先使用签名版。

更新桌面版后还会出现 SmartScreen 吗？

在 Authenticode 签名版发布前，新下载的 Windows 安装包仍可能触发 SmartScreen。每次都应重新确认来源和哈希；不要通过关闭 SmartScreen 来省略检查。