👉 [[https://github.com/sponsors/xenodium][通过 GitHub Sponsors 支持本项目]]

[[https://stable.melpa.org/#/chatgpt-shell][file:https://stable.melpa.org/packages/chatgpt-shell-badge.svg]] [[https://melpa.org/#/chatgpt-shell][file:https://melpa.org/packages/chatgpt-shell-badge.svg]]

• chatgpt-shell

一个支持多大模型的 Emacs [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Shell-Prompts.html][comint]] shell，由 [[https://lmno.lol/alvaro][我]] 开发。

• 相关包

• [[https://github.com/xenodium/ob-chatgpt-shell][ob-chatgpt-shell]]：将 chatgpt-shell 块作为 Emacs org babel 块执行。
• [[https://github.com/xenodium/ob-dall-e-shell][ob-dall-e-shell]]：将 DALL-E shell 块作为 Emacs org babel 块执行。
• [[https://github.com/xenodium/dall-e-shell][dall-e-shell]]：一个用于 OpenAI 的 DALL-E 的 Emacs shell。
• [[https://github.com/xenodium/shell-maker][shell-maker]]：创建由本地或云端服务支持的 Emacs shell。

• 新闻

chatgpt-shell 支持多模型 🎉

请赞助该项目，以确保开发与支持的可持续性。

| 提供商 | 模型 | 支持 | 设置 | |------------+---------------+-----------+----------------------------------| | Anthropic | Claude | 是 | 设置 =chatgpt-shell-anthropic-key= | | Deepseek | Chat/Reasoner | 是 | 设置 =chatgpt-shell-deepseek-key= | | Google | Gemini | 是 | 设置 =chatgpt-shell-google-key= | | Kagi | Summarizer | 是 | 设置 =chatgpt-shell-kagi-key= | | Ollama | Llama | 是 | 安装 [[https://ollama.com/][Ollama]] | | OpenAI | ChatGPT | 是 | 设置 =chatgpt-shell-openai-key= | | OpenRouter | Various | 是 | 设置 =chatgpt-shell-openrouter-key= | | Perplexity | Llama Sonar | 是 | 设置 =chatgpt-shell-perplexity-key= |

注意：除 [[https://ollama.com/][Ollama]] 外，通常需要为云服务的 API 访问付费。请务必向各 LLM 服务提供商确认。

我最喜欢的模型没有被支持。

| [[https://github.com/xenodium/chatgpt-shell/issues][提交功能请求]] | [[https://github.com/sponsors/xenodium][赞助本项目]] |

** 熟悉的 shell

chatgpt-shell 是一个 [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Shell-Prompts.html][comint]] shell。您可以沿用自己熟悉的 Emacs shell 工作流。

#+HTML:

** 切换模型

一个 shell 查询所有模型。只需通过 =M-x chatgpt-shell-swap-model= 切换 LLM 提供商，即可继续使用您熟悉的流程。

#+HTML:

** 混合型 shell

=chatgpt-shell= 包含一个 compose 缓冲区体验。这是我最喜欢且最常使用的与 LLM 交互的方式。

例如，选择一段文本并调用 =M-x chatgpt-shell-prompt-compose=（=C-c C-e= 是我偏好的快捷键），编辑缓冲区会自动复制选中的文本，并允许您构建更完整的查询。准备好后，使用熟悉的 =C-c C-c= 提交。缓冲区会自动变为只读，并启用单字符绑定。

#+HTML:

*** 导航：n/p（或 TAB/shift-TAB）

在源代码块之间导航（包括历史记录中的先前提交）。源代码块会自动被选中。

*** 回复：r

使用 =r= 绑定对之前的请求进行回复。

*** 再给我一些：m

想再要一些相同的数据吗？按下 =m= 即可请求更多内容。这对于跟进任何类型的列表（建议、候选、结果等）都非常方便。

*** 快速处理：q

我非常喜欢用 =q= 绑定快速关闭 Emacs 缓冲区。chatgpt-shell 的 compose 缓冲区也不例外。

*** 请求完整片段：e

LLM 返回了部分代码吗？按下 =e= 可以请求完整的代码片段。

*** 使用瞬态菜单快速操作

为了快速访问常用操作，=chatgpt-shell= 提供了一个瞬态菜单，基于优秀的 [[https://github.com/magit/transient][transient]] 包实现。可以把它想象成一个临时的键位映射叠加层，它会弹出显示可用命令及其快捷键，并在您选择一个命令后自动消失。

在 =chatgpt-shell= 缓冲区中，使用 =C-c C-t= 来调用该菜单。

菜单按逻辑分组排列，便于导航：

#+BEGIN_SRC text :exports code ┌──────────────────────────────────────────────────────────────────────────────┐ │ 外壳 通过组合生成提示 内联编辑 │ │ b: 切换到外壳缓冲区 e: 专用缓冲区 q: 快速 │ │ N: 创建新外壳 p: 小缓冲区 插入/ │ │ P: 小缓冲区（包含上次 编辑 │ │ 杀掉的内容） r: 发送 │ │ 区域 │ │ R: 发送 & │ │ 审核 │ │ 区域 │ │ │ │ 会话 历史记录 导航 │ │ m: 切换模型 h: 搜索 n: 下一项 │ │ L: 重新加载模型 p: 上一项 │ │ y: 切换系统提示 项 │ │ TAB: 下一个 │ │ 源 │ │ 块 │ │ : │ │ 上一个 │ │ 源 │ │ 块 │ │ │ │ 源代码块 记录 代码操作 │ │ C-c C-c: 执行 S: 保存 d: 描述 │ │ E: 编辑 O: 恢复 代码 │ │ V: 查看 f: 重构 │ │ 代码 │ │ g: 写 Git │ │ 提交 │ │ t: 生成 │ │ 单元测试 │ │ w: 校对 │ │ │ │ 其他 │ │ C: 清空缓冲区 │ │ I: 中断 │ │ v: 显示版本 │ └──────────────────────────────────────────────────────────────────────────────┘ #+END_SRC

（注：显示的具体命令取决于上下文，例如是否激活了区域，或者你是否位于 =chatgpt-shell= 缓冲区中。）

如果你更喜欢全局快捷键（在 Emacs 的任何地方都可用），可以在你的个人 Emacs 配置中添加如下内容：

#+begin_src emacs-lisp :lexical no ;; 在你的 init.el 或等效文件中 (global-set-key (kbd "C-c C-g") 'chatgpt-shell-transient) #+end_src

此菜单有助于发现可用的命令并快速执行，而无需记住每一个快捷键或 =M-x= 命令名称。

** 确认内联修改（通过差异）

请求内联修改，并在接受之前明确确认。

#+HTML:

** 执行代码片段（类似于 [[https://orgmode.org/worg/org-contrib/babel/intro.html][org babel]]）

外壳和组合缓冲区都允许用户通过 =C-c C-c= 执行源代码块，利用 [[https://orgmode.org/worg/org-contrib/babel/intro.html][org babel]] 的功能。

#+HTML:

** 视觉实验

我一直在尝试使用图像查询（目前仅支持 ChatGPT，请 [[https://github.com/sponsors/xenodium][赞助]] 以帮助增加对其他模型的支持）。

以下是一个方便的集成，用于提取日语词汇。此外，还有一个通用的图像描述工具，可通过 =M-x chatgpt-shell-describe-image= 调用，适用于任何 Emacs 图像（通过 dired、图像缓冲区、光标指向图像，或选择桌面区域）。

#+HTML:

• 支持这项工作

如果你觉得 =chatgpt-shell= 很有用，请帮助使该项目可持续发展，并考虑 ✨[[https://github.com/sponsors/xenodium][赞助]]✨。

=chatgpt-shell= 仍在开发中。请报告问题或提交 [[https://github.com/xenodium/chatgpt-shell/pulls][拉取请求]] 以改进它。

• 喜欢这个包吗？告诉我吧 💙

觉得它有用吗？喜欢这个包吗？我很想听听你的意见。请与我联系（[[https://indieweb.social/@xenodium][Mastodon]] / [[https://twitter.com/xenodium][Twitter]] / [[https://bsky.app/profile/xenodium.bsky.social][Bluesky]] / [[https://www.reddit.com/user/xenodium][Reddit]] / [[mailto:me__AT__xenodium.com][电子邮件]])。

• 安装

** MELPA

通过 [[https://github.com/jwiegley/use-package][use-package]]，你可以使用 =:ensure t= 进行安装。

#+begin_src emacs-lisp :lexical no (use-package chatgpt-shell :ensure t :custom ((chatgpt-shell-openai-key (lambda () (auth-source-pass-get 'secret "openai-key"))))) #+end_src

** Straight

#+begin_src emacs-lisp :lexical no (use-package shell-maker :straight (:type git :host github :repo "xenodium/shell-maker"))

(use-package chatgpt-shell :straight (:type git :host github :repo "xenodium/chatgpt-shell" :files ("chatgpt-shell*.el")) :custom ((chatgpt-shell-openai-key (lambda () (auth-source-pass-get 'secret "openai-key"))))) #+end_src

• 切换模型 ** M-x chatgpt-shell-swap-model

#+HTML:

• 设置默认模型

#+begin_src emacs-lisp :lexical no (setq chatgpt-shell-model-version "llama3.2") #+end_src

• 设置 API 密钥

首先，你需要为每个想要交互的公共大语言模型 API 获取一个 API 密钥。

服务	模型	链接：获取 API 密钥
OpenAI	ChatGPT	[[https://platform.openai.com/account/api-keys][获取 API 密钥]]
Anthropic	Claude	[[https://console.anthropic.com/dashboard][访问控制台]]
Deepseek	Chat/Reasoner	[[https://platform.deepseek.com/api_keys][获取 API 密钥]]
Google	Gemini	[[https://aistudio.google.com/app/apikey][获取 API 密钥]]
Kagi	Summarizer	[[https://kagi.com/settings?p=api][获取 API 密钥]]
OpenRouter	多种	[[https://openrouter.ai/settings/keys][管理您的 API 密钥]]
Perplexity	Llama Sonar	[[https://docs.perplexity.ai/guides/getting-started#generate-an-api-key][获取 API 密钥]]

** 通过函数将 API 密钥提供给 ChatGPT

您可以定义一个 chatgpt-shell 调用的函数来获取 API 密钥。以下示例适用于 OpenAI；对于其他服务，请采用类似的方法。

#+begin_src emacs-lisp ;; 如果您使用的是 "pass" 密码管理器 (setq chatgpt-shell-openai-key (lambda () ;; (auth-source-pass-get 'secret "openai-key") ; 使用 auth-sources 的 pass 支持作为替代 (nth 0 (process-lines "pass" "show" "openai-key"))))

;; 或者如果您使用 auth-sources，例如 ~/.authinfo 文件中包含以下行： ;; machine api.openai.com password OPENAI_KEY (setq chatgpt-shell-openai-key (auth-source-pick-first-password :host "api.openai.com"))

;; 或者与上一条相同，但采用惰性加载（避免意外弹出密码提示） (setq chatgpt-shell-openai-key (lambda () (auth-source-pick-first-password :host "api.openai.com"))) #+end_src

** 手动/交互式设置相应变量

=M-x set-variable chatgpt-shell-anthropic-key=

=M-x set-variable chatgpt-shell-deepseek-key=

=M-x set-variable chatgpt-shell-google-key=

...

** 在您的 Emacs 初始化文件中以编程方式设置相应变量 #+begin_src emacs-lisp ;; 从字符串设置 Anthropic 密钥 (setq chatgpt-shell-anthropic-key "my anthropic key") ;; 从环境变量设置 OpenAI 密钥 (setq chatgpt-shell-openai-key (getenv "OPENAI_API_KEY"))

#+end_src

• 通过代理服务使用 ChatGPT

如果您通过代理服务 "https://api.chatgpt.domain.com" 使用 ChatGPT，请设置如下选项：

#+begin_src emacs-lisp :lexical no (use-package chatgpt-shell :ensure t :custom ((chatgpt-shell-api-url-base "https://api.chatgpt.domain.com") (chatgpt-shell-openai-key (lambda () ;; 此处的 openai-key 应该是代理服务的密钥。 (auth-source-pass-get 'secret "openai-key"))))) #+end_src

如果您的代理服务 API 路径不是 OpenAI ChatGPT 的默认路径 "/v1/chat/completions="，则可以自定义选项 chatgpt-shell-api-url-path。

• 通过 HTTP(S) 代理使用 ChatGPT

在后台，chatgpt-shell 使用 =curl= 向 OpenAI 服务器发送请求。如果您通过 HTTP 代理使用 ChatGPT（例如您处于企业网络中，HTTP 代理将企业网络与互联网隔开），则需要通过 curl 选项 =-x http://your_proxy= 告诉 =curl= 使用该代理。为此，请使用 =chatgpt-shell-proxy=。

例如，如果您希望 curl 使用 =-x=http://your_proxy=，请将 =chatgpt-shell-proxy= 设置为 "=http://your_proxy="。

• 启动

通过 =M-x chatgpt-shell= 启动。

注意：=M-x chatgpt-shell= 会保持单个 shell 运行，必要时会重新聚焦。要启动多个 shell，请使用 =C-u M-x chatgpt-shell=。

• 清空缓冲区

在提示符下输入 =clear=。

#+begin_src sh ChatGPT> clear #+end_src

或者，您也可以使用 =M-x chatgpt-shell-clear-buffer= 或 =M-x comint-clear-buffer=。

• 保存和恢复

使用 =M-x chatgpt-shell-save-session-transcript= 保存会话记录，并使用 =M-x chatgpt-shell-restore-session-from-transcript= 恢复会话。

一些相关值存储在 =shell-maker= 中，例如 =shell-maker-transcript-default-path= 和 =shell-maker-forget-file-after-clear=。

• 流式传输

=chatgpt-shell= 可以选择等待整个响应接收完毕后再显示，也可以在数据块到达时逐步显示（流式传输）。

流式传输默认启用。若要禁用，请执行 =(setq chatgpt-shell-streaming nil)=。

• chatgpt-shell 自定义设置

#+BEGIN_SRC emacs-lisp :results table :colnames '("自定义变量" "描述") :exports results (let ((rows)) (mapatoms (lambda (symbol) (when (and (string-match "^chatgpt-shell" (symbol-name symbol)) (custom-variable-p symbol)) (push `(,symbol ,(car (split-string (or (documentation-property symbol 'variable-documentation) (get (indirect-variable symbol) 'variable-documentation) (get symbol 'variable-documentation) "") "\n"))) rows)))) rows) #+END_SRC

#+RESULTS: | 自定义变量 | 描述 | |------------------------------------------------------------------+------------------------------------------------------------------------------| | chatgpt-shell-google-api-url-base | Google API 的基础 URL。 | | chatgpt-shell-deepseek-api-url-base | DeepSeek API 的基础 URL。 | | chatgpt-shell-perplexity-key | Perplexity API 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-anthropic-thinking | 当非 nil 时，启用模型思考功能（如果可用）。 | | chatgpt-shell-deepseek-key | DeepSeek 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-prompt-header-write-git-commit | ‘git-commit’ 提示语的头部。 | | chatgpt-shell-highlight-blocks | 是否高亮显示源代码块。 | | chatgpt-shell-prompt-compose-display-action | 选择如何显示撰写缓冲区。 | | chatgpt-shell-display-function | 用于显示 shell 的函数。可设置为 ‘display-buffer’ 或自定义函数。 | | chatgpt-shell-prompt-header-generate-unit-test | ‘generate-unit-test’ 提示语的头部。 | | chatgpt-shell-prompt-header-refactor-code | ‘refactor-code’ 提示语的头部。 | | chatgpt-shell-prompt-header-proofread-region | 由 ‘chatgpt-shell-proofread-region’ 使用的提示语头部。 | | chatgpt-shell-openai-reasoning-effort | 用于 OpenAI 推理模型的推理力度。 | | chatgpt-shell-welcome-function | 返回欢迎消息的函数，或返回 nil 表示不显示消息。 | | chatgpt-shell-perplexity-api-url-base | Perplexity API 的基础 URL。 | | chatgpt-shell-prompt-query-response-style | 决定从其他缓冲区调用时的提示语风格。 | | chatgpt-shell-model-version | 活跃模型版本，可以是字符串。 | | chatgpt-shell-kagi-key | Kagi API 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-logging | 默认禁用日志记录（会降低速度）。 | | chatgpt-shell-render-latex | 是否渲染 LaTeX 块（实验性功能）。 | | chatgpt-shell-swap-model-selector | 在切换模型时使用的自定义函数。 | | chatgpt-shell-api-url-base | OpenAI API 的基础 URL。 | | chatgpt-shell-google-key | Google API 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-ollama-api-url-base | Ollama API 的基础 URL。 | | chatgpt-shell-openrouter-key | OpenRouter 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-babel-headers | 使 Babel 块正常工作的附加头信息。 | | chatgpt-shell--pretty-smerge-mode-hook | 进入或离开 ‘chatgpt-shell--pretty-smerge-mode’ 后执行的钩子。 | | chatgpt-shell-include-local-file-link-content | 非 nil 时，将在请求中包含链接文件的内容。 | | chatgpt-shell-compose-auto-transient | 当非 nil 时，撰写提交后自动显示临时菜单。 | | chatgpt-shell-source-block-actions | 已知语言的代码块操作。 | | chatgpt-shell-default-prompts | 可供选择的默认提示语列表。 | | chatgpt-shell-anthropic-key | Anthropic API 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-always-create-new | 非 nil 时，每次调用 ‘chatgpt-shell’ 都会创建一个新的 shell 缓冲区。 | | chatgpt-shell-screenshot-command | 用于截屏的程序。 | | chatgpt-shell-prompt-header-eshell-summarize-last-command-output | ‘eshell-summarize-last-command-output’ 提示语的头部。 | | chatgpt-shell-system-prompt | ‘chatgpt-shell-system-prompts’ 系统提示语索引。 | | chatgpt-shell-transmitted-context-length | 控制提供给 ChatGPT 的上下文长度。 | | chatgpt-shell-root-path | 存储内部 shell 文件的根路径位置。 | | chatgpt-shell-prompt-header-whats-wrong-with-last-command | ‘whats-wrong-with-last-command’ 提示语的头部。 | | chatgpt-shell-read-string-function | 从用户读取字符串的函数。 | | chatgpt-shell-swap-model-filter | 使用此函数作为过滤器来筛选可切换的模型。 | | chatgpt-shell-after-command-functions | 每次命令执行后调用的异常钩子（即带有参数的钩子）。 | | chatgpt-shell-system-prompts | 可供选择的系统提示语列表。 | | chatgpt-shell-openai-key | OpenAI 密钥，可以是字符串，也可以是加载并返回该密钥的函数。 | | chatgpt-shell-proxy | 当非 nil 时，用作代理（例如 http 或 socks5）。 | | chatgpt-shell-prompt-header-describe-code | ‘describe-code’ 提示语的头部。 | | chatgpt-shell-insert-dividers | 是否在请求和响应之间显示分隔线。 | | chatgpt-shell-models | 可供切换的支持模型列表。 | | chatgpt-shell-openrouter-api-url-base | OpenRouter API 的基础 URL。 | | chatgpt-shell-language-mapping | 将外部语言名称映射到 Emacs 中的语言名称。 | | chatgpt-shell-prompt-compose-view-mode-hook | 进入或离开 ‘chatgpt-shell-prompt-compose-view-mode’ 后执行的钩子。 | | chatgpt-shell-streaming | 是否流式传输 ChatGPT 的响应（随到随显 chunks）。 | | chatgpt-shell-anthropic-api-url-base | Anthropic API 的基础 URL。 | | chatgpt-shell-model-temperature | 采样温度，范围在 0 到 2 之间，或返回 nil。 | | chatgpt-shell-anthropic-thinking-budget-tokens | 分配给 Anthropic 模型思考的 token 预算。 | | chatgpt-shell-request-timeout | 请求超时等待时间，单位为秒。 | | chatgpt-shell-kagi-api-url-base | Kagi API 的基础 URL。 |

还有更多。可通过 =M-x set-variable= 浏览。

** =chatgpt-shell-display-function=（使用自定义函数）

如果你更倾向于使用自己的自定义显示函数，

#+begin_src emacs-lisp :lexical no (setq chatgpt-shell-display-function #'my/chatgpt-shell-frame)

(defun my/chatgpt-shell-frame (bname) (let ((cur-f (selected-frame)) (f (my/find-or-make-frame "chatgpt"))) (select-frame-by-name "chatgpt") (pop-to-buffer-same-window bname) (set-frame-position f (/ (display-pixel-width) 2) 0) (set-frame-height f (frame-height cur-f)) (set-frame-width f (frame-width cur-f) 1)))

(defun my/find-or-make-frame (fname) (condition-case nil (select-frame-by-name fname) (error (make-frame `((name . ,fname)))))) #+end_src

感谢 [[https://github.com/tuhdo][tuhdo]] 提供的自定义显示函数。

• chatgpt-shell 命令

#+BEGIN_SRC emacs-lisp :results table :colnames '("绑定" "命令" "描述") :exports results (let ((rows)) (mapatoms (lambda (symbol) (when (and (string-match "^chatgpt-shell" (symbol-name symbol)) (commandp symbol)) (push `(,(string-join (seq-filter (lambda (symbol) (not (string-match "menu" symbol))) (mapcar (lambda (keys) (key-description keys)) (or (where-is-internal (symbol-function symbol) comint-mode-map nil nil (command-remapping 'comint-next-input)) (where-is-internal symbol chatgpt-shell-mode-map nil nil (command-remapping symbol)) (where-is-internal (symbol-function symbol) chatgpt-shell-mode-map nil nil (command-remapping symbol))))) " 或 ") ,(symbol-name symbol) ,(car (split-string (or (documentation symbol t) "") "\n"))) rows)))) rows) #+END_SRC

#+RESULTS: | 绑定 | 命令 | 描述 | |----------------------+----------------------------------------------------------+---------------------------------------------------------------------------------| | | chatgpt-shell-japanese-lookup | 查找日语术语。 | | | chatgpt-shell-next-source-block | 将光标移动到下一个源代码块的主体。 | | | chatgpt-shell-prompt-compose-request-entire-snippet | 如果响应代码不完整，请求整个代码片段。 | | | chatgpt-shell-prompt-compose-request-more | 请求更多数据。这在您已经请求过示例时很有用。 | | | chatgpt-shell-google-toggle-grounding-with-google-search | 切换当前所选模型的 :grounding-search' 布尔值。 | | | chatgpt-shell-execute-babel-block-action-at-point | 以 Org Babel 格式执行代码块。 | | C-c C-s | chatgpt-shell-swap-system-prompt | 从 chatgpt-shell-system-prompts' 中切换系统提示词。 | | | chatgpt-shell-system-prompts-menu | ChatGPT | | | chatgpt-shell-prompt-compose-swap-model-version | 切换撰写缓冲区的模型版本。 | | | chatgpt-shell-describe-code | 使用 ChatGPT 描述区域内的代码。 | | C- 或 M-p | chatgpt-shell-previous-input | 循环浏览输入历史，并保存输入。 | | | chatgpt-shell-previous-link | 将光标移动到上一个链接。 | | | chatgpt-shell-copy-block-at-point | 将光标处的代码块复制到剪贴板。 | | | chatgpt-shell-prompt-compose-next-item | 跳转并选择下一个项目（请求、响应、代码块、链接、交互）。 | | C-c C-v | chatgpt-shell-swap-model | 从 chatgpt-shell-models' 中切换模型版本。 | | C-x C-s | chatgpt-shell-save-session-transcript | 将会话记录保存到文件中。 | | | chatgpt-shell-proofread-region | 使用 ChatGPT 校对区域或当前段落中的文本。 | | | chatgpt-shell-prompt-compose-quit-and-close-frame | 如果是最后一个窗口，则退出撰写并关闭框架。 | | | chatgpt-shell-prompt-compose-other-buffer | 跳转到 Shell 缓冲区（撰写缓冲区的另一个缓冲区）。 | | | chatgpt-shell | 启动 ChatGPT Shell 交互式命令。 | | RET | chatgpt-shell-submit | 提交当前输入。 | | | chatgpt-shell-prompt-compose-swap-system-prompt | 切换撰写缓冲区的系统提示词。 | | | chatgpt-shell-describe-image | 请求 OpenAI 描述图像。 | | | chatgpt-shell-prompt-compose-search-history | 搜索提示词历史，选择并插入到当前撰写缓冲区。 | | | chatgpt-shell-prompt-compose-previous-history | 将历史中的上一条提示词插入到撰写缓冲区。 | | | chatgpt-shell-delete-interaction-at-point | 删除光标处的交互（请求和响应）。 | | | chatgpt-shell-anthropic-toggle-thinking | 切换 Anthropic 模型，根据 chatgpt-shell-anthropic-thinking' 进行操作。 | | | chatgpt-shell-refresh-rendering | 通过重新应用到整个缓冲区来刷新 Markdown 渲染。 | | | chatgpt-shell-prompt-compose-insert-block-at-point | 在已知位置将代码块插入到光标处。 | | | chatgpt-shell-explain-code | 使用 ChatGPT 描述区域内的代码。 | | | chatgpt-shell-execute-block-action-at-point | 在光标处执行代码块。 | | | chatgpt-shell-load-awesome-prompts | 从 awesome-chatgpt-prompts 加载 chatgpt-shell-system-prompts'。 | | | chatgpt-shell-write-git-commit | 使用 ChatGPT 从区域编写提交信息。 | | | chatgpt-shell-restore-session-from-transcript | 从文件会话记录（或 HISTORY）中恢复会话。 | | | chatgpt-shell-prompt-compose-next-interaction | 显示下一次交互（请求/响应）。 | | <backtab> 或 C-c C-p | chatgpt-shell-previous-item | 跳转到上一个项目。 | | | chatgpt-shell-fix-error-at-point | 修复光标处的 flymake 错误。 | | | chatgpt-shell-next-link | 将光标移动到下一个链接。 | | | chatgpt-shell-prompt-compose-transient | ChatGPT Shell Compose 临时模式。 | | | chatgpt-shell-prompt-compose-clear-history | 清除撰写及关联的 Shell 历史记录。 | | | chatgpt-shell-prompt-appending-kill-ring | 从 minibuffer 发起 ChatGPT 请求，并将其添加到剪贴板。 | | | chatgpt-shell-ollama-load-models | 查询 Ollama 获取本地安装的模型，并将其添加到 | | C-<down> 或 M-n | chatgpt-shell-next-input | 循环浏览输入历史。 | | | chatgpt-shell-prompt-compose-view-mode | 类似于 view-mode，但专为 ChatGPT Compose 扩展。 | | | chatgpt-shell-clear-buffer | 清空当前 Shell 缓冲区。 | | | chatgpt-shell-insert-local-file-link | 选择并插入指向本地文件的链接。 | | | chatgpt-shell-edit-block-at-point | 在光标处执行代码块。 | | <tab> 或 C-c C-n | chatgpt-shell-next-item | 跳转到下一个项目。 | | | chatgpt-shell-prompt-compose-send-buffer | 将撰写缓冲区内容发送到 Shell 进行处理。 | | C-c C-e | chatgpt-shell-prompt-compose | 从专用缓冲区撰写并发送提示词。 | | | chatgpt-shell-rename-buffer | 重命名当前 Shell 缓冲区。 | | | chatgpt-shell-remove-block-overlays | 移除代码块覆盖层。对于重命名代码块非常有用。 | | | chatgpt-shell-send-region | 将区域发送到 ChatGPT。 | | | chatgpt-shell-send-and-review-region | 将区域发送到 ChatGPT，在提交前进行审查。 | | C-M-h | chatgpt-shell-mark-at-point-dwim | 如果光标在源代码块上，则标记该块；否则标记所有输出。 | | | chatgpt-shell-insert-buffer-file-link | 选择并插入指向缓冲区本地文件的链接。 | | | chatgpt-shell--pretty-smerge-mode | 用于显示冲突标记覆盖的小模式。 | | | chatgpt-shell-mark-block | 在撰写缓冲区中标记当前代码块。 | | | chatgpt-shell-prompt-compose-reply | 作为后续回复并撰写另一条查询。 | | | chatgpt-shell-prompt-compose-refresh | 使用 Shell 中的当前内容刷新撰写缓冲区。 | | | chatgpt-shell-set-as-primary-shell | 当有多个会话时，将其设置为主 Shell。 | | | chatgpt-shell-google-load-models | 查询 Google 获取可用的 Gemini LLM 模型列表。 | | | chatgpt-shell-rename-block-at-point | 重命名光标处的代码块（可能使用不同语言）。 | | | chatgpt-shell-quick-insert | 从 minibuffer 发起请求，并将响应插入到当前缓冲区。 | | | chatgpt-shell-reload-default-models | 重新加载所有可用模型。 | | S-<return> | chatgpt-shell-newline | 插入一个新行，并将光标移动到新行的左边界。 | | | chatgpt-shell-generate-unit-test | 使用 ChatGPT 为区域内的代码生成单元测试。 | | | chatgpt-shell-prompt-compose-view-last | 显示最后的请求/响应交互。 | | | chatgpt-shell-prompt-compose-previous-item | 跳转并选择上一个项目（请求、响应、代码块、链接、交互）。 | | | chatgpt-shell-prompt-compose-next-history | 将历史中的下一条提示词插入到撰写缓冲区。 | | C-c C-c | chatgpt-shell-ctrl-c-ctrl-c | 如果光标在源代码块内，则执行该块；否则中断。 | | | chatgpt-shell-eshell-summarize-last-command-output | 请求 ChatGPT 总结上次命令的输出。 | | M-r | chatgpt-shell-search-history | 搜索之前的输入历史。 | | | chatgpt-shell-mode | ChatGPT Shell 的主模式。 | | | chatgpt-shell-prompt-compose-mode | 从专用缓冲区撰写 ChatGPT 提示词的主模式。 | | | chatgpt-shell-previous-source-block | 将光标移动到上一个源代码块的主体。 | | | chatgpt-shell-prompt | 从 minibuffer 发起 ChatGPT 请求。 | | | chatgpt-shell-japanese-ocr-lookup | 选择屏幕上的一个区域进行 OCR，并用日语查找。 | | | chatgpt-shell-refactor-code | 使用 ChatGPT 重构区域内的代码。 | | | chatgpt-shell-proofread-paragraph-or-region | 使用 ChatGPT 校对区域或当前段落中的文本。 | | | chatgpt-shell-view-block-at-point | 在单独的缓冲区中查看光标处的代码块（使用相应语言的主模式）。 | | | chatgpt-shell-japanese-audio-lookup | 转录当前文件（缓冲区或 dired'）中的音频，并用日语查找。 | | | chatgpt-shell-eshell-whats-wrong-with-last-command | 询问 ChatGPT 上次 eshell 命令出了什么问题。 | | | chatgpt-shell-prompt-compose-cancel | 取消并关闭撰写缓冲区。 | | | chatgpt-shell-prompt-compose-retry | 重试向 Shell 发送请求。 | | | chatgpt-shell-version | 显示 chatgpt-shell' 模式的版本。 | | | chatgpt-shell-prompt-compose-previous-interaction | 显示上一次交互（请求/响应）。 | | | chatgpt-shell-interrupt | 从任何缓冲区中断 chatgpt-shell'。 | | | chatgpt-shell-view-at-point | 在单独的缓冲区中查看光标处的提示词和输出。 |

通过 =M-x= 浏览所有可用选项。

• 功能请求

• 请先查看此 README，确认所需功能是否已支持。
• 需要自定义行为吗？请查看现有的 [[https://github.com/xenodium/chatgpt-shell/issues?q=is%3Aissue+][问题/功能请求]]。您可能会在讨论中找到解决方案。

• 拉取请求 非常欢迎提交拉取请求。请在开始之前[[https://github.com/xenodium/chatgpt-shell/issues/new][联系一下]]，以确保我们不会重复工作。同时，请[[https://github.com/xenodium/chatgpt-shell/][搜索现有的讨论]]。

• 报告 bug ** 设置不生效？ 请分享您用于设置 =chatgpt-shell= 的完整代码片段（但需遮盖您的密钥）。同时请附上遇到的任何错误信息。继续阅读以了解如何提供更多详细信息。 ** 发现运行时或 Elisp 错误？ 请启用 =M-x toggle-debug-on-error=，重现错误，并分享堆栈跟踪信息。 ** 发现意外行为？ 请启用日志记录 =(setq chatgpt-shell-logging t)=，并在 bug 报告中分享 =chatgpt-log= 缓冲区的内容。 ** Babel 相关问题？ 请一并分享完整的 Org 代码片段。

• 支持我的工作

👉 觉得我的工作有用吗？[[https://github.com/sponsors/xenodium][通过 GitHub Sponsors 支持这项工作]]，或[[https://apps.apple.com/us/developer/xenodium-ltd/id304568690][购买我的 iOS 应用程序]]。

• 我的其他工具、包、应用及写作...

• [[https://xenodium.com/][博客 (xenodium.com)]]
• [[https://lmno.lol/alvaro][博客 (lmno.lol/alvaro)]]
• [[https://plainorg.com][Plain Org]] (iOS)
• [[https://flathabits.com][Flat Habits]] (iOS)
• [[https://apps.apple.com/us/app/scratch/id1671420139][Scratch]] (iOS)
• [[https://github.com/xenodium/macosrec][macosrec]] (macOS)
• [[https://apps.apple.com/us/app/fresh-eyes/id6480411697?mt=12][Fresh Eyes]] (macOS)
• [[https://github.com/xenodium/dwim-shell-command][dwim-shell-command]] (Emacs)
• [[https://github.com/xenodium/company-org-block][company-org-block]] (Emacs)
• [[https://github.com/xenodium/org-block-capf][org-block-capf]] (Emacs)
• [[https://github.com/xenodium/ob-swiftui][ob-swiftui]] (Emacs)
• [[https://github.com/xenodium/chatgpt-shell][chatgpt-shell]] (Emacs)
• [[https://github.com/xenodium/ready-player][ready-player]] (Emacs)
• [[https://github.com/xenodium/sqlite-mode-extras][sqlite-mode-extras]]
• [[https://github.com/xenodium/ob-chatgpt-shell][ob-chatgpt-shell]] (Emacs)
• [[https://github.com/xenodium/dall-e-shell][dall-e-shell]] (Emacs)
• [[https://github.com/xenodium/ob-dall-e-shell][ob-dall-e-shell]] (Emacs)
• [[https://github.com/xenodium/shell-maker][shell-maker]] (Emacs)

• 贡献者

#+HTML: #+HTML: #+HTML:

由 [[https://contrib.rocks][contrib.rocks]] 制作。

chatgpt-shell 快速上手指南

chatgpt-shell 是一个强大的 Emacs 多模型 LLM 交互终端（基于 comint），支持在 Emacs 内直接调用 ChatGPT、Claude、Gemini、Ollama 等多种大语言模型。它提供了类似 Shell 的交互体验，并支持代码块执行、图片识别及组合提示词编辑等功能。

环境准备

• 系统要求: GNU Emacs (建议最新版本)。
• 前置依赖:
  • 需安装 shell-maker 包（通常作为依赖自动安装）。
  • API Key: 根据你想使用的模型服务商（如 OpenAI, Anthropic, Google, DeepSeek 等），需提前注册并获取对应的 API Key。
  • 本地模型 (可选): 若使用 Ollama，需先在本地安装并运行 Ollama。

安装步骤

推荐使用 use-package 进行安装管理。你可以选择从 MELPA 仓库安装，或通过 straight.el 直接从 GitHub 安装。

方式一：通过 MELPA 安装（推荐）

确保你的 Emacs 已配置 MELPA 源，然后在配置文件（init.el 或 .emacs）中添加以下内容：

(use-package chatgpt-shell
  :ensure t
  :custom
  ;; 示例：从密码管理器获取 OpenAI Key，也可直接设置为字符串 "sk-..."
  ((chatgpt-shell-openai-key
    (lambda ()
      (auth-source-pass-get 'secret "openai-key")))))

方式二：通过 Straight.el 安装

如果你偏好直接从源码安装：

(use-package shell-maker
  :straight (:type git :host github :repo "xenodium/shell-maker"))

(use-package chatgpt-shell
  :straight (:type git :host github :repo "xenodium/chatgpt-shell" :files ("chatgpt-shell*.el"))
  :custom
  ((chatgpt-shell-openai-key
    (lambda ()
      (auth-source-pass-get 'secret "openai-key")))))

安装完成后，重启 Emacs 或重新加载配置文件。

基本使用

1. 配置 API Key

在使用前，必须设置对应模型的 API Key。你可以在 init.el 中全局设置，或在运行时通过变量设置。

全局设置示例 (OpenAI):

(setq chatgpt-shell-openai-key "你的-sk-开头的-API-Key")

切换默认模型:

;; 设置默认模型版本，例如 llama3.2
(setq chatgpt-shell-model-version "llama3.2")

注意: 不同厂商的 Key 变量名不同，例如 chatgpt-shell-anthropic-key, chatgpt-shell-google-key, chatgpt-shell-deepseek-key 等。

2. 启动会话

在 Emacs 中执行以下命令启动一个新的 Shell 会话：

M-x chatgpt-shell

这将打开一个类似于普通终端的缓冲区，你可以直接输入自然语言与 AI 对话。

3. 切换模型

chatgpt-shell 支持在一个会话中随时切换后端模型。执行以下命令并在提示中选择提供商和模型：

M-x chatgpt-shell-swap-model

4. 高级交互：组合提示词 (Compose Prompt)

这是最高效的使用方式。选中一段文本（或光标位于某处），然后调用组合模式来构建更复杂的请求：

M-x chatgpt-shell-prompt-compose

(建议绑定快捷键，例如 C-c C-e)

在弹出的编辑缓冲区中完善你的提示词，完成后按下 C-c C-c 提交。该模式支持以下快捷操作：

• n / p: 上下切换历史源块。
• r: 基于当前结果进行追问 (Reply)。
• m: 请求更多同类内容 (Give me more)。
• e: 请求完整的代码片段 (Request entire snippets)。
• q: 关闭当前缓冲区。

5. 使用瞬态菜单 (Transient Menu)

为了方便记忆命令，在 chatgpt-shell 缓冲区中按下 C-c C-t 可呼出功能菜单。你可以通过按键快速执行以下操作：

• Shells: 切换/新建 Shell (b, N)
• Session: 切换模型 (m)
• Code Actions: 描述代码 (d)、重构代码 (f)、生成单元测试 (t) 等。
• History: 搜索历史 (h)

6. 执行代码块

如果 AI 返回了代码块，你可以将光标移至代码块内，直接按下 C-c C-c 执行该代码（类似 Org Babel 的行为），结果将直接显示在下方。