Teletype安装后需重启Atom才能激活，否则无法调用命令；服务已降级为只读模式，连接失败多因服务不可用；多人编辑错位源于CRDT同步延迟；推荐改用VS Code Live Share或atom-pair等替代方案。
Teletype 安装后打不开面板？先确认 Atom 是否已重启
Teletype 不是装完就自动激活的插件，apm install teletype 后必须重启 Atom 才能加载——这是新手最常卡住的第一步。不重启的话，按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）搜不到任何 Teletype 命令，界面也看不到「Teletype」菜单项。
- 重启前可检查是否真装上了：打开 Atom →
Cmd+,→ 左侧点「Packages」→ 搜索teletype，状态栏显示「Installed」才算成功 - 如果安装失败，常见原因是网络问题导致
apm无法拉取依赖，可临时换国内镜像源：apm config set registry https://npmmirror.com/ - Atom 1.60+ 版本已停止官方维护，若用新版系统（如 macOS Sequoia 或 Windows 11 24H2），可能因 Electron 兼容性问题根本无法启动 Teletype，此时建议改用 VS Code + Live Share
创建会话后协作者连不上？检查 ID 和服务端连接状态
Teletype 使用的是中心化服务（由 GitHub 运营的 teletype.atom.io），不是 P2P。生成的会话 ID 本质是服务端分配的唯一通道名，协作者必须能访问该服务才能加入。
- 会话 ID 是一串类似
tx-7a8b9c的字符串，复制时别漏掉开头的tx-；粘贴进命令面板执行Teletype: Join by ID时，ID 必须完全匹配，大小写敏感 - 如果提示「Failed to connect to Teletype service」，大概率是防火墙或公司代理拦截了
wss://teletype.atom.io的 WebSocket 连接，可尝试在终端运行curl -I https://teletype.atom.io看是否返回 200 - Teletype 服务自 2025 年底起已降级为只读模式，新用户注册受限，老账号也可能被限流——这不是你配置错了，是服务本身不可用了
多人编辑时文字错位、删除不生效？CRDT 同步机制有延迟和边界
Teletype 底层用的是 teletype-crdt 库，靠给每个字符打带时间戳的唯一 ID 来解决冲突，但它的「最终一致」不是实时的，尤其在网络抖动或高并发编辑时会明显感知到滞后。
- 输入一个字符后立刻按退格，可能删掉的是上一条远程插入的内容，而不是刚输的——因为本地操作和远程操作还没完成 CRDT merge
- 不要在 Teletype 里做「精细结构修改」，比如同时多人重排 JSON 字段顺序或调整缩进层级，CRDT 对块级操作支持弱，容易产生不可逆的乱序
- 想看同步状态，右下角状态栏会有
Teletype: Connected (3 users)提示，但没「正在同步中」这类反馈，一切靠肉眼观察光标位置和文本变化
替代方案比硬扛 Teletype 更实际
Teletype 的核心问题不是用法复杂，而是底层服务已不可靠、维护停滞、文档缺失。2026 年还在 Atom 里强推 Teletype，就像在用 IE 浏览器跑 WebRTC 应用。
- 如果只是两人快速看代码，直接用
ssh+tmux或screen共享终端，稳定且无依赖 - 如果需要完整 IDE 协同（断点、变量查看、终端共享），VS Code 的
Live Share插件已全面支持 Python/JS/TS 等语言，且服务由 Microsoft 运营，可用性远高于 Teletype - 如果非要用 Atom，
atom-pair插件反而更轻量——它走的是 Pusher 实时消息通道，2026 年仍维持基础功能，命令是AtomPair: Start A New Pairing Session
真正难的从来不是怎么连上，而是连上之后能不能稳住。Teletype 的设计逻辑没错，但它依赖的那个「原子化协同」基础设施，早就没人修了。
