跳至指南

Mind 與審核

Mind 與審核是 onemind 保存已版本控管、經同儕審核之團隊 AI 指引的所在。開啟 Mind 以瀏覽最近的 Mind 或選擇 Project；提出變更前，請先閱讀生效內容、版本、相關 Project、檔案及歷史。

  1. Team 管理員可選擇新增 Mind，按需選擇其 Project，並輸入名稱及內容。檔案名稱將成為 [名稱].md。按一下建立以建立 Mind；建立由伺服器確認，是管理員操作。
  2. 如需修改現有 Mind，選擇更新。這會直接開啟拉取請求頁面：輸入必填標題、可選詳情，並使用側面板編輯器查看檔案清單。選擇取消以放棄，儲存以保留草稿，或傳送以提交審核。
  3. 提交不會更改已批准的 Mind。
  4. 現任管理員在通知中審核精確變更和檢查結果。按一下批准並發佈會發佈下一個不可變版本；拒絕保持生效版本不變。具授權的管理員可審核自己的提案。
  5. 查看歷史，然後同步已批准版本。

Mind 更新支援的檔案類型為 Markdown、JSON、YAML、TOML 及純文字（僅限 UTF-8）。新 Mind 的內容限制為 8,000 個字元；附加至更新的檔案每個限制為 512 KiB。將檔案上傳至草稿不代表已批准或套用。

若基礎版本變更或檢查失敗，請保留草稿、閱讀目前 Mind 並解決衝突後重新提交。刪除 Mind 會發送審核請求，在批准前仍可見。已儲存的草稿或待處理請求不等於已發佈的變更。Team 工作進度與 AI 工具互動記錄於 Matrix 工作。

瀏覽及整理 Mind

側邊導覽中的 Mind 部分是進入所有 Mind 的入口。最近的 Mind 顯示在清單頂部；選擇顯示全部以查看團隊中的所有 Mind，或選擇收合以摺疊清單。在項目下選擇一個 Project 以查看其中的 Mind；按一下 Mind 名稱以開啟其詳細資料視圖。

任何已登入的團隊成員均可個人化側邊欄中 Project 和 Mind 的排列順序。將列拖曳至所需位置，或將焦點移至列並按向上或向下箭頭鍵移動。順序是按使用者儲存至伺服器；不影響其他團隊成員的視圖。儲存確認訊息在順序記錄後出現。若開啟時無法載入順序，則顯示預設的伺服器順序。

從 Mind 詳細資料視圖，使用上一個 Mind 和下一個 Mind 箭頭在 Mind 之間切換，無需返回清單。

詳細資料視圖中的關於面板顯示 Mind 的當前版本、狀態（啟用或等待提案）、最後更新日期、建立者和最後更新者、相關 Project 及附加檔案。檔案預覽僅限純文字（UTF-8）；二進位檔案和過大的檔案會顯示備用訊息。使用部分切換按鈕展開或摺疊「關於」面板。建立時設定的 Mind 目的欄位也顯示於此。

當 Team 方案變更進行中時，所有 Mind 進入暫時唯讀狀態。「關於」面板顯示通知；在方案變更完成前，更新和傳送不可用。

草稿與拉取請求

在現有 Mind 上選擇更新會直接開啟拉取請求頁面。頁面列出基礎 Mind 檔案及任何附加檔案，顯示基礎版本，並提供必填標題和可選詳情的欄位。你可以使用側面板編輯器新增或移除 AI 工具鏈檔案（技能、掛鉤、提示詞、規則——JSON、YAML、TOML、Markdown 或純文字，每個最多 512 KiB）。草稿不會自動儲存；請明確選擇儲存以在不提交的情況下保留在此裝置。

若你在草稿進行中離開，會出現離開此 Mind 提案？對話框——選擇儲存並離開以在此裝置上保留草稿，或選擇繼續處理以返回編輯器。當你返回同一 Mind 時，載入已儲存的提案草稿？對話框會提供從已儲存草稿還原文字和檔案的選項。選擇載入提案以從上次離開的地方繼續，或關閉以重新開始。

你可以在傳送前重新命名 Markdown 檔案（檔案名稱必須保留 .md 或 .markdown 副檔名）。選擇傳送以提交提案進行 Safe Check 和審核。

若 Mind 處於唯讀狀態、暫時不可用，或你的連線已過期，則無法傳送；頁面會針對每種狀態顯示具體訊息。

更改 Mind 標題

更改 Mind 的顯示標題是獨立於更改內容的另一個審批流程。任何已登入的團隊成員均可提議更改標題：按一下 Mind 詳細資料視圖中的標題，輸入新標題（1 至 160 個字元，不含控制字元），然後選擇要求審批。一個固定提案標題為更新 Mind 標題的拉取請求將自動建立。

在管理員批准提案前，當前標題保持不變。若在您編輯標題期間 Mind 發生變更，會出現資料過期的訊息；請關閉並重新開啟編輯器以使用目前版本後再重新提交。Mind 處於唯讀狀態時，無法傳送標題變更。

Safe Check 與衝突檢查

提交拉取請求時，伺服器會自動執行 Safe Check——一種 AI 驅動的審核，在提案到達人工審核者之前產生發現結果。Safe Check 在每次提交時執行；無需使用者操作即可觸發。

衝突檢查是 Safe Check 的結構性組件。它將提議的 Mind 與所有其他啟用的 Mind 進行比較，並以三個嚴重程度群組報告發現結果：

  • 阻擋項 — 阻止批准的決定性衝突。提案必須在審核繼續之前進行編輯或拒絕。
  • 需審核 — 在批准前需要明確人工確認的建議性發現結果。
  • 重疊項 — 較低嚴重程度的發現結果，供參考。

每個發現結果均有置信度等級：確定（決定性）、啟發式或語義。11 種發現類型為：重複身份、過期版本引用、權限或範圍違規、無效分配、重複分配、受保護聲明衝突、缺少版本引用、依賴循環、資源擁有權衝突、矛盾指令和重複指引。每個發現結果顯示穩定的指紋、確切的來源版本及受影響的組合上下文，供審核者參考。

若存在建議性（需審核等級）發現結果，審核者必須勾選審核確認核取方塊——確認已審核所有建議性發現結果並了解不會自動解決任何 Mind 授權——才能使用批准並發佈操作。

如需在提交前在本地執行衝突檢查，請使用 Mind Check CLI 命令。執行帶 --harness 旗標的 onemind mind-check member 以檢查您的工具檔案（每個最多 256 KiB）；執行帶 --subject 旗標的 onemind mind-check manager 以檢查主題 Mind 或套件檔案。Mind Check 在當前版本中僅為警告模式，本身不會阻止同步。使用 --json 以程式化方式解析輸出。如需完整旗標清單，請參閱 CLI 命令參考。

在通知中審核

管理員在通知中審核傳入的拉取請求。每個請求顯示確切的提議差異、Safe Check 發現結果和衝突檢查發現結果。如需批准或拒絕：

  1. 在側邊導覽中開啟通知。
  2. 選擇傳入的 Mind 審核請求。
  3. 檢查提議的差異和任何衝突檢查發現結果。
  4. 若存在建議性（需審核等級）發現結果，請勾選審核確認核取方塊以確認。
  5. 選擇批准並發佈以發佈下一個不可變版本，或選擇拒絕以保持啟用版本不變。

授權時，管理員可以審核並批准自己的提案。阻擋等級的衝突檢查發現結果會阻止批准並發佈操作；提案必須在提交乾淨版本之前進行編輯或拒絕 PR。

如果提案經檢查後已批准的 Mind 又有變更，批准並發佈將無法再發佈該提案。審核頁面會說明提案已過期，提案作者或任何管理員可以選擇在目前版本上重新提出。onemind 會在目前版本上建立新提案，保留相同的標題、詳細資料、檔案和作者，重新執行安全檢查，並將舊提案標示為已被取代，附上前往新提案的連結。如果提案的修改與目前版本中的變更重疊，則不會取代任何內容：審核頁面會將目前版本與提案並列比較，方便作者提交已修正的提案。如果目前版本已包含這些變更，請拒絕舊提案以將其關閉。

通知同時處理刪除審核請求。刪除請求的決定與內容變更請求分開；請參閱下方的刪除與復原 Mind。

移動或複製 Mind

任何已登入的團隊成員均可將 Mind 行拖曳至側邊欄中的目標 Project，以移動或複製 Mind 至不同的 Project。

  1. 將 Mind 行拖曳至側邊欄中的目標 Project。
  2. 選擇複製以在來源 Project 中保留 Mind，或選擇移動以從來源 Project 中移除 Mind。
  3. Mind Checker 在傳送請求前自動執行；完成注意事項顯示已檢查的版本和雜湊值。
  4. 若 Mind Checker 無法完成，則不會建立審批請求。
  5. 請求進入通知中的管理員審批佇列。
  6. 管理員批准或拒絕變更；Mind 僅在批准後出現在目標 Project 中。

任何已登入的成員均可發起移動或複製請求，但只有管理員可以批准。移動 Mind 不可自動復原；需要第二個移動請求才能移回。

刪除與復原 Mind

刪除 Mind 會向團隊管理員傳送審核請求；Mind 保持可見，直到管理員批准刪除。如需請求刪除，從 Mind 操作選單選擇刪除並確認對話框。

管理員在通知中審核刪除請求，並選擇核准刪除或拒絕刪除。批准會隱藏 Mind，但不會永久移除；其受治理的歷史記錄將保留以供復原。

刪除批准後，通知顯示復原選項。如需還原 Mind，選擇復原 Mind。若 Mind 的 Project 也已刪除，必須先復原 Project 才能復原 Mind。選擇復原項目會將 Project 及其 Mind 還原至 Mind 面板，而不改變受治理的歷史記錄。復原失敗時會顯示具體錯誤訊息；請查看當前刪除狀態後再試。