@lark-apaas/miaoda-cli 0.1.3 → 0.1.4-alpha.abaa17f

package/dist/api/file/parsers.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseAttachment = parseAttachment;
 exports.parseHead = parseHead;
 /** 安全读取字符串字段（空字符串回退为默认值） */
-function str(value, fallback = "") {
-    return typeof value === "string" && value.length > 0 ? value : fallback;
+function str(value, fallback = '') {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
 }
 /** 安全读取数字字段（非正值回退到 0） */
 function int(value) {
-    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
         return Math.trunc(value);
     }
     return 0;
@@ -26,7 +26,7 @@ function readSize(meta) {
 function toDisplayPath(p) {
     if (!p)
         return p;
-    return p.startsWith("/") ? p : `/${p}`;
+    return p.startsWith('/') ? p : `/${p}`;
 }
 /** 将后端 attachment 结构映射为 CLI FileInfo（用于 ls） */
 function parseAttachment(att) {
@@ -41,8 +41,9 @@ function parseAttachment(att) {
     const downloadUrl = str(att.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    // uploaded_by 从 createdBy.name 映射（后端返 {userID, name, email, ...}，空代表匿名）
-    const uploader = str(att.createdBy?.name);
+    // uploaded_by 输出 {id, name} 对象：后端 createdBy: {userID, name, email, ...}，
+    // 任一非空都建对象；JSON 用对象、pretty 渲染只取 name。
+    const uploader = toUploaderRef(att.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
@@ -61,8 +62,18 @@ function parseHead(data, filePath) {
     const downloadUrl = str(outer.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    const uploader = str(outer.createdBy?.name);
+    const uploader = toUploaderRef(outer.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
 }
+/** 把后端 UserRef 归一成 CLI 暴露的 {id, name}；id / name 全空时返 undefined 略过字段。 */
+function toUploaderRef(user) {
+    if (!user)
+        return undefined;
+    const id = str(user.userID);
+    const name = str(user.name);
+    if (id === '' && name === '')
+        return undefined;
+    return { id, name };
+}

package/dist/api/observability/api.js

@@ -6,12 +6,12 @@ exports.getTraces = getTraces;
 exports.queryMetricsData = queryMetricsData;
 exports.queryAnalyticsData = queryAnalyticsData;
 const http_1 = require("../../utils/http");
-const DEFAULT_ERR_CODE = "INTERNAL_OB_ERROR";
+const DEFAULT_ERR_CODE = 'INTERNAL_OB_ERROR';
 // ── 日志 ──
 async function searchLogs(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/logs/search`;
     return (0, http_1.postInnerApi)(url, req, {
-        errPrefix: "Failed to search logs",
+        errPrefix: 'Failed to search logs',
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }
@@ -19,14 +19,14 @@ async function searchLogs(req) {
 async function searchTraces(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/search`;
     return (0, http_1.postInnerApi)(url, req, {
-        errPrefix: "Failed to search traces",
+        errPrefix: 'Failed to search traces',
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }
 async function getTraces(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/${encodeURIComponent(req.traceID)}`;
     return (0, http_1.postInnerApi)(url, req, {
-        errPrefix: "Failed to get trace",
+        errPrefix: 'Failed to get trace',
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }
@@ -34,7 +34,7 @@ async function getTraces(req) {
 async function queryMetricsData(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;
     return (0, http_1.postInnerApi)(url, req, {
-        errPrefix: "Failed to query metrics",
+        errPrefix: 'Failed to query metrics',
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }
@@ -46,7 +46,7 @@ async function queryMetricsData(req) {
 async function queryAnalyticsData(req) {
     const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/analytics/data/batch_query`;
     return (0, http_1.postInnerApi)(url, req, {
-        errPrefix: "Failed to query analytics",
+        errPrefix: 'Failed to query analytics',
         defaultErrCode: DEFAULT_ERR_CODE,
     });
 }

package/dist/api/observability/schemas.js

@@ -5,30 +5,30 @@ const output_1 = require("../../utils/output");
 /** LogItem 渲染契约（log search） */
 exports.logItemSchema = {
     columns: [
-        { key: "timestampNs", label: "time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: 'timestampNs', label: 'time', format: output_1.fmt.ns('yyyy-MM-dd HH:mm:ss.SSS') },
         {
-            key: "module",
+            key: 'module',
             derive: (row) => {
                 return row.attributes?.module;
             },
         },
         {
-            key: "user-id",
+            key: 'user-id',
             derive: (row) => {
                 return row.attributes?.user_id;
             },
         },
-        { key: "severityText", label: "severity-text" },
+        { key: 'severityText', label: 'severity-text' },
         {
-            key: "duration",
+            key: 'duration',
             format: output_1.fmt.durationMs(),
             derive: (row) => {
                 return row.attributes?.duration_ms;
             },
         },
-        { key: "traceID", label: "trace-id" },
-        { key: "id", label: "log-id" },
-        { key: "body" },
+        { key: 'traceID', label: 'trace-id' },
+        { key: 'id', label: 'log-id' },
+        { key: 'body' },
     ],
     strict: true,
 };
@@ -36,23 +36,23 @@ exports.logItemSchema = {
  *  duration 是 client-derived（BAM 只给 start/end，没有原生 durationNs 字段）。 */
 exports.spanSchema = {
     columns: [
-        { key: "startTimeUnixNano", label: "start-time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
-        { key: "name", label: "root-span" },
+        { key: 'startTimeUnixNano', label: 'start-time', format: output_1.fmt.ns('yyyy-MM-dd HH:mm:ss.SSS') },
+        { key: 'name', label: 'root-span' },
         {
-            key: "user-id",
+            key: 'user-id',
             derive: (row) => {
                 return row.attributes?.user_id;
             },
         },
         {
-            key: "duration",
-            label: "duration",
+            key: 'duration',
+            label: 'duration',
             format: output_1.fmt.durationMs(),
             derive: (row) => {
                 return row.attributes?.duration_ms;
             },
         },
-        { key: "traceID", label: "trace-id" },
+        { key: 'traceID', label: 'trace-id' },
     ],
     strict: true,
 };

package/dist/api/plugin/api.js

@@ -23,23 +23,23 @@ const node_path_1 = __importDefault(require("node:path"));
 // ── Plugin Version API ──
 async function getPluginVersions(keys, latestOnly = true) {
     const client = (0, http_1.getRuntimeHttpClient)();
-    const response = await client.post(`/api/v1/studio/innerapi/plugins/-/versions/batch_get?keys=${keys.join(",")}&latest_only=${String(latestOnly)}`);
+    const response = await client.post(`/api/v1/studio/innerapi/plugins/-/versions/batch_get?keys=${keys.join(',')}&latest_only=${String(latestOnly)}`);
     if (!response.ok) {
         throw new error_1.HttpError(response.status, response.url, `Failed to get plugin versions: ${String(response.status)} ${response.statusText}`);
     }
     const result = (await response.json());
-    if (result.status_code !== "0") {
-        throw new error_1.AppError("INTERNAL_API_ERROR", `API error: ${result.message ?? "unknown"}`);
+    if (result.status_code !== '0') {
+        throw new error_1.AppError('INTERNAL_API_ERROR', `API error: ${result.message ?? 'unknown'}`);
     }
     return result.data.pluginVersions;
 }
 async function getPluginVersion(pluginKey, requestedVersion) {
-    const isLatest = requestedVersion === "latest";
+    const isLatest = requestedVersion === 'latest';
     const versions = await getPluginVersions([pluginKey], isLatest);
     const pluginVersions = versions[pluginKey];
     if (!pluginVersions || pluginVersions.length === 0) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, {
-            next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"],
+        throw new error_1.AppError('PLUGIN_NOT_FOUND', `Plugin not found: ${pluginKey}`, {
+            next_actions: ['检查包名拼写，或确认该插件已在插件市场发布'],
         });
     }
     if (isLatest) {
@@ -47,7 +47,7 @@ async function getPluginVersion(pluginKey, requestedVersion) {
     }
     const targetVersion = pluginVersions.find((v) => v.version === requestedVersion);
     if (!targetVersion) {
-        throw new error_1.AppError("VERSION_NOT_FOUND", `Version ${requestedVersion} not found for plugin ${pluginKey}`, { next_actions: [`可用版本：${pluginVersions.map((v) => v.version).join(", ")}`] });
+        throw new error_1.AppError('VERSION_NOT_FOUND', `Version ${requestedVersion} not found for plugin ${pluginKey}`, { next_actions: [`可用版本：${pluginVersions.map((v) => v.version).join(', ')}`] });
     }
     return targetVersion;
 }
@@ -55,8 +55,8 @@ async function getPluginVersion(pluginKey, requestedVersion) {
 function parsePluginKey(key) {
     const match = /^(@[^/]+)\/(.+)$/.exec(key);
     if (!match) {
-        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, {
-            next_actions: ["插件 key 必须形如 @scope/name"],
+        throw new error_1.AppError('INVALID_PLUGIN_KEY', `Invalid plugin key format: ${key}`, {
+            next_actions: ['插件 key 必须形如 @scope/name'],
         });
     }
     return { scope: match[1], name: match[2] };
@@ -91,15 +91,15 @@ async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
         catch (error) {
             lastError = error instanceof Error ? error : new Error(String(error));
             if (attempt < maxRetries) {
-                (0, logger_1.log)("plugin", `${description} failed, retrying (${String(attempt + 1)}/${String(maxRetries)})...`);
+                (0, logger_1.log)('plugin', `${description} failed, retrying (${String(attempt + 1)}/${String(maxRetries)})...`);
             }
         }
     }
     throw (lastError ??
-        new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] }));
+        new error_1.AppError('INTERNAL_RETRY_EXHAUSTED', `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ['检查网络后重试，--verbose 可查看重试日志'] }));
 }
 /** 插件缓存目录 */
-const PLUGIN_CACHE_DIR = "node_modules/.cache/miaoda-cli/plugins";
+const PLUGIN_CACHE_DIR = 'node_modules/.cache/miaoda-cli/plugins';
 function getPluginCacheDir() {
     return node_path_1.default.join(process.cwd(), PLUGIN_CACHE_DIR);
 }
@@ -111,18 +111,18 @@ function ensureCacheDir() {
 }
 function getTempFilePath(pluginKey, version) {
     ensureCacheDir();
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const filename = `${safeKey}@${version}.tgz`;
     return node_path_1.default.join(getPluginCacheDir(), filename);
 }
 async function downloadPlugin(pluginKey, requestedVersion) {
     const pluginInfo = await getPluginVersion(pluginKey, requestedVersion);
     let tgzBuffer;
-    if (pluginInfo.downloadApproach === "inner") {
-        tgzBuffer = await withRetry(() => downloadFromInner(pluginKey, pluginInfo.version), "Download");
+    if (pluginInfo.downloadApproach === 'inner') {
+        tgzBuffer = await withRetry(() => downloadFromInner(pluginKey, pluginInfo.version), 'Download');
     }
     else {
-        tgzBuffer = await withRetry(() => downloadFromPublic(pluginInfo.downloadURL), "Download");
+        tgzBuffer = await withRetry(() => downloadFromPublic(pluginInfo.downloadURL), 'Download');
     }
     const tgzPath = getTempFilePath(pluginKey, pluginInfo.version);
     node_fs_1.default.writeFileSync(tgzPath, tgzBuffer);
@@ -135,7 +135,7 @@ async function downloadPlugin(pluginKey, requestedVersion) {
 // ── Cache ──
 function getCachePath(pluginKey, version) {
     ensureCacheDir();
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const filename = `${safeKey}@${version}.tgz`;
     return node_path_1.default.join(getPluginCacheDir(), filename);
 }
@@ -151,13 +151,13 @@ function listCachedPlugins() {
     const files = node_fs_1.default.readdirSync(cacheDir);
     const result = [];
     for (const file of files) {
-        if (!file.endsWith(".tgz"))
+        if (!file.endsWith('.tgz'))
             continue;
         const match = /^(.+)@(.+)\.tgz$/.exec(file);
         if (!match)
             continue;
         const [, rawName, version] = match;
-        const name = rawName.replace(/^_/, "@").replace(/_/, "/");
+        const name = rawName.replace(/^_/, '@').replace(/_/, '/');
         const filePath = node_path_1.default.join(cacheDir, file);
         const stat = node_fs_1.default.statSync(filePath);
         result.push({ name, version, filePath, size: stat.size, mtime: stat.mtime });
@@ -172,7 +172,7 @@ function cleanAllCache() {
     const files = node_fs_1.default.readdirSync(cacheDir);
     let count = 0;
     for (const file of files) {
-        if (file.endsWith(".tgz")) {
+        if (file.endsWith('.tgz')) {
             node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
             count++;
         }
@@ -184,7 +184,7 @@ function cleanPluginCache(pluginKey, version) {
     if (!node_fs_1.default.existsSync(cacheDir)) {
         return 0;
     }
-    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const safeKey = pluginKey.replace(/[/@]/g, '_');
     const files = node_fs_1.default.readdirSync(cacheDir);
     let count = 0;
     for (const file of files) {
@@ -195,7 +195,7 @@ function cleanPluginCache(pluginKey, version) {
             }
         }
         else {
-            if (file.startsWith(`${safeKey}@`) && file.endsWith(".tgz")) {
+            if (file.startsWith(`${safeKey}@`) && file.endsWith('.tgz')) {
                 node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
                 count++;
             }
@@ -209,29 +209,29 @@ async function reportEvents(events) {
         return true;
     try {
         const client = (0, http_1.getRuntimeHttpClient)();
-        const response = await client.post("/api/v1/studio/innerapi/resource_events", { events });
+        const response = await client.post('/api/v1/studio/innerapi/resource_events', { events });
         if (!response.ok) {
-            (0, logger_1.log)("telemetry", `Failed to report events: ${String(response.status)} ${response.statusText}`);
+            (0, logger_1.log)('telemetry', `Failed to report events: ${String(response.status)} ${response.statusText}`);
             return false;
         }
         const result = (await response.json());
-        if (result.status_code !== "0") {
-            (0, logger_1.log)("telemetry", `API error: ${result.message ?? "unknown"}`);
+        if (result.status_code !== '0') {
+            (0, logger_1.log)('telemetry', `API error: ${result.message ?? 'unknown'}`);
             return false;
         }
         return true;
     }
     catch (error) {
-        (0, logger_1.log)("telemetry", `Failed to report events: ${error instanceof Error ? error.message : String(error)}`);
+        (0, logger_1.log)('telemetry', `Failed to report events: ${error instanceof Error ? error.message : String(error)}`);
         return false;
     }
 }
 async function reportInstallEvent(pluginKey, version) {
     await reportEvents([
         {
-            resourceType: "plugin",
+            resourceType: 'plugin',
             resourceKey: pluginKey,
-            eventType: "install",
+            eventType: 'install',
             details: { version },
         },
     ]);
@@ -239,9 +239,9 @@ async function reportInstallEvent(pluginKey, version) {
 async function reportCreateInstanceEvent(pluginKey, version) {
     await reportEvents([
         {
-            resourceType: "plugin",
+            resourceType: 'plugin',
             resourceKey: pluginKey,
-            eventType: "create_instance",
+            eventType: 'create_instance',
             details: { version },
         },
     ]);

package/dist/cli/commands/app/index.js

@@ -3,25 +3,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAppCommands = registerAppCommands;
 const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../cli/handlers/app/index");
-function registerAppCommands(program) {
-    const appCmd = program.command("app").description("应用元数据管理：查看 / 修改");
+const error_1 = require("../../../utils/error");
+function registerAppCommands(program, opts = {}) {
+    const description = opts.includeInit
+        ? '应用元数据管理：查看 / 修改 / 初始化'
+        : '应用元数据管理：查看 / 修改';
+    const appCmd = program.command('app').description(description);
     appCmd.action(() => {
         appCmd.outputHelp();
     });
-    appCmd.addHelpText("after", `
+    appCmd.addHelpText('after', `
 作用范围
   仅供 Agent 在妙搭沙箱内调用。
   应用上下文：沙箱内的默认应用。
 `);
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
+    if (opts.includeInit) {
+        registerAppInit(appCmd);
+    }
 }
 function registerAppGet(parent) {
     const cmd = parent
-        .command("get")
-        .description("查看应用元数据（status / type / mode / branch / 时间戳 等）")
+        .command('get')
+        .description('查看应用元数据（status / type / mode / branch / 时间戳 等）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addHelpText("after", `
+        .addHelpText('after', `
 JSON 输出
   {"data": {"appID": "...", "name": "...", ...}}
 
@@ -30,7 +37,7 @@ JSON 输出
   $ miaoda app get --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleAppGet)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
         });
@@ -38,12 +45,12 @@ JSON 输出
 }
 function registerAppUpdate(parent) {
     const cmd = parent
-        .command("update")
-        .description("修改应用名称 / 描述（至少传 --name 或 --description）")
+        .command('update')
+        .description('修改应用名称 / 描述（至少传 --name 或 --description）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--name <name>", "新应用名称")
-        .option("--description <desc>", "新应用描述")
-        .addHelpText("after", `
+        .option('--name <name>', '新应用名称')
+        .option('--description <desc>', '新应用描述')
+        .addHelpText('after', `
 JSON 输出
   与 'app get' 一致：{"data": {...新 meta...}}
 
@@ -52,7 +59,7 @@ JSON 输出
   $ miaoda app update --description "在线商城应用"
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleAppUpdate)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             name: rawOpts.name,
@@ -60,3 +67,77 @@ JSON 输出
         });
     }));
 }
+function registerAppInit(parent) {
+    const cmd = parent
+        .command('init')
+        .description('初始化应用代码：抓 template 渲染、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
+        .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"} / {"steeringVersion": "<steering 版本>"}，均默认 latest')
+        .option('--skip-install', '跳过依赖安装', false)
+        .addHelpText('after', `
+幂等
+  .spark/meta.json 已存在时直接退出（initialized=false, reason=already_initialized），
+  不再触发 template 渲染、不重新拉 skills、不安装依赖。
+  meta.json 在 init 流程最后才写，写了 = 已完整成功一次；
+  上一次失败留下半渲染状态时（package.json 在但 meta.json 没在）允许重跑。
+
+依赖安装
+  默认：npm install --no-audit --no-fund
+  --skip-install: 跳过
+  MIAODA_DEP_CACHE_DIR 环境变量：
+    若设了且 CWD 含 package.json，先算 md5(package.json)，
+    命中 \${MIAODA_DEP_CACHE_DIR}/\${hash}.zip 则 unzip 复用缓存；未命中或解压后 node_modules
+    为空都会 fallback npm install。
+  JSON 模式下子进程 stdout 重定向到 stderr，避免污染最终 emit 的 JSON。
+
+JSON 输出
+  已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
+  新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
+                     "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
+
+示例
+  $ miaoda app init --template vite-react
+  $ miaoda app init --template vite-react --conf '{"version": "0.1.0-alpha.1"}'
+  $ miaoda app init --template vite-react --conf '{"steeringVersion": "0.1.0"}'
+  $ miaoda app init --template vite-react --skip-install
+  $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
+        const conf = parseInitConf(rawOpts.conf);
+        await (0, index_1.handleAppInit)({
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
+            template: rawOpts.template,
+            conf,
+            skipInstall: rawOpts.skipInstall,
+        });
+    }));
+}
+function parseInitConf(raw) {
+    if (raw === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('ARGS_INVALID', `--conf 必须是合法 JSON：${msg}`);
+    }
+    if (!isPlainObject(parsed)) {
+        throw new error_1.AppError('ARGS_INVALID', '--conf 必须是 JSON 对象');
+    }
+    const version = parsed.version;
+    if (version !== undefined && typeof version !== 'string') {
+        throw new error_1.AppError('ARGS_INVALID', '--conf.version 必须是字符串');
+    }
+    const steeringVersion = parsed.steeringVersion;
+    if (steeringVersion !== undefined && typeof steeringVersion !== 'string') {
+        throw new error_1.AppError('ARGS_INVALID', '--conf.steeringVersion 必须是字符串');
+    }
+    return { version, steeringVersion };
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}