{"id":10,"date":"2026-09-08T00:50:05","date_gmt":"2026-09-07T16:50:05","guid":{"rendered":"https:\/\/www.ssouq.xyz\/index.php\/2026\/09\/08\/ai-%e8%bd%af%e4%bb%b6%e8%ae%be%e8%ae%a1%e9%a1%b9%e7%9b%ae%e8%a7%84%e8%8c%83\/"},"modified":"2026-09-08T00:50:05","modified_gmt":"2026-09-07T16:50:05","slug":"ai-%e8%bd%af%e4%bb%b6%e8%ae%be%e8%ae%a1%e9%a1%b9%e7%9b%ae%e8%a7%84%e8%8c%83","status":"publish","type":"post","link":"https:\/\/www.ssouq.xyz\/index.php\/2026\/09\/08\/ai-%e8%bd%af%e4%bb%b6%e8%ae%be%e8%ae%a1%e9%a1%b9%e7%9b%ae%e8%a7%84%e8%8c%83\/","title":{"rendered":"AI \u8f6f\u4ef6\u8bbe\u8ba1\u9879\u76ee\u89c4\u8303"},"content":{"rendered":"<h1 id=\"ai\">AI \u8f6f\u4ef6\u8bbe\u8ba1\u9879\u76ee\u89c4\u8303<\/h1>\n<blockquote>\n<p><strong>Technical Specification v1.0<\/strong><br \/>\n\u6a21\u5757\u5316\u67b6\u6784\u4e0e\u8fed\u4ee3\u6f14\u8fdb\u6307\u5357 \u2014\u2014 \u4e3a AI \u9a71\u52a8\u7684\u8f6f\u4ef6\u9879\u76ee\u5efa\u7acb\u53ef\u7ef4\u62a4\u3001\u53ef\u6269\u5c55\u7684\u5de5\u7a0b\u6807\u51c6<\/p>\n<\/blockquote>\n<table>\n<thead>\n<tr>\n<th>\u7248\u672c<\/th>\n<th>\u65e5\u671f<\/th>\n<th>\u9002\u7528\u8303\u56f4<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1.0<\/td>\n<td>2026-09<\/td>\n<td>\u5168\u9879\u76ee<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2 id=\"_1\">\u76ee\u5f55<\/h2>\n<ol>\n<li><a href=\"#1-\u89c4\u8303\u6982\u8ff0\">\u89c4\u8303\u6982\u8ff0<\/a><\/li>\n<li><a href=\"#2-\u67b6\u6784\u8bbe\u8ba1\u539f\u5219\">\u67b6\u6784\u8bbe\u8ba1\u539f\u5219<\/a><\/li>\n<li><a href=\"#3-\u6a21\u5757\u4f53\u7cfb\u8bbe\u8ba1\">\u6a21\u5757\u4f53\u7cfb\u8bbe\u8ba1<\/a><\/li>\n<li><a href=\"#4-\u9879\u76ee\u76ee\u5f55\u7ed3\u6784\">\u9879\u76ee\u76ee\u5f55\u7ed3\u6784<\/a><\/li>\n<li><a href=\"#5-ai-\u80fd\u529b\u5c42\u89c4\u8303\">AI \u80fd\u529b\u5c42\u89c4\u8303<\/a><\/li>\n<li><a href=\"#6-\u6570\u636e\u5c42\u89c4\u8303\">\u6570\u636e\u5c42\u89c4\u8303<\/a><\/li>\n<li><a href=\"#7-\u63a5\u53e3\u5c42\u89c4\u8303\">\u63a5\u53e3\u5c42\u89c4\u8303<\/a><\/li>\n<li><a href=\"#8-\u8fed\u4ee3\u6f14\u8fdb\u673a\u5236\">\u8fed\u4ee3\u6f14\u8fdb\u673a\u5236<\/a><\/li>\n<li><a href=\"#9-\u5de5\u7a0b\u5b9e\u8df5\u89c4\u8303\">\u5de5\u7a0b\u5b9e\u8df5\u89c4\u8303<\/a><\/li>\n<li><a href=\"#10-\u534f\u4f5c\u4e0e\u53d1\u5e03\u89c4\u8303\">\u534f\u4f5c\u4e0e\u53d1\u5e03\u89c4\u8303<\/a><\/li>\n<\/ol>\n<hr \/>\n<h2 id=\"1\">1. \u89c4\u8303\u6982\u8ff0<\/h2>\n<p>AI \u8f6f\u4ef6\u9879\u76ee\u7684\u6838\u5fc3\u77db\u76fe\u5728\u4e8e\uff1a\u6a21\u578b\u80fd\u529b\u5feb\u901f\u53d8\u5316\uff0c\u800c\u5de5\u7a0b\u7ed3\u6784\u9700\u8981\u957f\u671f\u7a33\u5b9a\u3002\u672c\u89c4\u8303\u7684\u76ee\u6807\u662f\u5efa\u7acb\u4e00\u5957<strong>\u6a21\u5757\u81ea\u6cbb\u3001\u63a5\u53e3\u5951\u7ea6\u3001\u6e10\u8fdb\u589e\u5f3a<\/strong>\u7684\u9879\u76ee\u7ed3\u6784\u6807\u51c6\uff0c\u8ba9\u56e2\u961f\u80fd\u591f\u5728\u4e0d\u7275\u52a8\u5168\u5c40\u7684\u524d\u63d0\u4e0b\u66ff\u6362\u3001\u5347\u7ea7\u6216\u65b0\u589e\u4efb\u4f55\u5355\u4e2a\u6a21\u5757\u3002<\/p>\n<h3 id=\"_2\">\u9002\u7528\u8303\u56f4<\/h3>\n<p>\u672c\u89c4\u8303\u9002\u7528\u4e8e\u6240\u6709\u5305\u542b AI \u80fd\u529b\u7684\u8f6f\u4ef6\u9879\u76ee\uff0c\u6db5\u76d6\u6a21\u578b\u63a8\u7406\u670d\u52a1\u3001\u6570\u636e\u5904\u7406\u7ba1\u9053\u3001\u5e94\u7528\u4e1a\u52a1\u903b\u8f91\u53ca\u5bf9\u5916\u63a5\u53e3\u3002\u65e0\u8bba\u9879\u76ee\u91c7\u7528\u5355\u4f53\u8fd8\u662f\u5fae\u670d\u52a1\u67b6\u6784\uff0c\u6a21\u5757\u5c42\u9762\u7684\u8bbe\u8ba1\u7ea6\u5b9a\u4e00\u81f4\u3002<\/p>\n<h3 id=\"_3\">\u6838\u5fc3\u8bbe\u8ba1\u54f2\u5b66<\/h3>\n<table>\n<thead>\n<tr>\n<th>\u539f\u5219<\/th>\n<th>\u8bf4\u660e<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>\u6a21\u5757\u81ea\u6cbb<\/strong><\/td>\n<td>\u6bcf\u4e2a\u6a21\u5757\u62e5\u6709\u72ec\u7acb\u7684\u76ee\u5f55\u3001\u63a5\u53e3\u5b9a\u4e49\u3001\u6d4b\u8bd5\u5957\u4ef6\u548c\u7248\u672c\u53f7\u3002\u6a21\u5757\u5185\u90e8\u7684\u7ed3\u6784\u51b3\u7b56\u7531\u6a21\u5757\u8d1f\u8d23\u4eba\u5168\u6743\u51b3\u5b9a\uff0c\u5916\u90e8\u4e0d\u5e72\u9884\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>\u63a5\u53e3\u5951\u7ea6<\/strong><\/td>\n<td>\u6a21\u5757\u4e4b\u95f4\u901a\u8fc7\u663e\u5f0f\u58f0\u660e\u7684\u63a5\u53e3\u901a\u4fe1\uff0c\u800c\u975e\u76f4\u63a5\u5f15\u7528\u5185\u90e8\u5b9e\u73b0\u3002\u63a5\u53e3\u53d8\u66f4\u9700\u7ecf\u8bc4\u5ba1\u6d41\u7a0b\uff0c\u5e76\u9075\u5faa\u7248\u672c\u517c\u5bb9\u627f\u8bfa\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>\u6e10\u8fdb\u589e\u5f3a<\/strong><\/td>\n<td>\u65b0\u529f\u80fd\u4ee5\u65b0\u6a21\u5757\u6216\u6a21\u5757\u6269\u5c55\u5f62\u5f0f\u52a0\u5165\uff0c\u800c\u975e\u4fee\u6539\u5df2\u6709\u6a21\u5757\u7684\u6838\u5fc3\u903b\u8f91\u3002\u65e7\u63a5\u53e3\u5728\u5e9f\u5f03\u671f\u5185\u4fdd\u6301\u53ef\u7528\uff0c\u5e73\u6ed1\u8fc7\u6e21\u5230\u65b0\u5b9e\u73b0\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>\u53ef\u89c2\u6d4b\u6027\u5185\u7f6e<\/strong><\/td>\n<td>\u6bcf\u4e2a\u6a21\u5757\u4ece\u8bbe\u8ba1\u7b2c\u4e00\u5929\u8d77\u5373\u5305\u542b\u65e5\u5fd7\u3001\u6307\u6807\u548c\u8ffd\u8e2a\u80fd\u529b\uff0c\u4e0d\u4f5c\u4e3a\u4e8b\u540e\u8865\u5145\u3002\u6a21\u5757\u7684\u8fd0\u884c\u72b6\u6001\u53ef\u88ab\u72ec\u7acb\u76d1\u63a7\u548c\u8bca\u65ad\u3002<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<blockquote>\n<p><strong>\u9605\u8bfb\u7ea6\u5b9a<\/strong>\uff1a\u6587\u4e2d\u4f7f\u7528 <code>MUST<\/code> \/ <code>SHOULD<\/code> \/ <code>MAY<\/code> \u5173\u952e\u5b57\u9075\u5faa RFC 2119 \u8bed\u4e49\u3002<code>MUST<\/code> \u7ea7\u6761\u6b3e\u4e3a\u5f3a\u5236\u7ea6\u675f\uff0c\u8fdd\u53cd\u5373\u89c6\u4e3a\u89c4\u8303\u4e0d\u5408\u89c4\u3002<\/p>\n<\/blockquote>\n<hr \/>\n<h2 id=\"2\">2. \u67b6\u6784\u8bbe\u8ba1\u539f\u5219<\/h2>\n<p>\u6a21\u5757\u5316\u4e0d\u662f\u628a\u4ee3\u7801\u62c6\u5230\u4e0d\u540c\u76ee\u5f55\uff0c\u800c\u662f\u8ba9\u7cfb\u7edf\u5728\u7ed3\u6784\u4e0a\u5177\u5907<strong>\u72ec\u7acb\u66ff\u6362<\/strong>\u7684\u80fd\u529b\u3002\u4ee5\u4e0b\u516d\u6761\u539f\u5219\u8d2f\u7a7f\u4ece\u8bbe\u8ba1\u5230\u5b9e\u73b0\u7684\u6bcf\u4e2a\u51b3\u7b56\u3002<\/p>\n<h3 id=\"_4\">\u5206\u5c42\u4f9d\u8d56\uff0c\u5355\u5411\u6d41\u8f6c<\/h3>\n<p>\u7cfb\u7edf\u6309\u804c\u8d23\u5206\u5c42\uff0c\u4e0a\u5c42\u4f9d\u8d56\u4e0b\u5c42\uff0c\u540c\u5c42\u4e4b\u95f4\u901a\u8fc7\u63a5\u53e3\u901a\u4fe1\u3002\u4f9d\u8d56\u65b9\u5411\u81ea\u4e0a\u800c\u4e0b\u5355\u5411\u6d41\u8f6c\uff0c<code>MUST NOT<\/code> \u51fa\u73b0\u4e0b\u5c42\u53cd\u5411\u5f15\u7528\u4e0a\u5c42\u7684\u5faa\u73af\u4f9d\u8d56\u3002\u5206\u5c42\u7684\u610f\u4e49\u5728\u4e8e\uff1a\u4fee\u6539\u4e0b\u5c42\u5b9e\u73b0\u65f6\uff0c\u4e0a\u5c42\u63a5\u53e3\u4e0d\u53d8\u5373\u65e0\u9700\u6539\u52a8\u3002<\/p>\n<pre class=\"codehilite\"><code>\u63a5\u53e3\u5c42         \u2503 API Gateway \u2192 UI \/ BFF\n                          \u2193\n\u5e94\u7528\u5c42         \u2503 \u4e1a\u52a1\u7f16\u6392 \u2192 \u8ba4\u8bc1\u9274\u6743\n                          \u2193\nAI \u80fd\u529b\u5c42      \u2503 \u6a21\u578b\u7ba1\u7406 | Prompt \u7ba1\u7406 | \u63a8\u7406\u670d\u52a1 | \u8bc4\u4f30\u4f53\u7cfb\n                          \u2193\n\u6570\u636e\u5c42         \u2503 \u6570\u636e\u7ba1\u9053 \u2192 \u5b58\u50a8\u670d\u52a1\n                          \u2193\n\u57fa\u7840\u8bbe\u65bd\u5c42     \u2503 \u914d\u7f6e\u4e2d\u5fc3 | \u65e5\u5fd7\/\u8ffd\u8e2a | \u6d88\u606f\u961f\u5217\n<\/code><\/pre>\n<h3 id=\"_5\">\u9ad8\u5185\u805a\uff0c\u529f\u80fd\u95ed\u73af<\/h3>\n<p>\u4e00\u4e2a\u6a21\u5757\u5185\u7684\u6240\u6709\u4ee3\u7801\u56f4\u7ed5\u540c\u4e00\u4e2a\u4e1a\u52a1\u80fd\u529b\u7ec4\u7ec7\u3002\u5224\u65ad\u6807\u51c6\uff1a\u5982\u679c\u79fb\u9664\u8fd9\u4e2a\u6a21\u5757\uff0c\u7cfb\u7edf\u5931\u53bb\u7684\u662f\u4e00\u4e2a\u5b8c\u6574\u529f\u80fd\u800c\u975e\u96f6\u6563\u7247\u6bb5\u3002\u6a21\u5757\u5185\u90e8\u7684\u6570\u636e\u7ed3\u6784\u3001\u5de5\u5177\u51fd\u6570\u3001\u914d\u7f6e\u9879\u4e0d\u66b4\u9732\u7ed9\u5916\u90e8\u3002<\/p>\n<h3 id=\"_6\">\u63a5\u53e3\u5148\u884c\uff0c\u5b9e\u73b0\u968f\u540e<\/h3>\n<p>\u65b0\u589e\u6216\u4fee\u6539\u6a21\u5757\u65f6\uff0c\u5148\u4ea7\u51fa\u63a5\u53e3\u5b9a\u4e49\u6587\u4ef6\uff08OpenAPI \/ Protobuf \/ TypeScript interface \/ Protocol\uff09\uff0c\u8bc4\u5ba1\u901a\u8fc7\u540e\u624d\u5f00\u59cb\u7f16\u5199\u5b9e\u73b0\u3002\u63a5\u53e3\u662f\u6a21\u5757\u95f4\u7684\u5408\u7ea6\uff0c\u5b9e\u73b0\u662f\u5408\u7ea6\u7684\u5c65\u884c\u2014\u2014\u5408\u7ea6\u53d8\u66f4\u7684\u6210\u672c\u8fdc\u4f4e\u4e8e\u5b9e\u73b0\u91cd\u6784\uff0c\u56e0\u6b64\u63a5\u53e3\u8bbe\u8ba1\u503c\u5f97\u82b1\u66f4\u591a\u65f6\u95f4\u6253\u78e8\u3002<\/p>\n<h3 id=\"_7\">\u5355\u4e00\u804c\u8d23\uff0c\u7c92\u5ea6\u9002\u4e2d<\/h3>\n<p>\u4e00\u4e2a\u6a21\u5757\u53ea\u627f\u62c5\u4e00\u4e2a\u660e\u786e\u7684\u4e1a\u52a1\u804c\u8d23\u3002\u5224\u65ad\u7c92\u5ea6\u662f\u5426\u5408\u9002\u7684\u65b9\u6cd5\uff1a\u7528\u4e00\u53e5\u8bdd\u63cf\u8ff0\u6a21\u5757\u7684\u529f\u80fd\uff0c\u5982\u679c\u9700\u8981&#8221;\u548c&#8221;\u8fde\u63a5\u4e24\u4e2a\u4e0d\u540c\u52a8\u8bcd\uff0c\u8bf4\u660e\u7c92\u5ea6\u8fc7\u5927\u9700\u62c6\u5206\uff1b\u5982\u679c\u63cf\u8ff0\u8bcd\u8fc7\u4e8e\u6cdb\u5316\uff08\u5982&#8221;\u5de5\u5177\u6a21\u5757&#8221;\uff09\uff0c\u8bf4\u660e\u804c\u8d23\u4e0d\u6e05\u9700\u91cd\u65b0\u754c\u5b9a\u3002<\/p>\n<h3 id=\"_8\">\u65e0\u72b6\u6001\u4f18\u5148\uff0c\u72b6\u6001\u5916\u7f6e<\/h3>\n<p>\u6a21\u5757\u7684\u903b\u8f91\u5c42\u4e0d\u6301\u6709\u8fd0\u884c\u65f6\u72b6\u6001\u3002\u4f1a\u8bdd\u72b6\u6001\u3001\u7f13\u5b58\u3001\u4efb\u52a1\u961f\u5217\u7b49\u6301\u4e45\u5316\u6570\u636e\u5916\u7f6e\u5230\u6570\u636e\u5c42\u6216\u57fa\u7840\u8bbe\u65bd\u5c42\u3002\u65e0\u72b6\u6001\u6a21\u5757\u53ef\u4ee5\u6c34\u5e73\u6269\u5c55\u3001\u72ec\u7acb\u90e8\u7f72\u3001\u968f\u65f6\u91cd\u542f\uff0c\u8fd9\u4e9b\u7279\u6027\u5728 AI \u63a8\u7406\u670d\u52a1\u7684\u9ad8\u5e76\u53d1\u573a\u666f\u4e0b\u5c24\u4e3a\u5173\u952e\u3002<\/p>\n<h3 id=\"_9\">\u5931\u8d25\u9694\u79bb\uff0c\u4f18\u96c5\u964d\u7ea7<\/h3>\n<p>\u5355\u4e2a\u6a21\u5757\u7684\u6545\u969c\u4e0d\u963b\u65ad\u6574\u4e2a\u7cfb\u7edf\u3002\u6a21\u5757\u95f4\u7684\u8c03\u7528 <code>SHOULD<\/code> \u8bbe\u7f6e\u8d85\u65f6\u3001\u7194\u65ad\u548c\u964d\u7ea7\u7b56\u7565\u3002AI \u6a21\u578b\u63a8\u7406\u670d\u52a1\u5b95\u673a\u65f6\uff0c\u5e94\u7528\u5c42 <code>SHOULD<\/code> \u80fd\u56de\u9000\u5230\u89c4\u5219\u5f15\u64ce\u6216\u7f13\u5b58\u7ed3\u679c\uff0c\u800c\u975e\u76f4\u63a5\u62a5\u9519\u3002<\/p>\n<hr \/>\n<h2 id=\"3\">3. \u6a21\u5757\u4f53\u7cfb\u8bbe\u8ba1<\/h2>\n<p>\u6a21\u5757\u662f\u672c\u89c4\u8303\u7684\u6838\u5fc3\u8c03\u5ea6\u5355\u4f4d\u3002\u4e00\u4e2a\u6807\u51c6\u7684\u6a21\u5757\u5305\u542b\u56db\u4e2a\u7ec4\u6210\u90e8\u5206\uff1a<strong>\u63a5\u53e3\u5951\u7ea6<\/strong>\uff08\u5bf9\u5916\u58f0\u660e\u7684\u80fd\u529b\u548c\u6570\u636e\u683c\u5f0f\uff09\u3001<strong>\u5b9e\u73b0\u903b\u8f91<\/strong>\uff08\u5185\u90e8\u5982\u4f55\u5c65\u884c\u5951\u7ea6\uff09\u3001<strong>\u6d4b\u8bd5\u5957\u4ef6<\/strong>\uff08\u9a8c\u8bc1\u5b9e\u73b0\u7b26\u5408\u5951\u7ea6\uff09\u3001<strong>\u8fd0\u884c\u6e05\u5355<\/strong>\uff08\u4f9d\u8d56\u3001\u914d\u7f6e\u3001\u7248\u672c\u4fe1\u606f\uff09\u3002<\/p>\n<h3 id=\"_10\">\u6a21\u5757\u5206\u7c7b<\/h3>\n<p>\u6309\u4f9d\u8d56\u5c42\u7ea7\u548c\u804c\u8d23\u7c7b\u578b\uff0c\u6a21\u5757\u5206\u4e3a\u56db\u7c7b\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>\u7c7b\u578b<\/th>\n<th>\u804c\u8d23<\/th>\n<th>\u4f9d\u8d56\u65b9\u5411<\/th>\n<th>\u5178\u578b\u793a\u4f8b<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u6838\u5fc3\u6a21\u5757<\/td>\n<td>\u627f\u8f7d\u9879\u76ee\u6838\u5fc3\u4e1a\u52a1\u4ef7\u503c<\/td>\n<td>\u4f9d\u8d56\u670d\u52a1\u5c42 + \u6570\u636e\u5c42<\/td>\n<td>\u63a8\u7406\u670d\u52a1\u3001\u4e1a\u52a1\u7f16\u6392\u3001\u6a21\u578b\u7ba1\u7406<\/td>\n<\/tr>\n<tr>\n<td>\u670d\u52a1\u6a21\u5757<\/td>\n<td>\u63d0\u4f9b\u53ef\u590d\u7528\u7684\u9886\u57df\u80fd\u529b<\/td>\n<td>\u4f9d\u8d56\u6570\u636e\u5c42<\/td>\n<td>\u8ba4\u8bc1\u670d\u52a1\u3001\u68c0\u7d22\u670d\u52a1\u3001\u8bc4\u4f30\u670d\u52a1<\/td>\n<\/tr>\n<tr>\n<td>\u6570\u636e\u6a21\u5757<\/td>\n<td>\u7ba1\u7406\u6570\u636e\u7684\u8bfb\u5199\u548c\u6301\u4e45\u5316<\/td>\n<td>\u4f9d\u8d56\u57fa\u7840\u8bbe\u65bd\u5c42<\/td>\n<td>\u6570\u636e\u7ba1\u9053\u3001\u5b58\u50a8\u9002\u914d\u5668\u3001\u7f13\u5b58\u670d\u52a1<\/td>\n<\/tr>\n<tr>\n<td>\u5de5\u5177\u6a21\u5757<\/td>\n<td>\u63d0\u4f9b\u65e0\u72b6\u6001\u7684\u5de5\u5177\u51fd\u6570\u548c\u7c7b\u578b\u5b9a\u4e49<\/td>\n<td>\u65e0\u4f9d\u8d56\u6216\u4ec5\u4f9d\u8d56\u6807\u51c6\u5e93<\/td>\n<td>\u65e5\u5fd7\u5de5\u5177\u3001\u7c7b\u578b\u5b9a\u4e49\u3001\u683c\u5f0f\u8f6c\u6362<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_11\">\u4f9d\u8d56\u89c4\u5219<\/h3>\n<p>\u6a21\u5757\u95f4\u7684\u4f9d\u8d56\u9075\u5faa\u4ee5\u4e0b\u7ea6\u675f\uff1a<\/p>\n<ul>\n<li>\u6838\u5fc3\u6a21\u5757 <code>MAY<\/code> \u4f9d\u8d56\u670d\u52a1\u6a21\u5757\u548c\u6570\u636e\u6a21\u5757<\/li>\n<li>\u670d\u52a1\u6a21\u5757 <code>MAY<\/code> \u4f9d\u8d56\u6570\u636e\u6a21\u5757\u548c\u5de5\u5177\u6a21\u5757<\/li>\n<li>\u6570\u636e\u6a21\u5757 <code>MAY<\/code> \u4f9d\u8d56\u5de5\u5177\u6a21\u5757<\/li>\n<li>\u5de5\u5177\u6a21\u5757 <code>MUST NOT<\/code> \u4f9d\u8d56\u4efb\u4f55\u975e\u5de5\u5177\u6a21\u5757<\/li>\n<li>\u540c\u5c42\u6a21\u5757\u4e4b\u95f4 <code>MAY<\/code> \u901a\u4fe1\uff0c\u4f46 <code>MUST<\/code> \u901a\u8fc7\u63a5\u53e3\u5951\u7ea6\uff0c\u4e0d\u76f4\u63a5\u5f15\u7528\u5185\u90e8\u5b9e\u73b0<\/li>\n<li>\u4efb\u4f55\u6a21\u5757 <code>MUST NOT<\/code> \u5f62\u6210\u5faa\u73af\u4f9d\u8d56\uff08A \u2192 B \u2192 A\uff09<\/li>\n<\/ul>\n<pre class=\"codehilite\"><code>\u6838\u5fc3\u6a21\u5757 \u2500\u2500\u2192 \u670d\u52a1\u6a21\u5757 \u2500\u2500\u2192 \u6570\u636e\u6a21\u5757 \u2500\u2500\u2192 \u5de5\u5177\u6a21\u5757\n    \u2502             \u2502            \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n         (\u53ef\u8de8\u5c42\u4f9d\u8d56\u5de5\u5177\u6a21\u5757)\n\n\u7981\u6b62\u53cd\u5411:  \u5de5\u5177 \u2717\u2192 \u6838\u5fc3 | \u6570\u636e \u2717\u2192 \u670d\u52a1 | \u670d\u52a1 \u2717\u2192 \u6838\u5fc3\n<\/code><\/pre>\n<h3 id=\"_12\">\u63a5\u53e3\u5951\u7ea6\u4e09\u8981\u7d20<\/h3>\n<p>\u6bcf\u4e2a\u5bf9\u5916\u66b4\u9732\u7684\u63a5\u53e3 <code>MUST<\/code> \u5305\u542b\u4e09\u90e8\u5206\u58f0\u660e\uff1a<\/p>\n<ol>\n<li><strong>\u6570\u636e\u5951\u7ea6<\/strong> \u2014\u2014 \u8f93\u5165\u8f93\u51fa\u7684\u6570\u636e\u7ed3\u6784\uff0c\u4f7f\u7528\u8bed\u8a00\u65e0\u5173\u7684 schema \u63cf\u8ff0\uff08OpenAPI \/ Protobuf \/ JSON Schema\uff09\uff0c\u5b57\u6bb5\u542b\u4e49\u3001\u7c7b\u578b\u7ea6\u675f\u3001\u5fc5\u9009\/\u53ef\u9009\u5747\u6709\u660e\u786e\u5b9a\u4e49\u3002<\/li>\n<li><strong>\u884c\u4e3a\u5951\u7ea6<\/strong> \u2014\u2014 \u63a5\u53e3\u7684\u524d\u7f6e\u6761\u4ef6\uff08\u8c03\u7528\u65b9\u9700\u6ee1\u8db3\u4ec0\u4e48\u524d\u63d0\uff09\u3001\u540e\u7f6e\u6761\u4ef6\uff08\u8c03\u7528\u5b8c\u6210\u540e\u7cfb\u7edf\u5904\u4e8e\u4ec0\u4e48\u72b6\u6001\uff09\u3001\u4ee5\u53ca\u5f02\u5e38\u573a\u666f\uff08\u8f93\u5165\u4e0d\u5408\u6cd5\u3001\u4f9d\u8d56\u4e0d\u53ef\u7528\u65f6\u8fd4\u56de\u4ec0\u4e48\uff09\u3002<\/li>\n<li><strong>\u7248\u672c\u5951\u7ea6<\/strong> \u2014\u2014 \u63a5\u53e3\u7684\u8bed\u4e49\u7248\u672c\u53f7\uff0c\u4ee5\u53ca\u5f53\u524d\u7248\u672c\u7684\u72b6\u6001\uff08\u8349\u6848 \/ \u7a33\u5b9a \/ \u5e9f\u5f03\u4e2d\uff09\u3002<\/li>\n<\/ol>\n<h3 id=\"_13\">\u6a21\u5757\u6ce8\u518c\u4e0e\u53d1\u73b0<\/h3>\n<p>\u9879\u76ee\u7ef4\u62a4\u4e00\u4efd\u6a21\u5757\u6e05\u5355\u6587\u4ef6\uff08<code>modules.yaml<\/code>\uff09\uff0c\u8bb0\u5f55\u6bcf\u4e2a\u6a21\u5757\u7684\u540d\u79f0\u3001\u7248\u672c\u3001\u8def\u5f84\u3001\u63a5\u53e3\u6587\u4ef6\u4f4d\u7f6e\u3001\u4f9d\u8d56\u58f0\u660e\u548c\u5f53\u524d\u72b6\u6001\u3002\u65b0\u6a21\u5757\u52a0\u5165\u6216\u65e7\u6a21\u5757\u5e9f\u5f03\u65f6\uff0c\u540c\u6b65\u66f4\u65b0\u6b64\u6587\u4ef6\u3002\u8fd9\u4efd\u6e05\u5355\u662f\u6574\u4e2a\u7cfb\u7edf\u7684&#8221;\u5730\u56fe&#8221;\uff0cCI \u7ba1\u9053 <code>SHOULD<\/code> \u6821\u9a8c\u6e05\u5355\u4e0e\u5b9e\u9645\u4ee3\u7801\u7684\u4e00\u81f4\u6027\u3002<\/p>\n<blockquote>\n<p><strong>\u5b9e\u8df5\u5efa\u8bae<\/strong>\uff1a\u6a21\u5757\u6e05\u5355\u6587\u4ef6\u540c\u65f6\u5145\u5f53\u4f9d\u8d56\u68c0\u6d4b\u7684\u8f93\u5165\u6e90\u3002CI \u7ba1\u9053\u53ef\u89e3\u6790 <code>modules.yaml<\/code> \u4e2d\u7684\u4f9d\u8d56\u5173\u7cfb\uff0c\u81ea\u52a8\u68c0\u6d4b\u5faa\u73af\u4f9d\u8d56\u548c\u8d8a\u5c42\u5f15\u7528\uff0c\u5728\u4ee3\u7801\u5408\u5e76\u9636\u6bb5\u62e6\u622a\u8fdd\u89c4\u3002<\/p>\n<\/blockquote>\n<hr \/>\n<h2 id=\"4\">4. \u9879\u76ee\u76ee\u5f55\u7ed3\u6784<\/h2>\n<p>\u7edf\u4e00\u7684\u76ee\u5f55\u7ed3\u6784\u8ba9\u4efb\u4f55\u5f00\u53d1\u8005\u5728\u4efb\u4f55\u6a21\u5757\u4e2d\u90fd\u80fd\u5feb\u901f\u5b9a\u4f4d\u4ee3\u7801\u3002\u4ee5\u4e0b\u7ea6\u5b9a\u9002\u7528\u4e8e\u4f7f\u7528 TypeScript \/ Python \u7684 AI \u8f6f\u4ef6\u9879\u76ee\uff0c\u5176\u4ed6\u8bed\u8a00\u9075\u5faa\u7b49\u4ef7\u539f\u5219\u3002<\/p>\n<h3 id=\"_14\">\u9876\u5c42\u76ee\u5f55<\/h3>\n<pre class=\"codehilite\"><code class=\"language-text\">project-root\/\n\u251c\u2500\u2500 modules\/              # \u6240\u6709\u4e1a\u52a1\u6a21\u5757\n\u2502   \u251c\u2500\u2500 inference\/       # \u63a8\u7406\u670d\u52a1\u6a21\u5757\n\u2502   \u251c\u2500\u2500 model-manager\/   # \u6a21\u578b\u7ba1\u7406\u6a21\u5757\n\u2502   \u251c\u2500\u2500 prompt-engine\/   # Prompt \u7ba1\u7406\u6a21\u5757\n\u2502   \u251c\u2500\u2500 data-pipeline\/   # \u6570\u636e\u7ba1\u9053\u6a21\u5757\n\u2502   \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 packages\/            # \u53ef\u590d\u7528\u7684\u5de5\u5177\u5305\n\u2502   \u251c\u2500\u2500 types\/           # \u5171\u4eab\u7c7b\u578b\u5b9a\u4e49\n\u2502   \u251c\u2500\u2500 utils\/           # \u901a\u7528\u5de5\u5177\u51fd\u6570\n\u2502   \u2514\u2500\u2500 config\/          # \u914d\u7f6e\u7ba1\u7406\u5de5\u5177\n\u251c\u2500\u2500 gateway\/             # API \u7f51\u5173 \/ \u5165\u53e3\u5c42\n\u251c\u2500\u2500 infra\/               # \u57fa\u7840\u8bbe\u65bd\u914d\u7f6e\n\u2502   \u251c\u2500\u2500 docker\/          # \u5bb9\u5668\u5316\u5b9a\u4e49\n\u2502   \u251c\u2500\u2500 k8s\/             # \u7f16\u6392\u914d\u7f6e\n\u2502   \u2514\u2500\u2500 terraform\/       # \u57fa\u7840\u8bbe\u65bd\u5373\u4ee3\u7801\n\u251c\u2500\u2500 tools\/               # \u5f00\u53d1\u5de5\u5177\u4e0e\u811a\u672c\n\u2502   \u251c\u2500\u2500 cli\/             # \u9879\u76ee\u4e13\u7528 CLI\n\u2502   \u2514\u2500\u2500 scripts\/         # \u8fd0\u7ef4\u811a\u672c\n\u251c\u2500\u2500 docs\/                # \u9879\u76ee\u6587\u6863\n\u251c\u2500\u2500 modules.yaml         # \u6a21\u5757\u6e05\u5355\uff08\u4f9d\u8d56\u5730\u56fe\uff09\n\u251c\u2500\u2500 CONTRACT.md          # \u6a21\u5757\u95f4\u63a5\u53e3\u5951\u7ea6\u6c47\u603b\n\u2514\u2500\u2500 CHANGELOG.md         # \u53d8\u66f4\u65e5\u5fd7\n<\/code><\/pre>\n<h3 id=\"_15\">\u6a21\u5757\u5185\u76ee\u5f55<\/h3>\n<p>\u6bcf\u4e2a\u6a21\u5757\u5185\u90e8\u9075\u5faa\u7edf\u4e00\u7ed3\u6784\uff0c\u8ba9\u8de8\u6a21\u5757\u534f\u4f5c\u65f6\u65e0\u9700\u91cd\u65b0\u9002\u5e94\uff1a<\/p>\n<pre class=\"codehilite\"><code class=\"language-text\">modules\/inference\/\n\u251c\u2500\u2500 interface\/            # \u63a5\u53e3\u5951\u7ea6\uff08\u5bf9\u5916\u66b4\u9732\uff09\n\u2502   \u251c\u2500\u2500 openapi.yaml      # REST API \u5b9a\u4e49\n\u2502   \u2514\u2500\u2500 types.ts         # TypeScript \u7c7b\u578b\n\u251c\u2500\u2500 src\/                  # \u5b9e\u73b0\u4ee3\u7801\n\u2502   \u251c\u2500\u2500 handler\/          # \u8bf7\u6c42\u5904\u7406\n\u2502   \u251c\u2500\u2500 service\/          # \u6838\u5fc3\u903b\u8f91\n\u2502   \u2514\u2500\u2500 adapter\/          # \u5916\u90e8\u4f9d\u8d56\u9002\u914d\u5668\n\u251c\u2500\u2500 tests\/                # \u6d4b\u8bd5\u5957\u4ef6\n\u2502   \u251c\u2500\u2500 unit\/             # \u5355\u5143\u6d4b\u8bd5\n\u2502   \u251c\u2500\u2500 integration\/      # \u96c6\u6210\u6d4b\u8bd5\n\u2502   \u2514\u2500\u2500 fixtures\/         # \u6d4b\u8bd5\u6570\u636e\n\u251c\u2500\u2500 config\/               # \u6a21\u5757\u7ea7\u914d\u7f6e\n\u251c\u2500\u2500 README.md             # \u6a21\u5757\u8bf4\u660e\n\u251c\u2500\u2500 module.yaml           # \u6a21\u5757\u5143\u4fe1\u606f\n\u2514\u2500\u2500 CHANGELOG.md          # \u6a21\u5757\u53d8\u66f4\u65e5\u5fd7\n<\/code><\/pre>\n<h3 id=\"_16\">\u547d\u540d\u7ea6\u5b9a<\/h3>\n<table>\n<thead>\n<tr>\n<th>\u5bf9\u8c61<\/th>\n<th>\u7ea6\u5b9a<\/th>\n<th>\u793a\u4f8b<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u6a21\u5757\u540d<\/td>\n<td>kebab-case\uff0c\u540d\u8bcd\u6216\u540d\u8bcd\u77ed\u8bed<\/td>\n<td><code>model-manager<\/code>, <code>data-pipeline<\/code><\/td>\n<\/tr>\n<tr>\n<td>\u63a5\u53e3\u6587\u4ef6<\/td>\n<td>snake_case<\/td>\n<td><code>openapi.yaml<\/code>, <code>proto\/inference.proto<\/code><\/td>\n<\/tr>\n<tr>\n<td>\u6e90\u7801\u6587\u4ef6<\/td>\n<td>kebab-case\uff08TS\uff09\u6216 snake_case\uff08Python\uff09<\/td>\n<td><code>inference-handler.ts<\/code>, <code>model_loader.py<\/code><\/td>\n<\/tr>\n<tr>\n<td>\u6d4b\u8bd5\u6587\u4ef6<\/td>\n<td>\u4e0e\u88ab\u6d4b\u6587\u4ef6\u540c\u540d\u52a0 <code>.test<\/code> \/ <code>_test<\/code><\/td>\n<td><code>handler.test.ts<\/code>, <code>test_loader.py<\/code><\/td>\n<\/tr>\n<tr>\n<td>\u73af\u5883\u53d8\u91cf<\/td>\n<td>UPPER_SNAKE_CASE\uff0c\u6a21\u5757\u540d\u524d\u7f00<\/td>\n<td><code>INFER_PORT<\/code>, <code>MODEL_REGISTRY_URL<\/code><\/td>\n<\/tr>\n<tr>\n<td>\u914d\u7f6e\u952e<\/td>\n<td>dot.notation\uff0c\u6a21\u5757\u540d\u4e3a\u9996\u6bb5<\/td>\n<td><code>inference.timeout_ms<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<blockquote>\n<p><strong>\u7981\u6b62\u505a\u6cd5<\/strong>\uff1a\u4e0d\u8981\u5728\u6a21\u5757\u5185\u90e8\u521b\u5efa <code>common\/<\/code> \u6216 <code>misc\/<\/code> \u76ee\u5f55\u3002\u8fd9\u7c7b\u76ee\u5f55\u4f1a\u9010\u6e10\u5806\u79ef\u4e0d\u5c5e\u4e8e\u4efb\u4f55\u6a21\u5757\u7684&#8221;\u6d41\u6d6a\u4ee3\u7801&#8221;\uff0c\u7834\u574f\u6a21\u5757\u8fb9\u754c\u3002\u5982\u679c\u4e00\u6bb5\u903b\u8f91\u88ab\u591a\u4e2a\u6a21\u5757\u9700\u8981\uff0c\u63d0\u53d6\u4e3a <code>packages\/<\/code> \u4e0b\u7684\u72ec\u7acb\u5de5\u5177\u5305\u3002<\/p>\n<\/blockquote>\n<hr \/>\n<h2 id=\"5-ai\">5. AI \u80fd\u529b\u5c42\u89c4\u8303<\/h2>\n<p>AI \u80fd\u529b\u5c42\u662f\u672c\u89c4\u8303\u4e0e\u666e\u901a\u8f6f\u4ef6\u9879\u76ee\u89c4\u8303\u7684\u4e3b\u8981\u5dee\u5f02\u70b9\u3002\u8fd9\u4e00\u5c42\u5305\u542b\u56db\u4e2a\u6838\u5fc3\u6a21\u5757\uff0c\u5b83\u4eec\u7684\u534f\u4f5c\u65b9\u5f0f\u51b3\u5b9a\u4e86 AI \u529f\u80fd\u7684\u8d28\u91cf\u548c\u8fed\u4ee3\u901f\u5ea6\u3002<\/p>\n<h3 id=\"_17\">\u6a21\u578b\u7ba1\u7406\u6a21\u5757<\/h3>\n<p>\u6a21\u578b\u7ba1\u7406\u6a21\u5757\u8d1f\u8d23\u6a21\u578b\u7684<strong>\u6ce8\u518c\u3001\u7248\u672c\u63a7\u5236\u3001\u52a0\u8f7d\u4e0e\u5378\u8f7d<\/strong>\u3002\u6bcf\u4e2a\u6a21\u578b\u5728\u6ce8\u518c\u65f6 <code>MUST<\/code> \u8bb0\u5f55\u4ee5\u4e0b\u5143\u4fe1\u606f\uff1a<\/p>\n<ul>\n<li>\u6a21\u578b\u6807\u8bc6\u7b26\uff08name + version\uff0c\u5982 <code>gpt-classifier\/v2.1.0<\/code>\uff09<\/li>\n<li>\u6a21\u578b\u6765\u6e90\uff08\u8bad\u7ec3\u4efb\u52a1 ID \/ \u5916\u90e8\u4e0b\u8f7d\u5730\u5740 \/ \u57fa\u5ea7\u6a21\u578b + \u5fae\u8c03\u914d\u7f6e\uff09<\/li>\n<li>\u8f93\u5165\u8f93\u51fa schema\uff08\u5b57\u6bb5\u540d\u3001\u7c7b\u578b\u3001\u7ef4\u5ea6\u3001\u53d6\u503c\u8303\u56f4\uff09<\/li>\n<li>\u8d44\u6e90\u9700\u6c42\uff08GPU \u578b\u53f7\u3001\u663e\u5b58\u3001CPU\u3001\u5185\u5b58\uff09<\/li>\n<li>\u6027\u80fd\u57fa\u7ebf\uff08\u51c6\u786e\u7387\u3001\u5ef6\u8fdf P99\u3001\u541e\u5410\u91cf\uff0c\u53ca\u8bc4\u4f30\u6570\u636e\u96c6\u6807\u8bc6\uff09<\/li>\n<li>\u751f\u547d\u5468\u671f\u72b6\u6001\uff08draft \u2192 staging \u2192 production \u2192 deprecated \u2192 retired\uff09<\/li>\n<\/ul>\n<p>\u6a21\u578b\u52a0\u8f7d\u91c7\u7528<strong>\u5ef6\u8fdf\u52a0\u8f7d + \u9884\u70ed\u673a\u5236<\/strong>\uff1a\u6a21\u5757\u542f\u52a8\u65f6\u4ec5\u52a0\u8f7d\u914d\u7f6e\u5143\u4fe1\u606f\uff0c\u5b9e\u9645\u6a21\u578b\u6743\u91cd\u5728\u9996\u6b21\u8bf7\u6c42\u6216\u5b9a\u65f6\u9884\u70ed\u4efb\u52a1\u89e6\u53d1\u65f6\u52a0\u8f7d\u5230\u5185\u5b58\u3002\u5378\u8f7d\u65f6 <code>MUST<\/code> \u7b49\u5f85\u6b63\u5728\u8fdb\u884c\u7684\u63a8\u7406\u8bf7\u6c42\u5b8c\u6210\uff0c\u7136\u540e\u91ca\u653e\u8d44\u6e90\u3002<\/p>\n<h3 id=\"prompt\">Prompt \u7ba1\u7406\u6a21\u5757<\/h3>\n<p>Prompt \u662f AI \u7cfb\u7edf\u4e2d\u7684&#8221;\u6e90\u4ee3\u7801&#8221;\uff0c\u9700\u8981\u4e0e\u4ee3\u7801\u540c\u7ea7\u7684\u7ba1\u7406\u5f85\u9047\u3002Prompt \u7ba1\u7406\u6a21\u5757 <code>MUST<\/code> \u63d0\u4f9b\u4ee5\u4e0b\u80fd\u529b\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>\u80fd\u529b<\/th>\n<th>\u8bf4\u660e<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>\u6a21\u677f\u7248\u672c\u63a7\u5236<\/strong><\/td>\n<td>\u6bcf\u4e2a Prompt \u6a21\u677f\u6709\u72ec\u7acb\u7684\u8bed\u4e49\u7248\u672c\u53f7\uff0c\u53d8\u66f4\u5386\u53f2\u53ef\u8ffd\u6eaf\u3002\u6a21\u677f\u4f7f\u7528\u53d8\u91cf\u63d2\u503c\uff0c\u8fd0\u884c\u65f6\u6e32\u67d3\uff0c\u4e0d\u5728\u4ee3\u7801\u4e2d\u786c\u7f16\u7801\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>A\/B \u6d4b\u8bd5\u652f\u6301<\/strong><\/td>\n<td>\u540c\u4e00\u529f\u80fd\u7684\u591a\u4e2a Prompt \u7248\u672c\u53ef\u5e76\u884c\u8fd0\u884c\uff0c\u6309\u6d41\u91cf\u6bd4\u4f8b\u5206\u914d\uff0c\u7ed3\u679c\u6309\u7248\u672c\u7ef4\u5ea6\u7edf\u8ba1\u5bf9\u6bd4\u6548\u679c\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>\u53d8\u91cf\u6821\u9a8c<\/strong><\/td>\n<td>\u6a21\u677f\u4e2d\u7684\u53d8\u91cf <code>MUST<\/code> \u6709\u7c7b\u578b\u58f0\u660e\u548c\u5fc5\u9009\/\u53ef\u9009\u6807\u8bb0\u3002\u6e32\u67d3\u65f6\u6821\u9a8c\u53d8\u91cf\u503c\u662f\u5426\u7b26\u5408 schema\uff0c\u4e0d\u5408\u6cd5\u5219\u62d2\u7edd\u6e32\u67d3\u5e76\u62a5\u9519\u3002<\/td>\n<\/tr>\n<tr>\n<td><strong>\u5ba1\u8ba1\u8ffd\u8e2a<\/strong><\/td>\n<td>\u6bcf\u6b21 Prompt \u6e32\u67d3\u8bb0\u5f55\u6a21\u677f\u7248\u672c\u3001\u53d8\u91cf\u503c\u3001\u8f93\u51fa\u7ed3\u679c\u548c\u8c03\u7528\u65b9\u6807\u8bc6\u3002\u7528\u4e8e\u4e8b\u540e\u6392\u67e5\u8f93\u51fa\u5f02\u5e38\u548c\u6548\u679c\u56de\u5f52\u3002<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_18\">\u63a8\u7406\u670d\u52a1\u6a21\u5757<\/h3>\n<p>\u63a8\u7406\u670d\u52a1\u6a21\u5757\u662f AI \u80fd\u529b\u5c42\u7684\u5bf9\u5916\u7a97\u53e3\uff0c\u63a5\u6536\u8bf7\u6c42\u3001\u8c03\u5ea6\u6a21\u578b\u3001\u8fd4\u56de\u7ed3\u679c\u3002\u5b83\u7684\u8bbe\u8ba1\u6838\u5fc3\u662f<strong>\u5c06\u6a21\u578b\u9009\u62e9\u903b\u8f91\u4e0e\u63a8\u7406\u6267\u884c\u903b\u8f91\u5206\u79bb<\/strong>\u3002<\/p>\n<pre class=\"codehilite\"><code class=\"language-json\">{\n  &quot;request_id&quot;: &quot;uuid&quot;,\n  &quot;model&quot;: &quot;gpt-classifier\/v2.1.0&quot;,\n  &quot;inputs&quot;: {\n    &quot;text&quot;: &quot;\u5f85\u63a8\u7406\u5185\u5bb9&quot;,\n    &quot;context&quot;: { }\n  },\n  &quot;params&quot;: {\n    &quot;temperature&quot;: 0.7,\n    &quot;max_tokens&quot;: 1024,\n    &quot;stream&quot;: false\n  },\n  &quot;metadata&quot;: {\n    &quot;caller&quot;: &quot;service-x&quot;,\n    &quot;trace_id&quot;: &quot;...&quot;\n  }\n}\n<\/code><\/pre>\n<p>\u63a8\u7406\u670d\u52a1 <code>SHOULD<\/code> \u652f\u6301\u4e09\u79cd\u8c03\u7528\u6a21\u5f0f\uff1a\u540c\u6b65\u8bf7\u6c42\uff08\u4f4e\u5ef6\u8fdf\u573a\u666f\uff09\u3001\u5f02\u6b65\u6279\u5904\u7406\uff08\u9ad8\u541e\u5410\u573a\u666f\uff09\u3001\u6d41\u5f0f\u8fd4\u56de\uff08\u751f\u6210\u5f0f\u4efb\u52a1\uff09\u3002\u4e09\u79cd\u6a21\u5f0f\u5171\u7528\u540c\u4e00\u5957\u6a21\u578b\u52a0\u8f7d\u548c Prompt \u6e32\u67d3\u903b\u8f91\uff0c\u4ec5\u5728\u5916\u5c42\u5904\u7406\u8c03\u5ea6\u5dee\u5f02\u3002<\/p>\n<h3 id=\"_19\">\u8bc4\u4f30\u4f53\u7cfb\u6a21\u5757<\/h3>\n<p>\u8bc4\u4f30\u4f53\u7cfb\u6a21\u5757\u662f AI \u80fd\u529b\u5c42\u7684\u8d28\u91cf\u4fdd\u969c\u3002\u5b83\u72ec\u7acb\u4e8e\u63a8\u7406\u670d\u52a1\u8fd0\u884c\uff0c\u5b9a\u671f\u5bf9\u6a21\u578b\u548c Prompt \u7684\u8f93\u51fa\u8d28\u91cf\u8fdb\u884c\u56de\u5f52\u6d4b\u8bd5\u3002\u8bc4\u4f30 <code>MUST<\/code> \u8986\u76d6\u4e09\u4e2a\u7ef4\u5ea6\uff1a<\/p>\n<ol>\n<li><strong>\u8d28\u91cf\u6307\u6807<\/strong> \u2014\u2014 \u51c6\u786e\u7387\u3001F1\u3001BLEU\u3001ROUGE \u7b49\u9886\u57df\u76f8\u5173\u6307\u6807\uff0c\u6309\u8bc4\u4f30\u6570\u636e\u96c6\u5206\u7ec4\u7edf\u8ba1\u3002<\/li>\n<li><strong>\u6027\u80fd\u6307\u6807<\/strong> \u2014\u2014 \u5ef6\u8fdf\u5206\u5e03\uff08P50 \/ P95 \/ P99\uff09\u3001\u541e\u5410\u91cf\u3001\u8d44\u6e90\u5360\u7528\u3002<\/li>\n<li><strong>\u5b89\u5168\u6307\u6807<\/strong> \u2014\u2014 \u6709\u5bb3\u5185\u5bb9\u68c0\u6d4b\u7387\u3001PII \u6cc4\u9732\u68c0\u6d4b\u3001\u8d8a\u72f1\u653b\u51fb\u9632\u5fa1\u6210\u529f\u7387\u3002<\/li>\n<\/ol>\n<p>\u8bc4\u4f30\u7ed3\u679c <code>SHOULD<\/code> \u63a5\u5165\u53ef\u89c6\u5316\u770b\u677f\uff0c\u5386\u53f2\u8d8b\u52bf\u53ef\u8ffd\u6eaf\u3002\u5f53\u6307\u6807\u4f4e\u4e8e\u8bbe\u5b9a\u9608\u503c\u65f6\u81ea\u52a8\u89e6\u53d1\u544a\u8b66\uff0c\u963b\u6b62\u76f8\u5173\u6a21\u578b\u7248\u672c\u8fdb\u5165 production \u72b6\u6001\u3002<\/p>\n<h3 id=\"rag\">RAG \u6a21\u5757\uff08\u5982\u9002\u7528\uff09<\/h3>\n<p>\u68c0\u7d22\u589e\u5f3a\u751f\u6210\uff08RAG\uff09\u80fd\u529b\u62c6\u5206\u4e3a\u4e09\u4e2a\u5b50\u6a21\u5757\u72ec\u7acb\u7ba1\u7406\uff1a<strong>\u7d22\u5f15\u6a21\u5757<\/strong>\u8d1f\u8d23\u6587\u6863\u89e3\u6790\u3001\u5206\u5757\u3001\u5411\u91cf\u5316\u3001\u7d22\u5f15\u5199\u5165\uff1b<strong>\u68c0\u7d22\u6a21\u5757<\/strong>\u8d1f\u8d23\u67e5\u8be2\u6539\u5199\u3001\u5411\u91cf\u68c0\u7d22\u3001\u6df7\u5408\u6392\u5e8f\uff1b<strong>\u91cd\u6392\u6a21\u5757<\/strong>\u8d1f\u8d23\u5bf9\u68c0\u7d22\u7ed3\u679c\u505a\u4e8c\u6b21\u6392\u5e8f\u548c\u8fc7\u6ee4\u3002\u4e09\u4e2a\u5b50\u6a21\u5757\u5404\u6709\u72ec\u7acb\u7248\u672c\uff0c\u53ef\u5206\u522b\u8fed\u4ee3\u800c\u4e0d\u5f71\u54cd\u5176\u4ed6\u73af\u8282\u3002<\/p>\n<hr \/>\n<h2 id=\"6\">6. \u6570\u636e\u5c42\u89c4\u8303<\/h2>\n<p>\u6570\u636e\u5c42\u7ba1\u7406 AI \u7cfb\u7edf\u4e2d\u6240\u6709\u6570\u636e\u7684\u751f\u547d\u5468\u671f\uff1a\u91c7\u96c6\u3001\u6e05\u6d17\u3001\u6807\u6ce8\u3001\u5b58\u50a8\u3001\u7248\u672c\u63a7\u5236\u3002\u6570\u636e\u7684\u6b63\u786e\u6027\u548c\u53ef\u8ffd\u6eaf\u6027\u76f4\u63a5\u51b3\u5b9a\u6a21\u578b\u6548\u679c\uff0c\u56e0\u6b64\u6570\u636e\u5c42\u89c4\u8303\u7684\u6838\u5fc3\u662f<strong>\u4e0d\u53ef\u53d8 + \u53ef\u7248\u672c\u5316 + \u53ef\u5ba1\u8ba1<\/strong>\u3002<\/p>\n<h3 id=\"_20\">\u6570\u636e\u7ba1\u9053\u6a21\u5757<\/h3>\n<p>\u6570\u636e\u7ba1\u9053\u6a21\u5757\u4ee5 DAG\uff08\u6709\u5411\u65e0\u73af\u56fe\uff09\u65b9\u5f0f\u7f16\u6392\u6570\u636e\u5904\u7406\u6d41\u7a0b\u3002\u6bcf\u4e2a\u5904\u7406\u8282\u70b9\u662f\u4e00\u4e2a\u72ec\u7acb\u7684\u51fd\u6570\u6216\u670d\u52a1\uff0c\u63a5\u6536\u8f93\u5165\u6570\u636e\u96c6\uff0c\u8f93\u51fa\u5904\u7406\u540e\u7684\u6570\u636e\u96c6\u3002\u7ba1\u9053\u8bbe\u8ba1\u9075\u5faa\u4ee5\u4e0b\u89c4\u5219\uff1a<\/p>\n<ul>\n<li>\u6bcf\u4e2a\u8282\u70b9 <code>MUST<\/code> \u8bb0\u5f55\u8f93\u5165\u6570\u636e\u7684\u54c8\u5e0c\u503c\u548c\u8f93\u51fa\u6570\u636e\u7684\u54c8\u5e0c\u503c\uff0c\u7528\u4e8e\u8ffd\u6eaf\u6570\u636e\u8840\u7f18<\/li>\n<li>\u8282\u70b9\u7684\u5904\u7406\u903b\u8f91 <code>MUST<\/code> \u662f\u786e\u5b9a\u6027\u7684\u2014\u2014\u540c\u4e00\u8f93\u5165\u6c38\u8fdc\u4ea7\u51fa\u540c\u4e00\u8f93\u51fa\uff0c\u4e0d\u4f9d\u8d56\u968f\u673a\u72b6\u6001<\/li>\n<li>\u5f15\u5165\u968f\u673a\u6027\u7684\u8282\u70b9\uff08\u5982\u6570\u636e\u589e\u5f3a\uff09<code>MUST<\/code> \u663e\u5f0f\u4f20\u5165\u968f\u673a\u79cd\u5b50\uff0c\u79cd\u5b50\u4e0e\u8f93\u51fa\u4e00\u8d77\u8bb0\u5f55<\/li>\n<li>\u7ba1\u9053\u6267\u884c\u5931\u8d25\u65f6 <code>MAY<\/code> \u4ece\u5931\u8d25\u8282\u70b9\u91cd\u8bd5\uff0c\u4e0d\u91cd\u65b0\u6267\u884c\u5df2\u6210\u529f\u7684\u524d\u7f6e\u8282\u70b9<\/li>\n<\/ul>\n<h3 id=\"_21\">\u6570\u636e\u7248\u672c\u7ba1\u7406<\/h3>\n<p>\u6bcf\u6b21\u6570\u636e\u96c6\u53d8\u66f4\uff08\u65b0\u589e\u3001\u4fee\u6539\u3001\u5220\u9664\u8bb0\u5f55\uff09 <code>MUST<\/code> \u4ea7\u751f\u4e00\u4e2a\u65b0\u7684\u6570\u636e\u7248\u672c\u3002\u7248\u672c\u8bb0\u5f55\u5305\u542b\u53d8\u66f4\u65f6\u95f4\u3001\u53d8\u66f4\u4eba\u3001\u53d8\u66f4\u7c7b\u578b\u3001\u53d8\u66f4\u524d\u540e\u7684\u6570\u636e\u91cf\u3002\u6570\u636e\u7248\u672c\u4e0e\u6a21\u578b\u7248\u672c\u5173\u8054\uff1a\u6a21\u578b\u7684\u8bc4\u4f30\u7ed3\u679c <code>MUST<\/code> \u6807\u6ce8\u4f7f\u7528\u7684\u6570\u636e\u7248\u672c\u53f7\uff0c\u786e\u4fdd\u7ed3\u679c\u53ef\u590d\u73b0\u3002<\/p>\n<p>\u6570\u636e\u96c6\u7684\u7248\u672c\u63a7\u5236\u4e0d\u540c\u4e8e\u4ee3\u7801\u7684 Git \u7248\u672c\u63a7\u5236\u3002\u6570\u636e\u91cf\u5927\u3001\u4e8c\u8fdb\u5236\u683c\u5f0f\u591a\u3001\u53d8\u66f4\u9891\u7e41\uff0c<code>SHOULD<\/code> \u4f7f\u7528\u4e13\u95e8\u7684\u6570\u636e\u7248\u672c\u5de5\u5177\uff08\u5982 DVC \/ LakeFS\uff09\u800c\u975e\u76f4\u63a5\u5b58\u5165 Git\u3002<\/p>\n<h3 id=\"_22\">\u5b58\u50a8\u7b56\u7565<\/h3>\n<table>\n<thead>\n<tr>\n<th>\u6570\u636e\u7c7b\u578b<\/th>\n<th>\u5b58\u50a8\u65b9\u5f0f<\/th>\n<th>\u7248\u672c\u5316<\/th>\n<th>\u4fdd\u7559\u7b56\u7565<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u539f\u59cb\u6570\u636e<\/td>\n<td>\u5bf9\u8c61\u5b58\u50a8\uff08S3\/OSS\uff09<\/td>\n<td>\u4e0d\u53ef\u53d8\uff0c\u8ffd\u52a0\u5199\u5165<\/td>\n<td>\u6c38\u4e45\u4fdd\u7559\u6216\u6309\u5408\u89c4\u8981\u6c42<\/td>\n<\/tr>\n<tr>\n<td>\u6e05\u6d17\u540e\u6570\u636e<\/td>\n<td>\u5bf9\u8c61\u5b58\u50a8 + \u5143\u6570\u636e\u7d22\u5f15<\/td>\n<td>DVC\/LakeFS \u7248\u672c<\/td>\n<td>\u4fdd\u7559\u6700\u8fd1 N \u4e2a\u7248\u672c<\/td>\n<\/tr>\n<tr>\n<td>\u6807\u6ce8\u6570\u636e<\/td>\n<td>\u6570\u636e\u5e93 + \u7248\u672c\u5feb\u7167<\/td>\n<td>\u6bcf\u6b21\u6807\u6ce8\u53d8\u66f4\u4ea7\u751f\u7248\u672c<\/td>\n<td>\u6c38\u4e45\u4fdd\u7559<\/td>\n<\/tr>\n<tr>\n<td>\u8bc4\u4f30\u6570\u636e\u96c6<\/td>\n<td>Git \u4ed3\u5e93\uff08\u5c0f\u89c4\u6a21\uff09\u6216\u5bf9\u8c61\u5b58\u50a8<\/td>\n<td>Git \u63d0\u4ea4\u6216 DVC \u7248\u672c<\/td>\n<td>\u6c38\u4e45\u4fdd\u7559<\/td>\n<\/tr>\n<tr>\n<td>\u63a8\u7406\u65e5\u5fd7<\/td>\n<td>\u65f6\u5e8f\u6570\u636e\u5e93 + \u51b7\u5b58\u50a8\u5f52\u6863<\/td>\n<td>\u6309\u65f6\u95f4\u5206\u533a<\/td>\n<td>\u70ed\u6570\u636e 30 \u5929\uff0c\u51b7\u6570\u636e 1 \u5e74<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_23\">\u6570\u636e\u5b89\u5168\u4e0e\u9690\u79c1<\/h3>\n<p>\u542b PII\uff08\u4e2a\u4eba\u8eab\u4efd\u4fe1\u606f\uff09\u7684\u6570\u636e <code>MUST<\/code> \u5728\u8fdb\u5165\u6570\u636e\u7ba1\u9053\u524d\u5b8c\u6210\u8131\u654f\u5904\u7406\u3002\u8131\u654f\u89c4\u5219\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u58f0\u660e\uff0c\u4e0d\u786c\u7f16\u7801\u5728\u5904\u7406\u903b\u8f91\u4e2d\u3002\u6570\u636e\u8bbf\u95ee <code>MUST<\/code> \u7ecf\u8fc7\u8ba4\u8bc1\u6388\u6743\uff0c\u8bbf\u95ee\u65e5\u5fd7\u8bb0\u5f55\u64cd\u4f5c\u4eba\u3001\u65f6\u95f4\u3001\u6570\u636e\u8303\u56f4\u3002\u6a21\u578b\u8bad\u7ec3\u4f7f\u7528\u7684\u6570\u636e <code>MUST<\/code> \u53ef\u8ffd\u6eaf\u5230\u6570\u636e\u6765\u6e90\u548c\u6388\u6743\u72b6\u6001\u3002<\/p>\n<hr \/>\n<h2 id=\"7\">7. \u63a5\u53e3\u5c42\u89c4\u8303<\/h2>\n<p>\u63a5\u53e3\u662f\u6a21\u5757\u95f4\u7684\u5408\u7ea6\u3002\u4e00\u4efd\u597d\u7684\u63a5\u53e3\u5b9a\u4e49\u8ba9\u6d88\u8d39\u65b9\u65e0\u9700\u9605\u8bfb\u5b9e\u73b0\u4ee3\u7801\u5373\u53ef\u6b63\u786e\u8c03\u7528\uff0c\u8ba9\u63d0\u4f9b\u65b9\u5728\u4e0d\u7834\u574f\u6d88\u8d39\u65b9\u7684\u524d\u63d0\u4e0b\u91cd\u6784\u5b9e\u73b0\u3002<\/p>\n<h3 id=\"api\">API \u8bbe\u8ba1\u539f\u5219<\/h3>\n<ul>\n<li><strong>\u8d44\u6e90\u5bfc\u5411<\/strong> \u2014\u2014 URL \u8868\u8fbe\u8d44\u6e90\u800c\u975e\u52a8\u4f5c\uff0c\u52a8\u8bcd\u7531 HTTP method \u8868\u8fbe\uff1a<code>GET \/models\/:id<\/code> \u800c\u975e <code>GET \/getModel?id=<\/code><\/li>\n<li><strong>\u5e42\u7b49\u6027<\/strong> \u2014\u2014 GET \u8bf7\u6c42 <code>MUST<\/code> \u5e42\u7b49\uff0cPUT \u8bf7\u6c42 <code>SHOULD<\/code> \u5e42\u7b49\uff0cPOST \u8bf7\u6c42\u4e0d\u8981\u6c42\u5e42\u7b49\u4f46 <code>SHOULD<\/code> \u8fd4\u56de\u5e42\u7b49\u952e<\/li>\n<li><strong>\u5206\u9875<\/strong> \u2014\u2014 \u5217\u8868\u63a5\u53e3 <code>MUST<\/code> \u652f\u6301\u5206\u9875\uff0c\u9ed8\u8ba4\u4f7f\u7528\u6e38\u6807\u5206\u9875\uff08cursor-based\uff09\u800c\u975e\u504f\u79fb\u5206\u9875\uff08offset-based\uff09\uff0c\u5728\u6570\u636e\u91cf\u589e\u957f\u540e\u6027\u80fd\u66f4\u7a33\u5b9a<\/li>\n<li><strong>\u5b57\u6bb5\u7b5b\u9009<\/strong> \u2014\u2014 \u5217\u8868\u63a5\u53e3 <code>SHOULD<\/code> \u652f\u6301 <code>fields<\/code> \u53c2\u6570\uff0c\u8ba9\u8c03\u7528\u65b9\u6309\u9700\u83b7\u53d6\u5b57\u6bb5\uff0c\u51cf\u5c11\u4e0d\u5fc5\u8981\u7684\u6570\u636e\u4f20\u8f93<\/li>\n<li><strong>\u6279\u91cf\u64cd\u4f5c<\/strong> \u2014\u2014 \u6279\u91cf\u63a5\u53e3 <code>SHOULD<\/code> \u63a5\u53d7\u6570\u7ec4\u8f93\u5165\uff0c\u8fd4\u56de\u9010\u6761\u7ed3\u679c\u548c\u72b6\u6001\uff0c\u800c\u975e\u6574\u4f53\u6210\u529f\u6216\u5931\u8d25<\/li>\n<\/ul>\n<h3 id=\"_24\">\u9519\u8bef\u5904\u7406\u6807\u51c6<\/h3>\n<p>\u6240\u6709\u63a5\u53e3 <code>MUST<\/code> \u4f7f\u7528\u7edf\u4e00\u7684\u9519\u8bef\u54cd\u5e94\u683c\u5f0f\uff1a<\/p>\n<pre class=\"codehilite\"><code class=\"language-json\">{\n  &quot;error&quot;: {\n    &quot;code&quot;: &quot;MODEL_NOT_FOUND&quot;,\n    &quot;message&quot;: &quot;Model 'gpt-x\/v3' not found&quot;,\n    &quot;target&quot;: &quot;model&quot;,\n    &quot;details&quot;: {\n      &quot;available_models&quot;: [&quot;gpt-x\/v2&quot;, &quot;gpt-y\/v1&quot;]\n    },\n    &quot;request_id&quot;: &quot;uuid&quot;,\n    &quot;trace_id&quot;: &quot;...&quot;\n  }\n}\n<\/code><\/pre>\n<p>HTTP \u72b6\u6001\u7801\u4f7f\u7528\u7ea6\u5b9a\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>\u72b6\u6001\u7801<\/th>\n<th>\u8bed\u4e49<\/th>\n<th>\u4f7f\u7528\u573a\u666f<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>200<\/td>\n<td>\u6210\u529f<\/td>\n<td>\u8bf7\u6c42\u5904\u7406\u5b8c\u6210\uff0c\u8fd4\u56de\u7ed3\u679c<\/td>\n<\/tr>\n<tr>\n<td>202<\/td>\n<td>\u5df2\u63a5\u53d7<\/td>\n<td>\u5f02\u6b65\u4efb\u52a1\u5df2\u63d0\u4ea4\uff0c\u8fd4\u56de\u4efb\u52a1\u67e5\u8be2\u5730\u5740<\/td>\n<\/tr>\n<tr>\n<td>400<\/td>\n<td>\u5ba2\u6237\u7aef\u9519\u8bef<\/td>\n<td>\u8bf7\u6c42\u683c\u5f0f\u4e0d\u5408\u6cd5\u3001\u53c2\u6570\u7f3a\u5931\u3001\u7c7b\u578b\u9519\u8bef<\/td>\n<\/tr>\n<tr>\n<td>401<\/td>\n<td>\u672a\u8ba4\u8bc1<\/td>\n<td>\u7f3a\u5c11\u6216\u65e0\u6548\u7684\u8ba4\u8bc1\u51ed\u636e<\/td>\n<\/tr>\n<tr>\n<td>403<\/td>\n<td>\u65e0\u6743\u9650<\/td>\n<td>\u5df2\u8ba4\u8bc1\u4f46\u65e0\u6743\u8bbf\u95ee\u8be5\u8d44\u6e90<\/td>\n<\/tr>\n<tr>\n<td>404<\/td>\n<td>\u4e0d\u5b58\u5728<\/td>\n<td>\u8bf7\u6c42\u7684\u8d44\u6e90\u672a\u627e\u5230<\/td>\n<\/tr>\n<tr>\n<td>409<\/td>\n<td>\u51b2\u7a81<\/td>\n<td>\u8bf7\u6c42\u4e0e\u5f53\u524d\u8d44\u6e90\u72b6\u6001\u51b2\u7a81\uff08\u5982\u7248\u672c\u51b2\u7a81\uff09<\/td>\n<\/tr>\n<tr>\n<td>422<\/td>\n<td>\u8bed\u4e49\u9519\u8bef<\/td>\n<td>\u683c\u5f0f\u6b63\u786e\u4f46\u8bed\u4e49\u4e0d\u5408\u6cd5\uff08\u5982\u6e29\u5ea6\u53c2\u6570\u8d85\u51fa\u8303\u56f4\uff09<\/td>\n<\/tr>\n<tr>\n<td>429<\/td>\n<td>\u9650\u6d41<\/td>\n<td>\u8d85\u51fa\u8c03\u7528\u9891\u7387\u9650\u5236<\/td>\n<\/tr>\n<tr>\n<td>500<\/td>\n<td>\u670d\u52a1\u7aef\u9519\u8bef<\/td>\n<td>\u975e\u9884\u671f\u5f02\u5e38\uff0c\u9700\u8fd0\u7ef4\u4ecb\u5165<\/td>\n<\/tr>\n<tr>\n<td>503<\/td>\n<td>\u4e0d\u53ef\u7528<\/td>\n<td>\u4f9d\u8d56\u670d\u52a1\u4e0d\u53ef\u7528\uff0c\u53ef\u7a0d\u540e\u91cd\u8bd5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_25\">\u63a5\u53e3\u7248\u672c\u7b56\u7565<\/h3>\n<p>\u63a5\u53e3\u5728 URL \u8def\u5f84\u4e2d\u6807\u6ce8\u4e3b\u7248\u672c\u53f7\uff1a<code>\/api\/v1\/models\/:id<\/code>\u3002\u4e3b\u7248\u672c\u53f7\u53d8\u66f4\u610f\u5473\u7740\u5b58\u5728\u4e0d\u5411\u540e\u517c\u5bb9\u7684 breaking change\uff0c\u6d88\u8d39\u65b9\u9700\u8981\u9002\u914d\u3002\u6b21\u7248\u672c\u53f7\u548c\u4fee\u8ba2\u53f7\u5728\u54cd\u5e94\u5934\u6216\u54cd\u5e94\u4f53\u4e2d\u8fd4\u56de\uff0c\u4e0d\u4f53\u73b0\u5728 URL \u4e2d\u3002<\/p>\n<p>\u63a5\u53e3\u5e9f\u5f03\u6d41\u7a0b\uff1a\u6807\u8bb0\u4e3a deprecated \u540e <code>MUST<\/code> \u4fdd\u6301\u81f3\u5c11 2 \u4e2a\u6b21\u7248\u672c\u5468\u671f\u7684\u53ef\u7528\u671f\uff0c\u54cd\u5e94\u5934\u4e2d\u8fd4\u56de <code>Deprecation<\/code> \u548c <code>Sunset<\/code> \u5b57\u6bb5\u544a\u77e5\u6d88\u8d39\u65b9\u8fc1\u79fb\u65f6\u95f4\u3002\u5e9f\u5f03\u671f\u7ed3\u675f\u540e\u79fb\u9664\u63a5\u53e3\uff0c\u79fb\u9664\u64cd\u4f5c\u8bb0\u5f55\u5728 CHANGELOG \u4e2d\u3002<\/p>\n<hr \/>\n<h2 id=\"8\">8. \u8fed\u4ee3\u6f14\u8fdb\u673a\u5236<\/h2>\n<p>\u6a21\u5757\u5316\u67b6\u6784\u7684\u6700\u7ec8\u4ef7\u503c\u4f53\u73b0\u5728\u8fed\u4ee3\u6548\u7387\u4e0a\u3002\u5f53\u7cfb\u7edf\u80fd\u591f\u5728\u4e0d\u7275\u52a8\u5168\u5c40\u7684\u60c5\u51b5\u4e0b\u66ff\u6362\u6216\u5347\u7ea7\u5355\u4e2a\u6a21\u5757\uff0c\u8fed\u4ee3\u901f\u5ea6\u5c31\u4ece&#8221;\u7cfb\u7edf\u7ea7&#8221;\u964d\u4f4e\u5230\u4e86&#8221;\u6a21\u5757\u7ea7&#8221;\u3002\u672c\u7ae0\u5b9a\u4e49\u6a21\u5757\u4ece\u521b\u5efa\u5230\u9000\u5f79\u7684\u5168\u6d41\u7a0b\u3002<\/p>\n<h3 id=\"_26\">\u6a21\u5757\u751f\u547d\u5468\u671f<\/h3>\n<p>\u6bcf\u4e2a\u6a21\u5757\u7ecf\u5386\u4e94\u4e2a\u9636\u6bb5\uff0c\u9636\u6bb5\u8f6c\u6362\u9700\u6ee1\u8db3\u8be5\u9636\u6bb5\u7684<strong>\u51c6\u5165\u6761\u4ef6<\/strong>\u548c<strong>\u9000\u51fa\u6761\u4ef6<\/strong>\uff1a<\/p>\n<pre class=\"codehilite\"><code>Draft\uff08\u8349\u6848\uff09\u2192 Dev\uff08\u5f00\u53d1\u4e2d\uff09\u2192 Stable\uff08\u7a33\u5b9a\uff09\u2192 Maintenance\uff08\u7ef4\u62a4\uff09\u2192 Deprecated\uff08\u5e9f\u5f03\u4e2d\uff09\u2192 Retired\uff08\u5df2\u9000\u5f79\uff09\n                                           \u2193\n                                    Refactor\uff08\u91cd\u6784\uff09\u2192 Stable\n<\/code><\/pre>\n<table>\n<thead>\n<tr>\n<th>\u9636\u6bb5<\/th>\n<th>\u51c6\u5165\u6761\u4ef6<\/th>\n<th>\u9000\u51fa\u6761\u4ef6<\/th>\n<th>\u7ea6\u675f<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Draft\uff08\u8349\u6848\uff09<\/td>\n<td>\u6a21\u5757\u63d0\u6848\u901a\u8fc7\u8bc4\u5ba1<\/td>\n<td>\u63a5\u53e3\u5b9a\u4e49\u5b8c\u6210\u5e76\u8bc4\u5ba1\u901a\u8fc7<\/td>\n<td>\u4e0d\u53ef\u88ab\u5176\u4ed6\u6a21\u5757\u4f9d\u8d56<\/td>\n<\/tr>\n<tr>\n<td>Dev\uff08\u5f00\u53d1\u4e2d\uff09<\/td>\n<td>\u63a5\u53e3\u5b9a\u4e49\u8bc4\u5ba1\u901a\u8fc7<\/td>\n<td>\u5355\u5143\u6d4b\u8bd5\u8986\u76d6\u7387 \u2265 80%\uff0c\u6587\u6863\u5b8c\u6210<\/td>\n<td>\u63a5\u53e3\u53ef\u53d8\uff0c\u4e0d\u627f\u8bfa\u7a33\u5b9a<\/td>\n<\/tr>\n<tr>\n<td>Stable\uff08\u7a33\u5b9a\uff09<\/td>\n<td>\u6d4b\u8bd5\u8986\u76d6 + \u6587\u6863 + \u8bc4\u4f30\u8fbe\u6807<\/td>\n<td>\u89e6\u53d1\u91cd\u6784\u6216\u8fdb\u5165\u7ef4\u62a4<\/td>\n<td>\u63a5\u53e3\u53d8\u66f4\u9075\u5faa\u7248\u672c\u7b56\u7565<\/td>\n<\/tr>\n<tr>\n<td>Maintenance\uff08\u7ef4\u62a4\uff09<\/td>\n<td>\u4e0d\u518d\u65b0\u589e\u529f\u80fd<\/td>\n<td>\u6807\u8bb0\u4e3a deprecated<\/td>\n<td>\u4ec5\u4fee\u590d\u4e25\u91cd bug \u548c\u5b89\u5168\u6f0f\u6d1e<\/td>\n<\/tr>\n<tr>\n<td>Deprecated\uff08\u5e9f\u5f03\u4e2d\uff09<\/td>\n<td>\u6709\u66ff\u4ee3\u6a21\u5757\u6216\u63a5\u53e3<\/td>\n<td>\u8fc1\u79fb\u5b8c\u6210 + \u5e9f\u5f03\u671f\u6ee1<\/td>\n<td>\u6587\u6863\u6807\u6ce8\u66ff\u4ee3\u65b9\u6848<\/td>\n<\/tr>\n<tr>\n<td>Retired\uff08\u5df2\u9000\u5f79\uff09<\/td>\n<td>\u5e9f\u5f03\u671f\u6ee1 + \u65e0\u5f15\u7528<\/td>\n<td>\u2014<\/td>\n<td>\u4ee3\u7801\u4ece\u4ed3\u5e93\u79fb\u9664<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_27\">\u8bed\u4e49\u7248\u672c\u63a7\u5236<\/h3>\n<p>\u6bcf\u4e2a\u6a21\u5757\u9075\u5faa <strong>SemVer<\/strong>\uff08Semantic Versioning\uff09\u89c4\u8303\uff0c\u7248\u672c\u53f7\u683c\u5f0f\u4e3a <code>MAJOR.MINOR.PATCH<\/code>\uff1a<\/p>\n<ul>\n<li><strong>MAJOR<\/strong> \u2014\u2014 \u63a5\u53e3\u5b58\u5728\u4e0d\u5411\u540e\u517c\u5bb9\u7684\u53d8\u66f4\uff08\u5220\u9664\u63a5\u53e3\u3001\u4fee\u6539\u53c2\u6570\u7c7b\u578b\u3001\u4fee\u6539\u8fd4\u56de\u7ed3\u6784\uff09\u3002MAJOR \u53d8\u66f4 <code>MUST<\/code> \u4ea7\u51fa\u8fc1\u79fb\u6587\u6863\u3002<\/li>\n<li><strong>MINOR<\/strong> \u2014\u2014 \u65b0\u589e\u529f\u80fd\u6216\u63a5\u53e3\uff0c\u5411\u540e\u517c\u5bb9\u3002\u6d88\u8d39\u65b9\u4e0d\u5347\u7ea7\u4e5f\u80fd\u7ee7\u7eed\u5de5\u4f5c\uff0c\u5347\u7ea7\u540e\u53ef\u4f7f\u7528\u65b0\u80fd\u529b\u3002<\/li>\n<li><strong>PATCH<\/strong> \u2014\u2014 Bug \u4fee\u590d\u6216\u6027\u80fd\u4f18\u5316\uff0c\u4e0d\u6539\u53d8\u63a5\u53e3\u5951\u7ea6\u3002<\/li>\n<\/ul>\n<p>\u7248\u672c\u53f7\u8bb0\u5f55\u5728\u6a21\u5757\u7684 <code>module.yaml<\/code> \u4e2d\uff0c\u6a21\u5757\u6e05\u5355 <code>modules.yaml<\/code> \u540c\u6b65\u66f4\u65b0\u3002CI \u7ba1\u9053 <code>SHOULD<\/code> \u6821\u9a8c\u7248\u672c\u53f7\u53d8\u66f4\u4e0e\u5b9e\u9645 diff \u7684\u4e00\u81f4\u6027\u2014\u2014\u5982\u679c\u63a5\u53e3\u53d1\u751f\u4e86 breaking change \u4f46\u7248\u672c\u53f7\u53ea\u5347\u4e86 MINOR\uff0cCI <code>SHOULD<\/code> \u53d1\u51fa\u8b66\u544a\u3002<\/p>\n<h3 id=\"_28\">\u8fed\u4ee3\u5de5\u4f5c\u6d41<\/h3>\n<p>\u4e00\u4e2a\u5178\u578b\u7684\u529f\u80fd\u8fed\u4ee3\u6309\u4ee5\u4e0b\u6b65\u9aa4\u63a8\u8fdb\uff1a<\/p>\n<pre class=\"codehilite\"><code>\u9700\u6c42\u5206\u6790 \u2192 \u6a21\u5757\u5f71\u54cd\u8bc4\u4f30 \u2192 \u63a5\u53e3\u53d8\u66f4\u8bc4\u5ba1 \u2192 \u5f00\u53d1\u5b9e\u73b0 \u2192 \u6d4b\u8bd5\u9a8c\u8bc1 \u2192 \u96c6\u6210\u6d4b\u8bd5 \u2192 \u7070\u5ea6\u53d1\u5e03 \u2192 \u5168\u91cf\u53d1\u5e03\n                                                              \u2191                    \u2502\n                                                              \u2514\u2500\u2500\u2500\u2500 \u56de\u6eda \u2190\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n<\/code><\/pre>\n<p><strong>\u6a21\u5757\u5f71\u54cd\u8bc4\u4f30<\/strong>\u662f\u8fed\u4ee3\u6d41\u7a0b\u4e2d\u5bb9\u6613\u88ab\u8df3\u8fc7\u4f46\u6700\u5173\u952e\u7684\u73af\u8282\u3002\u8bc4\u4f30\u7684\u4ea7\u51fa\u662f\u4e00\u4efd\u5f71\u54cd\u8303\u56f4\u6e05\u5355\uff1a\u672c\u6b21\u53d8\u66f4\u6d89\u53ca\u54ea\u4e9b\u6a21\u5757\u3001\u54ea\u4e9b\u63a5\u53e3\u3001\u54ea\u4e9b\u6570\u636e\u683c\u5f0f\uff0c\u4e0b\u6e38\u6d88\u8d39\u65b9\u6709\u54ea\u4e9b\uff0c\u9700\u8981\u4ec0\u4e48\u9002\u914d\u3002\u5f71\u54cd\u8303\u56f4\u8d85\u51fa\u5355\u4e2a\u6a21\u5757\u7684\u53d8\u66f4 <code>MUST<\/code> \u5347\u7ea7\u4e3a\u8de8\u6a21\u5757\u8bc4\u5ba1\u3002<\/p>\n<h3 id=\"_29\">\u6280\u672f\u503a\u52a1\u7ba1\u7406<\/h3>\n<p>\u6280\u672f\u503a\u4e0d\u662f\u9700\u8981\u6d88\u706d\u7684\u654c\u4eba\uff0c\u800c\u662f\u9700\u8981\u7ba1\u7406\u7684\u8d44\u6e90\u3002\u6bcf\u4e2a\u6a21\u5757\u7ef4\u62a4\u4e00\u4efd\u6280\u672f\u503a\u6e05\u5355\uff0c\u8bb0\u5f55\u5df2\u77e5\u7684\u8bbe\u8ba1\u7f3a\u9677\u3001\u5f85\u4f18\u5316\u7684\u5b9e\u73b0\u3001\u786c\u7f16\u7801\u7684\u4e34\u65f6\u65b9\u6848\u3002\u6280\u672f\u503a\u6761\u76ee <code>SHOULD<\/code> \u5305\u542b\uff1a<\/p>\n<ul>\n<li>\u63cf\u8ff0\uff1a\u4ec0\u4e48\u95ee\u9898\uff0c\u4e3a\u4ec0\u4e48\u5f53\u521d\u8fd9\u6837\u5904\u7406<\/li>\n<li>\u5f71\u54cd\uff1a\u4e0d\u5904\u7406\u7684\u540e\u679c\uff08\u6027\u80fd\u3001\u53ef\u7ef4\u62a4\u6027\u3001\u5b89\u5168\u6027\uff09<\/li>\n<li>\u4f18\u5148\u7ea7\uff1a\u6309\u5f71\u54cd\u8303\u56f4\u548c\u4e25\u91cd\u7a0b\u5ea6\u6392\u5e8f<\/li>\n<li>\u507f\u8fd8\u65b9\u6848\uff1a\u9884\u671f\u7684\u4fee\u590d\u65b9\u5411\u548c\u9884\u4f30\u5de5\u4f5c\u91cf<\/li>\n<\/ul>\n<p>\u6bcf\u4e2a\u8fed\u4ee3\u5468\u671f <code>SHOULD<\/code> \u9884\u7559 15-20% \u7684\u5bb9\u91cf\u7528\u4e8e\u507f\u8fd8\u9ad8\u4f18\u5148\u7ea7\u6280\u672f\u503a\u3002\u6280\u672f\u503a\u6e05\u5355\u5728\u6bcf\u5b63\u5ea6\u7684\u67b6\u6784\u8bc4\u5ba1\u4e2d\u91cd\u65b0\u5ba1\u89c6\u548c\u6392\u5e8f\u3002<\/p>\n<hr \/>\n<h2 id=\"9\">9. \u5de5\u7a0b\u5b9e\u8df5\u89c4\u8303<\/h2>\n<p>\u5de5\u7a0b\u5b9e\u8df5\u89c4\u8303\u8986\u76d6\u4ee3\u7801\u5230\u90e8\u7f72\u4e4b\u95f4\u7684\u5168\u90e8\u73af\u8282\u3002\u8fd9\u4e9b\u7ea6\u5b9a\u4e0d\u662f\u98ce\u683c\u504f\u597d\uff0c\u800c\u662f\u4fdd\u8bc1\u6a21\u5757\u5316\u67b6\u6784\u5728\u56e2\u961f\u534f\u4f5c\u4e2d\u4e0d\u9000\u5316\u7684\u7ea6\u675f\u6761\u4ef6\u3002<\/p>\n<h3 id=\"_30\">\u4ee3\u7801\u98ce\u683c<\/h3>\n<p>\u9879\u76ee\u4f7f\u7528\u7edf\u4e00\u7684\u4ee3\u7801\u683c\u5f0f\u5316\u5de5\u5177\uff08Biome \/ Prettier + ESLint for TS, Ruff + Black for Python\uff09\uff0c\u914d\u7f6e\u6587\u4ef6\u63d0\u4ea4\u5230\u4ed3\u5e93\u6839\u76ee\u5f55\u3002\u683c\u5f0f\u5316\u5728\u63d0\u4ea4\u524d\u81ea\u52a8\u6267\u884c\uff0cCI \u7ba1\u9053\u6821\u9a8c\u683c\u5f0f\u4e00\u81f4\u6027\uff0c\u4e0d\u7b26\u5408\u7684 PR <code>MUST NOT<\/code> \u5408\u5e76\u3002<\/p>\n<p>\u4ee3\u7801\u6ce8\u91ca\u9075\u5faa&#8221;\u53ea\u89e3\u91ca\u4e3a\u4ec0\u4e48\uff0c\u4e0d\u89e3\u91ca\u662f\u4ec0\u4e48&#8221;\u7684\u539f\u5219\u3002\u51fd\u6570\u548c\u7c7b\u578b\u7684\u547d\u540d <code>SHOULD<\/code> \u8db3\u4ee5\u8868\u8fbe\u610f\u56fe\uff0c\u6ce8\u91ca\u7528\u4e8e\u8865\u5145\u547d\u540d\u65e0\u6cd5\u4f20\u8fbe\u7684\u4e0a\u4e0b\u6587\uff1a\u4e1a\u52a1\u7ea6\u675f\u3001\u5916\u90e8\u4f9d\u8d56\u7684\u9650\u5236\u3001\u5386\u53f2\u51b3\u7b56\u7684\u539f\u56e0\u3002\u81ea\u52a8\u751f\u6210\u7684\u6587\u6863\uff08\u5982 JSDoc \/ docstring\uff09 <code>SHOULD<\/code> \u8986\u76d6\u6240\u6709\u5bf9\u5916\u66b4\u9732\u7684\u63a5\u53e3\u548c\u516c\u5171\u7c7b\u578b\u3002<\/p>\n<h3 id=\"_31\">\u6d4b\u8bd5\u7b56\u7565<\/h3>\n<p>\u6d4b\u8bd5\u5206\u4e3a\u4e09\u5c42\uff0c\u5404\u6709\u4e0d\u540c\u7684\u5173\u6ce8\u70b9\u548c\u8986\u76d6\u7387\u8981\u6c42\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>\u5c42\u7ea7<\/th>\n<th>\u5173\u6ce8\u70b9<\/th>\n<th>\u8986\u76d6\u7387\u8981\u6c42<\/th>\n<th>\u6267\u884c\u4f4d\u7f6e<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u5355\u5143\u6d4b\u8bd5<\/td>\n<td>\u6a21\u5757\u5185\u51fd\u6570\u548c\u7c7b\u7684\u903b\u8f91\u6b63\u786e\u6027<\/td>\n<td>\u2265 80% \u884c\u8986\u76d6<\/td>\n<td>\u6bcf\u6b21\u63d0\u4ea4<\/td>\n<\/tr>\n<tr>\n<td>\u96c6\u6210\u6d4b\u8bd5<\/td>\n<td>\u6a21\u5757\u95f4\u63a5\u53e3\u5951\u7ea6\u7684\u517c\u5bb9\u6027<\/td>\n<td>\u5173\u952e\u8def\u5f84 100% \u8986\u76d6<\/td>\n<td>\u5408\u5e76\u5230\u4e3b\u5206\u652f\u524d<\/td>\n<\/tr>\n<tr>\n<td>\u7aef\u5230\u7aef\u6d4b\u8bd5<\/td>\n<td>\u7528\u6237\u89c6\u89d2\u7684\u6838\u5fc3\u4e1a\u52a1\u6d41\u7a0b<\/td>\n<td>\u6838\u5fc3\u573a\u666f\u5168\u8986\u76d6<\/td>\n<td>\u6bcf\u65e5\u5b9a\u65f6 + \u53d1\u5e03\u524d<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>AI \u76f8\u5173\u6a21\u5757\u7684\u6d4b\u8bd5 <code>MUST<\/code> \u989d\u5916\u5305\u542b<strong>\u6a21\u578b\u56de\u5f52\u6d4b\u8bd5<\/strong>\uff1a\u4f7f\u7528\u56fa\u5b9a\u7684\u8bc4\u4f30\u6570\u636e\u96c6\uff0c\u5bf9\u6bd4\u5f53\u524d\u7248\u672c\u4e0e\u57fa\u7ebf\u7248\u672c\u7684\u8f93\u51fa\u3002\u6a21\u578b\u8f93\u51fa\u7684\u56de\u5f52\u6d4b\u8bd5\u4e0d\u8981\u6c42\u9010\u5b57\u5339\u914d\uff0c\u800c\u662f\u8bc4\u4f30\u6307\u6807\u5728\u5bb9\u5dee\u8303\u56f4\u5185\u2014\u2014\u5ef6\u8fdf\u53d8\u5316\u4e0d\u8d85\u8fc7\u57fa\u7ebf\u7684 10%\uff0c\u8d28\u91cf\u6307\u6807\u6ce2\u52a8\u4e0d\u8d85\u8fc7 2 \u4e2a\u767e\u5206\u70b9\u3002<\/p>\n<h3 id=\"cicd\">CI\/CD \u7ba1\u9053<\/h3>\n<p>CI \u7ba1\u9053\u5728\u6bcf\u6b21\u4ee3\u7801\u63a8\u9001\u65f6\u6267\u884c\u4ee5\u4e0b\u68c0\u67e5\uff0c\u6309\u987a\u5e8f\u4e32\u884c\uff1a<\/p>\n<ol>\n<li><strong>Lint &amp; Format<\/strong> \u2014\u2014 \u4ee3\u7801\u98ce\u683c\u548c\u683c\u5f0f\u6821\u9a8c\uff0c\u5931\u8d25\u5373\u963b\u65ad<\/li>\n<li><strong>Unit Tests<\/strong> \u2014\u2014 \u5355\u5143\u6d4b\u8bd5\uff0c\u5931\u8d25\u5373\u963b\u65ad<\/li>\n<li><strong>Build<\/strong> \u2014\u2014 \u7f16\u8bd1\u548c\u6784\u5efa\uff0c\u9a8c\u8bc1\u7c7b\u578b\u6b63\u786e\u6027<\/li>\n<li><strong>Integration Tests<\/strong> \u2014\u2014 \u96c6\u6210\u6d4b\u8bd5\uff0c\u9a8c\u8bc1\u6a21\u5757\u95f4\u63a5\u53e3\u517c\u5bb9<\/li>\n<li><strong>Security Scan<\/strong> \u2014\u2014 \u4f9d\u8d56\u6f0f\u6d1e\u626b\u63cf\u548c\u654f\u611f\u4fe1\u606f\u68c0\u6d4b<\/li>\n<\/ol>\n<p>CD \u7ba1\u9053\u5728 CI \u5168\u90e8\u901a\u8fc7\u540e\u6267\u884c\uff0c\u90e8\u7f72\u7b56\u7565\u53d6\u51b3\u4e8e\u6a21\u5757\u7c7b\u578b\uff1a\u6838\u5fc3\u6a21\u5757\u4f7f\u7528\u7070\u5ea6\u53d1\u5e03\uff08\u5148 5% \u2192 25% \u2192 50% \u2192 100%\uff09\uff0c\u5de5\u5177\u6a21\u5757\u53ef\u76f4\u63a5\u5168\u91cf\u53d1\u5e03\u3002\u6bcf\u4e2a\u90e8\u7f72\u6279\u6b21 <code>MUST<\/code> \u8bbe\u7f6e\u81ea\u52a8\u56de\u6eda\u89e6\u53d1\u6761\u4ef6\uff1a\u9519\u8bef\u7387\u8d85\u8fc7\u9608\u503c\u6216\u5ef6\u8fdf\u8d85\u8fc7\u57fa\u7ebf 150%\u3002<\/p>\n<h3 id=\"_32\">\u73af\u5883\u7ba1\u7406<\/h3>\n<p>\u9879\u76ee\u7ef4\u62a4\u56db\u5957\u73af\u5883\uff0c\u5404\u6709\u660e\u786e\u7528\u9014\u548c\u9694\u79bb\u8981\u6c42\uff1a<\/p>\n<ul>\n<li><strong>local<\/strong> \u2014\u2014 \u5f00\u53d1\u8005\u672c\u5730\uff0c\u7528\u4e8e\u5f00\u53d1\u548c\u5355\u5143\u6d4b\u8bd5\u3002\u4f7f\u7528 mock \u4f9d\u8d56\uff0c\u4e0d\u8fde\u63a5\u771f\u5b9e\u6a21\u578b\u670d\u52a1\u3002<\/li>\n<li><strong>staging<\/strong> \u2014\u2014 \u9884\u53d1\u5e03\u73af\u5883\uff0c\u4f7f\u7528\u8131\u654f\u540e\u7684\u771f\u5b9e\u6570\u636e\uff0c\u8fde\u63a5 staging \u7248\u672c\u7684\u6a21\u578b\u548c\u4f9d\u8d56\u670d\u52a1\u3002\u96c6\u6210\u6d4b\u8bd5\u5728\u6b64\u6267\u884c\u3002<\/li>\n<li><strong>production<\/strong> \u2014\u2014 \u751f\u4ea7\u73af\u5883\uff0c\u8fde\u63a5\u771f\u5b9e\u7684\u6a21\u578b\u548c\u6570\u636e\u3002\u53d8\u66f4 <code>MUST<\/code> \u7ecf\u8fc7\u7070\u5ea6\u6d41\u7a0b\u3002<\/li>\n<li><strong>benchmark<\/strong> \u2014\u2014 \u6027\u80fd\u57fa\u51c6\u73af\u5883\uff0c\u914d\u7f6e\u4e0e production \u4e00\u81f4\u4f46\u9694\u79bb\u6d41\u91cf\u3002\u7528\u4e8e\u6a21\u578b\u8bc4\u4f30\u548c\u6027\u80fd\u56de\u5f52\u6d4b\u8bd5\u3002<\/li>\n<\/ul>\n<p>\u73af\u5883\u4e4b\u95f4\u7684\u914d\u7f6e\u5dee\u5f02\u901a\u8fc7\u73af\u5883\u53d8\u91cf\u6ce8\u5165\uff0c<code>MUST NOT<\/code> \u5728\u4ee3\u7801\u4e2d\u901a\u8fc7 <code>if env === 'production'<\/code> \u5206\u652f\u5904\u7406\u3002\u914d\u7f6e\u7ba1\u7406\u4f7f\u7528\u4e13\u95e8\u7684\u914d\u7f6e\u4e2d\u5fc3\u6216\u73af\u5883\u53d8\u91cf\u6587\u4ef6\uff0c\u654f\u611f\u4fe1\u606f\uff08API Key\u3001\u6570\u636e\u5e93\u5bc6\u7801\uff09 <code>MUST<\/code> \u4f7f\u7528\u5bc6\u94a5\u7ba1\u7406\u670d\u52a1\uff0c\u4e0d\u63d0\u4ea4\u5230\u4ee3\u7801\u4ed3\u5e93\u3002<\/p>\n<hr \/>\n<h2 id=\"10\">10. \u534f\u4f5c\u4e0e\u53d1\u5e03\u89c4\u8303<\/h2>\n<p>\u6a21\u5757\u5316\u67b6\u6784\u7684\u957f\u671f\u5065\u5eb7\u53d6\u51b3\u4e8e\u56e2\u961f\u534f\u4f5c\u7eaa\u5f8b\u3002\u672c\u7ae0\u5b9a\u4e49\u4ee3\u7801\u4ece\u7f16\u5199\u5230\u53d1\u5e03\u5230\u751f\u4ea7\u7684\u8fc7\u7a0b\u4e2d\uff0c\u56e2\u961f\u9700\u8981\u5171\u540c\u9075\u5b88\u7684\u6d41\u7a0b\u7ea6\u5b9a\u3002<\/p>\n<h3 id=\"_33\">\u5206\u652f\u7b56\u7565<\/h3>\n<p>\u9879\u76ee\u91c7\u7528 <strong>Trunk-Based Development<\/strong>\uff0c\u6240\u6709\u4eba\u5411\u4e3b\u5206\u652f\uff08<code>main<\/code>\uff09\u63d0\u4ea4\u4ee3\u7801\uff0c\u4e0d\u7ef4\u62a4\u957f\u671f\u7684\u529f\u80fd\u5206\u652f\u3002\u529f\u80fd\u5f00\u53d1\u5728\u77ed\u671f\u5206\u652f\uff08\u5b58\u6d3b\u4e0d\u8d85\u8fc7 3 \u5929\uff09\u4e0a\u8fdb\u884c\uff0c\u5b8c\u6210\u540e\u5408\u5e76\u56de <code>main<\/code>\u3002\u53d1\u5e03\u4ece <code>main<\/code> \u7684\u6807\u8bb0\u7248\u672c\u5207\u51fa release \u5206\u652f\uff0crelease \u5206\u652f\u4ec5\u7528\u4e8e\u4fee\u590d\u53d1\u5e03\u963b\u585e\u7684 bug\u3002<\/p>\n<blockquote>\n<p><strong>\u5206\u652f\u547d\u540d<\/strong>\uff1a\u529f\u80fd\u5206\u652f <code>feat\/&lt;module&gt;-&lt;description&gt;<\/code>\uff08\u5982 <code>feat\/inference-stream-support<\/code>\uff09\u3002\u4fee\u590d\u5206\u652f <code>fix\/&lt;module&gt;-&lt;description&gt;<\/code>\u3002Release \u5206\u652f <code>release\/v&lt;version&gt;<\/code>\u3002<\/p>\n<\/blockquote>\n<h3 id=\"_34\">\u4ee3\u7801\u5ba1\u67e5<\/h3>\n<p>\u6240\u6709\u4ee3\u7801\u53d8\u66f4 <code>MUST<\/code> \u7ecf\u8fc7\u81f3\u5c11 1 \u4eba\u7684\u5ba1\u67e5\u540e\u5408\u5e76\u3002\u6d89\u53ca\u63a5\u53e3\u53d8\u66f4\u7684 PR <code>MUST<\/code> \u7531\u6a21\u5757\u8d1f\u8d23\u4eba\u6216\u67b6\u6784\u5e08\u5ba1\u67e5\u3002PR \u5ba1\u67e5\u5173\u6ce8\u4ee5\u4e0b\u7ef4\u5ea6\uff1a<\/p>\n<ul>\n<li><strong>\u63a5\u53e3\u5408\u89c4<\/strong> \u2014\u2014 \u53d8\u66f4\u662f\u5426\u7b26\u5408\u63a5\u53e3\u5951\u7ea6\uff0c\u7248\u672c\u53f7\u662f\u5426\u6b63\u786e<\/li>\n<li><strong>\u6a21\u5757\u8fb9\u754c<\/strong> \u2014\u2014 \u662f\u5426\u5f15\u5165\u4e86\u8d8a\u5c42\u4f9d\u8d56\u6216\u5faa\u73af\u4f9d\u8d56<\/li>\n<li><strong>\u6d4b\u8bd5\u8986\u76d6<\/strong> \u2014\u2014 \u65b0\u589e\u4ee3\u7801\u662f\u5426\u6709\u5bf9\u5e94\u7684\u6d4b\u8bd5\u8986\u76d6<\/li>\n<li><strong>\u6587\u6863\u540c\u6b65<\/strong> \u2014\u2014 \u63a5\u53e3\u53d8\u66f4\u662f\u5426\u540c\u6b65\u66f4\u65b0\u4e86\u6587\u6863\u548c\u5951\u7ea6\u6587\u4ef6<\/li>\n<\/ul>\n<p>PR \u63cf\u8ff0 <code>MUST<\/code> \u5305\u542b\u53d8\u66f4\u6458\u8981\u3001\u5f71\u54cd\u8303\u56f4\u3001\u6d4b\u8bd5\u65b9\u6cd5\u548c\u5173\u8054\u7684 issue\/\u4efb\u52a1\u3002\u5927\u578b PR\uff08\u8d85\u8fc7 500 \u884c\u53d8\u66f4\uff09 <code>SHOULD<\/code> \u62c6\u5206\u4e3a\u591a\u4e2a\u5c0f PR \u4f9d\u6b21\u63d0\u4ea4\uff0c\u964d\u4f4e\u5ba1\u67e5\u96be\u5ea6\u548c\u5408\u5e76\u98ce\u9669\u3002<\/p>\n<h3 id=\"_35\">\u53d1\u5e03\u6d41\u7a0b<\/h3>\n<p>\u53d1\u5e03\u6d41\u7a0b\u6807\u51c6\u5316\u4e3a\u4e94\u4e2a\u6b65\u9aa4\uff1a<\/p>\n<ol>\n<li><strong>\u53d1\u5e03\u51c6\u5907<\/strong> \u2014\u2014 \u51bb\u7ed3\u65b0\u529f\u80fd\u5408\u5e76\uff0c\u521b\u5efa release \u5206\u652f\uff0c\u8fd0\u884c\u5b8c\u6574 CI \u5957\u4ef6<\/li>\n<li><strong>\u7070\u5ea6\u90e8\u7f72<\/strong> \u2014\u2014 \u90e8\u7f72\u5230 production \u7684 5% \u6d41\u91cf\uff0c\u76d1\u63a7\u9519\u8bef\u7387\u548c\u5ef6\u8fdf\u6307\u6807 30 \u5206\u949f<\/li>\n<li><strong>\u6269\u5927\u7070\u5ea6<\/strong> \u2014\u2014 \u6307\u6807\u6b63\u5e38\u5219\u6269\u5927\u5230 25% \u2192 50% \u2192 100%\uff0c\u6bcf\u9636\u6bb5\u89c2\u5bdf 30 \u5206\u949f<\/li>\n<li><strong>\u53d1\u5e03\u786e\u8ba4<\/strong> \u2014\u2014 \u5168\u91cf\u90e8\u7f72\u540e\u89c2\u5bdf 24 \u5c0f\u65f6\uff0c\u786e\u8ba4\u65e0\u5f02\u5e38\u540e\u6807\u8bb0\u53d1\u5e03\u5b8c\u6210<\/li>\n<li><strong>\u53d1\u5e03\u5f52\u6863<\/strong> \u2014\u2014 \u66f4\u65b0 CHANGELOG\uff0c\u5f52\u6863 release \u5206\u652f\uff0c\u8bb0\u5f55\u53d1\u5e03\u6458\u8981<\/li>\n<\/ol>\n<p>\u7070\u5ea6\u671f\u95f4\u7684\u76d1\u63a7\u6307\u6807\u548c\u56de\u6eda\u9608\u503c\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>\u6307\u6807<\/th>\n<th>\u56de\u6eda\u9608\u503c<\/th>\n<th>\u89c2\u5bdf\u7a97\u53e3<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u9519\u8bef\u7387\uff085xx\uff09<\/td>\n<td>&gt; 1%<\/td>\n<td>\u6ed1\u52a8 5 \u5206\u949f<\/td>\n<\/tr>\n<tr>\n<td>P99 \u5ef6\u8fdf<\/td>\n<td>&gt; \u57fa\u7ebf 150%<\/td>\n<td>\u6ed1\u52a8 10 \u5206\u949f<\/td>\n<\/tr>\n<tr>\n<td>\u63a8\u7406\u8d28\u91cf\u6307\u6807<\/td>\n<td>\u504f\u79bb\u57fa\u7ebf &gt; 5%<\/td>\n<td>\u6ed1\u52a8 30 \u5206\u949f<\/td>\n<\/tr>\n<tr>\n<td>\u8d44\u6e90\u4f7f\u7528\u7387<\/td>\n<td>GPU \u663e\u5b58 &gt; 95%<\/td>\n<td>\u5b9e\u65f6<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"_36\">\u53d8\u66f4\u65e5\u5fd7<\/h3>\n<p>\u6bcf\u4e2a\u6a21\u5757\u7ef4\u62a4\u72ec\u7acb\u7684 <code>CHANGELOG.md<\/code>\uff0c\u9879\u76ee\u6839\u76ee\u5f55\u7ef4\u62a4\u6c47\u603b\u7684 <code>CHANGELOG.md<\/code>\u3002\u53d8\u66f4\u65e5\u5fd7\u9075\u5faa <strong>Keep a Changelog<\/strong> \u683c\u5f0f\uff0c\u6309\u7248\u672c\u5012\u5e8f\u6392\u5217\uff1a<\/p>\n<pre class=\"codehilite\"><code class=\"language-markdown\"># CHANGELOG.md\n\n## [Unreleased]\n\n### Added\n- \u63a8\u7406\u670d\u52a1\u652f\u6301\u6d41\u5f0f\u8fd4\u56de\uff08modules\/inference\uff09\n\n### Changed\n- \u6a21\u578b\u7ba1\u7406\u63a5\u53e3\u8fd4\u56de\u589e\u52a0 `lifecycle_status` \u5b57\u6bb5\uff08modules\/model-manager\uff09\n\n### Fixed\n- Prompt \u6a21\u677f\u6e32\u67d3\u65f6\u53d8\u91cf\u7c7b\u578b\u6821\u9a8c\u5931\u6548\uff08modules\/prompt-engine\uff09\n\n### Deprecated\n- `GET \/api\/v1\/models` \u7684 `verbose` \u53c2\u6570\uff0c\u4f7f\u7528 `fields` \u66ff\u4ee3\n\n## [1.2.0] - 2026-08-15\n\n### Added\n- RAG \u91cd\u6392\u6a21\u5757\uff08modules\/reranker\uff09\n- \u6570\u636e\u7ba1\u9053\u652f\u6301\u589e\u91cf\u66f4\u65b0\u6a21\u5f0f\uff08modules\/data-pipeline\uff09\n<\/code><\/pre>\n<blockquote>\n<p><strong>\u81ea\u52a8\u5316\u5efa\u8bae<\/strong>\uff1a\u53d8\u66f4\u65e5\u5fd7\u7684\u7ef4\u62a4 <code>SHOULD<\/code> \u901a\u8fc7 Conventional Commits + \u81ea\u52a8\u5316\u5de5\u5177\uff08\u5982 changesets \/ standard-version\uff09\u5b8c\u6210\u3002\u63d0\u4ea4\u4fe1\u606f\u4f7f\u7528\u7ea6\u5b9a\u5f0f\u683c\u5f0f\uff08<code>feat:<\/code>, <code>fix:<\/code>, <code>break:<\/code>\uff09\uff0cCI \u7ba1\u9053\u5728\u53d1\u5e03\u65f6\u81ea\u52a8\u751f\u6210 CHANGELOG \u6761\u76ee\uff0c\u51cf\u5c11\u4eba\u5de5\u9057\u6f0f\u3002<\/p>\n<\/blockquote>\n<h3 id=\"_37\">\u4e8b\u6545\u54cd\u5e94<\/h3>\n<p>\u751f\u4ea7\u4e8b\u6545\u6309\u4e25\u91cd\u7a0b\u5ea6\u5206\u7ea7\u54cd\u5e94\u3002P0\uff08\u670d\u52a1\u4e0d\u53ef\u7528\uff09\u8981\u6c42 15 \u5206\u949f\u5185\u54cd\u5e94\u30011 \u5c0f\u65f6\u5185\u6062\u590d\u6216\u56de\u6eda\uff1bP1\uff08\u6838\u5fc3\u529f\u80fd\u964d\u7ea7\uff09\u8981\u6c42 1 \u5c0f\u65f6\u5185\u54cd\u5e94\u30014 \u5c0f\u65f6\u5185\u6062\u590d\u3002\u4e8b\u6545\u5904\u7406\u5b8c\u6210\u540e <code>MUST<\/code> \u5728 3 \u4e2a\u5de5\u4f5c\u65e5\u5185\u4ea7\u51fa\u4e8b\u6545\u590d\u76d8\u6587\u6863\uff0c\u5305\u542b\u65f6\u95f4\u7ebf\u3001\u6839\u56e0\u5206\u6790\u3001\u5f71\u54cd\u8303\u56f4\u548c\u6539\u8fdb\u63aa\u65bd\u3002\u6539\u8fdb\u63aa\u65bd\u5f55\u5165\u76f8\u5173\u6a21\u5757\u7684\u6280\u672f\u503a\u6e05\u5355\uff0c\u5728\u4e0b\u4e00\u6b21\u8fed\u4ee3\u4e2d\u5b89\u6392\u5904\u7406\u3002<\/p>\n<hr \/>\n<blockquote>\n<p>\u672c\u89c4\u8303\u4e3a\u6d3b\u6587\u6863\uff0c\u968f\u9879\u76ee\u5b9e\u8df5\u6301\u7eed\u8fed\u4ee3\u3002\u89c4\u8303\u53d8\u66f4\u9700\u7ecf\u67b6\u6784\u8bc4\u5ba1\u901a\u8fc7\u540e\u5408\u5e76\u3002<\/p>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"<p>AI \u8f6f\u4ef6\u8bbe\u8ba1\u9879\u76ee\u89c4\u8303 Technical Specification v1.0 \u6a21\u5757\u5316\u67b6\u6784\u4e0e\u8fed\u4ee3\u6f14\u8fdb\u6307\u5357 \u2014 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-10","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/posts\/10","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/comments?post=10"}],"version-history":[{"count":0,"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/posts\/10\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/media?parent=10"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/categories?post=10"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ssouq.xyz\/index.php\/wp-json\/wp\/v2\/tags?post=10"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}