arkts-lsp-proxy 0.1.0

package/README.md

@@ -0,0 +1,162 @@
+# ArkTS LSP Proxy
+
+将 DevEco Studio 内置的 ArkTS 语言服务器（ace-server）桥接出来，让 Claude Code 等支持 LSP 的工具获得 ArkTS 语言智能。
+
+## 解决什么问题
+
+AI 编码工具把 ArkTS 当成普通 TypeScript，导致：
+
+- 使用不存在的 Web/Node.js API（如 `document.getElementById`）
+- 不了解 ArkTS 声明式 UI 语法（`@Component`、`@State`、`build()` 等）
+- 不遵守 ArkTS 静态类型约束（禁止 `any`、禁止动态属性访问等）
+
+## 工作原理
+
+```
+Claude Code (LSP Client)
+    │ stdio (JSON-RPC)
+    ▼
+arkts-lsp-proxy (Node.js 进程)
+    │
+    ├── 1. 发现 DevEco Studio（环境变量 / 自动搜索）
+    ├── 2. 推导 SDK、ace-server、工具链路径
+    ├── 3. 解析 build-profile.json5，构造 modules 参数
+    ├── 4. 运行 hvigor --sync（生成依赖映射）
+    └── 5. 启动 ace-server，拦截 initialize 请求注入参数
+         │
+         ▼
+    ace-server (DevEco 官方语言服务)
+         ├── textDocument/diagnostics
+         ├── textDocument/completion
+         ├── textDocument/hover
+         ├── textDocument/definition
+         └── @Component/@State/@Prop 语义理解
+```
+
+代理不实现任何语言功能，只做消息转发和参数注入。
+
+## 前置条件
+
+- **DevEco Studio** 已安装（ace-server 随 IDE 分发）
+- **Node.js** >= 18
+
+## 安装
+
+### Claude Code 插件（推荐）
+
+```bash
+# 注册 marketplace
+/plugin marketplace add HelloiOS2014/harmony_arkts_lsp_proxy
+
+# 安装插件（首次使用时自动安装 arkts-lsp-proxy）
+/plugin install arkts-lsp
+```
+
+### npm 全局安装（手动 CLI 使用）
+
+```bash
+npm install -g arkts-lsp-proxy
+```
+
+## 配置
+
+### 环境变量
+
+```bash
+# macOS
+export DEVECO_HOME=/Applications/DevEco-Studio.app
+
+# Windows
+set DEVECO_HOME=D:\Application\Huawei\DevEco Studio
+
+# Linux
+export DEVECO_HOME=/opt/DevEco-Studio
+```
+
+不设置也可以，会自动搜索各平台默认安装路径。
+
+## 使用
+
+插件安装后，打开 `.ets` 文件时 LSP 自动激活。首次启动会执行 `hvigor --sync` 初始化依赖映射（可能需要几分钟），后续有缓存会很快。
+
+也可以手动运行：
+
+```bash
+cd /path/to/harmonyos/project
+arkts-lsp-proxy
+```
+
+## 平台支持
+
+| 平台 | 默认搜索路径 |
+|------|-------------|
+| macOS | `/Applications/DevEco-Studio.app`、`~/Applications/DevEco-Studio.app` |
+| Windows | `D:\Application\Huawei\DevEco Studio`、`C:\Program Files\Huawei\DevEco Studio` |
+| Linux | `/opt/DevEco-Studio`、`~/DevEco-Studio` |
+
+macOS 自动处理 `.app/Contents` 层，用户只需设置 `.app` 路径。
+
+## 错误处理
+
+| 场景 | 行为 |
+|------|------|
+| DevEco Studio 未安装 | stderr 输出安装指引，exit(1) |
+| 项目目录无 `build-profile.json5` | stderr 输出提示，exit(1) |
+| hvigor sync 失败 | stderr 输出警告，继续启动 ace-server |
+| ace-server 启动失败 | 输出错误信息，exit(1) |
+| ace-server 运行时崩溃 | 代理进程同步退出 |
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 测试
+npm test
+
+# 本地链接
+npm link
+```
+
+## 项目结构
+
+```
+src/
+├── env.ts          DevEco Studio 环境发现
+├── project.ts      HarmonyOS 项目解析 + findProjectRoot 向上搜索
+├── hvigor.ts       hvigor sync 缓存检查与执行
+├── ace-server.ts   ace-server 子进程生命周期管理（onExit 回调）
+├── proxy.ts        LSP 消息代理，拦截 initialize 注入参数
+└── index.ts        入口，串联所有模块
+.claude-plugin/
+└── marketplace.json    marketplace 清单 + lspServers 配置
+plugins/
+└── arkts-lsp/
+    ├── .claude-plugin/
+    │   └── plugin.json     插件清单
+    ├── .lsp.json           LSP 服务器配置
+    └── README.md           插件文档
+test/
+├── env.test.ts
+├── project.test.ts
+├── hvigor.test.ts
+├── ace-server.test.ts
+├── proxy.test.ts
+├── index.test.ts
+└── fixtures/
+```
+
+## 技术栈
+
+- TypeScript
+- `vscode-jsonrpc` — LSP 消息解析与传输
+- `json5` — 解析 `build-profile.json5`
+- Vitest — 测试
+
+## License
+
+MIT

package/dist/ace-server.d.ts

@@ -0,0 +1,10 @@
+import { type ChildProcess } from 'child_process';
+import type { DevEcoEnv } from './env';
+export type ExitHandler = (code: number | null, signal: string | null) => void;
+export interface AceServerHandle {
+    process: ChildProcess;
+    kill: () => void;
+    onExit: (handler: ExitHandler) => void;
+}
+export declare function startAceServer(env: DevEcoEnv): AceServerHandle;
+//# sourceMappingURL=ace-server.d.ts.map

package/dist/ace-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ace-server.d.ts","sourceRoot":"","sources":["../src/ace-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CA8C9D"}

package/dist/ace-server.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAceServer = startAceServer;
+const child_process_1 = require("child_process");
+function startAceServer(env) {
+    process.stderr.write(`[arkts-lsp] Starting ace-server: ${env.aceServerPath}\n`);
+    const child = (0, child_process_1.spawn)(env.nodeBin, [env.aceServerPath], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        windowsHide: true,
+        env: {
+            ...process.env,
+            DEVECO_SDK_HOME: env.sdkPath,
+        },
+    });
+    const exitHandlers = [];
+    child.stderr?.on('data', (data) => {
+        const msg = data.toString().trim();
+        if (msg && !msg.includes('heartbeat')) {
+            process.stderr.write(`[ace-server] ${msg}\n`);
+        }
+    });
+    child.on('error', (err) => {
+        process.stderr.write(`[arkts-lsp] ace-server error: ${err.message}\n`);
+        for (const handler of exitHandlers) {
+            handler(1, null);
+        }
+    });
+    child.on('exit', (code, signal) => {
+        process.stderr.write(`[arkts-lsp] ace-server exited (code=${code}, signal=${signal})\n`);
+        for (const handler of exitHandlers) {
+            handler(code, signal);
+        }
+    });
+    return {
+        process: child,
+        kill: () => {
+            if (child.exitCode === null) {
+                child.kill();
+            }
+        },
+        onExit: (handler) => {
+            exitHandlers.push(handler);
+        },
+    };
+}
+//# sourceMappingURL=ace-server.js.map

package/dist/ace-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ace-server.js","sourceRoot":"","sources":["../src/ace-server.ts"],"names":[],"mappings":";;AAWA,wCA8CC;AAzDD,iDAAyD;AAWzD,SAAgB,cAAc,CAAC,GAAc;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;IAEhF,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE;QACpD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,WAAW,EAAE,IAAI;QACjB,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,eAAe,EAAE,GAAG,CAAC,OAAO;SAC7B;KACF,CAAC,CAAC;IAEH,MAAM,YAAY,GAAkB,EAAE,CAAC;IAEvC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,IAAI,YAAY,MAAM,KAAK,CAAC,CAAC;QACzF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,GAAG,EAAE;YACT,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QACD,MAAM,EAAE,CAAC,OAAoB,EAAE,EAAE;YAC/B,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,9 @@
+export interface DevEcoEnv {
+    devecoHome: string;
+    sdkPath: string;
+    aceServerPath: string;
+    nodeBin: string;
+    hvigorPath: string;
+}
+export declare function findDevEcoEnv(): DevEcoEnv | null;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AA4DD,wBAAgB,aAAa,IAAI,SAAS,GAAG,IAAI,CAgBhD"}

package/dist/env.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findDevEcoEnv = findDevEcoEnv;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const PLATFORM = process.platform;
+const IS_MAC = PLATFORM === 'darwin';
+const IS_WIN = PLATFORM === 'win32';
+const DEFAULT_PATHS = {
+    darwin: [
+        '/Applications/DevEco-Studio.app',
+        '/Applications/DevEco Studio.app',
+        path.join(os.homedir(), 'Applications', 'DevEco-Studio.app'),
+        path.join(os.homedir(), 'Applications', 'DevEco Studio.app'),
+    ],
+    linux: [
+        '/opt/DevEco-Studio',
+        path.join(os.homedir(), 'DevEco-Studio'),
+    ],
+    win32: [
+        'D:/Application/Huawei/DevEco Studio',
+        'C:/Program Files/Huawei/DevEco Studio',
+        path.join(os.homedir(), 'AppData', 'Local', 'Huawei', 'DevecoStudio'),
+    ],
+};
+function resolveContentsPath(rawPath) {
+    const lower = rawPath.toLowerCase();
+    if (lower.endsWith('.app')) {
+        return path.join(rawPath, 'Contents');
+    }
+    if (fs.existsSync(path.join(rawPath, 'plugins'))) {
+        return rawPath;
+    }
+    if (path.basename(rawPath) === 'Contents') {
+        return rawPath;
+    }
+    return path.join(rawPath, 'Contents');
+}
+function validateDevEcoHome(candidate) {
+    const contentsPath = resolveContentsPath(candidate);
+    const aceServerPath = path.join(contentsPath, 'plugins', 'openharmony', 'ace-server', 'out', 'index.js');
+    if (!fs.existsSync(aceServerPath))
+        return null;
+    const sdkPkg = path.join(contentsPath, 'sdk', 'default', 'sdk-pkg.json');
+    if (!fs.existsSync(sdkPkg))
+        return null;
+    const nodeName = IS_WIN ? 'node.exe' : 'node';
+    const nodeBinDir = IS_WIN ? '' : 'bin';
+    const nodeBin = path.join(contentsPath, 'tools', 'node', nodeBinDir, nodeName);
+    const hvigorPath = path.join(contentsPath, 'tools', 'hvigor', 'bin', 'hvigorw.js');
+    return {
+        devecoHome: contentsPath,
+        sdkPath: path.join(contentsPath, 'sdk', 'default'),
+        aceServerPath,
+        nodeBin,
+        hvigorPath,
+    };
+}
+function findDevEcoEnv() {
+    const envHome = process.env.DEVECO_HOME;
+    if (envHome) {
+        const result = validateDevEcoHome(envHome.trim());
+        if (result)
+            return result;
+        // When DEVECO_HOME is explicitly set but invalid, don't fall through to defaults
+        return null;
+    }
+    const defaults = DEFAULT_PATHS[PLATFORM] || DEFAULT_PATHS.linux;
+    for (const p of defaults) {
+        const result = validateDevEcoHome(p);
+        if (result)
+            return result;
+    }
+    return null;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}

package/dist/hvigor.d.ts

@@ -0,0 +1,3 @@
+import type { DevEcoEnv } from './env';
+export declare function runHvigorSync(env: DevEcoEnv, projectRoot: string): boolean;
+//# sourceMappingURL=hvigor.d.ts.map

package/dist/hvigor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hvigor.d.ts","sourceRoot":"","sources":["../src/hvigor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AA2BvC,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAgD1E"}

package/dist/hvigor.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHvigorSync = runHvigorSync;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const HVIGOR_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+const HVIGOR_FLAGS = [
+    '--sync',
+    '-p', 'product=default',
+    '--analyze=normal',
+    '--parallel',
+    '--incremental',
+    '-p', 'enforce-ohpm=true',
+    '--daemonjs',
+];
+function isSyncFresh(projectRoot) {
+    const depMap = path.join(projectRoot, '.hvigor', 'dependencyMap', 'dependencyMap.json5');
+    if (!fs.existsSync(depMap))
+        return false;
+    try {
+        const stat = fs.statSync(depMap);
+        const ageMs = Date.now() - stat.mtimeMs;
+        return ageMs < 24 * 60 * 60 * 1000; // fresh if less than 24 hours old
+    }
+    catch {
+        return false;
+    }
+}
+function runHvigorSync(env, projectRoot) {
+    if (isSyncFresh(projectRoot)) {
+        process.stderr.write('[arkts-lsp] hvigor sync skipped (dependency map is fresh)\n');
+        return true;
+    }
+    if (!fs.existsSync(env.nodeBin)) {
+        process.stderr.write(`[arkts-lsp] DevEco node not found at: ${env.nodeBin}\n`);
+        return false;
+    }
+    if (!fs.existsSync(env.hvigorPath)) {
+        process.stderr.write(`[arkts-lsp] hvigorw.js not found at: ${env.hvigorPath}\n`);
+        return false;
+    }
+    process.stderr.write('[arkts-lsp] hvigor sync starting...\n');
+    const startTime = Date.now();
+    const result = (0, child_process_1.spawnSync)(env.nodeBin, [env.hvigorPath, ...HVIGOR_FLAGS], {
+        cwd: projectRoot,
+        timeout: HVIGOR_TIMEOUT_MS,
+        windowsHide: true,
+        encoding: 'utf8',
+        env: {
+            ...process.env,
+            DEVECO_SDK_HOME: env.sdkPath,
+        },
+    });
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+    if (result.error) {
+        if (result.error.code === 'ETIMEDOUT') {
+            process.stderr.write(`[arkts-lsp] hvigor sync timed out after ${HVIGOR_TIMEOUT_MS / 1000}s\n`);
+            return false;
+        }
+        process.stderr.write(`[arkts-lsp] hvigor sync error: ${result.error.message}\n`);
+        return false;
+    }
+    if (result.status !== 0) {
+        process.stderr.write(`[arkts-lsp] hvigor sync failed (exit ${result.status}, ${elapsed}s)\n`);
+        if (result.stderr)
+            process.stderr.write(result.stderr.slice(-500) + '\n');
+        return false;
+    }
+    process.stderr.write(`[arkts-lsp] hvigor sync completed (${elapsed}s)\n`);
+    return true;
+}
+//# sourceMappingURL=hvigor.js.map

package/dist/hvigor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hvigor.js","sourceRoot":"","sources":["../src/hvigor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const env_1 = require("./env");
+const project_1 = require("./project");
+const hvigor_1 = require("./hvigor");
+const ace_server_1 = require("./ace-server");
+const proxy_1 = require("./proxy");
+function main() {
+    process.stderr.write('[arkts-lsp] Starting ArkTS LSP Proxy\n');
+    // Step 1: Find DevEco Studio
+    const env = (0, env_1.findDevEcoEnv)();
+    if (!env) {
+        process.stderr.write('==============================================\n');
+        process.stderr.write('  ArkTS LSP: DevEco Studio not found!\n\n');
+        process.stderr.write('  Set the environment variable:\n');
+        process.stderr.write('    export DEVECO_HOME=/Applications/DevEco-Studio.app\n');
+        process.stderr.write('==============================================\n');
+        process.exit(1);
+    }
+    process.stderr.write(`[arkts-lsp] DevEco: ${env.devecoHome}\n`);
+    // Step 2: Find project root
+    const cwd = process.cwd();
+    const projectRoot = (0, project_1.findProjectRoot)(cwd);
+    if (!projectRoot) {
+        process.stderr.write(`[arkts-lsp] No HarmonyOS project found at ${cwd}\n`);
+        process.stderr.write('[arkts-lsp] Expected build-profile.json5 in current or parent directory\n');
+        process.exit(1);
+    }
+    const project = (0, project_1.parseProject)(projectRoot, env.sdkPath);
+    if (!project) {
+        process.stderr.write(`[arkts-lsp] Failed to parse project at ${projectRoot}\n`);
+        process.exit(1);
+    }
+    process.stderr.write(`[arkts-lsp] Project: ${project.projectRoot}\n`);
+    process.stderr.write(`[arkts-lsp] Modules: ${project.modules.map(m => m.moduleName).join(', ')}\n`);
+    // Step 3: Run hvigor sync
+    const syncOk = (0, hvigor_1.runHvigorSync)(env, project.projectRoot);
+    if (!syncOk) {
+        process.stderr.write('[arkts-lsp] hvigor sync failed, continuing anyway\n');
+    }
+    // Step 4: Start ace-server
+    const ace = (0, ace_server_1.startAceServer)(env);
+    // Step 5: Set up LSP proxy
+    const proxy = (0, proxy_1.createProxy)(process.stdin, process.stdout, ace.process, {
+        rootUri: project.rootUri,
+        lspServerWorkspacePath: project.lspServerWorkspacePath,
+        modules: project.modules,
+    });
+    // Step 6: Handle cleanup
+    const cleanup = () => {
+        proxy.dispose();
+        ace.kill();
+    };
+    process.on('SIGINT', () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.stdin.on('end', () => {
+        cleanup();
+    });
+    ace.onExit((code) => {
+        proxy.dispose();
+        process.exit(code ?? 1);
+    });
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/project.d.ts

@@ -0,0 +1,20 @@
+export interface AceModule {
+    moduleName: string;
+    modulePath: string;
+    deviceType: string[];
+    aceLoaderPath: string;
+    jsComponentType: number;
+    sdkJsPath: string;
+    compatibleSdkLevel: string;
+    apiType: string;
+}
+export interface ProjectConfig {
+    projectRoot: string;
+    rootUri: string;
+    lspServerWorkspacePath: string;
+    modules: AceModule[];
+}
+export declare function extractCompatibleSdkLevel(version: string): string;
+export declare function findProjectRoot(startDir: string): string | null;
+export declare function parseProject(projectRoot: string, sdkPath: string): ProjectConfig | null;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjE;AA2BD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/D;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAiDvF"}

package/dist/project.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCompatibleSdkLevel = extractCompatibleSdkLevel;
+exports.findProjectRoot = findProjectRoot;
+exports.parseProject = parseProject;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const json5_1 = __importDefault(require("json5"));
+function extractCompatibleSdkLevel(version) {
+    const match = version.match(/\((\d+)\)/);
+    return match ? match[1] : '12';
+}
+function constructModule(name, srcPath, projectRoot, sdkPath, compatibleSdkLevel, deviceTypes) {
+    const modulePath = path.resolve(projectRoot, srcPath);
+    const deviceType = deviceTypes[0] || 'phone';
+    const sdkJsPath = path.join(sdkPath, 'js', 'api', deviceType) + path.sep;
+    const aceLoaderPath = path.join(sdkPath, 'js', 'framework', deviceType, 'ace-loader');
+    return {
+        moduleName: name,
+        modulePath,
+        deviceType: deviceTypes.length > 0 ? deviceTypes : ['phone'],
+        aceLoaderPath,
+        jsComponentType: 0,
+        sdkJsPath,
+        compatibleSdkLevel,
+        apiType: 'Stage',
+    };
+}
+function findProjectRoot(startDir) {
+    let current = path.resolve(startDir);
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(current, 'build-profile.json5'))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+function parseProject(projectRoot, sdkPath) {
+    const profilePath = path.join(projectRoot, 'build-profile.json5');
+    if (!fs.existsSync(profilePath))
+        return null;
+    try {
+        const content = fs.readFileSync(profilePath, 'utf-8');
+        const profile = json5_1.default.parse(content);
+        const products = profile.app?.products || [];
+        const firstProduct = products[0];
+        const compatibleSdkLevel = firstProduct?.compatibleSdkVersion
+            ? extractCompatibleSdkLevel(firstProduct.compatibleSdkVersion)
+            : '12';
+        // Derive deviceType from product config, default to ['phone']
+        const deviceTypes = firstProduct?.compatibleDeviceType
+            ? (Array.isArray(firstProduct.compatibleDeviceType)
+                ? firstProduct.compatibleDeviceType
+                : [firstProduct.compatibleDeviceType])
+            : ['phone'];
+        const rawModules = profile.modules || [];
+        const modules = [];
+        for (const mod of rawModules) {
+            if (!mod.name || !mod.srcPath) {
+                process.stderr.write(`[arkts-lsp] Skipping module with missing name or srcPath\n`);
+                continue;
+            }
+            modules.push(constructModule(mod.name, mod.srcPath, projectRoot, sdkPath, compatibleSdkLevel, deviceTypes));
+        }
+        if (modules.length === 0)
+            return null;
+        return {
+            projectRoot,
+            rootUri: 'file://' + projectRoot,
+            lspServerWorkspacePath: projectRoot,
+            modules,
+        };
+    }
+    catch (e) {
+        process.stderr.write(`[arkts-lsp] Failed to parse build-profile.json5:\n`);
+        if (e instanceof Error) {
+            process.stderr.write(e.stack + '\n');
+        }
+        else {
+            process.stderr.write(String(e) + '\n');
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}

package/dist/proxy.d.ts

@@ -0,0 +1,19 @@
+import type { ChildProcess } from 'child_process';
+import type { AceModule } from './project';
+export interface LspMessage {
+    jsonrpc?: string;
+    id?: number | string;
+    method?: string;
+    params?: Record<string, unknown>;
+}
+export interface InitializationPayload {
+    rootUri: string;
+    lspServerWorkspacePath: string;
+    modules: AceModule[];
+}
+export declare function injectInitializationOptions(message: LspMessage, payload: InitializationPayload): LspMessage;
+export interface ProxyHandle {
+    dispose: () => void;
+}
+export declare function createProxy(clientIn: NodeJS.ReadableStream, clientOut: NodeJS.WritableStream, aceProcess: ChildProcess, payload: InitializationPayload): ProxyHandle;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,qBAAqB,GAC7B,UAAU,CAYZ;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,SAAS,EAAE,MAAM,CAAC,cAAc,EAChC,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,qBAAqB,GAC7B,WAAW,CA6Db"}

package/dist/proxy.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectInitializationOptions = injectInitializationOptions;
+exports.createProxy = createProxy;
+const node_1 = require("vscode-jsonrpc/node");
+function injectInitializationOptions(message, payload) {
+    if (message.method === 'initialize' && message.params) {
+        const params = { ...message.params };
+        params.initializationOptions = {
+            ...(params.initializationOptions || {}),
+            rootUri: payload.rootUri,
+            lspServerWorkspacePath: payload.lspServerWorkspacePath,
+            modules: payload.modules,
+        };
+        return { ...message, params };
+    }
+    return message;
+}
+function createProxy(clientIn, clientOut, aceProcess, payload) {
+    const aceIn = aceProcess.stdout;
+    const aceOut = aceProcess.stdin;
+    if (!aceIn || !aceOut) {
+        throw new Error('aceProcess must have both stdout and stdin streams');
+    }
+    const clientConn = (0, node_1.createMessageConnection)(new node_1.StreamMessageReader(clientIn), new node_1.StreamMessageWriter(clientOut));
+    const aceConn = (0, node_1.createMessageConnection)(new node_1.StreamMessageReader(aceIn), new node_1.StreamMessageWriter(aceOut));
+    clientConn.onNotification((method, params) => {
+        aceConn.sendNotification(method, params);
+    });
+    clientConn.onRequest((method, params, token) => {
+        if (method === 'initialize') {
+            const message = { method, params: params };
+            const modified = injectInitializationOptions(message, payload);
+            return aceConn.sendRequest(method, modified.params, token);
+        }
+        return aceConn.sendRequest(method, params, token);
+    });
+    aceConn.onNotification((method, params) => {
+        clientConn.sendNotification(method, params);
+    });
+    aceConn.onRequest((method, params, token) => {
+        return clientConn.sendRequest(method, params, token);
+    });
+    aceConn.onError(([err]) => {
+        process.stderr.write(`[arkts-lsp] ace connection error: ${err.message}\n`);
+        clientConn.dispose();
+    });
+    clientConn.onError(([err]) => {
+        process.stderr.write(`[arkts-lsp] client connection error: ${err.message}\n`);
+        aceConn.dispose();
+    });
+    aceProcess.on('exit', () => {
+        clientConn.dispose();
+    });
+    clientConn.listen();
+    aceConn.listen();
+    return {
+        dispose: () => {
+            clientConn.dispose();
+            aceConn.dispose();
+        },
+    };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "arkts-lsp-proxy",
+  "version": "0.1.0",
+  "description": "ArkTS LSP Proxy — bridges DevEco Studio's ace-server to Claude Code",
+  "main": "dist/index.js",
+  "bin": {
+    "arkts-lsp-proxy": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ test/",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "files": [
+    "dist/"
+  ],
+  "keywords": [
+    "arkts",
+    "lsp",
+    "harmonyos",
+    "deveco",
+    "claude-code"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HelloiOS2014/harmony_arkts_lsp_proxy.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "json5": "^2.2.3",
+    "vscode-jsonrpc": "^8.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/json5": "^0.0.30",
+    "@types/node": "^25.6.1",
+    "eslint": "^10.3.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.2",
+    "vitest": "^4.1.5"
+  }
+}