跳到內容
KeuralDocs
功能

程式碼與 Cowork

連接資料夾與儲存庫,讓代理程式處理你的檔案與程式碼。

Cowork

Cowork 畫面

Cowork 是在對話中將資料夾交給代理程式的模式。在桌面 App 的新對話中,於輸入框下方選擇 Cowork,再使用 新增資料夾 連接一個或多個資料夾。可用於將報告草稿存到資料夾,或一次整理多個檔案。核准模式與程式碼模式相同,共五種。

程式碼模式

程式碼模式畫面

在側邊欄上方的 對話 / 程式碼 切換中選擇 程式碼(側邊欄收合時,請點擊 程式碼 圖示),即可開啟程式碼工作畫面。代理程式會讀取你的專案、撰寫與編輯程式碼,並執行指令。側面板會顯示終端機、變更(差異)、檔案樹、結果物與對話資訊(內容使用量與已連接的外掛程式)。模型依等級選擇,與對話相同;思考(快速、中、高、超高、最高)則另外設定。

執行位置

位置說明可選擇的位置
這台裝置桌面 App 直接在這台電腦上的專案資料夾中作業。支援讀取、搜尋與編輯檔案、shell 指令,以及 git commit 與 push。桌面 App
Cloud(Keural Cloud)在雲端環境中拉取 GitHub 儲存庫進行作業,不需要這台電腦。可 commit 並 push 到工作分支,並建立 PR。需要 GitHub 連線。桌面 App(網頁與行動版需已登錄桌面裝置)
遠端裝置將工作交給已登錄的桌面裝置,該裝置必須開機。網頁與行動版

選擇本機模型時,無法使用 Cloud 與遠端裝置。離線模式下,工作僅在這台裝置上執行。

遠端控制

若要從網頁或手機查看並指示桌面上進行中的程式碼工作階段,請在側邊欄的對話選單中按下 開啟 Remote Control。Remote Control 關閉的工作階段無法從其他裝置傳送訊息。

核准模式

在程式碼模式的輸入框中,於 權限 下選擇代理程式可不經詢問即執行的範圍。按下 Shift + Tab 可依序切換 手動 → 自動接受編輯 → 計畫 → 自動。略過權限只能從選單中選擇。

模式檔案寫入與刪除Shell 指令
手動每次核准每次核准
自動接受編輯自動每次核准
計畫先顯示計畫,每次執行時都需要核准每次核准
自動自動僅有風險的指令(傳送、刪除、部署、系統變更等)需要核准
略過權限自動自動

自動 與 略過權限 會在未經確認的情況下變更你的電腦。請只在信任的專案中使用。遠端裝置上無法選擇略過權限。

其他規則:

  • 若要處理已連接資料夾以外的路徑,會再次要求核准。
  • 非略過權限時,會影響資料夾外路徑的 shell 指令,以及安裝套件等下載並執行的指令,每次都會詢問。
  • 非常危險的 shell 指令無論核准模式為何,都會在執行前被封鎖。
  • 核准視窗會顯示即將執行的指令與將會變更的檔案。進度與已變更的檔案會保留在對話的工作紀錄中。

其他工具

  • @ 檔案參照:在程式碼模式中連接資料夾後,請在輸入框中輸入 @ 以指定檔案。
  • GitHub 連線:在 設定 → GitHub 中,可儲存個人存取權杖,或使用 GitHub CLI 登入。已登入帳號的權杖會儲存在伺服器上。未登入的桌面 App 所使用的權杖,則儲存在這台電腦的安全儲存空間中。
  • 遠端執行權限:若要將電腦作為遠端裝置使用,請在 設定 → 安全性 的「我的裝置」中,設定其遠端執行權限(允許全部、僅允許安全操作或唯讀)以及允許的遠端資料夾。
  • 代理程式瀏覽器:代理程式會開啟網頁並直接操作,以進行確認。請參閱瀏覽器與應用程式控制。

行動 App

行動 App 中也可以在程式碼畫面將工作交給 Cloud 或遠端裝置。

本頁內容