同屏 0.1.2｜个人远程控制软件预览版

下载入口：https://go.dsn.cc

安装
Windows：运行 64 位 EXE 安装程序，适用于 Windows 10 / 11。
Mac：打开相应芯片的 DMG，将“同屏”拖入“应用程序”。Apple 芯片与 Intel 安装包不同。
当前安装包未配置商业代码签名证书，Mac 只有本地临时签名，没有 Apple 公证。系统可能要求你在“隐私与安全性”中确认来源并允许打开。不要关闭整个系统的安全保护。Windows 如提示来源未知，应先核对下载地址和 SHA256 校验值。

账号与设备
1. 保持服务地址 https://go.dsn.cc。
2. 首台电脑使用注册码创建账号，密码至少 12 个字符。注册后其他电脑登录同一账号即可。
3. 注册码单独交付给拥有者，不放在公开下载页。
4. “账号”可以填邮箱、手机号样式或英文账号。目前它是本软件的独立账号，不发送手机验证码，也没有微信登录。
5. 每台被控电脑首次在“设置与权限”中开启“允许同账号设备连接”。Mac 必须允许屏幕录制、辅助功能。权限变更后如提示需要，重启同屏。
6. 客户端需要保持运行。关闭窗口会留在菜单栏／托盘；彻底退出会断开。系统关机或睡眠后不能保证连接。

观看与控制
左侧勾选设备进入多屏观看，4/9/16 格分页；仅连接当前页面可见设备，减轻负载。上限表示布局，不保证任意电脑都能流畅播放 16 路。
多屏始终只观看。点击“查看单台”后仍默认只读，勾选“启用鼠标和键盘控制”并等到显示“正在控制”才可操作。
启用后鼠标和键盘只发给当前电脑；本地工具栏与输入框不向远端发键。
取消勾选、退出单台、切换电脑、最小化、应用失焦、断线会停止控制并释放已按下的键。
快捷释放：Ctrl+Shift+Esc（Windows）或 Command+Shift+Esc（Mac）。此组合可能被系统占用；始终也可点击“停止控制”。
中文或长段文字可用“发送文字”窗口输入，先在远端点击输入框，再发送。
Windows 中权限更高的管理员程序、UAC 界面可能无法操作；目前不承诺控制登录前的系统界面。

密码超时
设置支持 10 分钟、30 分钟、1 小时、2 小时和永久不重复验证。
输入账号密码验证后，最小化或临时离开不会立即要求再次输入；无操作时间仍继续计算。
页面交互、观看时移动鼠标及键盘操作会更新本应用的活动时间；仅网络心跳不会延长解锁。
到期后停止观看和控制，输入密码才能继续；本机接收来自其他已授权设备的连接不受本机观看界面锁定影响。
“永久”不会自动勾选控制框。显式锁定、退出账号、设备被撤销仍会停止访问。
登录凭据通过操作系统凭据加密存储，数据库保存密码校验值，不保存明文密码。

网络与服务器
账号和设备服务部署在 go.dsn.cc，画面优先通过 WebRTC 点对点传输，无法直连时使用已配置的 TURN 中继。
若网络安全组尚未放行，中继不会生效：TCP 3478、5349；UDP 3478、49160—49199。
设备列表在线并不等于媒体通道已连通。连接后的卡片底部会标示直连／中继与往返延时。
服务数据库是独立 SQLite 数据库，位于服务器私有数据目录，不在公开网站目录内。
服务器重启会中断已有连接，客户端随后重连；默认会要求重新确认控制框。

当前范围
Mac / Windows 安装包，同账号设备管理、只读多屏、单台明确授权控制、超时解锁、连接重试、撤销设备。
共享主显示器；没有远程文件传输、音频、系统登录前控制、远程开机或手机客户端。
已完成的检查详见交付测试记录。生成 Windows 安装包不等于 Windows 真机操作验收，首次安装后需进行 Mac→Windows 与 Windows→Mac 的双向测试。

源代码
npm ci
npm test
npm start
服务端要求 Node.js 22.22.3 或兼容的更新版本；npm run server 可运行本地测试服务。
生产服务启动脚本与部署过程保存在项目过程文件中，凭据不包含在源码包内。

构建所有平台前运行：node scripts/prepare-native.cjs。它会从官方 npm 源按完整性校验下载各目标平台的原生组件；只安装当前 Mac 依赖不足以生成可控制的 Windows 包。