harmony-build 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/README.md +265 -0
  2. package/dist/packages/arkanalyzer-mcp/src/index.d.ts +5 -0
  3. package/dist/packages/arkanalyzer-mcp/src/index.js +220 -0
  4. package/dist/packages/arkanalyzer-mcp/src/index.js.map +1 -0
  5. package/dist/packages/arkcheck-mcp/src/index.d.ts +5 -0
  6. package/dist/packages/arkcheck-mcp/src/index.js +160 -0
  7. package/dist/packages/arkcheck-mcp/src/index.js.map +1 -0
  8. package/dist/packages/arkcheck-mcp/src/rules.d.ts +15 -0
  9. package/dist/packages/arkcheck-mcp/src/rules.js +90 -0
  10. package/dist/packages/arkcheck-mcp/src/rules.js.map +1 -0
  11. package/dist/packages/dev-mcp/src/hvigor-bridge.d.ts +31 -0
  12. package/dist/packages/dev-mcp/src/hvigor-bridge.js +179 -0
  13. package/dist/packages/dev-mcp/src/hvigor-bridge.js.map +1 -0
  14. package/dist/packages/dev-mcp/src/index.d.ts +5 -0
  15. package/dist/packages/dev-mcp/src/index.js +256 -0
  16. package/dist/packages/dev-mcp/src/index.js.map +1 -0
  17. package/dist/packages/dev-mcp/src/log-stream.d.ts +56 -0
  18. package/dist/packages/dev-mcp/src/log-stream.js +147 -0
  19. package/dist/packages/dev-mcp/src/log-stream.js.map +1 -0
  20. package/dist/packages/harmony-knowledge-mcp/src/index.d.ts +5 -0
  21. package/dist/packages/harmony-knowledge-mcp/src/index.js +164 -0
  22. package/dist/packages/harmony-knowledge-mcp/src/index.js.map +1 -0
  23. package/dist/packages/hdc-mcp/src/hdc-runner.d.ts +32 -0
  24. package/dist/packages/hdc-mcp/src/hdc-runner.js +60 -0
  25. package/dist/packages/hdc-mcp/src/hdc-runner.js.map +1 -0
  26. package/dist/packages/hdc-mcp/src/index.d.ts +5 -0
  27. package/dist/packages/hdc-mcp/src/index.js +155 -0
  28. package/dist/packages/hdc-mcp/src/index.js.map +1 -0
  29. package/dist/packages/hvigor-mcp/src/index.d.ts +5 -0
  30. package/dist/packages/hvigor-mcp/src/index.js +300 -0
  31. package/dist/packages/hvigor-mcp/src/index.js.map +1 -0
  32. package/dist/packages/hvigor-mcp/src/log-parser.d.ts +28 -0
  33. package/dist/packages/hvigor-mcp/src/log-parser.js +65 -0
  34. package/dist/packages/hvigor-mcp/src/log-parser.js.map +1 -0
  35. package/dist/packages/mcp-common/src/entry.d.ts +1 -0
  36. package/dist/packages/mcp-common/src/entry.js +22 -0
  37. package/dist/packages/mcp-common/src/entry.js.map +1 -0
  38. package/dist/packages/mcp-common/src/errors.d.ts +13 -0
  39. package/dist/packages/mcp-common/src/errors.js +23 -0
  40. package/dist/packages/mcp-common/src/errors.js.map +1 -0
  41. package/dist/packages/mcp-common/src/index.d.ts +6 -0
  42. package/dist/packages/mcp-common/src/index.js +7 -0
  43. package/dist/packages/mcp-common/src/index.js.map +1 -0
  44. package/dist/packages/mcp-common/src/logger.d.ts +11 -0
  45. package/dist/packages/mcp-common/src/logger.js +32 -0
  46. package/dist/packages/mcp-common/src/logger.js.map +1 -0
  47. package/dist/packages/mcp-common/src/mcp-helpers.d.ts +41 -0
  48. package/dist/packages/mcp-common/src/mcp-helpers.js +94 -0
  49. package/dist/packages/mcp-common/src/mcp-helpers.js.map +1 -0
  50. package/dist/packages/mcp-common/src/safe-exec.d.ts +23 -0
  51. package/dist/packages/mcp-common/src/safe-exec.js +74 -0
  52. package/dist/packages/mcp-common/src/safe-exec.js.map +1 -0
  53. package/dist/packages/mcp-common/src/sandbox.d.ts +31 -0
  54. package/dist/packages/mcp-common/src/sandbox.js +96 -0
  55. package/dist/packages/mcp-common/src/sandbox.js.map +1 -0
  56. package/dist/packages/profiler-mcp/src/index.d.ts +5 -0
  57. package/dist/packages/profiler-mcp/src/index.js +148 -0
  58. package/dist/packages/profiler-mcp/src/index.js.map +1 -0
  59. package/dist/packages/profiler-mcp/src/trace-analyzer.d.ts +38 -0
  60. package/dist/packages/profiler-mcp/src/trace-analyzer.js +95 -0
  61. package/dist/packages/profiler-mcp/src/trace-analyzer.js.map +1 -0
  62. package/dist/src/index.d.ts +17 -0
  63. package/dist/src/index.js +61 -0
  64. package/dist/src/index.js.map +1 -0
  65. package/dist/src/server/handlers.d.ts +11 -0
  66. package/dist/src/server/handlers.js +33 -0
  67. package/dist/src/server/handlers.js.map +1 -0
  68. package/dist/src/server/tools.d.ts +23 -0
  69. package/dist/src/server/tools.js +57 -0
  70. package/dist/src/server/tools.js.map +1 -0
  71. package/package.json +54 -0
  72. package//345/217/221/345/270/203/346/214/207/345/215/227.md +45 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/arkcheck-mcp/src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * 内置 HarmonyOS 高性能编码规则(first pass,覆盖最常踩坑的 ~10 条)。
3
+ * 参考来源:华为《2025 HarmonyOS 高性能规则检测创新实践》、HarmonyOS 应用最佳实践文档。
4
+ */
5
+ export interface Rule {
6
+ id: string;
7
+ title: string;
8
+ /** 触发匹配的正则;命中即提示 */
9
+ pattern: RegExp;
10
+ severity: "error" | "warning" | "info";
11
+ explanation: string;
12
+ suggestion: string;
13
+ }
14
+ export declare const BUILTIN_RULES: Rule[];
15
+ export declare function explainRule(id: string): Rule | undefined;
@@ -0,0 +1,90 @@
1
+ /**
2
+ * 内置 HarmonyOS 高性能编码规则(first pass,覆盖最常踩坑的 ~10 条)。
3
+ * 参考来源:华为《2025 HarmonyOS 高性能规则检测创新实践》、HarmonyOS 应用最佳实践文档。
4
+ */
5
+ export const BUILTIN_RULES = [
6
+ {
7
+ id: "ARK001",
8
+ title: "高频 build() 中使用 console.log/console.info",
9
+ pattern: /\bbuild\s*\(\s*\)\s*\{[\s\S]{0,2000}?\bconsole\.(?:log|info|debug)\b/,
10
+ severity: "warning",
11
+ explanation: "build() 在每次状态变更时都会被调用;console.log 在主线程同步执行,会显著拉低帧率。",
12
+ suggestion: "把日志移到事件回调或 aboutToAppear;或改用 hilog 异步日志并仅在 debug 模式开启。",
13
+ },
14
+ {
15
+ id: "ARK002",
16
+ title: "ForEach 缺少 key 生成器",
17
+ pattern: /\bForEach\s*\(\s*[^,]+,\s*[^,]+\)\s*(?!,)/,
18
+ severity: "warning",
19
+ explanation: "ForEach 未指定 keyGenerator 时,框架按下标 diff,整列重建概率高,列表滚动会卡顿。",
20
+ suggestion: "为 ForEach 添加第三个参数:(item) => item.id 之类的稳定 key。",
21
+ },
22
+ {
23
+ id: "ARK003",
24
+ title: "长列表使用 ForEach 而非 LazyForEach",
25
+ pattern: /\bForEach\s*\(\s*this\.\w+/,
26
+ severity: "info",
27
+ explanation: "ForEach 一次性创建全部子节点;元素超过 50 时应改用 LazyForEach + IDataSource,避免首屏过长。",
28
+ suggestion: "对长列表/网格场景使用 LazyForEach,并实现 IDataSource。",
29
+ },
30
+ {
31
+ id: "ARK004",
32
+ title: "主线程同步 IO(readSync / fs.statSync)",
33
+ pattern: /\b(?:readSync|writeSync|statSync|readFileSync|writeFileSync)\s*\(/,
34
+ severity: "error",
35
+ explanation: "ArkTS 主线程不应执行同步 IO,会直接卡 UI;鸿蒙提供 @ohos.file.fs 的 Promise 版本。",
36
+ suggestion: "改用 await fs.read(...) 等异步 API;耗时任务移到 TaskPool/Worker。",
37
+ },
38
+ {
39
+ id: "ARK005",
40
+ title: "组件中创建大对象未做缓存",
41
+ pattern: /\bbuild\s*\(\s*\)\s*\{[\s\S]{0,2000}?new\s+(?:Array|Map|Set|Object)\s*\(/,
42
+ severity: "warning",
43
+ explanation: "build() 内 new 大对象会在每帧重建,触发 GC 与重渲染。",
44
+ suggestion: "把构造移到 aboutToAppear 或常量;或用 @State 字段缓存。",
45
+ },
46
+ {
47
+ id: "ARK006",
48
+ title: "嵌套 Stack/Column 过深(>6 层)",
49
+ pattern: /(?:Stack|Column|Row)\s*\(\s*\)[^}]{0,200}\{[^}]{0,200}\{[^}]{0,200}\{[^}]{0,200}\{[^}]{0,200}\{[^}]{0,200}\{/,
50
+ severity: "info",
51
+ explanation: "深层嵌套会导致布局计算时间指数增长;推荐扁平化 + RelativeContainer。",
52
+ suggestion: "用 RelativeContainer 或 Grid 替代多层 Column/Row。",
53
+ },
54
+ {
55
+ id: "ARK007",
56
+ title: "Worker/TaskPool 选择:长时任务用 TaskPool 不当",
57
+ pattern: /TaskPool\.execute[\s\S]{0,500}?while\s*\(\s*true\s*\)/,
58
+ severity: "warning",
59
+ explanation: "TaskPool 任务超过 3 分钟会被回收;常驻任务应使用 Worker。",
60
+ suggestion: "改用 @ohos.worker;或拆分长任务为多段 TaskPool 任务。",
61
+ },
62
+ {
63
+ id: "ARK008",
64
+ title: "明文权限/敏感字符串硬编码",
65
+ pattern: /\b(?:password|token|secret|api[_-]?key)\s*[:=]\s*["'][^"']{6,}["']/i,
66
+ severity: "error",
67
+ explanation: "敏感信息不应硬编码进 ArkTS 源码,存在泄露与上架审核风险。",
68
+ suggestion: "改用 @ohos.security.huks 或 preferences 加密存储。",
69
+ },
70
+ {
71
+ id: "ARK009",
72
+ title: "高频回调中调用 setInterval 未在 aboutToDisappear 清理",
73
+ pattern: /setInterval\s*\(/,
74
+ severity: "info",
75
+ explanation: "setInterval 不清理会在页面销毁后继续触发,造成内存泄漏与 ANR。",
76
+ suggestion: "在 aboutToDisappear 中 clearInterval(handle)。",
77
+ },
78
+ {
79
+ id: "ARK010",
80
+ title: "Image 资源未指定大小,触发整图解码",
81
+ pattern: /\bImage\s*\([^)]+\)\s*(?!\s*\.(?:width|height|sourceSize))/,
82
+ severity: "info",
83
+ explanation: "未声明 sourceSize/width/height 时框架按原图分辨率解码,大图浪费内存。",
84
+ suggestion: "为 Image 显式指定 .width().height() 或 .sourceSize()。",
85
+ },
86
+ ];
87
+ export function explainRule(id) {
88
+ return BUILTIN_RULES.find((r) => r.id === id);
89
+ }
90
+ //# sourceMappingURL=rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../packages/arkcheck-mcp/src/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,yCAAyC;QAChD,OAAO,EAAE,sEAAsE;QAC/E,QAAQ,EAAE,SAAS;QACnB,WAAW,EACT,qDAAqD;QACvD,UAAU,EAAE,wDAAwD;KACrE;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,2CAA2C;QACpD,QAAQ,EAAE,SAAS;QACnB,WAAW,EACT,wDAAwD;QAC1D,UAAU,EAAE,gDAAgD;KAC7D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,8BAA8B;QACrC,OAAO,EAAE,4BAA4B;QACrC,QAAQ,EAAE,MAAM;QAChB,WAAW,EACT,mEAAmE;QACrE,UAAU,EAAE,0CAA0C;KACvD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,kCAAkC;QACzC,OAAO,EAAE,mEAAmE;QAC5E,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,6DAA6D;QAC/D,UAAU,EAAE,uDAAuD;KACpE;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,0EAA0E;QACnF,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,yCAAyC;KACtD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,8GAA8G;QACvH,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,8CAA8C;QAC3D,UAAU,EAAE,6CAA6C;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,sCAAsC;QAC7C,OAAO,EAAE,uDAAuD;QAChE,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,wCAAwC;QACrD,UAAU,EAAE,wCAAwC;KACrD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,qEAAqE;QAC9E,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,kCAAkC;QAC/C,UAAU,EAAE,4CAA4C;KACzD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,4CAA4C;QACnD,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,yCAAyC;QACtD,UAAU,EAAE,6CAA6C;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,4DAA4D;QACrE,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,iDAAiD;QAC9D,UAAU,EAAE,iDAAiD;KAC9D;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { HarmonyMcpError, Logger } from "@harmony-mcp/common";
2
+ export declare function detectProjectRoot(start: string): string | null;
3
+ export declare function resolveHvigorBin(projectDir: string): {
4
+ bin: string;
5
+ source: string;
6
+ };
7
+ export declare function resolveDevecoSdkHome(): string | undefined;
8
+ export interface BuildResult {
9
+ ok: boolean;
10
+ duration_ms: number;
11
+ hap_paths: string[];
12
+ stdout: string;
13
+ stderr: string;
14
+ hvigor_bin: string;
15
+ hvigor_bin_source: string;
16
+ deveco_sdk_home?: string;
17
+ }
18
+ /**
19
+ * 跑一次 assembleHap,并尝试从工程产物目录里**找出最新生成的 .hap 文件**。
20
+ * 第二步比解析 stdout 更可靠 —— DevEco 工程的产物路径有约定结构。
21
+ */
22
+ export declare function buildHap(args: {
23
+ projectDir: string;
24
+ buildMode?: "debug" | "release";
25
+ product?: string;
26
+ daemon?: boolean;
27
+ timeoutMs?: number;
28
+ logger?: Logger;
29
+ }): Promise<BuildResult>;
30
+ /** 让 `runHvigor 找不到 hvigorw` 时的错误更可读。 */
31
+ export declare function explainHvigorMissing(bin: string, source: string, cwd: string): HarmonyMcpError;
@@ -0,0 +1,179 @@
1
+ /**
2
+ * dev-mcp 内嵌的 hvigor 调用层 —— 与 hvigor-mcp 行为一致(autoResolve hvigorw + DEVECO_SDK_HOME),
3
+ * 但只保留 "build + 找出产物 hap 路径" 的最小集,让 run_app 编排链路尽可能短。
4
+ *
5
+ * 之所以不从 @harmony-mcp/hvigor 直接 import:那是 MCP server 入口(带 stdio 协议),
6
+ * 不适合作为库使用;复制少量纯函数代价更小、更稳。
7
+ */
8
+ import fs from "node:fs";
9
+ import fsAsync from "node:fs/promises";
10
+ import os from "node:os";
11
+ import path from "node:path";
12
+ import { HarmonyMcpError, runCommand } from "@harmony-mcp/common";
13
+ const HARMONY_MARKERS = [
14
+ "hvigorw",
15
+ "hvigorfile.ts",
16
+ "hvigorfile.js",
17
+ "build-profile.json5",
18
+ "oh-package.json5",
19
+ ];
20
+ export function detectProjectRoot(start) {
21
+ let cur = path.resolve(start);
22
+ try {
23
+ const st = fs.statSync(cur);
24
+ if (st.isFile())
25
+ cur = path.dirname(cur);
26
+ }
27
+ catch { /* ok */ }
28
+ const root = path.parse(cur).root;
29
+ while (cur && cur !== root) {
30
+ for (const m of HARMONY_MARKERS)
31
+ if (fs.existsSync(path.join(cur, m)))
32
+ return cur;
33
+ cur = path.dirname(cur);
34
+ }
35
+ return null;
36
+ }
37
+ export function resolveHvigorBin(projectDir) {
38
+ const isWin = process.platform === "win32";
39
+ const local = path.join(projectDir, isWin ? "hvigorw.bat" : "hvigorw");
40
+ if (fs.existsSync(local))
41
+ return { bin: local, source: "project" };
42
+ if (process.env.HVIGOR_BIN)
43
+ return { bin: process.env.HVIGOR_BIN, source: "env" };
44
+ const candidates = [];
45
+ if (process.platform === "darwin") {
46
+ candidates.push("/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw", path.join(os.homedir(), "Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw"));
47
+ }
48
+ else if (process.platform === "linux") {
49
+ candidates.push(path.join(os.homedir(), "DevEco-Studio/tools/hvigor/bin/hvigorw"), "/opt/DevEco-Studio/tools/hvigor/bin/hvigorw");
50
+ }
51
+ else {
52
+ candidates.push("C:\\Program Files\\Huawei\\DevEco Studio\\tools\\hvigor\\bin\\hvigorw.bat");
53
+ }
54
+ for (const c of candidates)
55
+ if (fs.existsSync(c))
56
+ return { bin: c, source: "deveco" };
57
+ return { bin: "hvigorw", source: "path" };
58
+ }
59
+ function scoreSdkRoot(dir) {
60
+ let s = 0;
61
+ try {
62
+ if (fs.existsSync(path.join(dir, "default/hms")))
63
+ s += 100;
64
+ if (fs.existsSync(path.join(dir, "default/openharmony")))
65
+ s += 50;
66
+ if (fs.existsSync(path.join(dir, "openharmony")))
67
+ s += 30;
68
+ for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
69
+ if (!ent.isDirectory())
70
+ continue;
71
+ const sub = path.join(dir, ent.name);
72
+ for (const k of ["ets", "toolchains", "native"])
73
+ if (fs.existsSync(path.join(sub, k))) {
74
+ s += 10;
75
+ break;
76
+ }
77
+ }
78
+ }
79
+ catch { /* ok */ }
80
+ return s;
81
+ }
82
+ export function resolveDevecoSdkHome() {
83
+ const env = process.env.DEVECO_SDK_HOME;
84
+ if (env && fs.existsSync(env))
85
+ return env;
86
+ const home = os.homedir();
87
+ const cands = [];
88
+ if (process.platform === "darwin") {
89
+ cands.push("/Applications/DevEco-Studio.app/Contents/sdk", "/Applications/DevEco-Studio.app/Contents/SDK", path.join(home, "Applications/DevEco-Studio.app/Contents/sdk"), path.join(home, "Library/OpenHarmony/Sdk"), path.join(home, "Library/Huawei/Sdk"));
90
+ }
91
+ else if (process.platform === "linux") {
92
+ cands.push("/opt/DevEco-Studio/sdk", path.join(home, "OpenHarmony/Sdk"), path.join(home, "Huawei/Sdk"));
93
+ }
94
+ else {
95
+ cands.push("C:\\Program Files\\Huawei\\DevEco Studio\\sdk", path.join(home, "AppData\\Local\\Huawei\\Sdk"));
96
+ }
97
+ let best;
98
+ for (const c of cands) {
99
+ if (!fs.existsSync(c))
100
+ continue;
101
+ const sc = scoreSdkRoot(c);
102
+ if (sc > 0 && (!best || sc > best.score))
103
+ best = { dir: c, score: sc };
104
+ }
105
+ if (best)
106
+ return best.dir;
107
+ for (const c of cands)
108
+ if (fs.existsSync(c))
109
+ return c;
110
+ return undefined;
111
+ }
112
+ /**
113
+ * 跑一次 assembleHap,并尝试从工程产物目录里**找出最新生成的 .hap 文件**。
114
+ * 第二步比解析 stdout 更可靠 —— DevEco 工程的产物路径有约定结构。
115
+ */
116
+ export async function buildHap(args) {
117
+ const cwd = args.projectDir;
118
+ const { bin, source } = resolveHvigorBin(cwd);
119
+ const sdk = resolveDevecoSdkHome();
120
+ const env = {};
121
+ if (sdk)
122
+ env.DEVECO_SDK_HOME = sdk;
123
+ const cli = [];
124
+ if (args.daemon === false)
125
+ cli.push("--no-daemon");
126
+ cli.push("assembleHap");
127
+ if (args.product)
128
+ cli.push("--mode", "module", "-p", `product=${args.product}`);
129
+ cli.push("-p", `buildMode=${args.buildMode ?? "debug"}`);
130
+ args.logger?.info("dev-mcp:hvigor", { bin, source, sdkHome: sdk, cli });
131
+ const r = await runCommand(bin, cli, { cwd, env, timeoutMs: args.timeoutMs ?? 600_000 });
132
+ const haps = await findRecentHaps(cwd, r.durationMs + 5_000);
133
+ return {
134
+ ok: r.exitCode === 0,
135
+ duration_ms: r.durationMs,
136
+ hap_paths: haps,
137
+ stdout: r.stdout,
138
+ stderr: r.stderr,
139
+ hvigor_bin: bin,
140
+ hvigor_bin_source: source,
141
+ deveco_sdk_home: sdk,
142
+ };
143
+ }
144
+ /** 扫描典型产物目录,挑出最近 `withinMs` 内被修改过的 .hap 路径。 */
145
+ async function findRecentHaps(projectDir, withinMs) {
146
+ const candidates = [];
147
+ const cutoff = Date.now() - withinMs;
148
+ // 标准布局:<module>/build/default/outputs/default/*.hap
149
+ async function walk(dir, depth) {
150
+ if (depth > 6)
151
+ return;
152
+ let entries;
153
+ try {
154
+ entries = await fsAsync.readdir(dir, { withFileTypes: true });
155
+ }
156
+ catch {
157
+ return;
158
+ }
159
+ for (const ent of entries) {
160
+ if (ent.name === "node_modules" || ent.name === "oh_modules" || ent.name === ".hvigor")
161
+ continue;
162
+ const full = path.join(dir, ent.name);
163
+ if (ent.isDirectory())
164
+ await walk(full, depth + 1);
165
+ else if (ent.isFile() && ent.name.endsWith(".hap")) {
166
+ const st = await fsAsync.stat(full);
167
+ if (st.mtimeMs >= cutoff)
168
+ candidates.push(full);
169
+ }
170
+ }
171
+ }
172
+ await walk(projectDir, 0);
173
+ return candidates.sort();
174
+ }
175
+ /** 让 `runHvigor 找不到 hvigorw` 时的错误更可读。 */
176
+ export function explainHvigorMissing(bin, source, cwd) {
177
+ return new HarmonyMcpError("HVIGOR_BIN_NOT_FOUND", `无法启动 hvigor:${bin}(${source})。工程根 ${cwd} 下没有 hvigorw,DevEco 默认位置/PATH 也没有。请用 DevEco Studio 打开该工程一次让其生成本地 hvigorw,或设置 HVIGOR_BIN 环境变量。`, { project_dir: cwd, attempted_bin: bin, source });
178
+ }
179
+ //# sourceMappingURL=hvigor-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hvigor-bridge.js","sourceRoot":"","sources":["../../../../packages/dev-mcp/src/hvigor-bridge.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node
2
+ import { z } from "zod";
3
+ import { ToolDef } from "@harmony-mcp/common";
4
+ export declare const NAMESPACE = "dev";
5
+ export declare const tools: ToolDef<z.ZodObject<z.ZodRawShape>>[];
@@ -0,0 +1,256 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * harmony-dev-mcp: HarmonyOS 开发循环 MCP(DevEco Run 等价)
4
+ *
5
+ * 工具集:
6
+ * - run_app 一句话:build → install → start → 短暂尾随 hilog(同步返回)
7
+ * - start_log_stream 启动长寿命 hilog 流,返回 task_id
8
+ * - read_log_stream 按 since 游标增量拉日志
9
+ * - stop_log_stream 停止指定流
10
+ * - list_log_streams 列出当前所有活跃流
11
+ */
12
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
13
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
14
+ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
15
+ import { z } from "zod";
16
+ import { createLogger, HarmonyMcpError, isMainModule, PathSandbox, registerTools, runCommand, } from "@harmony-mcp/common";
17
+ import { buildHap, detectProjectRoot } from "./hvigor-bridge.js";
18
+ import { LogStreamManager } from "./log-stream.js";
19
+ const logger = createLogger("dev-mcp");
20
+ const sandbox = new PathSandbox({ allowedRoots: [], autoDetectProjectRoot: true });
21
+ const HDC_BIN = process.env.HDC_BIN ?? "hdc";
22
+ const DEFAULT_TARGET = process.env.HDC_TARGET;
23
+ const streams = new LogStreamManager();
24
+ process.on("SIGTERM", () => streams.shutdown());
25
+ process.on("SIGINT", () => { streams.shutdown(); process.exit(0); });
26
+ // ---------- Schemas ----------
27
+ const TargetField = z.string().min(1).optional().describe("设备序列号;不填使用默认设备");
28
+ const RunAppSchema = z.object({
29
+ project_dir: z.string().describe("鸿蒙工程根目录绝对路径"),
30
+ bundle_name: z.string().describe("应用 bundleName,例如 com.example.demo"),
31
+ ability_name: z.string().default("EntryAbility").describe("Ability 名"),
32
+ build_mode: z.enum(["debug", "release"]).default("debug"),
33
+ product: z.string().optional().describe("可选:工程 build-profile.json5 自定义 product"),
34
+ daemon: z.boolean().default(true).describe("是否启用 hvigor daemon(增量构建会快很多,默认开)"),
35
+ skip_build: z.boolean().default(false).describe("跳过 build,直接 install + start(已有 hap 时调试用)"),
36
+ hap_path: z.string().optional().describe("当 skip_build=true 时使用的本地 hap 路径;否则取 build 产物"),
37
+ follow_log_seconds: z.number().int().min(0).max(60).default(5)
38
+ .describe("启动后同步尾随 hilog 的秒数;0 表示不尾随。日志会内嵌在返回里。"),
39
+ log_level: z.enum(["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]).default("INFO"),
40
+ target: TargetField,
41
+ });
42
+ const StartLogStreamSchema = z.object({
43
+ bundle_name: z.string().optional().describe("可选:仅过滤该应用对应 pid 的日志"),
44
+ pid: z.number().int().positive().optional().describe("可选:直接按 pid 过滤"),
45
+ tag: z.string().optional(),
46
+ level: z.enum(["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]).default("INFO"),
47
+ buffer_capacity: z.number().int().positive().max(50000).default(5000),
48
+ target: TargetField,
49
+ });
50
+ const ReadLogStreamSchema = z.object({
51
+ task_id: z.string(),
52
+ since_seq: z.number().int().nonnegative().default(0).describe("上一次拉到的最大 seq,从 0 开始"),
53
+ max_lines: z.number().int().positive().max(2000).default(200),
54
+ });
55
+ const StopLogStreamSchema = z.object({ task_id: z.string() });
56
+ const ListLogStreamsSchema = z.object({});
57
+ // ---------- Helpers ----------
58
+ async function hdc(args, target, timeoutMs = 60_000) {
59
+ const finalTarget = target ?? DEFAULT_TARGET;
60
+ const finalArgs = finalTarget ? ["-t", finalTarget, ...args] : args;
61
+ return runCommand(HDC_BIN, finalArgs, { timeoutMs });
62
+ }
63
+ async function resolvePid(bundle, target) {
64
+ const r = await hdc(["shell", "pidof", bundle], target, 5_000);
65
+ if (r.exitCode !== 0)
66
+ return undefined;
67
+ const first = r.stdout.trim().split(/\s+/)[0];
68
+ const n = Number(first);
69
+ return Number.isFinite(n) && n > 0 ? n : undefined;
70
+ }
71
+ // ---------- Tools ----------
72
+ export const NAMESPACE = "dev";
73
+ export const tools = [
74
+ {
75
+ name: "run_app",
76
+ description: "一句话把鸿蒙工程跑到设备:build → install → aa start,并可选地同步尾随几秒 hilog。" +
77
+ "对应 DevEco Studio 的 Run 按钮。",
78
+ schema: RunAppSchema,
79
+ handler: async (a) => {
80
+ const projectRoot = detectProjectRoot(a.project_dir) ?? a.project_dir;
81
+ sandbox.ensureReadOnlyRoot(projectRoot);
82
+ const timeline = [];
83
+ const t0 = Date.now();
84
+ // 1) build
85
+ let hapPath = a.hap_path;
86
+ if (!a.skip_build) {
87
+ const ts = Date.now();
88
+ const build = await buildHap({
89
+ projectDir: projectRoot,
90
+ buildMode: a.build_mode,
91
+ product: a.product,
92
+ daemon: a.daemon,
93
+ logger,
94
+ });
95
+ timeline.push({
96
+ step: "build",
97
+ ok: build.ok,
98
+ ms: Date.now() - ts,
99
+ detail: {
100
+ hap_paths: build.hap_paths,
101
+ hvigor_bin: build.hvigor_bin,
102
+ hvigor_bin_source: build.hvigor_bin_source,
103
+ deveco_sdk_home: build.deveco_sdk_home,
104
+ stderr_tail: build.stderr.split("\n").slice(-8).join("\n"),
105
+ },
106
+ });
107
+ if (!build.ok) {
108
+ throw new HarmonyMcpError("BUILD_FAILED", "hvigor assembleHap failed", {
109
+ timeline,
110
+ stderr_tail: build.stderr.slice(-2000),
111
+ });
112
+ }
113
+ if (!hapPath)
114
+ hapPath = pickPreferredHap(build.hap_paths);
115
+ if (!hapPath) {
116
+ throw new HarmonyMcpError("NO_HAP_PRODUCED", "build succeeded but no .hap found under project", {
117
+ timeline,
118
+ });
119
+ }
120
+ }
121
+ else if (!hapPath) {
122
+ throw new HarmonyMcpError("HAP_PATH_REQUIRED", "skip_build=true 时必须传 hap_path");
123
+ }
124
+ // 2) install
125
+ {
126
+ const ts = Date.now();
127
+ const r = await hdc(["install", "-r", hapPath], a.target, 180_000);
128
+ timeline.push({
129
+ step: "install",
130
+ ok: r.exitCode === 0,
131
+ ms: Date.now() - ts,
132
+ detail: { hap_path: hapPath, stdout: r.stdout.trim(), stderr: r.stderr.trim() || undefined },
133
+ });
134
+ if (r.exitCode !== 0) {
135
+ throw new HarmonyMcpError("INSTALL_FAILED", r.stderr || r.stdout, { timeline });
136
+ }
137
+ }
138
+ // 3) force-stop(避免老进程残留影响)
139
+ await hdc(["shell", "aa", "force-stop", a.bundle_name], a.target, 10_000);
140
+ // 4) start
141
+ {
142
+ const ts = Date.now();
143
+ const r = await hdc(["shell", "aa", "start", "-b", a.bundle_name, "-a", a.ability_name], a.target, 15_000);
144
+ timeline.push({
145
+ step: "start",
146
+ ok: r.exitCode === 0 && /start ability successfully/i.test(r.stdout),
147
+ ms: Date.now() - ts,
148
+ detail: { stdout: r.stdout.trim(), stderr: r.stderr.trim() || undefined },
149
+ });
150
+ if (r.exitCode !== 0) {
151
+ throw new HarmonyMcpError("START_FAILED", r.stderr || r.stdout, { timeline });
152
+ }
153
+ }
154
+ // 5) 解析 pid,做精准日志过滤
155
+ const pid = await resolvePid(a.bundle_name, a.target);
156
+ // 6) 可选:尾随 follow_log_seconds 秒
157
+ let log_task_id;
158
+ let initial_lines = [];
159
+ let state;
160
+ if (a.follow_log_seconds > 0) {
161
+ const meta = streams.start({
162
+ hdcBin: HDC_BIN,
163
+ target: a.target ?? DEFAULT_TARGET,
164
+ pid,
165
+ level: a.log_level,
166
+ bundle_name: a.bundle_name,
167
+ logger,
168
+ });
169
+ log_task_id = meta.task_id;
170
+ await new Promise((res) => setTimeout(res, a.follow_log_seconds * 1000));
171
+ const snap = streams.read(meta.task_id, 0, 500);
172
+ initial_lines = snap.lines;
173
+ state = snap.state;
174
+ }
175
+ return {
176
+ ok: true,
177
+ total_ms: Date.now() - t0,
178
+ timeline,
179
+ bundle_name: a.bundle_name,
180
+ ability_name: a.ability_name,
181
+ pid,
182
+ hap_path: hapPath,
183
+ log_task_id,
184
+ log_state: state,
185
+ log_lines: initial_lines,
186
+ hint: log_task_id
187
+ ? `日志流仍在后台运行,可继续调用 read_log_stream(task_id="${log_task_id}", since_seq=<上次seq>) 拉新日志;用完调 stop_log_stream 释放。`
188
+ : `如需持续看日志,调 start_log_stream(bundle_name="${a.bundle_name}")`,
189
+ };
190
+ },
191
+ },
192
+ {
193
+ name: "start_log_stream",
194
+ description: "启动长寿命 hilog 流(后台跑 hdc hilog -x),返回 task_id,配合 read_log_stream 增量拉取",
195
+ schema: StartLogStreamSchema,
196
+ handler: async (a) => {
197
+ let pid = a.pid;
198
+ if (!pid && a.bundle_name)
199
+ pid = await resolvePid(a.bundle_name, a.target);
200
+ const meta = streams.start({
201
+ hdcBin: HDC_BIN,
202
+ target: a.target ?? DEFAULT_TARGET,
203
+ pid,
204
+ tag: a.tag,
205
+ level: a.level,
206
+ bundle_name: a.bundle_name,
207
+ bufferCapacity: a.buffer_capacity,
208
+ logger,
209
+ });
210
+ return { ...meta, hint: `用 read_log_stream(task_id="${meta.task_id}", since_seq=0) 开始拉日志。` };
211
+ },
212
+ },
213
+ {
214
+ name: "read_log_stream",
215
+ description: "增量拉取流式日志;since_seq 传上次返回的最大 seq",
216
+ schema: ReadLogStreamSchema,
217
+ handler: async (a) => streams.read(a.task_id, a.since_seq, a.max_lines),
218
+ },
219
+ {
220
+ name: "stop_log_stream",
221
+ description: "停止指定 task_id 的 hilog 流,释放设备 hdc 通道",
222
+ schema: StopLogStreamSchema,
223
+ handler: async (a) => streams.stop(a.task_id),
224
+ },
225
+ {
226
+ name: "list_log_streams",
227
+ description: "列出当前所有活跃的 hilog 流任务",
228
+ schema: ListLogStreamsSchema,
229
+ handler: async () => ({ streams: streams.list() }),
230
+ },
231
+ ];
232
+ /** 多个 hap 时优先选 entry-default-signed.hap > *-signed.hap > 第一个。 */
233
+ function pickPreferredHap(haps) {
234
+ if (!haps.length)
235
+ return undefined;
236
+ const signed = haps.filter((p) => /-signed\.hap$/.test(p));
237
+ if (signed.length) {
238
+ const entry = signed.find((p) => /\/entry-/.test(p)) ?? signed[0];
239
+ return entry;
240
+ }
241
+ return haps[0];
242
+ }
243
+ // ---------- Boot ----------
244
+ async function main() {
245
+ const server = new Server({ name: "harmony-dev-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
246
+ registerTools(server, { ListToolsRequestSchema, CallToolRequestSchema }, tools);
247
+ await server.connect(new StdioServerTransport());
248
+ logger.info("dev-mcp server started", { hdcBin: HDC_BIN });
249
+ }
250
+ if (isMainModule(import.meta.url)) {
251
+ main().catch((err) => {
252
+ logger.error("fatal", { err: String(err) });
253
+ process.exit(1);
254
+ });
255
+ }
256
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/dev-mcp/src/index.ts"],"names":[],"mappings":"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"}