@harmonyos-arkts/opencode-plugin 0.0.6 → 0.0.8

package/dist/index.js

@@ -14836,7 +14836,9 @@ function scheduleFlush() {
 }
 function log(message, data) {
   try {
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const now = /* @__PURE__ */ new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    const timestamp = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}T${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
     const logEntry = `[${timestamp}] ${message} ${data ? JSON.stringify(data) : ""}
 `;
     buffer.push(logEntry);
@@ -14860,7 +14862,7 @@ var HM_DEVELOP = `
 ### Development Phase
 - Use the \`harmonyos-atomic-dev\` skill to implement features according to the design document for harmonyos atomic service
 - Use the \`harmonyos-atomic-dev\` skill to fix issues and modify function in current projects
-- Use the createHmTemplate tool to create empty applicaiton\u3001module\u3001atomic
+- Use the createHmTemplate tool to create empty applicaiton\u3001module\u3001atomic.
 - Use the \`.harmonyos/\` file (*.md\u3001*.html) as references to generate
 - After completing development, you MUST proceed to the Build phase
 - **NO EXCEPTIONS**: Code must be built successfully before marking development as complete
@@ -14885,22 +14887,118 @@ var HM_BUILD = `
   5. If still failing after 3 attempts, report the remaining errors to the user and ask for guidance
 - Only after a successful build should the development cycle be considered complete
 `;
-var HM_ASCF = `
-### ASCF Phase
-- HM_ASCF is the default active environment. Treat all requests as ASCF-context tasks unless the user explicitly asks to switch domain.
-- Skill routing is mandatory and must be explicit before execution. Never handle ASCF tasks without selecting one of the ASCF skills first.
-- Use \`harmonyos-atomic-ascf-convert\` for mini-program to HarmonyOS Atomic Service conversion (migration, API mapping, directory and component adaptation, conversion implementation).
-- Use \`harmonyos-ascf-knowledge\` for ASCF development guidance, technical Q&A, issue localization, and troubleshooting in existing ASCF projects.
-- For mixed requests, execute in two stages: (1) conversion via \`harmonyos-atomic-ascf-convert\`, then (2) engineering verification and issue diagnosis via \`harmonyos-ascf-knowledge\`.
-- If the request is "how to", "why it fails", "where the issue is", or "how to fix", always prioritize \`harmonyos-ascf-knowledge\`.
-- If a selected skill returns insufficient context, immediately continue with the other ASCF skill as fallback, then merge results into a single ASCF-oriented answer.
-`;
 var HM_ONE2MANY = `
 ### One-to-Many Adaptation Phase
 - Use the \`harmonyos-one2many-adapt\` skill to adapt the HarmonyOS application for multiple device types (phone, tablet, foldable, 2-in-1, wearable, TV)
 - After completing adaptation, you MUST proceed to the Build phase
 - **NO EXCEPTIONS**: Code must be built successfully before marking adaptation as complete
 `;
+var HM_PLAN = `
+### Plan Phase
+You are a **planning specialist** for HarmonyOS projects. Your sole responsibility is to ANALYZE, PLAN, and DOCUMENT.
+
+**CRITICAL RULES (you MUST follow these):**
+1. You MUST follow ALL steps below in strict order. Do not skip any step.
+2. You MUST NOT write any implementation code or create/edit source files (except the plan document).
+3. You MUST write the final plan to \`.harmonyos/plan.md\`.
+4. After outputting the plan, STOP and wait for user/approver feedback. Do NOT proceed to development yourself.
+
+---
+
+**Step 1: Explore the Codebase**
+
+Thoroughly explore the existing project to understand:
+- Directory structure and file organization (use Glob)
+- Architecture patterns \u2014 look for @ComponentV2/@ObservedV2, MVVM, state management singletons
+- Page routing setup (main_pages.json, route_map.json)
+- Existing models, stores, and data flow
+- Any existing features similar to what's being requested
+- module.json5 for permissions and ability configuration
+- Entry point (EntryAbility) and initial page loading
+
+If \`.harmonyos/codebase.md\` exists, read it first for cached analysis.
+
+**Step 2: Analyze Requirements**
+
+Break down the user's request into:
+- Core features and sub-features
+- Dependencies between tasks (what must be done before what \u2014 use explicit "depends on Step N" markers)
+- Technical constraints (HarmonyOS NEXT API availability, Kit compatibility, permission requirements)
+- Impact analysis: which existing files need modification vs which are new files
+
+Output a dependency-ordered task list.
+
+**Step 3: Create the Development Plan**
+
+Write a structured plan to \`.harmonyos/plan.md\` using this template:
+
+\`\`\`markdown
+# Development Plan: [Feature Name]
+
+## Overview
+[1-2 sentence summary of what will be implemented]
+
+## Current Architecture Summary
+[Brief description of the relevant existing code that will be affected]
+
+## Implementation Steps
+
+### Step 1: [Clear Action Title]
+- **Objective**: [What this step accomplishes]
+- **Files to create**: [Full paths of new files, or "None"]
+- **Files to modify**: [Full paths of existing files to change, or "None"]
+- **Key changes**:
+  - [Specific code changes: new classes, methods, UI components]
+  - [APIs or Kits to use]
+  - [State management approach]
+  - [Configuration or permission updates]
+- **Acceptance criteria**: [How to verify this step is correctly completed]
+
+### Step 2: [Clear Action Title]
+[Same structure, with "depends on Step 1" if applicable]
+...
+
+## Risk & Considerations
+- [Potential issues, edge cases, or breaking changes to existing functionality]
+\`\`\`
+
+**Step 4: Present and Review**
+
+Output the plan content to the user in your response. Then conclude with:
+
+> Plan saved to \`.harmonyos/plan.md\`. Please review and confirm, or suggest adjustments before implementation begins.
+
+**STOP HERE. Do NOT proceed to implementation. The main agent or user will handle the next phase.**
+
+---
+
+**Granularity Guidelines:**
+- Simple tasks (1-2 files changed): 2-3 high-level steps
+- Medium tasks (3-5 files): 4-6 steps, one major file change per step
+- Complex tasks (6+ files or architectural changes): Fine-grained steps with explicit dependency chains
+- Each step MUST be independently verifiable
+- Group related changes that must be deployed together into the same step
+
+**Plan Output Example (for reference):**
+
+### Step 1: Add UserStore Model
+- **Objective**: Create shared user authentication state management
+- **Files to create**: entry/src/main/ets/model/UserStore.ets
+- **Files to modify**: None
+- **Key changes**:
+  - Create UserInfo interface and UserStore singleton with @ObservedV2/@Trace
+  - Add loginWithHuaweiID() method using @kit.AccountKit authentication
+  - Add logout() method
+- **Acceptance criteria**: UserStore exports getInstance(), isLoggedIn is reactive
+
+### Step 2: Create Splash Page with Countdown
+- **Objective**: Add splash screen that navigates based on login state
+- **Files to create**: entry/src/main/ets/pages/SplashPage.ets
+- **Files to modify**: entry/src/main/resources/base/profile/main_pages.json, entry/src/main/ets/entryability/EntryAbility.ets
+- **Key changes**:
+  - ... (depends on Step 1)
+- **Acceptance criteria**: App starts on SplashPage, countdown works, routes correctly
+`;
 function buildPlanPrompt(type) {
   switch (type) {
     case "dev":
@@ -14909,10 +15007,10 @@ function buildPlanPrompt(type) {
       return HM_DESIGN;
     case "build":
       return HM_BUILD;
-    case "ascf":
-      return HM_ASCF;
     case "one2many":
       return HM_ONE2MANY;
+    case "plan":
+      return HM_PLAN;
     case "all":
       return buildAllAgentPrompt();
     default:
@@ -14920,40 +15018,16 @@ function buildPlanPrompt(type) {
   }
 }
 function buildAllAgentPrompt() {
-  return `All HarmonyOS development tasks can be broadly categorized into three main phases: Design, Development, Build, and ASCF conversion. Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
+  return `All HarmonyOS development tasks can be broadly categorized into three main phases: Design, Development, Build. Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
 ${HM_DESIGN}
 ${HM_DEVELOP}
 ${HM_BUILD}
-${HM_ASCF}
 
 Follow these workflows:
 - **New project (greenfield)**: PRD Design \u2192 Development \u2192 Build.
-- **Incremental development (complex)**: Explore the project first \u2192 Use Plan Agent to list a plan \u2192 Discuss plan details with the user \u2192 Development \u2192 Build.
-- **Incremental development (simple)**: Development \u2192 Build directly.
-- **WeChat mini-program conversion**: ASCF Phase \u2192 Development \u2192 Build.`;
-}
-function buildHmExploreSubAgentPrompt() {
-  return `
-    You are a HarmonyOS project file search specialist. You excel at thoroughly navigating and exploring codebases.
-
-    Your strengths:
-    - Rapidly finding files using glob patterns
-    - Searching code and text with powerful regex patterns
-    - Reading and analyzing file contents
-
-    Guidelines:
-    - Use Glob for broad file pattern matching
-    - Use Grep for searching file contents with regex
-    - Use Read when you know the specific file path you need to read
-    - Use Bash for file operations like copying, moving, or listing directory contents
-    - Adapt your search approach based on the thoroughness level specified by the caller
-    - Return file paths as absolute paths in your final response
-    - For clear communication, avoid using emojis
-    - Create '\`.harmonyos/codebase.md\`' to write your findings, and you can also read '\`.harmonyos/codebase.md\`' if this existed
-    - Do not create any files except '\`.harmonyos/codebase.md\`', or run bash commands that modify the user's system state in any way
-
-    Complete the user's search request efficiently and report your findings clearly.
-  `;
+- **Complex tasks**: List a plan \u2192 Discuss plan details with the user if needed \u2192 Development \u2192 Build.
+- **Simple tasks**: Development \u2192 Build directly.
+`;
 }
 function buildHmAgentPrompt(type) {
   return `You are HarmonyOS Dev Assistant(HDACode), an expert coding agent specialized in HarmonyOS development.
@@ -15097,10 +15171,11 @@ function createHmAgent() {
     prompt: buildHmAgentPrompt("all"),
     temperature: 0.3,
     permission: {
-      "task": {
-        "explore": "deny"
-      },
-      "skillSearch": "deny"
+      "*": "allow",
+      doom_loop: "ask",
+      external_directory: {
+        "*": "ask"
+      }
     },
     metadata: void 0
   };
@@ -15134,13 +15209,6 @@ function createDesignAgent() {
 }
 
 // src/agents/dev-agent.ts
-function getHmExploreSubAgentDescription() {
-  return `
-    Fast agent specialized for exploring codebases. 
-    Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). 
-    When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions.
-  `;
-}
 function getHmDevDescription() {
   return `
     HarmonyOS Development
@@ -15155,72 +15223,12 @@ function createHmDevelopmentAgent() {
     prompt: buildHmAgentPrompt("dev"),
     temperature: 0.3,
     permission: {
-      "task": {
-        "explore": "deny"
-      },
       "skillSearch": "allow"
     },
     metadata: void 0
   };
   return agent;
 }
-function createHmExploreSubAgent() {
-  const agent = {
-    id: "harmonyos-explore",
-    name: "harmonyos-explore",
-    description: getHmExploreSubAgentDescription(),
-    mode: "subagent",
-    prompt: buildHmExploreSubAgentPrompt(),
-    temperature: 0.1,
-    permission: {
-      "*": "deny",
-      "grep": "allow",
-      "glob": "allow",
-      "list": "allow",
-      "bash": "allow",
-      "read": "allow",
-      "edit": {
-        "*.harmonyos/codebase.md": "allow"
-      },
-      "write": {
-        "*.harmonyos/codebase.md": "allow"
-      }
-    },
-    metadata: void 0
-  };
-  return agent;
-}
-
-// src/agents/ascf-agent.ts
-function getHmAscfDescription() {
-  return `
-      HarmonyOS ASCF assistant for mini-program conversion, ASCF development Q&A, and issue troubleshooting
-    `;
-}
-function createAscfAgent() {
-  const agent = {
-    id: "harmonyos-ascf",
-    name: "harmonyos-ascf",
-    description: getHmAscfDescription(),
-    mode: "primary",
-    prompt: buildHmAgentPrompt("ascf"),
-    temperature: 0.6,
-    permission: {
-      "skill": {
-        "*": "deny",
-        "harmonyos-atomic-ascf-convert": "allow",
-        "harmonyos-ascf-knowledge": "allow",
-        "huawei-payment-integration": "allow",
-        "harmonyos-atomic-service-filing": "allow",
-        "harmony-emulator-debugging": "allow",
-        "harmonyos-atomic-ascf-release": "allow"
-      },
-      "skillSearch": "deny"
-    },
-    metadata: void 0
-  };
-  return agent;
-}
 
 // src/agents/one2many-agent.ts
 function getHmOne2ManyDescription() {
@@ -15251,9 +15259,7 @@ var AgentRegistry = class {
     this.register(createHmAgent());
     this.register(createDesignAgent());
     this.register(createHmDevelopmentAgent());
-    this.register(createAscfAgent());
     this.register(createOne2ManyAgent());
-    this.register(createHmExploreSubAgent());
   }
   register(agent) {
     this.agents.set(agent.id, agent);
@@ -15385,57 +15391,7 @@ var AgentManager = class {
   }
 };
 
-// src/shared/ets-counter.ts
-import { readdir, readFile as readFile2, stat } from "fs/promises";
-import { join as join2, extname } from "path";
-var SKIP_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".preview",
-  "build",
-  ".cxx",
-  ".gradle",
-  "oh_modules",
-  ".hvigor",
-  "entry/build"
-]);
-async function collectEtsFiles(dir, results) {
-  let entries;
-  try {
-    entries = await readdir(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      if (SKIP_DIRS.has(entry.name)) continue;
-      if (entry.name.startsWith(".") && entry.name !== ".ets") continue;
-      await collectEtsFiles(join2(dir, entry.name), results);
-    } else if (extname(entry.name) === ".ets") {
-      const filePath = join2(dir, entry.name);
-      try {
-        const content = await readFile2(filePath, "utf-8");
-        const lines = content.split("\n").length;
-        results.push({ path: filePath, lines });
-      } catch {
-        log("Failed to read .ets file", { path: filePath });
-      }
-    }
-  }
-}
-async function countEtsLines(projectDir) {
-  const files = [];
-  await collectEtsFiles(projectDir, files);
-  const totalLines = files.reduce((sum, f) => sum + f.lines, 0);
-  return {
-    fileCount: files.length,
-    totalLines,
-    files,
-    timestamp: Date.now()
-  };
-}
-
 // src/managers/config-handler.ts
-var EXPLORE_ETS_THRESHOLD = 2e3;
 function mergePermission(target, source) {
   if (!target) return source;
   const result = { ...target };
@@ -15450,27 +15406,11 @@ function mergePermission(target, source) {
   }
   return result;
 }
-function createConfigHandler(_pluginConfig, agent, projectDir) {
+function createConfigHandler(_pluginConfig, agent, _projectDir) {
   return async (config3) => {
-    let exploreEnabled = true;
-    try {
-      const stats = await countEtsLines(projectDir);
-      exploreEnabled = stats.totalLines >= EXPLORE_ETS_THRESHOLD;
-      log("ETS count for explore agent", {
-        totalLines: stats.totalLines,
-        fileCount: stats.fileCount,
-        enabled: exploreEnabled
-      });
-    } catch (err) {
-      log("Failed to count ETS lines, enabling explore by default", { error: String(err) });
-    }
     const pluginAgents = agent.record();
     if (config3.agent) {
       for (const [id, pluginAgentConfig] of Object.entries(pluginAgents)) {
-        if (id === "harmonyos-explore" && !exploreEnabled) {
-          log("Skipping harmonyos-explore agent (insufficient .ets files)");
-          continue;
-        }
         if (config3.agent[id]) {
           const merged = { ...config3.agent[id], ...pluginAgentConfig };
           if (config3.agent[id].permission && pluginAgentConfig.permission) {
@@ -15491,7 +15431,7 @@ function createConfigHandler(_pluginConfig, agent, projectDir) {
       template: "/harmony-development-env-check",
       description: "\u68C0\u67E5 HarmonyOS \u5F00\u53D1\u73AF\u5883\u914D\u7F6E\uFF08Node.js\u3001JDK\u3001ohpm\u3001hvigor\u3001DevEco SDK\uFF09"
     };
-    log("Config merged", config3.agent);
+    log("Config merged");
   };
 }
 
@@ -28073,6 +28013,86 @@ async function downloadTemplate(mode, filePath) {
   }
 }
 
+// src/shared/ets-counter.ts
+import { readdir, readFile as readFile2, stat } from "fs/promises";
+import { join as join2, extname } from "path";
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".preview",
+  "build",
+  ".cxx",
+  ".gradle",
+  "oh_modules",
+  ".hvigor",
+  "entry/build"
+]);
+var HM_PROJECT_INDICATORS = ["build-profile.json5", "oh-package.json5"];
+var MAX_CONTENT_READ_FILES = 500;
+var ESTIMATED_LINES_PER_FILE = 100;
+async function isHarmonyOSProject(dir) {
+  for (const indicator of HM_PROJECT_INDICATORS) {
+    try {
+      await stat(join2(dir, indicator));
+      return true;
+    } catch {
+    }
+  }
+  return false;
+}
+async function collectEtsFilePaths(dir, results) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      if (entry.name.startsWith(".") && entry.name !== ".ets") continue;
+      await collectEtsFilePaths(join2(dir, entry.name), results);
+    } else if (extname(entry.name) === ".ets") {
+      results.push(join2(dir, entry.name));
+    }
+  }
+}
+async function countEtsLines(projectDir) {
+  const startTime = Date.now();
+  if (!await isHarmonyOSProject(projectDir)) {
+    log("ets.count.skipped", { projectDir, elapsed: Date.now() - startTime });
+    return { fileCount: 0, totalLines: 0, files: [], timestamp: Date.now() };
+  }
+  const filePaths = [];
+  await collectEtsFilePaths(projectDir, filePaths);
+  const fileCount = filePaths.length;
+  if (fileCount > MAX_CONTENT_READ_FILES) {
+    const elapsed2 = Date.now() - startTime;
+    log("ets.count.estimated", { fileCount, estimatedLines: fileCount * ESTIMATED_LINES_PER_FILE, elapsed: elapsed2 });
+    return {
+      fileCount,
+      totalLines: fileCount * ESTIMATED_LINES_PER_FILE,
+      files: [],
+      timestamp: Date.now()
+    };
+  }
+  const files = [];
+  for (const filePath of filePaths) {
+    try {
+      const content = await readFile2(filePath, "utf-8");
+      files.push({ path: filePath, lines: content.split("\n").length });
+    } catch {
+    }
+  }
+  const elapsed = Date.now() - startTime;
+  log("ets.count.precise", { fileCount, totalLines: files.reduce((sum, f) => sum + f.lines, 0), elapsed });
+  return {
+    fileCount,
+    totalLines: files.reduce((sum, f) => sum + f.lines, 0),
+    files,
+    timestamp: Date.now()
+  };
+}
+
 // src/tools/create-template/ets-check.ts
 async function checkEtsExists(directory) {
   try {
@@ -28124,24 +28144,20 @@ function createHmTemplateTool(managers) {
   });
 }
 
-// src/tools/skill-search/skill-search-tool.ts
-import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
-
 // src/tools/skill-search/search-skill.ts
-import { readFileSync } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join3 } from "node:path";
+import { readFileSync, existsSync } from "node:fs";
+import { join as join4 } from "node:path";
 
 // src/tools/skill-search/tokenizer.ts
+var CJK_RE = /[一-鿿㐀-䶿]/;
+var SEG_RE = /[一-鿿㐀-䶿]+|[\w@.]+/g;
+var CAMEL_RE = /[A-Z]?[a-z]+|[A-Z]+(?=[A-Z][a-z]|\b)|[0-9]+/g;
 var segmenter = new Intl.Segmenter("zh", { granularity: "word" });
-var SEG_RE = /[一-鿿㐀-䶿]+|[^\s\p{P}一-鿿㐀-䶿]+/gu;
-var CAMEL_RE = /[A-Z]?[a-z]+|[A-Z]+(?![a-z])/g;
 function tokenize(text) {
   const segments = text.match(SEG_RE) ?? [];
   const tokens = [];
   for (const seg of segments) {
-    if (/[一-鿿㐀-䶿]/.test(seg)) {
+    if (CJK_RE.test(seg)) {
       for (const s of segmenter.segment(seg)) {
         if (s.isWordLike) tokens.push(s.segment.toLowerCase().trim());
       }
@@ -28157,7 +28173,7 @@ function tokenize(text) {
       }
     }
   }
-  return tokens.filter((w) => w.length > 0);
+  return [...new Set(tokens.filter((w) => w.length > 0))];
 }
 
 // src/tools/skill-search/bm25.ts
@@ -28312,14 +28328,198 @@ var filter_default = [
   { id: "25", summary: "WaterFlow \u7011\u5E03\u6D41\u5E03\u5C40\u5F00\u53D1\u5B9E\u8DF5", path: "experience/experience_water_flow.md", category: "water_flow" }
 ];
 
+// src/tools/skill-search/build-sdk-index.ts
+import { readdir as readdir2, readFile as readFile3, writeFile } from "node:fs/promises";
+import { join as join3, relative, basename, dirname } from "node:path";
+var SCAN_DIRS = [
+  "openharmony/js/api",
+  "openharmony/ets/api",
+  "openharmony/ets/component",
+  "openharmony/ets/kits",
+  "hms/ets/api",
+  "hms/ets/kits"
+];
+var TS_EXT_RE = /\.(?:d\.ts|d\.ets|ts|ets)$/;
+async function scanFiles(dir) {
+  const results = [];
+  async function walk(current) {
+    const entries = await readdir2(current, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = join3(current, entry.name);
+      if (entry.isDirectory()) {
+        await walk(full);
+      } else if (TS_EXT_RE.test(entry.name)) {
+        results.push(full);
+      }
+    }
+  }
+  await walk(dir);
+  return results;
+}
+function extractSummary(content, filename, relPath) {
+  const rawName = filename.replace(/\.(?:d\.ts|d\.ets|ts|ets)$/, "");
+  let moduleName;
+  if (rawName.startsWith("@")) {
+    moduleName = rawName.replace(/^@/, "");
+  } else {
+    const dirParts = dirname(relPath).split("/").filter(Boolean);
+    moduleName = [...dirParts, rawName].join(".");
+  }
+  const symbols = [];
+  const stripped = content.replace(/\/\*\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+  const patterns = [
+    // Prefixed at file/module level
+    /declare\s+namespace\s+(\w+)/g,
+    /export\s+(?:default\s+)?interface\s+(\w+)/g,
+    /export\s+(?:default\s+)?class\s+(\w+)/g,
+    /export\s+(?:default\s+)?function\s+(\w+)/g,
+    /export\s+(?:default\s+)?const\s+(\w+)/g,
+    /export\s+(?:default\s+)?type\s+(\w+)/g,
+    /export\s+(?:default\s+)?enum\s+(\w+)/g,
+    /export\s+module\s+(\w+)/g,
+    /declare\s+function\s+(\w+)/g,
+    /declare\s+class\s+(\w+)/g,
+    /declare\s+interface\s+(\w+)/g,
+    /declare\s+const\s+(\w+)/g,
+    /declare\s+type\s+(\w+)/g,
+    /declare\s+enum\s+(\w+)/g,
+    // Bare declarations inside declare namespace / module blocks
+    /\bfunction\s+(\w+)\s*\(/g,
+    /\binterface\s+(\w+)\s*(?:\{|extends)/g,
+    /\benum\s+(\w+)\s*\{/g,
+    /\bclass\s+(\w+)\s*(?:\{|extends|implements)/g,
+    /\btype\s+(\w+)\s*=/g
+  ];
+  for (const pat of patterns) {
+    let m;
+    while ((m = pat.exec(stripped)) !== null) {
+      if (!symbols.includes(m[1])) {
+        symbols.push(m[1]);
+      }
+    }
+  }
+  const importNamedRe = /import\s+\{([^}]+)\}\s+from\s+/g;
+  let mImport;
+  while ((mImport = importNamedRe.exec(stripped)) !== null) {
+    for (const name of mImport[1].split(",")) {
+      const clean = name.trim().split(/\s+as\s+/)[0].trim();
+      if (clean && !symbols.includes(clean)) {
+        symbols.push(clean);
+      }
+    }
+  }
+  const importDefaultRe = /import\s+(\w+)\s+from\s+/g;
+  let mDef;
+  while ((mDef = importDefaultRe.exec(stripped)) !== null) {
+    const name = mDef[1];
+    if (!symbols.includes(name)) {
+      symbols.push(name);
+    }
+  }
+  const descMatch = content.match(
+    /\*\s*(?:@description\s+)?(Provides[^.]*\.)/s
+  );
+  let providesDesc = "";
+  if (descMatch) {
+    providesDesc = descMatch[1].replace(/\*\s*/g, "").replace(/\n/g, " ").trim().slice(0, 200);
+  }
+  if (!providesDesc) {
+    const gDesc = content.match(
+      /\*\s*@description\s+([\s\S]*?)\s*\*\s*\//s
+    );
+    if (gDesc) {
+      providesDesc = gDesc[1].replace(/\*\s*/g, "").replace(/\n/g, " ").trim().slice(0, 200);
+    }
+  }
+  const kitMatch = content.match(/\*\s*@kit\s+(\w+)/);
+  const kit = kitMatch ? kitMatch[1] : "";
+  const syscapMatch = content.match(
+    /\*\s*@syscap\s+SystemCapability\.([\w.]+)/
+  );
+  const syscap = syscapMatch ? syscapMatch[1] : "";
+  const parts = [moduleName];
+  if (kit && !moduleName.includes(kit)) parts.push(`Kit:${kit}`);
+  if (syscap) parts.push(syscap);
+  if (providesDesc) parts.push(providesDesc);
+  if (symbols.length > 0) {
+    parts.push(symbols.slice(0, 20).join(", "));
+  }
+  return {
+    summary: parts.join(" | "),
+    moduleName,
+    symbols: symbols.slice(0, 50)
+  };
+}
+async function buildSDKIndex(sdk_path) {
+  let allFiles = [];
+  for (const dir of SCAN_DIRS) {
+    const fullDir = join3(sdk_path, "default", dir);
+    log(`Scanning ${dir} ...`);
+    const files = await scanFiles(fullDir);
+    log(`  Found ${files.length} files`);
+    for (const f of files) {
+      allFiles.push({
+        absPath: f,
+        relPath: relative(fullDir, f),
+        sourceDir: dir
+      });
+    }
+  }
+  log(`Total files: ${allFiles.length}`);
+  const entries = [];
+  for (let i = 0; i < allFiles.length; i++) {
+    const { absPath, relPath, sourceDir } = allFiles[i];
+    const filename = basename(absPath);
+    try {
+      const content = await readFile3(absPath, "utf-8");
+      const { summary, moduleName, symbols } = extractSummary(
+        content,
+        filename,
+        relPath
+      );
+      entries.push({
+        id: String(i + 1),
+        summary,
+        path: absPath,
+        moduleName,
+        symbols
+      });
+    } catch {
+    }
+    if ((i + 1) % 500 === 0) {
+      log(`Processed ${i + 1}/${allFiles.length}`);
+    }
+  }
+  const outputPath = join3(import.meta.dirname, "sdk-index.json");
+  await writeFile(outputPath, JSON.stringify(entries, null, 2), "utf-8");
+  log(`Done! Wrote ${entries.length} entries to sdk-index.json`);
+  log(
+    `Sample entries:`,
+    entries.slice(0, 5).map((e) => e.moduleName)
+  );
+}
+
 // src/tools/skill-search/search-skill.ts
-var DEFAULT_SKILL_PATH = join3(homedir2(), ".config", "opencode", "skills", "harmonyos-atomic-dev");
 var cachedEntries = null;
 var cachedIndexableEntries = null;
 var cachedFilters = null;
 var cachedRetriever = null;
-function loadAndCache(resolvedPath) {
-  const raw = readFileSync(join3(resolvedPath, "index.json"), "utf-8");
+var cachedSdkEntries = null;
+var cachedSdkRetriever = null;
+async function loadAndCache(resolvedPath) {
+  const sdk_path = findSdkDir();
+  log("start load sdk cache", sdk_path);
+  if (sdk_path !== void 0) {
+    const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
+    if (!existsSync(sdkIndexPath)) {
+      log("sdk path is not exist, need to build");
+      await buildSDKIndex(sdk_path);
+    }
+    loadSdkIndex();
+    log("success to load sdk cache");
+  }
+  log("start load skill cache");
+  const raw = readFileSync(join4(resolvedPath, "index.json"), "utf-8");
   const entries = JSON.parse(raw);
   if (!Array.isArray(entries) || entries.length === 0) {
     return false;
@@ -28332,26 +28532,45 @@ function loadAndCache(resolvedPath) {
   const retriever = new HybridRetriever();
   retriever.addDocuments(documents, tokenizedDocs);
   cachedRetriever = retriever;
+  log("success to load sdk cache");
   return true;
 }
-function searchSkill(skill_path, query, topK = 5) {
-  const resolvedPath = skill_path?.trim() || DEFAULT_SKILL_PATH;
+function loadSdkIndex() {
+  if (cachedSdkRetriever) return true;
+  const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
+  if (!existsSync(sdkIndexPath)) return false;
+  try {
+    const raw = readFileSync(sdkIndexPath, "utf-8");
+    const entries = JSON.parse(raw);
+    if (!Array.isArray(entries) || entries.length === 0) return false;
+    cachedSdkEntries = entries;
+    const documents = entries.map((e) => e.summary);
+    const tokenizedDocs = documents.map((d) => tokenize(d));
+    const retriever = new BM25Retriever();
+    retriever.addDocuments(documents, tokenizedDocs);
+    cachedSdkRetriever = retriever;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function searchSkill(skill_path, query, topK = 3) {
   if (!cachedEntries) {
     try {
-      if (!loadAndCache(resolvedPath)) return [];
+      if (!await loadAndCache(skill_path?.trim())) return [];
     } catch {
       return [];
     }
   }
+  const prefix = skill_path.replace(/[\/\\]+$/, "");
   const preFiltered = [];
   for (const [category, entry] of cachedFilters) {
     const idx = query.toLowerCase().indexOf(category);
     if (idx !== -1) {
       preFiltered.push({
         ets_file_path: "",
-        experience_file_path: entry.path,
-        summary: entry.summary,
-        range: 0
+        experience_file_path: join4(prefix, entry.path),
+        sdk_file_path: ""
       });
       query = (query.slice(0, idx) + query.slice(idx + category.length)).trim();
     }
@@ -28359,23 +28578,42 @@ function searchSkill(skill_path, query, topK = 5) {
   if (!query) {
     return preFiltered;
   }
+  const MIN_SCORE = 0.01;
+  const sdkResults = loadSdkIndex() ? cachedSdkRetriever.search(query, topK).filter((r) => r.score >= MIN_SCORE).map((r) => ({
+    ets_file_path: "",
+    experience_file_path: "",
+    sdk_file_path: cachedSdkEntries[r.index].path
+  })) : [];
   const searchResults = cachedRetriever.search(query, topK);
-  const MIN_SCORE = 2e-3;
   const filtered = searchResults.filter((r) => r.score >= MIN_SCORE);
-  if (filtered.length === 0) return preFiltered;
-  return [...preFiltered, ...convert_search_result(filtered)];
+  const skillResults = filtered.length > 0 ? aggregateByExperience(convert_search_result(filtered, prefix)) : [];
+  return [...preFiltered, ...skillResults, ...sdkResults];
+}
+function aggregateByExperience(results) {
+  const map3 = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    const key = r.experience_file_path || r.ets_file_path;
+    const existing = map3.get(key);
+    if (existing) {
+      if (r.ets_file_path) {
+        existing.ets_file_path = existing.ets_file_path ? existing.ets_file_path + "\n" + r.ets_file_path : r.ets_file_path;
+      }
+    } else {
+      map3.set(key, { ...r });
+    }
+  }
+  return [...map3.values()];
 }
-function convert_search_result(searchResults) {
+function convert_search_result(searchResults, prefix) {
   return searchResults.map((result, rank) => {
     const entry = cachedIndexableEntries[result.index];
     const experience = cachedEntries.find(
       (e) => e.type === "experience" && e.category === entry.category
     );
     return {
-      ets_file_path: entry.path,
-      experience_file_path: experience?.path ?? "",
-      summary: entry.summary,
-      range: rank + 1
+      ets_file_path: join4(prefix, entry.path),
+      experience_file_path: experience?.path ? join4(prefix, experience.path) : "",
+      sdk_file_path: ""
     };
   });
 }
@@ -28383,19 +28621,27 @@ function convert_search_result(searchResults) {
 // src/tools/skill-search/skill-search-tool.ts
 function skillSearchTool(managers) {
   return tool({
-    description: "Search for relevant documents within the harmonyos-atomic-dev skill directory by keywords. Returns the top K most relevant document snippets from the skill directory, ranked by keyword match frequency. Use this tool instead of Glob/Grep when you need to find specific knowledge or documentation within harmonyos-atomic-dev skill. It scans all files under the given skill_path and returns the most relevant matches based on your query keywords. The results include ets_file_path (path to the ETS code examples), experience_file_path (path to the matching experience document best practices), summary (document summary), and range (relevance rank 1 = most relevant)\u3002",
+    description: "Search for relevant documents within the harmonyos-atomic-dev skill directory by keywords. Returns the top K most relevant document snippets from the skill directory, ranked by keyword match frequency. Use this tool instead of Glob/Grep when you need to find specific knowledge or documentation within harmonyos-atomic-dev skill. The results include experience_file_path (path to the matching experience document best practices) and ets_file_path (path to the ETS code examples and SDK API file). IMPORTANT: Each scenario only supports ONE tool call. Do NOT call this tool multiple times.",
     args: {
-      skill_path: tool.schema.string("Absolute path to the skill directory to search within. Default path may not contains harmonyos-atomic-dev skill").default(join4(homedir3(), ".config", "opencode", "skills", "harmonyos-atomic-dev")),
-      query: tool.schema.string("A decomposed requirement or intent describing what you want to find, broken down into searchable keywords separated by spaces."),
-      topK: tool.schema.number("Maximum number of top-ranked documents to return. Actual results may be fewer depending on query relevance.").min(1).max(5).default(5)
+      skill_path: tool.schema.string("Absolute path to the harmonyos-atomic-dev skill directory. IMPORTANT: this path should not contain any prefix or suffix like 'file://' or 'SKILL.md'."),
+      query: tool.schema.string("A decomposed requirement or intent describing what you want to find, broken down into searchable keywords separated by spaces. QUERY TIPS: For best results, decompose your intent into short space-separated keywords instead of long sentences. Include: 1) Kit or component name (e.g. ScanKit, AdsKit, ShareKit), 2) specific API or method names (e.g. scanBarcode, loadAd, ShareController), 3) feature keywords (e.g. \u626B\u7801, \u5E7F\u544A\u52A0\u8F7D, \u5206\u4EAB). Example: 'ScanKit \u626B\u7801 scanBarcode startScanForResult' instead of '\u5E2E\u6211\u5B9E\u73B0\u4E00\u4E2A\u626B\u7801\u529F\u80FD'. "),
+      topK: tool.schema.number("Maximum number of top-ranked documents to return. Actual results may be fewer depending on query relevance.").min(1).max(3).default(3)
     },
     execute: async (args, context) => {
       try {
-        const results = searchSkill(args.skill_path, args.query, args.topK);
+        const results = await searchSkill(args.skill_path, args.query, args.topK);
         if (results.length === 0) {
           return "No relative items found in the skill directory.";
         }
-        return JSON.stringify(results, null, 2);
+        const sdkInfo = results.map((r) => {
+          const parts = [];
+          if (r.experience_file_path) parts.push(`experience path ${r.experience_file_path}`);
+          if (r.ets_file_path) parts.push(`sample code path ${r.ets_file_path}`);
+          if (r.sdk_file_path) parts.push(`sdk info path ${r.sdk_file_path}`);
+          return parts.join("\n");
+        }).join("\n\n");
+        return `You can read the following files as needed to obtain information. 
+ ${sdkInfo}`;
       } catch (e) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
@@ -28427,7 +28673,7 @@ function createTools(args) {
 }
 
 // src/hooks/tool-hooks.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 
 // node_modules/diff/lib/index.mjs
 function Diff() {
@@ -29012,7 +29258,7 @@ function createToolHooks(sessionManager, projectDir) {
         if (input.tool === "write") {
           const filePath = output.args?.filePath;
           if (filePath) {
-            const oldContent = await readFile3(filePath, "utf-8").catch(() => "");
+            const oldContent = await readFile4(filePath, "utf-8").catch(() => "");
             writeContentCache.set(input.callID, oldContent);
           }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@harmonyos-arkts/opencode-plugin",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "HarmonyOS Full-Lifecycle Development Assistant. Specialized in the complete development lifecycle of HarmonyOS applications, including project creation, UI development, state management, network requests, data storage, permission requests, performance optimization, testing, and release.",
   "type": "module",
   "license": "MIT",
@@ -48,4 +48,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}