OpenCode 如何把会话 /share 分享成公开链接，并切换 share 的 manual、auto 与 disabled 模式

OpenCode 如何把会话 /share 分享成公开链接，并切换 share 的 manual、auto 与 disabled 模式

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode

在使用 OpenCode 时，如果需要把某次会话发给同事讨论、或者向他人求助，share 功能可以为当前会话生成一个公开链接。完成后的结果是：会话历史被同步到 OpenCode 的服务器，任何人拿到链接都能通过opncd.ai/s/<share-id>形式的地址查看这次对话。需要注意的是，共享的会话对持有链接的任何人都是公开可访问的。分享行为由配置文件中的share选项控制，共有manual、auto、disabled三种模式，默认是manual。

分享机制：/share 之后发生了什么

执行分享时，OpenCode 会做三件事（见 share 文档）：

1. 为当前会话创建一个唯一的公开 URL；
2. 将会话历史同步到 OpenCode 的服务器；
3. 让会话可以通过opncd.ai/s/<share-id>这个可分享链接访问。

在 manual 模式下手动分享当前会话

OpenCode 默认使用 manual（手动）分享模式：会话不会被自动分享，需要在 TUI 中显式输入内置命令（见 tui 文档 的 share 命令条目）：

/share

执行后会生成一个唯一的 URL 并复制到你的剪贴板——"URL 已出现在剪贴板中"就是文档给出的执行结果，把它粘贴给协作对象即可完成分享。

如果想显式声明手动模式（而不是依赖默认值），可以在 config 文档 所述的位置配置opencode.json：

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

切换到 auto 模式：新会话自动生成公开链接

如果希望每个新会话都自动分享，把 config 文档 中的share选项设为"auto"：

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

开启后，每一个新会话都会被自动分享并生成链接，不需要再逐个执行/share。适用场景是团队内所有会话本就默认公开的协作环境；如果会话可能包含未定稿或敏感内容，保留 manual 模式更稳妥。

切换到 disabled 模式：彻底关闭分享

要把分享功能完全关掉，把share选项设为"disabled"：

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

share 文档指出，如果要在整个团队范围内强制这个设置，做法是把带"share": "disabled"的opencode.json放进项目目录并提交到 Git，这样所有克隆该项目的成员都生效。

config 文档 中对share选项的取值做了同一处汇总：

• "manual"— 允许通过命令手动分享（默认值）；
• "auto"— 自动分享新会话；
• "disabled"— 完全禁用分享。

停止分享：/unshare 命令

分享出去的会话不会自动过期：在显式取消分享之前，完整会话历史、所有消息和会话元数据都会保留在服务器上。要停止分享并让会话从公开访问中移除，在 TUI 中执行：

/unshare

执行后分享链接会被移除，与该会话相关的数据也会被删除。文档建议：协作完成后就执行 unshare，不要把包含专有代码或机密数据的会话共享出去。

企业环境的额外约束

share 文档说明，在企业部署中 share 功能还可以：

• 出于安全合规要求被整体禁用；
• 限制为仅通过 SSO 认证的用户可用；
• 在自有基础设施上自托管。

如果你的组织属于这类部署，实际的可用模式取决于企业侧的策略配置，具体说明见 enterprise 文档。

小结

• 默认 manual 模式下用/share生成并复制公开链接，用/unshare移除链接并删除对应数据；
• 模式切换统一通过opencode.json的share字段完成，取值只能是"manual"、"auto"、"disabled"；
• 团队级强制关闭靠项目内的opencode.json提交到 Git 实现；
• 共享内容对持有链接的人完全公开且持续有效，直到手动 unshare，分享前先确认会话中不含敏感信息。

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode