android2harmony 0.1.0 → 0.1.2

package/agents/code-reviewer.md

@@ -46,7 +46,7 @@ Before starting the review, extract the code context for the commit by running t
    - `--commit`: the git commit to analyze — diffs against its first parent.
    - `--mode default`: builds the full call graph for call-chain context.
    - **Timeout (required).** Building the full call graph can hang or run very long on large projects, and the first `npx` run also has to download the package — so always cap this command. When you invoke it via the Bash tool, pass an explicit `timeout` of **600000** ms (10 minutes). Do **not** rely on the tool's implicit default. If the command exceeds this limit and is killed, treat it exactly like a failure and take the fallback in step 3.
-   - **SDK paths** are resolved by ArkAnalysis itself along the standard chain — `OHOS_SDK_PATH` / `HMS_SDK_PATH` from the OS environment, then `env.OHOS_SDK_PATH` / `env.HMS_SDK_PATH` in `~/.arkanalysis/config.json` (or `~/.hometrans/config.json` as an interop fallback) — so you normally pass nothing. Only if it exits with an error saying the SDK paths were not found, resolve them yourself and pass `--ohos-sdk "<...>/default/openharmony/ets"` and `--hms-sdk "<...>/default/hms/ets"` (deriving from `DEVECO_SDK_HOME` if set), or suggest the user run `ht init` to persist them.
+   - **SDK paths** are resolved by ArkAnalysis itself from the OS environment — `OHOS_SDK_PATH` / `HMS_SDK_PATH` — so you normally pass nothing. Only if it exits with an error saying the SDK paths were not found, resolve them yourself and pass `--ohos-sdk "<...>/default/openharmony/ets"` and `--hms-sdk "<...>/default/hms/ets"` (deriving from `DEVECO_SDK_HOME` if set), or ask the user for the SDK root and suggest they set `OHOS_SDK_PATH` / `HMS_SDK_PATH` (or `DEVECO_SDK_HOME`) as machine environment variables.
 
 2. **On success** — it prints a JSON array to stdout: one entry per affected file (`{ path, kind, ranges?, resourceNames? }`). Build the **code context** from it as follows, reading only what the output points at — **do not read whole files**:
 
@@ -71,7 +71,7 @@ Before starting the review, extract the code context for the commit by running t
    - If `test_case_path` is not provided, use `<output_path>/test_case.md`
 
 1. **Read the code context** (from Step 0):
-   - Parse the code context produced by ArkAnalysis (`npx arkanalysis`) (or the manually assembled fallback)
+   - Parse the code context produced by ArkAnalysis (`npx --yes arkanalysis`) (or the manually assembled fallback)
    - This contains the diff and relevant code context for commit `commit_id`
    - Understand the scope of changes: which files were modified, added, or deleted
    - Build a map of the changed code areas — these are the primary focus of the review
@@ -182,7 +182,7 @@ Sort all defects into this fix order:
 5. **PARTIAL scenarios** — in report order
 6. **Cross-cutting: State management** and other quality issues — lowest priority
 
-**Maximum 2 effective attempts** per defect (an effective attempt = code was modified AND compiles successfully; build-fixer iterations to clear compile errors do NOT count as an attempt).
+**Maximum 2 effective attempts** per defect (an effective attempt = code was modified AND compiles successfully; compile-fix retries inside `hmos-fix-build-errors` do NOT count as an attempt).
 
 ### 5b. Fix strategies
 
@@ -192,16 +192,14 @@ Apply the strategy that matches the defect category.
 
 **When**: `module.json5` is missing a required permission.
 
-1. **Verify the permission name is valid** — use WebSearch to search `HarmonyOS ohos.permission.<name> API reference` and confirm the permission exists in the SDK.
+1. **Verify the permission name is valid** — first use `npx --yes devecocli docs search` / `npx --yes devecocli docs read` to confirm the permission exists in the HarmonyOS docs; fall back to WebSearch only if the local docs flow does not surface the needed reference.
 2. Read `module.json5` and locate the `requestPermissions` array (create it if absent).
 3. Add the missing permission entry:
    ```json
-   { "name": "ohos.permission.XXX" }
-   ```
 4. If the feature requires **runtime permission** (e.g., camera, location, media), also add the runtime request code:
    - Search the Android source (if available) to see how the permission is requested.
    - Add `abilityAccessCtrl.createAtManager().requestPermissionsFromUser()` in the appropriate lifecycle (`onWindowStageCreate` or `aboutToAppear`).
-   - Use Context7 MCP tool or WebSearch to confirm the correct API usage.
+   - Prefer `npx --yes devecocli docs search` / `npx --yes devecocli docs read` for the HarmonyOS API reference, then fall back to WebSearch if the local docs are insufficient.
 
 #### Page/Component Creation
 
@@ -210,7 +208,7 @@ Apply the strategy that matches the defect category.
 1. **Read the Android source** (if `android_project_dir` is provided):
    - Find the corresponding Android Activity/Fragment/View.
    - Document: layout structure, event handlers, data sources, navigation targets.
-2. **Use Context7 MCP tool** to look up the HarmonyOS equivalent UI components (e.g., `Grid` for `RecyclerView`, `List` for `ListView`).
+2. **Use `npx --yes devecocli docs search` / `npx --yes devecocli docs read` first** to look up the HarmonyOS equivalent UI components (e.g., `Grid` for `RecyclerView`, `List` for `ListView`). Fall back to WebSearch only when the local docs flow is insufficient.
 3. **Create the page file** under `entry/src/main/ets/pages/`:
    - Implement a **minimal viable page**: basic UI structure + essential state variables + placeholder data.
    - Do NOT attempt to implement all business logic — focus on making the scenario's happy path work.
@@ -223,8 +221,8 @@ Apply the strategy that matches the defect category.
 
 1. **Identify the correct API**:
    - If Android source is available, find the corresponding Android API call and determine the HarmonyOS equivalent.
-   - Use Context7 MCP tool to search for `HarmonyOS <API name>` documentation.
-   - Use WebSearch as fallback: search `@ohos.<module> API 用法` or `HarmonyOS ArkTS <feature> example`.
+   - Prefer `npx --yes devecocli docs search` / `npx --yes devecocli docs read` for HarmonyOS API documentation.
+   - Use WebSearch as fallback when the local docs flow does not provide enough detail.
 2. **Do NOT guess API signatures** — always verify import path, function name, parameter types, and return type from documentation.
 3. Add the import statement and the API call in the correct location.
 
@@ -274,7 +272,7 @@ Apply the strategy that matches the defect category.
    - **V1**: `@State` on a non-primitive without `@Observed` on the class; `@Link` without a `$variable` binding from the parent; missing `@Watch` when a side-effect is needed on state change; `@Observed` class property used in UI but missing `@Track`.
    - **V2**: `@ObservedV2` class property observed in UI but missing `@Trace` (both must be used together — either alone is inert); `@Param` mutated inside the child (it is input-only — emit changes via `@Event`); `@Local` expected to receive external input (use `@Param` instead).
    - **Mixing**: V1 and V2 decorators in the same component (e.g. `@Local` inside `@Component`, or `@State` inside `@ComponentV2`) — align to the detected paradigm.
-3. Use Context7 MCP tool to verify the correct decorator combination if unsure.
+3. Use `npx --yes devecocli docs search` / `npx --yes devecocli docs read` first to verify the correct decorator combination if unsure. Fall back to WebSearch only when the local docs are insufficient.
 
 ---
 
@@ -282,10 +280,10 @@ Apply the strategy that matches the defect category.
 
 After completing fixes for a group of related defects (e.g., all defects in one scenario, or all permission defects), verify the project still compiles:
 
-1. Launch the **build-fixer** agent with `harmony_project_dir` and `output_path`.
-2. If compilation fails, the build-fixer agent will auto-fix compile errors — this does **not** count as an effective attempt.
+1. Invoke the `hmos-fix-build-errors` skill with the current HarmonyOS project path.
+2. If compilation fails, let `hmos-fix-build-errors` handle the compile-error fix loop — these retries do **not** count as an effective attempt.
 3. If compilation succeeds, proceed to the next group of defects.
-4. If compilation cannot be fixed after build-fixer's attempts, **revert the most recent changes** for that group and record the defect as "failed to fix — compilation error".
+4. If compilation still cannot be fixed after the build-fix skill completes, **revert the most recent changes** for that group and record the defect as "failed to fix — compilation error".
 
 ---
 
@@ -302,7 +300,7 @@ Write the merged review + fix report to `<output_path>/code-review-report.md` wi
 - **Commit ID**: <commit_id>
 - **Scenario Doc**: <test_case_path>
 - **Android Source**: <android_project_dir or "not provided">
-- **Code Context**: ArkAnalysis (npx arkanalysis) (or git-diff fallback)
+- **Code Context**: ArkAnalysis (npx --yes arkanalysis) (or git-diff fallback)
 - **Review Date**: <date>
 - **Total Scenarios**: <N>
 - **Scenario Results**: <X> PASS | <Y> PARTIAL | <Z> FAIL | <W> UNABLE TO VERIFY
@@ -341,7 +339,7 @@ Write the merged review + fix report to `<output_path>/code-review-report.md` wi
 - Android Reference: <description, if `android_project_dir` was used>
 - Files Modified:
   - `<file path>`: <what was changed>
-- API Documentation Used: <Context7 query or WebSearch query, if used>
+- API Documentation Used: <npx --yes devecocli docs query/doc title or WebSearch query, if used>
 - Compilation: PASS / FAIL
 - Notes: <caveats, follow-up needed>
 
@@ -466,7 +464,8 @@ Total defects: {T}, Fixed: {A}, Failed: {B}
 - **Be fair**: If the code works for a scenario, give it PASS — don't nitpick style in a scenario review.
 - **Derive implicit scenarios**: If the scenario document describes architecture (pages, modules, data flows) rather than explicit user stories, derive the scenarios yourself.
 - **No re-verification**: You found the defects; do not launch a second verification pass before fixing. Trust your own findings.
-- **Look up before you guess**: Use Context7 MCP tool or WebSearch to verify HarmonyOS API usage, parameter types, and patterns. Do not assume API signatures.
+- **Look up before you guess**: Prefer `npx --yes devecocli docs search` / `npx --yes devecocli docs read` for HarmonyOS API usage, parameter types, and patterns. Fall back to WebSearch only when the local docs flow is insufficient. Do not assume API signatures.
+- **Use device logs for runtime-only clues**: When a scenario failure appears device-specific or cannot be closed statically, prefer `npx --yes devecocli log --level E` and `npx --yes devecocli log --crash --bundle-name <bundle>` before broader manual diagnosis.
 - **Read before you edit**: Always read a file before modifying it. Understand the surrounding context.
 - **Android as specification**: When available, treat the Android implementation as the ground truth for expected behavior.
 - **Minimal changes**: Only fix identified defects. Do not refactor, add comments to unrelated code, or "improve" working code.

package/agents/scripts/hmos-precheck/index.mjs

@@ -49,9 +49,6 @@ function defaultUserConfigPath() {
   const xdg = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
   return path.join(xdg, "hmos-precheck", USER_CONFIG_BASENAME);
 }
-function defaultHomeTransConfigPath() {
-  return path.join(os.homedir(), ".hometrans", "config.json");
-}
 function commandlineToolsHelp() {
   return "Run `hmos-precheck init --scope user --commandline-tools /abs/path/to/command-line-tools`, or pass `--commandline-tools`.";
 }
@@ -135,10 +132,6 @@ async function resolveCommandlineToolsInfo(options) {
     const projectResult = await wrap(typeof value === "string" ? value : null, "project_config");
     if (projectResult) return projectResult;
   }
-  const homeTransConfig = await loadJson(defaultHomeTransConfigPath());
-  const homeTransValue = isObject(homeTransConfig?.env) ? homeTransConfig.env.DEVECO_SDK_HOME : void 0;
-  const homeTransResult = await wrap(typeof homeTransValue === "string" ? homeTransValue : null, "hometrans_config");
-  if (homeTransResult) return homeTransResult;
   const userConfig = await loadJson(options.userConfigPath ?? defaultUserConfigPath());
   const userValue = isObject(userConfig?.toolchain) ? userConfig.toolchain.commandline_tools : void 0;
   const userResult = await wrap(typeof userValue === "string" ? userValue : null, "user_config");
@@ -837,7 +830,6 @@ async function cmdDoctor(argv) {
     },
     config_paths: {
       project: projectRoot ? path.join(projectRoot, PROJECT_CONFIG_NAME) : null,
-      hometrans: defaultHomeTransConfigPath(),
       user: defaultUserConfigPath()
     },
     profiles: {

package/dist/index.js

@@ -20,67 +20,16 @@ function parseFrontmatter(content) {
   const match = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
   if (!match) return null;
   const lines = match[1].split(/\r?\n/);
-  let name = null;
-  let hidden = false;
-  let inMetadata = false;
-  let metadataIndent = -1;
   for (const line of lines) {
     if (!line.trim() || line.trim().startsWith("#")) continue;
-    const indent = line.length - line.trimStart().length;
-    const trimmed = line.trim();
-    const kv = trimmed.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
-    if (indent === 0) {
-      inMetadata = false;
-      if (!kv) continue;
-      const value = kv[2].trim();
-      if (kv[1] === "name") {
-        name = value.replace(/^["']|["']$/g, "");
-      } else if (kv[1] === "metadata") {
-        if (value === "") {
-          inMetadata = true;
-          metadataIndent = -1;
-        } else if (/visible\s*:\s*false/.test(value)) {
-          hidden = true;
-        }
-      }
-    } else if (inMetadata) {
-      if (metadataIndent === -1) metadataIndent = indent;
-      if (indent < metadataIndent) {
-        inMetadata = false;
-        continue;
-      }
-      if (kv && kv[1] === "visible" && kv[2].trim() === "false") {
-        hidden = true;
-      }
+    if (line.length - line.trimStart().length !== 0) continue;
+    const kv = line.trim().match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
+    if (!kv) continue;
+    if (kv[1] === "name") {
+      return kv[2].trim().replace(/^["']|["']$/g, "");
     }
   }
-  return name ? { name, hidden } : null;
-}
-function discoverA2HSkills(skillsRoot) {
-  const hidden = [];
-  const all = [];
-  let entries;
-  try {
-    entries = fs.readdirSync(skillsRoot, { withFileTypes: true });
-  } catch {
-    return { hidden, all };
-  }
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const skillFile = path2.join(skillsRoot, entry.name, "SKILL.md");
-    let raw;
-    try {
-      raw = fs.readFileSync(skillFile, "utf-8");
-    } catch {
-      continue;
-    }
-    const info = parseFrontmatter(raw);
-    if (info) {
-      all.push(info.name);
-      if (info.hidden) hidden.push(info.name);
-    }
-  }
-  return { hidden, all };
+  return null;
 }
 function discoverA2HAgents(agentsRoot) {
   const result = /* @__PURE__ */ new Map();
@@ -99,9 +48,9 @@ function discoverA2HAgents(agentsRoot) {
     } catch {
       continue;
     }
-    const info = parseFrontmatter(raw);
-    if (!info) continue;
-    result.set(info.name, stripFrontmatter(raw));
+    const name = parseFrontmatter(raw);
+    if (!name) continue;
+    result.set(name, stripFrontmatter(raw));
   }
   return result;
 }
@@ -131,7 +80,7 @@ function createServer(deps) {
       dispose: async () => {
         agentPrompts.clear();
       },
-      // ── config hook: register skills search paths, hidden skills, and agents ──
+      // ── config hook: register skills search paths and agents ──
       config: async (cfg) => {
         const skills = cfg.skills || {};
         cfg.skills = skills;
@@ -140,15 +89,6 @@ function createServer(deps) {
         if (!paths.includes(skillsRoot)) {
           paths.push(skillsRoot);
         }
-        const { hidden: a2hHidden, all: a2hAll } = discoverA2HSkills(skillsRoot);
-        const currentHidden = skills.hidden || [];
-        const cleaned = currentHidden.filter((name) => !a2hAll.includes(name));
-        for (const name of a2hHidden) {
-          if (!cleaned.includes(name)) {
-            cleaned.push(name);
-          }
-        }
-        skills.hidden = cleaned;
         const agent = cfg.agent || {};
         cfg.agent = agent;
         for (const [name, prompt] of agentPrompts) {

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts", "../src/paths.ts", "../src/discovery.ts", "../src/env.ts"],
-  "sourcesContent": ["import path from \"node:path\"\r\nimport type { A2HHostDeps, Plugin, PluginInput, PluginHooks } from \"./types\"\r\nimport { PKG_ROOT } from \"./paths\"\r\nimport { discoverA2HAgents, discoverA2HSkills } from \"./discovery\"\r\nimport { buildA2HEnvBase } from \"./env\"\r\n\r\n// Public re-exports \u2014 the package's external surface (dev eco code loads\r\n// dist/index.js at runtime and calls `createServer`; `A2HHostDeps` /\r\n// `PLUGIN_ID` are kept exported for any TS consumers).\r\nexport type { A2HHostDeps } from \"./types\"\r\nexport { PLUGIN_ID } from \"./paths\"\r\n\r\n/**\r\n * Create the A2H DevEco Code plugin.\r\n *\r\n * This is a self-contained plugin - skills/, agents/, and tools/\r\n * are bundled inside the package, NOT referenced from HomeTrans.\r\n * A2H-Plugin is the independently publishable \"plugin edition\" of HomeTrans.\r\n *\r\n * @param deps - host dependencies injected by DevEco Code's thin bridge.\r\n *   The A2H Plugin defines what it needs (A2HHostDeps);\r\n *   DevEco Code provides how to resolve it.\r\n * @returns A Plugin function ready to be registered as a built-in plugin.\r\n */\r\nexport function createServer(deps: A2HHostDeps): Plugin {\r\n  return async (input: PluginInput): Promise<PluginHooks> => {\r\n    // All A2H assets live inside this package (self-contained, no HomeTrans dep)\r\n    const skillsRoot = path.join(PKG_ROOT, \"skills\")\r\n    const agentsRoot = path.join(PKG_ROOT, \"agents\")\r\n\r\n    // Auto-discover agents: scan top-level agents/*.md, parse `name:` from\r\n    // frontmatter, strip frontmatter for prompt body. Adding/removing/renaming\r\n    // an agent is just a file drop \u2014 no code change, no rebuild.\r\n    const agentPrompts = discoverA2HAgents(agentsRoot)\r\n\r\n    return {\r\n      dispose: async () => {\r\n        agentPrompts.clear()\r\n      },\r\n\r\n      // \u2500\u2500 config hook: register skills search paths, hidden skills, and agents \u2500\u2500\r\n      config: async (cfg: Record<string, unknown>) => {\r\n        // --- Skills ---\r\n        const skills = (cfg.skills as Record<string, unknown>) || {}\r\n        cfg.skills = skills\r\n        \r\n\r\n        // Register the bundled skills/ directory as an additional search path\r\n        const paths = (skills.paths as string[]) || []\r\n        skills.paths = paths\r\n        if (!paths.includes(skillsRoot)) {\r\n          paths.push(skillsRoot)\r\n        }\r\n\r\n        // Manage hidden skill names, discovered from each SKILL.md's\r\n        // metadata.visible: false frontmatter. DevEco Code's available()\r\n        // filters these out of the user-facing /skills menu; get()/require()\r\n        // still resolve them so other skills can invoke them by name.\r\n        //\r\n        // We fully manage A2H entries in the hidden list: stale entries from\r\n        // skills that are renamed, removed, or changed to visible are cleaned\r\n        // up, while non-A2H entries (from other plugins) are left untouched.\r\n        const { hidden: a2hHidden, all: a2hAll } = discoverA2HSkills(skillsRoot)\r\n        const currentHidden = (skills.hidden as string[]) || []\r\n        // Remove any A2H-managed skills that are no longer hidden / no longer exist\r\n        const cleaned = currentHidden.filter((name) => !a2hAll.includes(name))\r\n        // Add currently-hidden A2H skills\r\n        for (const name of a2hHidden) {\r\n          if (!cleaned.includes(name)) {\r\n            cleaned.push(name)\r\n          }\r\n        }\r\n        skills.hidden = cleaned\r\n\r\n        // --- Agents ---\r\n        const agent = (cfg.agent as Record<string, Record<string, unknown>>) || {}\r\n        cfg.agent = agent\r\n\r\n        for (const [name, prompt] of agentPrompts) {\r\n          // Don't overwrite if the user already configured this agent\r\n          if (!agent[name]) {\r\n            agent[name] = {\r\n              mode: \"subagent\",\r\n              hidden: true,\r\n              prompt,\r\n            }\r\n          }\r\n        }\r\n\r\n      },\r\n\r\n      // \u2500\u2500 shell.env hook: inject DevEco Studio paths as env vars \u2500\u2500\r\n      // NOTE: deliberately uses the *base* env \u2014 the multimodal model apiKey\r\n      // is NOT injected into LLM shell sessions (would leak into every command\r\n      // and the transcript).\r\n      \"shell.env\": async (\r\n        shellInput: { cwd: string; sessionID?: string; callID?: string },\r\n        output: { env: Record<string, string> },\r\n      ) => {\r\n        const a2hEnv = await buildA2HEnvBase(deps)\r\n        Object.assign(output.env, a2hEnv)\r\n      },\r\n    }\r\n  }\r\n}\r\n", "import path from \"node:path\"\r\nimport { fileURLToPath } from \"node:url\"\r\n\r\n// Resolve package root (one directory above dist/ or src/). Computed once here\r\n// and imported everywhere else so there's a single source of truth. After\r\n// esbuild bundling, import.meta.url points at dist/index.js, so this still\r\n// resolves to the package root at runtime.\r\nconst __filename = fileURLToPath(import.meta.url)\r\nconst __dirname = path.dirname(__filename)\r\n\r\n/** Absolute path to the A2H-Plugin package root. */\r\nexport const PKG_ROOT = path.resolve(__dirname, \"..\")\r\n\r\n/** Public plugin id. */\r\nexport const PLUGIN_ID = \"android2harmony\"\r\n", "import path from \"node:path\"\r\nimport fs from \"node:fs\"\r\n\r\n/**\r\n * Strip YAML frontmatter (--- ... ---) from agent .md files.\r\n * Agent .md files have metadata in frontmatter; only the body\r\n * should be used as the LLM prompt.\r\n */\r\nexport function stripFrontmatter(content: string): string {\r\n  const match = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---\\s*\\n/)\r\n  return match ? content.slice(match[0].length).trim() : content\r\n}\r\n\r\n/**\r\n * Minimal YAML frontmatter extractor for A2H-owned `.md` files (SKILL.md\r\n * and agent `.md`). A2H controls the frontmatter format, so we only need\r\n * two values: the top-level `name` (a scalar) and whether `metadata.visible`\r\n * is false. This avoids pulling a YAML dependency into the plugin.\r\n *\r\n * Returns `{ name, hidden }` or null when the file has no usable frontmatter\r\n * (e.g. a README dropped into a directory that's also scanned for agents).\r\n */\r\nexport function parseFrontmatter(content: string): { name: string; hidden: boolean } | null {\r\n  const match = content.match(/^---\\s*\\r?\\n([\\s\\S]*?)\\r?\\n---/)\r\n  if (!match) return null\r\n  const lines = match[1].split(/\\r?\\n/)\r\n\r\n  let name: string | null = null\r\n  let hidden = false\r\n  let inMetadata = false\r\n  let metadataIndent = -1\r\n\r\n  for (const line of lines) {\r\n    if (!line.trim() || line.trim().startsWith(\"#\")) continue\r\n\r\n    const indent = line.length - line.trimStart().length\r\n    const trimmed = line.trim()\r\n    const kv = trimmed.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\\s*(.*)$/)\r\n\r\n    if (indent === 0) {\r\n      inMetadata = false\r\n      if (!kv) continue\r\n      const value = kv[2].trim()\r\n      if (kv[1] === \"name\") {\r\n        name = value.replace(/^[\"']|[\"']$/g, \"\")\r\n      } else if (kv[1] === \"metadata\") {\r\n        if (value === \"\") {\r\n          // Block-style metadata: following indented lines belong to it\r\n          inMetadata = true\r\n          metadataIndent = -1\r\n        } else if (/visible\\s*:\\s*false/.test(value)) {\r\n          // Inline/flow-style metadata: metadata: { visible: false }\r\n          hidden = true\r\n        }\r\n      }\r\n    } else if (inMetadata) {\r\n      if (metadataIndent === -1) metadataIndent = indent\r\n      if (indent < metadataIndent) {\r\n        inMetadata = false\r\n        continue\r\n      }\r\n      if (kv && kv[1] === \"visible\" && kv[2].trim() === \"false\") {\r\n        hidden = true\r\n      }\r\n    }\r\n  }\r\n\r\n  return name ? { name, hidden } : null\r\n}\r\n\r\n/**\r\n * Scan the bundled skills/ directory and return A2H skill visibility info.\r\n *\r\n * Returns two lists:\r\n * - `hidden`: names of skills whose SKILL.md frontmatter declares metadata.visible: false\r\n * - `all`: names of ALL A2H skill directories found (used to clean up stale hidden entries)\r\n *\r\n * Visibility lives with each skill definition (best practice): adding a new\r\n * hidden skill only needs a frontmatter edit, with no code change here. The\r\n * returned names are pushed into cfg.skills.hidden, which DevEco Code's\r\n * available() already filters on - while get()/require() still resolve\r\n * them so other skills can invoke them by name.\r\n */\r\nexport function discoverA2HSkills(skillsRoot: string): { hidden: string[]; all: string[] } {\r\n  const hidden: string[] = []\r\n  const all: string[] = []\r\n  let entries: fs.Dirent[]\r\n  try {\r\n    entries = fs.readdirSync(skillsRoot, { withFileTypes: true })\r\n  } catch {\r\n    return { hidden, all }\r\n  }\r\n  for (const entry of entries) {\r\n    if (!entry.isDirectory()) continue\r\n    const skillFile = path.join(skillsRoot, entry.name, \"SKILL.md\")\r\n    let raw: string\r\n    try {\r\n      raw = fs.readFileSync(skillFile, \"utf-8\")\r\n    } catch {\r\n      continue\r\n    }\r\n    const info = parseFrontmatter(raw)\r\n    if (info) {\r\n      all.push(info.name)\r\n      if (info.hidden) hidden.push(info.name)\r\n    }\r\n  }\r\n  return { hidden, all }\r\n}\r\n\r\n/**\r\n * Scan the bundled agents/ directory and return a `name \u2192 prompt body` map.\r\n *\r\n * Only top-level `.md` files are considered (subdirectories like `scripts/`\r\n * are skipped via `isFile()`). Files without a `name:` field in frontmatter\r\n * (e.g. a stray README) are silently skipped \u2014 the frontmatter name is the\r\n * source of truth, not the file basename. The body (frontmatter stripped)\r\n * becomes the LLM prompt.\r\n *\r\n * Adding a new agent is therefore a zero-code, zero-rebuild change: just\r\n * drop an `.md` with `name:` frontmatter into `agents/`.\r\n */\r\nexport function discoverA2HAgents(agentsRoot: string): Map<string, string> {\r\n  const result = new Map<string, string>()\r\n  let entries: fs.Dirent[]\r\n  try {\r\n    entries = fs.readdirSync(agentsRoot, { withFileTypes: true })\r\n  } catch {\r\n    return result\r\n  }\r\n  for (const entry of entries) {\r\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue\r\n    const file = path.join(agentsRoot, entry.name)\r\n    let raw: string\r\n    try {\r\n      raw = fs.readFileSync(file, \"utf-8\")\r\n    } catch {\r\n      continue\r\n    }\r\n    const info = parseFrontmatter(raw)\r\n    if (!info) continue  // not a valid agent file (no `name:` frontmatter)\r\n    result.set(info.name, stripFrontmatter(raw))\r\n  }\r\n  return result\r\n}\r\n", "import path from \"node:path\"\r\nimport type { A2HHostDeps } from \"./types\"\r\n\r\n/**\r\n * Build the A2H env var set from host-injected deps. Shared by the `shell.env`\r\n * hook (so every shell session sees these).\r\n * Env vars are the single source of truth in the plugin context.\r\n *\r\n * This base set contains NO secrets \u2014 only DevEco/SDK paths. The multimodal\r\n * model apiKey is intentionally NOT included: the `shell.env` hook uses this\r\n * base set so the key never leaks into every LLM shell command (and thus the\r\n * transcript).\r\n */\r\nexport async function buildA2HEnvBase(\r\n  deps: A2HHostDeps,\r\n): Promise<Record<string, string>> {\r\n  const env: Record<string, string> = {}\r\n\r\n  const home = await deps.resolveDevEcoHome()\r\n  if (home) {\r\n    const sdk = deps.resolveSdkPath(home)\r\n    env[\"DEVECO_HOME\"] = home\r\n    env[\"DEVECO_SDK_HOME\"] = sdk\r\n    env[\"OHOS_SDK_PATH\"] = path.join(sdk, \"default\", \"openharmony\", \"ets\")\r\n    env[\"HMS_SDK_PATH\"] = path.join(sdk, \"default\", \"hms\", \"ets\")\r\n  }\r\n\r\n  return env\r\n}\r\n"],
-  "mappings": "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",
+  "sourcesContent": ["import path from \"node:path\"\r\nimport type { A2HHostDeps, Plugin, PluginInput, PluginHooks } from \"./types\"\r\nimport { PKG_ROOT } from \"./paths\"\r\nimport { discoverA2HAgents } from \"./discovery\"\r\nimport { buildA2HEnvBase } from \"./env\"\r\n\r\n// Public re-exports \u2014 the package's external surface (dev eco code loads\r\n// dist/index.js at runtime and calls `createServer`; `A2HHostDeps` /\r\n// `PLUGIN_ID` are kept exported for any TS consumers).\r\nexport type { A2HHostDeps } from \"./types\"\r\nexport { PLUGIN_ID } from \"./paths\"\r\n\r\n/**\r\n * Create the A2H DevEco Code plugin.\r\n *\r\n * This is a self-contained plugin - skills/, agents/, and tools/\r\n * are bundled inside the package, NOT referenced from HomeTrans.\r\n * A2H-Plugin is the independently publishable \"plugin edition\" of HomeTrans.\r\n *\r\n * @param deps - host dependencies injected by DevEco Code's thin bridge.\r\n *   The A2H Plugin defines what it needs (A2HHostDeps);\r\n *   DevEco Code provides how to resolve it.\r\n * @returns A Plugin function ready to be registered as a built-in plugin.\r\n */\r\nexport function createServer(deps: A2HHostDeps): Plugin {\r\n  return async (input: PluginInput): Promise<PluginHooks> => {\r\n    // All A2H assets live inside this package (self-contained, no HomeTrans dep)\r\n    const skillsRoot = path.join(PKG_ROOT, \"skills\")\r\n    const agentsRoot = path.join(PKG_ROOT, \"agents\")\r\n\r\n    // Auto-discover agents: scan top-level agents/*.md, parse `name:` from\r\n    // frontmatter, strip frontmatter for prompt body. Adding/removing/renaming\r\n    // an agent is just a file drop \u2014 no code change, no rebuild.\r\n    const agentPrompts = discoverA2HAgents(agentsRoot)\r\n\r\n    return {\r\n      dispose: async () => {\r\n        agentPrompts.clear()\r\n      },\r\n\r\n      // \u2500\u2500 config hook: register skills search paths and agents \u2500\u2500\r\n      config: async (cfg: Record<string, unknown>) => {\r\n        // --- Skills ---\r\n        const skills = (cfg.skills as Record<string, unknown>) || {}\r\n        cfg.skills = skills\r\n\r\n        // Register the bundled skills/ directory as an additional search path.\r\n        // All bundled skills are user-visible \u2014 there is no partial-visibility\r\n        // (hidden) layer anymore, so we only register the search path here.\r\n        const paths = (skills.paths as string[]) || []\r\n        skills.paths = paths\r\n        if (!paths.includes(skillsRoot)) {\r\n          paths.push(skillsRoot)\r\n        }\r\n\r\n        // --- Agents ---\r\n        const agent = (cfg.agent as Record<string, Record<string, unknown>>) || {}\r\n        cfg.agent = agent\r\n\r\n        for (const [name, prompt] of agentPrompts) {\r\n          // Don't overwrite if the user already configured this agent\r\n          if (!agent[name]) {\r\n            agent[name] = {\r\n              mode: \"subagent\",\r\n              hidden: true,\r\n              prompt,\r\n            }\r\n          }\r\n        }\r\n\r\n      },\r\n\r\n      // \u2500\u2500 shell.env hook: inject DevEco Studio paths as env vars \u2500\u2500\r\n      // NOTE: deliberately uses the *base* env \u2014 the multimodal model apiKey\r\n      // is NOT injected into LLM shell sessions (would leak into every command\r\n      // and the transcript).\r\n      \"shell.env\": async (\r\n        shellInput: { cwd: string; sessionID?: string; callID?: string },\r\n        output: { env: Record<string, string> },\r\n      ) => {\r\n        const a2hEnv = await buildA2HEnvBase(deps)\r\n        Object.assign(output.env, a2hEnv)\r\n      },\r\n    }\r\n  }\r\n}\r\n", "import path from \"node:path\"\r\nimport { fileURLToPath } from \"node:url\"\r\n\r\n// Resolve package root (one directory above dist/ or src/). Computed once here\r\n// and imported everywhere else so there's a single source of truth. After\r\n// esbuild bundling, import.meta.url points at dist/index.js, so this still\r\n// resolves to the package root at runtime.\r\nconst __filename = fileURLToPath(import.meta.url)\r\nconst __dirname = path.dirname(__filename)\r\n\r\n/** Absolute path to the A2H-Plugin package root. */\r\nexport const PKG_ROOT = path.resolve(__dirname, \"..\")\r\n\r\n/** Public plugin id. */\r\nexport const PLUGIN_ID = \"android2harmony\"\r\n", "import path from \"node:path\"\r\nimport fs from \"node:fs\"\r\n\r\n/**\r\n * Strip YAML frontmatter (--- ... ---) from agent .md files.\r\n * Agent .md files have metadata in frontmatter; only the body\r\n * should be used as the LLM prompt.\r\n */\r\nexport function stripFrontmatter(content: string): string {\r\n  const match = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---\\s*\\n/)\r\n  return match ? content.slice(match[0].length).trim() : content\r\n}\r\n\r\n/**\r\n * Minimal YAML frontmatter extractor for A2H-owned `.md` files (SKILL.md\r\n * and agent `.md`). A2H controls the frontmatter format, so we only need\r\n * the top-level `name` (a scalar). This avoids pulling a YAML dependency\r\n * into the plugin.\r\n *\r\n * Returns the parsed `name`, or null when the file has no usable frontmatter\r\n * (e.g. a README dropped into a directory that's also scanned for agents).\r\n */\r\nexport function parseFrontmatter(content: string): string | null {\r\n  const match = content.match(/^---\\s*\\r?\\n([\\s\\S]*?)\\r?\\n---/)\r\n  if (!match) return null\r\n  const lines = match[1].split(/\\r?\\n/)\r\n\r\n  for (const line of lines) {\r\n    if (!line.trim() || line.trim().startsWith(\"#\")) continue\r\n    if (line.length - line.trimStart().length !== 0) continue // skip indented (e.g. metadata block) lines\r\n\r\n    const kv = line.trim().match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\\s*(.*)$/)\r\n    if (!kv) continue\r\n    if (kv[1] === \"name\") {\r\n      return kv[2].trim().replace(/^[\"']|[\"']$/g, \"\")\r\n    }\r\n  }\r\n\r\n  return null\r\n}\r\n\r\n/**\r\n * Scan the bundled agents/ directory and return a `name \u2192 prompt body` map.\r\n *\r\n * Only top-level `.md` files are considered (subdirectories like `scripts/`\r\n * are skipped via `isFile()`). Files without a `name:` field in frontmatter\r\n * (e.g. a stray README) are silently skipped \u2014 the frontmatter name is the\r\n * source of truth, not the file basename. The body (frontmatter stripped)\r\n * becomes the LLM prompt.\r\n *\r\n * Adding a new agent is therefore a zero-code, zero-rebuild change: just\r\n * drop an `.md` with `name:` frontmatter into `agents/`.\r\n */\r\nexport function discoverA2HAgents(agentsRoot: string): Map<string, string> {\r\n  const result = new Map<string, string>()\r\n  let entries: fs.Dirent[]\r\n  try {\r\n    entries = fs.readdirSync(agentsRoot, { withFileTypes: true })\r\n  } catch {\r\n    return result\r\n  }\r\n  for (const entry of entries) {\r\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue\r\n    const file = path.join(agentsRoot, entry.name)\r\n    let raw: string\r\n    try {\r\n      raw = fs.readFileSync(file, \"utf-8\")\r\n    } catch {\r\n      continue\r\n    }\r\n    const name = parseFrontmatter(raw)\r\n    if (!name) continue  // not a valid agent file (no `name:` frontmatter)\r\n    result.set(name, stripFrontmatter(raw))\r\n  }\r\n  return result\r\n}\r\n", "import path from \"node:path\"\r\nimport type { A2HHostDeps } from \"./types\"\r\n\r\n/**\r\n * Build the A2H env var set from host-injected deps. Shared by the `shell.env`\r\n * hook (so every shell session sees these).\r\n * Env vars are the single source of truth in the plugin context.\r\n *\r\n * This base set contains NO secrets \u2014 only DevEco/SDK paths. The multimodal\r\n * model apiKey is intentionally NOT included: the `shell.env` hook uses this\r\n * base set so the key never leaks into every LLM shell command (and thus the\r\n * transcript).\r\n */\r\nexport async function buildA2HEnvBase(\r\n  deps: A2HHostDeps,\r\n): Promise<Record<string, string>> {\r\n  const env: Record<string, string> = {}\r\n\r\n  const home = await deps.resolveDevEcoHome()\r\n  if (home) {\r\n    const sdk = deps.resolveSdkPath(home)\r\n    env[\"DEVECO_HOME\"] = home\r\n    env[\"DEVECO_SDK_HOME\"] = sdk\r\n    env[\"OHOS_SDK_PATH\"] = path.join(sdk, \"default\", \"openharmony\", \"ets\")\r\n    env[\"HMS_SDK_PATH\"] = path.join(sdk, \"default\", \"hms\", \"ets\")\r\n  }\r\n\r\n  return env\r\n}\r\n"],
+  "mappings": "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",
   "names": ["path", "path", "path", "path"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android2harmony",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A2H (Android-to-HarmonyOS) Plugin for DevEco Code — standalone plugin containing A2H skills, agents, and tools for converting Android apps to HarmonyOS",
   "type": "module",
   "license": "MIT",

package/skills/hmos-batch-ui-align/SKILL.md

@@ -9,13 +9,13 @@ Batch-convert a set of Android page snapshots (each snapshot is a `page_NNNN_Act
 
 ## Step 0 — Environment Variables Check (run first)
 
-The final build (Step 6, via `hmos_fix_build_errors`) resolves the DevEco location along the standard chain — **OS environment variable first, then `~/.hometrans/config.json`, then ask the user** (read env vars with `echo "$VAR"` on macOS/Linux; `$env:VAR` in PowerShell on Windows):
+The final build (Step 6, via `hmos_fix_build_errors`) resolves the DevEco location from the **OS environment variable** — then asks the user if unset (read env vars with `echo "$VAR"` on macOS/Linux; `$env:VAR` in PowerShell on Windows):
 
-| Variable | config.json fallback | Needed for | Valid when |
-|---|---|---|---|
-| `DEVECO_HOME` *(or `DEVECO_SDK_HOME`)* | `env.DEVECO_HOME` / `env.DEVECO_SDK_HOME` | Step 6 unified build | resolves to a valid DevEco install |
+| Variable | Needed for | Valid when |
+|---|---|---|
+| `DEVECO_SDK_HOME` | Step 6 unified build | resolves to a valid DevEco install (derive the install root as its parent dir) |
 
-If neither the env var nor `~/.hometrans/config.json` yields a valid DevEco install, **ask the user** for the DevEco Studio install path before proceeding (suggest running `ht init` to persist it as a machine environment variable).
+If the env var does not yield a valid DevEco install, **ask the user** for the DevEco Studio install path before proceeding (suggest setting `DEVECO_SDK_HOME` as a machine environment variable).
 
 ## Step 1 — Parse User Request
 

package/skills/hmos-batch-ui-align/references/mvvm-v2/!!/350/257/255/346/263/225/357/274/232/345/217/214/345/220/221/347/273/221/345/256/232.md

@@ -0,0 +1,206 @@
+在状态管理V1中，推荐使用[$$](../$$语法：系统组件双向同步/arkts-two-way-sync.md)实现系统组件的双向绑定。
+
+在状态管理V2中，推荐使用!!语法糖统一处理双向绑定。
+
+说明
+
+!!语法从API version 12开始支持。
+
+## 概述
+
+!!双向绑定语法，是一个语法糖方便开发者实现数据双向绑定，用于初始化子组件的[@Param](../../状态管理（V2）/管理组件拥有的状态/@Param：组件外部输入/arkts-new-param.md)和[@Event](../../状态管理（V2）/管理组件拥有的状态/@Event装饰器：规范组件输出/arkts-new-event.md)。其中@Event方法名需要声明为“$”+ @Param属性名，详见[使用场景](arkts-new-binding.md#使用场景)。
+
+* 如果使用了!!双向绑定语法，表明父组件的变化会同步给子组件，子组件的变化也会同步给父组件。
+* 父组件未使用!!时，变化是单向的。
+
+## 使用场景
+
+### 自定义组件间双向绑定
+
+1. 在Index中构造Star子组件，双向绑定父子组件中的value属性，并初始化子组件的@Param value和@Event $value。
+
+   @Param与@Event装饰器配合使用的双向绑定语法糖。
+
+   ```
+   1. Child({ value: this.value, $value: (val: number) => { this.value = val; } })
+   ```
+
+   [Binding\_Star\_Param\_Event.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20260402/ArkUISample/ArkUI_Binding/entry/src/main/ets/pages/Binding_Star_Param_Event.ets#L29-L31)
+
+   上述语法可以简化为!!双向绑定语法糖。
+
+   ```
+   1. Star({ value: this.value!! })
+   ```
+
+   [Binding\_Star.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20260402/ArkUISample/ArkUI_Binding/entry/src/main/ets/pages/Binding_Star.ets#L29-L31)
+2. 使用@Param value与@Event $value语法实现自定义组件双向绑定。
+
+   ```
+   1. @Entry
+   2. @ComponentV2
+   3. struct Parent {
+   4. @Local value: number = 0;
+
+   6. build() {
+   7. Column() {
+   8. Text(`${this.value}`)
+   9. // 点击Index中的Button改变value值，父组件Parent和子组件Child中的Text将同步更新。
+   10. Button(`change value in parent component`).onClick(() => {
+   11. this.value++;
+   12. })
+   13. // 使用@Param与@Event语法实现自定义组件双向绑定。
+   14. Child({ value: this.value, $value: (val: number) => { this.value = val; } })
+   15. // ...
+   16. // ···
+   17. }
+   18. }
+   19. }
+
+   21. @ComponentV2
+   22. struct Child {
+   23. @Param value: number = 0;
+   24. @Event $value: (val: number) => void = (val: number) => {};
+
+   26. build() {
+   27. Column() {
+   28. Text(`${this.value}`)
+   29. // 点击子组件Child中的Button，调用`this.$value(10)`方法，父组件Parent和子组件Child中的Text将同步更新。
+   30. Button(`change value in child component`).onClick(() => {
+   31. this.$value(10);
+   32. })
+   33. }
+   34. }
+   35. }
+   ```
+
+   [Binding\_Star\_Param\_Event.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20260402/ArkUISample/ArkUI_Binding/entry/src/main/ets/pages/Binding_Star_Param_Event.ets#L15-L55)
+3. 使用!!语法糖实现自定义组件双向绑定。
+
+   ```
+   1. @Entry
+   2. @ComponentV2
+   3. struct Index {
+   4. @Local value: number = 0;
+
+   6. build() {
+   7. Column() {
+   8. Text(`${this.value}`)
+   9. // 点击Index中的Button改变value值，父组件Index和子组件Star中的Text将同步更新。
+   10. Button(`change value in parent component`).onClick(() => {
+   11. this.value++;
+   12. })
+   13. // 使用!!语法糖实现自定义组件双向绑定。
+   14. Star({ value: this.value!! })
+   15. // ...
+   16. }
+   17. }
+   18. }
+
+   20. @ComponentV2
+   21. struct Star {
+   22. @Param value: number = 0;
+   23. @Event $value: (val: number) => void = (val: number) => {};
+
+   25. build() {
+   26. Column() {
+   27. Text(`${this.value}`)
+   28. // 点击子组件Star中的Button，调用`this.$value(10)`方法，父组件Index和子组件Star中的Text将同步更新。
+   29. Button(`change value in child component`).onClick(() => {
+   30. this.$value(10);
+   31. })
+   32. }
+   33. }
+   34. }
+   ```
+
+   [Binding\_Star.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20260402/ArkUISample/ArkUI_Binding/entry/src/main/ets/pages/Binding_Star.ets#L15-L54)
+
+**使用限制**
+
+* !!双向绑定语法不支持多层父子组件传递。
+* 不支持与@Event混用。从API version 18开始，当使用!!双向绑定语法给子组件传递参数时，给对应的@Event方法传参会编译报错。
+* 当使用3个或更多感叹号（!!!、!!!!、!!!!!等）时，不支持双向绑定功能。
+
+### 系统组件参数双向绑定
+
+!!运算符为系统组件提供TS变量的引用，使得TS变量和系统组件的内部状态保持同步。添加方式是在变量名后添加，例如isShow!!。
+
+内部状态的含义由组件决定。例如：[bindMenu](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/弹窗控制/菜单控制/ts-universal-attributes-menu.md#bindmenu11)组件的isShow参数。
+
+```
+1. import { hilog } from '@kit.PerformanceAnalysisKit';
+
+3. const TAG: string = 'click show Menu';
+4. const DOMAIN = 0xFF00;
+
+6. @Entry
+7. @ComponentV2
+8. struct BindMenuInterface {
+9. @Local isShow: boolean = false;
+
+11. build() {
+12. Column() {
+13. Row() {
+14. Text('click show Menu')
+15. .bindMenu(this.isShow!!, // 双向绑定。
+16. [
+17. {
+18. value: 'Menu1',
+19. action: () => {
+20. hilog.info(DOMAIN, TAG, 'handle Menu1 click');
+21. }
+22. },
+23. {
+24. value: 'Menu2',
+25. action: () => {
+26. hilog.info(DOMAIN, TAG, 'handle Menu2 click');
+27. }
+28. },
+29. ])
+30. }.height('50%')
+
+32. Text('isShow: ' + this.isShow).fontSize(18).fontColor(Color.Red)
+33. Row() {
+34. Button('Click')
+35. .onClick(() => {
+36. this.isShow = true;
+37. })
+38. .width(100)
+39. .fontSize(20)
+40. .margin(10)
+41. }
+42. }.width('100%')
+43. }
+44. }
+```
+
+[Sys\_Binding.ets](https://gitcode.com/HarmonyOS_Samples/guide-snippets/blob/HarmonyOS-feature-20260402/ArkUISample/ArkUI_Binding/entry/src/main/ets/pages/Sys_Binding.ets#L15-L59)
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/97/v3/cghdEOKRR3GXknTuMAuJpw/zh-cn_image_0000002622857453.gif?HW-CC-KV=V1&HW-CC-Date=20260611T062628Z&HW-CC-Expire=86400&HW-CC-Sign=AB1935492FA1375D091F97EB1B7D985568F2B08F7AF489056C217A437FD62AE8)
+
+**使用规则**
+
+* 当前!!双向绑定支持基础类型变量，当该变量使用[@State](../../状态管理（V1）/管理组件拥有的状态/@State装饰器：组件内状态/arkts-state.md)等状态管理V1装饰器装饰，或者[@Local](../../状态管理（V2）/管理组件拥有的状态/@Local装饰器：组件内部状态/arkts-new-local.md)等状态管理V2装饰器装饰时，变量值的变化会触发UI刷新。
+
+  | 属性 | 支持的参数 | 起始API版本 |
+  | --- | --- | --- |
+  | [bindMenu](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/弹窗控制/菜单控制/ts-universal-attributes-menu.md#bindmenu11) | isShow | 18 |
+  | [bindContextMenu](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/弹窗控制/菜单控制/ts-universal-attributes-menu.md#bindcontextmenu12) | isShown | 18 |
+  | [bindPopup](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/弹窗控制/Popup控制/ts-universal-attributes-popup.md#bindpopup) | show | 18 |
+  | [TextInput](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/文本与输入/TextInput/ts-basic-components-textinput.md#textinputoptions对象说明) | text | 18 |
+  | [TextArea](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/文本与输入/TextArea/ts-basic-components-textarea.md#textareaoptions对象说明) | text | 18 |
+  | [Search](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/文本与输入/Search/ts-basic-components-search.md#searchoptions18对象说明) | value | 18 |
+  | [BindSheet](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/模态转场设置/半模态转场/ts-universal-attributes-sheet-transition.md#bindsheet) | isShow | 18 |
+  | [BindContentCover](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/通用属性/模态转场设置/全屏模态转场/ts-universal-attributes-modal-transition.md#bindcontentcover) | isShow | 18 |
+  | [SideBarContainer](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/栅格与分栏/SideBarContainer/ts-container-sidebarcontainer.md#sidebarwidth) | sideBarWidth | 18 |
+  | [Navigation](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/导航与切换/Navigation/ts-basic-components-navigation.md#navbarwidth9) | navBarWidth | 18 |
+  | [Toggle](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Toggle/ts-basic-components-toggle.md#toggleoptions18对象说明) | isOn | 18 |
+  | [Checkbox](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Checkbox/ts-basic-components-checkbox.md#select) | select | 18 |
+  | [CheckboxGroup](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/CheckboxGroup/ts-basic-components-checkboxgroup.md#selectall) | selectAll | 18 |
+  | [Radio](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Radio/ts-basic-components-radio.md#checked) | checked | 18 |
+  | [Rating](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Rating/ts-basic-components-rating.md#ratingoptions18对象说明) | rating | 18 |
+  | [Slider](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Slider/ts-basic-components-slider.md#slideroptions对象说明) | value | 18 |
+  | [Select](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Select/ts-basic-components-select.md#selected) | selected | 18 |
+  | [Select](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/按钮与选择/Select/ts-basic-components-select.md#value) | value | 18 |
+  | [MenuItem](../../../../../../../harmonyos-references/ArkUI（方舟UI框架）/ArkTS组件/菜单/MenuItem/ts-basic-components-menuitem.md#selected) | selected | 18 |