企业官网建设流程全解析

WorkBuddy Manager 是腾讯 CodeBuddy 的账号池管理控制台，内置 OpenAI 兼容反代网关，支持扫码批量纳管账号、定时签到保活、密钥分发与用量统计。它的「高级设置」藏在设置 → 上游配置页面里，涵盖并发、熔断、系统提示词等关键参数。这篇文章用白话把每个参数讲清楚，帮你把账号池调得更稳、更省积分。

一、先进入设置页：参数都藏在这里

登录后点左侧「设置 → 上游配置」，就能看到全部高级参数。页面采用可视化表单，每个参数都带中文名称、白话说明和安全取值范围，输入时即时校验（时刻必须 0-23、时长必须写成30s / 10m / 2h这类格式），非法值直接拒绝，不会写坏配置。

每个分组右下角有独立的「保存」按钮，且只提交你改动过的项，不会误覆盖其他配置；读取失败时页面会明确提示原因并锁定保存，杜绝空配置覆盖真实文件。

想直接改原始 JSON？点开页面底部的「高级设置」即可（冷门参数仍可在这里编辑）。表单字段的完整定义见 web/app/(main)/settings/layout.tsx/settings/layout.tsx#L210-L550)，各功能分组说明见 docs/features.md。

二、并发参数：一个账号同时接几个请求 🚀

并发参数决定了账号池的吞吐能力，位于「并发与熔断」分组（源码定义见 layout.tsx/settings/layout.tsx#L324-L414)）：

调参建议：账号少、流量大时可以把max_in_flight从 3 提到 5~8；账号多时保持默认反而更稳，因为限流一触发，整个号就会进冷却，得不偿失。

三、熔断与限流冷却：账号“拖后腿”时自动保护 🛡️

池子里总有账号状态不好，WorkBuddy Manager 用两套机制自动隔离它们：

1. 熔断（连续失败保护）

• breaker_threshold（默认 3 次）：某账号连续失败多少次后，自动暂停使用它一段时间
• breaker_cooldown（默认30m）：被熔断的账号先等多久再回来
• breaker_cooldown_max（默认6h）：反复熔断会指数退避延长冷却，这是封顶值

白话：一个号连续 3 次请求失败，就让它歇 30 分钟；如果它歇完又连续挂，下次直接歇更久，最多 6 小时——避免把流量反复砸向一个坏号。

2. 限流冷却（被腾讯限流后）

• soft_rate（默认600s）：被腾讯限流后，账号冷却多久。数值越大越保守
• soft_rate_max（默认2h）：连续触发限流会逐次延长冷却，这是延长后的封顶值

这两项在「限流与冷却」分组（layout.tsx/settings/layout.tsx#L307-L322)）。账号页上被冷却的账号会明确标出「冷却中」，配合「最后续期」时间判断状态（docs/images 里的状态列）：

四、系统提示词：三种模式怎么选 💬

系统提示词（prompt分组，见 layout.tsx/settings/layout.tsx#L450-L476)）控制网关如何对待客户端发来的system / developer消息：

另一个字段是file（自定义提示词文件）：仅custom与append模式生效，留空使用内置默认提示词。注意：路径必须真实存在于上游容器内且可读，写错会导致上游启动失败、反代不可用——不确定就留空。

页面里这两个字段都带显式风险警示（上图设置页中黄色的提示条），新手保持默认passthrough即可，行为最可预期。

五、省钱与体验类参数 📊

同属「并发与熔断」分组，但值得单独说：

• idle_weight_per_hour（闲置补偿/小时，默认 0.5）：账号每闲置 1 小时增加一点调度权重，让久未使用的账号优先被选中，避免流量总打在同一个号上
• idle_weight_max（闲置补偿上限，默认 5）：闲置加成的封顶值，防止某个号权重无限膨胀
• expiring_soon（快过期积分窗口，默认168h）：到期时间落在此窗口内的积分会被标记为「快过期」，选号时优先消耗，避免积分白白过期。留空或填 0 = 关闭该优化
• cost_explore_interval（成本档位探索周期，默认30m）：长时间只用高成本档位时，每隔这么久改走一次低成本档位探测，成功就留在低档（省钱）。填 0 可关闭

「会话粘性」分组（layout.tsx/settings/layout.tsx#L426-L448)）控制多轮对话路由：开启后同一会话的连续请求尽量落在同一账号，上下文更连贯；ttl（会话保持时长，默认30m）和gc_interval（清理周期，默认5m）按需微调即可。

六、改完如何确认生效 ✅

保存上游配置后，面板会自动重载上游容器使配置生效（页面上有「正在应用配置」的提示条）；如果当前环境无法操作 docker（如容器未挂载 docker.sock），页面会如实告诉你需在宿主机手动重启，而不是让你以为改完就生效。

改完可以看两个地方验证：

1. 仪表盘的「反代上游」卡片：健康账号 / 冷却中 / 粘性会话数实时变化
2. 用量统计页：请求数、Token 消耗与错误率按时间、模型、密钥维度统计（docs/features.md 有完整说明）

签到的账号如果反复失败，「任务记录」页会留痕（每轮签到有汇总行，失败会明确标红），配合熔断参数一起看，很容易定位是哪个号在拖后腿：

七、相关文档与源码速查 📚

一句话总结：新手全部保持默认即可；账号多、流量大时优先动「单账号最大并发」，发现某号频繁冷却再收紧「熔断冷却」，想省积分就打开「快过期积分窗口」——改完到用量统计页看一眼错误率，参数调优就完成闭环了。