!134 merge fix/ohos-agent-auto-install into main

feat(acp): add HarmonyOS Claude and Codex agents

Created-by: guantw
Commit-by: guantw
Merged-by: SWangHash
Description: ## Summary

Add HarmonyOS-specific ACP Agent detection and installation support while preserving the existing behavior on Windows, Linux, macOS, and remote workspaces.

HarmonyOS now supports:

- Kimi Code
- Qwen Code
- CodeBuddy Code
- Claude Code
- Codex
- DeepSeek Harness
- OpenCode detection and guided acquisition

The DeepSeek Harness ACP bridge is packaged into the HarmonyOS HAP and reused through its existing `bitfun-acp` profile.

Fixes #

## Type and Areas

Type:

Feature / UI/UX

Areas:

HarmonyOS, ACP Agents, installer, web UI, Rust core, HAP packaging

## Motivation / Impact

HarmonyOS users can detect, install, and add supported ACP Agents directly from BitFun.

Agent definitions now select the appropriate implementation for the current platform. Existing Windows, Linux, macOS, and remote-workspace behavior remains unchanged.

OpenCode does not modify the user's third-party HarmonyBrew trust configuration. If an existing installation is detected, it can be added directly; otherwise, BitFun provides the corresponding installation source.

## Verification

- Passed focused ACP Agent frontend tests.
- Passed DeepSeek Harness ACP bridge tests.
- Passed TypeScript type checking and Rust formatting checks.
- Successfully built the production HarmonyOS HAP.
- Verified the packaged HAP contains the required DeepSeek Harness ACP resources.
- Installed and tested the HAP on a physical HarmonyOS device.
- Verified Agent detection, installation, configuration, and ACP startup flows on the device.

## Reviewer Notes

HarmonyOS uses platform-specific provisioning definitions. Other desktop platforms and remote workspaces continue using the existing upstream Agent definitions.

The implementation does not automatically modify or replace the user's HarmonyBrew tap trust configuration.

## Checklist

- [x] This PR is focused and does not include secrets, temporary prompts, generated scratch files, or unrelated artifacts.
- [x] Relevant verification is recorded above, or skipped checks are explained.
- [x] User-facing strings, docs, and locales are updated where applicable.

See merge request: OpenHarmonyPCDeveloper/BitFun!134

Author: SWangHash

scripts/prepare-dsh-profile.mjs

@@ -31,11 +31,14 @@
 
 import { spawnSync } from 'node:child_process';
 import {
+  cpSync,
   existsSync,
   lstatSync,
   mkdirSync,
   readdirSync,
   readFileSync,
+  renameSync,
+  rmSync,
   statSync,
   writeFileSync,
 } from 'node:fs';
@@ -45,7 +48,22 @@ import { fileURLToPath } from 'node:url';
 const ROOT_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const PACKAGE_DIR = path.join(ROOT_DIR, 'packages', 'dsh-acp');
 const OUT_DIR = path.join(PACKAGE_DIR, 'dist-profile');
+const OHOS_OUT_DIR = path.join(
+  ROOT_DIR,
+  'src',
+  'apps',
+  'ohos',
+  'entry',
+  'src',
+  'main',
+  'resources',
+  'resfile',
+  'dsh-profile',
+);
 const STAMP_FILENAME = '.bitfun-bridge.json';
+const OHOS_STAMP_FILENAME = 'bitfun-bridge.json';
+const NODE_MODULES_DIR = 'node_modules';
+const OHOS_NODE_MODULES_DIR = 'vendor-node-modules';
 
 /** One installed harness package is enough to tell a populated tree from a bare one. */
 const DEPS_PROBE = path.join(PACKAGE_DIR, 'node_modules', '@deepseek-ai', 'dsh-app-boot');
@@ -185,6 +203,35 @@ export function getDshProfileRebuildPlan({
   };
 }
 
+/**
+ * Stage the built profile into HarmonyOS resfile-compatible names.
+ *
+ * The HarmonyOS resource bundle uses aliases for the profile's leading-dot
+ * marker and `node_modules` directory. Keep the canonical desktop build
+ * unchanged and normalize the names back when the Rust client materializes the
+ * profile into the user's DSH home.
+ *
+ * @param {{ sourceDir?: string, destinationDir?: string }} [options]
+ */
+export function syncOhosDshProfile({
+  sourceDir = OUT_DIR,
+  destinationDir = OHOS_OUT_DIR,
+} = {}) {
+  rmSync(destinationDir, { recursive: true, force: true });
+  mkdirSync(path.dirname(destinationDir), { recursive: true });
+  cpSync(sourceDir, destinationDir, { recursive: true, dereference: true });
+
+  const stamp = path.join(destinationDir, STAMP_FILENAME);
+  if (existsSync(stamp)) {
+    renameSync(stamp, path.join(destinationDir, OHOS_STAMP_FILENAME));
+  }
+
+  const nodeModules = path.join(destinationDir, NODE_MODULES_DIR);
+  if (existsSync(nodeModules)) {
+    renameSync(nodeModules, path.join(destinationDir, OHOS_NODE_MODULES_DIR));
+  }
+}
+
 /**
  * Run a command in the bridge package directory.
  * @param {string} command - the executable to run.
@@ -217,8 +264,10 @@ function fail(message, status) {
 function main() {
   if (process.env.BITFUN_SKIP_DSH_PROFILE === '1') {
     process.stdout.write('[dsh-profile] skipped (this build ships no DeepSeek bridge)\n');
+    rmSync(OUT_DIR, { recursive: true, force: true });
     mkdirSync(OUT_DIR, { recursive: true });
     writeFileSync(path.join(OUT_DIR, 'NOT-BUILT.md'), PLACEHOLDER);
+    syncOhosDshProfile();
     return;
   }
 
@@ -227,6 +276,7 @@ function main() {
   const plan = getDshProfileRebuildPlan({ force });
   if (!plan.shouldBuild) {
     process.stdout.write(`[dsh-profile] ${plan.reason}\n`);
+    syncOhosDshProfile();
     return;
   }
   process.stdout.write(`[dsh-profile] ${plan.reason}\n`);
@@ -242,6 +292,8 @@ function main() {
 
   const packaged = run('node', ['scripts/build-profile.mjs']);
   if (packaged !== 0) fail('profile packaging failed', packaged);
+
+  syncOhosDshProfile();
 }
 
 if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {

scripts/prepare-dsh-profile.test.mjs

@@ -1,5 +1,6 @@
 import assert from 'node:assert/strict';
 import {
+  existsSync,
   mkdirSync,
   mkdtempSync,
   readFileSync,
@@ -12,7 +13,10 @@ import path from 'node:path';
 import { test } from 'node:test';
 import { fileURLToPath } from 'node:url';
 
-import { getDshProfileRebuildPlan } from './prepare-dsh-profile.mjs';
+import {
+  getDshProfileRebuildPlan,
+  syncOhosDshProfile,
+} from './prepare-dsh-profile.mjs';
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 
@@ -149,6 +153,34 @@ test('skips when a complete stamp is newer than every input', () => {
   }
 });
 
+test('stages a clean HarmonyOS profile with resfile-compatible names', () => {
+  const root = mkdtempSync(path.join(tmpdir(), 'bitfun-dsh-ohos-profile-'));
+  const sourceDir = path.join(root, 'dist-profile');
+  const destinationDir = path.join(root, 'resfile', 'dsh-profile');
+  try {
+    mkdirSync(path.join(sourceDir, 'node_modules', '@example', 'bridge'), { recursive: true });
+    writeFileSync(path.join(sourceDir, '.bitfun-bridge.json'), '{"profile":"bitfun-acp"}\n');
+    writeFileSync(path.join(sourceDir, 'node_modules', '@example', 'bridge', 'index.js'), '');
+    mkdirSync(destinationDir, { recursive: true });
+    writeFileSync(path.join(destinationDir, 'stale.js'), 'stale');
+
+    syncOhosDshProfile({ sourceDir, destinationDir });
+
+    assert.equal(existsSync(path.join(destinationDir, 'stale.js')), false);
+    assert.equal(existsSync(path.join(destinationDir, '.bitfun-bridge.json')), false);
+    assert.equal(existsSync(path.join(destinationDir, 'node_modules')), false);
+    assert.equal(existsSync(path.join(destinationDir, 'bitfun-bridge.json')), true);
+    assert.equal(
+      existsSync(
+        path.join(destinationDir, 'vendor-node-modules', '@example', 'bridge', 'index.js'),
+      ),
+      true,
+    );
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
 test('desktop:dev does not compile the DeepSeek profile', () => {
   const devScript = readFileSync(path.join(repoRoot, 'scripts', 'dev.cjs'), 'utf8');
   assert.doesNotMatch(devScript, /runCommandPrefixed\('dsh-profile'/);