@seeed-studio/solution-cli 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -0,0 +1,84 @@
+# Changelog
+
+本文件记录 `@seeed-studio/solution-cli` 的所有重要更新与版本演进。
+
+---
+
+## [0.4.6] - 2026-10-20
+
+### 新增功能 (Added)
+- **方案成功案例接入与动态检索 (`cases`)**：
+  - `hub get <id> --section cases` 支持在线拉取方案落地成功案例集合（Typesense `cc_success_cases` 集合与 Solution `related_posts` 融合），支持多语言与真实带 UTM 归因的落地页链接。
+  - 搜索结果（`hub search`）直出落地案例计数值，提供直观的客户落地证据。
+- **单篇案例完整正文下钻 (`case get`)**：
+  - 新增顶层命令 `solution-cli case get <id_or_slug> [--locale zh|en|ja] [--json]`，支持获取 2000+ 字完整 Markdown 正文（`body_md`）、现场背景、工况挑战、合作伙伴与硬件清单。
+- **产品模块渐进式披露与字段裁剪 (`--section`)**：
+  - `product search` 与 `product query` 新增 `--section <overview|power|interfaces|specs|all>` 支持：
+    - `--section power`：专用于供电、线缆、开箱即用与必需配件分析，裁剪掉无关网络接口与算力字段，大幅缩减上下文占用；
+    - `--section interfaces`：仅保留板载接口、通信协议与 I/O 外设扩展槽；
+    - `--section overview`：仅保留家族简介与各 SKU 开箱判定简述。
+- **中文硬件泛称同义词匹配**：
+  - 针对“树莓派”、“工控机”等中文通用行业用词内置分词同义词表与在线回退匹配，避免直接搜索中文硬件无结果。
+- **场景化防回退 Benchmark 评测套件**：
+  - 新增 `npm run benchmark`（18 个端到端用户场景），覆盖方案咨询、案例下钻、硬件开箱判定、同义词、芯片避坑、离线降级与部署契约。
+
+### 体验与文档优化 (Documentation)
+- **Agent Skill 技能升级**：更新 `SKILL.md` 与 `consult-and-select.md`，补充成功案例下钻与产品字段裁剪指引。
+
+---
+
+## [0.4.5] - 2026-10-19
+
+### 新增功能 (Added)
+- **方案数据接口与参数自省 (`schema`)**：
+  - 新增 `schema` 命令，支持一键查询应用对外提供的数据接口（MQTT Topic、REST API 端点、TCP 语音/流媒体端口及数据格式），方便快速接入自有系统或数据库。
+  - 支持直接导出部署参数的标准 Draft-07 JSON Schema，包含默认值和条件依赖。
+- **命令行直接传参部署 (`--input` / `--inputs-file`)**：
+  - 支持在部署时通过 `-i 参数名=值`（或 `-i 步骤.参数名=值`）直接传递参数，无需再手写多层 JSON 文件。
+  - 支持通过 `--inputs-file` 读取 YAML/JSON 配置文件批量传参。
+- **已部署应用自动更新 (`--replace-existing`)**：
+  - 修改参数重新部署时，自动停止并替换已有冲突容器，快速应用新配置并重启服务。
+
+### 体验与文档优化 (Documentation)
+- **Agent Skill 技能升级**：同步更新内置 AI 助手技能（支持 Claude Code, Codex, 豆包等），增加数据接入自省与无头入参推荐范式。
+
+---
+
+## [0.4.4] - 2026-10-15
+
+### 问题修复 (Fixed)
+- 修复 Windows 与 macOS 环境下软链接创建异常，完善跨平台目录同步回退。
+- 修复豆包工作（Doubao Work）技能路径协同问题。
+
+### 体验与文档优化 (Documentation)
+- 补充各支持 Agent 的 CLI 指令集与硬件排错踩坑库（gotchas）参考。
+
+---
+
+## [0.4.3] - 2026-10-14
+
+### 问题修复 (Fixed)
+- 修复 Agent 环境识别中的路径加载与语法异常。
+
+---
+
+## [0.4.2] - 2026-10-14
+
+### 体验与优化 (Improved)
+- 规范并增强豆包工作（Doubao Work）技能的本地扫描发现路径。
+
+---
+
+## [0.4.1] - 2026-10-13
+
+### 体验与优化 (Improved)
+- 增强硬件与配件匹配规则：优化电源线、电池及多国适配插头的识别过滤，准确识别开箱即用状态。
+
+---
+
+## [0.4.0] - 2026-10-13
+
+### 新增功能 (Added)
+- **硬件开箱即用与包装清单查询**：支持精准查询硬件是否随附电源、盒内清单、外设接口与支持的落地场景。
+- **Hermes Agent 支持**：新增对 Hermes Agent 的环境检测与技能自动安装支持。
+- **Agent 架构解耦**：将豆包工作与 WorkBuddy 解耦为独立配置管理。

package/README.md

@@ -9,7 +9,7 @@ Install the signed Rust deployment engine and the `solution-cli` AI Agent Skill
 
 | 目标 AI 宿主 | 专属安装命令（直接复制发给 AI 或在终端运行） | 技能挂载路径 |
 |---|---|---|
-| **豆包工作 (Doubao Work)** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent doubao` | `~/Doubao/skills` (及 `~/.agents/skills`) |
+| **豆包工作 (Doubao Work)** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent doubao` | `~/Doubao/skills` (Windows: `%USERPROFILE%\Doubao\skills`；及 `~/.agents/skills`) |
 | **Claude Code** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent claude` | `~/.claude/skills` |
 | **OpenAI Codex** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent codex` | `~/.agents/skills` 或 `~/.codex/skills` |
 | **Google Antigravity** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent antigravity` | `~/.gemini/config/skills` |
@@ -103,6 +103,9 @@ npx -y @seeed-studio/solution-cli product query recomputer_j40 --json
 | Command | Purpose |
 |---|---|
 | `solution-cli install --agent <agent-id> -y` | Install or update the signed Engine and Skill |
+| `solution-cli update` | Check for Engine/content updates and sync installed AI Agent skills |
+| `solution-cli agent list [--json]` | List supported AI agent hosts and their skill directories |
+| `solution-cli gotchas [keyword] [--chip <chip>]` | Query edge hardware, chip troubleshooting & caveats |
 | `solution-cli hub search "<query>" --json` | Find solution scenarios and reference designs |
 | `solution-cli product query <family-id> --json` | Read hardware family specifications |
 | `solution-cli product accessories <family-id> --json` | Check required and compatible accessories |

package/bin/cli.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { runInstall, runUpdate, listAgents, runStatus, runUninstall } from '../lib/installer.js';
 import { runDoctor } from '../lib/doctor.js';
-import { searchHub, listHub, getHubRecord, loadKnowledgeCore, queryProductFamily, searchProducts, queryAccessories, createDeploymentLockfile } from '../lib/knowledge.js';
+import { searchHub, listHub, getHubRecord, getHubRecordAsync, getCaseRecord, loadKnowledgeCore, queryProductFamily, searchProducts, searchProductsAsync, queryAccessories, createDeploymentLockfile, PRODUCT_SECTIONS } from '../lib/knowledge.js';
 import { assertCompatibility } from '../lib/compatibility.js';
 import { searchGotchas } from '../lib/gotchas.js';
 
@@ -33,10 +33,12 @@ Commands:
   hub         Search scenarios and reference designs from Seeed Solution Hub
               Usage: solution-cli hub search <keyword> [--limit 5] [--locale zh|en|ja] [--json]
                      solution-cli hub list [--type scenario|tech|reference_design] [--page N] [--limit 50] [--locale zh|en|ja] [--json]
-                     solution-cli hub get <id> [--type ...] [--section overview|links|description|architecture|products|deployment|playbook|integration] [--preset <id>] [--locale zh|en|ja] [--json]
+                     solution-cli hub get <id> [--type ...] [--section overview|links|description|architecture|products|deployment|playbook|integration|cases] [--preset <id>] [--locale zh|en|ja] [--json]
+  case        Retrieve full story, body markdown, and details of a success case
+              Usage: solution-cli case get <id_or_slug> [--locale zh|en|ja] [--json]
   product     Query product families, SKUs, physical interfaces, box contents, and verified accessories
-              Usage: solution-cli product search <keyword|model|sku> [--limit 5] [--locale zh|en|ja] [--json]
-                     solution-cli product query <family_id> [--locale zh|en|ja] [--json]
+              Usage: solution-cli product search <keyword|model|sku> [--section overview|power|interfaces|specs|all] [--limit 5] [--locale zh|en|ja] [--json]
+                     solution-cli product query <family_id> [--section overview|power|interfaces|specs|all] [--locale zh|en|ja] [--json]
                      solution-cli product accessories <family_id> [--sku <sku>] [--category <cats>] [--compact] [--json]
                      solution-cli product verify-compatibility --host <family_id> [--json]
   gotchas     Search edge hardware and chip troubleshooting knowledge (RK3588, reCamera, Jetson, Hailo)
@@ -210,7 +212,8 @@ function validateCommandFlags(command, flags) {
     doctor: ['--json'],
     agent: ['--json'],
     hub: ['--json', '--compact', '--locale', '--limit', '--page', '--type', '--section', '--sections', '--preset'],
-    product: ['--json', '--compact', '--locale', '--sku', '--host', '--accessory', '--category', '--limit'],
+    case: ['--json', '--locale'],
+    product: ['--json', '--compact', '--locale', '--sku', '--host', '--accessory', '--category', '--limit', '--section'],
     gotchas: ['--json', '--chip'],
     lockfile: ['--json', '--solution', '--version', '--hardware'],
     help: [],
@@ -310,6 +313,22 @@ function renderSectionOutput(r, section) {
       console.log('\n     \x1b[35m[系统快速对接指引]\x1b[0m');
       r.integration.system_ingestion_guide.forEach((g) => console.log(`     ${g}`));
     }
+  } else if (section === 'cases') {
+    console.log(`     \x1b[36m[成功案例与客户实践 (Case Studies & Success Stories)]\x1b[0m`);
+    console.log(`     数据来源: ${r.cases?.source || 'bundled_manifest'} | 状态: ${r.cases?.availability || 'unavailable'}`);
+    const items = r.cases?.items || [];
+    if (items.length === 0) {
+      console.log('     暂无结构化案例或当前处于离线状态。');
+    } else {
+      items.forEach((item, idx) => {
+        console.log(`\n     \x1b[32m[案例 ${idx + 1}]\x1b[0m \x1b[1m${item.title}\x1b[0m`);
+        if (item.industry?.length) console.log(`        🏷️ 行业分类: ${item.industry.join(', ')}`);
+        if (item.region?.length) console.log(`        🌍 落地地区: ${item.region.join(', ')}`);
+        if (item.hardware?.length) console.log(`        🛠️ 采用硬件: ${item.hardware.join(', ')}`);
+        if (item.description) console.log(`        💡 案例概述: ${item.description}`);
+        if (item.url) console.log(`        🔗 详情链接: ${item.url}`);
+      });
+    }
   }
 }
 
@@ -403,7 +422,7 @@ async function main() {
           const listLimit = flags.usedFlags.has('--limit') ? flags.limit : 50;
           dto = listHub({ type: flags.type, locale: flags.locale, page: flags.page, limit: listLimit });
         } else if (sub === 'get') {
-          const row = getHubRecord(flags.positionals[1], {
+          const row = await getHubRecordAsync(flags.positionals[1], {
             type: flags.type,
             locale: flags.locale,
             section: flags.section,
@@ -415,16 +434,17 @@ async function main() {
             process.exit(1);
           }
           const core = loadKnowledgeCore();
+          const rowSource = row.cases?.source === 'typesense' ? 'typesense' : 'bundled_manifest';
           dto = {
             records: [row],
-            source: 'bundled_manifest',
+            source: rowSource,
             freshness: 'UNKNOWN',
             dataset_version: core.dataset_version || null,
             build_time: core.build_time || null,
             provenance: core.provenance || null,
-            scope: 'bundled_catalog_snapshot',
+            scope: rowSource === 'typesense' ? 'typesense' : 'bundled_catalog_snapshot',
             locale: flags.locale,
-            warnings: [],
+            warnings: row.warnings || [],
           };
         } else {
           const query = flags.positionals.slice(1).join(' ');
@@ -477,6 +497,9 @@ async function main() {
                 }).join(', ');
                 console.log(`     Available Sections: ${sectionSummary}`);
               }
+              if (r.cases_count > 0) {
+                console.log(`     \x1b[32m成功案例:\x1b[0m ${r.cases_count} 个落地案例 (使用 hub get ${r.id} --section cases 查看详情)`);
+              }
               console.log('');
             });
           }
@@ -515,13 +538,24 @@ async function main() {
         }
         const familyId = queryTarget;
 
+        const productSection = flags.usedFlags.has('--section') ? String(flags.section).toLowerCase().trim() : 'all';
+        if (!PRODUCT_SECTIONS.has(productSection)) {
+          console.error(`Unsupported product section "${flags.section}". Supported: ${Array.from(PRODUCT_SECTIONS).join(', ')}.`);
+          process.exit(1);
+        }
+
         if (sub === 'search') {
           const q = (rawFirst === 'search' ? flags.positionals.slice(1).join(' ') : queryTarget) || '';
           if (!q.trim()) {
             console.error('Please specify a search query (e.g. "solution-cli product search J4012 Super")');
             process.exit(1);
           }
-          const dto = searchProducts({ query: q, locale: flags.locale, limit: flags.limit ? parseInt(flags.limit, 10) : 5 });
+          const dto = await searchProductsAsync({
+            query: q,
+            locale: flags.locale,
+            limit: flags.limit ? parseInt(flags.limit, 10) : 5,
+            section: productSection,
+          });
           if (flags.json) {
             console.log(JSON.stringify(dto, null, 2));
           } else {
@@ -531,64 +565,130 @@ async function main() {
               console.log(`\n🔍 找到 ${dto.records.length} 个匹配的硬件产品族:`);
               dto.records.forEach((fam) => {
                 console.log(`\n======================================================================`);
-                console.log(`📦 \x1b[1m${fam.title}\x1b[0m (Family ID: \x1b[36m${fam.family_id}\x1b[0m)`);
+                const sectionTag = productSection !== 'all' ? ` \x1b[33m[Section: ${productSection}]\x1b[0m` : '';
+                console.log(`📦 \x1b[1m${fam.title}\x1b[0m (Family ID: \x1b[36m${fam.family_id}\x1b[0m)${sectionTag}`);
                 if (fam.summary) console.log(`   💡 简介: ${fam.summary}`);
-                if (fam.interfaces?.length) console.log(`   🔌 板载接口 (Interfaces): ${fam.interfaces.join(', ')}`);
-                if (fam.protocols?.length) console.log(`   📡 通信协议 (Protocols): ${fam.protocols.join(', ')}`);
-
-                if (fam.supported_scenarios?.length) {
-                  console.log(`   🚀 官方落地方案 (该设备可以干嘛):`);
-                  fam.supported_scenarios.slice(0, 5).forEach((sc) => {
-                    const scTitle = sc.title?.[flags.locale] || sc.title?.zh || sc.title?.en || sc.id;
-                    console.log(`      - \x1b[32m${scTitle}\x1b[0m (ID: ${sc.id})`);
-                  });
-                }
 
-                if (fam.matched_skus?.length) {
-                  console.log(`   🎯 具体型号 (SKU) & 开箱配置:`);
-                  fam.matched_skus.forEach((s) => {
-                    console.log(`      --------------------------------------------------`);
-                    console.log(`      SKU: \x1b[1m${s.sku}\x1b[0m | 型号: ${s.model || '标准款'} | 名称: ${s.name}`);
-                    if (s.ai_performance) console.log(`      ⚡ 算力: ${s.ai_performance}`);
-
-                    // Power & Readiness summary
-                    if (s.package_profile?.readiness_summary) {
-                      const icon = s.package_profile.out_of_the_box_ready ? '\x1b[32m✔ 开箱即用\x1b[0m' : '\x1b[33m⚠️ 无法直接开机/需配件\x1b[0m';
-                      console.log(`      ⚡ 开箱状态: ${icon}`);
-                      console.log(`         ${s.package_profile.readiness_summary}`);
-                    } else if (s.power.adapter_included === true) {
-                      console.log(`      🔌 电源适配器: \x1b[32m✔ 随附\x1b[0m (${s.power.adapter_spec || s.power.input_voltage || '标配适配器'})`);
-                    } else if (s.power.adapter_included === false) {
-                      console.log(`      🔌 电源适配器: \x1b[31m✖ 不随附\x1b[0m (需要自备或加配: ${s.power.adapter_spec || s.power.input_voltage || '需外接电源'})`);
-                    } else if (s.power.input_voltage) {
-                      console.log(`      🔌 供电要求: ${s.power.input_voltage} ${s.power.input_connector || ''}`);
-                    }
-
-                    // Required accessories if any
-                    if (s.required_accessories?.length) {
-                      console.log(`      🔌 必需加配配件:`);
-                      s.required_accessories.forEach((acc) => {
-                        console.log(`         • \x1b[1m${acc.name}\x1b[0m (SKU: ${acc.sku || 'N/A'})${acc.reason ? ` - ${acc.reason}` : ''}`);
-                      });
-                    }
-
-                    // Package contents
-                    if (s.package_contents?.length) {
-                      console.log(`      📦 包装清单 (Box Contents):`);
-                      s.package_contents.forEach((item) => console.log(`         • ${item}`));
-                    }
-
-                    // I/O ports
-                    if (s.io_ports?.length) {
-                      const portSummary = s.io_ports.map((p) => `${p.count}x ${p.type}${p.notes ? ` (${p.notes})` : ''}`).join(', ');
-                      console.log(`      🖥️ 外设端口 (I/O Ports): ${portSummary}`);
-                    }
-
-                    if (s.url) console.log(`      🔗 购买链接: ${s.url}`);
-                  });
+                if (productSection === 'power') {
+                  if (fam.matched_skus?.length) {
+                    console.log(`   🎯 型号供电与开箱配置:`);
+                    fam.matched_skus.forEach((s) => {
+                      console.log(`      --------------------------------------------------`);
+                      console.log(`      SKU: \x1b[1m${s.sku}\x1b[0m | 型号: ${s.model || '标准款'} | 名称: ${s.name}`);
+                      if (s.package_profile?.readiness_summary) {
+                        const icon = s.package_profile.out_of_the_box_ready ? '\x1b[32m✔ 开箱即用\x1b[0m' : '\x1b[33m⚠️ 无法直接开机/需配件\x1b[0m';
+                        console.log(`      ⚡ 开箱状态: ${icon}`);
+                        console.log(`         ${s.package_profile.readiness_summary}`);
+                      } else if (s.power?.adapter_included === true) {
+                        console.log(`      🔌 电源适配器: \x1b[32m✔ 随附\x1b[0m (${s.power.adapter_spec || s.power.input_voltage || '标配适配器'})`);
+                      } else if (s.power?.adapter_included === false) {
+                        console.log(`      🔌 电源适配器: \x1b[31m✖ 不随附\x1b[0m (需要自备或加配: ${s.power.adapter_spec || s.power.input_voltage || '需外接电源'})`);
+                      } else if (s.power?.input_voltage) {
+                        console.log(`      🔌 供电要求: ${s.power.input_voltage} ${s.power.input_connector || ''}`);
+                      }
+                      if (s.required_accessories?.length) {
+                        console.log(`      🔌 必需加配配件:`);
+                        s.required_accessories.forEach((acc) => {
+                          console.log(`         • \x1b[1m${acc.name}\x1b[0m (SKU: ${acc.sku || 'N/A'})${acc.reason ? ` - ${acc.reason}` : ''}`);
+                        });
+                      }
+                      if (s.package_contents?.length) {
+                        console.log(`      📦 包装清单: ${s.package_contents.join(', ')}`);
+                      }
+                      if (s.url) console.log(`      🔗 购买链接: ${s.url}`);
+                    });
+                  }
+                } else if (productSection === 'interfaces') {
+                  if (fam.interfaces?.length) console.log(`   🔌 板载接口 (Interfaces): ${fam.interfaces.join(', ')}`);
+                  if (fam.protocols?.length) console.log(`   📡 通信协议 (Protocols): ${fam.protocols.join(', ')}`);
+                  if (fam.matched_skus?.length) {
+                    console.log(`   🎯 型号外设端口与扩展:`);
+                    fam.matched_skus.forEach((s) => {
+                      console.log(`      --------------------------------------------------`);
+                      console.log(`      SKU: \x1b[1m${s.sku}\x1b[0m | 型号: ${s.model || '标准款'} | 名称: ${s.name}`);
+                      if (s.interfaces?.length) console.log(`      🔌 接口: ${s.interfaces.join(', ')}`);
+                      if (s.io_ports?.length) {
+                        const portSummary = s.io_ports.map((p) => `${p.count}x ${p.type}${p.notes ? ` (${p.notes})` : ''}`).join(', ');
+                        console.log(`      🖥️ 外设端口: ${portSummary}`);
+                      }
+                      if (s.expansion_slots?.length) {
+                        const slotSummary = s.expansion_slots.map((sl) => `${sl.type}`).join(', ');
+                        console.log(`      🧩 扩展槽位: ${slotSummary}`);
+                      }
+                      if (s.url) console.log(`      🔗 购买链接: ${s.url}`);
+                    });
+                  }
+                } else if (productSection === 'overview') {
+                  if (fam.matched_skus?.length) {
+                    console.log(`   🎯 SKU 概览 (${fam.matched_skus.length} 款):`);
+                    fam.matched_skus.forEach((s) => {
+                      const icon = s.out_of_the_box_ready ? '\x1b[32m✔\x1b[0m' : '\x1b[33m⚠️\x1b[0m';
+                      console.log(`      - SKU: \x1b[1m${s.sku}\x1b[0m (${s.model || '标准款'}) | ${s.name} [${icon} ${s.readiness_summary || ''}]`);
+                      if (s.url) console.log(`        链接: ${s.url}`);
+                    });
+                  }
+                } else {
+                  // all or specs
+                  if (fam.interfaces?.length) console.log(`   🔌 板载接口 (Interfaces): ${fam.interfaces.join(', ')}`);
+                  if (fam.protocols?.length) console.log(`   📡 通信协议 (Protocols): ${fam.protocols.join(', ')}`);
+
+                  if (fam.supported_scenarios?.length) {
+                    console.log(`   🚀 官方落地方案 (该设备可以干嘛):`);
+                    fam.supported_scenarios.slice(0, 5).forEach((sc) => {
+                      const scTitle = sc.title?.[flags.locale] || sc.title?.zh || sc.title?.en || sc.id;
+                      console.log(`      - \x1b[32m${scTitle}\x1b[0m (ID: ${sc.id})`);
+                    });
+                  }
+
+                  if (fam.matched_skus?.length) {
+                    console.log(`   🎯 具体型号 (SKU) & 开箱配置:`);
+                    fam.matched_skus.forEach((s) => {
+                      console.log(`      --------------------------------------------------`);
+                      console.log(`      SKU: \x1b[1m${s.sku}\x1b[0m | 型号: ${s.model || '标准款'} | 名称: ${s.name}`);
+                      if (s.ai_performance) console.log(`      ⚡ 算力: ${s.ai_performance}`);
+
+                      // Power & Readiness summary
+                      if (s.package_profile?.readiness_summary) {
+                        const icon = s.package_profile.out_of_the_box_ready ? '\x1b[32m✔ 开箱即用\x1b[0m' : '\x1b[33m⚠️ 无法直接开机/需配件\x1b[0m';
+                        console.log(`      ⚡ 开箱状态: ${icon}`);
+                        console.log(`         ${s.package_profile.readiness_summary}`);
+                      } else if (s.power?.adapter_included === true) {
+                        console.log(`      🔌 电源适配器: \x1b[32m✔ 随附\x1b[0m (${s.power.adapter_spec || s.power.input_voltage || '标配适配器'})`);
+                      } else if (s.power?.adapter_included === false) {
+                        console.log(`      🔌 电源适配器: \x1b[31m✖ 不随附\x1b[0m (需要自备或加配: ${s.power.adapter_spec || s.power.input_voltage || '需外接电源'})`);
+                      } else if (s.power?.input_voltage) {
+                        console.log(`      🔌 供电要求: ${s.power.input_voltage} ${s.power.input_connector || ''}`);
+                      }
+
+                      // Required accessories if any
+                      if (s.required_accessories?.length) {
+                        console.log(`      🔌 必需加配配件:`);
+                        s.required_accessories.forEach((acc) => {
+                          console.log(`         • \x1b[1m${acc.name}\x1b[0m (SKU: ${acc.sku || 'N/A'})${acc.reason ? ` - ${acc.reason}` : ''}`);
+                        });
+                      }
+
+                      // Package contents
+                      if (s.package_contents?.length) {
+                        console.log(`      📦 包装清单 (Box Contents):`);
+                        s.package_contents.forEach((item) => console.log(`         • ${item}`));
+                      }
+
+                      // I/O ports
+                      if (s.io_ports?.length) {
+                        const portSummary = s.io_ports.map((p) => `${p.count}x ${p.type}${p.notes ? ` (${p.notes})` : ''}`).join(', ');
+                        console.log(`      🖥️ 外设端口 (I/O Ports): ${portSummary}`);
+                      }
+
+                      if (s.url) console.log(`      🔗 购买链接: ${s.url}`);
+                    });
+                  }
                 }
               });
               console.log(`\n💡 提示: 查看该设备必需与推荐配件请使用: solution-cli product accessories <family_id>`);
+              if (productSection === 'all') {
+                console.log(`💡 渐进式披露建议: 可使用 --section <overview|power|interfaces|specs> 按需裁剪输出减少上下文占用。`);
+              }
             }
           }
         } else if (sub === 'query') {
@@ -596,7 +696,7 @@ async function main() {
             console.error('Please specify a product family ID (e.g. "solution-cli product query recomputer_j40")');
             process.exit(1);
           }
-          const dto = queryProductFamily(familyId, { locale: flags.locale });
+          const dto = queryProductFamily(familyId, { locale: flags.locale, section: productSection });
           if (flags.json) {
             console.log(JSON.stringify(dto, null, 2));
           } else {
@@ -715,6 +815,57 @@ async function main() {
         break;
       }
 
+      case 'case': {
+        const rawFirst = flags.positionals[0];
+        let sub = rawFirst;
+        let targetSlug = flags.positionals[1];
+
+        if (sub !== 'get') {
+          // Auto routing: solution-cli case <slug_or_id>
+          targetSlug = flags.positionals.join(' ');
+          sub = 'get';
+        }
+
+        if (!targetSlug || !targetSlug.trim()) {
+          console.error('Please specify a case slug or ID (e.g. "solution-cli case get rice-pest-and-disease-monitoring-solution-to-ensure-a-bountiful-harvest")');
+          process.exit(1);
+        }
+
+        const dto = await getCaseRecord(targetSlug.trim(), { locale: flags.locale });
+        if (flags.json) {
+          console.log(JSON.stringify(dto, null, 2));
+        } else {
+          if (dto.records.length === 0) {
+            console.log(`未找到案例 "${targetSlug}"。${dto.warnings?.join(' ') || ''}`);
+          } else {
+            const c = dto.records[0];
+            console.log(`\n======================================================================`);
+            console.log(`📖 \x1b[1m${c.title}\x1b[0m (ID: \x1b[36m${c.id}\x1b[0m)`);
+            if (c.slug) console.log(`   Slug: ${c.slug}`);
+            if (c.solution_ids?.length) console.log(`   🚀 关联方案 (Solution IDs): ${c.solution_ids.join(', ')}`);
+            if (c.hardware?.length) console.log(`   📦 使用硬件: ${c.hardware.join(', ')}`);
+            if (c.industry?.length || c.region?.length) {
+              const meta = [];
+              if (c.region?.length) meta.push(`地区: ${c.region.join(', ')}`);
+              if (c.industry?.length) meta.push(`行业: ${c.industry.join(', ')}`);
+              console.log(`   🌍 ${meta.join(' | ')}`);
+            }
+            if (c.url) console.log(`   🔗 案例原文: ${c.url}`);
+            if (c.excerpt) console.log(`\n💡 \x1b[33m摘要:\x1b[0m\n   ${c.excerpt.replace(/\n/g, '\n   ')}`);
+            if (c.body_md) {
+              console.log(`\n📄 \x1b[32m案例正文 (Full Story):\x1b[0m`);
+              console.log(`----------------------------------------------------------------------`);
+              console.log(c.body_md);
+              console.log(`----------------------------------------------------------------------`);
+            }
+          }
+          if (dto.warnings?.length) {
+            dto.warnings.forEach((w) => console.log(`\x1b[33mNote:\x1b[0m ${w}`));
+          }
+        }
+        break;
+      }
+
       case 'gotchas': {
         const query = flags.positionals.join(' ');
         const results = searchGotchas({ query, chip: flags.chip });

package/catalog/client-config.json

@@ -5,6 +5,7 @@
     "host": "https://rel-search.seeedstudio.com",
     "search_key_solution": "dNsKBp0Pepdz9tvyIY1O92EMOM00XCHv",
     "search_key_reference_design": "rEy4VhZnqEmrduFG2e8uvfWMz5ZzXhjb",
-    "search_key_purchase_profile": ""
+    "search_key_purchase_profile": "YrowCXcDOGTt9KedslTEmeY0ZJEhlBml",
+    "search_key_cc_success_cases": "FIVCfDzHtAaZLbAXBa0DAFD7DKyqYCxm"
   }
 }

package/docs/cli-guide.md

@@ -34,7 +34,7 @@ Agent 的默认工作流是“先咨询，再选型，再检查，最后在用
 
 | 目标 AI 宿主平台 | 专属安装命令（直接复制发给 AI 或在终端运行） | 技能默认配置路径 |
 |---|---|---|
-| **豆包工作 (Doubao Work)** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent doubao` | `~/Doubao/skills` (及 `~/.agents/skills`) |
+| **豆包工作 (Doubao Work)** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent doubao` | `~/Doubao/skills` (Windows: `%USERPROFILE%\Doubao\skills`；及 `~/.agents/skills`) |
 | **Claude Code** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent claude` | `~/.claude/skills` |
 | **OpenAI Codex** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent codex` | `~/.agents/skills` 或 `~/.codex/skills` |
 | **Google Antigravity** | `npm install -g @seeed-studio/solution-cli && solution-cli install --agent antigravity` | `~/.gemini/config/skills` |
@@ -255,14 +255,26 @@ solution-cli status
 
 查看 Engine 路径、版本、内容缓存和 Skill 挂载状态。
 
-### 3. 网络与源排查
+### 3. 日常更新同步（solution-cli update）
+
+当官方发布了新的硬件知识库、避坑指南或部署契约更新时，运行以下命令即可增量同步所有已配置的 Agent 技能与本地 Engine：
+
+```bash
+solution-cli update
+```
+
+该命令会自动：
+1. 检查并拉取最新稳定的 `sensecraft-engine` 核心二进制与云端方案目录。
+2. 扫描已安装的全部 AI 宿主（如豆包、Claude、Codex 等），安全增量同步最新的 Skill 文件（保留用户的自定义修改）。
+
+### 4. 网络与源排查
 
 若遇到 npm 下载或同步延迟，可在命令中显式指定官方源：
 ```bash
 npx -y --registry=https://registry.npmjs.org/ @seeed-studio/solution-cli install -y
 ```
 
-### 4. 干净卸载
+### 5. 干净卸载
 
 只卸载指定宿主，并先备份需要保留的用户修改：