开发笔记
从连接,到可恢复的操作。
整理 UP-Shell 开发过程中反复遇到的几个问题。内容是个人实践记录,需要结合实际环境理解。
01 同一概念,不同平台
电脑与手机都能围绕 SSH、SFTP 和 Linux 指标组织界面,但系统权限、输入方式和后台行为并不相同。桌面任务恢复与 Android 前台连接不能共用一条未经验证的承诺。
Android 使用独立触屏布局、系统文件选择器和 Keystore;桌面依赖系统 WebView 与本机安全存储。构建、模拟测试、真实设备操作和长时间运行要分别记录。
02 版本与安装的证据
版本号只是标识,不能证明安装成功。更新需要核对原签名、文件摘要和版本关系,并在真实系统上验收。迁移或排查问题前应保留原应用与本地资料。
03 先确认服务器是谁
首次 SSH 连接需要通过可信渠道核对主机指纹。已保存的指纹发生变化时应阻断连接,向服务器管理者核实;不能为了恢复连接而自动接受新指纹。
示例使用虚构主机,不收集访问者的服务器地址、密码或私钥。真实操作只能针对自己拥有或已获授权的设备。
04 让操作目标始终清楚
终端、文件面板和监控都绑定当前会话。切换服务器不能把旧任务的结果误写到新会话,也不能让重连自动重放此前输入的命令。
05 结果未知,不等于失败
SFTP 写入时连接中断,远端可能已经完成操作。界面需要保留原任务并提示核实,先确认目标文件与摘要,再决定是否重试。文件覆盖前明确范围,取消操作也应说明已完成的部分。
06 给模型明确的操作范围
模型可用于解释报错或整理步骤。涉及执行时,需要绑定当前目标、检查工具参数并让操作者确认关键动作。模型返回建议、工具执行和结果核验是不同阶段。
首页的模型交互是合成示意,不发送请求。已有客户端中可选的第三方模型会按用户配置接收输入与上下文,使用前应阅读对应服务说明。
07 恢复的是原任务
桌面任务恢复索引绑定原任务与服务器身份,重新连接后先核实状态,不创建一份相同任务来代替恢复。结果无法确认时应保留“待核实”,不能显示成功。
Android 锁屏、后台限制或网络切换可能中断连接;不能用桌面的测试结果推断手机能跨重启接回任务。
08 本机资料与备份
桌面工作区可通过加密文件备份,恢复前查看范围与差异。任务恢复索引与可搬运的工作区备份是不同资料。Android 当前未提供桌面式备份文件导出,迁移前应保留原设备并核实所需资料。
09 已有资料的后续处理
本站已停用原网页业务入口。此前形成的客户端账号与资料处理范围仍在隐私说明中披露,需要处理时可通过邮件提出申请。
记录不完整时
发现说明与实际行为不一致,可以提供页面位置、系统与复现步骤。请先去除敏感内容,再联系作者。