前言¶
在 DeepSeek Harness（DSH）里和 AI 对谈时，常见需求是：让同事或朋友一起看上下文、补充观点，甚至代你向模型提问——但又不想对方安装 DSH、登录你的站点，或把整台实例的权限交出去。发截图或导出 Markdown 往往丢互动；临时开账号成本高。下面介绍的 dsh-share-room 是面向 web 客户端 的 DSH 插件：房主在对话头栏一键分享，访客用手机或桌面浏览器打开一次性邀请链接即可加入，无需账号；讨论与「问 AI」分流，分享范围限定在当前会话 fork 副本，并可随时撤销或调整策略。
这是什么¶
dsh-share-room（维护者 yillkid）是 DeepSeek Harness 的插件，npm 包名 dsh-share-room，当前发布版本 0.2.0，许可证 MIT。它解决的是：在 HTTPS 可达的 DSH 实例上，把单条 AI 对话以可控方式共享给最多 20 位访客，共同讨论并有限度地向你的 AI 提问。
插件归属社区生态：可在 SkillHub 目录页 查阅条目；该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。DSH 本身遵循「一切皆插件」的扩展思路，本插件通过 Cordis patch 注入 web 客户端与会话相关 UI 模块。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
分享与会话隔离¶
- 在对话头栏点击 Share（界面文案当前为繁体中文）。插件会 fork 一份独立副本 用于分享，原始对话保持私有。
- 每位访客获得 一次性邀请链接，从手机或桌面打开即可加入；无需安装 DSH、无需站点账号。
- 单次分享最多 20 位访客；每人以自己的名字发言。
- 访客 只能看到本次分享对应的对话，不能访问你的其他对话、文件或设置。
两类消息¶
- Discuss（讨论）：参与者彼此交流，AI 不参与。
- Ask AI（问 AI）：AI 读取自上次提问以来的讨论内容后作答，所有人可见回答。
管理与生命周期¶
- 随时撤销：可移除访客、关闭访客提问、或结束分享；结束后访客不能再发帖；可选择保留 只读页面 供阅读与下载。
- 分享进行中可调整：可延长或缩短有效期（自创建起最长 90 天）、修改访客提问次数上限、选择 AI 执行权限等级。
- 站点总开关：Settings → General → 對話分享（Conversation sharing） 可关闭整站分享能力；关闭后无法新建分享或邀请，访客立即看到「分享暫停中」，已有数据不删除，重新开启后恢复。
路由与集成要点¶
- 房主 API：
/api/share-room.*，使用 DSH 自身登录。 - 访客页面：
/share/<id>/，由插件自行认证访客。 - 若站点前有全站登录门（例如
@summersec/dsh-web-auth），须 仅放行/share/；详见仓库内docs/web-auth-public-prefixes.md。 - 反向代理在 HTTPS 下发送
X-Forwarded-Proto: https时，访客 Cookie 会自动带Secure；也可设置环境变量SHARE_ROOM_SECURE_COOKIE=1强制开启。
安装与启用¶
环境要求¶
- DSH 0.1.5-rc.1 或 0.1.7-rc.2（文档写明均已测试）；
- Node.js 22 或更高；
- 访客能访问的 HTTPS 地址（公网域名或隧道等）。
安装步骤¶
- 将插件安装到 DSH 的 web profile：
dsh plugin --profile web add dsh-share-room
DSH 会通过 pnpm 从 npm 安装，并写入该 profile 的 dsh.profile.bundles。
- 重启 DSH。对话头栏会出现 Share 入口。
更新与卸载：
dsh plugin --profile web update dsh-share-room
dsh plugin --profile web remove dsh-share-room
若要从 GitHub 指定版本安装（而非 npm）：
dsh plugin --profile web add github:yillkid/dsh-share-room#v0.2.0
默认开关与模板¶
安装后分享功能默认开启。站点模板可在 cordis.patch.yml 里对 share-room 设置 config: { enabled: false }，使新站点默认关闭；房主在设置里的选择优先。
典型用法¶
- 确认 DSH 已用 web profile 装好插件并重启，且访客能通过 HTTPS 打开你的实例。
- 在要协作的对话中点击头栏 Share，按对话框填写访客称呼等信息；可选 帶入這段對話到目前為止的內容，则访客会看到创建分享前的完整对话（含已有 AI 回答）。
- 将生成的邀请链接发给对方；对方打开链接进入
/share/<id>/页面，用 Discuss 交流，需要模型介入时使用 Ask AI。 - 房主在管理界面可邀请更多人、移除访客、切换是否允许访客提问、调整 AI 权限与提问次数上限、延长或结束分享。
- 若不再分享，结束分享并视需要保留只读页；全站暂停可在 Settings → General → 對話分享 关闭。
演示动画与截图见 GitHub 仓库 的 docs/media/；完整带字幕视频为 docs/media/demo.mp4。
适用场景与注意事项¶
适合谁¶
- 需要在 同一 AI 对话上下文 里做远程协作、评审或陪练，又不想给每位参与者 DSH 账号的团队或个人。
- 已部署 可公网 HTTPS 访问 的 DSH web 实例，并愿意承担 访客提问消耗的模型费用（默认每个分享访客提问合计上限 50 次，可改）。
安全与成本（分享前必读）¶
README 强调：访客问的是 你的 AI、你的密钥、你的账单；插件能限制范围，不能保证模型对访客保密。
- 创建分享时，fork 副本会切到 DSH 的
read-only权限；若切换失败则 不会创建分享。你可在管理对话框把访客提问提升到workspace-write或完全权限；完全权限 需先在 Settings → General → 分享可使用完全權限 打开（默认关），且每次选择需再次确认。 - 只读模式下 AI 仍可读取 DSH 能读的文件并写进回答——模型能看见的，访客可能间接得到。应在仅含必要资料的 workspace 里运行共享对话，只分享给可信的人。
- 访客输入标记为不可信；模型仍可能被诱导。所有消息与 AI 操作记录在共享对话中，房主可实时查看；结束分享会撤回队列中尚未执行的访客提问，已可见内容与已执行操作无法撤销。
- 访客页与 DSH 同源，采用严格 CSP；若存在注入缺陷，风险与站点登录上下文相关。最强隔离建议将
/share/放到独立主机名。
插件权限说明¶
插件随 当前 DSH web 进程 运行，并 patch 会话与聊天相关客户端模块。安装前应阅读 源码与许可证，确认符合你的合规与运维策略；勿在未审计的情况下对不可信来源安装同名包。
结尾¶
dsh-share-room 把 DSH 单条对话变成可链接协作的「房间」：fork 隔离原会话、Discuss / Ask AI 分工、人数与提问上限及权限可调、分享可撤销或全站暂停。适合已有 HTTPS DSH 部署、需要在可控边界内让人一起用你 AI 的场景。
