MackingJAI：用 ChatGPT 桌面端在本地模拟 OpenAI/Ollama API 的实用指南

有没有想过，不用 API Key，就能在本地像和官方接口一样愉快地对话？MackingJAI 就是这样一个小工具——只需配合 ChatGPT Mac 应用和 Apple Shortcuts，轻松把本地 ChatGPT 桌面端伪装成 OpenAI 或 Ollama API。下面，我们一步步来玩转它，无论是调试、测试，还是日常开发，都能瞬间上手。

目录

  1. MackingJAI 是什么？
  2. 为啥要用它？
  3. 它到底怎么跑起来？
  4. 秒装指南：从零到可用

    • 准备工作
    • 安装 DMG
    • 导入 Shortcut
    • 配好本地代理
  5. 常见接入示例

    • Curl 一行命令
    • Python SDK 零改动
    • LangChain 无缝切换
    • Docker & Open-webui
    • Raycast 快捷入口
  6. 参数去哪儿找？深度解读
  7. 妙用小贴士
  8. 遇到问题别慌（FAQ）
  9. 现状&展望
  10. HowTo & FAQ Schema 快速参考

MackingJAI 是什么？

简单来说，MackingJAI 就是一层“魔法”代理，让你在本地调用 ChatGPT 桌面版，就像在调用 OpenAI 或 Ollama 的官方 API。一切请求都拦截到 127.0.0.1:11435，再通过 Apple Shortcuts 转给 ChatGPT 桌面端，最后把结果打包成官方格式返回——完全零门槛。

亮点速览

  • 不用 Key：随便填个 “Bearer No need for API” 就能跑
  • 即装即用：安装 DMG，加个 Shortcut，马上能发请求
  • 多模型支持：桌面端有的模型都能调
  • 接入灵活：Curl、Python、LangChain、Raycast……一通百通

为啥要用它？

  • 零成本测试：不花一分钱就能本地搞起对话接口，真香！
  • 数据不出门：所有交互只在本机环回，不会跑到外网。
  • 立即响应：没网络卡顿、没限流，一键调试就是这么爽。
  • 框架通吃：不管你是用哪种工具，只要支持 OpenAI 接口，都能直接切入。

它到底怎么跑起来？

  1. Shortcut 拦截：先在 Apple Shortcuts 安装好 MackingJAI 的脚本，监听 http://127.0.0.1:11435/* 的请求。
  2. 转给桌面端：Shortcut 拿到请求后，把它连同 headers、body 以 JSON 形式传给 ChatGPT Mac App。
  3. 桌面端回答：ChatGPT 按照 model、messages 等字段生成回复内容。
  4. 返还给客户端：Shortcut 把 ChatGPT 的输出重新装箱，一份标准 OpenAI/Ollama JSON 就这样出来了。
flowchart LR
  Client[你的代码或工具] -->|POST /v1/chat/completions| Proxy[127.0.0.1:11435]
  Proxy --> Shortcut{Apple Shortcut}
  Shortcut --> ChatGPT[ChatGPT Mac App]
  ChatGPT --> Shortcut
  Shortcut --> Client

秒装指南：从零到可用

准备工作

  • 系统：macOS 12 以上
  • ChatGPT 桌面版：下载安装并登录
  • Shortcuts：已启用，允许本地网络访问

安装 DMG

  1. 访问 MackingJAI Releases
  2. 下载最新 .dmg
  3. 双击拖进“应用程序”

导入 Shortcut

  • 打开 MackingJAI，菜单里点 Install Shortcut
  • 或者去 iCloud 链接一键导入

安装时，macOS 可能会弹窗请求“网络访问”“自动化”权限，记得点“允许”。

配好本地代理

在任何兼容 OpenAI 的调用里，把：

  • API Base 改成 http://127.0.0.1:11435/v1/
  • API Key 随意填（比如 No need for API）

Ollama 同理，只要把端口从 11434 换成 11435，路径可以省掉 /v1。

常见接入示例

Curl 一行命令

curl http://127.0.0.1:11435/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer No need for API" \
  -d '{
    "model":"o4-mini-high",
    "messages":[
      {"role":"system","content":"请用是/否回答"},
      {"role":"user","content":"巴黎是法国的首都吗？"}
    ]
  }'

Python SDK 零改动

from openai import OpenAI

client = OpenAI(
    api_key="No need for API",
    base_url="http://127.0.0.1:11435/v1/"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role":"system","content":"你是个助手。"},
        {"role":"user","content":"你好！"}
    ]
)
print(resp.choices[0].message.content)

LangChain 无缝切换

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model_name="gpt-4o",
    openai_api_base="http://127.0.0.1:11435/v1",
    openai_api_key="No key",
)

print(llm.invoke([
    ("system","翻译成法语：The quick brown fox jumps over the lazy dog")
]))

Docker & Open-webui

场景 URL 说明
Docker 内部访问 http://host.docker.internal:11435 直接抛给本地服务
OpenAI 兼容调用 http://host.docker.internal:11435/v1 各种客户端都能照常用
无 Docker 直接把 11434 换成 11435 其他全照旧

Raycast 快捷入口

  1. 打开 Raycast 设置
  2. 在 AI 配置里，把端口填 11435
  3. 保存，马上能本地唤起 ChatGPT

参数去哪儿找？深度解读

参数 功能说明 示例
api_key 虚拟 Key，仅作兼容，不做校验 任意非空字符串
base_url 本地代理地址 http://127.0.0.1:11435/v1
model 要调用的模型名称，映射到桌面端已加载的模型 gpt-4o, o4-mini-high
messages 对话历史或指令，格式和官方 API 一致 同 OpenAI 文档
系统权限 Shortcuts 的网络和自动化权限 在“系统偏好”授予

模型映射贴士

  • 专属快照（如 gpt-4o-2024-05-13）会自动匹配同名桌面模型
  • GPT4.1 系列会优雅回退到 GPT-4/GPT-4o/GPT-4o-mini

妙用小贴士

  • 任务分流：把辅助性任务（标题、标签）丢给轻量模型（如 o3），节省主模型资源。
  • 打开调试：Shortcuts 支持打印请求日志，一键看见到底发了什么。
  • 限速并发：并发多次请求时，加个 100ms 小延迟，不卡就完事。
  • 盯住性能：用活动监视器看看 ChatGPT 桌面占多少 CPU/内存，别一不小心把 Mac 折腾崩。

遇到问题别慌（FAQ）

Q：为什么提示 Connection refused？
A：通常是 Shortcut 没装好或者没给网络权限。打开 Shortcuts，确认脚本正常导入并在“安全性与隐私”里允许网络访问。

Q：哪里看本地有哪些模型？
A：在 ChatGPT 桌面版“设置 → 模型管理”里，一目了然。

Q：请求没响应或超时？
A：确保 ChatGPT 桌面正在运行、已登录，网络无代理干扰，再看 Shortcut 日志。

Q：想切回官方接口怎么办？
A：把 base_url 换成 https://api.openai.com/v1，真 Key 填上，照常上线用就行。

现状 & 展望

  • 目前：依赖桌面订阅，只能用已授权模型；暂不支持图像消息；macOS 专享。
  • 未来：补充高级参数控制（温度、top_p 等）；出 Windows/Linux 版；上线 Homebrew Cask，一键安装升级更顺手。

HowTo & FAQ Schema 快速参考

<script type="application/ld+json">
{
  "@context":"https://schema.org",
  "@type":"HowTo",
  "name":"本地用 MackingJAI 模拟 OpenAI API",
  "step":[
    {"@type":"HowToStep","name":"装 DMG","text":"下载并拖入应用程序文件夹"},
    {"@type":"HowToStep","name":"导 Shortcut","text":"菜单里点 Install Shortcut 或用 iCloud 链接"},
    {"@type":"HowToStep","name":"改 Base","text":"base_url 填 http://127.0.0.1:11435/v1，api_key 填任意"}
  ]
}
</script>

<script type="application/ld+json">
{
  "@context":"https://schema.org",
  "@type":"FAQPage",
  "mainEntity":[
    {"@type":"Question","name":"Connection refused？","acceptedAnswer":{"@type":"Answer","text":"给 Shortcut 授予网络权限，并确认 ChatGPT 桌面已启动。"}},
    {"@type":"Question","name":"怎么看模型？","acceptedAnswer":{"@type":"Answer","text":"桌面版“设置→模型管理”里查看。"}}
  ]
}
</script>

撰稿：一位喜欢把技术讲得轻松易懂的开发者
适合人群：有 Mac、喜欢折腾本地开发的同学们
更新时间：2025-06-15