{"id":10021346,"date":"2026-04-26T18:52:27","date_gmt":"2026-04-26T10:52:27","guid":{"rendered":"https:\/\/itmax.cn\/?p=10021346"},"modified":"2026-04-26T18:52:27","modified_gmt":"2026-04-26T10:52:27","slug":"%e3%80%90%e5%bc%80%e6%ba%90%e5%89%aa%e6%98%a0%e5%b0%8f%e5%8a%a9%e6%89%8b%e3%80%91%e5%bc%80%e5%8f%91%e8%80%85%e6%8c%87%e5%8d%97","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10021346","title":{"rendered":"\u3010\u5f00\u6e90\u526a\u6620\u5c0f\u52a9\u624b\u3011\u5f00\u53d1\u8005\u6307\u5357"},"content":{"rendered":"<h2>\u5f00\u53d1\u8005\u6307\u5357<\/h2>\n<h3>\u76ee\u5f55<\/h3>\n<ol>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u7b80\u4ecb\" target=\"_blank\" rel=\"noopener noreferrer\">\u7b80\u4ecb<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u9879\u76ee\u7ed3\u6784\" target=\"_blank\" rel=\"noopener noreferrer\">\u9879\u76ee\u7ed3\u6784<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6838\u5fc3\u7ec4\u4ef6\" target=\"_blank\" rel=\"noopener noreferrer\">\u6838\u5fc3\u7ec4\u4ef6<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u67b6\u6784\u6982\u89c8\" target=\"_blank\" rel=\"noopener noreferrer\">\u67b6\u6784\u6982\u89c8<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790\" target=\"_blank\" rel=\"noopener noreferrer\">\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u4f9d\u8d56\u5173\u7cfb\u5206\u6790\" target=\"_blank\" rel=\"noopener noreferrer\">\u4f9d\u8d56\u5173\u7cfb\u5206\u6790<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6027\u80fd\u8003\u8651\" target=\"_blank\" rel=\"noopener noreferrer\">\u6027\u80fd\u8003\u8651<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6545\u969c\u6392\u9664\u6307\u5357\" target=\"_blank\" rel=\"noopener noreferrer\">\u6545\u969c\u6392\u9664\u6307\u5357<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u7ed3\u8bba\" target=\"_blank\" rel=\"noopener noreferrer\">\u7ed3\u8bba<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u9644\u5f55\" target=\"_blank\" rel=\"noopener noreferrer\">\u9644\u5f55<\/a><\/li>\n<\/ol>\n<h3>\u7b80\u4ecb<\/h3>\n<p>capcut-mate \u662f\u4e00\u4e2a\u5f00\u6e90\u7684\u526a\u6620\u81ea\u52a8\u5316\u5de5\u5177\uff0c\u63d0\u4f9b\u57fa\u4e8e API \u7684\u8349\u7a3f\u7ba1\u7406\u3001\u5a92\u4f53\u7d20\u6750\u5904\u7406\u548c\u89c6\u9891\u5bfc\u51fa\u80fd\u529b\u3002\u8be5\u9879\u76ee\u91c7\u7528 Python FastAPI \u6784\u5efa\u540e\u7aef\u670d\u52a1\uff0c\u5e76\u7ed3\u5408 Electron \u6784\u5efa\u684c\u9762\u5ba2\u6237\u7aef\uff0c\u652f\u6301 Windows \u548c Linux \u5e73\u53f0\u3002\u9879\u76ee\u73b0\u5df2\u5b9e\u73b0\u5b8c\u6574\u7684\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\uff0c\u901a\u8fc7\u53ef\u9009\u4f9d\u8d56\u7ba1\u7406\u548c\u4f18\u96c5\u964d\u7ea7\u673a\u5236\uff0c\u786e\u4fdd\u5728\u4e0d\u540c\u64cd\u4f5c\u7cfb\u7edf\u4e0a\u7684\u5f00\u53d1\u4f53\u9a8c\u4e00\u81f4\u3002<\/p>\n<p>\u9879\u76ee\u73b0\u5728\u4f7f\u7528\u6761\u4ef6\u4f9d\u8d56\u5b89\u88c5\u673a\u5236\uff0c\u6839\u636e\u64cd\u4f5c\u7cfb\u7edf\u81ea\u52a8\u9009\u62e9\u5408\u9002\u7684\u4f9d\u8d56\u5305\uff0c\u907f\u514d\u5728\u4e0d\u652f\u6301\u7684\u5e73\u53f0\u4e0a\u5b89\u88c5\u4e0d\u517c\u5bb9\u7684\u7ec4\u4ef6\u3002<\/p>\n<h3>\u9879\u76ee\u7ed3\u6784<\/h3>\n<p>\u9879\u76ee\u91c7\u7528\u5206\u5c42\u67b6\u6784\u8bbe\u8ba1\uff0c\u4e3b\u8981\u5206\u4e3a\u4ee5\u4e0b\u51e0\u4e2a\u5c42\u6b21\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TB\nsubgraph &quot;\u684c\u9762\u5ba2\u6237\u7aef\u5c42&quot;\nDC[Electron Desktop Client]\nUI[React Web UI]\nend\nsubgraph &quot;API \u5c42&quot;\nAPI[FastAPI \u5e94\u7528]\nROUTER[\u8def\u7531\u5c42]\nMIDDLEWARE[\u4e2d\u95f4\u4ef6\u5c42]\nend\nsubgraph &quot;\u4e1a\u52a1\u903b\u8f91\u5c42&quot;\nSERVICE[\u670d\u52a1\u5c42]\nSCHEMAS[\u6570\u636e\u6a21\u578b]\nend\nsubgraph &quot;\u5de5\u5177\u5c42&quot;\nUTILS[\u5de5\u5177\u6a21\u5757]\nLOGGER[\u65e5\u5fd7\u7cfb\u7edf]\nDOWNLOADER[\u8349\u7a3f\u4e0b\u8f7d\u5668]\nend\nsubgraph &quot;\u5e95\u5c42\u7cfb\u7edf&quot;\nPYJY[\u526a\u6620\u81ea\u52a8\u5316]\nCONFIG[\u914d\u7f6e\u7ba1\u7406]\nTEMPLATES[\u6a21\u677f\u7cfb\u7edf]\nend\nDC --&gt; API\nUI --&gt; API\nAPI --&gt; ROUTER\nAPI --&gt; MIDDLEWARE\nROUTER --&gt; SERVICE\nSERVICE --&gt; UTILS\nSERVICE --&gt; PYJY\nUTILS --&gt; DOWNLOADER\nUTILS --&gt; LOGGER\nSERVICE --&gt; SCHEMAS\nSERVICE --&gt; CONFIG\nSERVICE --&gt; TEMPLATES<\/code><\/pre>\n<h3>\u6838\u5fc3\u7ec4\u4ef6<\/h3>\n<p>\u9879\u76ee\u5305\u542b\u591a\u4e2a\u6838\u5fc3\u7ec4\u4ef6\uff0c\u6bcf\u4e2a\u7ec4\u4ef6\u90fd\u6709\u660e\u786e\u7684\u804c\u8d23\u5206\u5de5\uff1a<\/p>\n<h4>1. \u5e94\u7528\u5165\u53e3\u7ec4\u4ef6<\/h4>\n<ul>\n<li><strong>main.py<\/strong>: FastAPI \u5e94\u7528\u5165\u53e3\uff0c\u8d1f\u8d23\u5e94\u7528\u521d\u59cb\u5316\u3001\u8def\u7531\u6ce8\u518c\u548c\u4e2d\u95f4\u4ef6\u914d\u7f6e<\/li>\n<li><strong>\u684c\u9762\u5ba2\u6237\u7aef<\/strong>: Electron \u5e94\u7528\uff0c\u63d0\u4f9b\u56fe\u5f62\u5316\u754c\u9762\u548c\u672c\u5730\u6587\u4ef6\u7ba1\u7406<\/li>\n<\/ul>\n<h4>2. \u4e2d\u95f4\u4ef6\u7ec4\u4ef6<\/h4>\n<ul>\n<li><strong>PrepareMiddleware<\/strong>: \u73af\u5883\u521d\u59cb\u5316\u4e2d\u95f4\u4ef6\uff0c\u8d1f\u8d23\u521b\u5efa\u5fc5\u8981\u7684\u76ee\u5f55\u7ed3\u6784<\/li>\n<li><strong>ResponseMiddleware<\/strong>: \u7edf\u4e00\u54cd\u5e94\u5904\u7406\u4e2d\u95f4\u4ef6\uff0c\u6807\u51c6\u5316 API \u54cd\u5e94\u683c\u5f0f<\/li>\n<\/ul>\n<h4>3. \u670d\u52a1\u7ec4\u4ef6<\/h4>\n<ul>\n<li><strong>\u8349\u7a3f\u670d\u52a1<\/strong>: \u8349\u7a3f\u521b\u5efa\u3001\u7ba1\u7406\u548c\u5bfc\u51fa\u7684\u6838\u5fc3\u4e1a\u52a1\u903b\u8f91<\/li>\n<li><strong>\u5a92\u4f53\u5904\u7406\u670d\u52a1<\/strong>: \u89c6\u9891\u3001\u97f3\u9891\u3001\u56fe\u7247\u548c\u5b57\u5e55\u7684\u5904\u7406\u80fd\u529b<\/li>\n<li><strong>\u81ea\u52a8\u5316\u670d\u52a1<\/strong>: \u526a\u6620\u5e94\u7528\u7a0b\u5e8f\u7684\u81ea\u52a8\u5316\u63a7\u5236<\/li>\n<\/ul>\n<h4>4. \u5de5\u5177\u7ec4\u4ef6<\/h4>\n<ul>\n<li><strong>\u65e5\u5fd7\u7cfb\u7edf<\/strong>: \u7ed3\u6784\u5316\u7684\u65e5\u5fd7\u8bb0\u5f55\u548c\u683c\u5f0f\u5316<\/li>\n<li><strong>\u8349\u7a3f\u4e0b\u8f7d\u5668<\/strong>: \u8fdc\u7a0b\u8349\u7a3f\u6587\u4ef6\u7684\u4e0b\u8f7d\u548c\u672c\u5730\u5316\u5904\u7406<\/li>\n<li><strong>\u914d\u7f6e\u7ba1\u7406<\/strong>: \u73af\u5883\u53d8\u91cf\u548c\u8def\u5f84\u914d\u7f6e\u7684\u96c6\u4e2d\u7ba1\u7406<\/li>\n<\/ul>\n<h3>\u67b6\u6784\u6982\u89c8<\/h3>\n<p>\u7cfb\u7edf\u91c7\u7528\u5206\u5c42\u67b6\u6784\uff0c\u5404\u5c42\u4e4b\u95f4\u901a\u8fc7\u6e05\u6670\u7684\u63a5\u53e3\u8fdb\u884c\u901a\u4fe1\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">sequenceDiagram\nparticipant Client as \u5ba2\u6237\u7aef\nparticipant API as FastAPI\nparticipant Middleware as \u4e2d\u95f4\u4ef6\nparticipant Service as \u670d\u52a1\u5c42\nparticipant Utils as \u5de5\u5177\u5c42\nparticipant Jianying as \u526a\u6620\u81ea\u52a8\u5316\nClient-&gt;&gt;API : HTTP \u8bf7\u6c42\nAPI-&gt;&gt;Middleware : \u8bf7\u6c42\u8fdb\u5165\nMiddleware-&gt;&gt;Service : \u8c03\u7528\u4e1a\u52a1\u903b\u8f91\nService-&gt;&gt;Utils : \u4f7f\u7528\u5de5\u5177\u51fd\u6570\nUtils-&gt;&gt;Jianying : \u63a7\u5236\u526a\u6620\u5e94\u7528\nJianying--&gt;&gt;Utils : \u8fd4\u56de\u6267\u884c\u7ed3\u679c\nUtils--&gt;&gt;Service : \u8fd4\u56de\u5904\u7406\u7ed3\u679c\nService--&gt;&gt;Middleware : \u8fd4\u56de\u4e1a\u52a1\u7ed3\u679c\nMiddleware--&gt;&gt;API : \u7edf\u4e00\u54cd\u5e94\u683c\u5f0f\nAPI--&gt;&gt;Client : HTTP \u54cd\u5e94<\/code><\/pre>\n<h3>\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790<\/h3>\n<h4>FastAPI \u5e94\u7528\u67b6\u6784<\/h4>\n<p>\u5e94\u7528\u91c7\u7528\u6a21\u5757\u5316\u8bbe\u8ba1\uff0c\u4e3b\u8981\u7ec4\u4ef6\u5305\u62ec\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">classDiagram\nclass FastAPIApp {\n+title : str\n+version : str\n+include_router()\n+add_middleware()\n+run()\n}\nclass Router {\n+prefix : str\n+tags : list\n+post()\n+get()\n}\nclass Middleware {\n+dispatch()\n+process_request()\n+process_response()\n}\nclass ServiceLayer {\n+business_logic()\n+validation()\n+error_handling()\n}\nFastAPIApp --&gt; Router : &quot;\u5305\u542b&quot;\nRouter --&gt; ServiceLayer : &quot;\u8c03\u7528&quot;\nFastAPIApp --&gt; Middleware : &quot;\u6ce8\u518c&quot;\nServiceLayer --&gt; ServiceLayer : &quot;\u5185\u90e8\u8c03\u7528&quot;<\/code><\/pre>\n<h4>\u4e2d\u95f4\u4ef6\u5904\u7406\u6d41\u7a0b<\/h4>\n<p>\u4e2d\u95f4\u4ef6\u7cfb\u7edf\u63d0\u4f9b\u8bf7\u6c42\u9884\u5904\u7406\u548c\u54cd\u5e94\u540e\u5904\u7406\u80fd\u529b\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">flowchart TD\nStart([\u8bf7\u6c42\u5230\u8fbe]) --&gt; Prepare[&quot;PrepareMiddleware&lt;br\/&gt;\u521b\u5efa\u76ee\u5f55\u7ed3\u6784&quot;]\nPrepare --&gt; Next[&quot;\u8c03\u7528\u4e0b\u4e00\u4e2a\u4e2d\u95f4\u4ef6&quot;]\nNext --&gt; Response[&quot;ResponseMiddleware&lt;br\/&gt;\u7edf\u4e00\u54cd\u5e94\u5904\u7406&quot;]\nResponse --&gt; Validation{&quot;\u53c2\u6570\u9a8c\u8bc1&quot;}\nValidation --&gt; |\u901a\u8fc7| Business[&quot;\u8c03\u7528\u4e1a\u52a1\u903b\u8f91&quot;]\nValidation --&gt; |\u5931\u8d25| Error422[&quot;\u5904\u7406422\u9519\u8bef&quot;]\nBusiness --&gt; Success[&quot;\u6210\u529f\u54cd\u5e94&quot;]\nError422 --&gt; ErrorResp[&quot;\u8fd4\u56de\u9519\u8bef\u54cd\u5e94&quot;]\nSuccess --&gt; ErrorCheck{&quot;\u662f\u5426\u6709\u5f02\u5e38&quot;}\nErrorCheck --&gt; |\u662f| CustomError[&quot;\u5904\u7406\u81ea\u5b9a\u4e49\u5f02\u5e38&quot;]\nErrorCheck --&gt; |\u5426| JsonFormat[&quot;JSON\u54cd\u5e94\u683c\u5f0f\u5316&quot;]\nCustomError --&gt; FinalResp[&quot;\u6700\u7ec8\u54cd\u5e94&quot;]\nJsonFormat --&gt; FinalResp\nErrorResp --&gt; FinalResp<\/code><\/pre>\n<h4>\u8349\u7a3f\u7ba1\u7406\u7cfb\u7edf<\/h4>\n<p>\u8349\u7a3f\u7ba1\u7406\u662f\u7cfb\u7edf\u7684\u6838\u5fc3\u529f\u80fd\uff0c\u5305\u542b\u5b8c\u6574\u7684\u751f\u547d\u5468\u671f\u7ba1\u7406\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">stateDiagram-v2\n[*] --&gt; \u8349\u7a3f\u521b\u5efa\n\u8349\u7a3f\u521b\u5efa --&gt; \u8349\u7a3f\u521d\u59cb\u5316 : \u521b\u5efa\u6a21\u677f\n\u8349\u7a3f\u521d\u59cb\u5316 --&gt; \u5a92\u4f53\u6dfb\u52a0 : \u6dfb\u52a0\u7d20\u6750\n\u5a92\u4f53\u6dfb\u52a0 --&gt; \u8349\u7a3f\u4fdd\u5b58 : \u4fdd\u5b58\u66f4\u6539\n\u8349\u7a3f\u4fdd\u5b58 --&gt; \u8349\u7a3f\u5bfc\u51fa : \u5bfc\u51fa\u89c6\u9891\n\u8349\u7a3f\u5bfc\u51fa --&gt; \u8349\u7a3f\u6e05\u7406 : \u6e05\u7406\u4e34\u65f6\u6587\u4ef6\n\u8349\u7a3f\u6e05\u7406 --&gt; [*]\n\u8349\u7a3f\u521b\u5efa --&gt; \u8349\u7a3f\u5220\u9664 : \u5220\u9664\u8349\u7a3f\n\u8349\u7a3f\u5220\u9664 --&gt; [*]<\/code><\/pre>\n<h4>\u526a\u6620\u81ea\u52a8\u5316\u63a7\u5236<\/h4>\n<p>\u526a\u6620\u81ea\u52a8\u5316\u63a7\u5236\u7cfb\u7edf\u63d0\u4f9b\u5b8c\u6574\u7684\u5e94\u7528\u4ea4\u4e92\u80fd\u529b\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">classDiagram\nclass JianyingController {\n+app : WindowControl\n+app_status : str\n+app_sub_status : str\n+find_and_click_draft()\n+click_export_button()\n+export_draft()\n+get_window()\n+switch_to_home()\n}\nclass ControlFinder {\n+desc_matcher()\n+class_name_matcher()\n}\nclass ExportResolution {\n+RES_8K\n+RES_4K\n+RES_2K\n+RES_1080P\n+RES_720P\n+RES_480P\n}\nclass ExportFramerate {\n+FR_24\n+FR_25\n+FR_30\n+FR_50\n+FR_60\n}\nJianyingController --&gt; ControlFinder : &quot;\u4f7f\u7528&quot;\nJianyingController --&gt; ExportResolution : &quot;\u8bbe\u7f6e&quot;\nJianyingController --&gt; ExportFramerate : &quot;\u8bbe\u7f6e&quot;<\/code><\/pre>\n<h4>\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\u67b6\u6784<\/h4>\n<p>\u9879\u76ee\u5b9e\u73b0\u4e86\u5b8c\u6574\u7684\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\uff0c\u901a\u8fc7\u53ef\u9009\u4f9d\u8d56\u7ba1\u7406\u548c\u4f18\u96c5\u964d\u7ea7\u673a\u5236\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">flowchart TD\nPlatform[\u5e73\u53f0\u68c0\u6d4b] --&gt; WinCheck{Windows?}\nWinCheck --&gt; |\u662f| WinDeps[\u52a0\u8f7dWindows\u4f9d\u8d56]\nWinCheck --&gt; |\u5426| BaseDeps[\u52a0\u8f7d\u57fa\u7840\u4f9d\u8d56]\nWinDeps --&gt; SysCheck{\u7cfb\u7edf\u5b8c\u6574\u6027?}\nSysCheck --&gt; |\u662f| FullFunc[\u5b8c\u6574\u529f\u80fd]\nSysCheck --&gt; |\u5426| Graceful[\u4f18\u96c5\u964d\u7ea7]\nBaseDeps --&gt; Graceful\nGraceful --&gt; BasicFunc[\u57fa\u7840\u529f\u80fd]\nFullFunc --&gt; AutoExport[\u81ea\u52a8\u5bfc\u51fa\u529f\u80fd]\nBasicFunc --&gt; ManualExport[\u624b\u52a8\u5bfc\u51fa\u529f\u80fd]<\/code><\/pre>\n<p>\u9879\u76ee\u73b0\u5728\u4f7f\u7528\u6761\u4ef6\u4f9d\u8d56\u5b89\u88c5\u673a\u5236\uff0c\u901a\u8fc7 <code>sys_platform<\/code> \u6761\u4ef6\u786e\u4fdd\u53ea\u5728\u652f\u6301\u7684\u5e73\u53f0\u4e0a\u5b89\u88c5\u76f8\u5e94\u7684\u4f9d\u8d56\u5305\u3002<\/p>\n<h3>\u4f9d\u8d56\u5173\u7cfb\u5206\u6790<\/h3>\n<h4>\u5916\u90e8\u4f9d\u8d56\u7ba1\u7406<\/h4>\n<p>\u9879\u76ee\u4f7f\u7528 Poetry \u8fdb\u884c\u4f9d\u8d56\u7ba1\u7406\uff0c\u4e3b\u8981\u4f9d\u8d56\u5305\u62ec\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TB\nsubgraph &quot;\u6838\u5fc3\u4f9d\u8d56&quot;\nFASTAPI[fastapi&gt;=0.100.0]\nUVICORN[&quot;uvicorn[standard]&gt;=0.35.0&quot;]\nREQUESTS[requests&gt;=2.32.5]\nend\nsubgraph &quot;\u7cfb\u7edf\u96c6\u6210&quot;\nPYWIN32[pywin32&gt;=311]\nUIAUTOMATION[uiautomation&gt;=2.0.29]\nMEDIAINFO[pymediainfo&gt;=7.0.1]\nend\nsubgraph &quot;\u4e91\u5b58\u50a8&quot;\nCOS[cos-python-sdk-v5&gt;=1.9.38]\nend\nsubgraph &quot;\u90ae\u4ef6\u9a8c\u8bc1&quot;\nEMAIL[email-validator&gt;=2.2.0]\nend\nsubgraph &quot;\u5e94\u7528\u5165\u53e3&quot;\nMAIN[main.py]\nend\nMAIN --&gt; FASTAPI\nMAIN --&gt; UVICORN\nMAIN --&gt; REQUESTS\nMAIN --&gt; PYWIN32\nMAIN --&gt; UIAUTOMATION\nMAIN --&gt; MEDIAINFO\nMAIN --&gt; COS\nMAIN --&gt; EMAIL<\/code><\/pre>\n<p>Windows \u7279\u5b9a\u4f9d\u8d56\u73b0\u5728\u901a\u8fc7\u53ef\u9009\u4f9d\u8d56\u7ec4 <code>windows<\/code> \u63d0\u4f9b\uff0c\u5e76\u4f7f\u7528 <code>sys_platform == 'win32'<\/code> \u6761\u4ef6\u786e\u4fdd\u53ea\u5728 Windows \u5e73\u53f0\u4e0a\u5b89\u88c5\u3002<\/p>\n<h4>\u53ef\u9009\u4f9d\u8d56\u7b56\u7565<\/h4>\n<p>\u9879\u76ee\u91c7\u7528\u53ef\u9009\u4f9d\u8d56\u7b56\u7565\uff0c\u5c06 Windows \u7279\u5b9a\u4f9d\u8d56\u8bbe\u4e3a\u53ef\u9009\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TD\nBaseDeps[\u57fa\u7840\u4f9d\u8d56] --&gt; Core[\u6838\u5fc3\u529f\u80fd]\nBaseDeps --&gt; CrossPlatform[\u8de8\u5e73\u53f0\u652f\u6301]\nCrossPlatform --&gt; Linux[Linux\u652f\u6301]\nCrossPlatform --&gt; Windows[Windows\u652f\u6301]\nWindows --&gt; WinSpecific[Windows\u7279\u5b9a\u529f\u80fd]\nWinSpecific --&gt; AutoExport[\u81ea\u52a8\u5bfc\u51fa]\nWinSpecific --&gt; UIAutomation[UI\u81ea\u52a8\u5316]\nCore --&gt; AllFeatures[\u5b8c\u6574\u529f\u80fd\u96c6]\nLinux --&gt; BasicFeatures[\u57fa\u7840\u529f\u80fd\u96c6]<\/code><\/pre>\n<p>\u53ef\u9009\u4f9d\u8d56\u73b0\u5728\u4f7f\u7528 <code>sys_platform<\/code> \u6761\u4ef6\uff0c\u786e\u4fdd\u4f9d\u8d56\u5b89\u88c5\u4e0e\u64cd\u4f5c\u7cfb\u7edf\u5339\u914d\u3002<\/p>\n<h4>\u5185\u90e8\u6a21\u5757\u4f9d\u8d56<\/h4>\n<p>\u5185\u90e8\u6a21\u5757\u4e4b\u95f4\u7684\u4f9d\u8d56\u5173\u7cfb\u5982\u4e0b\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TD\nMAIN[main.py] --&gt; ROUTER[src\/router\/v1.py]\nMAIN --&gt; PREPARE[src\/middlewares\/prepare.py]\nMAIN --&gt; RESPONSE[src\/middlewares\/response.py]\nMAIN --&gt; DOWNLOADER[src\/utils\/draft_downloader.py]\nMAIN --&gt; LOGGER[src\/utils\/logger.py]\nROUTER --&gt; SERVICE[src\/service\/]\nROUTER --&gt; SCHEMAS[src\/schemas\/]\nSERVICE --&gt; PYJY[src\/pyJianYingDraft\/]\nSERVICE --&gt; UTILS[src\/utils\/]\nSERVICE --&gt; CONFIG[config.py]\nPYJY --&gt; EXCEPTIONS[exceptions.py]\nUTILS --&gt; LOGGER\nUTILS --&gt; CONFIG<\/code><\/pre>\n<h3>\u6027\u80fd\u8003\u8651<\/h3>\n<p>\u7cfb\u7edf\u5728\u8bbe\u8ba1\u65f6\u5145\u5206\u8003\u8651\u4e86\u6027\u80fd\u4f18\u5316\uff1a<\/p>\n<h4>1. \u7f13\u5b58\u7b56\u7565<\/h4>\n<ul>\n<li>\u8349\u7a3f\u7f13\u5b58\uff1a\u4f7f\u7528\u5185\u5b58\u7f13\u5b58\u51cf\u5c11\u91cd\u590d\u521b\u5efa\u5f00\u9500<\/li>\n<li>\u6587\u4ef6\u4e0b\u8f7d\u7f13\u5b58\uff1a\u907f\u514d\u91cd\u590d\u4e0b\u8f7d\u76f8\u540c\u6587\u4ef6<\/li>\n<li>\u8def\u7531\u4fe1\u606f\u7f13\u5b58\uff1a\u51cf\u5c11\u8def\u7531\u6ce8\u518c\u65f6\u7684\u8ba1\u7b97\u5f00\u9500<\/li>\n<\/ul>\n<h4>2. \u5f02\u6b65\u5904\u7406<\/h4>\n<ul>\n<li>\u6587\u4ef6\u4e0b\u8f7d\u91c7\u7528\u5f02\u6b65\u6a21\u5f0f<\/li>\n<li>\u526a\u6620\u81ea\u52a8\u5316\u64cd\u4f5c\u4f7f\u7528\u975e\u963b\u585e\u7b49\u5f85<\/li>\n<li>\u65e5\u5fd7\u8bb0\u5f55\u91c7\u7528\u5f02\u6b65\u5199\u5165<\/li>\n<\/ul>\n<h4>3. \u8d44\u6e90\u7ba1\u7406<\/h4>\n<ul>\n<li>\u8fde\u63a5\u6c60\u7ba1\u7406\u6570\u636e\u5e93\u8fde\u63a5<\/li>\n<li>\u6587\u4ef6\u53e5\u67c4\u81ea\u52a8\u91ca\u653e<\/li>\n<li>\u5185\u5b58\u4f7f\u7528\u76d1\u63a7\u548c\u56de\u6536<\/li>\n<\/ul>\n<h4>4. \u7f51\u7edc\u4f18\u5316<\/h4>\n<ul>\n<li>HTTP \u8bf7\u6c42\u8d85\u65f6\u8bbe\u7f6e<\/li>\n<li>\u91cd\u8bd5\u673a\u5236\u548c\u9000\u907f\u7b97\u6cd5<\/li>\n<li>\u8fde\u63a5\u590d\u7528\u548c\u6301\u4e45\u8fde\u63a5<\/li>\n<\/ul>\n<h4>5. \u8de8\u5e73\u53f0\u6027\u80fd\u4f18\u5316<\/h4>\n<ul>\n<li>\u6761\u4ef6\u5bfc\u5165\u51cf\u5c11\u4e0d\u5fc5\u8981\u7684\u6a21\u5757\u52a0\u8f7d<\/li>\n<li>\u5e73\u53f0\u7279\u5b9a\u529f\u80fd\u7684\u5ef6\u8fdf\u521d\u59cb\u5316<\/li>\n<li>\u4f18\u96c5\u964d\u7ea7\u907f\u514d\u529f\u80fd\u7f3a\u5931\u65f6\u7684\u6027\u80fd\u635f\u5931<\/li>\n<\/ul>\n<p>\u9879\u76ee\u73b0\u5728\u4f7f\u7528\u6761\u4ef6\u5bfc\u5165\u673a\u5236\uff0c\u907f\u514d\u5728\u4e0d\u652f\u6301\u7684\u5e73\u53f0\u4e0a\u52a0\u8f7d\u4e0d\u517c\u5bb9\u7684\u6a21\u5757\uff0c\u63d0\u9ad8\u542f\u52a8\u6027\u80fd\u3002<\/p>\n<h3>\u6545\u969c\u6392\u9664\u6307\u5357<\/h3>\n<h4>\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\u95ee\u9898<\/h4>\n<ol>\n<li>\n<p><strong>Windows \u4e0a\u7f3a\u5c11\u4f9d\u8d56<\/strong><\/p>\n<ul>\n<li>\u68c0\u67e5\u662f\u5426\u6b63\u786e\u5b89\u88c5\u4e86 Windows \u53ef\u9009\u4f9d\u8d56<\/li>\n<li>\u9a8c\u8bc1 pywin32 \u548c uiautomation \u662f\u5426\u6b63\u786e\u5b89\u88c5<\/li>\n<li>\u786e\u8ba4 Windows \u7248\u672c\u517c\u5bb9\u6027<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>Linux \u4e0a\u529f\u80fd\u53d7\u9650<\/strong><\/p>\n<ul>\n<li>\u786e\u8ba4\u57fa\u7840\u4f9d\u8d56\u5df2\u6b63\u786e\u5b89\u88c5<\/li>\n<li>\u9a8c\u8bc1\u81ea\u52a8\u5bfc\u51fa\u529f\u80fd\u662f\u5426\u6309\u9884\u671f\u964d\u7ea7<\/li>\n<li>\u68c0\u67e5\u65e5\u5fd7\u8f93\u51fa\u786e\u8ba4\u529f\u80fd\u72b6\u6001<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u5bfc\u5165\u9519\u8bef<\/strong><\/p>\n<ul>\n<li>\u68c0\u67e5 sys.platform \u662f\u5426\u6b63\u786e\u8bc6\u522b<\/li>\n<li>\u9a8c\u8bc1\u53ef\u9009\u4f9d\u8d56\u7684\u6761\u4ef6\u5b89\u88c5<\/li>\n<li>\u786e\u8ba4\u6a21\u5757\u8def\u5f84\u914d\u7f6e\u6b63\u786e<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h4>\u9519\u8bef\u5904\u7406\u6a21\u5f0f<\/h4>\n<p>\u7cfb\u7edf\u91c7\u7528\u7edf\u4e00\u7684\u9519\u8bef\u5904\u7406\u6a21\u5f0f\uff1a<\/p>\n<pre style=\"display:none;\"><code class=\"mermaid\">flowchart TD\nRequest[\u8bf7\u6c42\u5904\u7406] --&gt; PlatformCheck{\u5e73\u53f0\u68c0\u67e5}\nPlatformCheck --&gt; WinCheck{Windows?}\nWinCheck --&gt; |\u662f| WinImport[\u5bfc\u5165Windows\u6a21\u5757]\nWinCheck --&gt; |\u5426| BaseImport[\u5bfc\u5165\u57fa\u7840\u6a21\u5757]\nWinImport --&gt; ImportCheck{\u5bfc\u5165\u6210\u529f?}\nImportCheck --&gt; |\u662f| WinReady[Windows\u529f\u80fd\u5c31\u7eea]\nImportCheck --&gt; |\u5426| GracefulDowngrade[\u4f18\u96c5\u964d\u7ea7]\nBaseImport --&gt; BaseReady[\u57fa\u7840\u529f\u80fd\u5c31\u7eea]\nGracefulDowngrade --&gt; BaseReady\nWinReady --&gt; Validate{\u53c2\u6570\u9a8c\u8bc1}\nBaseReady --&gt; Validate\nValidate --&gt; |\u901a\u8fc7| Business[\u4e1a\u52a1\u903b\u8f91]\nValidate --&gt; |\u5931\u8d25| ParamError[\u53c2\u6570\u9a8c\u8bc1\u9519\u8bef]\nBusiness --&gt; Success{\u4e1a\u52a1\u6210\u529f}\nSuccess --&gt; |\u662f| SuccessResp[\u6210\u529f\u54cd\u5e94]\nSuccess --&gt; |\u5426| BusinessException[\u4e1a\u52a1\u5f02\u5e38]\nParamError --&gt; ErrorResp[\u9519\u8bef\u54cd\u5e94]\nBusinessException --&gt; ErrorResp\nErrorResp --&gt; Log[\u65e5\u5fd7\u8bb0\u5f55]<\/code><\/pre>\n<h3>\u7ed3\u8bba<\/h3>\n<p>capcut-mate \u9879\u76ee\u5c55\u73b0\u4e86\u826f\u597d\u7684\u8f6f\u4ef6\u5de5\u7a0b\u5b9e\u8df5\uff0c\u91c7\u7528\u5206\u5c42\u67b6\u6784\u8bbe\u8ba1\u3001\u6a21\u5757\u5316\u7ec4\u4ef6\u548c\u5b8c\u5584\u7684\u9519\u8bef\u5904\u7406\u673a\u5236\u3002\u9879\u76ee\u73b0\u5df2\u5b9e\u73b0\u5b8c\u6574\u7684\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\uff0c\u901a\u8fc7\u53ef\u9009\u4f9d\u8d56\u7ba1\u7406\u548c\u4f18\u96c5\u964d\u7ea7\u673a\u5236\uff0c\u786e\u4fdd\u5728\u4e0d\u540c\u64cd\u4f5c\u7cfb\u7edf\u4e0a\u7684\u5f00\u53d1\u4f53\u9a8c\u4e00\u81f4\u3002\u9879\u76ee\u63d0\u4f9b\u4e86\u5b8c\u6574\u7684\u8349\u7a3f\u7ba1\u7406\u548c\u526a\u6620\u81ea\u52a8\u5316\u80fd\u529b\uff0c\u4e3a\u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u6e05\u6670\u7684\u6269\u5c55\u8def\u5f84\u548c\u7ef4\u62a4\u6307\u5357\u3002<\/p>\n<p>\u9879\u76ee\u73b0\u5728\u5177\u5907\u5b8c\u5584\u7684\u8de8\u5e73\u53f0\u5f00\u53d1\u652f\u6301\uff0c\u901a\u8fc7\u6761\u4ef6\u4f9d\u8d56\u5b89\u88c5\u548c\u4f18\u96c5\u964d\u7ea7\u673a\u5236\uff0c\u4e3a\u4e0d\u540c\u5e73\u53f0\u7684\u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u6700\u4f73\u7684\u5f00\u53d1\u4f53\u9a8c\u3002<\/p>\n<h3>\u9644\u5f55<\/h3>\n<h4>\u5f00\u53d1\u73af\u5883\u642d\u5efa\u6b65\u9aa4<\/h4>\n<h5>Windows \u5e73\u53f0\uff08\u5b8c\u6574\u529f\u80fd\uff09<\/h5>\n<p>\u5728 Windows \u4e0a\u5b89\u88c5\u5b8c\u6574\u529f\u80fd\uff0c\u5305\u62ec UI \u81ea\u52a8\u5316\uff1a<\/p>\n<pre><code class=\"bash\"># \u4f7f\u7528 uv \u5b89\u88c5\uff08\u63a8\u8350\uff09\nuv sync\n\n# \u6216\u8005\u4f7f\u7528 pip \u5b89\u88c5 Windows \u53ef\u9009\u4f9d\u8d56\npip install -e .[windows]<\/code><\/pre>\n<p>\u8fd9\u5c06\u5b89\u88c5\u6240\u6709\u4f9d\u8d56\uff0c\u5305\u62ec\uff1a<\/p>\n<ul>\n<li><code>pywin32<\/code> &#8211; Windows API \u63a5\u53e3<\/li>\n<li><code>uiautomation<\/code> &#8211; UI \u81ea\u52a8\u5316\u5e93<\/li>\n<\/ul>\n<h5>Linux \u5e73\u53f0\uff08\u57fa\u7840\u529f\u80fd\uff09<\/h5>\n<p>\u5728 Linux \u4e0a\u5b89\u88c5\u57fa\u7840\u529f\u80fd\uff0cUI \u81ea\u52a8\u5316\u76f8\u5173\u529f\u80fd\u5c06\u4e0d\u53ef\u7528\uff1a<\/p>\n<pre><code class=\"bash\"># \u4f7f\u7528 uv \u5b89\u88c5\uff08\u63a8\u8350\uff09\nuv sync\n\n# \u6216\u8005\u4f7f\u7528 pip \u5b89\u88c5\u57fa\u7840\u4f9d\u8d56\npip install -e .<\/code><\/pre>\n<p>\u8fd9\u5c06\u53ea\u5b89\u88c5\u8de8\u5e73\u53f0\u4f9d\u8d56\uff0c\u4e0d\u5305\u62ec Windows \u7279\u5b9a\u7684\u5e93\u3002<\/p>\n<h5>\u73af\u5883\u53d8\u91cf\u914d\u7f6e<\/h5>\n<p>\u65e0\u8bba\u5728\u54ea\u4e2a\u5e73\u53f0\uff0c\u90fd\u9700\u8981\u914d\u7f6e\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\uff1a<\/p>\n<pre><code class=\"bash\"># \u57fa\u7840\u914d\u7f6e\nexport DRAFT_DIR=&quot;\/path\/to\/drafts&quot;\nexport OUTPUT_DIR=&quot;\/path\/to\/output&quot;\n\n# \u817e\u8baf\u4e91\u914d\u7f6e\uff08\u53ef\u9009\uff09\nexport SECRET_ID=&quot;your_secret_id&quot;\nexport SECRET_KEY=&quot;your_secret_key&quot;\nexport REGION=&quot;your_region&quot;\nexport BUCKET=&quot;your_bucket&quot;<\/code><\/pre>\n<h5>\u4f7f\u7528\u793a\u4f8b<\/h5>\n<h6>\u5728 Windows \u4e0a\u8fd0\u884c\u5b8c\u6574\u670d\u52a1<\/h6>\n<pre><code class=\"bash\"># \u542f\u52a8 API \u670d\u52a1\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# \u89c6\u9891\u81ea\u52a8\u5bfc\u51fa\u529f\u80fd\u53ef\u7528<\/code><\/pre>\n<h6>\u5728 Linux \u4e0a\u8fd0\u884c\u57fa\u7840\u670d\u52a1<\/h6>\n<pre><code class=\"bash\"># \u542f\u52a8 API \u670d\u52a1\nuvicorn main:app --host 0.0.0.0 --port 8000\n\n# \u6ce8\u610f\uff1a\u89c6\u9891\u81ea\u52a8\u5bfc\u51fa\u529f\u80fd\u4e0d\u53ef\u7528\n# \u53ef\u4ee5\u4f7f\u7528 \/gen_video \u63a5\u53e3\uff0c\u4f46\u4f1a\u8fd4\u56de\u63d0\u793a\u4fe1\u606f<\/code><\/pre>\n<h4>\u8de8\u5e73\u53f0\u6d4b\u8bd5\u7b56\u7565<\/h4>\n<h5>CI\/CD \u8de8\u5e73\u53f0\u6d4b\u8bd5<\/h5>\n<p>\u9879\u76ee\u5305\u542b\u4e13\u95e8\u7684 CI\/CD \u6d4b\u8bd5\u811a\u672c\uff0c\u7528\u4e8e\u9a8c\u8bc1\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\uff1a<\/p>\n<pre><code class=\"bash\"># \u8fd0\u884c CI \u4f9d\u8d56\u6d4b\u8bd5\npython tests\/test_ci_dependencies.py\n\n# \u8fd0\u884c\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\u6d4b\u8bd5\npython tests\/test_cross_platform.py<\/code><\/pre>\n<p>\u8fd9\u4e9b\u811a\u672c\u4f1a\u81ea\u52a8\u68c0\u6d4b\u8fd0\u884c\u73af\u5883\u5e76\u9a8c\u8bc1\uff1a<\/p>\n<ul>\n<li>\u57fa\u7840\u4f9d\u8d56\u5b89\u88c5<\/li>\n<li>\u5e73\u53f0\u7279\u5b9a\u4f9d\u8d56\u5904\u7406<\/li>\n<li>\u529f\u80fd\u6a21\u5757\u5bfc\u5165<\/li>\n<\/ul>\n<p>CI\/CD \u73b0\u5728\u4f7f\u7528 <code>uv sync<\/code> \u800c\u4e0d\u662f <code>uv sync --all-extras<\/code>\uff0c\u907f\u514d\u5728 Linux \u73af\u5883\u4e2d\u5b89\u88c5 Windows \u7279\u5b9a\u4f9d\u8d56\u3002<\/p>\n<h5>\u6d4b\u8bd5\u8986\u76d6\u8303\u56f4<\/h5>\n<ol>\n<li>\n<p><strong>\u57fa\u7840\u4f9d\u8d56\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>\u9a8c\u8bc1\u6838\u5fc3\u4f9d\u8d56\u7684\u6b63\u786e\u5b89\u88c5<\/li>\n<li>\u68c0\u67e5\u53ef\u9009\u4f9d\u8d56\u7684\u6761\u4ef6\u5b89\u88c5<\/li>\n<li>\u786e\u8ba4\u6a21\u5757\u5bfc\u5165\u7684\u5b8c\u6574\u6027<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u5e73\u53f0\u7279\u5b9a\u529f\u80fd\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>Windows \u5e73\u53f0\u7684 UI \u81ea\u52a8\u5316\u529f\u80fd<\/li>\n<li>Linux \u5e73\u53f0\u7684\u5360\u4f4d\u7b26\u529f\u80fd<\/li>\n<li>\u4f18\u96c5\u964d\u7ea7\u673a\u5236\u7684\u6b63\u786e\u6027<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>CI\/CD \u73af\u5883\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>uv sync \u7684\u6b63\u786e\u6267\u884c<\/li>\n<li>\u53ef\u9009\u4f9d\u8d56\u7684\u667a\u80fd\u8df3\u8fc7<\/li>\n<li>\u5e73\u53f0\u68c0\u6d4b\u7684\u51c6\u786e\u6027<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h4>Docker \u5bb9\u5668\u5316\u90e8\u7f72<\/h4>\n<h5>Windows Docker\uff08\u63a8\u8350\u7528\u4e8e\u751f\u4ea7\uff09<\/h5>\n<pre><code class=\"dockerfile\">FROM python:3.11-windowsservercore-ltsc2022\n\nWORKDIR \/app\nCOPY . .\n\n# \u5b89\u88c5\u5b8c\u6574\u4f9d\u8d56\nRUN pip install -e .[windows]\n\nEXPOSE 8000\nCMD [&quot;uvicorn&quot;, &quot;main:app&quot;, &quot;--host&quot;, &quot;0.0.0.0&quot;, &quot;--port&quot;, &quot;8000&quot;]<\/code><\/pre>\n<h5>Linux Docker<\/h5>\n<pre><code class=\"dockerfile\">FROM python:3.11-slim\n\nWORKDIR \/app\nCOPY . .\n\n# \u5b89\u88c5\u57fa\u7840\u4f9d\u8d56\nRUN pip install -e .\n\nEXPOSE 8000\nCMD [&quot;uvicorn&quot;, &quot;main:app&quot;, &quot;--host&quot;, &quot;0.0.0.0&quot;, &quot;--port&quot;, &quot;8000&quot;]<\/code><\/pre>\n<p>Docker \u914d\u7f6e\u73b0\u5728\u652f\u6301\u4e24\u79cd\u90e8\u7f72\u6a21\u5f0f\uff0c\u5206\u522b\u9488\u5bf9 Windows \u548c Linux \u5e73\u53f0\u3002<\/p>\n<h4>CI\/CD \u96c6\u6210<\/h4>\n<h5>GitHub Actions \u5de5\u4f5c\u6d41<\/h5>\n<p>\u9879\u76ee\u5305\u542b\u5b8c\u6574\u7684 CI\/CD \u914d\u7f6e\uff0c\u652f\u6301\u8de8\u5e73\u53f0\u6784\u5efa\uff1a<\/p>\n<pre><code class=\"yaml\"># \u4e3b\u8981\u5de5\u4f5c\u6d41 - Docker \u6784\u5efa\nname: Docker Image CI Dev\non:\n  push:\n    branches: [ &quot;main&quot;, &quot;dev&quot; ]\n    tags:\n      - 'v*'\n  pull_request:\n    branches: [ &quot;main&quot;, &quot;dev&quot; ]\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      # \u5b89\u88c5 uv \u73af\u5883\n      - name: \u5b89\u88c5uv\n        uses: astral-sh\/setup-uv@v2\n        with:\n          version: &quot;0.8.11&quot;\n          enable-cache: true\n\n      # \u53ea\u5b89\u88c5\u57fa\u7840\u4f9d\u8d56\uff0c\u907f\u514d\u5e73\u53f0\u7279\u5b9a\u4f9d\u8d56\n      - name: \u5b89\u88c5\u57fa\u7840\u4f9d\u8d56\n        run: uv sync\n\n      # \u6784\u5efa Docker \u955c\u50cf\n      - name: \u6784\u5efa\u5e76\u63a8\u9001Docker\u955c\u50cf\n        uses: docker\/build-push-action@v5\n        with:\n          context: .\n          file: .\/Dockerfile\n          push: ${{ github.event_name != 'pull_request' }}\n          tags: ${{ steps.meta.outputs.tags }}<\/code><\/pre>\n<p>CI\/CD \u5de5\u4f5c\u6d41\u73b0\u5728\u4f7f\u7528 <code>uv sync<\/code> \u800c\u4e0d\u662f <code>uv sync --all-extras<\/code>\uff0c\u786e\u4fdd\u5728 Linux \u73af\u5883\u4e2d\u6b63\u786e\u8df3\u8fc7 Windows \u7279\u5b9a\u4f9d\u8d56\u3002<\/p>\n<h4>\u8de8\u5e73\u53f0\u5f00\u53d1\u6700\u4f73\u5b9e\u8df5<\/h4>\n<h5>1. \u5f00\u53d1\u73af\u5883\u9009\u62e9<\/h5>\n<ul>\n<li><strong>Windows \u5f00\u53d1<\/strong>: \u4f7f\u7528\u5b8c\u6574\u4f9d\u8d56\uff0c\u5305\u62ec UI \u81ea\u52a8\u5316\u529f\u80fd<\/li>\n<li><strong>Linux \u5f00\u53d1<\/strong>: \u4f7f\u7528\u57fa\u7840\u4f9d\u8d56\uff0c\u4e13\u6ce8\u4e8e API \u529f\u80fd\u5f00\u53d1<\/li>\n<li><strong>\u8de8\u5e73\u53f0\u5f00\u53d1<\/strong>: \u4f7f\u7528\u6761\u4ef6\u5bfc\u5165\u673a\u5236\uff0c\u786e\u4fdd\u4ee3\u7801\u5728\u4e0d\u540c\u5e73\u53f0\u4e0a\u7684\u517c\u5bb9\u6027<\/li>\n<\/ul>\n<h5>2. \u4ee3\u7801\u7f16\u5199\u89c4\u8303<\/h5>\n<ul>\n<li>\u4f7f\u7528 <code>sys.platform<\/code> \u6216 <code>sys.platform.startswith()<\/code> \u8fdb\u884c\u5e73\u53f0\u68c0\u67e5<\/li>\n<li>\u4e3a\u4e0d\u652f\u6301\u7684\u529f\u80fd\u63d0\u4f9b\u4f18\u96c5\u964d\u7ea7\u65b9\u6848<\/li>\n<li>\u4f7f\u7528 try-except \u5904\u7406\u53ef\u9009\u4f9d\u8d56\u7684\u5bfc\u5165\u9519\u8bef<\/li>\n<\/ul>\n<h5>3. \u6d4b\u8bd5\u7b56\u7565<\/h5>\n<ul>\n<li>\u5728\u672c\u5730\u5f00\u53d1\u73af\u5883\u4e2d\u9a8c\u8bc1\u6838\u5fc3\u529f\u80fd<\/li>\n<li>\u4f7f\u7528 CI\/CD \u786e\u4fdd\u8de8\u5e73\u53f0\u517c\u5bb9\u6027<\/li>\n<li>\u5b9a\u671f\u8fd0\u884c\u8de8\u5e73\u53f0\u6d4b\u8bd5\u811a\u672c<\/li>\n<\/ul>\n<h5>4. \u90e8\u7f72\u8003\u8651<\/h5>\n<ul>\n<li>\u751f\u4ea7\u73af\u5883\u4f7f\u7528 Docker \u5bb9\u5668\u5316\u90e8\u7f72<\/li>\n<li>\u6839\u636e\u76ee\u6807\u5e73\u53f0\u9009\u62e9\u5408\u9002\u7684 Docker \u57fa\u7840\u955c\u50cf<\/li>\n<li>\u786e\u4fdd\u4f9d\u8d56\u5b89\u88c5\u8fc7\u7a0b\u7684\u5e73\u53f0\u517c\u5bb9\u6027<\/li>\n<\/ul>\n<h4>API \u6d4b\u8bd5\u7b56\u7565<\/h4>\n<ol>\n<li>\n<p><strong>\u5355\u5143\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>\u4f7f\u7528 pytest \u8fdb\u884c\u5355\u5143\u6d4b\u8bd5<\/li>\n<li>\u8986\u76d6\u6838\u5fc3\u4e1a\u52a1\u903b\u8f91<\/li>\n<li>\u6a21\u62df\u5916\u90e8\u4f9d\u8d56<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u96c6\u6210\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>\u6d4b\u8bd5\u5b8c\u6574\u7684 API \u5de5\u4f5c\u6d41<\/li>\n<li>\u9a8c\u8bc1\u526a\u6620\u81ea\u52a8\u5316\u529f\u80fd<\/li>\n<li>\u68c0\u67e5\u9519\u8bef\u5904\u7406\u673a\u5236<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u6027\u80fd\u6d4b\u8bd5<\/strong><\/p>\n<ul>\n<li>\u538b\u529b\u6d4b\u8bd5\u8349\u7a3f\u521b\u5efa<\/li>\n<li>\u6d4b\u8bd5\u5e76\u53d1\u5904\u7406\u80fd\u529b<\/li>\n<li>\u76d1\u63a7\u8d44\u6e90\u4f7f\u7528\u60c5\u51b5<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h4>\u8d21\u732e\u6307\u5357<\/h4>\n<ol>\n<li>\n<p><strong>\u4ee3\u7801\u89c4\u8303<\/strong><\/p>\n<ul>\n<li>\u9075\u5faa PEP 8 \u7f16\u7801\u6807\u51c6<\/li>\n<li>\u4f7f\u7528\u7c7b\u578b\u6ce8\u89e3<\/li>\n<li>\u7f16\u5199\u6e05\u6670\u7684\u6587\u6863\u5b57\u7b26\u4e32<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u63d0\u4ea4\u89c4\u8303<\/strong><\/p>\n<ul>\n<li>\u4f7f\u7528 Conventional Commits \u683c\u5f0f<\/li>\n<li>\u63d0\u4f9b\u8be6\u7ec6\u7684\u53d8\u66f4\u63cf\u8ff0<\/li>\n<li>\u5305\u542b\u6d4b\u8bd5\u7528\u4f8b<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u5ba1\u67e5\u6d41\u7a0b<\/strong><\/p>\n<ul>\n<li>\u4ee3\u7801\u5ba1\u67e5\u5fc5\u987b\u901a\u8fc7<\/li>\n<li>\u6d4b\u8bd5\u8986\u76d6\u7387\u8981\u6c42<\/li>\n<li>\u6027\u80fd\u57fa\u51c6\u6d4b\u8bd5<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>\u8de8\u5e73\u53f0\u517c\u5bb9\u6027<\/strong><\/p>\n<ul>\n<li>\u65b0\u529f\u80fd\u9700\u652f\u6301\u8de8\u5e73\u53f0<\/li>\n<li>\u53ef\u9009\u4f9d\u8d56\u7684\u6b63\u786e\u4f7f\u7528<\/li>\n<li>\u4f18\u96c5\u964d\u7ea7\u7684\u5b9e\u73b0<\/li>\n<li>\u5168\u9762\u7684\u6d4b\u8bd5\u8986\u76d6<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p>\u8d21\u732e\u6307\u5357\u73b0\u5728\u5f3a\u8c03\u8de8\u5e73\u53f0\u517c\u5bb9\u6027\u548c\u6761\u4ef6\u4f9d\u8d56\u7684\u6b63\u786e\u4f7f\u7528\u3002<\/p>\n<p><a href=\"https:\/\/segmentfault.com\/a\/1190000047730941\">https:\/\/segmentfault.com\/a\/1190000047730941<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5f00\u53d1\u8005\u6307\u5357 \u76ee\u5f55 \u7b80\u4ecb \u9879\u76ee\u7ed3\u6784 \u6838\u5fc3\u7ec4\u4ef6 \u67b6\u6784\u6982\u89c8 \u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790 \u4f9d\u8d56\u5173\u7cfb\u5206\u6790 \u6027\u80fd\u8003\u8651 \u6545\u969c\u6392\u9664\u6307\u5357 \u7ed3\u8bba [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[4],"tags":[],"class_list":["post-10021346","post","type-post","status-publish","format-standard","hentry","category-share"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021346","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10021346"}],"version-history":[{"count":0,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021346\/revisions"}],"wp:attachment":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10021346"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10021346"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10021346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}