@hedgehog-finance/hedgehog-plugin 1.0.21 → 1.0.23

package/src/features/informationVerification/schema.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+
+export const BuildInformationVerificationMessageParamsSchema = z.object({
+	newsId: z.string().trim().min(1).describe("新闻 ID，例如 news-5"),
+	sourceTitle: z.string().trim().min(1).describe("新闻标题"),
+	sourceContent: z.string().trim().min(1).describe("新闻正文")
+});
+export type BuildInformationVerificationMessageParams = z.infer<typeof BuildInformationVerificationMessageParamsSchema>;
+
+export const QueryInformationVerificationHistoryParamsSchema = z.object({
+	page: z.number().int().min(1).default(1).describe("页码"),
+	pageSize: z.number().int().min(1).max(50).default(10).describe("每页数量，默认 10")
+});
+export type QueryInformationVerificationHistoryParams = z.infer<typeof QueryInformationVerificationHistoryParamsSchema>;
+
+export const GetInformationVerificationDetailParamsSchema = z.object({
+	id: z.string().trim().min(1).optional().describe("记录 ID"),
+	sourceId: z.string().trim().min(1).optional().describe("新闻来源 ID，例如 news-5")
+}).refine((value) => value.id || value.sourceId, {
+	message: "id 或 sourceId 至少提供一个"
+});
+export type GetInformationVerificationDetailParams = z.infer<typeof GetInformationVerificationDetailParamsSchema>;

package/src/features/informationVerification/tools.ts

@@ -0,0 +1,181 @@
+import { getDB } from "../../core/database.js";
+import {
+	BuildInformationVerificationMessageParams,
+	BuildInformationVerificationMessageParamsSchema,
+	GetInformationVerificationDetailParamsSchema,
+	QueryInformationVerificationHistoryParamsSchema
+} from "./schema.js";
+
+interface RuntimeTool {
+	name: string;
+	label?: string;
+	description: string;
+	parameters: unknown;
+	registerTool?: boolean;
+	execute(params: unknown, ctx?: { userId: string }): Promise<string>;
+}
+
+const INFORMATION_VERIFICATION_SKILL = "hedgehog-information-verification";
+
+const BuildInformationVerificationMessageAgentToolSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: ["newsId", "sourceTitle", "sourceContent"],
+	properties: {
+		newsId: { type: "string", description: "新闻 ID，例如 news-5" },
+		sourceTitle: { type: "string", description: "新闻标题" },
+		sourceContent: { type: "string", description: "新闻正文" }
+	}
+};
+
+function buildContent(args: BuildInformationVerificationMessageParams): string {
+	return [
+		"对这条新闻进行信息求证",
+		"",
+		`新闻标题：${args.sourceTitle}`,
+		"",
+		"新闻正文：",
+		args.sourceContent
+	].join("\n");
+}
+
+function buildInformationVerificationMessage(args: BuildInformationVerificationMessageParams): string {
+	const buildGeneratingSaveParams = () => JSON.stringify({
+		sourceId: args.newsId,
+		sourceTitle: args.sourceTitle,
+		status: "generating",
+		content: ""
+	});
+	const buildFinalSaveParams = (status: "completed" | "failed") => JSON.stringify({
+		sourceId: args.newsId,
+		status,
+		content: "..."
+	});
+	return JSON.stringify({
+		cw_system_prompt: [
+			`开始分析前必须先调用 save_information_verification，参数为 ${buildGeneratingSaveParams()}；如果返回 skipped=true，必须立即停止，不要继续调用 skill 或生成正文。`,
+			`必须触发并使用 ${INFORMATION_VERIFICATION_SKILL} skill 生成信息求证与置信度审计报告。`,
+			`生成成功后必须调用 save_information_verification，参数为 ${buildFinalSaveParams("completed")}，content 传最终完整求证报告正文。`,
+			`生成失败后必须调用 save_information_verification，参数为 ${buildFinalSaveParams("failed")}，content 存放完整错误信息。`
+		].join("\n"),
+		cw_context: JSON.stringify({
+			sourceId: args.newsId,
+			sourceTitle: args.sourceTitle
+		}),
+		cw_content: buildContent(args),
+		cw_output: [
+			`输出结构以 ${INFORMATION_VERIFICATION_SKILL} skill 的交付模板为准。`
+		].join("\n")
+	});
+}
+
+function selectGeneratingInformationVerification(userId: string, sourceId: string) {
+	const db = getDB();
+	return db.prepare(`
+		SELECT id, sourceId, sourceTitle, status, content, createdAt, updatedAt
+		FROM news_fact_check_analysis
+		WHERE userId = ? AND sourceId = ? AND status = 'generating'
+		ORDER BY updatedAt DESC, createdAt DESC
+		LIMIT 1
+	`).get(userId, sourceId);
+}
+
+export const informationVerificationTools: Record<string, RuntimeTool> = {
+	query_information_verification_history: {
+		name: "query_information_verification_history",
+		label: "查询信息求证列表",
+		description: "分页查询信息求证记录列表。返回记录标识、来源 ID、标题、状态和时间字段；列表结果不包含 content，详情请使用 get_information_verification_detail 查询。",
+		parameters: QueryInformationVerificationHistoryParamsSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = QueryInformationVerificationHistoryParamsSchema.parse(params ?? {});
+			const db = getDB();
+			const userId = ctx?.userId || "default";
+			const offset = (args.page - 1) * args.pageSize;
+			const rows = db.prepare(`
+				SELECT id, sourceId, sourceTitle, status, createdAt, updatedAt
+				FROM news_fact_check_analysis
+				WHERE userId = ?
+				ORDER BY updatedAt DESC, createdAt DESC
+				LIMIT ? OFFSET ?
+			`).all(userId, args.pageSize, offset);
+			const countRow = db.prepare(`
+				SELECT COUNT(*) AS total FROM news_fact_check_analysis WHERE userId = ?
+			`).get(userId) as { total: number };
+			const total = countRow.total || 0;
+			return JSON.stringify({
+				success: true,
+				data: rows,
+				pagination: {
+					page: args.page,
+					pageSize: args.pageSize,
+					total,
+					totalPages: Math.ceil(total / args.pageSize)
+				}
+			});
+		}
+	},
+	get_information_verification_detail: {
+		name: "get_information_verification_detail",
+		label: "查询信息求证详情",
+		description: "根据记录 ID 或 sourceId 查询信息求证完整详情，包含 content 正文及所有元数据。",
+		parameters: GetInformationVerificationDetailParamsSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = GetInformationVerificationDetailParamsSchema.parse(params);
+			const db = getDB();
+			if (args.sourceId) {
+				const row = db.prepare(`
+					SELECT id, sourceId, sourceTitle, status, content, createdAt, updatedAt
+					FROM news_fact_check_analysis
+					WHERE sourceId = ?
+					ORDER BY updatedAt DESC, createdAt DESC
+					LIMIT 1
+				`).get(args.sourceId);
+				return JSON.stringify({ success: true, data: row || null });
+			}
+			const row = db.prepare(`
+				SELECT id, sourceId, sourceTitle, status, content, createdAt, updatedAt
+				FROM news_fact_check_analysis
+				WHERE id = ?
+				ORDER BY updatedAt DESC, createdAt DESC
+				LIMIT 1
+			`).get(args.id);
+			return JSON.stringify({ success: true, data: row || null });
+		}
+	},
+	build_information_verification_message: {
+		name: "build_information_verification_message",
+		label: "构建信息求证消息",
+		description: "根据新闻 ID、标题和正文构建用于主动 RPC 发起 Agent 信息求证任务的标准消息。该工具只返回提示词消息体，不触发定时任务，也不保存分析结果。",
+		parameters: BuildInformationVerificationMessageAgentToolSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = BuildInformationVerificationMessageParamsSchema.parse(params);
+			const userId = ctx?.userId || "default";
+			const generating = selectGeneratingInformationVerification(userId, args.newsId);
+			if (generating) {
+				return JSON.stringify({
+					success: true,
+					skipped: true,
+					reason: "already_generating",
+					data: generating
+				});
+			}
+			const message = buildInformationVerificationMessage(args);
+			return JSON.stringify({
+				success: true,
+				data: {
+					message,
+					payload: JSON.parse(message),
+					sourceId: args.newsId,
+					saveParams: {
+						sourceId: args.newsId,
+						sourceTitle: args.sourceTitle
+					},
+					skill: INFORMATION_VERIFICATION_SKILL
+				}
+			});
+		}
+	}
+};

package/src/features/notes/schema.ts

@@ -1,4 +1,4 @@
-import { z } from "openclaw/plugin-sdk/zod";
+import { z } from "zod";
 
 const ExchangeEnum = z.enum(["SSE", "SZSE", "NASDAQ", "NYSE", "AMEX", "HKEX"]);
 const ProfileLibraryInputSchema = z.object({
@@ -8,12 +8,12 @@ const ProfileLibraryInputSchema = z.object({
 
 export const AddStockNoteParamsSchema = z.object({
 	watchlistId: z.string().trim().min(1).optional().describe("自选股 ID，优先使用该字段绑定股票"),
-	stockCode: z.string().trim().min(1).optional().describe("股票代码；未传 watchlistId 时需与 exchange 一起定位股票"),
-	exchange: ExchangeEnum.optional().describe("交易所；未传 watchlistId 时需与 stockCode 一起定位股票"),
+	stock_code: z.string().trim().min(1).optional().describe("股票代码；未传 watchlistId 时需与 exchange 一起定位股票"),
+	exchange: ExchangeEnum.optional().describe("交易所；未传 watchlistId 时需与 stock_code 一起定位股票"),
 	note: z.string().trim().min(1).max(200).describe("笔记内容，200 字以内"),
 	profileLibraryIds: z.array(ProfileLibraryInputSchema).optional().describe("关联资料库列表，格式为 { id, title }")
-}).refine((value) => Boolean(value.watchlistId || (value.stockCode && value.exchange)), {
-	message: "watchlistId 或 stockCode + exchange 必须传一个"
+}).refine((value) => Boolean(value.watchlistId || (value.stock_code && value.exchange)), {
+	message: "watchlistId 或 stock_code + exchange 必须传一个"
 });
 export type AddStockNoteParams = z.infer<typeof AddStockNoteParamsSchema>;
 
@@ -25,12 +25,12 @@ export type DeleteStockNoteParams = z.infer<typeof DeleteStockNoteParamsSchema>;
 export const UpdateStockNoteParamsSchema = z.object({
 	id: z.string().trim().min(1).describe("笔记 ID"),
 	watchlistId: z.string().trim().min(1).optional().describe("自选股 ID；传入则重新绑定股票"),
-	stockCode: z.string().trim().min(1).optional().describe("股票代码；与 exchange 一起传入可重新绑定股票"),
-	exchange: ExchangeEnum.optional().describe("交易所；与 stockCode 一起传入可重新绑定股票"),
+	stock_code: z.string().trim().min(1).optional().describe("股票代码；与 exchange 一起传入可重新绑定股票"),
+	exchange: ExchangeEnum.optional().describe("交易所；与 stock_code 一起传入可重新绑定股票"),
 	note: z.string().trim().min(1).max(200).optional().describe("笔记内容，200 字以内"),
 	profileLibraryIds: z.array(ProfileLibraryInputSchema).optional().describe("关联资料库列表，格式为 { id, title }；传入则覆盖原有关联")
-}).refine((value) => !(value.stockCode && !value.exchange) && !(!value.stockCode && value.exchange), {
-	message: "stockCode 与 exchange 必须同时传入"
+}).refine((value) => !(value.stock_code && !value.exchange) && !(!value.stock_code && value.exchange), {
+	message: "stock_code 与 exchange 必须同时传入"
 });
 export type UpdateStockNoteParams = z.infer<typeof UpdateStockNoteParamsSchema>;
 
@@ -41,7 +41,7 @@ export type GetStockNoteByIdParams = z.infer<typeof GetStockNoteByIdParamsSchema
 
 export const QueryStockNotesParamsSchema = z.object({
 	watchlistId: z.string().trim().min(1).optional().describe("自选股 ID"),
-	stockCode: z.string().trim().min(1).optional().describe("股票代码"),
+	stock_code: z.string().trim().min(1).optional().describe("股票代码"),
 	exchange: ExchangeEnum.optional().describe("交易所"),
 	keyword: z.string().trim().optional().describe("模糊查询关键词，可匹配股票代码、股票名称或笔记内容"),
 	page: z.number().int().min(1).optional().describe("页码，从 1 开始，默认 1"),
@@ -52,8 +52,8 @@ export type QueryStockNotesParams = z.infer<typeof QueryStockNotesParamsSchema>;
 export interface StockNoteRow {
 	id: string;
 	watchlistId: string;
-	stockCode: string;
-	stockName: string;
+	stock_code: string;
+	stock_name: string;
 	exchange: string;
 	market: string;
 	note: string;
@@ -73,3 +73,8 @@ export interface StockNote extends StockNoteRow {
 		title: string;
 	}[];
 }
+
+export const GetStockNoteParamsSchema = z.object({
+	stock_code: z.string().trim().min(1).describe("股票代码")
+});
+export type GetStockNoteParams = z.infer<typeof GetStockNoteParamsSchema>;

package/src/features/notes/tools.ts

@@ -13,21 +13,33 @@ import {
 	StockNoteProfileLibraryRow,
 	StockNoteRow,
 	UpdateStockNoteParams,
-	UpdateStockNoteParamsSchema
+	UpdateStockNoteParamsSchema,
+	GetStockNoteParamsSchema,
+	GetStockNoteParams
 } from "./schema.js";
 
 interface RuntimeTool {
 	name: string;
+	label?: string;
 	description: string;
 	parameters: unknown;
 	registerTool?: boolean;
 	execute(params: unknown, ctx: { userId: string }): Promise<string>;
 }
 
+const GetStockNoteAgentToolSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: ["stock_code"],
+	properties: {
+		stock_code: { type: "string", description: "股票代码，例如：000001.SZ 或 600000.SH" }
+	}
+};
+
 interface WatchlistStock {
 	id: string;
-	stockCode: string;
-	stockName: string;
+	stock_code: string;
+	stock_name: string;
 	exchange: string;
 	market: string;
 }
@@ -77,8 +89,8 @@ function getNoteSelectSql(whereSql: string): string {
 		SELECT
 			sn.id,
 			sn.watchlistId,
-			w.stockCode,
-			w.stockName,
+			w.stock_code,
+			w.stock_name,
 			w.exchange,
 			w.market,
 			sn.note,
@@ -93,22 +105,22 @@ function getNoteSelectSql(whereSql: string): string {
 function resolveWatchlistStock(
 	db: ReturnType<typeof getDB>,
 	userId: string,
-	args: { watchlistId?: string; stockCode?: string; exchange?: string }
+	args: { watchlistId?: string; stock_code?: string; exchange?: string }
 ): WatchlistStock | null {
 	if (args.watchlistId) {
 		return db.prepare(`
-			SELECT id, stockCode, stockName, exchange, market
+			SELECT id, stock_code, stock_name, exchange, market
 			FROM watchlist
 			WHERE id = ? AND userId = ? AND isDeleted = 0
 		`).get(args.watchlistId.trim(), userId) as WatchlistStock | undefined || null;
 	}
 
-	if (args.stockCode && args.exchange) {
+	if (args.stock_code && args.exchange) {
 		return db.prepare(`
-			SELECT id, stockCode, stockName, exchange, market
+			SELECT id, stock_code, stock_name, exchange, market
 			FROM watchlist
-			WHERE userId = ? AND stockCode = ? AND exchange = ? AND isDeleted = 0
-		`).get(userId, args.stockCode.trim(), args.exchange) as WatchlistStock | undefined || null;
+			WHERE userId = ? AND stock_code = ? AND exchange = ? AND isDeleted = 0
+		`).get(userId, args.stock_code.trim(), args.exchange) as WatchlistStock | undefined || null;
 	}
 
 	return null;
@@ -234,10 +246,10 @@ export const noteTools: Record<string, RuntimeTool> = {
 					return JSON.stringify({ success: false, error: "笔记不存在" });
 				}
 
-				const stock = (args.watchlistId || args.stockCode || args.exchange)
+				const stock = (args.watchlistId || args.stock_code || args.exchange)
 					? resolveWatchlistStock(db, uId, args)
 					: null;
-				if ((args.watchlistId || args.stockCode || args.exchange) && !stock) {
+				if ((args.watchlistId || args.stock_code || args.exchange) && !stock) {
 					return JSON.stringify({ success: false, error: "股票不存在或未在自选列表中" });
 				}
 				const profileLibraries = args.profileLibraryIds === undefined ? undefined : uniqueProfileLibraries(args.profileLibraryIds);
@@ -316,9 +328,9 @@ export const noteTools: Record<string, RuntimeTool> = {
 					conditions.push("sn.watchlistId = ?");
 					params.push(args.watchlistId);
 				}
-				if (args.stockCode) {
-					conditions.push("w.stockCode = ?");
-					params.push(args.stockCode);
+				if (args.stock_code) {
+					conditions.push("w.stock_code = ?");
+					params.push(args.stock_code);
 				}
 				if (args.exchange) {
 					conditions.push("w.exchange = ?");
@@ -327,7 +339,7 @@ export const noteTools: Record<string, RuntimeTool> = {
 				const keyword = args.keyword?.trim();
 				if (keyword) {
 					const pattern = `%${escapeLikePattern(keyword)}%`;
-					conditions.push("(w.stockCode LIKE ? ESCAPE '\\' OR w.stockName LIKE ? ESCAPE '\\' OR sn.note LIKE ? ESCAPE '\\')");
+					conditions.push("(w.stock_code LIKE ? ESCAPE '\\' OR w.stock_name LIKE ? ESCAPE '\\' OR sn.note LIKE ? ESCAPE '\\')");
 					params.push(pattern, pattern, pattern);
 				}
 
@@ -348,5 +360,30 @@ export const noteTools: Record<string, RuntimeTool> = {
 				return JSON.stringify({ success: false, error: e.message });
 			}
 		}
+	},
+
+	get_stock_note: {
+		name: "get_stock_note",
+		label: "拉取股票笔记",
+		description: "根据股票代码拉取股票笔记。",
+		parameters: GetStockNoteAgentToolSchema,
+		registerTool: true,
+		execute: async (rawArgs: unknown) => {
+			try {
+				const args = GetStockNoteParamsSchema.parse(rawArgs);
+				const db = getDB();
+				const code = args.stock_code.trim().toUpperCase().replace(/\.SS$/i, ".SH");
+				const rows = db.prepare(`
+					SELECT sn.id, sn.note, sn.createdAt, sn.updatedAt
+					FROM stock_notes sn
+					JOIN watchlist w ON w.id = sn.watchlistId
+					WHERE w.stock_code = ? AND w.isDeleted = 0
+					ORDER BY sn.updatedAt DESC, sn.createdAt DESC
+				`).all(code) as { id: string; note: string; createdAt: string; updatedAt: string }[];
+				return JSON.stringify({ success: true, data: rows });
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
 	}
 };

package/src/features/pluginInfo/schema.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+
+export const GetPluginVersionParamsSchema = z.object({}).nullish();
+
+export const GetSkillVersionsParamsSchema = z.object({}).nullish();
+
+export const UpdateSkillVersionsParamsSchema = z.object({
+	versions: z.record(z.string()).optional(),
+	skills: z.array(z.object({
+		name: z.string(),
+		version: z.string()
+	})).optional()
+}).refine(params => Boolean(params.versions || params.skills), {
+	message: "versions or skills is required"
+});
+export type UpdateSkillVersionsParams = z.infer<typeof UpdateSkillVersionsParamsSchema>;
+
+export const BuildUpdateSkillVersionsMessageParamsSchema = UpdateSkillVersionsParamsSchema;
+export type BuildUpdateSkillVersionsMessageParams = z.infer<typeof BuildUpdateSkillVersionsMessageParamsSchema>;

package/src/features/pluginInfo/tools.ts

@@ -1,17 +1,27 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
-import { z } from "openclaw/plugin-sdk/zod";
+import { getDB } from "../../core/database.js";
+import {
+	BuildUpdateSkillVersionsMessageParams,
+	BuildUpdateSkillVersionsMessageParamsSchema,
+	GetPluginVersionParamsSchema,
+	GetSkillVersionsParamsSchema,
+	UpdateSkillVersionsParams,
+	UpdateSkillVersionsParamsSchema
+} from "./schema.js";
 
 interface RuntimeTool {
 	name: string;
 	description: string;
 	parameters: unknown;
 	registerTool?: boolean;
+	agentToolTarget?: "main";
 	execute(params: unknown, ctx: { userId: string }): Promise<string>;
 }
 
-const GetPluginVersionParamsSchema = z.object({}).nullish();
+const UPDATE_SKILL_VERSIONS_TOOL_NAME = "update_hedgehog_skill_versions";
+const HEDGEHOG_INIT_SKILL_NAME = "hedgehog-init";
 
 let cachedPluginVersion: string | null = null;
 
@@ -46,6 +56,119 @@ function getPluginVersion(): string {
 	return cachedPluginVersion;
 }
 
+function getSkillVersions() {
+	const rows = getDB().prepare(`
+		SELECT skillName, version, createdAt, updatedAt
+		FROM skill_versions
+		ORDER BY skillName ASC
+	`).all() as { skillName: string; version: string; createdAt: string; updatedAt: string }[];
+	const versions: Record<string, string> = {};
+	const skills = rows.map(row => {
+		versions[row.skillName] = row.version;
+		return {
+			name: row.skillName,
+			version: row.version,
+			createdAt: row.createdAt,
+			updatedAt: row.updatedAt
+		};
+	});
+
+	return {
+		skills,
+		versions
+	};
+}
+
+function normalizeSkillVersionUpdates(params: UpdateSkillVersionsParams) {
+	const updates = new Map<string, string>();
+
+	if (params.versions) {
+		for (const [name, version] of Object.entries(params.versions)) {
+			const trimmedName = name.trim();
+			const trimmedVersion = version.trim();
+			if (trimmedName && trimmedVersion) updates.set(trimmedName, trimmedVersion);
+		}
+	}
+
+	if (params.skills) {
+		for (const skill of params.skills) {
+			const trimmedName = skill.name.trim();
+			const trimmedVersion = skill.version.trim();
+			if (trimmedName && trimmedVersion) updates.set(trimmedName, trimmedVersion);
+		}
+	}
+
+	return Array.from(updates.entries()).map(([name, version]) => ({ name, version }));
+}
+
+function updateSkillVersions(params: UpdateSkillVersionsParams) {
+	const updates = normalizeSkillVersionUpdates(params);
+	const db = getDB();
+	const stmt = db.prepare(`
+		INSERT INTO skill_versions (skillName, version, updatedAt)
+		VALUES (?, ?, STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW'))
+		ON CONFLICT(skillName) DO UPDATE SET
+			version = excluded.version,
+			updatedAt = excluded.updatedAt
+	`);
+
+	db.exec("BEGIN");
+	try {
+		for (const update of updates) {
+			stmt.run(update.name, update.version);
+		}
+		db.exec("COMMIT");
+	} catch (e) {
+		if (db.inTransaction) db.exec("ROLLBACK");
+		throw e;
+	}
+
+	return {
+		updated: updates,
+		...getSkillVersions()
+	};
+}
+
+function buildUpdateSkillVersionsMessage(params: BuildUpdateSkillVersionsMessageParams): string {
+	const updates = normalizeSkillVersionUpdates(params);
+	const toolParams = {
+		skills: updates
+	};
+	const includesHedgehogInit = updates.some(update => update.name === HEDGEHOG_INIT_SKILL_NAME);
+
+	if (includesHedgehogInit) {
+		return JSON.stringify({
+			cw_system_prompt: [
+				"必须触发并使用 hedgehog-init skill 更新 hedgehog-workspace 的系统提示词到最新版本。",
+				`只有在 hedgehog-init skill 的系统提示词更新流程成功后，才可以调用 ${UPDATE_SKILL_VERSIONS_TOOL_NAME} 工具。`,
+				`成功后必须调用 ${UPDATE_SKILL_VERSIONS_TOOL_NAME} 工具更新本地数据库中的 skill 版本号，参数为 ${JSON.stringify(toolParams)}。`,
+				"如果系统提示词更新失败，禁止调用 update_hedgehog_skill_versions，必须直接说明失败原因。"
+			].join("\n"),
+			cw_context: JSON.stringify({
+				action: "update_hedgehog_init_system_prompt",
+				skills: updates
+			}),
+			cw_content: "Skill升级了，帮我更新`hedgehog-workspace`系统提示词到最新版本。",
+			cw_output: "系统提示词更新成功后，调用 update_hedgehog_skill_versions 工具写入版本，并返回简短结果。"
+		});
+	}
+
+	return JSON.stringify({
+		cw_system_prompt: [
+			"必须先更新 hedgehog-workspace 中的 hedgehog skills。",
+			`只有在 hedgehog skills 更新成功后，才可以调用 ${UPDATE_SKILL_VERSIONS_TOOL_NAME} 工具。`,
+			`更新成功后必须调用 ${UPDATE_SKILL_VERSIONS_TOOL_NAME} 工具更新本地数据库中的 skill 版本号，参数为 ${JSON.stringify(toolParams)}。`,
+			"如果 hedgehog skills 更新失败，禁止调用 update_hedgehog_skill_versions，必须直接说明失败原因。"
+		].join("\n"),
+		cw_context: JSON.stringify({
+			action: "update_hedgehog_skills",
+			skills: updates
+		}),
+		cw_content: "帮我更新`hedgehog-workspace`的hedgehog skills",
+		cw_output: "hedgehog skills 更新成功后，调用 update_hedgehog_skill_versions 工具写入版本，并返回简短结果。"
+	});
+}
+
 export const pluginInfoTools: Record<string, RuntimeTool> = {
 	get_plugin_version: {
 		name: "get_plugin_version",
@@ -59,5 +182,53 @@ export const pluginInfoTools: Record<string, RuntimeTool> = {
 				version: getPluginVersion()
 			});
 		}
+	},
+	get_skill_versions: {
+		name: "get_skill_versions",
+		description: "获取数据库中记录的所有 skill 版本号",
+		parameters: GetSkillVersionsParamsSchema,
+		registerTool: false,
+		async execute(params: unknown) {
+			GetSkillVersionsParamsSchema.parse(params);
+			return JSON.stringify({
+				success: true,
+				...getSkillVersions()
+			});
+		}
+	},
+	update_hedgehog_skill_versions: {
+		name: "update_hedgehog_skill_versions",
+		description: "更新数据库中记录的 skill 版本号",
+		parameters: UpdateSkillVersionsParamsSchema,
+		registerTool: false,
+		agentToolTarget: "main",
+		async execute(params: unknown) {
+			const parsed = UpdateSkillVersionsParamsSchema.parse(params);
+			return JSON.stringify({
+				success: true,
+				...updateSkillVersions(parsed)
+			});
+		}
+	},
+	build_update_skill_versions_message: {
+		name: "build_update_skill_versions_message",
+		description: "构建用于主动 RPC 发起 Agent 更新数据库 skill 版本号任务的标准消息。该方法只返回提示词消息体，不直接更新数据库。",
+		parameters: BuildUpdateSkillVersionsMessageParamsSchema,
+		registerTool: false,
+		async execute(params: unknown) {
+			const parsed = BuildUpdateSkillVersionsMessageParamsSchema.parse(params);
+			const message = buildUpdateSkillVersionsMessage(parsed);
+			return JSON.stringify({
+				success: true,
+				data: {
+					message,
+					payload: JSON.parse(message),
+					tool: UPDATE_SKILL_VERSIONS_TOOL_NAME,
+					updateParams: {
+						skills: normalizeSkillVersionUpdates(parsed)
+					}
+				}
+			});
+		}
 	}
 };

package/src/features/profileLibrary/schema.ts

@@ -1,4 +1,4 @@
-import { z } from "openclaw/plugin-sdk/zod";
+import { z } from "zod";
 
 export const AddProfileLibraryParamsSchema = z.object({
 	id: z.string().trim().min(1).optional().describe("资料库 ID，不传则自动生成"),