{"id":101,"date":"2026-03-21T22:47:17","date_gmt":"2026-03-21T14:47:17","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/concepts-queue\/"},"modified":"2026-03-21T23:08:55","modified_gmt":"2026-03-21T15:08:55","slug":"concepts-queue","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/concepts-queue\/","title":{"rendered":"\u547d\u4ee4\u961f\u5217"},"content":{"rendered":"<h1>\u547d\u4ee4\u961f\u5217<\/h1>\n<h1>\u547d\u4ee4\u961f\u5217\uff082026-01-16\uff09<\/h1>\n<p>\u6211\u4eec\u901a\u8fc7\u4e00\u4e2a\u5c0f\u578b\u8fdb\u7a0b\u5185\u961f\u5217\u5e8f\u5217\u5316\u5165\u7ad9\u81ea\u52a8\u56de\u590d\u8fd0\u884c\uff08\u6240\u6709\u6e20\u9053\uff09\uff0c\u4ee5\u9632\u6b62\u591a\u4e2a\u667a\u80fd\u4f53\u8fd0\u884c\u53d1\u751f\u51b2\u7a81\uff0c\u540c\u65f6\u4ecd\u5141\u8bb8\u8de8\u4f1a\u8bdd\u7684\u5b89\u5168\u5e76\u884c\u3002<\/p>\n<h2>\u4e3a\u4ec0\u4e48\u9700\u8981<\/h2>\n<ul>\n<li>\u81ea\u52a8\u56de\u590d\u8fd0\u884c\u53ef\u80fd\u5f00\u9500\u5f88\u5927\uff08LLM \u8c03\u7528\uff09\uff0c\u5f53\u591a\u6761\u5165\u7ad9\u6d88\u606f\u63a5\u8fd1\u540c\u65f6\u5230\u8fbe\u65f6\u53ef\u80fd\u53d1\u751f\u51b2\u7a81\u3002<\/li>\n<li>\u5e8f\u5217\u5316\u53ef\u4ee5\u907f\u514d\u7ade\u4e89\u5171\u4eab\u8d44\u6e90\uff08\u4f1a\u8bdd\u6587\u4ef6\u3001\u65e5\u5fd7\u3001CLI stdin\uff09\uff0c\u5e76\u964d\u4f4e\u4e0a\u6e38\u901f\u7387\u9650\u5236\u7684\u53ef\u80fd\u6027\u3002<\/li>\n<\/ul>\n<h2>\u5de5\u4f5c\u539f\u7406<\/h2>\n<ul>\n<li>\u4e00\u4e2a\u652f\u6301\u901a\u9053\u611f\u77e5\u7684 FIFO \u961f\u5217\u4ee5\u53ef\u914d\u7f6e\u7684\u5e76\u53d1\u4e0a\u9650\u6392\u7a7a\u6bcf\u4e2a\u901a\u9053\uff08\u672a\u914d\u7f6e\u7684\u901a\u9053\u9ed8\u8ba4\u4e3a 1\uff1bmain \u9ed8\u8ba4\u4e3a 4\uff0csubagent \u4e3a 8\uff09\u3002<\/li>\n<li><code>runEmbeddedPiAgent<\/code> \u6309<strong>\u4f1a\u8bdd\u952e<\/strong>\u5165\u961f\uff08\u901a\u9053 <code>session:&lt;key&gt;<\/code>\uff09\uff0c\u4ee5\u4fdd\u8bc1\u6bcf\u4e2a\u4f1a\u8bdd\u53ea\u6709\u4e00\u4e2a\u6d3b\u52a8\u8fd0\u884c\u3002<\/li>\n<li>\u7136\u540e\u6bcf\u4e2a\u4f1a\u8bdd\u8fd0\u884c\u88ab\u6392\u5165<strong>\u5168\u5c40\u901a\u9053<\/strong>\uff08\u9ed8\u8ba4\u4e3a <code>main<\/code>\uff09\uff0c\u56e0\u6b64\u6574\u4f53\u5e76\u884c\u5ea6\u53d7 <code>agents.defaults.maxConcurrent<\/code> \u9650\u5236\u3002<\/li>\n<li>\u542f\u7528\u8be6\u7ec6\u65e5\u5fd7\u65f6\uff0c\u5982\u679c\u6392\u961f\u8fd0\u884c\u5728\u5f00\u59cb\u524d\u7b49\u5f85\u8d85\u8fc7\u7ea6 2 \u79d2\uff0c\u4f1a\u53d1\u51fa\u7b80\u77ed\u901a\u77e5\u3002<\/li>\n<li>\u8f93\u5165\u6307\u793a\u5668\u4ecd\u5728\u5165\u961f\u65f6\u7acb\u5373\u89e6\u53d1\uff08\u5f53\u6e20\u9053\u652f\u6301\u65f6\uff09\uff0c\u56e0\u6b64\u5728\u7b49\u5f85\u8f6e\u6b21\u65f6\u7528\u6237\u4f53\u9a8c\u4e0d\u53d7\u5f71\u54cd\u3002<\/li>\n<\/ul>\n<h2>\u961f\u5217\u6a21\u5f0f\uff08\u6309\u6e20\u9053\uff09<\/h2>\n<p>\u5165\u7ad9\u6d88\u606f\u53ef\u4ee5\u5f15\u5bfc\u5f53\u524d\u8fd0\u884c\u3001\u7b49\u5f85\u540e\u7eed\u8f6e\u6b21\uff0c\u6216\u4e24\u8005\u517c\u987e\uff1a<\/p>\n<ul>\n<li><code>steer<\/code>\uff1a\u7acb\u5373\u6ce8\u5165\u5f53\u524d\u8fd0\u884c\uff08\u5728\u4e0b\u4e00\u4e2a\u5de5\u5177\u8fb9\u754c\u540e\u53d6\u6d88\u5f85\u5904\u7406\u7684\u5de5\u5177\u8c03\u7528\uff09\u3002\u5982\u679c\u672a\u5728\u6d41\u5f0f\u4f20\u8f93\uff0c\u5219\u56de\u9000\u5230 followup\u3002<\/li>\n<li><code>followup<\/code>\uff1a\u5728\u5f53\u524d\u8fd0\u884c\u7ed3\u675f\u540e\u4e3a\u4e0b\u4e00\u4e2a\u667a\u80fd\u4f53\u8f6e\u6b21\u5165\u961f\u3002<\/li>\n<li><code>collect<\/code>\uff1a\u5c06\u6240\u6709\u6392\u961f\u6d88\u606f\u5408\u5e76\u4e3a<strong>\u5355\u4e2a<\/strong>\u540e\u7eed\u8f6e\u6b21\uff08\u9ed8\u8ba4\uff09\u3002\u5982\u679c\u6d88\u606f\u9488\u5bf9\u4e0d\u540c\u7684\u6e20\u9053\/\u7ebf\u7a0b\uff0c\u5b83\u4eec\u4f1a\u5355\u72ec\u6392\u7a7a\u4ee5\u4fdd\u7559\u8def\u7531\u3002<\/li>\n<li><code>steer-backlog<\/code>\uff08\u53c8\u540d <code>steer+backlog<\/code>\uff09\uff1a\u73b0\u5728\u5f15\u5bfc<strong>\u5e76<\/strong>\u4fdd\u7559\u6d88\u606f\u7528\u4e8e\u540e\u7eed\u8f6e\u6b21\u3002<\/li>\n<li><code>interrupt<\/code>\uff08\u65e7\u7248\uff09\uff1a\u4e2d\u6b62\u8be5\u4f1a\u8bdd\u7684\u6d3b\u52a8\u8fd0\u884c\uff0c\u7136\u540e\u8fd0\u884c\u6700\u65b0\u6d88\u606f\u3002<\/li>\n<li><code>queue<\/code>\uff08\u65e7\u7248\u522b\u540d\uff09\uff1a\u4e0e <code>steer<\/code> \u76f8\u540c\u3002<\/li>\n<\/ul>\n<p>steer-backlog \u610f\u5473\u7740\u4f60\u53ef\u4ee5\u5728\u88ab\u5f15\u5bfc\u7684\u8fd0\u884c\u4e4b\u540e\u83b7\u5f97\u540e\u7eed\u54cd\u5e94\uff0c\u56e0\u6b64\u6d41\u5f0f\u4f20\u8f93\u754c\u9762\u53ef\u80fd\u770b\u8d77\u6765\u50cf\u91cd\u590d\u3002\u5982\u679c\u4f60\u5e0c\u671b\u6bcf\u6761\u5165\u7ad9\u6d88\u606f\u53ea\u6709\u4e00\u4e2a\u54cd\u5e94\uff0c\u8bf7\u4f18\u5148\u4f7f\u7528 <code>collect<\/code>\/<code>steer<\/code>\u3002<br \/>\n\u53d1\u9001 <code>\/queue collect<\/code> \u4f5c\u4e3a\u72ec\u7acb\u547d\u4ee4\uff08\u6309\u4f1a\u8bdd\uff09\u6216\u8bbe\u7f6e <code>messages.queue.byChannel.discord: \"collect\"<\/code>\u3002<\/p>\n<p>\u9ed8\u8ba4\u503c\uff08\u914d\u7f6e\u4e2d\u672a\u8bbe\u7f6e\u65f6\uff09\uff1a<\/p>\n<ul>\n<li>\u6240\u6709\u754c\u9762 \u2192 <code>collect<\/code><\/li>\n<\/ul>\n<p>\u901a\u8fc7 <code>messages.queue<\/code> \u5168\u5c40\u6216\u6309\u6e20\u9053\u914d\u7f6e\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n{<br \/>\n  messages: {<br \/>\n    queue: {<br \/>\n      mode: \"collect\",<br \/>\n      debounceMs: 1000,<br \/>\n      cap: 20,<br \/>\n      drop: \"summarize\",<br \/>\n      byChannel: { discord: \"collect\" },<br \/>\n    },<br \/>\n  },<br \/>\n}<\/code><\/p>\n<h2>\u961f\u5217\u9009\u9879<\/h2>\n<p>\u9009\u9879\u9002\u7528\u4e8e <code>followup<\/code>\u3001<code>collect<\/code> \u548c <code>steer-backlog<\/code>\uff08\u4ee5\u53ca\u5f53 <code>steer<\/code> \u56de\u9000\u5230 followup \u65f6\uff09\uff1a<\/p>\n<ul>\n<li><code>debounceMs<\/code>\uff1a\u5728\u5f00\u59cb\u540e\u7eed\u8f6e\u6b21\u524d\u7b49\u5f85\u9759\u9ed8\uff08\u9632\u6b62&#8221;\u7ee7\u7eed\uff0c\u7ee7\u7eed&#8221;\uff09\u3002<\/li>\n<li><code>cap<\/code>\uff1a\u6bcf\u4e2a\u4f1a\u8bdd\u7684\u6700\u5927\u6392\u961f\u6d88\u606f\u6570\u3002<\/li>\n<li><code>drop<\/code>\uff1a\u6ea2\u51fa\u7b56\u7565\uff08<code>old<\/code>\u3001<code>new<\/code>\u3001<code>summarize<\/code>\uff09\u3002<\/li>\n<\/ul>\n<p>summarize \u4fdd\u7559\u88ab\u4e22\u5f03\u6d88\u606f\u7684\u7b80\u77ed\u8981\u70b9\u5217\u8868\uff0c\u5e76\u5c06\u5176\u4f5c\u4e3a\u5408\u6210\u7684\u540e\u7eed\u63d0\u793a\u6ce8\u5165\u3002<br \/>\n\u9ed8\u8ba4\u503c\uff1a<code>debounceMs: 1000<\/code>\u3001<code>cap: 20<\/code>\u3001<code>drop: summarize<\/code>\u3002<\/p>\n<h2>\u6309\u4f1a\u8bdd\u8986\u76d6<\/h2>\n<ul>\n<li>\u53d1\u9001 <code>\/queue &lt;mode&gt;<\/code> \u4f5c\u4e3a\u72ec\u7acb\u547d\u4ee4\uff0c\u4e3a\u5f53\u524d\u4f1a\u8bdd\u5b58\u50a8\u8be5\u6a21\u5f0f\u3002<\/li>\n<li>\u9009\u9879\u53ef\u4ee5\u7ec4\u5408\uff1a<code>\/queue collect debounce:2s cap:25 drop:summarize<\/code><\/li>\n<li><code>\/queue default<\/code> \u6216 <code>\/queue reset<\/code> \u6e05\u9664\u4f1a\u8bdd\u8986\u76d6\u3002<\/li>\n<\/ul>\n<h2>\u8303\u56f4\u548c\u4fdd\u8bc1<\/h2>\n<ul>\n<li>\u9002\u7528\u4e8e\u6240\u6709\u4f7f\u7528 Gateway \u7f51\u5173\u56de\u590d\u7ba1\u9053\u7684\u5165\u7ad9\u6e20\u9053\u7684\u81ea\u52a8\u56de\u590d\u667a\u80fd\u4f53\u8fd0\u884c\uff08WhatsApp \u7f51\u9875\u7248\u3001Telegram\u3001Slack\u3001Discord\u3001Signal\u3001iMessage\u3001\u7f51\u9875\u804a\u5929\u7b49\uff09\u3002<\/li>\n<li>\u9ed8\u8ba4\u901a\u9053\uff08<code>main<\/code>\uff09\u5bf9\u5165\u7ad9 + \u4e3b\u5fc3\u8df3\u662f\u8fdb\u7a0b\u8303\u56f4\u7684\uff1b\u8bbe\u7f6e <code>agents.defaults.maxConcurrent<\/code> \u4ee5\u5141\u8bb8\u591a\u4e2a\u4f1a\u8bdd\u5e76\u884c\u3002<\/li>\n<li>\u53ef\u80fd\u5b58\u5728\u989d\u5916\u7684\u901a\u9053\uff08\u4f8b\u5982 <code>cron<\/code>\u3001<code>subagent<\/code>\uff09\uff0c\u4ee5\u4fbf\u540e\u53f0\u4efb\u52a1\u53ef\u4ee5\u5e76\u884c\u8fd0\u884c\u800c\u4e0d\u963b\u585e\u5165\u7ad9\u56de\u590d\u3002<\/li>\n<li>\u6309\u4f1a\u8bdd\u901a\u9053\u4fdd\u8bc1\u4e00\u6b21\u53ea\u6709\u4e00\u4e2a\u667a\u80fd\u4f53\u8fd0\u884c\u89e6\u53ca\u7ed9\u5b9a\u4f1a\u8bdd\u3002<\/li>\n<li>\u65e0\u5916\u90e8\u4f9d\u8d56\u6216\u540e\u53f0\u5de5\u4f5c\u7ebf\u7a0b\uff1b\u7eaf TypeScript + promises\u3002<\/li>\n<\/ul>\n<h2>\u6545\u969c\u6392\u9664<\/h2>\n<ul>\n<li>\u5982\u679c\u547d\u4ee4\u4f3c\u4e4e\u5361\u4f4f\uff0c\u542f\u7528\u8be6\u7ec6\u65e5\u5fd7\u5e76\u67e5\u627e&#8221;queued for \u2026ms&#8221;\u884c\u4ee5\u786e\u8ba4\u961f\u5217\u6b63\u5728\u6392\u7a7a\u3002<\/li>\n<li>\u5982\u679c\u4f60\u9700\u8981\u67e5\u770b\u961f\u5217\u6df1\u5ea6\uff0c\u542f\u7528\u8be6\u7ec6\u65e5\u5fd7\u5e76\u89c2\u5bdf\u961f\u5217\u8ba1\u65f6\u884c\u3002<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>\u547d\u4ee4\u961f\u5217 \u547d\u4ee4\u961f\u5217\uff082026-01-16\uff09 \u6211\u4eec\u901a\u8fc7\u4e00\u4e2a\u5c0f\u578b\u8fdb\u7a0b\u5185\u961f\u5217\u5e8f\u5217\u5316\u5165\u7ad9\u81ea\u52a8\u56de\u590d\u8fd0\u884c\uff08\u6240\u6709\u6e20\u9053\uff09\uff0c\u4ee5\u9632 [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-101","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/101","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=101"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/101\/revisions"}],"predecessor-version":[{"id":396,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/101\/revisions\/396"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=101"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=101"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=101"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}