@geminilight/mindos 0.5.2 → 0.5.5

package/scripts/setup.js

@@ -133,6 +133,12 @@ const T = {
   mcpInstallDone: { en: (n) => `✔ ${n} agent(s) configured`, zh: (n) => `✔ 已配置 ${n} 个 Agent` },
   mcpSkipped:     { en: '  → Skipped. Run `mindos mcp install` anytime to configure agents.', zh: '  → 已跳过。随时运行 `mindos mcp install` 配置 Agent。' },
 
+  // skill install step
+  skillInstalling:  { en: (name) => `⏳ Installing Skill "${name}"...`, zh: (name) => `⏳ 正在安装 Skill "${name}"...` },
+  skillInstallOk:   { en: (name) => `  ${c.green('✔')} Skill "${name}" installed`, zh: (name) => `  ${c.green('✔')} Skill "${name}" 已安装` },
+  skillInstallFail: { en: (name, msg) => `  ${c.red('✘')} Skill "${name}" failed: ${msg}`, zh: (name, msg) => `  ${c.red('✘')} Skill "${name}" 安装失败：${msg}` },
+  skillSkipped:     { en: '  → No agents selected, skill install skipped.', zh: '  → 未选择 Agent，跳过 Skill 安装。' },
+
   // restart prompts (re-onboard with config changes)
   restartRequired:   { en: 'Config changed. Service restart required.', zh: '配置已变更，需要重启服务。' },
   restartNow:        { en: 'Restart now?', zh: '立即重启？' },
@@ -441,8 +447,13 @@ async function isSelfPort(port) {
         res.on('end', () => {
           try {
             const data = JSON.parse(body);
-            resolve(data.service === 'mindos');
-          } catch { resolve(false); }
+            // 200 with service=mindos → definitely us.
+            // 401 Unauthorized → also us (webPassword is set).
+            resolve(data.service === 'mindos' || res.statusCode === 401);
+          } catch {
+            // Non-JSON but got a response on /api/health → likely us
+            resolve(res.statusCode === 401 || res.statusCode === 200);
+          }
         });
       });
       req.on('error', () => resolve(false));
@@ -671,7 +682,7 @@ async function runMcpInstallStep(mcpPort, authToken) {
 
   if (selected.length === 0) {
     write(c.dim(t('mcpSkipped') + '\n'));
-    return;
+    return [];
   }
 
   write('\n' + c.dim(tf('mcpInstalling', selected.length) + '\n'));
@@ -705,6 +716,64 @@ async function runMcpInstallStep(mcpPort, authToken) {
   }
 
   console.log(`\n${c.green(tf('mcpInstallDone', okCount))}`);
+  return selected;
+}
+
+/* ── Skill auto-install ────────────────────────────────────────────────────── */
+
+const UNIVERSAL_AGENTS = new Set([
+  'amp', 'cline', 'codex', 'cursor', 'gemini-cli',
+  'github-copilot', 'kimi-cli', 'opencode', 'warp',
+]);
+const SKILL_UNSUPPORTED = new Set(['claude-desktop']);
+const AGENT_NAME_MAP = {
+  'claude-code': 'claude-code',
+  'windsurf': 'windsurf',
+  'trae': 'trae',
+  'openclaw': 'openclaw',
+  'codebuddy': 'codebuddy',
+};
+
+/**
+ * Install the appropriate MindOS Skill to selected agents via `npx skills add`.
+ * @param {string} template - 'en' | 'zh' | 'empty' | 'custom'
+ * @param {string[]} selectedAgents - MCP agent keys from the multi-select step
+ */
+function runSkillInstallStep(template, selectedAgents) {
+  if (!selectedAgents || selectedAgents.length === 0) {
+    write(c.dim(t('skillSkipped') + '\n'));
+    return;
+  }
+
+  const skillName = template === 'zh' ? 'mindos-zh' : 'mindos';
+  const source = resolve(ROOT, 'skills');
+
+  // Filter to non-universal, skill-capable agents
+  const additionalAgents = selectedAgents
+    .filter(key => !UNIVERSAL_AGENTS.has(key) && !SKILL_UNSUPPORTED.has(key))
+    .map(key => AGENT_NAME_MAP[key] || key);
+
+  let cmd;
+  if (additionalAgents.length > 0) {
+    cmd = `npx skills add "${source}" -s ${skillName} -a ${additionalAgents.join(',')} -g -y`;
+  } else {
+    cmd = `npx skills add "${source}" -s ${skillName} -a universal -g -y`;
+  }
+
+  write(tf('skillInstalling', skillName) + '\n');
+
+  try {
+    execSync(cmd, {
+      encoding: 'utf-8',
+      timeout: 30_000,
+      env: { ...process.env, NODE_ENV: 'production' },
+      stdio: 'pipe',
+    });
+    write(tf('skillInstallOk', skillName) + '\n');
+  } catch (err) {
+    const msg = err.stderr || err.message || 'Unknown error';
+    write(tf('skillInstallFail', skillName, msg.split('\n')[0]) + '\n');
+  }
 }
 
 // ── GUI Setup ─────────────────────────────────────────────────────────────────
@@ -739,16 +808,34 @@ async function startGuiSetup() {
   // Read or create config, set setupPending
   let config = {};
   try { config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { /* ignore */ }
+
+  const isFirstTime = !config.mindRoot;
   config.setupPending = true;
   writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
 
-  // Find a free port
-  const port = await findFreePort(3000);
-  if (config.port === undefined) {
-    config.port = port;
-    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+  // Determine which port to use for the setup wizard
+  let usePort;
+  if (isFirstTime) {
+    // First-time onboard: use a temporary port (scan from 9100) so the user's
+    // chosen port in Step 3 can differ without a mid-setup restart.
+    // 9100 is chosen to avoid conflicts with common services (5000=AirPlay, 3000/8080=dev).
+    usePort = await findFreePort(9100);
+  } else {
+    // Re-onboard: service is already running on config.port — reuse it.
+    const existingPort = config.port || 3000;
+    if (await isSelfPort(existingPort)) {
+      // Service already running — just open the setup page, no need to spawn.
+      const url = `http://localhost:${existingPort}/setup`;
+      console.log(`\n${c.green(tf('guiReady', url))}\n`);
+      const opened = openBrowser(url);
+      if (!opened) console.log(c.dim(tf('guiOpenFailed', url)));
+      process.exit(0);
+    }
+    // Service not running — start on existing port
+    usePort = await isPortInUse(existingPort)
+      ? await findFreePort(9100)  // existing port occupied by another process
+      : existingPort;
   }
-  const usePort = config.port || port;
 
   write(c.yellow(t('guiStarting') + '\n'));
 
@@ -841,6 +928,15 @@ async function main() {
 
   const { readdirSync } = await import('node:fs');
   let mindDir;
+  let selectedTemplate = 'en'; // hoisted — set by template selection or inferred from existing config
+  // Infer template from existing config's disabledSkills or UI language
+  if (resumeCfg.disabledSkills?.includes('mindos')) {
+    selectedTemplate = 'zh';
+  } else if (resumeCfg.disabledSkills?.includes('mindos-zh')) {
+    selectedTemplate = 'en';
+  } else {
+    selectedTemplate = uiLang; // fallback to UI language for first-time existing KB
+  }
 
   // Default KB path: existing mindRoot if set, otherwise ~/MindOS (same as GUI default)
   const HOME = homedir();
@@ -875,9 +971,9 @@ async function main() {
     } else {
       // ── Template selection (part of Step 1) ─────────────────────────────
       write('\n');
-      const tpl = await select('tplPrompt', 'tplOptions', 'tplValues');
+      selectedTemplate = await select('tplPrompt', 'tplOptions', 'tplValues');
       mkdirSync(mindDir, { recursive: true });
-      await applyTemplate(tpl, mindDir);
+      await applyTemplate(selectedTemplate, mindDir);
       break;
     }
   }
@@ -1000,12 +1096,13 @@ async function main() {
   }
 
   const config = {
-    mindRoot:    mindDir,
-    port:        webPort,
-    mcpPort:     mcpPort,
-    authToken:   authToken,
-    webPassword: webPassword || '',
-    startMode:   startMode,
+    mindRoot:       mindDir,
+    port:           webPort,
+    mcpPort:        mcpPort,
+    authToken:      authToken,
+    webPassword:    webPassword || '',
+    startMode:      startMode,
+    disabledSkills: selectedTemplate === 'zh' ? ['mindos'] : ['mindos-zh'],
     ai: {
       provider:  isSkip ? existingAiProvider : (isAnthropic ? 'anthropic' : 'openai'),
       providers: existingProviders,
@@ -1052,7 +1149,13 @@ async function main() {
   stepHeader(7);
   write(c.dim(tf('mcpStepHint') + '\n\n'));
 
-  await runMcpInstallStep(mcpPort, authToken);
+  const selectedAgents = await runMcpInstallStep(mcpPort, authToken);
+
+  // ── Skill auto-install ────────────────────────────────────────────────────
+  if (selectedAgents && selectedAgents.length > 0) {
+    write('\n');
+    runSkillInstallStep(selectedTemplate, selectedAgents);
+  }
 
   // ── Sync setup (optional) ──────────────────────────────────────────────────
   const wantSync = await askYesNo('syncSetup');

package/skills/human-insights/SKILL.md

@@ -1,143 +0,0 @@
----
-name: human-insights
-description: "捕捉、记录和提炼人机协作过程中产生的隐性知识，存入项目 human-insights/ 目录。当用户说「记录下这个发现」「这个方法很有效，存一下」「回顾下我们的协作」「总结下 SOP」「这个 AI 总是犯这个错」「把这个变成规则」「整理下 insights」「提炼下规律」「升华到 CLAUDE.md」时使用此 Skill。对话中出现值得沉淀的协作模式、认知升级、反模式时也应触发。"
----
-
-# Human Insights Skill
-
-捕捉人机协作中产生的隐性知识，让它不随对话消失，并定期提炼为可复用的 SOP。
-
-核心设计原则：**零摩擦**。记录的成本越低，记录的频率越高，积累的价值越大。所有让用户需要思考"怎么配合"的设计都是反模式。
-
----
-
-## 核心理念
-
-insights 不是终点，是 CLAUDE.md 的原材料。生命周期：
-
-```
-对话碎片 → 捕捉 → human-insights/ → 定期回顾提炼 → CLAUDE.md / Skill
-```
-
-已升华进 CLAUDE.md 的 insight 标记为 `[已采纳]`，避免重复处理。
-
----
-
-## 三种模式
-
-### 模式一：捕捉（用户主动触发）
-
-用户说"记录下这个"、"这个很有用"时触发。
-
-1. 理解内容 — 读懂要记录什么，必要时追问一句
-2. **AI 判断分类**，用户不需要选（见下方分类体系）
-3. 检查目标文件，避免重复记录
-4. 写入，自动填写时间，来源一句话
-5. 告知用户记录到了哪里
-
-### 模式二：主动提议（AI 识别信号）
-
-对话中出现以下信号时，AI 在回答完后顺带问一句"这个发现值得记进 human-insights，要我记一下吗？"
-
-**值得提议的信号（需同时满足：有新意 + 可复用）：**
-- 用户明确纠正了 AI 的错误认知或行为模式
-- 用户发现某个做法比之前的方式明显更高效，且说清楚了为什么
-- 对话中归纳出了一条可以跨场景复用的规律或原则
-
-**不需要提议的情况：**
-- 只是某个任务执行得顺利（不代表有可复用的模式）
-- 用户已经在说"记一下"（模式一已覆盖）
-- 同一对话中已经提议过一次（避免反复打断）
-
-用户说"好"/"记一下"即执行，说"不用"则跳过。不打断主流程，轻量提议。
-
-### 模式三：回顾提炼（定期整理）
-
-用户说"回顾下协作"、"总结 SOP"、"升华到 CLAUDE.md" 时触发。
-
-1. 读取 `human-insights/` 下所有文件，统计各类别条目数和"待提炼"数量
-2. 识别模式 — 找出：① 反复出现的主题 ② 相互印证的发现 ③ 已有足够证据支撑的规律
-3. 起草提炼结果，每条产出明确其形态：
-   - **规则**：适合写进 CLAUDE.md 的行为约束（"做 X 之前先做 Y"）
-   - **流程**：可复用的步骤序列（适合写成 Skill 或 CLAUDE.md 流程节）
-   - **Prompt 模板**：可直接复用的指令结构
-4. 展示给用户确认，用户可修改或拒绝某条
-5. 写入 CLAUDE.md 对应章节，原 insight 标记 `[已采纳 → CLAUDE.md #章节名]`
-6. 更新 `README.md` 各文件摘要
-
----
-
-## 分类体系（AI 判断，用户无感）
-
-| 类别 | 文件 | 记录什么 |
-|------|------|---------|
-| Prompt 模式 | `prompt-patterns.md` | 有效的提问方式、指令结构、上下文给法 |
-| 工作流发现 | `workflow.md` | 有效的协作流程、任务拆分方式、节奏把握 |
-| AI 行为规律 | `ai-behavior.md` | AI 在特定场景下的规律性表现、容易犯的错 |
-| 认知升级 | `mindset.md` | 对某个概念/方法的新理解，之前认知被纠正 |
-| 反模式 | `anti-patterns.md` | 踩过的坑、低效做法、应该避免的模式 |
-
-一条 insight 可以属于多个类别时，以最主要的类别为准写入一个文件，不重复写入。
-
----
-
-## 记录格式
-
-轻量为主，自动填时间，来源一句话够了：
-
-```markdown
-## <标题>
-
-**时间：** YYYY-MM-DD  **来源：** <一句话场景，如"MindOS CLAUDE.md 整理中">
-
-<发现了什么、为什么有价值、怎么用。1-3 句话。>
-
-**状态：** 待提炼 / [已采纳 → CLAUDE.md #章节名]
-```
-
----
-
-## 目录结构
-
-```
-human-insights/
-├── README.md           # 索引 + 各文件一句话摘要（只列已创建的文件）
-├── prompt-patterns.md
-├── workflow.md
-├── ai-behavior.md
-├── mindset.md
-└── anti-patterns.md
-```
-
-首次使用时只创建 `README.md` 和当前需要写入的文件，其余按需创建。
-
----
-
-## 初始化
-
-`human-insights/` 不存在时自动创建目录和 `README.md`：
-
-```markdown
-# Human Insights
-
-记录人机协作过程中产生的隐性知识，定期提炼为可复用的 SOP。
-
-## 文件索引
-
-（按需添加，创建新文件时同步更新此表）
-
-| 文件 | 摘要 |
-|------|------|
-
-## 升华路径
-
-积累 → 回顾提炼 → 写入 CLAUDE.md → 标记 [已采纳]
-```
-
----
-
-## 边界说明
-
-- vs `wiki/80-known-pitfalls.md`：pitfalls 记客观技术坑（别人也会踩），insights 记主观协作发现（你个人的认知）
-- vs `wiki/06-conventions.md`：conventions 是已确定的规范，insights 是还在验证中的发现
-- vs `CLAUDE.md`：CLAUDE.md 是已固化的规则，insights 是原材料