05_使用教程_Pooon_XiangBei_OSS
输入“/”快速插入内容
05_使用教程_Pooon_XiangBei_OSS
05_使用教程_Pooon_XiangBei_OSS
用户4890用户4890今天修改
响备 OSS
一、使用教程
1. 安装程序
1.
拿到响备 OSS 安装压缩包（Pooon_XiangBei_OSS_latest.zip）后，右键点击压缩包 → 选择"解压到当前文件夹" → 看到解压出的程序文件夹。
2.
进入解压后的文件夹，找到 响备OSS.exe（或同名应用程序）→ 右键点击 → 选择"发送到 → 桌面快捷方式" → 桌面出现响备 OSS 图标。
3.
双击桌面图标启动程序 → 看到主界面打开，说明安装完成。
提示：本程序为绿色软件，无需运行安装向导，解压即可使用。如需卸载，直接删除整个程序文件夹即可。
2. 首次配置
第一次启动后，请按以下顺序完成配置，否则定时备份无法正常工作。
第 1 步：填写阿里云 OSS 信息
1.
在主界面点击"设置"页 → 看到 OSS 配置区域。
2.
填入 AccessKey ID → 填入 AccessKey Secret → 填入 Bucket 名称（默认 zaibei）→ 填入接入点地址（默认 oss-cn-hangzhou.aliyuncs.com）。
3.
点击"测试连接"按钮 → 看到"连接成功"提示，说明 OSS 信息正确；如果提示失败，请检查 ID、Secret、Bucket 名称是否拼写正确。
4.
点击"保存配置" → 看到"保存成功"提示，OSS 信息配置完成。
第 2 步：创建备份计划
1.
在主界面点击"备份计划"页 → 点击"新建计划"按钮 → 看到计划配置表单。
2.
填写计划名称（如"我的项目代码备份"） → 点击"选择目录"按钮 → 在弹出的文件夹选择器里选中要备份的本地文件夹 → 点击"确定"。
3.
在"OSS 存储位置"输入框中填写云端存放路径（如 backups/myproject/），或保留下拉框默认值。
4.
选择备份频率：可选"每隔 N 小时""每天指定时间""每周指定日期" → 按需填入具体时间点 → 看到下方出现预览说明（如"每天 09:00 自动备份"）。
5.
选择保留策略：可选"保留最近 N 份""保留最近 N 天""分层保留""永不删除" → 填入对应数量。
6.
根据需要勾选"启用空闲检测"（建议保持开启）→ 点击"保存计划" → 看到"计划已保存"提示，列表中出现新计划。
第 3 步：开启后台运行（可选但推荐）
1.
进入"设置"页 → 找到"开机自启动"选项 → 勾选启用。
2.
找到"关闭窗口时"选项 → 选择"最小化到托盘"（默认值，推荐）。
3.
点击"保存配置" → 关闭主窗口 → 看到右下角系统托盘出现响备 OSS 图标，说明程序已在后台运行。
3. 快速上手
立即触发一次备份
1.
在主界面"备份计划"列表中，找到刚才创建的计划 → 点击右侧"立即备份"按钮。
2.
看到状态变为"备份中" → 等待状态变为"备份成功" → 说明本次备份完成。
3.
如需查看结果，点击"查看日志" → 看到本次备份的详细过程，包括压缩、上传、跳过原因等。
检查是否有新版本
1.
进入"设置"页 → 找到"检查更新"按钮并点击。
2.
看到"已是最新版本"提示，说明无需更新；如果提示"发现新版本"，按提示关闭程序重新启动即可完成升级。
3.
升级完成后，原有配置和备份计划原样保留，无需重新设置。
启用群通知（可选）
1.
进入"设置"页 → 找到企业微信群通知区域。
2.
填入企业微信机器人 Webhook 地址 → 点击"测试发送"按钮 → 看到群内收到测试消息，且界面提示"验证成功"。
3.
勾选"备份成功通知""备份失败通知""跳过通知"中需要的项目 → 点击"保存配置" → 后续备份完成会自动推送到群。
二、常见问题
安装与启动类
Q1：双击 exe 没反应，程序打不开
现象：双击桌面图标后看不到主界面。
解决方法：
1.
右键点击任务栏空白处 → 选择"任务管理器" → 查看进程列表中是否已有 响备OSS.exe 在运行。
2.
如果有，说明程序已启动并最小化到托盘 → 点击右下角系统托盘的响备 OSS 图标即可恢复窗口。
3.
如果没有，右键点击 exe → 选择"以管理员身份运行" → 看是否能正常打开；若仍不行，请检查 Windows Defender 或第三方杀毒软件是否拦截了程序，将程序目录加入信任名单后重试。
Q2：启动时弹出"配置文件损坏"提示
现象：升级或异常关机后启动，提示配置文件无法读取。
解决方法：
1.
进入程序所在文件夹 → 找到 config.yaml 文件 → 将其重命名为 config.yaml.bak 备份。