Bind recovery to the original receipt and scope, verify the held file and MD5, persist strict restart checkpoints, and atomically refresh identity without reusing cloud authorization. Cover direct retry, replacement protection, stale journals, and transactional failures; record Linux validation limits. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
drosync POC source contract
当前上传内容校验采用 MD5,协议 v2 / 本地 schema 7;历史 SHA256 内容回执退出支持。切换步骤见 MD5 说明。
drosync is the supported one-way synchronization path from customer-owned local directories to Baidu Object Storage (BOS). It is not a mounted filesystem: v1 does not download, propagate remote deletion, merge file contents, preserve POSIX ownership/mode, follow symlinks, or create empty remote directories.
Frozen scope
- Control plane: existing Go API plus the
drosync-coordinatorasynchronous worker. - Client: Rust CLI, daemon, read-only Web report viewer, updater, and SQLite crash journal.
- UI:
/object-syncwith role-specific administration, operations, release, and audit surfaces. - Targets: Windows 10/11 x86_64, Ubuntu 22.04/24.04 x86_64/ARM64, and macOS 13+ arm64.
- Limits per session: 1,000,000 files, 1 TiB per object, 20 TiB total; 500 devices per organization and at most 16 client data requests per device.
- Retention: session/item 90 days, versions/audit 1 year, heads indefinitely, staging/multipart 24 hours, conflicts indefinitely.
Document map
- 中文用户使用手册
- Product requirements
- Architecture and state machines
- OpenAPI 3.1 contract
- Installation
- CLI reference
- Permissions and security
- Conflict runbook
- Audit dictionary
- Operations and SLO
- Disaster recovery
- Updates and rollback
- Test and acceptance matrix
- Decisions and external prerequisites
Safety invariant
A space starts blocked/unverified. A successful If-None-Match: * probe permits create-only operation. Original-key update is available only after conditional update and conditional multipart completion probes pass and an administrator explicitly confirms that the shared prefix has no platform-external writer. Any observed drift disables the space. The UI cannot bypass these gates.
当前入口约束:功能入口唯一性。CLI 是唯一操作入口;Web 只读;GUI 和旧命令别名退出支持。历史验收报告保留原始记录,不作为当前命令手册。