LocalHelper 是一个面向 Windows 单机使用的终端 AI 智能体工作台。它把模型接入、 本地代码修改、Git 保护、普通交流和联网调研放进一个界面，同时把项目状态、 会话记录与凭据留在本机。
- 在启动页直接选择本机 Git 项目，也可以进入不绑定项目的普通交流。
- 通过一个模型中心管理多个 OpenAI-compatible 中转与模型。
- 为默认、快速和强力任务分别选择模型，并设置跨中转备用链。
- 流式显示模型输出，保留会话、全文搜索、项目记忆与上下文使用情况。
- 在写代码前建立 Git 检查点，支持 diff、撤销、重做、并行 worktree 与合并。
- 支持剪贴板图片、
@文件搜索、外部编辑器和工具调用详情。 - 使用内置 DuckDuckGo，或可选的 Brave、Tavily、本机 Chrome CDP 进行只读联网调研，并保存来源。
LocalHelper 按“本机、单用户”边界设计，不是 Web 服务，也不提供账户系统。 界面与后台进程只通过当前 Windows 用户可访问的命名管道通信，不监听 TCP 端口。
运行发布包需要：
- Windows 10/11 x64
- Windows Terminal
- Git
- 一个提供
/v1/chat/completions的 OpenAI-compatible 接口
下载发布包后，在 Windows Terminal 中运行：
.\helper.exe首次进入后按 Ctrl+M 打开模型中心：
- 选择“添加中转”。
- 依次填写中转名称、Base URL 和 API Key。
- 等待连接测试与模型发现完成。
- 选择默认模型；如有需要，再分别设置快速模型、强力模型和备用模型。
同一个中转可以配置多个模型，不同任务档位也可以使用不同中转。会话中切换 模型不会新建会话，从下一轮开始生效。
源码构建需要 Go 1.26.5。仓库根目录执行：
go test ./...
powershell -NoProfile -File .\scripts\package.ps1 -Force便携包输出到：
dist\helper-windows-amd64
包内包含 helper.exe、构建信息、依赖许可证、SHA-256 校验和与隔离环境
smoke 报告。更完整的构建和恢复说明见
Windows x64 便携构建。
| 操作 | 快捷键 |
|---|---|
| 命令面板 | Ctrl+K |
| 模型中心 | Ctrl+M |
| 项目选择器 | Ctrl+P |
| 会话选择器 | Ctrl+L |
| 显示或隐藏侧栏 | Ctrl+B |
| 查看 Git diff | Ctrl+D |
| 外部编辑器 | Ctrl+E |
| 工具详情 | Ctrl+T |
| 粘贴文本或图片 | Ctrl+V |
| 退出界面、保留后台任务 | Ctrl+Q |
输入框中按 Enter 发送，按 Alt+Enter 换行。输入 @文件名 可以搜索
当前 Git 项目中的文件；更多动作可从 Ctrl+K 命令面板发现。
运行数据默认位于：
%LOCALAPPDATA%\helper
其中包括设置、SQLite 状态、会话、调研资料、检查点、备份和日志。这些内容
不会写到所打开的 Git 项目里，也不与 helper.exe 放在一起。
通过模型中心填写的 API Key 使用 Windows DPAPI 加密，只能由当前 Windows 账户解密；也可以让配置引用环境变量。程序不会把明文 Key 写入日志、会话 JSONL 或 SQLite。日志层还会对授权头、常见密钥字段和已加载凭据进行脱敏。
- 模型协议只实现 OpenAI-compatible Chat Completions，不直接实现 Anthropic、Gemini、Responses API 或本地模型专用协议。
- 联网工具只用于搜索、读取和整理来源，不执行网站登录、下单或内容发布。
- 项目写入默认限制在 Git 根目录。写入项目外路径需要明确授权。
- Git 与本地数据是事实来源；界面退出不会等同于终止正在执行的任务。
面向开发者的设计文档：
当前版本支持 Windows 10/11 x64，仍在持续迭代。使用前建议先运行
helper.exe doctor 检查 Git、数据库、后台进程和本机依赖状态。