# huawei-cloud-sync **Repository Path**: sunshinewithmoonlight/huawei-cloud-sync ## Basic Information - **Project Name**: huawei-cloud-sync - **Description**: 华为云空间本机 CLI:图库、备忘录、待办与录音迁移目录;复用授权 WebKit 会话 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-10 - **Last Updated**: 2026-11-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # huawei-cloud-sync 面向账号所有者的华为云空间本机 CLI,提供图库、备忘录、待办与录音迁移目录的操作入口。通过已有的授权 WebKit 会话访问消费者云私有接口,不是华为官方 SDK,也不是常驻同步服务。 ## 项目功能 | 模块 | 当前能力 | 限制 | |---|---|---| | 登录会话 | 检查、刷新、只读探测 | 依赖外部 `huawei-notepad-tasks` 登录 helper、macOS Keychain 与授权 WebKit profile | | 图库 | 分页列表、原图下载、上传及精确回读 | 没有通用删除命令;测试清理仅限本次唯一上传且校验通过的对象 | | 备忘录与待办 | 导出、导入、文字更新、提醒、完成状态、精确软删除 | 写入依赖最新 ETag;附件仅处理元数据 | | 录音 | Drive 迁移目录发现与下载入口 | 仅目标目录直属文件,不递归;真实录音文件下载 E2E 仍为 `PARTIAL` | | 安全 | 输出递归脱敏、未知写入结果不重放、下载续传与 SHA-256 校验 | 本地业务导出仍含用户数据,不应提交或公开 | 图库与备忘录等 `PASS` 仅指已有账号的历史验收,不承诺任意账号或未来上游兼容性。录音范围为空不代表账号全部来源都没有录音;旧接口仅作诊断,不能替代 Drive 权威来源。 ## 安装 需要 Python 3.9+;完整云端操作的支持环境是 macOS。**本仓库不包含外部登录 helper、Keychain 凭据或浏览器 profile**,单独克隆不等于已具备登录能力。先阅读 [部署与依赖](docs/setup.md)。 ```sh git clone https://gitee.com/sunshinewithmoonlight/huawei-cloud-sync.git cd huawei-cloud-sync python3 -m venv .venv .venv/bin/python -m pip install -e '.[browser,dev]' .venv/bin/python -m playwright install webkit .venv/bin/python -m hwcloudsync --help ``` 准备好外部 helper 后,按实际位置配置环境;下面是**示例值,不是程序默认值**: ```sh export HWCLOUD_SKILL_ROOT="$HOME/.agents/skills/huawei-notepad-tasks" export HWCLOUD_PYTHON="$PWD/.venv/bin/python" ./scripts/hwcloudsync auth refresh ./scripts/hwcloudsync auth probe ``` ## 使用 ```sh .venv/bin/python -m hwcloudsync photos list --limit 20 --json .venv/bin/python -m hwcloudsync photos download --output ./downloads/photos --limit 20 .venv/bin/python -m hwcloudsync notes export --output ./exports/notepad.json .venv/bin/python -m hwcloudsync notes import --input ./exports/notepad.json --dry-run .venv/bin/python -m hwcloudsync recordings list --json ``` 导入会产生云端写入,先检查 `--dry-run`;下载和导出文件只保留在本地。写入、提醒、删除和异常对账见 [操作说明](docs/operations.md)。 ## 配置模板 [.env.example](.env.example) 只提供可审阅的 shell 环境模板,不含密钥。程序**不会自动加载 `.env`**,需要手动导出变量或在审阅后用 shell 加载。外部 helper 与程序环境的具体默认路径、解释器选择和会话刷新契约见 [配置说明](docs/configuration.md)。 ## 文档入口 - [文档索引与职责](docs/README.md) - [架构与数据边界](docs/architecture.md) - [测试与发布验收](docs/testing.md) - [版本变更](CHANGELOG.md) / [迁移说明](docs/migrations.md) / [发布说明](docs/releases/v0.1.0.md) - [安全说明](SECURITY.md) / [历史验收与证据索引](docs/evidence.md) 历史账号级原始证据保留在本机,不纳入公开 Git;仓库仅提供历史范围说明和离线发布验证。 ## 责任边界 只可操作本人或已明确授权的账号。上游为非公开消费者 Web 接口,可能随时变化;写入前应自行备份并核对目标。项目不提供凭据管理、附件二进制同步、录音上传、自动冲突合并或后台调度。 本次仅将代码公开,未额外授予开源许可证;未经另行许可,不应将公开可见理解为获得任意再分发授权。