mingdao-harness 0.1.61 → 0.1.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "description": "MingDao Harness —— 开源智能体框架（Agent Harness）。零依赖、开箱即用，针对 DeepSeek-V4 系列优化，开放主流模型接入。",
   "type": "module",
   "bin": {

package/src/config.js

@@ -33,6 +33,26 @@ export function loadConfig() {
   }
 }
 
+/** 桌面版首次运行：无配置时自动创建最小可用配置（引导在 WebUI 内完成，
+ * 不再要求先去终端跑 mingdao init）。CLI 的 mingdao init 向导不受影响。 */
+export function ensureMinimalConfig() {
+  const existing = loadConfig();
+  if (existing) return existing;
+  ensureHome();
+  const pp = PROVIDERS['deepseek'] || Object.values(PROVIDERS)[0];
+  const model = modelPreset('deepseek-v4-flash') ? 'deepseek-v4-flash' : pp.models[0];
+  const cfg = {
+    provider: 'deepseek',
+    model,
+    baseUrl: pp.baseUrl,
+    permission: 'ask',
+    sandbox: 'off',
+    contextBudget: 128000,
+  };
+  saveConfig(cfg);
+  return cfg;
+}
+
 export function saveConfig(cfg) {
   ensureHome();
   const p = configPath();

package/src/web/index.html

@@ -666,6 +666,10 @@ async function init(){
     $('#notifyChk').checked=j.notify!==false;
     const env = ('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
+    // 首次使用引导：无 API Key 时明确提示去设置（桌面版自动初始化后必走这里）
+    if (j.keyReady === false) {
+      renderBanner({ text: '🔑 欢迎使用 MingDao Harness！还没有配置 API Key：请点击右上角 ⚙ 设置 →「模型与 API Key」选择模型并填入密钥（DeepSeek 平台申请）后即可对话。' });
+    }
   }catch(e){
     const ms=$('#modelSel'); if(!ms.options.length){ const o=document.createElement('option'); o.textContent='加载失败，刷新重试'; ms.appendChild(o); }
   }

package/src/web/server.js

@@ -463,6 +463,8 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         ok: true,
         model: modelName,
         models,
+        // 首次使用引导：当前模型无可用 API Key 时前端显示「去 ⚙ 设置填 Key」横幅
+        keyReady: Boolean((resolveProviderConfig(cfg, modelName) || {}).apiKey),
         permissions: ['ask', 'auto', 'readonly'],
         permission: cfg.permission ?? 'ask',
         sandbox: cfg.sandbox || 'off',