文档 / 协作与集成

Live Share

在同一个项目上结对编程，端到端加密、一次性邀请、按访客设置权限。你的机密永远不会被共享。

Live Share 让另一个人和你一起编辑你当前打开的项目：两人可以同时输入、看到对方的光标、交谈，还可以一起跟进一次调试会话。它不需要云端服务器：连接直接建立在两台电脑之间。

通过命令 Live Share：结对编程（工具组，从 查找操作 Ctrl+Shift+A 中打开）启动它。它会在一个标签页中打开。

开始会话

  1. 点击 共享此项目。
  2. 填写 你的名字。
  3. 在 共享到 中选择监听位置：本地网络（使用你的地址）、其他地址（VPN）… 或 仅此电脑（SSH 隧道）。Yuli 只在该接口上监听，绝不会监听所有接口。
  4. 选择选项：在每位访客加入前进行批准、访客可以编辑 和 共享我的调试会话。
  5. 点击 开始共享，并通过可信渠道把邀请发送给你的同伴。

邀请的格式如下：

text
yuli-live://host:puerto/token#sha256

其中包含地址、一个秘密令牌以及会话证书的 SHA-256 指纹。

安全

保护措施 详情
加密 TLS 1.3，每个会话都会创建一个证书。其 SHA-256 指纹随邀请一起传递并被固定：不需要证书颁发机构。
令牌 128 位，来自系统随机数生成器，一次性使用，以恒定时间进行比较。
有效期 默认情况下，邀请在 30 分钟后过期。
失败尝试 每个地址每分钟最多 5 次。
参与者 每个会话最多 12 人。
文档大小 每个共享文件最大 4 MB。

批准访客

如果你开启了批准，Yuli 会提醒你：“{nombre} 想要加入”。你可以选择：

选项 结果
接受（只读） 加入并查看项目，但不能编辑。
接受并允许编辑 加入并可以编辑。
拒绝 不能加入。

按访客设置权限

在会话期间，你可以在参与者列表中更改每位访客的权限：

权限 默认
编辑 取决于你接受访客的方式。
终端 关闭。
踢出 将该访客移出会话。

终端 权限会给访客一个 在你的电脑上、以你的账户运行的真实终端。只对完全信任的人开启，并在对方不再需要时关闭。

加入、踢出和权限变更都会记录在审计日志中。

共享哪些内容

  • 同时编辑项目文件。
  • 每位参与者的光标，以及 跟随 另一位参与者。
  • 会话聊天。
  • 你的调试会话（如果你选择共享）：停住的行、调用栈和变量。访客可以请求单步执行。

绝不共享的内容

机密、凭据保险库、.git/ 文件夹，以及项目之外的一切（包括通过符号链接指向的内容）。被 .gitignore 忽略的文件只有在主持人主动共享时才会共享。检测到含有凭据的文件会以 脱敏且只读 的形式提供给访客。