diff --git a/common/FileTransferV2.h b/common/FileTransferV2.h index 97abf82..295fe72 100644 --- a/common/FileTransferV2.h +++ b/common/FileTransferV2.h @@ -25,9 +25,11 @@ #include #include #include +#include #include #include #include +#include #include #include #include @@ -164,11 +166,15 @@ public: // 处理 V2 文件数据包 // 返回: 0=成功, >0=错误码 - static int RecvFileChunkV2(const uint8_t* buf, size_t len, uint64_t myClientID) + // reply:主连接(Linux 传 g_pMainClient)。非空时,C2C 传输的最后一个条目处理完会回一包 + // 落盘结果(TOKEN_C2C_SEND_RESULT),服务端据此把 receiver_ack 变成真实值; + // 传 nullptr(macOS 目前没有全局主连接)则保持旧行为,不发回执。 + static int RecvFileChunkV2(const uint8_t* buf, size_t len, uint64_t myClientID, + IOCPClient* reply = nullptr) { // 检查是否是 FILE_COMPLETE_V2 包 if (len >= 1 && buf[0] == COMMAND_FILE_COMPLETE_V2) { - return HandleFileComplete(buf, len, myClientID); + return HandleFileComplete(buf, len, myClientID, reply); } if (len < sizeof(FileChunkPacketV2)) { @@ -210,10 +216,10 @@ public: for (char& c : relPath) { if (c == '\\') c = '/'; } - // 移除盘符前缀 (如 C:/) - if (relPath.size() >= 3 && relPath[1] == ':' && relPath[2] == '/') { + // 移除盘符前缀 (如 C:/)——只认「字母 + 冒号」,否则 /:data 这类合法路径会被改写 + if (relPath.size() >= 3 && isalpha((unsigned char)relPath[0]) && relPath[1] == ':' && relPath[2] == '/') { relPath = relPath.substr(3); - } else if (relPath.size() >= 2 && relPath[1] == ':') { + } else if (relPath.size() >= 2 && isalpha((unsigned char)relPath[0]) && relPath[1] == ':') { relPath = relPath.substr(2); } // 移除开头的 / @@ -228,8 +234,8 @@ public: for (char& c : savePath) { if (c == '\\') c = '/'; } - // 移除盘符前缀 (如 C:/) - if (savePath.size() >= 3 && savePath[1] == ':' && savePath[2] == '/') { + // 移除盘符前缀 (如 C:/)——只认「字母 + 冒号」,否则 /:data 这类合法路径会被改写 + if (savePath.size() >= 3 && isalpha((unsigned char)savePath[0]) && savePath[1] == ':' && savePath[2] == '/') { savePath = savePath.substr(2); } // 确保以 / 开头 @@ -241,7 +247,14 @@ public: // 目录处理 if (pkt->flags & FFV2_DIRECTORY) { MakeDirs(savePath + "/dummy"); + // MakeDirs 不回报 mkdir 的失败(它还要给服务端下载复用),这里单独确认一次: + // 目录没建成也要让回执带上 errno,否则会向服务端谎报成功。 + struct stat st; + int mkErr = 0; + if (stat(savePath.c_str(), &st) != 0) mkErr = errno ? errno : EIO; + else if (!S_ISDIR(st.st_mode)) mkErr = EIO; Mprintf("[V2 Recv] Created directory: %s\n", savePath.c_str()); + FinishC2CItem(pkt, reply, myClientID, false, true, 0, mkErr); return 0; } @@ -250,9 +263,11 @@ public: // 获取或创建接收状态 uint64_t stateKey = pkt->transferID ^ ((uint64_t)pkt->fileIndex << 48); - RecvState* state = GetOrCreateState(stateKey, pkt, savePath); + int openErr = 0; + RecvState* state = GetOrCreateState(stateKey, pkt, savePath, &openErr); if (!state) { Mprintf("[V2 Recv] Failed to create state\n"); + FinishC2CItem(pkt, reply, myClientID, true, IsFinalChunk(pkt), 0, openErr ? openErr : EIO); return 5; } @@ -260,7 +275,9 @@ public: const char* data = (const char*)buf + sizeof(FileChunkPacketV2) + pkt->nameLength; if (lseek(state->fd, pkt->offset, SEEK_SET) == -1) { - Mprintf("[V2 Recv] lseek failed: errno=%d\n", errno); + int e = errno; + Mprintf("[V2 Recv] lseek failed: errno=%d\n", e); + FinishC2CItem(pkt, reply, myClientID, true, IsFinalChunk(pkt), 0, e); return 6; } @@ -270,7 +287,9 @@ public: ssize_t n = write(state->fd, data + written, toWrite - written); if (n <= 0) { if (errno == EINTR) continue; - Mprintf("[V2 Recv] write failed: errno=%d\n", errno); + int e = errno; + Mprintf("[V2 Recv] write failed: errno=%d\n", e); + FinishC2CItem(pkt, reply, myClientID, true, IsFinalChunk(pkt), 0, e); return 7; } written += n; @@ -292,6 +311,15 @@ public: // 文件完成 if (isLast) { + // 落盘长度自检:写到一半失败过、或偏移被改写,都会在这里落成「长度不符」 + struct stat st; + int szErr = 0; + if (fstat(state->fd, &st) != 0) szErr = errno ? errno : EIO; + else if ((uint64_t)st.st_size != pkt->fileSize) szErr = EIO; + + // 记账 + 最后一个条目时回执(要在拿 s_statesMtx 之前做:里面会 Send2Server) + FinishC2CItem(pkt, reply, myClientID, true, true, pkt->fileSize, szErr); + close(state->fd); state->fd = -1; Mprintf("[V2 Recv] File complete: %s\n", savePath.c_str()); @@ -306,7 +334,8 @@ public: } // 处理文件完成校验包 - static int HandleFileComplete(const uint8_t* buf, size_t len, uint64_t myClientID) + static int HandleFileComplete(const uint8_t* buf, size_t len, uint64_t myClientID, + IOCPClient* reply = nullptr) { if (len < sizeof(FileCompletePacketV2)) { return 1; @@ -322,6 +351,9 @@ public: Mprintf("[V2] File complete verify: transferID=%llu, fileIndex=%u, size=%llu\n", pkt->transferID, pkt->fileIndex, pkt->fileSize); + // 空文件不发任何数据块(worker 只发这个完成包),C2C 回执只能靠它把该条目算作已处理 + NoteC2CComplete(pkt, reply, myClientID); + // TODO: 实现 SHA-256 校验 // 目前简单返回成功 return 0; @@ -663,7 +695,7 @@ public: private: static RecvState* GetOrCreateState(uint64_t key, const FileChunkPacketV2* pkt, - const std::string& savePath) + const std::string& savePath, int* openErrno = nullptr) { std::lock_guard lock(s_statesMtx); @@ -682,6 +714,7 @@ private: // 打开文件 state->fd = open(savePath.c_str(), O_WRONLY | O_CREAT | O_TRUNC, 0644); if (state->fd < 0) { + if (openErrno) *openErrno = errno; // errno 会被下面的 Mprintf 冲掉,先存 Mprintf("[V2 Recv] open failed: %s, errno=%d\n", savePath.c_str(), errno); return nullptr; } @@ -691,6 +724,111 @@ private: return ptr; } + // ===== C2C 接收回执 ===== + // C2C 的目标端不再只是「收包落盘」:本次传输的每个条目都定案后回一包 + // C2CSendResultPacket(TOKEN_C2C_RECV_RESULT,与源端的 175 分开,免得两种语义混在一个 token 里), + // 把「是否真的写进去了」告诉服务端。Windows 目标端没有这个能力,服务端对它们保持旧语义。 + // + // 条目定案的三个来源(缺一不可): + // 1) 目录项:worker 发的 FFV2_DIRECTORY 包(不带 LAST_CHUNK); + // 2) 非空文件:最后一块写盘成功(再 fstat 核对长度); + // 3) 空文件:worker 不发任何数据块,只发 COMMAND_FILE_COMPLETE_V2。 + // 源端的重发(最多 3 次)和「最后一块 + 完成包」都会重复命中同一 fileIndex,用 done 集合去重。 + struct RecvProgress { + uint32_t totalFiles = 0; // 从任意数据块/目录包学到(完成包里没有这个字段) + std::set doneFiles; // 已定案的文件 fileIndex + std::set doneDirs; // 已定案的目录项 fileIndex + uint64_t bytes = 0; // 实收文件字节数 + bool failed = false; + int firstErrno = 0; + }; + + static bool IsFinalChunk(const FileChunkPacketV2* pkt) + { + return (pkt->flags & FFV2_LAST_CHUNK) != 0; + } + + static uint8_t MapErrnoToFileError(int e) + { + switch (e) { + case EACCES: + case EPERM: + case EROFS: return FEV2_ACCESS_DENIED; + case ENOENT: + case ENOTDIR: return FEV2_FILE_NOT_FOUND; + case ENOSPC: return FEV2_DISK_FULL; + default: return FEV2_WRITE_FAILED; + } + } + + // 记录一个条目的处理结果;finalChunk 表示这一包关掉了该条目(文件的最后一块 / 目录项 / 完成包)。 + // 所有条目都定案后就发回执。err != 0 表示这一条目失败(errno 原样带给服务端)。 + static void FinishC2CItem(const FileChunkPacketV2* pkt, IOCPClient* reply, uint64_t myClientID, + bool isFile, bool finalChunk, uint64_t bytes, int err) + { + if (pkt->dstClientID == 0 || reply == nullptr) return; // 服务端上传/下载、或没有回执通道 + + C2CSendResultPacket res = {}; + { + std::lock_guard lk(s_recvProgressMtx); + // 传输中途断掉时条目会残留:攒多了整体清一次(残留的都是已废弃的 transferID) + if (s_recvProgress.size() > 32) s_recvProgress.clear(); + RecvProgress& e = s_recvProgress[pkt->transferID]; + if (pkt->totalFiles != 0) e.totalFiles = pkt->totalFiles; // 完成包里没有,沿用学到的值 + + if (err != 0) { + e.failed = true; + if (e.firstErrno == 0) e.firstErrno = err; + } + if (finalChunk) { + if (isFile) { + if (e.doneFiles.insert(pkt->fileIndex).second && err == 0) e.bytes += bytes; + } else { + e.doneDirs.insert(pkt->fileIndex); + } + } + + const bool finished = e.totalFiles != 0 + && e.doneFiles.size() + e.doneDirs.size() >= e.totalFiles; + if (!finished) return; + + res.cmd = (uint8_t)TOKEN_C2C_RECV_RESULT; + res.transferID = pkt->transferID; + res.dstClientID = myClientID; // 服务端按连接身份 + dstClientID 双重核对 + res.status = e.failed ? (uint32_t)MapErrnoToFileError(e.firstErrno) + : (uint32_t)FEV2_OK; + res.win32err = (uint32_t)e.firstErrno; // 176 包里放的是 errno,不是 win32 码 + res.workerRc = 0; // 恒 0:不是源端 worker 返回码 + res.fileCount = (uint32_t)e.doneFiles.size(); + res.totalBytes = e.bytes; + s_recvProgress.erase(pkt->transferID); + } + + // 锁外发送:Send2Server 可能阻塞,不应占着进度表 + if (reply->IsConnected() && reply->Send2Server((char*)&res, sizeof(res))) { + Mprintf("[V2 Recv] C2C ack: transferID=%llu, files=%u, bytes=%llu, status=%u, errno=%u\n", + (unsigned long long)res.transferID, res.fileCount, + (unsigned long long)res.totalBytes, res.status, res.win32err); + } else { + Mprintf("[V2 Recv] C2C ack send failed: transferID=%llu\n", + (unsigned long long)res.transferID); + } + } + + // COMMAND_FILE_COMPLETE_V2:空文件的唯一「定案」来源(也用来给已定案的非空文件去重) + static void NoteC2CComplete(const FileCompletePacketV2* cp, IOCPClient* reply, uint64_t myClientID) + { + if (cp->dstClientID == 0 || reply == nullptr) return; + FileChunkPacketV2 probe = {}; + probe.cmd = COMMAND_SEND_FILE_V2; + probe.transferID = cp->transferID; + probe.dstClientID = cp->dstClientID; + probe.fileIndex = cp->fileIndex; + probe.totalFiles = 0; // 完成包没有 totalFiles,沿用进度表里学到的 + probe.fileSize = cp->fileSize; + FinishC2CItem(&probe, reply, myClientID, true, true, 0, 0); // 空文件 bytes=0 + } + // 接收状态存储 static inline std::map> s_states; static inline std::mutex s_statesMtx; @@ -698,4 +836,8 @@ private: // C2C 目标目录存储 static inline std::map s_targetDirs; static inline std::mutex s_targetDirMtx; + + // C2C 接收进度(按 transferID;定案发完回执即删) + static inline std::map s_recvProgress; + static inline std::mutex s_recvProgressMtx; }; diff --git a/common/commands.h b/common/commands.h index 8464e49..b589575 100644 --- a/common/commands.h +++ b/common/commands.h @@ -137,6 +137,7 @@ inline int isValid_10s() // 无此位 = 老客户端,按系统 ANSI(默认 CP936)解读 #define CLIENT_CAP_SCREEN_PREVIEW 0x0004 // 支持屏幕预览(双击在线主机时弹缩略图) #define CLIENT_CAP_C2C_PATHS 0x0008 // 支持按路径清单向另一客户端发送文件(COMMAND_C2C_SEND_FILES,仅 Windows) +#define CLIENT_CAP_C2C_RECV_ACK 0x0010 // 作为 C2C 目标端时,落盘完成后回执(TOKEN_C2C_RECV_RESULT,目前仅 Linux) #define TALK_DLG_MAXLEN 1024 // 最大输入字符长度 @@ -339,9 +340,11 @@ enum { TOKEN_DOWNLOAD_ERROR = 173, // [token:1][win32err:4 LE] 下载请求无可用文件(路径全部不存在) // MCP C2C 文件传输(服务端 → 源客户端 → 目标客户端;数据由服务端原样中继)。 - // 只有声明 CLIENT_CAP_C2C_PATHS 的新客户端认识这两个值,老客户端走 default 丢弃。 + // COMMAND_C2C_SEND_FILES / TOKEN_C2C_SEND_RESULT 只有声明 CLIENT_CAP_C2C_PATHS 的新客户端认识; + // TOKEN_C2C_RECV_RESULT 由声明 CLIENT_CAP_C2C_RECV_ACK 的目标端回发,老服务端走 default 丢弃。 COMMAND_C2C_SEND_FILES = 174, // [C2CSendFilesPacket][targetDir\0][path1\0]...[\0] TOKEN_C2C_SEND_RESULT = 175, // [C2CSendResultPacket] 源客户端回传的发送结果 + TOKEN_C2C_RECV_RESULT = 176, // [C2CSendResultPacket] 目标客户端回传的落盘回执(win32err 放 errno) TOKEN_DECRYPT = 199, TOKEN_REGEDIT = 200, // 注册表 @@ -1111,6 +1114,10 @@ typedef struct LOGIN_INFOR { #ifdef _WIN32 caps |= CLIENT_CAP_SCREEN_PREVIEW; caps |= CLIENT_CAP_C2C_PATHS; +#elif defined(__linux__) && !defined(__ANDROID__) + // Linux 客户端作为 C2C 目标端时会回执落盘结果(common/FileTransferV2.h)。 + // macOS 暂未接线(无全局主连接句柄),不声明——服务端就不会为它空等回执。 + caps |= CLIENT_CAP_C2C_RECV_ACK; #endif sprintf_s(moduleVersion, "%s-%04X", DLL_VERSION, caps); } diff --git a/common/file_upload.h b/common/file_upload.h index 091fb4f..d18fb4c 100644 --- a/common/file_upload.h +++ b/common/file_upload.h @@ -114,17 +114,18 @@ struct C2CSendFilesPacket { // char path1[...]; '\0'; ...; // 源端绝对路径(文件或目录),列表以空串结束:额外一个 '\0' }; // 106 bytes + 字符串 -// C2C 路径清单发送结果(源客户端 → 服务端) +// C2C 结果包:源客户端 → 服务端(TOKEN_C2C_SEND_RESULT,发送结果) +// 或 目标客户端 → 服务端(TOKEN_C2C_RECV_RESULT,落盘回执;win32err 位置放 errno,workerRc 恒 0) struct C2CSendResultPacket { - uint8_t cmd; // TOKEN_C2C_SEND_RESULT = 175 + uint8_t cmd; // TOKEN_C2C_SEND_RESULT = 175 / TOKEN_C2C_RECV_RESULT = 176 uint64_t transferID; // 对应请求的 transferID uint64_t dstClientID; // 目标客户端 uint32_t status; // 0=已全部发送;FEV2_* 失败码;1001=发送线程失败(见 workerRc) uint32_t win32err; // status=FEV2_FILE_NOT_FOUND/ACCESS_DENIED 时的首个 win32 码 int32_t workerRc; // FileBatchTransferWorkerV2 返回值(0=成功) uint32_t fileCount; // 实际发出的文件数(不含目录项) - uint64_t totalBytes; // 实际发出的文件字节数 -}; // 45 bytes + uint64_t totalBytes; // 实际发出的(回执里是实际落盘的)文件字节数 +}; // 41 bytes(#pragma pack(1)) // V2 文件完成校验包 struct FileCompletePacketV2 { @@ -157,6 +158,7 @@ enum FileErrorV2 : uint8_t { FEV2_TRANSFER_CANCEL = 6, // 传输被取消 FEV2_CHECKSUM_ERROR = 7, // 校验和错误(块级CRC) FEV2_HASH_MISMATCH = 8, // 哈希不匹配(文件级SHA-256) + FEV2_WRITE_FAILED = 9, // 接收端写盘失败(POSIX 端 errno 无法归类时用它,明细在 win32err) }; // V2 续传查询包(发送方在传输前发送) diff --git a/docs/Mcp_Design.md b/docs/Mcp_Design.md index efca347..209c843 100644 --- a/docs/Mcp_Design.md +++ b/docs/Mcp_Design.md @@ -840,8 +840,9 @@ Debug 实例(`Bin\Yama_x64d.exe`,临时端口)实测:`list_all_hosts` 第 54 个工具:把文件从一台客户端**直接**发到另一台,服务端只做包中继,不落盘。复用 V2 文件传输的 C2C 通道(`FileChunkPacketV2.dstClientID != 0`),新增协议号 `COMMAND_C2C_SEND_FILES=174`(服务端给源端下路径清单)、`TOKEN_C2C_SEND_RESULT=175`(源端回传发送结果),以及能力位 `CLIENT_CAP_C2C_PATHS=0x0008`(老客户端因此被提前拒绝并提示升级)。 -- 工具契约:`src_id` / `dst_id` / `paths[]` / `dst_dir` / 可选 `timeout_ms`;返回 `transfer_id` / `file_count` / `total_bytes` / `receiver_ack`(恒为 `false`,V2 的完成校验在接收方做但没有回执)。 +- 工具契约:`src_id` / `dst_id` / `paths[]` / `dst_dir` / 可选 `timeout_ms`;返回 `transfer_id` / `file_count` / `total_bytes` / `receiver_ack`。 - 开关:`McpFileTransfer=1 && McpReadonly=0`(会写远程),注解登记为破坏性 + 非只读,`McpInternal` 的 gating 表同步。 -- 两端都必须是 Windows 客户端(`-32005`):目标端也限制,是因为 `dst_dir` 由源端拼进 V2 块的文件名,非 Windows 接收端拿不到目标目录会写到错误位置。 +- 源端必须是 Windows 客户端(`-32005`);目标端可以是 Windows / Linux / macOS(2026-10-27 起)。POSIX 目标给绝对 POSIX `dst_dir`(`/tmp/recv`),服务端在建会话前校验形态,非法 `-32602`。 +- `receiver_ack`:Linux 目标端落盘后会回一包 `TOKEN_C2C_RECV_RESULT=176`(能力位 `CLIENT_CAP_C2C_RECV_ACK=0x0010`),`true` 表示目标端确认写入、`total_bytes` 是实收值;写入失败统一 `-32011`(带 status/errno)。Windows/macOS 目标端不回执,仍为 `false`,需 `list_files` 复核。 - 实施中一个坑:服务端既有的 C2C 中继分支会在源端子连接上挂进度对话框,而 `NotifyProc` 对挂了 `hDlg` 的连接会把后续包交给对话框——源端最后那包结果就被当 V1 文件块吃掉,工具只能超时。现按「该 host 是否有 MCP 的 C2C 会话」跳过对话框,MFC 手动 C2C 不变。 -- 协议细节、落盘路径语义(`dst_dir` + 相对公共父目录)、错误码映射、限制与实测见 [Mcp_FileTransfer_Design.md](./Mcp_FileTransfer_Design.md) §14。 +- 协议细节、落盘路径语义(`dst_dir` + 相对公共父目录,Windows 与 POSIX 两种目标端)、回执与错误码映射(含 `-32011`)、限制与实测见 [Mcp_FileTransfer_Design.md](./Mcp_FileTransfer_Design.md) §14。 diff --git a/docs/Mcp_FileTransfer_Design.md b/docs/Mcp_FileTransfer_Design.md index caae750..9c58861 100644 --- a/docs/Mcp_FileTransfer_Design.md +++ b/docs/Mcp_FileTransfer_Design.md @@ -415,17 +415,19 @@ int n = RecvFileChunkV2((char*)szBuffer, ulLength, m_conn, nullptr, m_hash, m_hm ### 14.2 协议(`common/commands.h` / `common/file_upload.h`) ```cpp -CLIENT_CAP_C2C_PATHS 0x0008 // LOGIN_INFOR 能力位,仅 Windows 客户端置位 +CLIENT_CAP_C2C_PATHS 0x0008 // LOGIN_INFOR 能力位,仅 Windows 客户端置位(源端) +CLIENT_CAP_C2C_RECV_ACK 0x0010 // 作为目标端会回执落盘结果,目前仅 Linux 客户端置位(macOS 不置位) COMMAND_C2C_SEND_FILES = 174, // 服务端 → 源客户端主连接 TOKEN_C2C_SEND_RESULT = 175, // 源客户端 → 服务端(源端自开的传输子连接上) +TOKEN_C2C_RECV_RESULT = 176, // 目标客户端 → 服务端(目标端主连接上) ``` | 包 | 布局 | 说明 | |---|---|---| | `C2CSendFilesPacket` | `cmd(1) transferID(8) srcClientID(8) dstClientID(8) hash(64) hmac(16) flags(1)` = 106 B | 后接 `dst_dir\0`,再是 `path1\0 … pathN\0`,以额外一个 `\0` 结束(ANSI/936) | -| `C2CSendResultPacket` | `cmd(1) transferID(8) dstClientID(8) status(4) win32err(4) workerRc(4) fileCount(4) totalBytes(8)` = 45 B | `status`:0=全部发出、`FEV2_FILE_NOT_FOUND`/`FEV2_ACCESS_DENIED`(带首个 win32 码)、1001=发送线程失败(看 `workerRc`) | +| `C2CSendResultPacket` | `cmd(1) transferID(8) dstClientID(8) status(4) win32err(4) workerRc(4) fileCount(4) totalBytes(8)` = 41 B(`#pragma pack(1)`) | 175:`status` 0=全部发出、`FEV2_FILE_NOT_FOUND`/`FEV2_ACCESS_DENIED`(带首个 win32 码)、1001=发送线程失败(看 `workerRc`)。176:`status` 0=全部落盘成功,否则为映射后的 `FEV2_*`;`win32err` 位置放**首个 errno**;`workerRc` 恒 0 | -老客户端不认识 174(服务端按 `CLIENT_CAP_C2C_PATHS` 提前拒绝,`-32005` 提示升级);老服务端不认识 175,走 `default` 丢弃,无兼容风险。 +老客户端不认识 174(服务端按 `CLIENT_CAP_C2C_PATHS` 提前拒绝,`-32005` 提示升级);老服务端不认识 175/176,走 `default` 丢弃,无兼容风险。回执用**独立的 176**而不是复用 175:同一台主机可能同时是 A 传输的目标端和 B 传输的源端,复用会让服务端把回执误当成源端结果去 latch `done`。 ### 14.3 客户端(`client/KernelManager.cpp`) @@ -439,29 +441,41 @@ TOKEN_C2C_SEND_RESULT = 175, // 源客户端 → 服务端(源端自开 - **会话**:`BeginC2CTransfer(src, dst, transferID)` 把会话键在**源**设备上(`tool="copy_files_c2c"`、`dstClientID`),与 `m_Pending`、目标端文件会话双向互斥;`WaitC2CDone` 只等源端那包结果,**没有停滞看门狗**(源端全程只在最后回一包,大文件中途静默是正常的),只有总超时。 - **中继**:完全复用 `COMMAND_SEND_FILE_V2` / `COMMAND_FILE_COMPLETE_V2` 的 `dstClientID != 0` 分支,零改动。 - **必须抑制源端的进度对话框**(实施中踩到的坑):该分支原本会在源端子连接上挂一个 `CDlgFileSend` 显示进度。而 `NotifyProc` 对**挂了 `hDlg` 的连接**会把后续包交给对话框的 `OnReceiveComplete`——源端最后那包 175 就被当成 V1 文件块解析(服务端 trace 里是 `RecvFileChunk failed: 3`),MCP 侧只会超时。现在用 `IsC2CTransferPending(src, dst)` 判定:MCP 发起的 C2C 不建对话框,包照常落到 `MessageHandle`;MFC 手动 C2C(Ctrl+V / 文件管理器)行为完全不变。 -- **落盘位置**:目标端收到的目录是 `dst_dir`,文件名取各路径**相对公共父目录**的部分(库内 `GetCommonRoot` 语义)。例如发 `D:\data\a.txt` 与 `D:\data\sub\`,目标是 `C:\backup`,则得到 `C:\backup\a.txt`、`C:\backup\sub\b.bin`;`dst_dir` 不存在时由接收端自动创建。目标端是 Linux/macOS 时上述语义不成立(见 14.6),工具在建会话前就拒绝。 +- **落盘位置**:目标端收到的目录是 `dst_dir`,文件名取各路径**相对公共父目录**的部分(库内 `GetCommonRoot` 语义)。例如发 `D:\data\a.txt` 与 `D:\data\sub\`,目标是 `C:\backup`,则得到 `C:\backup\a.txt`、`C:\backup\sub\b.bin`;`dst_dir` 不存在时由接收端自动创建。 + - **Windows 目标**:`dst_dir` 必须是绝对 Windows 路径(`C:\backup`),服务端补尾部 `\` 后交给源端拼接。 + - **Linux/macOS 目标**:`dst_dir` 必须是绝对 POSIX 路径(`/home/user/incoming`、`/tmp/recv`),不得含 `\`。源端仍然只是把 `dst_dir` 与相对路径**纯字符串拼接**(`targetDir + relPath`,库内不经过任何 Windows 路径 API),因此得到 `"/tmp/recv\sub\b.bin"`;POSIX 接收端 `GetTargetDir()` 为空时会把 `\` 归一化成 `/`、去盘符、补前导 `/` 再 `MakeDirs`,正好落到 `/tmp/recv/sub/b.bin`。这条路径不需要改 Windows 客户端。 + - 目标端类型来自 `RES_CLIENT_TYPE`(`LNX`/`MAC` 视为 POSIX),服务端在**建会话前**校验形态,不合法直接 `-32602`。 +- **目标端回执**:目标端声明 `CLIENT_CAP_C2C_RECV_ACK`(当前只有 Linux)时,服务端在源端结果之后再 `WaitC2CReceiver`(≤5 s,250 ms 切片)等一包 176;没有该能力位的目标端(Windows、macOS、老客户端)直接跳过,不增加任何延迟。回执状态记在 `FileTransferSession` 的 `recv*` 字段,与源端的 `done/status` 互不覆盖。 ### 14.5 工具契约 -入参:`src_id`、`dst_id`(必填,且不得相同)、`paths`(必填,文件或目录,1..N)、`dst_dir`(必填,绝对路径)、`timeout_ms`(默认 600000,上限 3600000)。 +入参:`src_id`、`dst_id`(必填,且不得相同)、`paths`(必填,文件或目录,1..N,源端 Windows 绝对路径)、`dst_dir`(必填,绝对路径;Windows 目标用 `C:\x`,Linux/macOS 目标用 `/x`)、`timeout_ms`(默认 600000,上限 3600000)。 出参(`structuredContent`):`transfer_id`、`src_id`、`dst_id`、`dst_dir`、`file_count`、`total_bytes`、`receiver_ack`。 +`receiver_ack` 三种取值: +- `true` 且 `status==0`:目标端已确认全部条目落盘(`file_count`/`total_bytes` 是**目标端实收**值,与源端统计一致)。 +- `false`:目标端不支持回执(Windows/macOS/老客户端),或目标端中途断线——源端只保证「包已全部发出」,请用 `list_files` 复核。 +- 目标端回执报错时工具**不返回** `structuredContent`,而是下面的 `-32011` 错误。 + | 码 | 触发 | |---|---| -| `-32602` | 缺参 / id 非法 / 源目标相同 / `paths`、`dst_dir` 含 `..` 段或编码无法转 936 | +| `-32602` | 缺参 / id 非法 / 源目标相同 / `paths`、`dst_dir` 含 `..` 段或内嵌 NUL / 编码无法转 936 / POSIX 目标的 `dst_dir` 不是绝对 `/…` 或含 `\` | | `-32002` | 源或目标主机不在线 | | `-32003` | 源或目标已有在飞传输(单设备单传输) | | `-32004` | 命令下发失败 | -| `-32005` | 源端是老客户端(无 `CLIENT_CAP_C2C_PATHS`)、源端或目标端是 Linux/macOS | +| `-32005` | 源端是老客户端(无 `CLIENT_CAP_C2C_PATHS`)、或源端是 Linux/macOS(目标端可以是 Linux/macOS) | | `-32006` | `McpFileTransfer=0` 或 `McpReadonly=1`(改远程);任一端不支持 V2 | | `-32009` / `-32010` | 源端路径不存在(win32 2/3)/ 拒绝访问(win32 5) | -| `-32001` | 等源端结果超时(传输可能仍在进行) | +| `-32011` | **目标端写入失败**:收到 176 回执且 `status != 0`;文案带 status、首个 errno(13/1→权限、2→路径不存在、28→磁盘满)与实收文件数 | +| `-32001` | 等源端结果超时(传输可能仍在进行);或**支持回执的目标端在源端完成后 5 s 内没有回执**(对 `total_bytes>0` 的传输才判失败;全空文件传输没有数据块、目标端无从学到 `totalFiles`,按无回执处理) | ### 14.6 限制 -- **`receiver_ack` 恒为 `false`**:V2 的完成校验由接收方做(`HandleFileCompleteV2`),但接收方不回执,源端只能确认「全部包已发出」。要确认落盘请用 `list_files` 核对目标端。 +- **回执只覆盖 Linux 目标端**:Windows 目标端(V2 接收实现里没有回执通道)与 macOS(`macos/main.mm` 的客户端对象是函数内局部变量,没有全局主连接句柄)仍是 `receiver_ack:false`,只能确认「包已全部发出」,要确认落盘请用 `list_files` 核对目标端。 - **不做断点续传**(`enableResume=false`):C2C 的续传查询/应答会多两跳,v1 从简;失败即整包重发。 -- **两端都必须是 Windows 客户端**。目标端也限制,是因为 `dst_dir` 由源端拼进每个 V2 块的 `name` 字段(绝对 Windows 路径),而接收端的「目标目录」只能由 `COMMAND_C2C_PREPARE` 设置,本流程不发该包:Linux/macOS 的 `RecvFileChunkV2` 拿不到 targetDir,会走「服务端下载」分支把 `C:\x\y` 去掉盘符当绝对路径写(`common/FileTransferV2.h:224`),落到 `/x/y` 并要求 root 权限。要支持非 Windows 目标,需要新增携带显式目标路径的准备包并升级对应客户端。 +- **源端必须是 Windows 客户端**(`CLIENT_CAP_C2C_PATHS` 只有 Windows 置位);目标端可以是 Windows / Linux / macOS。 +- **POSIX 目标的路径限制**:`dst_dir` 与文件名的 UTF-8 → ANSI 转换固定用 CP936(协议字段没有编码标志位),GBK 无法表示的字符(如 `ö`、`ß`)会变成 `?`;POSIX 目标的 `dst_dir` 必须是绝对 `/…` 且不含 `\`;Linux 侧文件名按收到的字节原样落盘(大多是 GBK 字节),在 UTF-8 环境里 `ls` 会显示为乱码但内容与 SHA-256 正确。要根治需要为 V2 名字字段引入 UTF-8 标志位,本次不做。 +- **空文件不会被创建**(协议现状,与目标端类型无关):worker 对 0 字节文件不发数据块,只发 `FileCompletePacketV2`,接收端没有对应分支去 `open(O_CREAT)`。空**目录**会创建。 - 一次只允许一对主机间的单个传输(源、目标各自都要求空闲),避免与 `download_file`/`upload_file` 抢同一主机的连接。 ### 14.7 验证(Debug 实例 + 两个 Debug 客户端副本,同一台机器不同目录 → 不同 client_id) @@ -474,3 +488,32 @@ TOKEN_C2C_SEND_RESULT = 175, // 源客户端 → 服务端(源端自开 | `dst_dir` 不存在(`…\recv\fresh\nested`) | 自动创建,文件到位 | | `src_id == dst_id` / 源路径不存在 / 目标离线 / `dst_dir` 含 `..` | `-32602` / `-32009`(win32=3) / `-32002` / `-32602` | | `tools/mcp_smoke.ps1`(含主机类工具,41 项) | 全通过;新增 `copy_files_c2c` 同主机 `-32602`、目标离线 `-32002` 两项 | + +### 14.8 增补(2026-10-27):Linux 作为目标端 + 落盘回执 + +改动面:服务端门禁按目标端类型校验 `dst_dir`(§14.4);Linux 接收端 `common/FileTransferV2.h` 统计每个 +`transferID` 的定案条目,全部定案后从主连接回一包 `TOKEN_C2C_RECV_RESULT`(176);服务端新增 +`OnC2CRecvResult` / `WaitC2CReceiver`,在源端结果之后等回执并把它变成 `receiver_ack` 或 `-32011`。 + +接收端记账要点(都在 `FileTransferV2.h` 的 `RecvProgress` 里): + +- 条目定案有三个来源:**目录项包**(`FFV2_DIRECTORY`,无 LAST_CHUNK)、**最后一块数据**、**空文件的完成包**; + 源端重发(最多 3 次)与「最后一块 + 完成包」都会重复命中同一 `fileIndex`,用 `doneFiles`/`doneDirs` 去重。 +- `totalFiles` 只能从数据块/目录包学到(`FileCompletePacketV2` 没有该字段);目录项也计入 `totalFiles`, + 所以判据是 `doneFiles + doneDirs >= totalFiles`。 +- `errno` 只在失败瞬间有效,open 失败处紧接着就有 `Mprintf`,因此在失败点立刻取值再传递; + `fstat` 复核最终大小,大小不符记 `EIO`。 +- 回执在锁外发送;`reply->IsConnected()` 失败只记日志,不影响已落盘的文件。 + +验证(Debug 实例 6543/6546,WSL Ubuntu 24.04 里新编译的 `linux/ghost` 以 yuan(1000) 运行): + +| 用例 | 结果 | +|---|---| +| Windows → Linux,`dst_dir=/tmp/yama_c2c/recv`,2 个文件(其一中文名)+ 目录(含 3 MB 二进制与空子目录) | 3 个文件 SHA-256 全对、`sub/empty` 空目录已建,`receiver_ack:true`、`file_count=3`、`total_bytes=3147539`(与源端一致),耗时 3.2 s | +| `dst_dir=/tmp/yama_c2c/fresh/nested`(不存在) | 自动创建,`receiver_ack:true` | +| POSIX 目标给 `dst_dir=C:\tmp\x` | `-32602` "use an absolute POSIX path such as /home/user/incoming" | +| POSIX 目标给不可写位置 `/proc/yama_c2c` | `-32011` "no such file or directory (status=3, errno=2, files=1)" | +| 只发一个 0 字节文件 | 成功返回、`receiver_ack:false`(无数据块 → 接收端学不到 `totalFiles` → 不回执),**不误报** `-32001` | +| 只发一个空目录 | 目录包携带 `totalFiles` → 回执到达,`receiver_ack:true`、`file_count=0`,目录已创建 | +| Windows → Windows 回归(原 c2c_test 用例) | 全部与改动前一致,`receiver_ack:false`,耗时 3.2 s(未增加等待) | +| `upload_file`/`download_file`(`dstClientID=0`) | 不进回执分支(`FinishC2CItem` 首行即 `dstClientID==0` 返回),行为不变 | diff --git a/linux/README.md b/linux/README.md index 083efde..9526452 100644 --- a/linux/README.md +++ b/linux/README.md @@ -26,6 +26,7 @@ SimpleRemoter 的 Linux 客户端,支持远程桌面、远程终端、文件 | 守护进程 | daemonize() | Windows 服务 | ✅ 完整 | | 剪贴板同步 | `ClipboardHandler.h` | `ScreenManager.cpp` | ✅ 服务端↔Linux | | V2 文件传输 | `FileTransferV2.h` | `file_upload.h` | ✅ 服务端↔Linux | +| C2C 文件接收 | `FileTransferV2.h` | `file_upload.h` | ✅ Windows/MCP → Linux(目标目录由服务端 `dst_dir` 指定,落盘后回执) | | 配置持久化 | `LinuxConfig` | INI 文件 | ✅ 完整 | ### 未实现 diff --git a/linux/main.cpp b/linux/main.cpp index 72c0527..8dd7b47 100644 --- a/linux/main.cpp +++ b/linux/main.cpp @@ -455,8 +455,8 @@ int DataProcess(void* user, PBYTE szBuffer, ULONG ulLength) FileTransferV2::HandleC2CPrepare(szBuffer, ulLength, nullptr); Mprintf("** [%p] C2C Prepare received ***\n", user); } else if (szBuffer[0] == COMMAND_SEND_FILE_V2 || szBuffer[0] == COMMAND_FILE_COMPLETE_V2) { - // V2 文件接收 - int result = FileTransferV2::RecvFileChunkV2(szBuffer, ulLength, g_myClientID); + // V2 文件接收;g_pMainClient 用于 C2C 落盘回执(DataProcess 的 user 恒为 NULL) + int result = FileTransferV2::RecvFileChunkV2(szBuffer, ulLength, g_myClientID, g_pMainClient); if (result != 0) { Mprintf("** [%p] V2 File recv error: %d ***\n", user, result); } diff --git a/server/2015Remote/2015RemoteDlg.cpp b/server/2015Remote/2015RemoteDlg.cpp index 578044b..229c5e7 100644 --- a/server/2015Remote/2015RemoteDlg.cpp +++ b/server/2015Remote/2015RemoteDlg.cpp @@ -5582,6 +5582,15 @@ BOOL CALLBACK CMy2015RemoteDlg::NotifyProc(CONTEXT_OBJECT* ContextObject) int cmd = ContextObject->GetBYTE(0); AUTO_TICK(50, std::to_string(cmd)); + // 目标端的 C2C 落盘回执:必须在对话框分支之前截走——目标主机要是正开着远程屏幕/文件管理, + // 主连接上的包会被 hDlg->OnReceiveComplete 吃掉,MCP 侧就永远等不到回执(会被判成写入失败)。 + if (cmd == TOKEN_C2C_RECV_RESULT) { + McpServer().OnC2CRecvResult(ContextObject->GetClientID(), + ContextObject->InDeCompressedBuffer.GetBuffer(), + ContextObject->InDeCompressedBuffer.GetBufferLen()); + return TRUE; + } + DialogBase* Dlg = (DialogBase*)ContextObject->hDlg; if (Dlg) { if (!IsWindow(Dlg->GetSafeHwnd()) || Dlg->IsClosed()) @@ -7034,6 +7043,13 @@ VOID CMy2015RemoteDlg::MessageHandle(CONTEXT_OBJECT* ContextObject) McpServer().OnC2CResult(ContextObject->GetClientID(), szBuffer, len); break; } + case TOKEN_C2C_RECV_RESULT: { // copy_files_c2c 目标端落盘回执 + // 正常在 NotifyProc 里就截走了(避免被 hDlg 吃掉);这里兜住未运行/直投的路径。 + Mprintf("[C2C] 收到目标端回执: dev=%llu len=%u\n", + (unsigned long long)ContextObject->GetClientID(), len); + McpServer().OnC2CRecvResult(ContextObject->GetClientID(), szBuffer, len); + break; + } case TOKEN_SEARCH_FILE_LIST: { // 搜索结果【B2:仅 MCP 无头搜索会到达】 // 有挂起的 search_file 且是本连接发的 → 收下这一包;否则是已被放弃的旧搜索 // (工具线程已超时返回部分结果)的尾包,原地丢弃即可。 diff --git a/server/2015Remote/McpServer.cpp b/server/2015Remote/McpServer.cpp index 74d79ac..cb64154 100644 --- a/server/2015Remote/McpServer.cpp +++ b/server/2015Remote/McpServer.cpp @@ -1778,7 +1778,7 @@ std::string BuildToolsListResult(const Json::Value& id) { if (CMcpServer::Instance().IsFileTransferEnabled() && !CMcpServer::Instance().IsReadonly()) { Json::Value tool(Json::objectValue); tool["name"] = "copy_files_c2c"; - tool["description"] = u8"在两个在线 Windows 主机之间直接拷贝文件(V2 C2C:源主机自己发、目标主机自己收,服务端只中继,不在主控落盘)。paths 为源主机绝对路径(文件或目录,目录递归、保留相对目录结构);dst_dir 为目标主机保存目录(不存在自动创建)。返回 transfer_id/file_count/total_bytes;receiver_ack 恒为 false —— V2 没有目标端回执,目标端校验失败只记在目标机日志里,需要确证请用 list_files 复核。"; + tool["description"] = u8"在两个在线主机之间直接拷贝文件(V2 C2C:源主机自己发、目标主机自己收,服务端只中继,不在主控落盘)。源主机必须是 Windows;目标主机可以是 Windows 或 Linux/macOS。paths 为源主机绝对路径(文件或目录,目录递归、保留相对目录结构);dst_dir 为目标主机保存目录(不存在自动创建),Windows 目标用 D:\\Incoming 这类绝对路径,Linux/macOS 目标用 /home/user/incoming 这类绝对 POSIX 路径。返回 transfer_id/file_count/total_bytes/receiver_ack:receiver_ack=true 表示目标端已确认写入(Linux 客户端回执),false 表示目标端没有回执(Windows 目标、老客户端或 macOS),此时需要确证请用 list_files 复核。"; tool["inputSchema"] = BuildCopyFilesC2CInputSchema(); tool["outputSchema"] = BuildCopyFilesC2COutputSchema(); tools.append(tool); @@ -5117,7 +5117,7 @@ Json::Value BuildCopyFilesC2CInputSchema() { Json::Value dir(Json::objectValue); dir["type"] = "string"; - dir["description"] = u8"目标主机保存目录(绝对路径,不存在自动创建),如 D:\\Incoming"; + dir["description"] = u8"目标主机保存目录(绝对路径,不存在自动创建):Windows 目标如 D:\\Incoming,Linux/macOS 目标如 /home/user/incoming"; props["dst_dir"] = dir; Json::Value to(Json::objectValue); @@ -5203,13 +5203,15 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM return BuildError(id, -32005, "Source host client is too old: upgrade it to a build that supports copy_files_c2c"); if (!dstCtx->SupportsFileV2()) return BuildError(id, -32006, "Destination host does not support V2 file transfer"); - // 目标端也必须是 Windows:dst_dir 由源端拼进每个块的 name 字段(绝对 Windows 路径), - // 非 Windows 接收端拿不到 COMMAND_C2C_PREPARE 设置的目标目录,会把 C:\x\y 去盘符后 - // 当绝对路径写(common/FileTransferV2.h:224)——落到 /x/y 并要求 root 权限。 + // 目标端可以是 Windows,也可以是 Linux/macOS:dst_dir 由源端原样拼进每个块的 name 字段 + // (纯字符串拼接,不经 Windows 路径 API),所以 Windows 目标吃绝对 Windows 路径, + // POSIX 目标吃绝对 POSIX 路径——接收端会把 '\' 归一化成 '/' 后按绝对路径落盘 + // (common/FileTransferV2.h:224)。形态在下面按 dstType 分别校验。 CString dstType = dstCtx->GetAdditionalData(RES_CLIENT_TYPE); - if (dstType == "LNX" || dstType == "MAC") - return BuildError(id, -32005, "copy_files_c2c requires a Windows destination host: " - "non-Windows clients cannot honour dst_dir yet"); + const bool posixDst = (dstType == "LNX" || dstType == "MAC"); + // 目标端是否会回落盘回执(目前只有新 Linux 客户端声明)。不会回的(Windows/老客户端) + // 不等回执,避免每次传输都白等几秒。 + const bool dstAcks = dstCtx->SupportsC2CRecvAck(); std::string dstDirUtf8 = GetStringArg(args, "dst_dir"); if (dstDirUtf8.empty()) @@ -5227,21 +5229,43 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM timeoutMs = v; } - // 目标目录:UTF-8 → 目标端 ANSI(936),去尾斜杠后统一补一个 '\'(作 targetDir 前缀)。 - std::string dstDirAnsi = ToAnsi(dstDirUtf8, 936); - if (dstDirAnsi.empty()) - return BuildError(id, -32602, "Invalid dst_dir encoding"); + // 目标目录:UTF-8 → 目标端 ANSI(936),去尾斜杠后统一补一个分隔符(作 targetDir 前缀, + // 源端是 targetDir + 相对路径的裸拼接,前缀必须以分隔符结尾)。 + if (dstDirUtf8.find('\0') != std::string::npos) // 报文是 NUL 分隔的,内嵌 NUL 会截断并注入后续字段 + return BuildError(id, -32602, "Invalid dst_dir: embedded NUL"); + std::string dstDirAnsi; + if (posixDst) { + // 精确转换:CP936 表示不了字符(emoji/西里尔等)直接拒绝,而不是悄悄变成 '?' + // 把文件写进另一个目录。 + if (!Utf8ToCpExact(dstDirUtf8, 936, dstDirAnsi) || dstDirAnsi.empty()) + return BuildError(id, -32602, "Invalid dst_dir encoding (must be representable in CP936): " + + dstDirUtf8); + } else { + dstDirAnsi = ToAnsi(dstDirUtf8, 936); + if (dstDirAnsi.empty()) + return BuildError(id, -32602, "Invalid dst_dir encoding"); + } while (!dstDirAnsi.empty() && (dstDirAnsi.back() == '\\' || dstDirAnsi.back() == '/')) dstDirAnsi.pop_back(); if (dstDirAnsi.empty() || HasDotDotSegment(dstDirAnsi)) return BuildError(id, -32602, "Invalid dst_dir: " + dstDirUtf8); - dstDirAnsi += "\\"; + if (posixDst) { + // POSIX 目标:接收端把 '\' 当分隔符归一化,接 C:\x 会落成 /C:/x 之类;只收 '/' 根路径。 + if (dstDirAnsi[0] != '/' || dstDirAnsi.find('\\') != std::string::npos) + return BuildError(id, -32602, "Invalid dst_dir for a Linux/macOS destination: use an " + "absolute POSIX path such as /home/user/incoming"); + dstDirAnsi += "/"; + } else { + dstDirAnsi += "\\"; + } std::vector pathAnsi; for (unsigned int i = 0; i < paths.size(); ++i) { if (!paths[i].isString()) return BuildError(id, -32602, "paths must be an array of strings"); const std::string u8 = paths[i].asString(); + if (u8.find('\0') != std::string::npos) + return BuildError(id, -32602, "Invalid path: embedded NUL"); std::string ansi = ToAnsi(u8, 936); if (ansi.empty()) return BuildError(id, -32602, "Invalid path encoding: " + u8); @@ -5282,6 +5306,11 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM CMcpServer::C2CResult r; bool ok = mcp.WaitC2CDone(srcId, timeoutMs, r); + + // 源端说「全部发出」后再等目标端回执:只有声明 CLIENT_CAP_C2C_RECV_ACK 的端会回, + // 其余(Windows 目标、老 Linux 客户端、macOS)什么都不发,直接跳过等待。 + if (ok && dstAcks) mcp.WaitC2CReceiver(srcId, 5000, r); + mcp.ClearFileTransfer(srcId); if (!ok) { @@ -5302,6 +5331,24 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM return BuildError(id, -32000, msg); } + // 目标端回了回执但失败:源端的「全部发出」不算完成,按目标端写入失败上报。 + if (r.recvAck && r.recvStatus != (uint32_t)FEV2_OK) { + const char* why = "write failed"; + if (r.recvStatus == (uint32_t)FEV2_ACCESS_DENIED) why = "permission denied"; + else if (r.recvStatus == (uint32_t)FEV2_FILE_NOT_FOUND) why = "no such file or directory"; + else if (r.recvStatus == (uint32_t)FEV2_DISK_FULL) why = "no space left on device"; + return BuildError(id, -32011, std::string("Destination host failed to write the files: ") + why + + " (status=" + std::to_string(r.recvStatus) + + ", errno=" + std::to_string(r.recvErrno) + + ", files=" + std::to_string(r.recvFileCount) + ")"); + } + + // 声明了会回执却不回:目标端可能中途掉线或包被丢弃,源端的「已发出」不能当成落盘成功。 + // 例外:整包没有字节(paths 全是空文件)——客户端不为空文件发任何数据块,也就无从回执。 + if (dstAcks && !r.recvAck && r.totalBytes != 0) + return BuildError(id, -32001, "Source finished sending but the destination did not confirm " + "the write (verify with list_files on the destination host)"); + // 审计(不可关闭;只记主机 id、目录与字节数,不落文件名以外的内容) if (parent) { std::string audit = "host " + std::to_string(srcId) + " -> host " + std::to_string(dstId) @@ -5320,8 +5367,9 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM sc["dst_dir"] = dstDirUtf8; sc["file_count"] = (Json::UInt)r.fileCount; sc["total_bytes"] = (Json::UInt64)r.totalBytes; - // V2 没有「目标端已校验」的回执回到服务端:目标端校验失败只记在目标主机日志里。 - sc["receiver_ack"] = false; + // receiver_ack=true 只可能来自 POSIX 接收端(Linux 客户端写完最后一包回执); + // Windows 目标与老客户端没有回执,false 时请用 list_files 在目标主机上复核。 + sc["receiver_ack"] = r.recvAck; result["structuredContent"] = sc; Json::Value content(Json::arrayValue); @@ -5329,7 +5377,8 @@ std::string BuildCopyFilesC2C(const Json::Value& id, const Json::Value& args, CM item["type"] = "text"; item["text"] = std::string(u8"C2C 发送完成:") + std::to_string(r.fileCount) + u8" 个文件(" + std::to_string(r.totalBytes) + u8" 字节),目标主机保存目录 " + dstDirUtf8 - + u8"。目标端无回执:请用 list_files 或 exec_command 在目标主机上复核。"; + + (r.recvAck ? u8"。目标端已确认写入。" + : u8"。目标端无回执:请用 list_files 或 exec_command 在目标主机上复核。"); content.append(item); result["content"] = content; result["isError"] = false; @@ -8077,6 +8126,28 @@ void CMcpServer::OnC2CResult(uint64_t src_id, const BYTE* buf, ULONG len) { m_FileXferCv.notify_all(); } +void CMcpServer::OnC2CRecvResult(uint64_t dst_id, const BYTE* buf, ULONG len) { + if (len < sizeof(C2CSendResultPacket)) return; + const C2CSendResultPacket* res = (const C2CSendResultPacket*)buf; + if (res->cmd != TOKEN_C2C_RECV_RESULT || res->dstClientID != dst_id) return; // 身份自洽性 + + std::lock_guard lk(m_FileXferMutex); + // 目标端在服务端没有自己的会话条目(BeginC2CTransfer 只登记源端),只能按 dstClientID + transferID 反查。 + for (auto& kv : m_FileXferSessions) { + FileTransferSession& s = kv.second; + if (s.tool != "copy_files_c2c" || s.dstClientID != dst_id + || s.transferID != res->transferID) continue; + if (s.recvAck) return; // 重复回执只认第一包 + s.recvAck = true; + s.recvStatus = res->status; + s.recvErrno = res->win32err; // 176 里放的是 errno + s.recvFileCount = res->fileCount; + s.recvBytes = res->totalBytes; + m_FileXferCv.notify_all(); + return; + } +} + bool CMcpServer::WaitC2CDone(uint64_t src_id, int timeoutMs, C2CResult& out) { std::unique_lock lk(m_FileXferMutex); auto it = m_FileXferSessions.find(src_id); @@ -8108,6 +8179,29 @@ bool CMcpServer::WaitC2CDone(uint64_t src_id, int timeoutMs, C2CResult& out) { return s.c2cResult && s.error == 0; } +bool CMcpServer::WaitC2CReceiver(uint64_t src_id, int timeoutMs, C2CResult& out) { + std::unique_lock lk(m_FileXferMutex); + auto it = m_FileXferSessions.find(src_id); + if (it == m_FileXferSessions.end()) return false; // 会话已收尾:按「无回执」处理 + + const auto deadline = std::chrono::steady_clock::now() + std::chrono::milliseconds(timeoutMs); + while (!it->second.recvAck) { + auto slice = std::chrono::milliseconds(250); + auto now = std::chrono::steady_clock::now(); + if (now + slice > deadline) slice = std::chrono::duration_cast(deadline - now); + if (slice.count() <= 0) break; // 超时:老客户端/Windows 目标根本不回执 + m_FileXferCv.wait_for(lk, slice); + } + + FileTransferSession& s = it->second; + out.recvAck = s.recvAck; + out.recvStatus = s.recvStatus; + out.recvErrno = s.recvErrno; + out.recvFileCount = s.recvFileCount; + out.recvBytes = s.recvBytes; + return s.recvAck; +} + bool CMcpServer::OnDownloadDriveList(uint64_t device_id, context* fmSubCtx) { std::string localDir, remotePath; { diff --git a/server/2015Remote/McpServer.h b/server/2015Remote/McpServer.h index b77ec91..2efb620 100644 --- a/server/2015Remote/McpServer.h +++ b/server/2015Remote/McpServer.h @@ -298,6 +298,12 @@ public: int32_t workerRc = 0; // FileBatchTransferWorkerV2 返回值 uint32_t fileCount = 0; uint64_t totalBytes = 0; + // 目标端回执(只有 POSIX 接收端会发;Windows 目标恒为 false) + bool recvAck = false; // 收到了目标端回执 + uint32_t recvStatus = 0; // 回执 status(0=写入成功,FEV2_* = 失败原因) + DWORD recvErrno = 0; // 回执 win32err(POSIX 端放 errno) + uint32_t recvFileCount = 0; // 回执 fileCount(实收文件数) + uint64_t recvBytes = 0; // 回执 totalBytes(实收字节数) }; // 登记 C2C 会话(false = 源设备已有文件会话/挂起请求,或源==目标)。 @@ -307,9 +313,18 @@ public: // 无对应会话(迟到的结果、MFC 侧手写包)直接忽略。 void OnC2CResult(uint64_t src_id, const BYTE* buf, ULONG len); + // TOKEN_C2C_RECV_RESULT:目标客户端(目前只有 Linux)回传落盘回执。 + // 目标端在服务端没有自己的会话条目(会话键在源端),所以按 dstClientID + transferID 反查; + // 回执可能早于源端结果到达,两条 latch 互相独立,这里绝不置 done。 + void OnC2CRecvResult(uint64_t dst_id, const BYTE* buf, ULONG len); + // 工具线程:等源客户端回传结果;true=全部发出(error=0)。调用方随后 ClearFileTransfer(src)。 bool WaitC2CDone(uint64_t src_id, int timeoutMs, C2CResult& out); + // 工具线程:源端报告发出后再等目标端回执(仅声明 CLIENT_CAP_C2C_RECV_ACK 的端会回); + // true=收到回执(out.recvStatus 判断成败),false=没有回执(老客户端/超时)。 + bool WaitC2CReceiver(uint64_t src_id, int timeoutMs, C2CResult& out); + // TOKEN_DRIVE_LIST:识别 download_file,存文件管理器子链接并下发 CMD_DOWN_FILES_V2。 // 返回 true=已接管(保持子链接,收尾由 ClearFileTransfer);false=会话已清理(调用方 CancelIO)。 bool OnDownloadDriveList(uint64_t device_id, context* fmSubCtx); @@ -686,6 +701,12 @@ private: int32_t c2cWorkerRc = 0; // 结果包 workerRc uint32_t c2cFileCount = 0; // 结果包 fileCount uint64_t c2cBytes = 0; // 结果包 totalBytes + // 目标端回执(POSIX 接收端写完最后一包后发的同一个 175 包,dstClientID = 自己) + bool recvAck = false; // 已收到目标端回执 + uint32_t recvStatus = 0; // 回执 status(0=写入成功) + DWORD recvErrno = 0; // 回执 win32err(POSIX 端放 errno) + uint32_t recvFileCount = 0; // 回执 fileCount(实收文件数) + uint64_t recvBytes = 0; // 回执 totalBytes(实收字节数) std::string localDir; // download:本机保存目录(ANSI,结尾 '\') std::string remotePath; // 客户端远程路径(ANSI,发 CMD_DOWN_FILES_V2 用) bool overwrite = false; // 是否覆盖已存在文件 diff --git a/server/2015Remote/context.h b/server/2015Remote/context.h index fa18c80..1c51762 100644 --- a/server/2015Remote/context.h +++ b/server/2015Remote/context.h @@ -89,6 +89,15 @@ public: return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_C2C_PATHS) != 0; } + // 检查客户端作为 C2C 目标端时是否回落盘回执(TOKEN_C2C_RECV_RESULT)。 + // 目前只有 Linux 客户端声明;没有此能力位的老客户端/Windows 端不回执, + // 服务端据此决定要不要等回执,避免给它们白等。 + bool SupportsC2CRecvAck() const { + CString caps = GetClientData(ONLINELIST_CAPABILITIES); + if (caps.IsEmpty()) return false; + return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_C2C_RECV_ACK) != 0; + } + // 检查客户端是否支持屏幕预览(双击主机时拉缩略图)。 bool SupportsScreenPreview() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES);