{"record":{"id":"607ac10605de7cdf","repo":"BigPizzaV3/CodexPlusPlus","slug":"api-external","errorCode":null,"errorMessage":"请填写 API 的模型名称","messagePattern":"请填写 API 的模型名称","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"tools/conversation-canvas/external-api.mjs","lineNumber":15,"sourceCode":"// OpenAI-compatible Chat Completions. Never persist credentials in tree checkpoints.\nexport function apiEndpoint(raw){\n  let url;try{url=new URL(String(raw).trim());}catch{throw Error('请输入完整的 HTTPS API 地址');}\n  if(url.protocol!=='https:'||url.username||url.password||url.search||url.hash)throw Error('API 地址须使用 HTTPS，且不含账号、密码、查询参数或片段');\n  const path=url.pathname.replace(/\\/+$/,'');\n  url.pathname=path.endsWith('/chat/completions')?path:(path||'/v1')+'/chat/completions';\n  return url.href;\n}\n\nexport function apiConfig(input){\n  const channel=input?.channel==='external'?'external':'native';\n  const value={channel,baseUrl:String(input?.baseUrl||'').trim(),model:String(input?.model||'').trim(),key:String(input?.key||'').trim(),remember:input?.remember===true,speed:input?.speed==='provider'?'provider':'fast',revision:input?.revision||crypto.randomUUID()};\n  if(channel==='external'){\n    value.endpoint=apiEndpoint(value.baseUrl);\n    if(!value.model||value.model.length>200)throw Error('请填写 API 的模型名称');\n    if(!value.key||/[\\r\\n]/.test(value.key))throw Error('请在设置中填写有效 API Key');\n  }\n  return value;\n}\n\nexport function storedApiConfig(config){\n  const {channel,baseUrl,model,remember,speed,revision}=config;\n  return {channel,baseUrl,model,remember,speed,revision,...remember?{key:config.key}:{}};\n}\n\nexport function apiError(error){\n  if(error?.name==='AbortError')return error;\n  if(error?.canvasApiLocal===true)return error;\n  const code=Number(error?.status??error?.responseStatus);\n  const hint={401:'密钥无效或已过期',403:'接口拒绝访问，请检查权限',404:'地址或模型不存在',408:'接口请求超时',413:'本批资料超过接口大小限制',429:'接口限流或额度不足'}[code];\n  // Provider messages can echo request contents and Authorization; never display them.\n  return Object.assign(Error(hint?`API ${code}：${hint}`:code>=400?`API 请求失败（HTTP ${code}），请检查服务状态`:'API 连接失败，请检查地址、网络及服务状态'),{retryable:!code||code===408||code===429||code>=500});\n}","sourceCodeStart":1,"sourceCodeEnd":33,"githubUrl":"https://github.com/BigPizzaV3/CodexPlusPlus/blob/b1ed92e5e4a2d74095d4b8db5af43cef7acba9c6/tools/conversation-canvas/external-api.mjs#L1-L33","documentation":"For the external channel, apiConfig() requires a non-empty model name of at most 200 characters after trimming. The model name is sent to the OpenAI-compatible Chat Completions endpoint and cannot be inferred. This error means the model field was empty or exceeded 200 chars.","triggerScenarios":"apiConfig({channel:'external',baseUrl:'https://api.example.com/v1',model:''}) or model length > 200; also thrown via readApiForm/config callers when the settings form was saved with a blank model.","commonSituations":"User picks 'external API' channel but forgets to fill the model dropdown/text; model name truncated by paste; user copies a base URL but not the model; migration restored a config without a model field.","solutions":["Fill in the exact model identifier the provider expects, e.g. 'gpt-4o' or 'deepseek-chat'","Check the provider's models endpoint (/v1/models) for the exact spelling","Ensure the saved config object actually contains a non-empty model string before calling apiConfig","Shorten the model string if it exceeded 200 characters (it should never be that long)"],"exampleFix":"// before\napiConfig({channel:'external',baseUrl:'https://api.example.com/v1',model:''})\n// after\napiConfig({channel:'external',baseUrl:'https://api.example.com/v1',model:'gpt-4o',key:'sk-...'})","handlingStrategy":"validation","validationCode":"const model = String(input?.model || '').trim();\nif (!model) throw new Error('请填写 API 的模型名称');\nif (model.length > 200) throw new Error('model name too long');","typeGuard":"function hasModel(c) { return typeof c?.model === 'string' && c.model.trim().length > 0 && c.model.trim().length <= 200; }","tryCatchPattern":"let cfg;\ntry { cfg = apiConfig(formValues); } catch (e) { if (String(e).includes('模型名称')) focusModelField(); return; }","preventionTips":["Make the model field required in the settings form UI","Populate a model dropdown from GET /v1/models when the provider supports it","Persist the model along with baseUrl so partial restores don't drop it","Validate the whole external-channel config as a unit before saving"],"tags":["config","validation","api-model"],"backgroundTag":"empty-required-field","analyzedSha":"b1ed92e5e4a2d74095d4b8db5af43cef7acba9c6","analyzedAt":"2026-09-19T23:35:21.129Z","contentChangedAt":"2026-09-19T23:35:21.129Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}