AI 程式設計教學中文版
官方教學中文版入門

分享會話

說明 OpenCode 會話分享的用途、公開邊界、撤銷方式和團隊預設策略。

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
Share分享把會話生成可分享連結。
可見性visibility誰能看到分享內容。
敏感清理scrub分享前去掉敏感資訊。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你安全地分享 OpenCode 會話,不洩露敏感資訊。

你是 OpenCode 會話分享顧問。

【角色】
OpenCode 會話分享顧問,按最小夠用、安全優先的原則給可落地方案,每條結論都落到能照做的步驟或示例,不停留在空泛建議。

【輸入】
- 我想分享給誰:___
- 會話裡有無敏感內容:___
- 分享目的:___
- 可見性要求:___
- 經驗水平:___

【工作流程】
1. 說明分享機制和可見性
2. 判斷會話能否分享
3. 清理敏感資訊
4. 給分享步驟
5. 給驗證

【輸出規範】
▌一、分享機制
▌二、能否分享
▌三、敏感清理
▌四、分享步驟 + 驗證

【硬約束】
- 分享前清掉金鑰 / 私有資料
- 可見性按需收緊
- 拿不準的內容不分享
- 不要替我臆測情況或編造不存在的功能,資訊不全先問清
- 不確定的設定或介面一律以官方文件為準,禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例,不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

OpenCode 的 /share 不是“發一段截圖”,而是把目前會話同步到 OpenCode 的分享服務,並生成一個任何拿到連結的人都能開啟的公開 URL。它適合求助、覆盤和團隊協作,不適合未經檢查地分享真實專案上下文。

這一篇用 8 分鐘換什麼:你會知道 /share 到底分享了什麼、什麼時候用 manual / auto / disabled、分享前要檢查哪些敏感內容,以及團隊專案為什麼應該先把預設值收緊。

先給結論:分享前先當公開頁面處理

分享連結形如:

opncd.ai/s/<share-id>

只要別人拿到連結,就能訪問對應會話。不要把它理解成“只有團隊成員可見”的私密連結。

場景建議
非敏感問題求助手動 /share,發給需要的人
團隊覆盤一次 OpenCode 輸出手動分享,結束後 /unshare
公開儲存庫 CI 自動化明確檢查 share 設定和記錄內容
私有客戶專案、商業策略、未公開原始碼share: "disabled"
企業試用期預設停用,再按合規要求評估

不要在包含 API key、cookie、客戶資料、內部路徑、未公開原始碼、私有服務地址或商業策略的會話裡直接 /share。先脫敏,脫敏不確定就停用分享。

分享的資料流

當你分享目前會話時,OpenCode 會建立唯一公開 URL,並把會話歷史同步到 OpenCode 伺服器。官方文件明確說明,分享後的會話在取消分享前會保持可訪問狀態。

flowchart LR
  Local["本地 OpenCode 會話"] --> Share["/share"]
  Share --> Server["同步到 OpenCode 分享服務"]
  Server --> URL["opncd.ai/s/<share-id>"]
  URL --> Viewer["任何擁有連結的人"]
  Server --> Unshare["/unshare 移除連結並刪除相關資料"]

  style Share fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
  style Server fill:#fef3c7,stroke:#f59e0b
  style Viewer fill:#fee2e2,stroke:#ef4444
  style Unshare fill:#dcfce7,stroke:#22c55e

通常會被分享的內容包括:

  • 完整對話歷史。
  • 使用者訊息和 OpenCode 回覆。
  • 與該會話相關的後設資料。
  • 對話裡出現的檔案片段、命令輸出、錯誤記錄或路徑資訊。

所以真正的安全判斷不是“有沒有貼金鑰”,而是“這段會話公開後,陌生人能不能推斷出不該公開的資訊”。

三種分享模式怎麼選

OpenCode 的 share 設定有三種模式。

模式行為適合場景
manual預設模式;只有執行 /share 才生成連結個人日常使用、臨時求助
auto新會話自動分享極少數公開演示或固定公開協作環境
disabled完全停用分享私有儲存庫、客戶專案、企業試用、敏感團隊

專案裡可以顯式寫入:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "share": "disabled"
}

團隊專案不要靠口頭約定“大家別點分享”。把 share: "disabled" 寫進專案設定,提交到 Git,才能讓預設行為穩定。

手動分享和取消分享

手動分享目前會話:

/share

這會生成一個唯一 URL,並複製到剪貼簿。

取消分享目前會話:

/unshare

官方文件說明,/unshare 會移除分享連結,並刪除與該對話相關的資料。實際協作裡建議把 /unshare 當作收尾動作:問題解決、覆盤結束、連結不再需要,就撤銷。

分享前檢查清單

/share 前,至少掃一遍這些內容:

  • 會話裡有沒有 API key、token、cookie、SSH key、OAuth 回撥資訊。
  • 命令輸出裡有沒有 .env、CI secrets、資料庫連線串、私有 registry token。
  • 檔案片段裡有沒有客戶名稱、郵箱、訂單、賬號、內部專案代號。
  • 錯誤記錄裡有沒有內網域名、私有 IP、伺服器路徑、使用者目錄。
  • 對話裡有沒有未公開產品策略、報價、路線圖或漏洞細節。
  • 公開後是否會暴露團隊使用的 provider、模型、閘道器或安全策略。

如果只是要別人幫你看一個報錯,更穩的做法是先匯出或複製最小必要資訊,脫敏後再分享,而不是把整個會話直接公開。

團隊預設策略

個人學習可以保留 manual。團隊專案建議分層處理:

專案型別預設策略
教學示例、公開 demomanual,必要時分享
開源專案manual,CI 整合單獨檢查分享預設值
私有業務專案disabled
客戶交付專案disabled
企業統一環境透過集中設定停用或限制分享

企業版可以把分享功能完全停用、限制給透過 SSO(Single Sign-On,單點登入——員工只在公司身份系統登入一次,訪問所有內部應用都自動透過)的使用者,或在自有基礎設施中託管分享頁面。即使具備這些能力,敏感組織也應該先預設關閉,再按用例開放。

什麼時候適合分享

適合分享的情況:

  • 你要向同事展示一次 OpenCode 的推理過程。
  • 你要讓別人覆盤一個非敏感 bug 的定位過程。
  • 你要給社群提問,且已經確認會話裡沒有私密上下文。
  • 你要把一次公開儲存庫的修復過程作為教學素材。

不適合分享的情況:

  • 會話接觸了真實客戶、真實賬號或真實生產記錄。
  • agent 讀過私有原始碼、商業計劃、報價、合同或內部文件。
  • 你不確定命令輸出裡有沒有 secret。
  • 專案所在組織沒有明確的資料分享政策。

接下來去哪

官方資料

本頁目錄