{"id":1868,"date":"2026-08-18T20:14:02","date_gmt":"2026-08-18T12:14:02","guid":{"rendered":"https:\/\/tongchun.website\/index.php\/kimiagent-02-runtime\/"},"modified":"2026-08-18T20:26:24","modified_gmt":"2026-08-18T12:26:24","slug":"kimiagent-02-runtime","status":"publish","type":"page","link":"https:\/\/tongchun.website\/index.php\/kimiagent-02-runtime\/","title":{"rendered":"02-runtime \u2014 Kimi \u6c99\u7bb1\u4ee3\u7801\u6267\u884c\u8fd0\u884c\u65f6\uff08kernel-server \/ ipykernel\uff09"},"content":{"rendered":"\n

\u2190 \u8fd4\u56de\u4e3b\u62a5\u544a\uff1aKimi Agent\uff08\u4e91\u7aef\u6c99\u7bb1\uff09\u6280\u672f\u62a5\u544a<\/a> \uff5c GitHub \u539f\u6587<\/a><\/p>\n\n\n\n

\u5408\u89c4\u4e0e\u98ce\u9669\u58f0\u660e<\/strong>\uff1a\u672c\u62a5\u544a\u4e3a\u5b89\u5168\u7814\u7a76\u4e0e\u4e92\u64cd\u4f5c\u5b66\u4e60\u76ee\u7684\u7684\u9006\u5411\u5206\u6790\uff0c\u5168\u7a0b\u53ea\u8bfb\u91c7\u96c6\uff0c\u672a\u5bf9\u76ee\u6807\u7cfb\u7edf\u505a\u4efb\u4f55\u4fee\u6539\uff1b\u6587\u4e2d\u6240\u6709\u5bc6\u94a5\u3001token\u3001\u8d26\u53f7\u7ea7\u6807\u8bc6\uff08chat_id \/ project_id \/ tenant_id \u7b49\uff09\u5747\u5df2\u8131\u654f\uff1b\u6c99\u7bb1\u5185\u53d1\u73b0\u7684\u9ed8\u8ba4\u5f31\u53e3\u4ee4\uff08VNC\/SSH\uff09\u5c5e\u5e73\u53f0\u4fa7\u914d\u7f6e\uff0c\u4ec5\u4f5c\u5b89\u5168\u53d1\u73b0\u62ab\u9732\uff0c\u8bf7\u52ff\u7528\u4e8e\u8bbf\u95ee\u4efb\u4f55\u4e0d\u5c5e\u4e8e\u81ea\u5df1\u7684\u7cfb\u7edf\u3002docx\/pdf\/xlsx\/kimi-slides \u7b49\u5f15\u64ce\u4e8c\u8fdb\u5236\u4e3a Moonshot \u4e13\u6709\u8bb8\u53ef\uff08\u7981\u518d\u5206\u53d1\/\u9006\u5411\uff09\uff0c\u672c\u6587\u4ec5\u4f5c\u884c\u4e3a\u7ea7\u63cf\u8ff0\u3002\u62a5\u544a\u57fa\u4e8e\u5355\u6b21\u5206\u6790\u7a97\u53e3\uff08\u7ea6 50 \u5206\u949f\u751f\u547d\u5468\u671f\uff09\uff0c\u8f6f\u4ef6\u7248\u672c\u4e0e\u6280\u80fd\u5e93\u5b58\u968f\u955c\u50cf\u66f4\u65b0\u53ef\u80fd\u53d8\u5316\u3002<\/p><\/blockquote>\n\n\n\n

\u91c7\u96c6\u65f6\u95f4\uff1a2026-08-18\u3002\u6765\u6e90\uff1aSSH \u53ea\u8bfb\u8bbf\u95ee\uff08kimi \u7528\u6237\uff09+ \u6c99\u7bb1\u5185\u5b9e\u6d4b curl\u3002\u6240\u6709\u6587\u4ef6\u8def\u5f84\u4e3a\u6c99\u7bb1\u5185\u8def\u5f84\u3002<\/p>\n\n\n\n

1. \u603b\u4f53\u67b6\u6784\uff1a\u4e00\u6761 HTTP \u2192 ZMQ \u2192 ipykernel \u7684\u94fe\u8def<\/h2>\n\n\n\n

\u4e91\u7aef kimiagent\uff08\u6c99\u7bb1\u5916\uff09\u6267\u884c\u4ee3\u7801\u7684\u5b8c\u6574\u94fe\u8def\uff1a<\/p>\n\n\n\n

\u4e91\u7aef agent (kimiagent)\n  \u2502  HTTP POST \/kernel\/execute  {\"code\": \"...\", \"timeout\": 30}\n  \u25bc\nkernel-server  :8888  (FastAPI + uvicorn, \/app\/kernel_server.py, PID 74, \u7528\u6237 kimi)\n  \u2502  jupyter_client.KernelManager \/ BlockingKernelClient (ZMQ, HMAC-SHA256 \u7b7e\u540d)\n  \u25bc\nipykernel \u5b50\u8fdb\u7a0b  (\/usr\/local\/bin\/python3 -m ipykernel_launcher -f \/tmp\/tmpXXX.json, PID 180)\n  \u2502  iopub\/shell ZMQ \u6d88\u606f\u6d41\n  \u25bc\nkernel-server \u805a\u5408 stream\/error\/execute_result\/display_data \u2192 JSON \u54cd\u5e94\u56de\u4f20<\/code><\/pre>\n\n\n\n
\u5173\u952e\u4e8b\u5b9e\uff1akernel-server \u662f\u6c99\u7bb1\u5185\u552f\u4e00\u9762\u5411\u4e91\u7aef\u6a21\u578b\u7684\u4ee3\u7801\u6267\u884c\u5165\u53e3\u3002\/app\/.agents\/skills\/<\/code> \u4e0b grep 8888<\/code> \u65e0\u4efb\u4f55\u4e1a\u52a1\u5f15\u7528\uff08\u547d\u4e2d\u7684\u5168\u662f node_modules \u91cc\u65e0\u5173\u6587\u672c\uff09\uff0c\u8bf4\u660e\u8c03\u7528\u65b9\u5728\u6c99\u7bb1\u5916\u2014\u2014\u4e91\u7aef agent \u76f4\u63a5\u6253\u5bb9\u5668\u7684 0.0.0.0:8888<\/code>\u3002<\/p>\n\n\n\n
2. kernel-server \u8fdb\u7a0b\u4e0e\u542f\u52a8\u65b9\u5f0f<\/h2>\n\n\n\n
  • s6 \u670d\u52a1\u5b9a\u4e49\uff1a\/etc\/s6-overlay\/s6-rc.d\/kernel-server\/run<\/code>\uff08type=longrun\uff0c\u65e0 dependencies \u6587\u4ef6\uff09<\/li>
  • \u542f\u52a8\u811a\u672c\u5185\u5bb9\u8981\u70b9\uff1a<\/li><\/ul>\n\n\n\n
      export WORKDIR=\"${KERNEL_SERVER_WORKDIR:-\/mnt\/agents}\"\n  export DISPLAY=:99; export XAUTHORITY=\/home\/kimi\/.Xauthority; export HOME=\/home\/kimi\n  mkdir -p ${WORKDIR}; chown -R kimi:kimi ${WORKDIR}; cd ${WORKDIR}\n  exec \/command\/s6-setuidgid kimi python3 \/app\/kernel_server.py --host 0.0.0.0 --port 8888<\/code><\/pre>\n\n\n\n
    • \u5b9e\u9645\u73af\u5883\u53d8\u91cf KERNEL_SERVER_WORKDIR=\/tmp\/kimi-project-kernel<\/code>\uff08\u89c1 \/proc\/74\/environ<\/code>\uff09\uff0c\u6240\u4ee5\u4ee3\u7801\u6267\u884c cwd \u4e0d\u662f\u5de5\u4f5c\u533a \/mnt\/agents<\/code>\uff0c\u800c\u662f \/tmp\/kimi-project-kernel<\/code><\/strong>\u3002\u5b9e\u6d4b os.getcwd()<\/code> \u8fd4\u56de \/tmp\/kimi-project-kernel<\/code>\uff0cos.getuid()=999<\/code>\uff08kimi\uff09\u3002<\/li>
    • \u8fdb\u7a0b\u540c\u65f6\u6ce8\u5165 DISPLAY=:99<\/code>\uff08Xvnc \u865a\u62df\u663e\u793a\uff09\uff0c\u56e0\u6b64 kernel \u91cc\u8dd1\u7684\u4ee3\u7801\u53ef\u4ee5\u76f4\u63a5\u64cd\u4f5c GUI\/\u622a\u56fe\u3002<\/li>
    • \u955c\u50cf\/\u6784\u5efa\u4fe1\u606f\uff1aMOONBOX_PROJECT_TEMPLATE_VERSION=project-20260811-2<\/code>\uff0cPython 3.12.12\uff0cpip \u6e90\u6307\u5411 pypi.mirrors.msh.team<\/code> \/ mirrors.cloud.aliyuncs.com<\/code>\u3002<\/li><\/ul>\n\n\n\n
      3. kernel-server \u7684 HTTP API\uff08\/app\/kernel_server.py\uff0c\u7ea6 330 \u884c\uff09<\/h2>\n\n\n\n
      FastAPI \u5e94\u7528\uff0cuvicorn \u8dd1\u5728 0.0.0.0:8888<\/code>\u3002\u7aef\u70b9\u6e05\u5355\uff1a<\/p>\n\n\n\n
      \u65b9\u6cd5<\/th>\u8def\u5f84<\/th>\u4f5c\u7528<\/th><\/tr><\/thead>
      GET<\/td>\/<\/code><\/td>\u670d\u52a1\u4fe1\u606f<\/td><\/tr>
      GET<\/td>\/health<\/code><\/td>kernel \u521d\u59cb\u5316\u68c0\u67e5\uff08\u672a\u521d\u59cb\u5316 503\uff09<\/td><\/tr>
      GET<\/td>\/kernel\/status<\/code><\/td>alive \/ pid \/ connection_file \/ client_connected<\/td><\/tr>
      GET<\/td>\/kernel\/connection<\/code><\/td>\u8fd4\u56de\u5b8c\u6574 connection_info\uff08\u542b ZMQ HMAC key \u660e\u6587<\/strong>\uff09<\/td><\/tr>
      GET<\/td>\/kernel\/connection-file<\/code><\/td>\u7b80\u5316\u7248\u8fde\u63a5\u6587\u4ef6\u8def\u5f84<\/td><\/tr>
      GET<\/td>\/kernel\/debug<\/code><\/td>KernelManager \u5185\u90e8\u72b6\u6001 dump\uff08”\u5f00\u53d1\u7528”\u4f46\u751f\u4ea7\u5f00\u7740\uff09<\/td><\/tr>
      POST<\/td>\/kernel\/reset<\/code><\/td>\u9500\u6bc1\u5e76\u91cd\u542f kernel<\/td><\/tr>
      POST<\/td>\/kernel\/interrupt<\/code><\/td>SIGINT \u4e2d\u65ad<\/td><\/tr>
      POST<\/td>\/kernel\/execute<\/code><\/td>\u6267\u884c\u4ee3\u7801\uff0c{code, timeout(\u9ed8\u8ba430s), restart(bool)}<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \u9274\u6743\uff1a\u5b8c\u5168\u6ca1\u6709\u3002<\/strong> \u65e0 token\u3001\u65e0\u7b7e\u540d\u3001\u65e0 IP \u767d\u540d\u5355\uff0cCORS \u914d\u7f6e\u4e3a allow_origins=[\"*\"]<\/code> + allow_credentials=True<\/code>\u3002\u6211\u5728\u6c99\u7bb1\u5185\u4e0d\u5e26\u4efb\u4f55\u51ed\u636e\u76f4\u63a5\u6267\u884c\u6210\u529f\uff1a<\/p>\n\n\n\n
      $ curl -s -X POST http:\/\/127.0.0.1:8888\/kernel\/execute \\\n    -H 'Content-Type: application\/json' -d '{\"code\":\"print(1+1)\",\"timeout\":10}'\n{\"success\":true,\"output\":\"2\",\"error\":null,\"images\":[]}<\/code><\/pre>\n\n\n\n
      \u5b89\u5168\u6027\u5b8c\u5168\u4f9d\u8d56\u7f51\u7edc\u5c42\u9694\u79bb\uff08\u5bb9\u5668\u4e0d\u51fa\u7f51\u5230\u975e\u6388\u6743\u65b9\uff09\u3002\u4efb\u4f55\u4eba\u80fd\u5230 8888 \u5c31\u80fd\u4ee5 kimi \u8eab\u4efd\u6267\u884c\u4efb\u610f\u4ee3\u7801\uff0c\u4e14 \/kernel\/connection<\/code> \u8fd8\u4f1a\u6cc4\u9732 ZMQ HMAC key\uff08\u5b9e\u6d4b\u503c\u4e3a b447fec7-...<\/code>\uff0cUUID \u683c\u5f0f\uff09\uff0c\u62ff\u5230\u540e\u53ef\u7ed5\u8fc7 kernel-server \u76f4\u63a5\u8fde ZMQ \u7aef\u53e3\u6267\u884c\u3002<\/p>\n\n\n\n
      4. ipykernel \u7684\u542f\u52a8\u4e0e\u7ba1\u7406\uff08\/app\/jupyter_kernel.py\uff0c\u7ea6 470 \u884c\uff09<\/h2>\n\n\n\n
      JupyterKernel<\/code> \u7c7b\u5c01\u88c5 jupyter_client.manager.KernelManager<\/code>\uff1a<\/p>\n\n\n\n
      • \u542f\u52a8<\/strong>\uff1aKernelManager(ip=get_host_ip())<\/code> \u2192 start_kernel()<\/code>\uff0cjupyter_client \u81ea\u52a8\u751f\u6210 connection file\uff08\u672c\u6b21\u4e3a \/tmp\/tmpc80xj0x6.json<\/code>\uff09\uff0c\u518d\u8d77 client\u3001start_channels()<\/code>\uff0c\u5faa\u73af wait_for_ready(timeout=30)<\/code>\u3002\u6ce8\u610f\u6784\u9020\u65f6\u4f20\u4e86\u5bb9\u5668 hostname IP\uff0c\u4f46\u5b9e\u9645 connection file \u91cc ip<\/code> \u5b57\u6bb5\u662f 127.0.0.1<\/code>\uff085 \u4e2a ZMQ \u7aef\u53e3\u4e3a 127.0.0.1 \u4e0a\u7684\u968f\u673a\u9ad8\u4f4d\u7aef\u53e3\uff1ashell 45059 \/ iopub 45759 \/ stdin 44903 \/ control 49717 \/ hb 57453\uff0c\u4e0e netstat -tln<\/code> \u8f93\u51fa\u4e00\u4e00\u5bf9\u5e94\uff09\u3002<\/li>
      • \u521d\u59cb\u5316\u811a\u672c<\/strong>\uff1a\u6bcf\u6b21\u65b0 kernel \u542f\u52a8\u540e\u7f6e _init_script_pending=True<\/code>\uff0c\u5728\u4e0b\u4e00\u6b21 \/kernel\/execute<\/code> \u524d\u5148\u6267\u884c \/app\/ipython.py.init<\/code>\uff1b\u5931\u8d25\u5219\u6574\u4e2a\u8bf7\u6c42 500\u3002init \u811a\u672c\u5185\u5bb9\uff1amatplotlib inline + \u5168\u5957 rcParams\uff08\u4e2d\u6587\u5b57\u4f53\u63a2\u6d4b\uff1a\u626b\u63cf fontManager \u91cc\u540d\u5b57\u542b CJK\/Han\/CN\/TW\/JP \u7684\u5b57\u4f53\u8ffd\u52a0\u5230 font.family\uff09\u3001\u6ce8\u518c ImageShow.IPythonViewer<\/code> \u8ba9 PIL \u56fe\u7247\u76f4\u63a5\u4ee5 PNG \u56de\u4f20\u3002<\/li>
      • \u4fdd\u6d3b<\/strong>\uff1a\u6bcf\u6b21 execute \u524d _ensure_kernel_alive()<\/code>\u2014\u2014\u68c0\u67e5 is_alive()<\/code> \u548c kernel_info()<\/code> \u63a2\u6d3b\uff0c\u5931\u8d25\u81ea\u52a8 _start_kernel()<\/code> \u91cd\u542f\u3002<\/li>
      • \u5e76\u53d1<\/strong>\uff1akernel_server \u7528\u4e00\u628a\u5168\u5c40 asyncio.Lock<\/code>\uff0c\u6240\u6709 execute\/reset \u4e32\u884c\uff08\u5355 kernel \u6a21\u578b\uff0c\u540c\u4e00\u65f6\u523b\u53ea\u6709\u4e00\u4e2a\u6267\u884c\uff09\u3002<\/li>
      • \u4e2d\u65ad<\/strong>\uff1a\u53cc\u4fdd\u9669\u2014\u2014\u5148\u6309 PID \u53d1 SIGINT\uff08_get_kernel_pid()<\/code> \u6709 4 \u7ea7 fallback\uff1aprovisioner.process.pid \u2192 km.kernel.pid \u2192 \u6309 kernel_id \u626b psutil \u8fdb\u7a0b \u2192 \u6309 connection file \u540d\u626b\u8fdb\u7a0b\uff09\uff0c\u518d\u5c1d\u8bd5 client.interrupt()\u3002<\/li>
      • \u8d85\u65f6<\/strong>\uff1aexecute \u8d85\u8fc7 timeout \u540e\u81ea\u52a8 interrupt\uff0c\u7b49\u5f85 kernel \u56de idle\uff0c\u8fd4\u56de Execution timed out after N seconds<\/code>\u3002\u5f02\u5e38\u8def\u5f84\u8fd8\u4f1a\u81ea\u52a8\u91cd\u542f kernel\u3002<\/li>
      • \u83b7\u53d6 PID \u7684\u56db\u7ea7 fallback<\/strong> \u662f\u4e2a\u7ec6\u8282\u4eae\u70b9\uff1a\u517c\u5bb9 jupyter-client \u65b0\u65e7\u7248\u672c\uff0c\u5bf9 Hermes \u7ba1\u7406\u5b50\u8fdb\u7a0b\u6709\u53c2\u8003\u4ef7\u503c\u3002<\/li><\/ul>\n\n\n\n
        5. \u6267\u884c\u7ed3\u679c\u7684\u56de\u4f20\u534f\u8bae<\/h2>\n\n\n\n
        kernel-server \u53ea\u6d88\u8d39 iopub \u901a\u9053\uff0c\u6309 msg_type<\/code> \u5206\u6d41\uff1a<\/p>\n\n\n\n
        • stream<\/code> \u2192 \u539f\u6837\u62fc\u63a5 stdout\/stderr \u6587\u672c<\/li>
        • error<\/code> \u2192 traceback \u62fc\u63a5\u8fdb error<\/code> \u5b57\u6bb5<\/li>
        • execute_result<\/code> \u2192 \u53d6 text\/plain<\/code> \u8ffd\u52a0\u5230 output\uff1b\u6709 image\/png<\/code> \u6536\u8fdb images<\/li>
        • display_data<\/code> \u2192 \u4f18\u5148\u6536 image\/png<\/code>\uff0c\u5426\u5219 text\/plain<\/code><\/li>
        • \u7ec8\u6b62\u6761\u4ef6\uff1a\u6536\u5230\u672c msg_id \u7684 status: idle<\/code><\/li><\/ul>\n\n\n\n
          \u54cd\u5e94 JSON\uff1a{success, output(str), error, images[list[str]]}<\/code>\u2014\u2014\u56fe\u7247\u662f base64 PNG \u6570\u7ec4\u76f4\u63a5\u5185\u8054\u5728 HTTP \u54cd\u5e94\u91cc<\/strong>\uff0c\u524d\u7aef\/agent \u62ff\u5230\u5373\u53ef\u6e32\u67d3\u3002\u6ca1\u6709\u5355\u72ec\u7684\u6d41\u5f0f\u63a5\u53e3\uff0c\u662f\u4e00\u6b21\u6027\u540c\u6b65\u8fd4\u56de\uff08SSE\/WebSocket \u6d41\u5f0f\u7531\u4e91\u7aef agent \u4fa7\u81ea\u5df1\u5904\u7406\u6216\u6ca1\u6709\uff09\u3002<\/p>\n\n\n\n
          6. \u5b89\u5168\u9650\u5236\u4e0e\u62e6\u622a\u903b\u8f91\uff08\u91cd\u70b9\uff1a\u51e0\u4e4e\u6ca1\u6709\uff09<\/h2>\n\n\n\n
          kernel-server \/ jupyter_kernel \u4e24\u5c42\u6ca1\u6709\u4efb\u4f55\u4ee3\u7801\u5ba1\u67e5\u3001\u547d\u4ee4\u9ed1\u540d\u5355\u3001\u7f51\u7edc\/\u6587\u4ef6\u7cfb\u7edf\u62e6\u622a<\/strong>\u3002\u5df2\u9a8c\u8bc1\u7684\u9650\u5236\u53ea\u6709\uff1a<\/p>\n\n\n\n