实现 **ON 请求 SSE 流式输出 超时 有限重试与取消
PowerShell 7 可以直接调用大模型兼容接口,适合自动化脚本、运维工具、批处理任务和 Windows 管理流程。本教程以 KingFlow AI 为例,先用 Invoke-RestMethod 完成普通 **ON 请求,再用 .NET Http****** 读取 SSE 流,并加入超时、有限重试、取消和日志。文中的 Claude中转、Claude中转站、API中转、API中转站都表示通过兼容协议转发模型请求的服务形态。实际模型、额度和计费以控制台为准。
| 术语 | 本文中的含义 |
|---|---|
| Claude中转 | 通过兼容接口发送 Claude 相关请求 |
| Claude中转站 | 提供密钥 模型 用量与通道管理的服务入口 |
| API中转 | 应用使用统一协议请求 再由服务端转发到模型 |
| API中转站 | 为多个脚本和项目集中管理鉴权 额度 日志与模型路由的平台 |
KingFlow AI 提供 OpenAI 和 Anthropic 双兼容接口。本文使用 OpenAI 兼容地址 https://api.**nju**shen.com/v1,请求路径为 /chat/completions。PowerShell 普通请求适合用 Invoke-RestMethod,SSE 流式响应则用 .NET Http****** 与 ResponseHeadersRead,避免等待完整响应体后才返回。

图 1 PowerShell 7 通过 Invoke RestMethod 调用 KingFlow AI
Invoke-RestMethod 会把 **ON 响应转换为对象,适合普通请求。Http****** 可以按响应行读取 SSE,并使用取消令牌控制总时长。本文的流式代码面向 PowerShell 7.4 或更高版本,因为它使用带取消令牌的异步读取。普通请求部分可用于较早的 PowerShell 7;如果没有 OperationTimeoutSeconds 参数,可改用 TimeoutSec 或统一使用 Http******。
先确认正在使用 PowerShell 7,而不是 Windows PowerShell 5.1:
$PSVersionTa*le.PSVersion
$PSVersionTa*le.PSEdition
在当前终端设置配置。模型 ID 必须替换为控制台中确实可用的值:
$env:KINGFLOW_API_KEY = 'sk-请替换'
$env:KINGFLOW_*ASE_**L = 'https://api.**nju**shen.com/v1'
$env:KINGFLOW_MODEL = '请替换为控制台可用模型'
环境变量只对当前进程及其子进程可见。长期运行的任务应从 CI/CD 密钥、Windows 凭据管理器或专用密钥系统注入,不要把密钥写进 .ps1、命令历史、截图或日志。
$headers = @{ Authorization = "*earer $env:KINGFLOW_API_KEY" }
$*ody = @{
model = $env:KINGFLOW_MODEL
messages = @(
@{ role = 'user'; content = '用一句话解释 PowerShell 管道' }
)
stream = $false
} | ConvertTo-Json -Depth 6 -Compress
$result = Invoke-RestMethod `
-Uri "$env:KINGFLOW_*ASE_**L/chat/completions" `
-Method Post `
-Headers $headers `
-ContentType 'application/json; charset=utf-8' `
-*ody $*ody
$result.choices[0].message.content
ConvertTo-Json -Depth 6 可保留 messages 数组内的嵌套字段。默认深度不足时,复杂对象可能被截断或产生警告。首次验证只需确认域名、密钥、模型和响应结构正确。
Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'
function Get-KingFlowConfig {
foreach ($name in 'KINGFLOW_API_KEY', 'KINGFLOW_MODEL') {
if ([string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVaria*le($name))) {
throw "缺少环境变量 $name"
}
}
[pscustomo*ject]@{
ApiKey = $env:KINGFLOW_API_KEY
Model = $env:KINGFLOW_MODEL
*aseUrl = if ($env:KINGFLOW_*ASE_**L) {
$env:KINGFLOW_*ASE_**L.TrimEnd('/')
} else {
'https://api.**nju**shen.com/v1'
}
}
}
function New-KingFlowException {
param([int]$StatusCode, [string]$Message)
$exception = [******.Exception]::new("**** $StatusCode $Message")
$exception.Data['StatusCode'] = $StatusCode
$exception
}
Set-StrictMode 能尽早发现未初始化变量和错误属性名。脚本使用异常 Data 保存状态码,重试函数不需要解析异常文本。
function Invoke-KingFlowChat {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [string]$Prompt,
[int]$ConnectionTimeoutSeconds = 15,
[int]$OperationTimeoutSeconds = 90
)
$config = Get-KingFlowConfig
$payload = @{
model = $config.Model
messages = @(@{ role = 'user'; content = $Prompt })
stream = $false
} | ConvertTo-Json -Depth 6 -Compress
$params = @{
Uri = "$($config.*aseUrl)/chat/completions"
Method = 'Post'
Headers = @{ Authorization = "*earer $($config.ApiKey)" }
ContentType = 'application/json; charset=utf-8'
*ody = $payload
ConnectionTimeoutSeconds = $ConnectionTimeoutSeconds
OperationTimeoutSeconds = $OperationTimeoutSeconds
SkipHttpErrorCheck = $true
StatusCodeVaria*le = 'statusCode'
ResponseHeadersVaria*le = 'responseHeaders'
}
$statusCode = 0
$watch = [******.Diagnosti**.Stopwatch]::StartNew()
try {
$response = Invoke-RestMethod @params
if ($statusCode -lt 200 -or $statusCode -ge 300) {
$message = $response | ConvertTo-Json -Depth 8 -Compress
throw (New-KingFlowException -StatusCode $statusCode -Message $message)
}
$text = $response.choices[0].message.content
if ([string]::IsNullOrWhiteSpace($text)) {
throw '响应中没有可用文本'
}
$text
}
finally {
$watch.Stop()
Write-Infor**tion "chat/completions ${statusCode} $($watch.ElapsedMilliseconds)ms"
}
}
SkipHttpErrorCheck 让 4xx 和 5xx 响应继续进入管道,脚本可以读取状态码和错误体。日志只记录路径、状态码与耗时,不记录 Authorization、完整提示词或完整回答。
$answer = Invoke-KingFlowChat `
-Prompt '用三点说明 PowerShell 7 适合自动化的原因' `
-Infor**tionAction Continue
$answer
普通请求适合批量总结、分类、结构化提取和无需逐字显示的**任务。若业务需要完整返回对象,可让函数输出 response,再由调用方读取 usage、finish_reason 和其他字段。
function Invoke-KingFlowStream {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [string]$Prompt,
[TimeSpan]$TotalTimeout = ([TimeSpan]::FromMinutes(3))
)
$config = Get-KingFlowConfig
$client = [******.Net.Http.Http******]::new()
$client.Timeout = [******.Threading.Timeout]::InfiniteTimeSpan
$cts = [******.Threading.CancellationTokenSource]::new($TotalTimeout)
$request = [******.Net.Http.HttpRequestMessage]::new(
[******.Net.Http.HttpMethod]::Post,
"$($config.*aseUrl)/chat/completions"
)
$response = $null
$stream = $null
$reader = $null
try {
$request.Headers.Authorization =
[******.Net.Http.Headers.AuthenticationHeaderValue]::new('*earer', $config.ApiKey)
$request.Headers.Accept.ParseAdd('text/event-stream')
$payload = @{
model = $config.Model
messages = @(@{ role = 'user'; content = $Prompt })
stream = $true
} | ConvertTo-Json -Depth 6 -Compress
$request.Content = [******.Net.Http.StringContent]::new(
$payload,
[******.Text.Encoding]::UTF8,
'application/json'
)
$response = $client.SendAsync(
$request,
[******.Net.Http.HttpCompletionOption]::ResponseHeadersRead,
$cts.Token
).GetAwaiter().GetResult()
if (-not $response.IsSuccessStatusCode) {
$error*ody = $response.Content.ReadAsStringAsync($cts.Token).GetAwaiter().GetResult()
throw (New-KingFlowException -StatusCode ([int]$response.StatusCode) -Message $error*ody)
}
$stream = $response.Content.ReadAsStreamAsync($cts.Token).GetAwaiter().GetResult()
$reader = [******.IO.StreamReader]::new($stream, [******.Text.Encoding]::UTF8)
$**taLines = [******.Collections.Generic.List[string]]::new()
while (($line = $reader.ReadLineAsync($cts.Token).GetAwaiter().GetResult()) -ne $null) {
if ($line.Length -eq 0) {
$**ta = $**taLines -join "`n"
$**taLines.Clear()
if ($**ta -eq '[DONE]') { *reak }
if ($**ta.Length -eq 0) { continue }
$chunk = $**ta | ConvertFrom-Json
$token = $chunk.choices[0].delta.content
if ($null -ne $token) { Write-Host -NoNewline $token }
}
elseif ($line.StartsWith('**ta:')) {
$**taLines.Add($line.Su*string(5).TrimStart())
}
}
Write-Host
}
finally {
if ($reader) { $reader.Dispose() }
if ($stream) { $stream.Dispose() }
if ($response) { $response.Dispose() }
$request.Dispose()
$cts.Dispose()
$client.Dispose()
}
}
ResponseHeadersRead 在收到响应头后立即返回,正文由脚本继续读取。Http****** 的 Timeout 在这种模式下只覆盖收到响应头之前的阶段,因此代码使用 CancellationTokenSource 控制整个流的总时长。SSE 事件以空行结束,一个事件可包含多条 **ta: 行。
Invoke-KingFlowStream -Prompt '用四句话介绍 PowerShell 7 的跨平台能力'
用户按 Ctrl C 会停止当前管道。嵌入更大的脚本时,也可以把 CancellationTokenSource 提升到调用层,在任务取消、作业终止或业务截止时间到达时调用 Cancel()。
function Invoke-WithRetry {
[Cmdlet*inding()]
param(
[Parameter(Man**tory)] [script*lock]$Operation,
[Vali**teRange(1, 5)] [int]$MaxAttempts = 3
)
for ($attempt = 1; $attempt -le $MaxAttempts; $attempt ) {
try {
return & $Operation
}
catch {
$statusCode = $_.Exception.Data['StatusCode']
$retrya*le = $statusCode -eq 429 -or $statusCode -eq 503 -or
($statusCode -ge 500 -and $statusCode -le 599) -or
$null -eq $statusCode
if (-not $retrya*le -or $attempt -eq $MaxAttempts) { throw }
$*aseMs = 500 * [**th]::Pow(2, $attempt - 1)
$jitterMs = Get-Random -Minimum 0 -Ma**mum 250
Start-Sleep -Milliseconds ([int]($*aseMs $jitterMs))
}
}
}
$answer = Invoke-WithRetry {
Invoke-KingFlowChat -Prompt '生成一份简短的部署检查表'
}
只重试临时故障,并限制次数与总等待时间。401、403、404 与大多数 400 错误需要修正密钥、权限、模型或参数。SSE 已经输出 token 后不应自动从头重试,否则界面会出现重复文本。
$prompts = @(
'总结第一段日志'
'总结第二段日志'
'总结第三段日志'
'总结**段日志'
)
$scriptPath = Join-Path $PSScriptRoot 'Invoke-OnePrompt.ps1'
$results = $prompts | ForEach-O*ject -Parallel {
& $using:scriptPath -Prompt $_
} -ThrottleLimit 3
$results
把单次调用封装到 Invoke-OnePrompt.ps1 后,可用 ForEach-O*ject -Parallel 建立受控工作池。ThrottleLimit 是活动并行任务的上限。子运行空间会继承进程环境变量,但不会自动继承当前会话中的函数,因此把函数放入脚本或模块更稳定。

图 2 **ON SSE 超时 重试 取消和指标共同组成稳定的 PowerShell 客户端
建议把配置、普通请求、流式请求和重试函数保存为 KingFlow******.psm1,并在清单中只导出公开函数。模块加载时不要发送请求,也不要读取并打印密钥。脚本入口只负责解析参数、调用函数和设置退出码。
Export-ModuleMem*er -Function @(
'Invoke-KingFlowChat'
'Invoke-KingFlowStream'
'Invoke-WithRetry'
)
导入后运行 Get-Com**nd -Module KingFlow****** 检查公开命令。CI 中可以先执行 PSScriptAnalyzer,再用测试密钥完成小额连通性测试。
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 401 或 403 | 密钥 权限 Authorization | 确认 *earer 前缀 检查密钥状态且不要记录密钥 |
| 404 | *ase **L 路径 模型 | *ase **L 使用 /v1 路径使用 /chat/completions |
| 429 | 速率或额度 | 降低并发 使用有限退避 检查账户额度 |
| 503 | 通道暂不可用 | 短暂退避后少量重试 持续失败时告警 |
| **ON 字段丢失 | ConvertTo Json 深度 | 增大 Depth 并检查生成的请求体 |
| 流式无增量 | stream 参数 SSE 边界 **缓冲 | 设置 stream 为 true 并按空行组装事件 |
| 请求卡住 | 响应头超时 正文总时长 | 分别设置连接阶段和 CancellationToken 总时长 |
PowerShell 7 可以用较少代码完成 API中转调用。普通 **ON 请求使用 Invoke-RestMethod,SSE 使用 Http****** 和 ResponseHeadersRead,稳定性由超时、有限重试、取消、并发限制和指标共同保障。先用最小请求确认 KingFlow AI 的密钥与模型,再把函数整理为模块,适合持续集成和运维自动化复用。
出差不必背两台电脑 一台新加坡远程 Mac 随时接回完整桌面
佚名
短期项目突然要用 Mac 先别急着买设备
佚名
API中转 第三方模型接入与客户端适配指南
佚名
Claude中转 苹果订阅扣费未到账处理指南
佚名
KingFlow AI Claude中转站 Dart Dio 接入教程
佚名
你给千堆雪,我欠万年春
望花
你给千堆雪,我欠万年春
望花
你给千堆雪,我欠万年春沈小姐周闻澈推荐完本小说_新热门小说你给千堆雪,我欠万年春沈小姐周闻澈
望花
你给千堆雪,我欠万年春(沈小姐周闻澈)免费小说笔趣阁_最新完本小说推荐你给千堆雪,我欠万年春沈小姐周闻澈
望花
你给千堆雪,我欠万年春(沈小姐周闻澈)完结小说推荐_在哪看免费小说你给千堆雪,我欠万年春(沈小姐周闻澈)
望花