@hedgehog-finance/hedgehog-plugin 1.0.19 → 1.0.21

package/src/core/database.ts

@@ -141,6 +141,100 @@ function runWatchlistDedupMigrations(db: DatabaseSync) {
 	`);
 }
 
+function runStockNotesMigrations(db: DatabaseSync) {
+	const columns = db.prepare("PRAGMA table_info(stock_notes)").all() as { name: string }[];
+	if (columns.length > 0 && !columns.some(column => column.name === "watchlistId")) {
+		db.prepare("ALTER TABLE stock_notes ADD COLUMN watchlistId TEXT").run();
+	}
+	const relationColumns = db.prepare("PRAGMA table_info(stock_note_profile_libraries)").all() as { name: string }[];
+	if (relationColumns.length > 0 && !relationColumns.some(column => column.name === "title")) {
+		db.prepare("ALTER TABLE stock_note_profile_libraries ADD COLUMN title TEXT NOT NULL DEFAULT ''").run();
+	}
+	db.exec("CREATE INDEX IF NOT EXISTS idx_stock_notes_user_stock ON stock_notes(userId, watchlistId, updatedAt DESC)");
+}
+
+function runStockAiAnalysisMigrations(db: DatabaseSync) {
+	const indexes = db.prepare("PRAGMA index_list(stock_ai_analysis)").all() as { name: string; unique: number }[];
+	const hasUniqueStockIndex = indexes.some(index => {
+		if (index.unique !== 1) return false;
+		const columns = db.prepare(`PRAGMA index_info(${index.name})`).all() as { name: string }[];
+		const columnNames = columns.map(column => column.name);
+		return columnNames.includes("userId") && columnNames.includes("stockCode");
+	});
+	if (!hasUniqueStockIndex) return;
+
+	db.exec("BEGIN");
+	try {
+		db.exec(`
+			DROP TABLE IF EXISTS stock_ai_analysis_history;
+
+			CREATE TABLE stock_ai_analysis_history (
+				id            TEXT NOT NULL,
+				userId        TEXT NOT NULL,
+				stockCode     TEXT NOT NULL,
+				stockName     TEXT NOT NULL,
+				market        TEXT NOT NULL DEFAULT 'CN',
+				content       TEXT NOT NULL,
+				createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+				updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+				PRIMARY KEY(id, userId)
+			);
+
+			INSERT INTO stock_ai_analysis_history (id, userId, stockCode, stockName, market, content, createdAt, updatedAt)
+			SELECT id, userId, stockCode, stockName, market, content, createdAt, updatedAt
+			FROM stock_ai_analysis;
+
+			DROP TABLE stock_ai_analysis;
+			ALTER TABLE stock_ai_analysis_history RENAME TO stock_ai_analysis;
+			CREATE INDEX IF NOT EXISTS idx_stock_ai_analysis_user_stock_updated ON stock_ai_analysis(userId, stockCode, updatedAt DESC);
+		`);
+		db.exec("COMMIT");
+	} catch (e) {
+		if (db.inTransaction) db.exec("ROLLBACK");
+		throw e;
+	}
+}
+
+function runArticleAiAnalysisMigrations(db: DatabaseSync) {
+	const columns = db.prepare("PRAGMA table_info(article_ai_analysis)").all() as { name: string }[];
+	if (columns.length === 0 || columns.some(column => column.name === "sourceId")) {
+		return;
+	}
+
+	db.exec("BEGIN");
+	try {
+		db.exec(`
+			DROP TABLE IF EXISTS article_ai_analysis_v2;
+
+			CREATE TABLE article_ai_analysis_v2 (
+				id            TEXT NOT NULL,
+				sourceId      TEXT NOT NULL,
+				userId        TEXT NOT NULL,
+				analysisType  TEXT NOT NULL,
+				market        TEXT NOT NULL DEFAULT 'CN',
+				content       TEXT NOT NULL,
+				createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+				updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+				PRIMARY KEY(id, userId),
+				UNIQUE(sourceId, userId, analysisType, market)
+			);
+
+			INSERT INTO article_ai_analysis_v2 (id, sourceId, userId, analysisType, market, content, createdAt, updatedAt)
+			SELECT lower(hex(randomblob(16))), id, userId, analysisType, market, content, createdAt, updatedAt
+			FROM article_ai_analysis;
+
+			DROP TABLE article_ai_analysis;
+			ALTER TABLE article_ai_analysis_v2 RENAME TO article_ai_analysis;
+			CREATE INDEX IF NOT EXISTS idx_article_ai_analysis_user_source_type_updated
+				ON article_ai_analysis(userId, sourceId, analysisType, updatedAt DESC);
+		`);
+		db.exec("COMMIT");
+	} catch (e) {
+		if (db.inTransaction) db.exec("ROLLBACK");
+		throw e;
+	}
+}
+
 export function getDB(): DatabaseSync {
 	if (!_db) {
 		const dbPath = getDbPath();
@@ -220,9 +314,70 @@ export function getDB(): DatabaseSync {
 			UNIQUE(watchlistId, categoryId)
 		);
 		CREATE INDEX IF NOT EXISTS idx_watchlist_theme_user ON watchlist_theme_items(userId);
+
+		CREATE TABLE IF NOT EXISTS profile_libraries (
+			id            TEXT NOT NULL,
+			userId        TEXT NOT NULL,
+			title         TEXT NOT NULL,
+			createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			PRIMARY KEY(id, userId)
+		);
+		CREATE INDEX IF NOT EXISTS idx_profile_libraries_user_title ON profile_libraries(userId, title);
+
+		CREATE TABLE IF NOT EXISTS stock_notes (
+			id            TEXT NOT NULL,
+			userId        TEXT NOT NULL,
+			watchlistId   TEXT NOT NULL,
+			note          TEXT NOT NULL CHECK (length(note) <= 200),
+			createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			PRIMARY KEY(id, userId)
+		);
+
+		CREATE TABLE IF NOT EXISTS stock_note_profile_libraries (
+			id                TEXT PRIMARY KEY,
+			noteId            TEXT NOT NULL,
+			userId            TEXT NOT NULL,
+			profileLibraryId  TEXT NOT NULL,
+			title             TEXT NOT NULL,
+			createdAt         DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			UNIQUE(noteId, userId, profileLibraryId)
+		);
+		CREATE INDEX IF NOT EXISTS idx_stock_note_profile_libraries_user_note ON stock_note_profile_libraries(userId, noteId);
+
+		CREATE TABLE IF NOT EXISTS stock_ai_analysis (
+			id            TEXT NOT NULL,
+			userId        TEXT NOT NULL,
+			stockCode     TEXT NOT NULL,
+			stockName     TEXT NOT NULL,
+			market        TEXT NOT NULL DEFAULT 'CN',
+			content       TEXT NOT NULL,
+			createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			PRIMARY KEY(id, userId)
+		);
+		CREATE INDEX IF NOT EXISTS idx_stock_ai_analysis_user_stock_updated ON stock_ai_analysis(userId, stockCode, updatedAt DESC);
+
+		CREATE TABLE IF NOT EXISTS article_ai_analysis (
+			id            TEXT NOT NULL,
+			sourceId      TEXT NOT NULL,
+			userId        TEXT NOT NULL,
+			analysisType  TEXT NOT NULL,
+			market        TEXT NOT NULL DEFAULT 'CN',
+			content       TEXT NOT NULL,
+			createdAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			updatedAt     DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+			PRIMARY KEY(id, userId),
+			UNIQUE(sourceId, userId, analysisType, market)
+		);
+		CREATE INDEX IF NOT EXISTS idx_article_ai_analysis_user_source_type_updated ON article_ai_analysis(userId, sourceId, analysisType, updatedAt DESC);
 		`);
 
 		runWatchlistDedupMigrations(_db);
+		runStockNotesMigrations(_db);
+		runStockAiAnalysisMigrations(_db);
+		runArticleAiAnalysisMigrations(_db);
 	}
 	return _db;
 }

package/src/features/index.ts

@@ -1,4 +1,8 @@
 import { watchlistTools } from "./watchlist/tools.js";
+import { profileLibraryTools } from "./profileLibrary/tools.js";
+import { noteTools } from "./notes/tools.js";
+import { stockAnalysisTools } from "./stockAnalysis/tools.js";
+import { pluginInfoTools } from "./pluginInfo/tools.js";
 
 export interface RuntimeTool {
     name: string;
@@ -10,5 +14,9 @@ export interface RuntimeTool {
 }
 
 export const allFeaturesTools: Record<string, RuntimeTool> = {
-    ...watchlistTools
+    ...watchlistTools,
+    ...profileLibraryTools,
+    ...noteTools,
+    ...stockAnalysisTools,
+    ...pluginInfoTools
 };

package/src/features/notes/schema.ts

@@ -0,0 +1,75 @@
+import { z } from "openclaw/plugin-sdk/zod";
+
+const ExchangeEnum = z.enum(["SSE", "SZSE", "NASDAQ", "NYSE", "AMEX", "HKEX"]);
+const ProfileLibraryInputSchema = z.object({
+	id: z.string().trim().min(1).describe("资料库 ID"),
+	title: z.string().trim().min(1).describe("资料库标题")
+});
+
+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 一起定位股票"),
+	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 必须传一个"
+});
+export type AddStockNoteParams = z.infer<typeof AddStockNoteParamsSchema>;
+
+export const DeleteStockNoteParamsSchema = z.object({
+	id: z.string().trim().min(1).describe("笔记 ID")
+});
+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 一起传入可重新绑定股票"),
+	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 必须同时传入"
+});
+export type UpdateStockNoteParams = z.infer<typeof UpdateStockNoteParamsSchema>;
+
+export const GetStockNoteByIdParamsSchema = z.object({
+	id: z.string().trim().min(1).describe("笔记 ID")
+});
+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("股票代码"),
+	exchange: ExchangeEnum.optional().describe("交易所"),
+	keyword: z.string().trim().optional().describe("模糊查询关键词，可匹配股票代码、股票名称或笔记内容"),
+	page: z.number().int().min(1).optional().describe("页码，从 1 开始，默认 1"),
+	pageSize: z.number().int().min(1).max(100).optional().describe("每页数量，默认 20，最大 100")
+});
+export type QueryStockNotesParams = z.infer<typeof QueryStockNotesParamsSchema>;
+
+export interface StockNoteRow {
+	id: string;
+	watchlistId: string;
+	stockCode: string;
+	stockName: string;
+	exchange: string;
+	market: string;
+	note: string;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface StockNoteProfileLibraryRow {
+	noteId: string;
+	id: string;
+	title: string;
+}
+
+export interface StockNote extends StockNoteRow {
+	profileLibraries: {
+		id: string;
+		title: string;
+	}[];
+}

package/src/features/notes/tools.ts

@@ -0,0 +1,352 @@
+import { randomUUID } from "node:crypto";
+import { getDB } from "../../core/database.js";
+import {
+	AddStockNoteParams,
+	AddStockNoteParamsSchema,
+	DeleteStockNoteParams,
+	DeleteStockNoteParamsSchema,
+	GetStockNoteByIdParams,
+	GetStockNoteByIdParamsSchema,
+	QueryStockNotesParams,
+	QueryStockNotesParamsSchema,
+	StockNote,
+	StockNoteProfileLibraryRow,
+	StockNoteRow,
+	UpdateStockNoteParams,
+	UpdateStockNoteParamsSchema
+} from "./schema.js";
+
+interface RuntimeTool {
+	name: string;
+	description: string;
+	parameters: unknown;
+	registerTool?: boolean;
+	execute(params: unknown, ctx: { userId: string }): Promise<string>;
+}
+
+interface WatchlistStock {
+	id: string;
+	stockCode: string;
+	stockName: string;
+	exchange: string;
+	market: string;
+}
+
+function escapeLikePattern(value: string): string {
+	return value.replace(/[\\%_]/g, (char) => `\\${char}`);
+}
+
+function normalizePagination(args: { page?: number; pageSize?: number }) {
+	const page = args.page ?? 1;
+	const pageSize = args.pageSize ?? 20;
+	return {
+		page,
+		pageSize,
+		offset: (page - 1) * pageSize
+	};
+}
+
+function uniqueProfileLibraries(libraries: { id: string; title: string }[] | undefined): { id: string; title: string }[] {
+	const byId = new Map<string, string>();
+	for (const library of libraries || []) {
+		const id = library.id.trim();
+		const title = library.title.trim();
+		if (id && title && !byId.has(id)) {
+			byId.set(id, title);
+		}
+	}
+	return Array.from(byId, ([id, title]) => ({ id, title }));
+}
+
+function runInTransaction<T>(db: ReturnType<typeof getDB>, task: () => T): T {
+	const savepoint = `note_tx_${randomUUID().replace(/-/g, "")}`;
+	db.exec(`SAVEPOINT ${savepoint}`);
+	try {
+		const result = task();
+		db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+		return result;
+	} catch (e) {
+		db.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);
+		db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+		throw e;
+	}
+}
+
+function getNoteSelectSql(whereSql: string): string {
+	return `
+		SELECT
+			sn.id,
+			sn.watchlistId,
+			w.stockCode,
+			w.stockName,
+			w.exchange,
+			w.market,
+			sn.note,
+			sn.createdAt,
+			sn.updatedAt
+		FROM stock_notes sn
+		JOIN watchlist w ON w.id = sn.watchlistId AND w.userId = sn.userId
+		WHERE ${whereSql}
+	`;
+}
+
+function resolveWatchlistStock(
+	db: ReturnType<typeof getDB>,
+	userId: string,
+	args: { watchlistId?: string; stockCode?: string; exchange?: string }
+): WatchlistStock | null {
+	if (args.watchlistId) {
+		return db.prepare(`
+			SELECT id, stockCode, stockName, 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) {
+		return db.prepare(`
+			SELECT id, stockCode, stockName, exchange, market
+			FROM watchlist
+			WHERE userId = ? AND stockCode = ? AND exchange = ? AND isDeleted = 0
+		`).get(userId, args.stockCode.trim(), args.exchange) as WatchlistStock | undefined || null;
+	}
+
+	return null;
+}
+
+function attachProfileLibraries(db: ReturnType<typeof getDB>, userId: string, rows: StockNoteRow[]): StockNote[] {
+	if (rows.length === 0) return [];
+	const noteIds = rows.map(row => row.id);
+	const libraryRows = db.prepare(`
+		SELECT npl.noteId, npl.profileLibraryId AS id, npl.title
+		FROM stock_note_profile_libraries npl
+		WHERE npl.userId = ? AND npl.noteId IN (${noteIds.map(() => "?").join(",")})
+		ORDER BY npl.noteId, npl.createdAt ASC
+	`).all(userId, ...noteIds) as StockNoteProfileLibraryRow[];
+
+	const librariesByNoteId = new Map<string, { id: string; title: string }[]>();
+	for (const row of libraryRows) {
+		const list = librariesByNoteId.get(row.noteId) || [];
+		list.push({ id: row.id, title: row.title });
+		librariesByNoteId.set(row.noteId, list);
+	}
+
+	return rows.map(row => {
+		const libs = librariesByNoteId.get(row.id) || [];
+		return {
+			...row,
+			profileLibraries: libs
+		};
+	});
+}
+
+function successWithPagination(data: StockNote[], page: number, pageSize: number, total: number) {
+	return JSON.stringify({
+		success: true,
+		data,
+		pagination: {
+			page,
+			pageSize,
+			total,
+			totalPages: Math.ceil(total / pageSize)
+		}
+	});
+}
+
+export const noteTools: Record<string, RuntimeTool> = {
+	add_stock_note: {
+		name: "add_stock_note",
+		description: "新增股票笔记，笔记内容 200 字以内，可关联资料库列表；profileLibraryIds 格式为 { id, title }",
+		parameters: AddStockNoteParamsSchema,
+		registerTool: false,
+		execute: async (args: AddStockNoteParams, ctx: { userId: string }) => {
+			try {
+				const db = getDB();
+				const uId = String(ctx.userId);
+				const id = randomUUID();
+				const stock = resolveWatchlistStock(db, uId, args);
+				if (!stock) {
+					return JSON.stringify({ success: false, error: "股票不存在或未在自选列表中" });
+				}
+				const profileLibraries = uniqueProfileLibraries(args.profileLibraryIds);
+
+				runInTransaction(db, () => {
+					db.prepare(`
+						INSERT INTO stock_notes (id, userId, watchlistId, note)
+						VALUES (?, ?, ?, ?)
+					`).run(id, uId, stock.id, args.note);
+
+					const insertRelation = db.prepare(`
+						INSERT INTO stock_note_profile_libraries (id, noteId, userId, profileLibraryId, title)
+						VALUES (?, ?, ?, ?, ?)
+					`);
+					profileLibraries.forEach((profileLibrary) => {
+						insertRelation.run(randomUUID(), id, uId, profileLibrary.id, profileLibrary.title);
+					});
+				});
+
+				const row = db.prepare(getNoteSelectSql("sn.id = ? AND sn.userId = ?")).get(id, uId) as StockNoteRow;
+				return JSON.stringify({ success: true, data: attachProfileLibraries(db, uId, [row])[0] });
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
+	},
+
+	delete_stock_note: {
+		name: "delete_stock_note",
+		description: "删除股票笔记，并清理笔记关联资料库记录",
+		parameters: DeleteStockNoteParamsSchema,
+		registerTool: false,
+		execute: async (args: DeleteStockNoteParams, ctx: { userId: string }) => {
+			try {
+				const db = getDB();
+				const uId = String(ctx.userId);
+				const id = args.id.trim();
+
+				const info = runInTransaction(db, () => {
+					db.prepare("DELETE FROM stock_note_profile_libraries WHERE noteId = ? AND userId = ?").run(id, uId);
+					return db.prepare("DELETE FROM stock_notes WHERE id = ? AND userId = ?").run(id, uId);
+				});
+				return JSON.stringify({ success: info.changes > 0 });
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
+	},
+
+	update_stock_note: {
+		name: "update_stock_note",
+		description: "修改股票笔记；传入 profileLibraryIds 时会覆盖原有关联资料库列表；profileLibraryIds 格式为 { id, title }",
+		parameters: UpdateStockNoteParamsSchema,
+		registerTool: false,
+		execute: async (args: UpdateStockNoteParams, ctx: { userId: string }) => {
+			try {
+				const db = getDB();
+				const uId = String(ctx.userId);
+				const id = args.id.trim();
+				const existing = db.prepare(`
+					SELECT id
+					FROM stock_notes
+					WHERE id = ? AND userId = ?
+				`).get(id, uId);
+				if (!existing) {
+					return JSON.stringify({ success: false, error: "笔记不存在" });
+				}
+
+				const stock = (args.watchlistId || args.stockCode || args.exchange)
+					? resolveWatchlistStock(db, uId, args)
+					: null;
+				if ((args.watchlistId || args.stockCode || args.exchange) && !stock) {
+					return JSON.stringify({ success: false, error: "股票不存在或未在自选列表中" });
+				}
+				const profileLibraries = args.profileLibraryIds === undefined ? undefined : uniqueProfileLibraries(args.profileLibraryIds);
+
+				runInTransaction(db, () => {
+					const updates: string[] = ["updatedAt = STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')"];
+					const updateParams: unknown[] = [];
+					if (stock) {
+						updates.unshift("watchlistId = ?");
+						updateParams.push(stock.id);
+					}
+					if (args.note !== undefined) {
+						updates.unshift("note = ?");
+						updateParams.unshift(args.note);
+					}
+					db.prepare(`
+						UPDATE stock_notes SET ${updates.join(", ")}
+						WHERE id = ? AND userId = ?
+					`).run(...updateParams, id, uId);
+					if (profileLibraries) {
+						db.prepare(`
+							DELETE FROM stock_note_profile_libraries
+							WHERE userId = ? AND noteId = ?
+						`).run(uId, id);
+
+						const insertRelation = db.prepare(`
+							INSERT INTO stock_note_profile_libraries (id, noteId, userId, profileLibraryId, title)
+							VALUES (?, ?, ?, ?, ?)
+						`);
+						profileLibraries.forEach((profileLibrary) => {
+							insertRelation.run(randomUUID(), id, uId, profileLibrary.id, profileLibrary.title);
+						});
+					}
+				});
+
+				const row = db.prepare(getNoteSelectSql("sn.id = ? AND sn.userId = ?")).get(id, uId) as StockNoteRow;
+				return JSON.stringify({ success: true, data: attachProfileLibraries(db, uId, [row])[0] });
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
+	},
+
+	get_stock_note_by_id: {
+		name: "get_stock_note_by_id",
+		description: "根据 ID 查询股票笔记详情",
+		parameters: GetStockNoteByIdParamsSchema,
+		registerTool: false,
+		execute: async (args: GetStockNoteByIdParams, ctx: { userId: string }) => {
+			try {
+				const db = getDB();
+				const uId = String(ctx.userId);
+				const row = db.prepare(getNoteSelectSql("sn.id = ? AND sn.userId = ?")).get(args.id.trim(), uId) as StockNoteRow | undefined;
+
+				return JSON.stringify({ success: true, data: row ? attachProfileLibraries(db, uId, [row])[0] : null });
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
+	},
+
+	query_stock_notes: {
+		name: "query_stock_notes",
+		description: "分页查询股票笔记，支持按股票代码、交易所和关键词过滤",
+		parameters: QueryStockNotesParamsSchema,
+		registerTool: false,
+		execute: async (args: QueryStockNotesParams = {}, ctx: { userId: string }) => {
+			try {
+				const db = getDB();
+				const uId = String(ctx.userId);
+				const { page, pageSize, offset } = normalizePagination(args);
+				const conditions = ["sn.userId = ?", "w.isDeleted = 0"];
+				const params: unknown[] = [uId];
+
+				if (args.watchlistId) {
+					conditions.push("sn.watchlistId = ?");
+					params.push(args.watchlistId);
+				}
+				if (args.stockCode) {
+					conditions.push("w.stockCode = ?");
+					params.push(args.stockCode);
+				}
+				if (args.exchange) {
+					conditions.push("w.exchange = ?");
+					params.push(args.exchange);
+				}
+				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 '\\')");
+					params.push(pattern, pattern, pattern);
+				}
+
+				const whereSql = conditions.join(" AND ");
+				const total = (db.prepare(`
+					SELECT COUNT(*) AS count
+					FROM stock_notes sn
+					JOIN watchlist w ON w.id = sn.watchlistId AND w.userId = sn.userId
+					WHERE ${whereSql}
+				`).get(...params) as { count: number }).count;
+				const rows = db.prepare(`${getNoteSelectSql(whereSql)}
+					ORDER BY sn.updatedAt DESC, sn.createdAt DESC
+					LIMIT ? OFFSET ?
+				`).all(...params, pageSize, offset) as StockNoteRow[];
+
+				return successWithPagination(attachProfileLibraries(db, uId, rows), page, pageSize, total);
+			} catch (e: any) {
+				return JSON.stringify({ success: false, error: e.message });
+			}
+		}
+	}
+};

package/src/features/pluginInfo/tools.ts

@@ -0,0 +1,63 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "openclaw/plugin-sdk/zod";
+
+interface RuntimeTool {
+	name: string;
+	description: string;
+	parameters: unknown;
+	registerTool?: boolean;
+	execute(params: unknown, ctx: { userId: string }): Promise<string>;
+}
+
+const GetPluginVersionParamsSchema = z.object({}).nullish();
+
+let cachedPluginVersion: string | null = null;
+
+function findPackageJsonPath(startDir: string): string | null {
+	let currentDir = startDir;
+
+	while (true) {
+		const candidate = path.join(currentDir, "package.json");
+		if (fs.existsSync(candidate)) return candidate;
+
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
+}
+
+function getPluginVersion(): string {
+	if (cachedPluginVersion) return cachedPluginVersion;
+
+	const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+	const packageJsonPath = findPackageJsonPath(moduleDir);
+	if (!packageJsonPath) {
+		throw new Error("无法找到插件 package.json");
+	}
+
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) as { version?: unknown };
+	if (typeof packageJson.version !== "string" || !packageJson.version.trim()) {
+		throw new Error("插件 package.json 缺少有效版本号");
+	}
+
+	cachedPluginVersion = packageJson.version.trim();
+	return cachedPluginVersion;
+}
+
+export const pluginInfoTools: Record<string, RuntimeTool> = {
+	get_plugin_version: {
+		name: "get_plugin_version",
+		description: "获取当前 Hedgehog 插件版本号",
+		parameters: GetPluginVersionParamsSchema,
+		registerTool: false,
+		async execute(params: unknown) {
+			GetPluginVersionParamsSchema.parse(params);
+			return JSON.stringify({
+				success: true,
+				version: getPluginVersion()
+			});
+		}
+	}
+};