Codewhale 文档

查找准确的使用说明。

从新手指引和安装开始,或者直接查找产品名词、模式、权限、工具、提供商、Fleet、钩子、MCP 与运行时 API。这些页面就是正式的产品文档;每页都链接仓库中的源文档,方便查阅完整细节。

产品名词

这些名词在全站、TUI 和收据里含义完全一致。名词本身不翻译;每条定义都与仓库中的公共事实矩阵逐字对应。

执行名词

Fleet = 谁来做工作

谁来做工作:配置好的 worker、角色、模型、主机和信任边界。

Workflow = 工作按什么顺序进行

工作按什么顺序进行:阶段、门禁、预算、回放和汇总。

Lane = 一个正在运行的 Workflow 实例

一个正在运行的 Workflow 实例及其实时进度。

Runtime = Lane 在哪里、如何执行

Lane 在哪里、如何执行:本地或远程进程、提供商路由、沙箱和 API 边界。

模式与权限姿态

模式(Tab 循环,输入框空闲时)决定可见的交互方式;权限姿态(Shift+Tab 循环)决定工具执行前询问的激进程度。两者正交。

Plan

设计优先且始终只读:调查工具可用,shell 与补丁执行保持关闭。

Act

新会话的默认工作模式:多步骤工具调用,每次 shell 调用都有审批提示把关。

Operate

在与 Act 相同的权限姿态、沙箱和安全规则下进行多任务调度;真正的多步骤工作默认派发给后台 worker。

Ask

默认值:当一个未决选择会实质改变权限、成本、范围或结果时,Codewhale 会询问。

Auto-Review

完全自主:从不弹出用户提问;把歧义消解为安全可逆的解释,或明确报告无法安全继续。

Full Access

普通工具调用不再显示审批提示;不可绕过的安全、仓库法则和托管策略拦截仍然会失败关闭。

路由身份:provider · 模型 · 请求→实际思考档位 · 来源

Provider

谁提供推理——托管 API、网关或本机回环本地运行时(Ollama、vLLM、SGLang)。绝不会根据模型名称推断已配置的 provider。

Model

该提供商上的具体模型。Codewhale 把模型当作可选组件;任何提供商或模型都不享有特权。

Requested reasoning

为冻结路由请求的策略:inherit、off、low、medium、high、max 或 auto。Auto 允许自适应思考,但绝不允许静默切换 provider 或模型。

Effective reasoning

运行时或 provider 能够确认时,显示该次运行实际采用的档位;无法确认时标为暂不可用,绝不从请求值复制或臆造。

Routing source

说明为何选择这条已配置路由,例如显式成员档案或继承的会话设置。缺失的来源保持暂不可用,绝不猜测。

咨询角色

Consultant

面向用户的只读 Fleet 咨询角色。历史拼写 oracle 与 advisor 仅作为已保存配置和回放的兼容别名保留;新的产品界面统一使用 Consultant。

测量原则

  • 当提供商上报时,token 与缓存用量会在本地显示;未知用量保持未知,绝不显示为零。
  • 成本、进度、能力和交付状态仅在有来源能够确认时显示。暂不可用的值保持暂不可用,绝不会变成零或成功。
  • 本站不发布基准排行榜。Codewhale 今后发布任何数字时,都必须同时给出确切的提供商、模型、请求与实际思考档位和测量工具链。

暂不可用 基准排行榜:本站没有,也不会在没有路由身份与测量工具链的情况下出现。

来源文档:docs/FLEET.md, docs/MODES.md, docs/public-surface-facts.json · 名词文案来自 web/lib/content/vocabulary.ts;更新时请同步修改 docs-map.ts。