karuo-ai/01_卡资（金）/金仓_存储备份/UU远程/SKILL.md

name, description, triggers, owner, group, version, updated, memory_palace_path, memory_palace_slot

name	description	triggers	owner	group	version	updated	memory_palace_path	memory_palace_slot
UU远程	网易UU远程 macOS 安装、被控/主控、远程终端零手操装软件（Codex/插件/配置同步）。触发词：UU远程、远程安装、远程控制装软件、UU终端、OFFICE-INNER、DESKTOP-434GEGI。	UU远程、uu远程、网易UU远程、网易远程、远程桌面、远控Mac、UURemote、被控、主控、安装UU远程、远程安装、远程控制、UU终端、远程装软件、远程装Codex、OFFICE-INNER、DESKTOP-434GEGI	金仓	金	1.2	2026-06-07	卡若记忆宫殿/金殿/金仓厢/遥台	跨端远控：本机装客户端、开被控、主控连被控、终端自动化装软件

UU远程（网易 · 遥台）

官网：https://uuyc.163.com/ · 下载页：https://uuyc.163.com/download/
本机应用：/Applications/UURemote.app · Bundle ID：com.netease.uuremote

与 G10 局域网控制（ADB/scrcpy/RustDesk 局域网）互补：UU远程侧重 公网/账号体系 下多端远控 Mac（4K、低延迟、免费），适合外出用手机控家里/公司 Mac。

能力边界

能做	不能做 / 须用户
下载最新 macOS pkg、解压安装 App	pkg 完整安装（含系统 Daemon）需本机 管理员密码
复制 App 到 /Applications、注册用户 LaunchAgent	首次打开须在 GUI 登录网易账号、同意权限
打开客户端、检查进程/服务、排障	远程 解锁屏幕、输入登录密码 须卡若本人
记录版本号与安装包缓存路径	替代 SSH/VPN；不写入账号密码到仓库
远程终端零手操装软件（Windows 被控）	被控须在线+已登录；Mac 须开辅助功能给 Cursor；解锁密码须卡若
同步本机 Codex/插件/配置到被控	从 Mac ~/.codex 生成命令；禁止 LAN HTTP 拉包（UU 中继下常失败）

目录

UU远程/
├── SKILL.md
├── evolution/                     # 远程安装踩坑沉淀
├── 脚本/
│   ├── install_uu_remote_mac.sh   # 下载+安装 App+用户 Agent
│   ├── repair_uu_remote_mac.sh    # 修复 1001（拉起 Service）
│   ├── check_uu_remote.sh         # 状态检查
│   ├── uninstall_uu_remote_mac.sh # 卸载（可选）
│   ├── build_codex_deploy_phases.py      # 本机 ~/.codex → Codex 专用 phase
│   ├── build_uu_remote_phases.py         # ★ 通用 PS/目录同步 → phase
│   ├── uu_remote_terminal_paste.sh       # 粘贴到 UU 终端（会 activate）
│   ├── uu_remote_terminal_paste_silent.sh # 静默粘贴（不弹窗）
│   ├── uu_remote_open_terminal.sh        # 选设备并打开终端
│   ├── uu_remote_codex_deploy_auto.sh    # 顺序粘贴全部 phase
│   ├── uu_remote_install_codex.sh        # ★ 一键远程装 Codex
│   └── uu_remote_install_software.sh     # ★ 通用远程装软件/插件/配置
└── 安装包/                        # 缓存 pkg（可删，脚本会重下）

★ 远程终端 · 零手操装软件（Agent 默认）

卡若说「远程装 XX / 给 OFFICE-INNER 装 Codex」→ 直接执行，不问确认。
真源踩坑：evolution/2026-06-07_UU远程终端软件安装.md

一键 · 远程装 Codex（Windows 被控）

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本/uu_remote_install_codex.sh" OFFICE-INNER

设备名 = UU 左侧列表名（如 DESKTOP-434GEGI、OFFICE-INNER），须与终端窗口标题 终端 - <设备名> 一致。

流程（四步）

1. build_codex_deploy_phases.py — 读本机 ~/.codex，生成 /tmp/codex_phases_<设备>/phase*.txt
2. uu_remote_open_terminal.sh — UURemote 选中设备并开「更多→终端」
3. uu_remote_codex_deploy_auto.sh — AppleScript Cmd+V + Enter 顺序粘贴（phase1 等 180s npm）
4. UU 终端内验收 codex --version + codex login status

★ 通用 · 远程装任意软件/插件/配置

UU="/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本"

# 方式 A：自有 PowerShell 安装脚本
bash "$UU/uu_remote_install_software.sh" OFFICE-INNER --from-ps ./install.ps1

# 方式 B：同步本机配置目录到被控 %USERPROFILE%\.myapp
bash "$UU/uu_remote_install_software.sh" DESKTOP-434GEGI \
  --sync-dir "$HOME/.myapp_config" --remote-dir .myapp

# 方式 C：已生成 phase 目录
bash "$UU/uu_remote_install_software.sh" DESKTOP-434GEGI --phase-dir /tmp/my_phases

# 静默（终端已开、不弹窗）
SILENT=1 bash "$UU/uu_remote_install_software.sh" DESKTOP-434GEGI --phase-dir /tmp/my_phases

被控 OS	做法
Windows	build_uu_remote_phases.py → EncodedCommand 分段粘贴
Mac 被控	UU 终端 zsh；brew install / cp；勿 EncodedCommand
插件/配置	--sync-dir 或 Codex 同款 base64 写 %USERPROFILE%\.xxx

Gotchas（2026-06-07）

现象	原因	处理
iwr 无法连接远程服务器	Mac HTTP 仅局域网，UU 中继不可达	禁 HTTP 拉包；改 AppleScript 粘贴 EncodedCommand
Desktop 路径不存在 / 用户名乱码	固定 $env:USERPROFILE\Desktop\...	只用 $env:USERPROFILE / $env:TEMP
codex 静默无输出	缺 VC++ 运行库	phase1 已含 winget install Microsoft.VCRedist.2015+.x64
装了错误 npm 包	裸 codex 是 2012 老包	必须 @openai/codex
粘贴无反应	未开辅助功能 / 终端窗口未聚焦	系统设置→辅助功能→Cursor；确认窗口 终端 - 设备名
EncodedCommand 过长	单段超 ~20KB 终端截断	build_uu_remote_phases.py 自动切；auth 优先一次性 b64
Add-Content 参数错误	Add-Content Join-Path ... 语法	必须 -LiteralPath $p -Value '...'
静默粘贴无反应	终端窗口未开	uu_remote_terminal_paste_silent.sh 会 skip；需先开终端或 OPEN_TERMINAL=1

一键安装（Agent 默认执行）

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本/install_uu_remote_mac.sh"

流程：版本 API → CDN 下载 uuyc_*.pkg → 解压 Payload → 覆盖 /Applications/UURemote.app → 安装 ~/Library/LaunchAgents/com.netease.uuremote.agent.plist → open -a UURemote。

被控完整能力（需一次管理员）

被控后台服务在 LaunchDaemon（须 /Library/LaunchDaemons）：

sudo installer -pkg "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/安装包/uuyc_"*.pkg" -target /

或仅补 Daemon（App 已存在时）：

sudo cp "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/参考资料/com.netease.uuremote.daemon.plist" /Library/LaunchDaemons/
sudo launchctl bootstrap system /Library/LaunchDaemons/com.netease.uuremote.daemon.plist

系统设置（被控必开）：「隐私与安全性」→ 屏幕录制、辅助功能、完全磁盘访问（按客户端提示勾选 UURemote）。

状态检查

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本/check_uu_remote.sh"

常用命令

# 打开客户端
open -a UURemote

# 进程
pgrep -lf UURemote

# 用户 Agent
launchctl print gui/$(id -u)/com.netease.uuremote.agent 2>/dev/null | head -20

# 系统 Daemon（完整 pkg 安装后）
sudo launchctl print system/com.netease.uuremote.daemon 2>/dev/null | head -10

版本与下载源

项	值
版本查询 API	https://api.nrd.nie.163.com/api/v1/release/dl/4?channel=gwqd（302 → uuyc_{version}.pkg）
CDN 直链模式	https://a56.gdl.netease.com/uuyc_{version}.pkg
当前本机（2026-05-18）	4.23.0
最低系统	macOS 11.0+

排障

现象	处理
错误码 1001 / 无法连接服务器（界面红条）	多为 UURemoteService 未起（日志 XPC Echo failure, Remote Pid: 0、connectionNoFound）→ 执行 脚本/repair_uu_remote_mac.sh
无法被控、只能主控	跑完整 sudo installer 装 Daemon；检查屏幕录制/辅助功能
App 打不开	xattr -cr /Applications/UURemote.app 后重开
Agent 未起	bash 脚本/repair_uu_remote_mac.sh 或 launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.netease.uuremote.agent.plist
与 RustDesk 冲突	二选一常驻被控，或只保留一个 LaunchDaemon

1001 一键修复

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本/repair_uu_remote_mac.sh"

验收：日志出现 信令-streamer连接-成功了 且 pgrep -f UURemoteService 有进程。

卸载

bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/UU远程/脚本/uninstall_uu_remote_mac.sh"

关联技能

• G10 局域网控制：局域网 Android/投屏/RustDesk
• G07 服务器管理：SSH/宝塔远程机（非 GUI 桌面）
• G16 远程环境一键部署：远程机装 OpenClaw/飞书