工作階段知識庫

本頁介紹「工作階段知識庫」、「整理紀錄」與「已封存會話」。管理、編輯與匯入本機 Markdown 檔案的說明，請參閱本機知識庫。

工作階段知識庫儲存知識、決策、限制條件與經驗教訓，並依「專案 → 會話 → 條目」的層級組織。產生的條目會獨立儲存：來源會話變更時，條目不會隨之改變，您也可以手動編輯。工作階段知識庫屬於您所連線的 VelaTerm 後端，並由該後端的所有專案與會話共用；連線到其他伺服器時，您看到的是該伺服器的知識庫。

工作階段知識庫與會話內容搜尋是分開的。會話搜尋會在原始對話中尋找文字，知識庫則只搜尋已儲存的條目。VelaTerm 只會在您要求時整理、儲存與顯示條目，不會自動將條目加入新的會話。

整理會話

在側邊欄中的會話或其分頁上按右鍵，選擇「整理至工作階段知識庫」。已封存的會話也提供相同的操作。
選擇「代理程式」：Claude、Codex、Grok Build、OpenCode、Pi 或 OMP。VelaTerm 會使用設定 ▸ 智慧體中設定的可執行檔路徑，或在 PATH 中尋找該程式。找不到的智慧體會標示為「尚未安裝或設定」，且無法選取。
可視需要選擇「模型（選填）」與「思考程度」。「預設模型」與「使用智慧體預設值」會交由智慧體本身的設定決定。模型清單與建立會話時使用的清單相同，且只有支援推理強度的模型才會顯示強度等級。VelaTerm 會記住您上次使用的智慧體、模型與推理強度。智慧體必須已登入，且有權使用所選的模型。
點選「整理並儲存」。所選的智慧體會接收會話的文字，並透過其自身的模型設定進行處理。
在「整理紀錄」中追蹤此工作。關閉對話方塊不會停止工作。

有智慧體的對話記錄時，VelaTerm 會讀取該記錄；否則會改用會話的終端機錄製內容（請參閱終端機使用方式），並移除其中的終端機控制碼。兩者都無法讀取時，會回報「此工作階段目前沒有可讀取的對話內容。」終端機錄製內容包含畫面上可見的文字，也可能包含重繪的內容，因此負責整理的智慧體不應將這類輸出視為已驗證的事實。

來源快照會儲存為了整理而讀取的文字。專案與會話名稱會在會話首次加入時儲存；之後即使專案或會話在其他地方重新命名、移動、封存或刪除，這些名稱也不會隨之更新。

再次整理同一個會話時，會重新讀取該會話，並取代先前從中產生的條目，包括您手動所做的編輯；即使文字與模型設定都沒有變更，也是如此。如果該會話已有尚未完成的工作，新工作會取代它。舊工作已在執行時，新工作會在舊處理程序停止後自動開始（「等待此工作階段的上一項整理停止後，將自動開始。」）；舊工作仍會保留在記錄中。

整理的運作方式

整理分為三個階段，並顯示為工作的進度：

擷取主題： 分段讀取會話，並擷取可重複運用的知識。主題只會在此工作內合併；不會使用其他會話的條目與先前的手動編輯。
合併知識： 合併每個主題的各項內容，保留知識、限制條件與不確定之處。智慧體會依指示考量後續的修正與矛盾之處，且不得自行編造結論。
儲存條目： VelaTerm 會檢查欄位、來源、連結與版本，並在單一資料庫交易中取代該會話產生的條目。標題相同的條目會沿用原本的識別資訊，並新增一個修訂版本。不再產生的條目會連同其修訂紀錄一併刪除，指向這些條目的連結也會移除。整理成功但未找到任何可重複運用的內容時，會清除該會話先前產生的條目（「本次未擷取到可重複運用的知識，此工作階段既有的產生條目已清空。」）。檢查失敗、取消或發生版本衝突時，先前的條目會維持不變，也不會儲存任何部分結果。

智慧體負責傳回結構化內容，所有資料庫變更則由 VelaTerm 執行。條目之間會互相連結，「反向連結」清單會自動計算。即使原始會話已刪除，來源快照與修訂紀錄仍可使用。

整理出的知識品質仍需要您自行判斷。如有錯誤，請編輯條目或還原先前的修訂版本；還原會建立新的修訂版本，並保留被取代的版本。

整理紀錄

「整理紀錄」會列出整理工作，每頁 40 項。每項工作會顯示智慧體、模型（未選擇時顯示「預設模型」）、推理強度與時間；執行中的工作還會顯示目前的階段（「擷取主題」、「合併知識」或「儲存條目」）。工作的狀態為「等待開始」、「進行中」、「正在取消」、「已完成」、「失敗」或「已取消」，並可從清單開啟其「來源快照」與產生的條目。

「取消」會停止等待中或執行中的工作。執行中的工作在智慧體處理程序停止之前會顯示「正在取消」。取消不會刪除來源快照。
「重試」會以相同的來源快照、模型與推理強度重新啟動失敗或已取消的工作。記錄中顯示的是工作建立時的設定；預設選項表示由智慧體自行決定，並不表示 VelaTerm 已解析出特定模型。

不同的會話可以同時整理。每個會話一次只執行一項工作，再次提交時只會保留最新的等待中工作，而不會形成佇列。等待中的工作會儲存在資料庫中，應用程式重新啟動後會繼續。執行中的工作如果兩分鐘未回報進度，會標示為已中斷（「整理工作已中斷，可重試處理已儲存的來源快照。」）。等待的時間不計入工作的時間上限。

整理進行期間，您仍可編輯條目。如果有人在工作期間編輯或刪除了該會話產生的條目，工作會回報版本衝突，您的變更會保留，之後可以再重試。不同的會話可以使用相同的條目標題；但在同一個會話中，標題必須是唯一的。

瀏覽與維護條目

從右側面板開啟知識庫（請參閱本機知識庫），依專案、會話與條目展開「工作階段知識庫」。點選專案或會話可列出其條目，點選條目即可閱讀。「返回上一層」按鈕會回到上一層頁面。

清單頁面提供搜尋（「搜尋條目標題與內文…」）、標籤篩選（「所有標籤」）、排序方式（「最近更新」或「依標題排序」）與重新整理。搜尋範圍涵蓋標題、摘要、內文與標籤，支援多個詞語（所有詞語都必須符合），並優先列出標題符合的結果；每筆結果也會列出與其直接相關的條目。沒有完全符合的結果時，會與本機知識庫搜尋一樣顯示近似結果。
會話的條目每頁顯示 40 項；專案與會話清單不受此限制，較長的樹狀清單會提供「載入更多」。
條目頁面會顯示 Markdown 內文、「相關條目」、「反向連結」、「來源」與「修訂紀錄」。您可以直接編輯內文並以 ⌘S／Ctrl+S 儲存，也可以透過「編輯」修改標題、摘要與標籤，或使用「匯出 Markdown」、「複製到本機知識庫」與「刪除」。刪除條目也會刪除其修訂紀錄，但會保留來源會話及其快照。
「新增條目」可手動建立條目；這類條目會顯示在「手動建立」群組中。

樹狀結構也支援管理操作：

在條目上按右鍵可重新命名或刪除條目；將條目拖曳到另一個會話上，即可將其改為歸屬該會話。
在專案或會話群組上按右鍵，可重新命名群組或刪除其中的條目。重新命名群組也會重新命名實際的專案或會話。刪除群組只會移除其中的知識條目：「刪除該群組內全部 N 條知識條目？專案或工作階段本身保留。」
將會話拖曳到另一個專案上，會把實際的會話移到該專案。
「手動建立」、「歷史合併條目」與「來源專案不明」群組無法重新命名。

條目頁面、編輯表單、來源快照、修訂版本、整理對話方塊與整理紀錄都有各自的網址，所選的專案、會話、搜尋、篩選、排序與頁碼也都包含在網址中。

已封存會話

已封存的會話在知識庫中管理。「已封存會話」會出現在知識庫樹狀結構中「工作階段知識庫」的旁邊，並依來源專案將已封存的會話分組；側邊欄標頭中的「已封存會話」按鈕也會開啟同一個位置。

主要區域會依專案列出所有已封存的會話。開啟的會話有兩個分頁：「對話」顯示完整對話，「知識條目」顯示從該會話產生的條目。
「搜尋封存內容…」只會搜尋已封存會話的全文，並依會話將符合項目分組。
開啟的已封存會話提供「恢復為正常會話」、「整理至工作階段知識庫」、「匯出完整上下文為 Markdown」（適用於 Claude 與 Codex 會話）與「徹底刪除（連帶錄製）」。徹底刪除會立即生效，不會要求確認。
封存、還原與刪除會話不會變更既有的知識條目，因為條目與來源快照是分開儲存的。還原的會話可以繼續其對話。

舊版本的資料

VelaTerm 升級舊資料時，只有單一來源會話的條目會歸屬到該會話。已經合併多個會話的條目會完整保留在「歷史合併條目」群組中；這些條目不會被拆分，也絕不會因為再次整理其中某個會話而被取代。沒有來源的條目會歸入「手動建立」。仍然存在的專案資訊已在升級時補齊一次；無法判定所屬專案的來源會列在「來源專案不明」之下，並保留其原始會話名稱與快照。

資料與限制

工作階段知識庫儲存在應用程式的 SQLite 資料庫中（memory_* 資料表），與會話搜尋索引分開。介面只保留所顯示的內容與尚未儲存的表單輸入；驗證、版本檢查、重複偵測與所有寫入作業都在後端進行。

單一來源最多可包含 2,000,000 個字元，每個擷取區段最多 24,000 個字元，單次模型輸入最多 350,000 個字元，單一條目內文最多 200,000 個字元。
每次智慧體呼叫最多可執行 10 分鐘，其每個輸出串流最多可產生 8 MiB。
對於 OpenCode、Pi 與 OMP，單次呼叫傳入的文字上限為 128 KiB。
如果智慧體傳回的輸出不符合預期的結構，VelaTerm 會要求其重新產生，最多三次。

超過這些限制時會明確回報失敗（「來源、上下文或輸出超出支援的大小，未截斷內容，也未儲存條目。」）；不會截斷內容後再儲存。

整理過程會記錄在應用程式資料目錄的 logs/runtime-*.log 中。未設定 VLX_LOG_DIR 時，由 VLX_MEMORY_LOG_DIR 設定目錄。VLX_MEMORY_LOG_LEVEL=error 只記錄錯誤，off 則關閉此模組的日誌。日誌會記錄工作與階段、輸入與輸出數量、耗時、字元數、SHA-256 摘要與 token 用量數據，但絕不會記錄完整的提示詞、來源文字、模型回應、憑證或錯誤輸出；原始資料保存在來源快照中。

程式碼圖譜連結

知識條目可以連結到程式碼符號，條目頁面上的「程式碼參照」可跳至程式碼圖譜。連結的檔案變更時，條目會顯示需要重新檢閱；確認檢閱不會變更條目的文字。會話中的智慧體可以使用 vkb 查詢程式碼與條目。請參閱程式碼圖譜與知識庫。