移动创作伴侣完整手册
第一次连接只需三步
1. 电脑选择要开放的项目目录
2. 启动移动创作伴侣并显示二维码
3. 手机扫码，在授权范围内浏览或编辑默认建议先使用只读权限。确认连接和目录无误后，再按需要开启编辑、创建、上传或删除。
移动创作伴侣把电脑上的写吗项目临时开放给同一 Wi‑Fi / 局域网中的手机或平板。它不是云盘，也不是公网多人协作平台；核心目标是让用户离开电脑后仍能浏览项目、记录灵感、编辑正文、上传媒体，并调用电脑端已经配置好的 AI。
适合的场景
沙发上校稿、外出前在手机记录灵感、拍照后直接上传项目、用平板继续写、调用 PC 本地模型整理选区。
不适合的场景
把端口直接暴露公网、多人同时字符级协作、替代企业网盘、在不可信公共 Wi‑Fi 中长期开放。
一、它与其他功能的关系
| 功能 | 定位 |
|---|---|
| 移动创作伴侣 | 个人跨设备访问；手机连接自己的 PC 写吗。 |
| 局域网项目协作 | 多位成员各自保留本地项目副本与个人历史。 |
| AI 客服与人工坐席 | 面向访客与客服人员的企业服务系统。 |
| ComfyUI | 图片、视频和工作流执行引擎，与移动伴侣并非同一插件。 |
二、第一次连接
- 在“设置 → 组件与插件”启用移动创作伴侣。
- 从左侧活动栏打开“移动”工作台，或在目录右键选择“在手机上浏览或编辑此目录”。
- 确认开放目录。第一次建议保持只读，只开启确实需要的权限。
- 启动服务，确保手机与电脑在同一 Wi‑Fi，并扫描二维码。
- 浏览和编辑成功后，再按需开启创建、上传、删除和“允许手机调用 PC AI”。
长期二维码不是固定网络地址。它保证访问令牌可复用；路由器重新分配电脑 IP、端口变化或切换网络后，仍可能需要重新展示二维码。
三、现在可以做什么
- 以可折叠文件树浏览安全白名单中的文本、Markdown 与 MDX；记忆展开目录、滚动位置和最后打开文件；
- 约 280ms 后自动把手机正文写回 PC 当前编辑器，并接收 PC 或其他设备的文件变化；
- 非重叠修改自动合并；重叠冲突优先保护手机输入，并把 PC 版本备份到
.xiema/mobile-conflicts； - 新建 Markdown、MDX、目录和灵感文件，上传图片或视频并插入项目相对引用；
- 选区长按显示 PC AI、粗体、斜体、下划线、高亮、删除线和复制；
- 手机端支持有序列表、无序列表、任务列表与引用回车续写；
- 调用电脑端本地或在线 AI，执行整理结构、润色、续写、精简、扩写、摘要或自定义任务；候选稿由用户确认后再替换、插入或追加；
- 可选择启动后自动开启，并使用保存在写吗加密凭据库中的长期令牌。
四、安全边界
- 默认同一局域网使用，不依赖云端中转；
- 路径限制在主动开放根目录内，禁止访问
.xiema、.git、.vs、隐藏目录和目录联接； - 不能删除开放根目录，不执行任意 HTML、JavaScript 或 JSX；
- 手机不会获得 AI API Key、模型端点或凭据文件；
- 当前同步不是字符级 CRDT，不应宣传为断网自动合并或公网多人实时协作；
- 可信家庭/办公室局域网可使用 HTTP + WebSocket；跨公网使用必须额外配置 VPN 或可信 HTTPS 网关。
五、常见问题
| 现象 | 检查 |
|---|---|
| 扫码打不开 | 手机与 PC 是否同一网络；Windows 防火墙；二维码中的 IP 是否仍为当前电脑地址；服务是否在运行。 |
| 只能看不能改 | 会话是否开启编辑权限；文件类型是否在白名单；文件是否只读。 |
| PC AI 按钮不可用 | 电脑端是否主动允许手机调用 PC AI；写吗是否已配置可用模型；AI 请求是否仍在执行。 |
| 旧二维码失效 | 令牌被重置、IP 或端口变化、服务目录更换，均需重新扫码。 |
| 出现 409 | 文件版本已改变。重新加载并对比冲突副本，不要强行覆盖。 |
六、当前支持范围
源码与版本说明显示主要功能已经实现并经过多轮静态校验：固定工作台、二维码、长期令牌、自动启动、目录树、实时同步、冲突副本、媒体上传、MDX 快捷插入、手机选区菜单和 PC AI 桥接均有对应实现与修复记录。
本次环境无法启动 Windows WPF 主程序和手机浏览器进行端到端连接。正式发布前应至少测试 Android 与 iOS 各一台设备、PC 与手机双向修改、同位置冲突、二维码重置、自动启动、媒体上传和 PC AI 写回。
移动创作伴侣：手机访问电脑项目
电脑端开启
- 安装并启用“移动创作伴侣”；
- 从活动栏打开移动工作台，或右键项目目录选择在手机上浏览/编辑；
- 确认开放根目录，第一次测试建议只读；
- 按需开启编辑、创建、上传和删除权限；
- 启动服务，用手机扫描当前二维码；
- 长期使用可启用长期二维码；自动启动需要单独开启。
手机端可做什么
- 浏览安全白名单中的文本、Markdown 和 MDX；
- 编辑当前文档、新建 Markdown、MDX、目录和灵感文件；
- 上传图片或视频，并插入项目相对引用；
- 选择文字后调用电脑端 AI，候选稿可替换、插入、追加或复制；
- WebSocket 实时接收文件变化、项目树变化和在线设备数量；
- 发生版本冲突时返回 409 并保护冲突副本，不无提示覆盖。
安全边界
- 默认只在同一 Wi-Fi / 局域网使用，不依赖云端中转；
- 使用随机令牌、到期时间和固定时间比较；
- 路径被限制在用户主动开放的根目录内；
- 禁止访问
.xiema、.git、.vs、隐藏目录和目录联接； - 不能删除开放根目录，也不执行任意 HTML、JavaScript 或 JSX；
- 当前同步是整篇文档版本同步与冲突保护，不是字符级 CRDT，不应当作公网多人实时协作系统。
连接失败：确认手机和电脑处于同一局域网、电脑未睡眠、防火墙允许写吗在专用网络通信，并重新扫描工作台当前二维码。IP 或端口变化后，即使长期令牌不变，二维码地址也需要更新。
配图占位：电脑端移动工作台
展示开放目录、权限、二维码、在线设备和启动/停止。
images/quick-start/23-mobile-desktop.png配图占位：手机端目录、编辑器与 PC AI
不要放真实私密项目内容。
images/quick-start/24-mobile-editor.png