guru

大師

在您的終端中享受 ChatGPT。 中文

 A guru is a teacher or mentor who is highly respected and knowledgeable in
their field. The term is often associated with spiritual or religious
leaders, but can also refer to experts in other areas such as business,
technology, or health.                      -- generated by ChatGPT

特徵

• 在對話或一次性模式下工作，預設為對話模式。使用--oneshot進入一次性模式，該模式會刪除每個請求的上下文訊息。以--last開始guru繼續上次對話。
• 靈活管理上下文訊息。當超過令牌限制時，歷史訊息將自動收縮，並且您可以手動查看、刪除或收縮訊息。
• 使用管道重定向標準輸入/標準輸出。它很容易包含到您的腳本中。
• 指令自動完成、酷炫的動畫和 ChatGPT 回應的 Markdown 渲染。
• 與 Awesome Prompt 儲存庫集成，預設使用 Awesome-chatgpt-prompts 和 Awesome-chatgpt-prompts-zh （首次使用需要同步）。它有兩個內建提示：Committer、Cheatsheet。
• 會話復原、會話建立、會話切換等基本會話管理
• 獨特而強大的會話堆疊，可以推送或彈出子會話。
• 動態檢視或設定內部參數，例如修改API參數。
• 支援執行系統命令，輸出將提交給下一個請求。
• 獨特且強大的Executor，執行ChatGPT的輸出，並可選擇回饋執行結果。

快速入門

安裝

 go install github.com/shafreeck/guru@latest

取得您的 OpenAI API 金鑰

Guru 使用 OpenAI 的開放 API 與 ChatGPT 進行通訊。以開發者身分登入您的帳戶取得對應的API key。

https://platform.openai.com/account/api-keys

配置大師

首次使用時設定 guru，執行guru config並輸入從上述步驟取得的 OpenAI API 金鑰。可以選擇使用socks5 代理程式。您可以繞過此步驟並直接使用命令參數，但建議將您的金鑰儲存到設定檔中。

使用者指南

對話模式

 > guru [text]

直接執行guru進入對話模式。 guru其實是guru chat指令的別名。使用--oneshot標誌運行 guru 以進入oneshot模式，在此模式下，guru 會刪除每個詢問的上下文訊息。會話始終自動記錄~/.guru/session/

內建提示

充當備忘錄

 > guru cheat

guru cheat是guru chat -p Cheatsheet指令的別名，用來簡化使用者輸入。

充當提交者

 > git diff | guru commit

guru commit是guru chat -p Committer的別名。

單次模式

使用--oneshot參數進入一次性會話模式。在這種模式下，上下文訊息將被自動丟棄。但是，如果--prompt, -p指定提示，則提示的內容將被固定並隨每個請求一起提交。

使用: message pin指令固定任何訊息

 guru --oneshot

重定向標準輸入和標準輸出

 echo list files in this dir in detail | guru cheat | sh

留言管理

ChatGPT 不會在伺服器端儲存對話的上下文。它的上下文感知能力是透過提交客戶端的所有上下文內容來實現的。根據 OpenAI API 中的定義，提交的問題或回覆的答案都稱為訊息。訊息內容被標記為token，提交和回覆的token總數都有限制，最多為4096個。長時間的對話會耗盡代幣。

Guru支援自動清理舊訊息，實現滾動視窗持續通話。然而，有時我們希望對提交給 ChatGPT 的訊息進行更精確的控制。此時，可以使用訊息管理的內部指令來手動收縮、刪除或追加訊息。

對於我們不想刪除或不想被滾動視窗清理的訊息，我們可以使用: message pin命令固定訊息。 oneshot 模式使用此方法固定提示訊息，從而保留每個問題都會提交的提示。

• : message list列出所有目前訊息，別名:ls
• : message delete [id...]刪除訊息，其中參數為訊息ID，可以同時刪除多個訊息
• : message shrink [expr]收縮訊息，其中expr是範圍表達式，與 Golang Slice 中的表達式相同： begin:end 。 Begin 或 End 可以省略，例如5: ，表示保留所有 ID 大於或等於 5 的訊息。
• message show [id]顯示某則訊息並用 Markdown 渲染它。預設顯示最後一條訊息。
• message append追加訊息，也可使用快捷方式:append
• message pin [id]固定一則訊息，固定的訊息不會被訊息自動收縮機制自動刪除，也不能被: message delete指令刪除。
• message unpin [id]取消固定訊息

會話管理

每次執行guru時，都會自動建立一個會話。會話歷史記錄預設保存在~/.guru/session/目錄中。啟動時，您可以使用--session-id, -s指定會話 ID 或使用--last恢復最後一個會話。如果指定的會話 ID 不存在，則會自動建立。

會話管理提供了豐富的功能。會話管理最有用的功能是會話堆疊，它可以在不中斷當前會話的情況下巢狀子會話。會話的連續性非常有用，例如在談論論文時進行長時間對話，我希望將對話訊息記錄下來，以便將來審查時可以看到清晰的聊天記錄。 Guru 稍後也將支援匯出會話歷史記錄。

 guru > :session
Available commands:

:session new                  create a new session
:session remove               delete a session
:session shrink               shrink sessions
:session list                 list sessions
:session switch               switch a session
:session history              print history of current session
:session stack                show the session stack
:session stack push           create a new session, and stash the current
:session stack pop            pop out current session

• :session new建立一個新會話，也可以透過簡寫別名:new觸發。
• :session remove [sid]刪除會話。
• :session shrink [expr]收縮會話，其中expr是範圍表達式，類似:message shrink指令。
• :session list列出所有會話，目前會話以*表示。
• :session switch [sid]切換到不同的會話。
• :session history顯示會話歷史記錄。
• :session stack顯示會話堆疊狀態，也可以透過簡寫別名:stack觸發。
• :session stack push建立一個新會話並將其推送到堆疊上，也可以透過簡寫別名>來觸發。
• :session stack pop從堆疊中彈出目前會話，也可以透過簡寫別名<來觸發。

會話堆疊使用情況

>是一個特殊指令，用作:session stack push的別名。執行時，它會建立一個新會話並將其推入堆疊。命令提示字元將附加一個“>”符號，例如guru >> 。 <是:session stack pop的別名。執行時，它會從堆疊中彈出最頂層的會話，命令提示字元將刪除“>”符號。

注意：目前只有>和<命令會影響命令提示字元。直接使用:session stack push/pop不會有這種效果，但我們計劃將來改進機制。

快速儲存庫管理

prompt repo命令使您能夠新增或同步提示儲存庫。目前，Guru 支援兩個高品質的提示儲存庫： awesome-chatgpt-prompts和awesome-chatgpt-prompts-zh 。用戶還可以添加自己喜歡的存儲庫。

請注意，在初次使用時， Cheatsheet和Committer以外的遠端提示將需要:prompt repo sync命令來同步其檔案以供使用。同步的提示檔案預設儲存在~/.guru/prompt/目錄中。

 guru > :prompt
Available commands:
:prompt act as                act as a role
:prompt list                  list all prompts
:prompt repo sync             sync prompts with remote repos
:prompt repo add              add a remote repo
:prompt repo list             list remote repos
Alias commands:
:prompts                      alias :prompts = :prompt list

:prompt指令可讓您使用在awesome-chatgpt-prompts儲存庫中定義的提示，以及新增和同步您自己的提示儲存庫。

• :prompt act as as 充當提示符的角色，也可以透過簡寫別名:act as來觸發。
• :prompt list列出所有載入的提示訊息，也可以透過簡寫別名:prompts觸發。
• :prompt repo add/sync/list新增、同步並列出提示儲存庫。

充當 Linux 終端

 guru > :act as Linux Terminal

執行系統指令

您可以使用$符號執行系統命令，命令的輸出將在下一輪對話中提交給ChatGPT。當您需要載入文件時，這特別有用。

如果$符號後面沒有命令，Guru 將切換到 shell 模式，並且命令提示字元將變更為guru $ 。在此模式下，您輸入的任何命令都會像在 shell 中一樣執行，並且所有輸出都將在下一輪對話中提交給 ChatGPT。

在 shell 模式下，輸入>將返回對話模式。

查看或設定即時參數

• :info查看即時參數
• :set設定即時參數

 dir                           /Users/shafreeck/.guru
filename
openai-api-key                sk-************************************************
pin                           false
prompt
session-id                    chat-1680879639912-1ec4e509-af5b-4abb-9f4b-bebde2276d96
socks5                        localhost:8804
stdin                         false
timeout                       3m0s
------------------------------
chatgpt.frequency_penalty     0
chatgpt.max_tokens            0
chatgpt.model                 gpt-3.5-turbo
chatgpt.n                     1
chatgpt.presence_penalty      0
chatgpt.stop
chatgpt.stream                true
chatgpt.temperature           1
chatgpt.top_p                 1
chatgpt.user
disable-auto-shrink           false
executor
feedback                      false
non-interactive               false
oneshot                       false
system
verbose                       false

 :set chatgpt.temperature 0.5

執行者

執行器是 Guru 最強大、最獨特的功能。啟動 Guru 時，您可以使用--executor, -e參數指定執行程式。每輪聊天結束後，Guru 都會透過 stdin 將 ChatGPT 輸出傳遞給執行器。如果指定了--feedback ，執行器的輸出也會回饋到ChatGPT。

執行器與上面提到的系統命令不同。系統指令只是豐富了透過shell輸入資料的手段。而執行器則用於處理ChatGPT的輸出，實現了input -> output -> input的完整閉環。這意味著我們可以在會話期間使用執行器來處理訊息。

出於安全原因，每次執行程式呼叫都需要使用者確認。

殼牌作為執行者

最簡單的使用場景是透過shell執行ChatGPT返回的命令。

 > guru cheat -e sh

進階功能：ChatGPT 的自聊天

您可以使用以下指令來實作ChatGPT自對話：

 > guru -e "guru --dir ./conversation --last" --feedback Hi

自聊的原理是使用另一個guru作為執行者，將第二個guru的--dir設置為自己獨立的目錄，以避免與第一個guru混淆，並設置--last在每次啟動時恢復會話以維持對話的上下文。