diff --git a/server/2015Remote/McpInternal.cpp b/server/2015Remote/McpInternal.cpp index 10c2c32..01eb88a 100644 --- a/server/2015Remote/McpInternal.cpp +++ b/server/2015Remote/McpInternal.cpp @@ -481,6 +481,8 @@ const ToolHints kToolHints[] = { { "list_online_hosts", true, false, true, false }, { "search_hosts", true, false, true, false }, { "list_all_hosts", true, false, true, false }, + // P2-2:三合一后的正式名字(旧名保留为可调用别名) + { "list_hosts", true, false, true, false }, { "get_host_detail", true, false, true, false }, // get_activity_history 虽不含主机 id 之外的写操作,但要经主连接向目标主机发 // COMMAND_QUERY_ACTIVITY 取数据(McpServer.cpp:2249),属触达外部主机 → openWorld=true。 @@ -505,6 +507,7 @@ const ToolHints kToolHints[] = { { "list_registry", true, false, true, true }, { "download_file", true, false, true, true }, // 只读主机(写的是主控本机目录) { "search_file", true, false, true, true }, + { "read_file", true, false, true, true }, // 按字节读远端文件,无写操作 // --- 文件系统写操作(McpFileWrite)--- { "delete_path", false, true, false, true }, { "move_path", false, true, false, true }, @@ -523,6 +526,9 @@ const ToolHints kToolHints[] = { { "host_list_scheduled_tasks", true, false, true, true }, { "host_get_hosts_file", true, false, true, true }, // --- 终端 --- + // 默认 GET 只读,但 method 可传 POST/PUT/DELETE 等(改的是被探测的服务,不是主机文件), + // 与 get_keylog 同理按「可写、可破坏」登记,避免客户端把它当纯读工具批量重试。 + { "http_probe", false, true, false, true }, { "terminal_open", false, false, true, true }, { "terminal_exec", false, true, false, true }, // 任意命令,后果由命令决定 { "exec_command", false, true, false, true }, diff --git a/server/2015Remote/McpServer.cpp b/server/2015Remote/McpServer.cpp index 5098f73..da35979 100644 --- a/server/2015Remote/McpServer.cpp +++ b/server/2015Remote/McpServer.cpp @@ -4135,16 +4135,20 @@ std::string BuildExecCommand(const Json::Value& id, const Json::Value& args, CMy // 哨兵形态见 BuildSentinelLines:POSIX PTY / ConPTY 下命令与哨兵分两行下发(吞行命令 // 不再超时),老 ShellManager 保持单行 && / || 形式(其客户端按写入长度跳回显)。 std::string cmdLine, sentLine; - SendSentinelLines(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); + // 等待提示符期间 shell 可能已退出:OnTerminalClosed 会把子连接指针置空、OfflineProc 随后把它 + // 归还连接池(可能被新连接复用)。确认仍是本会话的子连接才写,否则直接交给 WaitTerminalDone + // 收尾(会话已 closed,立刻返回已收集的输出),避免往别人的连接里灌命令。 + if (mcp.IsTermSubCtxLive(devId, std::string(), subCtx)) + SendSentinelLines(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); std::vector raw; int exitCode = -1; bool closed = false; if (!mcp.WaitTerminalDone(devId, raw, exitCode, closed, timeoutMs)) { - subCtx->CancelIO(); + if (!closed) subCtx->CancelIO(); return BuildError(id, -32001, "Timeout waiting for command output"); } - subCtx->CancelIO(); // 关子链接,结束 shell 进程 + if (!closed) subCtx->CancelIO(); // 关子链接,结束 shell 进程;shell 已退出时指针可能已回收 // 清洗:raw → UTF-8 → 剥 ANSI → CRLF 归一 → 去 ConPTY 回显命令行 → TrimRight。 // raw 已截断到哨兵前。 @@ -5126,7 +5130,10 @@ std::string BuildTerminalExec(const Json::Value& id, const Json::Value& args, CM if (posix && isPty) mcp.WaitTerminalBootstrap(devId, timeoutMs < 2000 ? timeoutMs : 2000); - SendTerminalCommandLine(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); + // 等待期间 shell 可能已退出(子连接断开后指针交还连接池、可能被复用):确认仍是本会话 + // 的子连接才写;不写则下面 WaitTermCommand 立即按 closed 收尾(会话结束、需重新 open)。 + if (mcp.IsTermSubCtxLive(devId, sessionId, subCtx)) + SendTerminalCommandLine(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); // 审计:命令执行(不可关闭)。 if (parent) { @@ -5152,7 +5159,8 @@ std::string BuildTerminalExec(const Json::Value& id, const Json::Value& args, CM int elapsedMs = (int)std::chrono::duration_cast( std::chrono::steady_clock::now() - started).count(); - // shell 退出时 WaitTermCommand 已清理会话与路由;子连接本身已由客户端关闭,无需 CancelIO。 + // shell 退出时 WaitTermCommand 会清理会话与路由(本次被 max_output_bytes 截断时先保留, + // 等后续轮询把尾巴取完再清理);子连接本身已由客户端关闭,无需 CancelIO。 // 轮询块没有命令回显可剥(回显只在首块);命令路径带 cmdLine/sentLine 走完整清洗。 // 片段交付(命令未结束或本次被 max_output_bytes 截断)保留块尾空白,拼接才不粘连。 @@ -8606,7 +8614,9 @@ std::string BuildHttpProbe(const Json::Value& id, const Json::Value& args, CMy20 mcp.WaitTerminalBootstrap(devId, 2000); std::string cmdLine, sentLine; - SendTerminalCommandLine(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); + // 同 terminal_exec:等提示符期间 shell 可能已退出,子连接指针可能已被连接池复用。 + if (mcp.IsTermSubCtxLive(devId, sessionId, subCtx)) + SendTerminalCommandLine(subCtx, isPty, posix, command, nonce, cmdLine, sentLine); // 审计:请求的目标(不可关闭;不带 body/headers,避免泄露凭据)。 if (parent) { @@ -8648,6 +8658,14 @@ std::string BuildHttpProbe(const Json::Value& id, const Json::Value& args, CMy20 "Timeout waiting for http_probe result; the request is still running in terminal session " + sessionId + " (call terminal_exec with only session_id to collect the tail)"); + // 写前校验发现子连接已断(shell 退出)时会跳过下发,这里必然没有输出:报会话结束的墓碑文案, + // 比让解析器报「host 输出异常」清楚。 + if (closed && all.empty()) { + std::string destroyed = mcp.DescribeTermDestroyed(devId, sessionId); + return BuildError(id, -32002, destroyed.empty() + ? "Terminal session ended before the probe could run; call terminal_open again" : destroyed); + } + // 本工具隐式创建的会话用完即关:留着会让后续 exec_command 被 -32003「终端会话已存在」 // 挡到空闲回收为止。命令未结束时(上面的超时分支)保持会话,便于调用方轮询。 if (!reused) @@ -12261,6 +12279,18 @@ bool CMcpServer::IsTerminalContext(context* subCtx) { return m_TermContextToDevice.find(subCtx) != m_TermContextToDevice.end(); } +bool CMcpServer::IsTermSubCtxLive(uint64_t device_id, const std::string& sessionId, context* subCtx) { + if (!subCtx) return false; + std::lock_guard lk(m_TermMutex); + auto it = m_TermSessions.find(device_id); + if (it == m_TermSessions.end()) return false; + const TermSession& s = it->second; + // OnTerminalClosed 置 closed 的同时把 subCtx 置空:closed 即「这个指针已交还连接池」。 + if (s.closed || s.subCtx != subCtx) return false; + if (!sessionId.empty() && (!s.persistent || s.sessionId != sessionId)) return false; + return true; +} + void CMcpServer::OnTerminalData(context* subCtx, const BYTE* data, ULONG len) { std::lock_guard lk(m_TermMutex); auto it = m_TermContextToDevice.find(subCtx); @@ -12295,13 +12325,17 @@ void CMcpServer::OnTerminalClosed(context* subCtx) { auto sit = m_TermSessions.find(it->second); if (sit == m_TermSessions.end()) return; TermSession& s = sit->second; + // 子连接已断,OfflineProc 随后会把它归还连接池:会话里不能再留这个指针,否则等待线程 + // 醒来(或后续轮询)会对已回收、甚至已被新连接复用的 context 误 CancelIO;路由也必须 + // 立刻摘掉,否则迟到的清理会按旧指针误删新连接的表项。 + m_TermContextToDevice.erase(it); + s.subCtx = nullptr; s.closed = true; if (s.persistent && !s.busy && s.started) { - // 空闲持久会话:shell 已退、无等待线程会清理,直接擦路由+会话(无需 CancelIO,已死)。 - m_TermContextToDevice.erase(subCtx); + // 空闲持久会话:shell 已退、无等待线程会清理,直接擦会话(子连接已死,无需 CancelIO)。 m_TermSessions.erase(sit); } - m_TermCv.notify_all(); // busy 场景唤醒等待线程由其清理;一次性 exec 路径不变 + m_TermCv.notify_all(); // busy 场景唤醒等待线程交付剩余输出后由其清理;一次性 exec 路径不变 } bool CMcpServer::BeginTermPending(uint64_t device_id, const std::string& command, const std::string& nonce) { @@ -12316,15 +12350,26 @@ bool CMcpServer::BeginTermPending(uint64_t device_id, const std::string& command bool CMcpServer::WaitTerminalReady(uint64_t device_id, context*& subCtx, bool& isPty, int timeoutMs) { std::unique_lock lk(m_TermMutex); - auto it = m_TermSessions.find(device_id); - if (it == m_TermSessions.end()) return false; + // 谓词每次重新查表:等待期间 OnTerminalClosed(子连接断开)可能擦会话或置 closed, + // 缓存的迭代器会悬空。会话消失也算「结束等待」,由下面统一判失败。 + auto ready = [&] { + auto jt = m_TermSessions.find(device_id); + return jt == m_TermSessions.end() || jt->second.started || jt->second.closed; + }; + bool signaled = WaitWithCancel(lk, m_TermCv, DeadlineAfter(timeoutMs), ready); - bool signaled = WaitWithCancel(lk, m_TermCv, DeadlineAfter(timeoutMs), - [&] { return it->second.started; }); - if (!signaled) { + auto it = m_TermSessions.find(device_id); + if (!signaled || it == m_TermSessions.end() || !it->second.started || it->second.closed || + !it->second.subCtx) { // 放弃:迟到的 shell 子连接就绪包(TOKEN_SHELL_START/TOKEN_TERMINAL_START)不能弹终端窗口。 + // 失败原因可能是超时,也可能是子连接刚建立就断开(OnTerminalClosed 已置空 subCtx): + // 绝不能把空指针或已回收的 context 交给调用方。 MarkLateFirstPacket(device_id, { (BYTE)TOKEN_SHELL_START, (BYTE)TOKEN_TERMINAL_START }); - m_TermSessions.erase(it); // 超时/取消 → 清理 + if (it != m_TermSessions.end()) { + // 会话要么未就绪、要么子连接已断,都不可再用;清理掉避免占着该主机的终端槽。 + if (it->second.subCtx) m_TermContextToDevice.erase(it->second.subCtx); + m_TermSessions.erase(it); + } return false; } subCtx = it->second.subCtx; @@ -12352,13 +12397,17 @@ bool CMcpServer::WaitTerminalDone(uint64_t device_id, std::vector& out, int& exitCode, bool& closed, int timeoutMs) { std::unique_lock lk(m_TermMutex); auto it = m_TermSessions.find(device_id); - if (it == m_TermSessions.end()) return false; + if (it == m_TermSessions.end()) { + closed = true; // 会话已不在(被取消/回收):子连接去向未知,调用方不能再去碰这个指针 + return false; + } bool signaled = WaitWithCancel(lk, m_TermCv, DeadlineAfter(timeoutMs), [&] { return it->second.done || it->second.closed; }); if (!signaled) { // 超时/取消 → 清理(含路由表) - m_TermContextToDevice.erase(it->second.subCtx); + closed = it->second.closed; // 照实回报:closed 时子连接指针已置空、可能已被连接池复用 + if (it->second.subCtx) m_TermContextToDevice.erase(it->second.subCtx); m_TermSessions.erase(it); return false; } @@ -12530,6 +12579,7 @@ int CMcpServer::WaitTermCommand(uint64_t device_id, const std::string& sessionId return 7; // 没有在跑的命令:轮询只会空等到超时,直接告诉调用方用错 isPty = it->second.isPty; nonce = it->second.nonce; + ++it->second.waiters; // terminal_close 靠它判断 closed 之后有没有人负责收尾 // 谓词每次都重新查表:等待期间会话可能被 terminal_close / busy 兜底回收擦掉。 const std::string sid = sessionId; @@ -12581,6 +12631,23 @@ int CMcpServer::WaitTermCommand(uint64_t device_id, const std::string& sessionId s.delivered = deliverEnd; if (s.closed) { // shell 进程退出(或运行中被 terminal_close)→ 交付剩余输出后清理会话+路由 + if (s.delivered < end) { + // 本块被 maxOutputBytes 截断:会话与缓冲都保留(已 closed,pollMode 仍允许继续调用), + // 由后续轮询把尾巴取完再清理。若在这里直接擦会话,未交付的输出会静默丢失。 + // 但远端 shell 必须现在就结束(terminal_close 场景),否则它会一直跑到 1 小时兜底; + // 缓冲已收在 s.data 里,CancelIO 不影响后续轮询。 + context* subCtx = s.subCtx; + if (subCtx) { + m_TermContextToDevice.erase(subCtx); + s.subCtx = nullptr; + } + --s.waiters; + if (subCtx) { + lk.unlock(); + subCtx->CancelIO(); + } + return 0; + } context* subCtx = s.subCtx; exitCode = -1; MarkTermDestroyedLocked(device_id, s.sessionId, @@ -12600,11 +12667,13 @@ int CMcpServer::WaitTermCommand(uint64_t device_id, const std::string& sessionId s.busy = false; s.lastActiveAt = time(nullptr); // idle 语义是「距上次活动」,避免刚完成就被回收 } + --s.waiters; return 0; } // 超时:命令仍在远端运行。会话保持 busy、不销毁,调用方继续轮询(P0-2)。 s.lastActiveAt = time(nullptr); + --s.waiters; return 1; } @@ -12616,17 +12685,22 @@ int CMcpServer::CloseTermSession(uint64_t device_id, const std::string& sessionI if (it == m_TermSessions.end()) return 1; // 不存在(幂等) TermSession& s = it->second; if (!s.persistent || s.sessionId != sessionId) return 2; // token 不匹配 - if (s.busy) { - // 有命令在飞:置 closed 唤醒等待线程,由其清理(避免双重擦除)。 + if (s.busy && s.waiters > 0) { + // 有等待线程:置 closed 唤醒它,由其交付剩余输出后清理(避免双重擦除)。 s.closed = true; MarkTermDestroyedLocked(device_id, sessionId, "Terminal session was closed by terminal_close while a command was running"); m_TermCv.notify_all(); return 0; } + // 空闲,或 busy 但已无等待线程(调用方超时走人,只可能靠轮询):立刻收尾。 + // 后者若沿用「置 closed 等别人清理」,远端 shell 会一直跑到 1 小时 busy 兜底, + // 期间该主机的终端全部返回 busy。 subCtx = s.subCtx; - MarkTermDestroyedLocked(device_id, sessionId, "Terminal session was closed by terminal_close"); - m_TermContextToDevice.erase(s.subCtx); + MarkTermDestroyedLocked(device_id, sessionId, + s.busy ? "Terminal session was closed by terminal_close while a command was running" + : "Terminal session was closed by terminal_close"); + if (subCtx) m_TermContextToDevice.erase(subCtx); m_TermSessions.erase(it); } if (subCtx) subCtx->CancelIO(); // 锁外取消 IO,触发客户端 shell 退出 diff --git a/server/2015Remote/McpServer.h b/server/2015Remote/McpServer.h index 7f272d1..b6c76d8 100644 --- a/server/2015Remote/McpServer.h +++ b/server/2015Remote/McpServer.h @@ -227,6 +227,11 @@ public: // 终端子连接是否已被 MCP 接管(MessageHandle 顶部据此把 shell 输出路由到 OnTerminalData)。 bool IsTerminalContext(context* subCtx); + // 工具线程:写命令前确认 subCtx 仍是该会话在用的子连接。等待提示符期间 shell 可能已退出, + // 子连接被 OfflineProc 归还连接池后可能已被新连接复用,此时再写就是往别人的连接里灌命令。 + // sessionId 非空时还要求会话是持久的且 token 一致。 + bool IsTermSubCtxLive(uint64_t device_id, const std::string& sessionId, context* subCtx); + // 追加 shell 输出并做哨兵检测(命中置 done 并唤醒等待者)。 void OnTerminalData(context* subCtx, const BYTE* data, ULONG len); @@ -241,6 +246,7 @@ public: // 工具线程:等待输出收集完成(哨兵命中 / 进程退出 / 超时)。 // 成功 true:out=截断到哨兵前的原始字节、exitCode=0/1(进程退出无哨兵时 -1)、closed=是否进程退出。 + // 失败时也尽量照实回填 closed:为 true 表示子连接已断开或去向未知,调用方不得再对它 CancelIO。 bool WaitTerminalDone(uint64_t device_id, std::vector& out, int& exitCode, bool& closed, int timeoutMs); // 工具线程:写命令前等 shell 启动完成(收到第一屏输出,通常是提示符)。 @@ -284,7 +290,8 @@ public: // 等待本条命令结束或超时,并交付 [delivered, ...) 的增量输出。 // pollMode=true 表示本次调用没有携带新命令(只轮询),此时会话空闲 = 调用方用错,返回 7。 - // 返回:0=命令结束(done=true;closed=true 表示 shell 退出,会话已清理) + // 返回:0=命令结束(done=true;closed=true 表示 shell 退出;本次被 maxOutputBytes 截断时 + // 会话保留到轮询取完尾巴再清理,否则当场清理) // 1=等待超时,命令仍在运行(done=false;会话保持 busy,可再次轮询) // 2=请求被取消,会话已销毁(与旧语义一致:取消方不会再轮询) // 3=会话不存在/未就绪/等待期间被销毁(细节看 DescribeTermDestroyed) @@ -854,6 +861,8 @@ private: size_t delivered = 0; // 已交付给调用方的 data 前缀长度(超时/轮询增量回传) size_t droppedBytes = 0; // 因 data 硬上限被丢弃的最旧字节数(如实上报) std::chrono::steady_clock::time_point busySince{}; // busy 起点(长时间在飞的强制回收兜底) + int waiters = 0; // 阻塞在 WaitTermCommand 里的线程数;terminal_close 据此 + // 判断 closed 之后是否还有人负责收尾(没有就自己清) }; std::mutex m_TermMutex; std::condition_variable m_TermCv;