@puyinkai/wow-xiaobao-cli 0.0.0-stage → 1.0.0

package/dist/search-kLJrFOVI.mjs

@@ -0,0 +1,70 @@
+import { n as xbApiFetch, t as resolveConfig } from "./config-DqUxKQ3m.mjs";
+import { n as requireActiveProject } from "./project-store-B-2rqrgM.mjs";
+import { t as tenantProjectHeaders } from "./headers-Dy5gROBB.mjs";
+import { n as writeResult, t as writeError } from "./format-bDFUVuDQ.mjs";
+import { t as csvToArray } from "./util-BuoFIeLS.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/kb/search.ts
+/**
+* `wow-xiaobao kb search <query>` — semantic knowledge-base retrieval via
+* POST /ai-open/kb/search. Returns ranked chunks (not full documents),
+* scoped to the active project.
+*/
+var search_default = defineCommand({
+	meta: {
+		name: "search",
+		description: "知识库语义检索（返回 chunk，按当前激活项目隔离）"
+	},
+	args: {
+		query: {
+			type: "positional",
+			required: true,
+			description: "检索 query"
+		},
+		k: {
+			type: "string",
+			description: "返回 chunk 数量，默认 5，最大 20"
+		},
+		"chunk-types": {
+			type: "string",
+			description: "CSV: chunk 类型过滤"
+		},
+		"doc-ids": {
+			type: "string",
+			description: "CSV: 文档 ID 过滤"
+		},
+		"enable-rerank": {
+			type: "boolean",
+			description: "是否启用 rerank"
+		},
+		"rerank-threshold": {
+			type: "string",
+			description: "rerank 阈值（小数）"
+		},
+		"api-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			writeResult(await xbApiFetch(resolveConfig({ apiBase: args["api-base"] }), "POST", "/ai-open/kb/search", {
+				headers: tenantProjectHeaders(await requireActiveProject()),
+				body: {
+					query: String(args.query),
+					k: args.k != null ? Number(args.k) : void 0,
+					chunkTypes: csvToArray(args["chunk-types"]),
+					docIds: csvToArray(args["doc-ids"]),
+					enableRerank: args["enable-rerank"] ? true : void 0,
+					rerankThreshold: args["rerank-threshold"] != null ? Number(args["rerank-threshold"]) : void 0
+				}
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { search_default as default };

package/dist/service-score-CiIxFGJ8.mjs

@@ -0,0 +1,91 @@
+import { n as xbApiFetch, t as resolveConfig } from "./config-DqUxKQ3m.mjs";
+import { n as requireActiveProject } from "./project-store-B-2rqrgM.mjs";
+import { t as tenantProjectHeaders } from "./headers-Dy5gROBB.mjs";
+import { n as writeResult, t as writeError } from "./format-bDFUVuDQ.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/shared/service-score.ts
+const scoreItems = [
+	"sales",
+	"demand",
+	"duration",
+	"interaction",
+	"icebreaking",
+	"communication"
+];
+/** 两种维度复用参数校验和协议，业务 ID 始终按字符串发送以保留大整数精度。 */
+function serviceScoreCommand(scope) {
+	const idArg = `${scope}-id`;
+	return defineCommand({
+		meta: {
+			name: "score",
+			description: `${scope === "customer" ? "客户综合" : "单次来访"}服务分，支持按评分项下钻（不含证据）`
+		},
+		args: {
+			[idArg]: {
+				type: "string",
+				required: true,
+				description: scope === "customer" ? "客户 wangId" : "来访 ID"
+			},
+			"include-details": {
+				type: "boolean",
+				default: false,
+				description: "返回明细，默认只返回总分及各评分项"
+			},
+			items: {
+				type: "string",
+				description: `明细范围，逗号分隔：${scoreItems.join(",")}；需配合 --include-details`
+			},
+			"api-base": { type: "string" },
+			format: {
+				type: "string",
+				default: "json"
+			}
+		},
+		async run({ args }) {
+			try {
+				const id = String(args[idArg]);
+				const format = String(args.format);
+				const includeDetails = args["include-details"] === true;
+				const items = args.items === void 0 ? void 0 : String(args.items).split(",").map((item) => item.trim());
+				if (!/^[1-9]\d*$/.test(id) || BigInt(id) > 9223372036854775807n || items !== void 0 && (!includeDetails || items.some((item) => !scoreItems.includes(item)))) {
+					writeError({
+						code: "BAD_ARGUMENT",
+						message: `${idArg} 必须为有效正整数 ID；--items 需配合 --include-details，取值为 ${scoreItems.join(",")}`
+					}, format);
+					process.exit(2);
+				}
+				const config = resolveConfig({ apiBase: typeof args["api-base"] === "string" ? args["api-base"] : void 0 });
+				const active = await requireActiveProject();
+				const result = await xbApiFetch(config, "POST", `/ai-open/${scope === "customer" ? "customers" : "visits"}/score`, {
+					headers: tenantProjectHeaders(active),
+					body: {
+						[scope === "customer" ? "customerId" : "visitId"]: id,
+						includeDetails,
+						...items === void 0 ? {} : { items: [...new Set(items)] }
+					}
+				});
+				const envelope = result.data;
+				if (!result.ok || !envelope || typeof envelope !== "object" || String(envelope.code) !== "0") throw {
+					code: "API_ERROR",
+					status: result.status,
+					message: envelope?.msg ?? "服务分查询失败",
+					body: result.data
+				};
+				if (typeof envelope.data === "string") throw {
+					code: "ACCESS_DENIED",
+					message: envelope.data
+				};
+				if (!envelope.data || typeof envelope.data !== "object") throw {
+					code: "API_ERROR",
+					message: "服务分返回数据为空"
+				};
+				writeResult(result, format);
+			} catch (err) {
+				writeError(err, String(args.format));
+				process.exit(1);
+			}
+		}
+	});
+}
+//#endregion
+export { serviceScoreCommand as t };

package/dist/shared-BCf9YDEa.mjs

@@ -0,0 +1,11 @@
+import { s as getRange, t as defineDateCommand } from "./shared-CdUFV4rc.mjs";
+//#region src/commands/date/range/shared.ts
+function defineRangePresetCommand(preset, description) {
+	return defineDateCommand({
+		name: preset,
+		description,
+		run: ({ args }) => getRange(preset, args.timezone)
+	});
+}
+//#endregion
+export { defineRangePresetCommand as t };

package/dist/shared-COOwe14d.mjs

@@ -0,0 +1,87 @@
+import { n as xbApiFetch, t as resolveConfig } from "./config-DqUxKQ3m.mjs";
+import { n as requireActiveProject } from "./project-store-B-2rqrgM.mjs";
+import { t as tenantProjectHeaders } from "./headers-Dy5gROBB.mjs";
+import { n as writeResult, t as writeError } from "./format-bDFUVuDQ.mjs";
+import { r as toLocalDateTime, t as csvToArray } from "./util-BuoFIeLS.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/beautx/shared.ts
+/**
+* Shared args/body builder for `wow-xiaobao beautx *` — the four beautx (医美)
+* queries share one request shape (visitIds/wangIds/beautxCustomerIds/时间窗/分页).
+*/
+function defineBeautxCommand(def) {
+	return defineCommand({
+		meta: {
+			name: def.name,
+			description: def.description
+		},
+		args: {
+			"visit-ids": {
+				type: "string",
+				description: "CSV: 来访 ID 过滤"
+			},
+			"customer-ids": {
+				type: "string",
+				description: "CSV: 客户 wang_id 过滤"
+			},
+			"beautx-customer-ids": {
+				type: "string",
+				description: "CSV: 医美业务客户 ID 过滤"
+			},
+			...def.supportsLatestOnly ? { "latest-only": {
+				type: "boolean",
+				description: "每客户只取最新一条"
+			} } : {},
+			...def.supportsDimension ? { dimension: {
+				type: "string",
+				description: "画像标签维度名过滤"
+			} } : {},
+			from: {
+				type: "string",
+				description: "开始时间（含）"
+			},
+			to: {
+				type: "string",
+				description: "结束时间（不含）"
+			},
+			page: {
+				type: "string",
+				default: "1"
+			},
+			size: {
+				type: "string",
+				default: "10"
+			},
+			"api-base": { type: "string" },
+			format: {
+				type: "string",
+				default: "toon"
+			}
+		},
+		async run({ args }) {
+			try {
+				const config = resolveConfig({ apiBase: args["api-base"] });
+				const active = await requireActiveProject();
+				writeResult(await xbApiFetch(config, "POST", def.path, {
+					headers: tenantProjectHeaders(active),
+					body: {
+						visitIds: csvToArray(args["visit-ids"]),
+						customerIds: csvToArray(args["customer-ids"]),
+						beautxCustomerIds: csvToArray(args["beautx-customer-ids"]),
+						latestOnly: def.supportsLatestOnly ? args["latest-only"] : void 0,
+						dimensionName: def.supportsDimension ? args.dimension : void 0,
+						fromDate: toLocalDateTime(args.from),
+						toDate: toLocalDateTime(args.to),
+						page: Number(args.page),
+						size: Number(args.size)
+					}
+				}), args.format);
+			} catch (err) {
+				writeError(err, args.format);
+				process.exit(1);
+			}
+		}
+	});
+}
+//#endregion
+export { defineBeautxCommand as t };

package/dist/shared-CdUFV4rc.mjs

@@ -0,0 +1,277 @@
+import { n as writeResult, t as writeError } from "./format-bDFUVuDQ.mjs";
+import { defineCommand } from "citty";
+//#region src/core/date-util.ts
+/**
+* Local date/time helpers for `wow-xiaobao date *` (no network).
+*
+* Default timezone: Asia/Shanghai (or TZ env). Weekday numbering: 1=Monday … 7=Sunday.
+*/
+const DEFAULT_TIMEZONE = "Asia/Shanghai";
+const DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const WEEKDAY_SHORT_TO_NUM = {
+	Mon: 1,
+	Tue: 2,
+	Wed: 3,
+	Thu: 4,
+	Fri: 5,
+	Sat: 6,
+	Sun: 7
+};
+var DateInputError = class extends Error {
+	code = "INVALID_DATE";
+	hint = "日期须为 YYYY-MM-DD；days 须为非负整数";
+	constructor(message) {
+		super(message);
+		this.name = "DateInputError";
+	}
+};
+function resolveTimezone(input) {
+	const tz = (input ?? process.env.TZ ?? "Asia/Shanghai").trim();
+	if (!tz) return DEFAULT_TIMEZONE;
+	try {
+		Intl.DateTimeFormat(void 0, { timeZone: tz });
+		return tz;
+	} catch {
+		throw new DateInputError(`无效时区: ${tz}`);
+	}
+}
+function parseYmd(date) {
+	const m = DATE_RE.exec(date.trim());
+	if (!m) throw new DateInputError(`无效日期: ${date}`);
+	const year = Number(m[1]);
+	const month = Number(m[2]);
+	const day = Number(m[3]);
+	const probe = new Date(Date.UTC(year, month - 1, day));
+	if (probe.getUTCFullYear() !== year || probe.getUTCMonth() + 1 !== month || probe.getUTCDate() !== day) throw new DateInputError(`无效日期: ${date}`);
+	return {
+		year,
+		month,
+		day
+	};
+}
+function pad2(n) {
+	return String(n).padStart(2, "0");
+}
+function formatYmd(ymd) {
+	return `${ymd.year}-${pad2(ymd.month)}-${pad2(ymd.day)}`;
+}
+function formatDateTime(parts) {
+	return `${formatYmd(parts)} ${pad2(parts.hour)}:${pad2(parts.minute)}:${pad2(parts.second)}`;
+}
+function getZonedParts(instant, timeZone) {
+	const parts = new Intl.DateTimeFormat("en-US", {
+		timeZone,
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit",
+		hour: "2-digit",
+		minute: "2-digit",
+		second: "2-digit",
+		weekday: "short",
+		hour12: false,
+		hourCycle: "h23"
+	}).formatToParts(instant);
+	const pick = (type) => parts.find((p) => p.type === type)?.value ?? "";
+	const hourRaw = Number(pick("hour"));
+	const hour = hourRaw === 24 ? 0 : hourRaw;
+	return {
+		year: Number(pick("year")),
+		month: Number(pick("month")),
+		day: Number(pick("day")),
+		hour,
+		minute: Number(pick("minute")),
+		second: Number(pick("second")),
+		weekdayShort: pick("weekday")
+	};
+}
+function weekdayNumFromShort(short) {
+	const num = WEEKDAY_SHORT_TO_NUM[short];
+	if (!num) throw new DateInputError(`无法解析星期: ${short}`);
+	return num;
+}
+function weekdayZh(instant, timeZone) {
+	return new Intl.DateTimeFormat("zh-CN", {
+		timeZone,
+		weekday: "long"
+	}).format(instant);
+}
+function zonedInstant(ymd, hms, timeZone) {
+	const [hh, mm, ss] = hms.split(":").map(Number);
+	const utcGuess = Date.UTC(ymd.year, ymd.month - 1, ymd.day, hh, mm, ss);
+	const offset = getTimezoneOffsetMs(timeZone, new Date(utcGuess));
+	return new Date(utcGuess - offset);
+}
+function getTimezoneOffsetMs(timeZone, date) {
+	const parts = getZonedParts(date, timeZone);
+	return Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second) - date.getTime();
+}
+function addCalendarDays(ymd, offset) {
+	const dt = new Date(Date.UTC(ymd.year, ymd.month - 1, ymd.day + offset));
+	return {
+		year: dt.getUTCFullYear(),
+		month: dt.getUTCMonth() + 1,
+		day: dt.getUTCDate()
+	};
+}
+function buildDateInfo(parts, timeZone, instant) {
+	const weekdayNum = weekdayNumFromShort(parts.weekdayShort);
+	return {
+		date: formatYmd(parts),
+		datetime: formatDateTime(parts),
+		timezone: timeZone,
+		weekday: weekdayZh(instant, timeZone),
+		weekdayNum
+	};
+}
+function getNow(timeZoneInput) {
+	const timeZone = resolveTimezone(timeZoneInput);
+	const instant = /* @__PURE__ */ new Date();
+	return buildDateInfo(getZonedParts(instant, timeZone), timeZone, instant);
+}
+function getDateInfo(date, timeZoneInput) {
+	const timeZone = resolveTimezone(timeZoneInput);
+	const instant = zonedInstant(parseYmd(date), "00:00:00", timeZone);
+	const parts = getZonedParts(instant, timeZone);
+	return {
+		date: formatYmd(parts),
+		timezone: timeZone,
+		weekday: weekdayZh(instant, timeZone),
+		weekdayNum: weekdayNumFromShort(parts.weekdayShort)
+	};
+}
+function getRelativeDay(offsetDays, timeZoneInput) {
+	const timeZone = resolveTimezone(timeZoneInput);
+	return getDateInfo(formatYmd(addCalendarDays(getZonedParts(/* @__PURE__ */ new Date(), timeZone), offsetDays)), timeZone);
+}
+function addDays(date, offset, timeZoneInput) {
+	const timeZone = resolveTimezone(timeZoneInput);
+	return getDateInfo(formatYmd(addCalendarDays(parseYmd(date), offset)), timeZone);
+}
+function dateDiff(startDate, endDate) {
+	const start = parseYmd(startDate);
+	const end = parseYmd(endDate);
+	const startMs = Date.UTC(start.year, start.month - 1, start.day);
+	const endMs = Date.UTC(end.year, end.month - 1, end.day);
+	return {
+		startDate: formatYmd(start),
+		endDate: formatYmd(end),
+		days: Math.round((endMs - startMs) / 864e5)
+	};
+}
+function startOfWeekMonday(ymd, timeZone) {
+	return addCalendarDays(ymd, -(weekdayNumFromShort(getZonedParts(zonedInstant(ymd, "12:00:00", timeZone), timeZone).weekdayShort) - 1));
+}
+function startOfMonth(ymd) {
+	return {
+		year: ymd.year,
+		month: ymd.month,
+		day: 1
+	};
+}
+function nextMonthStart(ymd) {
+	if (ymd.month === 12) return {
+		year: ymd.year + 1,
+		month: 1,
+		day: 1
+	};
+	return {
+		year: ymd.year,
+		month: ymd.month + 1,
+		day: 1
+	};
+}
+function getRange(preset, timeZoneInput) {
+	const timeZone = resolveTimezone(timeZoneInput);
+	const todayParts = getZonedParts(/* @__PURE__ */ new Date(), timeZone);
+	const today = formatYmd(todayParts);
+	const tomorrow = formatYmd(addCalendarDays(todayParts, 1));
+	const yesterday = formatYmd(addCalendarDays(todayParts, -1));
+	let from;
+	let to;
+	switch (preset) {
+		case "today":
+			from = `${today} 00:00:00`;
+			to = `${tomorrow} 00:00:00`;
+			break;
+		case "yesterday":
+			from = `${yesterday} 00:00:00`;
+			to = `${today} 00:00:00`;
+			break;
+		case "today-so-far":
+			from = `${today} 00:00:00`;
+			to = formatDateTime(todayParts);
+			break;
+		case "this-week": {
+			const monday = formatYmd(startOfWeekMonday(todayParts, timeZone));
+			const nextMonday = formatYmd(addCalendarDays(parseYmd(monday), 7));
+			from = `${monday} 00:00:00`;
+			to = `${nextMonday} 00:00:00`;
+			break;
+		}
+		case "this-month": {
+			const monthStart = formatYmd(startOfMonth(todayParts));
+			const nextMonth = formatYmd(nextMonthStart(todayParts));
+			from = `${monthStart} 00:00:00`;
+			to = `${nextMonth} 00:00:00`;
+			break;
+		}
+		case "last-7-days":
+			from = `${formatYmd(addCalendarDays(todayParts, -6))} 00:00:00`;
+			to = `${tomorrow} 00:00:00`;
+			break;
+		default: throw new DateInputError(`未知 preset: ${preset}`);
+	}
+	const anchor = getDateInfo(today, timeZone);
+	return {
+		range: preset,
+		timezone: timeZone,
+		from,
+		to,
+		date: anchor.date,
+		weekday: anchor.weekday,
+		weekdayNum: anchor.weekdayNum
+	};
+}
+//#endregion
+//#region src/commands/date/shared.ts
+/**
+* Shared helpers for `wow-xiaobao date *`.
+*/
+const timezoneArg = { timezone: {
+	type: "string",
+	description: "IANA 时区，默认 Asia/Shanghai（或 TZ 环境变量）"
+} };
+function parsePositiveDays(raw, label = "days") {
+	if (raw === void 0 || raw === "") throw new DateInputError(`缺少 ${label}`);
+	const days = Number(raw);
+	if (!Number.isInteger(days) || days < 0) throw new DateInputError(`${label} 须为非负整数: ${raw}`);
+	return days;
+}
+function defineDateCommand(def) {
+	return defineCommand({
+		meta: {
+			name: def.name,
+			description: def.description
+		},
+		args: {
+			format: {
+				type: "string",
+				default: "toon",
+				description: "Stdout format: toon (default) / json / table"
+			},
+			...timezoneArg,
+			...def.args
+		},
+		async run({ args }) {
+			const format = typeof args.format === "string" ? args.format : void 0;
+			try {
+				writeResult(def.run({ args }), format);
+			} catch (err) {
+				writeError(err, format);
+				process.exit(1);
+			}
+		}
+	});
+}
+//#endregion
+export { getDateInfo as a, getRelativeDay as c, dateDiff as i, parsePositiveDays as n, getNow as o, addDays as r, getRange as s, defineDateCommand as t };

package/dist/staff-DasX8vTs.mjs

@@ -0,0 +1,14 @@
+import { defineCommand } from "citty";
+//#region src/commands/staff/index.ts
+var staff_default = defineCommand({
+	meta: {
+		name: "staff",
+		description: "查看和调用员工工具"
+	},
+	subCommands: {
+		list: () => import("./list-BVk58WIy.mjs").then((m) => m.default),
+		call: () => import("./call-BfT4uEa7.mjs").then((m) => m.default)
+	}
+});
+//#endregion
+export { staff_default as default };

package/dist/staff-client-B3hnEyNi.mjs

@@ -0,0 +1,59 @@
+import { n as xbApiFetch } from "./config-DqUxKQ3m.mjs";
+//#region src/core/staff-client.ts
+/** Employee REST facade. Business payloads and errors retain the original staff CLI contract. */
+const STAFF_TOOLS_PATH = "/ai-open/staff/tools";
+function object(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function unwrap(response) {
+	const result = response.data;
+	if (!response.ok) throw Object.assign(/* @__PURE__ */ new Error(`员工接口请求失败（HTTP ${response.status}）`), {
+		code: "API_ERROR",
+		status: response.status,
+		details: result
+	});
+	if (!object(result) || String(result.code) !== "0") throw Object.assign(new Error(object(result) ? String(result.msg ?? "员工接口请求失败") : "员工接口响应格式错误"), {
+		code: "API_ERROR",
+		details: result
+	});
+	if (typeof result.data === "string") throw Object.assign(new Error(result.data), {
+		code: "ACCESS_DENIED",
+		details: result
+	});
+	return result.data;
+}
+async function fetchStaffTools(config, headers) {
+	const data = unwrap(await xbApiFetch(config, "GET", STAFF_TOOLS_PATH, {
+		headers,
+		timeoutMs: 9e4
+	}));
+	if (!object(data) || !Array.isArray(data.tools) || data.tools.some((tool) => !object(tool) || typeof tool.name !== "string" || !tool.name.startsWith("staff-"))) throw Object.assign(/* @__PURE__ */ new Error("员工工具目录响应格式错误"), {
+		code: "INVALID_API_RESPONSE",
+		details: data
+	});
+	return data.tools;
+}
+async function callStaffTool(config, headers, tool, variables, timeRange) {
+	const data = unwrap(await xbApiFetch(config, "POST", `${STAFF_TOOLS_PATH}/${encodeURIComponent(tool)}/call`, {
+		headers,
+		body: {
+			variables,
+			...timeRange?.start || timeRange?.end ? { timeRange } : {}
+		},
+		timeoutMs: 9e4
+	}));
+	if (!object(data) || typeof data.isError !== "boolean" || !("payload" in data)) throw Object.assign(/* @__PURE__ */ new Error("员工工具响应格式错误"), {
+		code: "INVALID_API_RESPONSE",
+		details: data
+	});
+	if (data.isError) {
+		const error = data.payload;
+		throw Object.assign(new Error(object(error) ? String(error.message ?? error.msg ?? "员工工具调用失败") : "员工工具调用失败"), {
+			code: "STAFF_TOOL_ERROR",
+			details: error
+		});
+	}
+	return data.payload;
+}
+//#endregion
+export { fetchStaffTools as n, callStaffTool as t };

package/dist/status-BFJYeL2I.mjs

@@ -0,0 +1,24 @@
+import { n as isAccessTokenValid, r as readToken, t as decodeJwtPayload } from "./token-store-BGLVc825.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/auth/status.ts
+/**
+* `wow-xiaobao auth status` — 授权状态检测：退出码 0 且输出 "Logged in as ..." 表示
+* 平台放置的访问令牌可用，否则退出码 1。只读本地文件，不发请求。
+*/
+var status_default = defineCommand({
+	meta: {
+		name: "status",
+		description: "授权状态检测（exit 0 = 令牌可用）"
+	},
+	async run() {
+		const token = await readToken();
+		if (!isAccessTokenValid(token)) {
+			process.stdout.write("Not authenticated: 请在旺喔 App 的连接器里授权旺小宝\n");
+			process.exit(1);
+		}
+		const c = decodeJwtPayload(token.id_token) ?? {};
+		process.stdout.write(`Logged in as ${String(c.name ?? c.preferred_username ?? c.sub ?? "unknown")}\n`);
+	}
+});
+//#endregion
+export { status_default as default };

package/dist/subtract-wUG7Jzdu.mjs

@@ -0,0 +1,21 @@
+import { n as parsePositiveDays, r as addDays, t as defineDateCommand } from "./shared-CdUFV4rc.mjs";
+//#region src/commands/date/subtract.ts
+var subtract_default = defineDateCommand({
+	name: "subtract",
+	description: "日期往前推 N 天",
+	args: {
+		date: {
+			type: "positional",
+			required: true,
+			description: "基准日期 YYYY-MM-DD"
+		},
+		days: {
+			type: "positional",
+			required: true,
+			description: "往前推的天数（非负整数）"
+		}
+	},
+	run: ({ args }) => addDays(args.date, -parsePositiveDays(args.days, "days"), args.timezone)
+});
+//#endregion
+export { subtract_default as default };