ai_co_discuss 0.2.17 → 0.2.18

package/backend/server.py

@@ -1442,7 +1442,7 @@ class DiscussionHandler(BaseHTTPRequestHandler):
         """Forward authenticated browser requests to the shared Node entrypoint and pin their website."""
         site = self.local_request_site(method)
         route = parts[2:]
-        if method == "OPTIONS" and route in (["settings"], ["launch"], ["room-models"], ["room-member"], ["models"], ["api-key"], ["pick-directory"]):
+        if method == "OPTIONS" and route in (["settings"], ["launch"], ["room-models"], ["room-member"], ["models"], ["api-key"], ["api-check"], ["pick-directory"]):
             return self.respond({"ok": True})
         if route == ["settings"] and method in ("GET", "POST"):
             command = "settings"
@@ -1456,6 +1456,8 @@ class DiscussionHandler(BaseHTTPRequestHandler):
             command = "models"
         elif route == ["api-key"] and method == "POST":
             command = "api-key"
+        elif route == ["api-check"] and method == "POST":
+            command = "api-check"
         elif route == ["room-member"] and method == "POST":
             command = "room-member"
         elif route == ["pick-directory"] and method == "POST":

package/docs/runner.md

@@ -21,7 +21,9 @@
 
 自定义地址保留完整路径前缀，填写到协议根路径，例如 [OpenRouter](https://openrouter.ai/docs/api_reference/overview) 的 `https://openrouter.ai/api/v1`，选择 Chat Completions 并填写其返回的 `provider/model` ID。程序分别追加 `/responses`、`/chat/completions`、`/messages` 或 `/models/{model}:generateContent`；不改写模型 ID 中的点号、横线或斜线，不按房间身份强制套用官方协议或思考参数。实现参考 [Cherry Studio 的供应商解析说明（固定版本）](https://github.com/CherryHQ/cherry-studio/blob/843a297fe73e9f527c8eb8291c0e1335f2279c04/docs/references/ai/provider-resolution.md) 对供应商、协议、Base URL 与 API 模型 ID 的拆分方式；协议转换独立实现，不引入其代码或 SDK。
 
-`POST /api/local/api-key`（CLI 为 `codiscuss launch api-key --file FILE`）接收 `{base_url, api_key}`，仅向本机服务目录的 `api-keys/UUID.json` 写入，返回 `{api_key_ref}`。文件依赖本机用户目录权限保护，不作加密保险库；不要共享此目录。Base URL 改动后必须重新填写该地址对应的 Key。`launch settings` 读取结果附带 `api_keys`（`{Base URL: api_key_ref}`，同一地址取最近保存的一份，不含密钥），新建表单与改 Base URL 时自动带出该地址已保存的 Key，无需重复填写。网页密钥输入框不设保存按钮，失焦或回车即保存，可切换明文显示；输入仅在组件内存保留至保存成功，不进入控制器快照、localStorage、启动待办、房间数据或上游错误日志。
+`POST /api/local/api-key`（CLI 为 `codiscuss launch api-key --file FILE`）接收 `{base_url, api_key}`，仅向本机服务目录的 `api-keys/UUID.json` 写入，返回 `{api_key_ref}`。文件依赖本机用户目录权限保护，不作加密保险库；不要共享此目录。Base URL 改动后必须重新填写该地址对应的 Key。`launch settings` 读取结果附带 `api_keys`（`{Base URL: api_key_ref}`，同一地址取最近保存的一份，不含密钥），新建表单与改 Base URL 时自动带出该地址已保存的 Key，无需重复填写。网页密钥输入框不设保存按钮，失焦或回车即保存，可切换明文显示；它是用 CSS 遮挡的文本框，避免浏览器提示生成或保存密码。输入仅在组件内存保留至保存成功，保存后清空输入框，只在占位文字显示末四位以示确认；密钥不进入控制器快照、localStorage、启动待办、房间数据或上游错误日志。
+
+`POST /api/local/api-check`（CLI 为 `codiscuss launch api-check --file FILE`）接收 API profile，用该 profile 带一个空工具向模型发送一次极短请求（30 秒超时），一并核对地址、密钥、协议、模型与工具调用支持，成功返回 `{ok:true}`，失败只报 HTTP 状态。会产生一次极小的模型调用费用。网页 API 卡片背面的闪电按钮调用此入口。
 
 启动配置中的 API profile 为 `{adapter:"api", base_url, api_protocol, api_key_ref, model}`；`api_protocol` 为 `responses/chat/anthropic/gemini`。启动器在私有房间配置保存 `api_home`，供服务解析密钥引用。API 不需要 executable、项目目录、会话 ID 或技能安装；API 会话编号是本机参与者绑定，不是厂商的聊天 ID。模型列表入口仍为 `launch models` / `/api/local/models`，传入此 profile，只返回模型元数据。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai_co_discuss",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "bin": {
     "codiscuss": "runner/codiscuss.mjs"
   },

package/runner/discussion_api.mjs

@@ -14,6 +14,8 @@ export const API_PROVIDERS = {
 const PROTOCOLS = ['responses', 'chat', 'anthropic', 'gemini'];
 const REQUEST_TIMEOUT_MS = 180_000;
 const MAX_OUTPUT_TOKENS = 8192;
+const CHECK_TIMEOUT_MS = 30_000;
+const CHECK_TOOL = { name: 'noop', description: '连通性检查，无需调用', parameters: { type: 'object', properties: {} } };
 
 /** Validate an explicit API root, keeping custom gateway paths intact. */
 export function api_base_url(value) {
@@ -112,6 +114,14 @@ export async function api_models(home, profile) {
   return { adapter: 'api', models, error: '', source: 'api' };
 }
 
+/** Send one tiny tool-enabled request so address, key, protocol and model are checked together. */
+export async function api_check(home, profile) {
+  const key = read_api_key(home, profile);
+  const context = { system: '这是连通性检查。', history: api_history(profile, '只回复 OK。'), tools: [CHECK_TOOL] };
+  await api_generate(profile, key, context, AbortSignal.timeout(CHECK_TIMEOUT_MS));
+  return { ok: true };
+}
+
 /** Start protocol-specific history with a user request. */
 export function api_history(profile, prompt) {
   return profile.api_protocol === 'gemini' ? [{ role: 'user', parts: [{ text: prompt }] }] : [{ role: 'user', content: prompt }];

package/runner/discussion_launch.mjs

@@ -10,7 +10,7 @@ import { parseArgs } from 'node:util';
 
 import { atomic_json } from './discussion_adapters.mjs';
 import { software_models } from './discussion_models.mjs';
-import { API_PROVIDERS, api_models, save_api_key, saved_api_keys, validate_api_profile } from './discussion_api.mjs';
+import { API_PROVIDERS, api_check, api_models, save_api_key, saved_api_keys, validate_api_profile } from './discussion_api.mjs';
 import { acquire_lock, api, CODEX_ADAPTERS, DiscussionStore, service_drafts, task_files, validate_config } from './discussion_runner.mjs';
 import { assert_shared_home, CONNECTION_FIELDS, configuration_snapshot, read_registry, registered_identity, register_room, service_home, service_pid, start_service } from './discussion_service.mjs';
 
@@ -44,6 +44,7 @@ const HELP = `用法：codiscuss launch settings [--file FILE]
       codiscuss launch room-models --file FILE
       codiscuss launch models --file FILE
       codiscuss launch api-key --file FILE
+      codiscuss launch api-check --file FILE
       codiscuss launch room-member --file FILE
       codiscuss launch pick-directory
 
@@ -53,6 +54,7 @@ room-config 修正已暂停房间的软件路径或切换 Codex App / CLI，不
 room-models 只读指定 site、room_id 的本机登记模型与思考强度，不启动讨论。
 models 按 adapter、executable 或 API profile 读取模型目录，不启动讨论或生成回答。
 api-key 将 base_url、api_key 保存于本机私有目录，只返回 api_key_ref。
+api-check 用 API profile 向模型发送一次极短请求，核对地址、密钥、协议与模型是否可用。
 pick-directory 在本机弹出系统目录选择窗口，返回所选路径；取消时不返回路径。
 room-member 为运行中的自由房间或讨论邀请、请回一位成员（讨论只接受本机唤醒的成员）；须提供 site、room_id、token、action（add/rejoin）、name。
 JSON 指定 site、entry（conversation/web）、room（建房内容，含 submission_id）
@@ -705,6 +707,7 @@ export async function launch_main(args = process.argv.slice(2), input_text) {
   if (positionals[0] === 'settings') result = { ...(input ? save_launch_settings(home, input) : launch_settings(home)), api_providers: API_PROVIDERS,
     api_keys: saved_api_keys(home) };
   else if (positionals[0] === 'api-key' && input) result = save_api_key(home, input);
+  else if (positionals[0] === 'api-check' && input) result = await api_check(home, input);
   else if (positionals[0] === 'room-models' && input) result = room_models(home, input);
   else if (positionals[0] === 'models' && input?.adapter === 'api') result = await api_models(home, input);
   else if (positionals[0] === 'models' && input) {

package/web/app.js

@@ -1437,8 +1437,8 @@ async function local_launch_request(action, payload) {
     response = await fetch(`${local_connection?.endpoint || ""}/api/local/${action}`, {
       method: payload === undefined ? "GET" : "POST", headers, credentials: "omit", redirect: "error",
       body: payload === undefined ? undefined : JSON.stringify(payload),
-      ...(payload === undefined || ["room-models", "models"].includes(action)
-        ? { signal: AbortSignal.timeout(action === "models" ? MODEL_CATALOG_TIMEOUT_MS : LOCAL_CONNECTION_TIMEOUT_MS) } : {}) });
+      ...(payload === undefined || ["room-models", "models", "api-check"].includes(action)
+        ? { signal: AbortSignal.timeout(["models", "api-check"].includes(action) ? MODEL_CATALOG_TIMEOUT_MS : LOCAL_CONNECTION_TIMEOUT_MS) } : {}) });
   } catch (error) {
     if (!local_connection) throw error;
     throw new Error("无法连接本机服务：请在这台电脑运行 codiscuss local open，并允许浏览器访问本机网络，再重试原请求");
@@ -1623,6 +1623,12 @@ async function save_launch_api_key(name, api_key) {
   publish_view();
 }
 
+/** Ask the local service to send one tiny request with the current API profile; throws its reason on failure. */
+async function check_launch_api(name) {
+  const { base_url, api_protocol, model, api_key_ref } = state.launch.profiles[name] || {};
+  await local_launch_request("api-check", { adapter: "api", base_url, api_protocol, model, api_key_ref });
+}
+
 /** Provide selectable software results without turning an unavailable list into a text field. */
 function launch_model_state(name, launch = state.launch) {
   const profile = launch.profiles[name] || {};
@@ -2983,7 +2989,7 @@ function change_view_theme(theme) {
 
 window.discuss_view = { snapshot: view_snapshot, write_field: write_view_field,
   write_launch: write_launch_field, write_room_connection, write_room_adapter, launch_clients: LAUNCH_CLIENTS,
-  launch_model_state, load_launch_models, write_launch_model, save_launch_api_key, launch_summary, launch_can_set_access, launch_can_bind_session, pick_launch_directory, restore_launch_profile, reset_create_form, empty_discussion_message,
+  launch_model_state, load_launch_models, write_launch_model, save_launch_api_key, check_launch_api, launch_summary, launch_can_set_access, launch_can_bind_session, pick_launch_directory, restore_launch_profile, reset_create_form, empty_discussion_message,
   start_drag: start_directory_drag,
   attachment_markup, attachment_size, attachment_file_icon, drop_attachments, paste_attachments,
   write_expert: write_view_expert, add_instance: add_view_instance, platform_of, execute: execute_view_action, theme: change_view_theme,