harmony-build 0.2.0

package/dist/packages/dev-mcp/src/log-stream.d.ts

@@ -0,0 +1,56 @@
+import { Logger } from "@harmony-mcp/common";
+export interface LogLine {
+    seq: number;
+    ts: string;
+    level: string;
+    tag?: string;
+    pid?: number;
+    text: string;
+}
+export interface LogTaskMeta {
+    task_id: string;
+    started_at: string;
+    pid_filter?: number;
+    tag_filter?: string;
+    level_filter?: string;
+    device?: string;
+    bundle_name?: string;
+}
+export interface LogTaskState extends LogTaskMeta {
+    status: "running" | "stopped" | "error";
+    total_lines: number;
+    errors: number;
+    warnings: number;
+    buffer_size: number;
+    last_error?: string;
+    /** 检测到的崩溃事件（最多 10 个） */
+    crashes: Array<{
+        ts: string;
+        signal?: string;
+        preview: string;
+    }>;
+}
+export interface StartLogStreamOptions {
+    hdcBin: string;
+    target?: string;
+    pid?: number;
+    tag?: string;
+    level?: "DEBUG" | "INFO" | "WARN" | "ERROR" | "FATAL";
+    bundle_name?: string;
+    /** 环形缓冲容量；超出旧的覆盖；默认 5000 行 */
+    bufferCapacity?: number;
+    logger?: Logger;
+}
+export declare class LogStreamManager {
+    private tasks;
+    private idCounter;
+    start(opts: StartLogStreamOptions): LogTaskMeta;
+    read(taskId: string, sinceSeq?: number, max?: number): {
+        lines: LogLine[];
+        state: LogTaskState;
+    };
+    stop(taskId: string): LogTaskState;
+    list(): LogTaskState[];
+    /** 进程退出时调用，避免泄漏。 */
+    shutdown(): void;
+}

package/dist/packages/dev-mcp/src/log-stream.js

@@ -0,0 +1,147 @@
+/**
+ * 长寿命日志流管理：把 `hdc hilog` 进程长期挂着，
+ * 在 server 内存里维护环形缓冲，外部通过 task_id + since 增量拉取。
+ *
+ * 这是把 MCP "请求-响应" 模式改造成"对话里实时看日志"的关键模块。
+ */
+import { spawn } from "node:child_process";
+const HILOG_PARSE = /^(\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\.\d+)\s+(\d+)\s+(\d+)\s+([DIWEF])\s+([\w-]+)?\s*:\s*(.*)$/;
+const CRASH_HINTS = /\b(FaultLogger|OH_CRASH|libc fatal|signal\s+\d+\s+\(SIG)/i;
+export class LogStreamManager {
+    tasks = new Map();
+    idCounter = 0;
+    start(opts) {
+        const taskId = `log-${Date.now().toString(36)}-${this.idCounter++}`;
+        const args = [];
+        if (opts.target)
+            args.push("-t", opts.target);
+        args.push("shell", "hilog");
+        if (opts.level)
+            args.push("-L", levelShort(opts.level));
+        if (opts.pid)
+            args.push("-P", String(opts.pid));
+        if (opts.tag)
+            args.push("-T", opts.tag);
+        // 一直流式输出
+        args.push("-x");
+        const child = spawn(opts.hdcBin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        const meta = {
+            task_id: taskId,
+            started_at: new Date().toISOString(),
+            pid_filter: opts.pid,
+            tag_filter: opts.tag,
+            level_filter: opts.level,
+            device: opts.target,
+            bundle_name: opts.bundle_name,
+        };
+        const task = {
+            meta,
+            child,
+            buffer: [],
+            capacity: opts.bufferCapacity ?? 5000,
+            nextSeq: 1,
+            status: "running",
+            errors: 0,
+            warnings: 0,
+            crashes: [],
+        };
+        let stdoutCarry = "";
+        child.stdout?.on("data", (chunk) => {
+            stdoutCarry += chunk.toString("utf8");
+            let idx;
+            while ((idx = stdoutCarry.indexOf("\n")) !== -1) {
+                const raw = stdoutCarry.slice(0, idx).trimEnd();
+                stdoutCarry = stdoutCarry.slice(idx + 1);
+                if (!raw)
+                    continue;
+                const line = parseHilog(raw, task.nextSeq++);
+                if (!line)
+                    continue;
+                appendLine(task, line);
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            task.lastError = chunk.toString("utf8").slice(0, 500);
+        });
+        child.on("exit", (code) => {
+            task.status = code === 0 ? "stopped" : "error";
+            if (code !== 0 && code !== null) {
+                task.lastError = `hdc hilog exited with code ${code}: ${task.lastError ?? ""}`;
+            }
+            opts.logger?.info("log stream ended", { task: taskId, code });
+        });
+        child.on("error", (err) => {
+            task.status = "error";
+            task.lastError = err.message;
+        });
+        this.tasks.set(taskId, task);
+        return meta;
+    }
+    read(taskId, sinceSeq = 0, max = 200) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            throw new Error(`unknown task: ${taskId}`);
+        const slice = task.buffer.filter((l) => l.seq > sinceSeq).slice(0, max);
+        return { lines: slice, state: snapshot(task) };
+    }
+    stop(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            throw new Error(`unknown task: ${taskId}`);
+        if (task.child.exitCode === null)
+            task.child.kill("SIGTERM");
+        task.status = "stopped";
+        return snapshot(task);
+    }
+    list() {
+        return [...this.tasks.values()].map(snapshot);
+    }
+    /** 进程退出时调用，避免泄漏。 */
+    shutdown() {
+        for (const t of this.tasks.values())
+            if (t.child.exitCode === null)
+                t.child.kill("SIGTERM");
+        this.tasks.clear();
+    }
+}
+function appendLine(task, line) {
+    task.buffer.push(line);
+    if (task.buffer.length > task.capacity)
+        task.buffer.splice(0, task.buffer.length - task.capacity);
+    if (line.level === "E" || line.level === "F")
+        task.errors++;
+    else if (line.level === "W")
+        task.warnings++;
+    if (CRASH_HINTS.test(line.text) && task.crashes.length < 10) {
+        task.crashes.push({ ts: line.ts, preview: line.text.slice(0, 240) });
+    }
+}
+function parseHilog(raw, seq) {
+    const m = HILOG_PARSE.exec(raw);
+    if (!m)
+        return { seq, ts: "", level: "I", text: raw };
+    return {
+        seq,
+        ts: m[1],
+        pid: Number(m[2]),
+        level: m[4],
+        tag: m[5],
+        text: m[6],
+    };
+}
+function levelShort(l) {
+    return { DEBUG: "D", INFO: "I", WARN: "W", ERROR: "E", FATAL: "F" }[l] ?? "I";
+}
+function snapshot(t) {
+    return {
+        ...t.meta,
+        status: t.status,
+        total_lines: t.nextSeq - 1,
+        errors: t.errors,
+        warnings: t.warnings,
+        buffer_size: t.buffer.length,
+        last_error: t.lastError,
+        crashes: t.crashes,
+    };
+}
+//# sourceMappingURL=log-stream.js.map

package/dist/packages/dev-mcp/src/log-stream.js.map

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

package/dist/packages/harmony-knowledge-mcp/src/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { z } from "zod";
+import { ToolDef } from "@harmony-mcp/common";
+export declare const NAMESPACE = "knowledge";
+export declare const tools: ToolDef<z.ZodObject<z.ZodRawShape>>[];

package/dist/packages/harmony-knowledge-mcp/src/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * harmony-knowledge-mcp: 把鸿蒙开发知识库（公司性能 SOP、最佳实践、提案）暴露为：
+ *   - Resources：harmony-kb://docs/<rel-path>
+ *   - Tools：search_kb（关键字检索），read_doc（按路径读取）
+ *
+ * 知识库根目录通过 HARMONY_KB_ROOTS 环境变量配置（多个用 PATH 分隔符隔开）。
+ * 默认：仓库的 docs/ 和 proposals/。
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createLogger, HarmonyMcpError, isMainModule, registerTools, } from "@harmony-mcp/common";
+const logger = createLogger("harmony-knowledge-mcp");
+const kbRoots = (process.env.HARMONY_KB_ROOTS ?? defaultRoots())
+    .split(path.delimiter)
+    .filter(Boolean)
+    .map((p) => path.resolve(p));
+function defaultRoots() {
+    // 相对当前 cwd 找仓库内的 docs/ 与 proposals/
+    return [path.resolve("docs"), path.resolve("proposals")].join(path.delimiter);
+}
+async function walkMd(root) {
+    const out = [];
+    try {
+        await fs.access(root);
+    }
+    catch {
+        return out;
+    }
+    async function rec(d) {
+        const entries = await fs.readdir(d, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.name.startsWith(".") || e.name === "node_modules")
+                continue;
+            const full = path.join(d, e.name);
+            if (e.isDirectory())
+                await rec(full);
+            else if (full.endsWith(".md") || full.endsWith(".sh") || full.endsWith(".txt")) {
+                out.push(full);
+            }
+        }
+    }
+    await rec(root);
+    return out;
+}
+function toUri(abs) {
+    // 用第一个匹配的 root 计算相对路径
+    for (const root of kbRoots) {
+        if (abs === root || abs.startsWith(root + path.sep)) {
+            const rel = path.relative(root, abs);
+            const rootName = path.basename(root);
+            return `harmony-kb://${rootName}/${rel.split(path.sep).join("/")}`;
+        }
+    }
+    return `harmony-kb://orphan/${path.basename(abs)}`;
+}
+function fromUri(uri) {
+    const m = /^harmony-kb:\/\/([^/]+)\/(.+)$/.exec(uri);
+    if (!m)
+        throw new HarmonyMcpError("INVALID_URI", `bad uri: ${uri}`);
+    const [, rootName, rel] = m;
+    const root = kbRoots.find((r) => path.basename(r) === rootName);
+    if (!root)
+        throw new HarmonyMcpError("UNKNOWN_ROOT", `unknown kb root: ${rootName}`);
+    const abs = path.resolve(root, rel);
+    if (!(abs === root || abs.startsWith(root + path.sep))) {
+        throw new HarmonyMcpError("URI_ESCAPES_ROOT", `uri escapes kb root: ${uri}`);
+    }
+    return abs;
+}
+const SearchKbSchema = z.object({
+    query: z.string().describe("要检索的关键字（多个空格分隔，全部出现才算命中）"),
+    max_results: z.number().int().positive().max(50).default(10),
+});
+const ReadDocSchema = z.object({
+    uri: z.string().describe("harmony-kb:// 协议的资源 URI"),
+});
+export const NAMESPACE = "knowledge";
+export const tools = [
+    {
+        name: "search_kb",
+        description: "在鸿蒙知识库（docs/proposals/SOP）里按关键字检索片段",
+        schema: SearchKbSchema,
+        handler: async (a) => {
+            const terms = a.query.split(/\s+/).filter(Boolean).map((t) => t.toLowerCase());
+            const hits = [];
+            for (const root of kbRoots) {
+                const files = await walkMd(root);
+                for (const f of files) {
+                    const text = await fs.readFile(f, "utf8");
+                    const lower = text.toLowerCase();
+                    if (!terms.every((t) => lower.includes(t)))
+                        continue;
+                    const lines = text.split(/\r?\n/);
+                    for (let i = 0; i < lines.length; i++) {
+                        const ll = lines[i].toLowerCase();
+                        const hitCount = terms.reduce((s, t) => s + (ll.includes(t) ? 1 : 0), 0);
+                        if (hitCount === 0)
+                            continue;
+                        hits.push({
+                            uri: toUri(f),
+                            line: i + 1,
+                            preview: lines[i].trim().slice(0, 200),
+                            score: hitCount,
+                        });
+                    }
+                }
+            }
+            hits.sort((a, b) => b.score - a.score);
+            return { query: a.query, hits: hits.slice(0, a.max_results), total: hits.length };
+        },
+    },
+    {
+        name: "read_doc",
+        description: "按 harmony-kb:// URI 读取完整文档内容",
+        schema: ReadDocSchema,
+        handler: async (a) => {
+            const abs = fromUri(a.uri);
+            const text = await fs.readFile(abs, "utf8");
+            return { uri: a.uri, bytes: text.length, content: text };
+        },
+    },
+];
+async function main() {
+    const server = new Server({ name: "harmony-knowledge-mcp", version: "0.1.0" }, { capabilities: { tools: {}, resources: {} } });
+    // Resources：列出所有文档
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const all = [];
+        for (const root of kbRoots) {
+            const files = await walkMd(root);
+            for (const f of files) {
+                all.push({
+                    uri: toUri(f),
+                    name: path.relative(root, f),
+                    mimeType: f.endsWith(".md") ? "text/markdown" : "text/plain",
+                });
+            }
+        }
+        return { resources: all };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+        const uri = req.params.uri;
+        const abs = fromUri(uri);
+        const text = await fs.readFile(abs, "utf8");
+        const mimeType = abs.endsWith(".md") ? "text/markdown" : "text/plain";
+        return {
+            contents: [{ uri, mimeType, text }],
+        };
+    });
+    registerTools(server, { ListToolsRequestSchema, CallToolRequestSchema }, tools);
+    await server.connect(new StdioServerTransport());
+    logger.info("harmony-knowledge-mcp started", { kbRoots });
+}
+if (isMainModule(import.meta.url)) {
+    main().catch((err) => {
+        logger.error("fatal", { err: String(err) });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/packages/harmony-knowledge-mcp/src/index.js.map

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

package/dist/packages/hdc-mcp/src/hdc-runner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * hdc 调用层：所有对 hdc CLI 的调用都通过这里走，统一处理 hdc 路径、超时、错误。
+ */
+import { RunResult, Logger } from "@harmony-mcp/common";
+export interface HdcRunnerOptions {
+    /** hdc 可执行文件路径；默认从环境变量 HDC_BIN 取，否则 'hdc' */
+    hdcBin?: string;
+    /** 默认目标设备序列号；可被单次调用覆盖 */
+    defaultTarget?: string;
+    /** 命令默认超时 */
+    timeoutMs?: number;
+    logger: Logger;
+}
+export declare class HdcRunner {
+    private readonly hdcBin;
+    private readonly defaultTarget?;
+    private readonly timeoutMs;
+    private readonly logger;
+    constructor(opts: HdcRunnerOptions);
+    /** 运行原始 hdc 命令；自动注入 -t <target>（如果传了 target）。 */
+    raw(args: string[], target?: string, timeoutMs?: number): Promise<RunResult>;
+    /** `hdc list targets` 解析为字符串数组 */
+    listTargets(): Promise<string[]>;
+    /** `hdc install <hap>` */
+    installHap(hapPath: string, target?: string): Promise<RunResult>;
+    /** `hdc uninstall <bundle>` */
+    uninstall(bundleName: string, target?: string): Promise<RunResult>;
+    /** `hdc shell <...>`  —— 注意：禁止任意 shell，调用方需做白名单 */
+    shell(args: string[], target?: string, timeoutMs?: number): Promise<RunResult>;
+    /** `hdc file recv <remote> <local>` */
+    fileRecv(remote: string, local: string, target?: string): Promise<RunResult>;
+}

package/dist/packages/hdc-mcp/src/hdc-runner.js

@@ -0,0 +1,60 @@
+/**
+ * hdc 调用层：所有对 hdc CLI 的调用都通过这里走，统一处理 hdc 路径、超时、错误。
+ */
+import { runCommand, HarmonyMcpError } from "@harmony-mcp/common";
+export class HdcRunner {
+    hdcBin;
+    defaultTarget;
+    timeoutMs;
+    logger;
+    constructor(opts) {
+        this.hdcBin = opts.hdcBin ?? process.env.HDC_BIN ?? "hdc";
+        this.defaultTarget = opts.defaultTarget ?? process.env.HDC_TARGET;
+        this.timeoutMs = opts.timeoutMs ?? 60_000;
+        this.logger = opts.logger;
+    }
+    /** 运行原始 hdc 命令；自动注入 -t <target>（如果传了 target）。 */
+    async raw(args, target, timeoutMs) {
+        const finalTarget = target ?? this.defaultTarget;
+        const finalArgs = finalTarget ? ["-t", finalTarget, ...args] : args;
+        this.logger.debug("hdc exec", { args: finalArgs });
+        const result = await runCommand(this.hdcBin, finalArgs, {
+            timeoutMs: timeoutMs ?? this.timeoutMs,
+        });
+        if (result.exitCode !== 0) {
+            this.logger.warn("hdc non-zero exit", {
+                exitCode: result.exitCode,
+                stderr: result.stderr.slice(0, 500),
+            });
+        }
+        return result;
+    }
+    /** `hdc list targets` 解析为字符串数组 */
+    async listTargets() {
+        const res = await this.raw(["list", "targets"]);
+        if (res.exitCode !== 0) {
+            throw new HarmonyMcpError("HDC_LIST_FAILED", res.stderr || "hdc list targets failed");
+        }
+        return res.stdout
+            .split(/\r?\n/)
+            .map((l) => l.trim())
+            .filter((l) => l && l !== "[Empty]");
+    }
+    /** `hdc install <hap>` */
+    async installHap(hapPath, target) {
+        return this.raw(["install", hapPath], target, 180_000);
+    }
+    /** `hdc uninstall <bundle>` */
+    async uninstall(bundleName, target) {
+        return this.raw(["uninstall", bundleName], target);
+    }
+    /** `hdc shell <...>`  —— 注意：禁止任意 shell，调用方需做白名单 */
+    async shell(args, target, timeoutMs) {
+        return this.raw(["shell", ...args], target, timeoutMs);
+    }
+    /** `hdc file recv <remote> <local>` */
+    async fileRecv(remote, local, target) {
+        return this.raw(["file", "recv", remote, local], target, 180_000);
+    }
+}
+//# sourceMappingURL=hdc-runner.js.map

package/dist/packages/hdc-mcp/src/hdc-runner.js.map

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

package/dist/packages/hdc-mcp/src/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { z } from "zod";
+import { ToolDef } from "@harmony-mcp/common";
+export declare const NAMESPACE = "hdc";
+export declare const tools: ToolDef<z.ZodObject<z.ZodRawShape>>[];

package/dist/packages/hdc-mcp/src/index.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/**
+ * hdc-mcp: 鸿蒙 hdc 命令行的 MCP Server 化。
+ *
+ * 提供的工具：
+ *   - list_devices         列出当前连接的设备
+ *   - install_hap          安装 HAP 包
+ *   - uninstall            按 bundleName 卸载
+ *   - start_ability        启动指定 Ability
+ *   - stop_ability         按 bundleName 停止
+ *   - hilog_capture        抓取 hilog（按 level/tag 过滤）
+ *   - screencap            截屏并把图片拉回本地
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs/promises";
+import { createLogger, HarmonyMcpError, isMainModule, registerTools } from "@harmony-mcp/common";
+import { HdcRunner } from "./hdc-runner.js";
+const logger = createLogger("hdc-mcp");
+const hdc = new HdcRunner({ logger });
+// ---------- Schemas ----------
+const TargetField = z.string().min(1).optional().describe("设备序列号；不填使用默认设备");
+const ListDevicesSchema = z.object({});
+const InstallHapSchema = z.object({
+    hap_path: z.string().describe("要安装的 .hap 文件本地绝对路径"),
+    target: TargetField,
+});
+const UninstallSchema = z.object({
+    bundle_name: z.string().describe("应用 bundleName，例如 com.example.demo"),
+    target: TargetField,
+});
+const StartAbilitySchema = z.object({
+    bundle_name: z.string().describe("应用 bundleName"),
+    ability_name: z.string().describe("Ability 名，例如 EntryAbility"),
+    target: TargetField,
+});
+const StopAbilitySchema = z.object({
+    bundle_name: z.string().describe("应用 bundleName"),
+    target: TargetField,
+});
+const HilogCaptureSchema = z.object({
+    duration_seconds: z.number().int().positive().max(120).default(5)
+        .describe("抓取时长（秒），上限 120"),
+    level: z.enum(["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]).optional()
+        .describe("最低日志等级"),
+    tag: z.string().optional().describe("按 tag 过滤"),
+    pid: z.number().int().optional().describe("按进程 PID 过滤"),
+    target: TargetField,
+});
+const ScreencapSchema = z.object({
+    local_path: z.string().optional()
+        .describe("本地保存路径，省略则保存到系统临时目录"),
+    target: TargetField,
+});
+// ---------- Tools ----------
+export const NAMESPACE = "hdc";
+export const tools = [
+    {
+        name: "list_devices",
+        description: "列出当前 hdc 检测到的所有设备/模拟器",
+        schema: ListDevicesSchema,
+        handler: async () => ({ devices: await hdc.listTargets() }),
+    },
+    {
+        name: "install_hap",
+        description: "安装 HAP 包到指定设备",
+        schema: InstallHapSchema,
+        handler: async (a) => {
+            const r = await hdc.installHap(a.hap_path, a.target);
+            return { ok: r.exitCode === 0, exit_code: r.exitCode, stdout: r.stdout, stderr: r.stderr };
+        },
+    },
+    {
+        name: "uninstall",
+        description: "按 bundleName 卸载应用",
+        schema: UninstallSchema,
+        handler: async (a) => {
+            const r = await hdc.uninstall(a.bundle_name, a.target);
+            return { ok: r.exitCode === 0, exit_code: r.exitCode, stdout: r.stdout, stderr: r.stderr };
+        },
+    },
+    {
+        name: "start_ability",
+        description: "启动指定 Ability（aa start -b <bundle> -a <ability>）",
+        schema: StartAbilitySchema,
+        handler: async (a) => {
+            const r = await hdc.shell(["aa", "start", "-b", a.bundle_name, "-a", a.ability_name], a.target);
+            return { ok: r.exitCode === 0, stdout: r.stdout, stderr: r.stderr };
+        },
+    },
+    {
+        name: "stop_ability",
+        description: "停止指定 bundleName 的进程（aa force-stop）",
+        schema: StopAbilitySchema,
+        handler: async (a) => {
+            const r = await hdc.shell(["aa", "force-stop", a.bundle_name], a.target);
+            return { ok: r.exitCode === 0, stdout: r.stdout, stderr: r.stderr };
+        },
+    },
+    {
+        name: "hilog_capture",
+        description: "抓取 hilog（可按 level/tag/pid 过滤），返回原始日志文本",
+        schema: HilogCaptureSchema,
+        handler: async (a) => {
+            const args = ["hilog"];
+            if (a.level)
+                args.push("-L", a.level);
+            if (a.tag)
+                args.push("-T", a.tag);
+            if (a.pid !== undefined)
+                args.push("-P", String(a.pid));
+            args.push("-x");
+            const r = await hdc.shell(args, a.target, (a.duration_seconds + 5) * 1000);
+            return { duration_seconds: a.duration_seconds, log: r.stdout, truncated: r.truncated };
+        },
+    },
+    {
+        name: "screencap",
+        description: "截屏并保存到本地",
+        schema: ScreencapSchema,
+        handler: async (a) => {
+            const localPath = a.local_path ?? path.join(os.tmpdir(), `harmony-screencap-${Date.now()}.png`);
+            const remoteTmp = `/data/local/tmp/mcp-screencap-${Date.now()}.png`;
+            const cap = await hdc.shell(["snapshot_display", "-f", remoteTmp], a.target, 15_000);
+            if (cap.exitCode !== 0) {
+                throw new HarmonyMcpError("SCREENCAP_FAILED", cap.stderr || "snapshot_display failed");
+            }
+            const recv = await hdc.fileRecv(remoteTmp, localPath, a.target);
+            if (recv.exitCode !== 0) {
+                throw new HarmonyMcpError("FILE_RECV_FAILED", recv.stderr || "file recv failed");
+            }
+            const stat = await fs.stat(localPath);
+            return { local_path: localPath, bytes: stat.size };
+        },
+    },
+];
+// ---------- Boot ----------
+async function main() {
+    const server = new Server({ name: "harmony-hdc-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    registerTools(server, { ListToolsRequestSchema, CallToolRequestSchema }, tools);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("hdc-mcp server started on stdio");
+}
+if (isMainModule(import.meta.url)) {
+    main().catch((err) => {
+        logger.error("fatal", { err: String(err) });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map