@hedgehog-finance/hedgehog-plugin 1.0.21 → 1.0.23

package/src/dailyMorningBriefingCron.ts

@@ -0,0 +1,129 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import { logger } from "./core/logger.js";
+import { CHART_OUTPUT_GUIDANCE } from "./features/chartOutput.js";
+import { HEDGEHOG_AGENT_ID } from "./openclawConstants.js";
+
+const DAILY_MORNING_BRIEFING_CRON_ID = "hedgehog_daily_morning_briefing";
+const DAILY_MORNING_BRIEFING_SESSION_KEY = `cron:${DAILY_MORNING_BRIEFING_CRON_ID}`;
+const DAILY_MORNING_BRIEFING_SKILL = "hedgehog-daily-morning-briefing";
+const DAILY_MORNING_BRIEFING_MESSAGE = JSON.stringify({
+	cw_system_prompt: [
+		"开始分析前必须先调用 save_daily_morning_briefing，参数为 {\"status\":\"generating\",\"content\":\"\"}；如果返回 skipped=true，必须立即停止，不要继续调用 skill 或生成正文。",
+		`必须触发并使用 ${DAILY_MORNING_BRIEFING_SKILL} skill 生成盘前简报。`,
+		"生成成功后必须调用 save_daily_morning_briefing，参数为 {\"status\":\"completed\",\"content\":\"...\"}，content 传最终完整早报正文。",
+		"生成失败后必须调用 save_daily_morning_briefing，参数为 {\"status\":\"failed\",\"content\":\"...\"}，content 存放完整错误信息。",
+		"如果最终内容包含 [图表数据]，正文必须已经包含所有对应图表占位符。"
+	].join("\n"),
+	cw_market: "CN",
+	cw_content: [
+		"生成每日早报"
+	].join("\n"),
+	cw_output: [
+		`输出结构以 ${DAILY_MORNING_BRIEFING_SKILL} skill 的交付模板为准。`,
+		CHART_OUTPUT_GUIDANCE
+	].join("\n")
+});
+
+type CronServiceLike = {
+	list(opts?: { includeDisabled?: boolean }): Promise<CronJobLike[]>;
+	add(input: DailyMorningBriefingCronConfig): Promise<unknown>;
+	update(id: string, patch: DailyMorningBriefingCronConfig): Promise<unknown>;
+	remove(id: string): Promise<{ ok?: boolean; removed?: boolean } | undefined>;
+};
+
+type CronJobLike = {
+	id?: string;
+	name?: string;
+	sessionKey?: string;
+	schedule?: {
+		kind?: string;
+		tz?: unknown;
+	};
+};
+
+type DailyMorningBriefingCronConfig = {
+	agentId: string;
+	name: string;
+	description: string;
+	enabled: boolean;
+	schedule: {
+		kind: "cron";
+		expr: string;
+		tz?: string;
+	};
+	sessionTarget: "isolated";
+	wakeMode: "now";
+	payload: {
+		kind: "agentTurn";
+		message: string;
+		timeoutSeconds: number;
+	};
+	delivery: {
+		mode: "none";
+	};
+	deleteAfterRun: false;
+};
+
+function buildDailyMorningBriefingCronConfig(existing?: CronJobLike): DailyMorningBriefingCronConfig {
+	const existingTz = typeof existing?.schedule?.tz === "string" && existing.schedule.tz.trim()
+		? existing.schedule.tz
+		: undefined;
+
+	return {
+		agentId: HEDGEHOG_AGENT_ID,
+		name: DAILY_MORNING_BRIEFING_CRON_ID,
+		description: "触发 hedgehog-daily-morning-briefing skill 生成每日盘前早报并入库。",
+		enabled: true,
+		schedule: {
+			kind: "cron",
+			expr: "30 7 * * *",
+			...(existingTz ? { tz: existingTz } : {})
+		},
+		sessionTarget: "isolated",
+		wakeMode: "now",
+		payload: {
+			kind: "agentTurn",
+			message: DAILY_MORNING_BRIEFING_MESSAGE,
+			timeoutSeconds: 0
+		},
+		delivery: {
+			mode: "none"
+		},
+		deleteAfterRun: false
+	};
+}
+
+function isDailyMorningBriefingCronJob(job: CronJobLike): boolean {
+	return job?.name === DAILY_MORNING_BRIEFING_CRON_ID || job?.sessionKey === DAILY_MORNING_BRIEFING_SESSION_KEY;
+}
+
+export async function ensureDailyMorningBriefingCron(cron: CronServiceLike | undefined): Promise<void> {
+	try {
+		if (!cron) {
+			logger.warn("Daily morning briefing cron was not scheduled because OpenClaw cron API is unavailable");
+			return;
+		}
+
+		const existingJobs = (await cron.list({ includeDisabled: true })).filter(isDailyMorningBriefingCronJob);
+		const [primaryJob, ...duplicateJobs] = existingJobs;
+
+		if (primaryJob?.id) {
+			await cron.update(primaryJob.id, buildDailyMorningBriefingCronConfig(primaryJob));
+		} else {
+			await cron.add(buildDailyMorningBriefingCronConfig());
+		}
+
+		const duplicateIds = duplicateJobs
+			.map(job => job.id)
+			.filter((id): id is string => typeof id === "string" && id.length > 0);
+		await Promise.all(duplicateIds.map(id => cron.remove(id)));
+	} catch (e) {
+		logger.error({ err: e }, "Failed to ensure daily morning briefing cron");
+	}
+}
+
+export function registerDailyMorningBriefingCron(api: OpenClawPluginApi): void {
+	api.on("gateway_start", async (_event, ctx) => {
+		await ensureDailyMorningBriefingCron(ctx.getCron?.());
+	});
+}

package/src/features/chartOutput.ts

@@ -0,0 +1,35 @@
+export function ensureChartPlaceholdersInBody(content: string): string {
+	const chartDataMatch = content.match(/(?:\*\*)?\[图表数据\](?:\*\*)?/);
+	if (!chartDataMatch || typeof chartDataMatch.index !== "number") return content;
+
+	const chartDataStart = chartDataMatch.index;
+	const body = content.slice(0, chartDataStart);
+	const chartData = content.slice(chartDataStart);
+	const placeholders = Array.from(chartData.matchAll(/\{图\d+\}\s*:/g), match => match[0].replace(/\s*:$/, ""));
+	const uniquePlaceholders = [...new Set(placeholders)];
+	const missingPlaceholders = uniquePlaceholders.filter(placeholder => !body.includes(placeholder));
+	if (missingPlaceholders.length === 0) return content;
+
+	const insertion = [
+		"## 图表",
+		"",
+		...missingPlaceholders.flatMap(placeholder => [placeholder, ""])
+	].join("\n");
+	return `${body.trimEnd()}\n\n${insertion}\n${chartData.trimStart()}`;
+}
+
+export const CHART_OUTPUT_GUIDANCE = [
+	"正文中如果生成任何图表，必须在对应分析段落先给出明确金融结论，并在结论后单独放置图表占位符，例如：",
+	"{图1}",
+	"每个图表占位符前后都必须换行；正文占位符与尾部 [图表数据] 编号必须一一对应，禁止只在尾部输出图表数据。",
+	"图表生成遵循投研可视化原则：仅在有助于趋势识别、横向比较、结构拆解或风险暴露说明时生成。",
+	"图表数据必须可追溯，来源限于工具返回、资讯原文、上下文已给出的数值，或正文已明确披露的计算结果；禁止使用示意性、编造型或装饰性数据。",
+	"图表数量控制在 1-3 张；无可靠数值数据时不生成图表。",
+	"图表标题必须明确市场、资产、指标与时间范围；xAxis、series、legend、title 必须与正文结论和数据口径一致。",
+	"图表类型只能取以下值之一：",
+	"[\"Line\",\"Bar\",\"Area\",\"Pie\",\"Donut\",\"Horizontal Bar\",\"Radar\",\"Histogram\",\"Scatter Plot\",\"Bubble\"]",
+	"图表类型选择：趋势变化用 Line 或 Area；横向比较用 Bar 或 Horizontal Bar；结构占比用 Pie 或 Donut；多维评分用 Radar；分布、相关性、离群点用 Histogram、Scatter Plot 或 Bubble。",
+	"如果生成图表，结尾追加 [图表数据]，不要使用代码块，格式必须严格为：",
+	"{图1}: {\"chart\":\"Line\",\"option\":{...}}；{图2}: {\"chart\":\"Bar\",\"option\":{...}}",
+	"其中 chart 必须是上面的图表类型之一，option 必须是纯 JSON，不允许 JS 函数、formatter 函数或注释。"
+].join("\n");

package/src/features/dailyMorningBriefing/schema.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+
+export const DailyMorningBriefingStatusSchema = z.enum(["generating", "completed", "failed"]);
+
+export const SaveDailyMorningBriefingParamsSchema = z.object({
+	id: z.string().trim().min(1).optional().describe("每日早报 ID；开始生成时不传，后续更新状态时传入"),
+	content: z.string().default("").describe("每日早报最终内容；失败时存入错误信息"),
+	status: DailyMorningBriefingStatusSchema.default("completed").describe("保存状态：generating 生成中，completed 成功，failed 失败")
+}).refine((value) => {
+	if (value.status === "completed") return value.content.trim().length > 0;
+	return true;
+}, {
+	message: "completed 状态必须提供 content"
+});
+export type SaveDailyMorningBriefingParams = z.infer<typeof SaveDailyMorningBriefingParamsSchema>;
+
+export const QueryDailyMorningBriefingsParamsSchema = z.object({
+	market: z.string().trim().min(1).default("CN").describe("市场类型，默认 CN"),
+	page: z.number().int().min(1).default(1).describe("页码"),
+	pageSize: z.number().int().min(1).max(50).default(10).describe("每页数量，默认 10")
+});
+export type QueryDailyMorningBriefingsParams = z.infer<typeof QueryDailyMorningBriefingsParamsSchema>;
+
+export const GetDailyMorningBriefingDetailParamsSchema = z.object({
+	id: z.string().trim().min(1).describe("每日早报 ID")
+});
+export type GetDailyMorningBriefingDetailParams = z.infer<typeof GetDailyMorningBriefingDetailParamsSchema>;
+
+export interface DailyMorningBriefing {
+	id: string;
+	market: string;
+	briefingDate: string;
+	content: string;
+	status: string;
+	watchlistSnapshot: unknown[];
+	createdAt: string;
+	updatedAt: string;
+}

package/src/features/dailyMorningBriefing/tools.ts

@@ -0,0 +1,246 @@
+import { getDB } from "../../core/database.js";
+import { ensureChartPlaceholdersInBody } from "../chartOutput.js";
+import {
+	DailyMorningBriefing,
+	GetDailyMorningBriefingDetailParamsSchema,
+	QueryDailyMorningBriefingsParamsSchema,
+	SaveDailyMorningBriefingParamsSchema
+} from "./schema.js";
+
+interface RuntimeTool {
+	name: string;
+	label?: string;
+	description: string;
+	parameters: unknown;
+	registerTool?: boolean;
+	execute(params: unknown, ctx?: { userId: string }): Promise<string>;
+}
+
+const DAILY_MORNING_BRIEFING_MARKET = "CN";
+
+const SaveDailyMorningBriefingAgentToolSchema = {
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		id: { type: "string", description: "每日盘前早报 ID；开始生成时不传，后续更新生成结果时必须传入开始时返回的 id" },
+		content: { type: "string", description: "每日盘前早报正文；status=generating 时为空，status=failed 时存入错误信息" },
+		status: { type: "string", enum: ["generating", "completed", "failed"], description: "保存状态：generating 表示开始生成，completed 表示生成成功，failed 表示生成失败" }
+	}
+};
+
+function normalizeMarket(market: string): string {
+	const raw = market.trim().toUpperCase();
+	if (raw === "A股" || raw === "中国股市" || raw === "MARKETS.CN") return "CN";
+	return raw || "CN";
+}
+
+function getLocalDateString(): string {
+	const now = new Date();
+	const year = now.getFullYear();
+	const month = String(now.getMonth() + 1).padStart(2, "0");
+	const day = String(now.getDate()).padStart(2, "0");
+	return `${year}-${month}-${day}`;
+}
+
+function buildDailyMorningBriefingId(market: string, briefingDate: string): string {
+	return `daily_morning_briefing_${market}_${briefingDate}`;
+}
+
+function selectDailyMorningBriefing(
+	db: ReturnType<typeof getDB>,
+	id: string
+): DailyMorningBriefing {
+	const row = db.prepare(`
+		SELECT id, market, briefingDate, content, status, watchlistSnapshot, createdAt, updatedAt
+		FROM daily_morning_briefings
+		WHERE id = ?
+	`).get(id) as (Omit<DailyMorningBriefing, "watchlistSnapshot"> & { watchlistSnapshot: string }) | undefined;
+
+	if (!row) throw new Error("daily morning briefing was not saved");
+
+	return {
+		id: row.id,
+		market: row.market,
+		briefingDate: row.briefingDate,
+		content: row.content,
+		status: row.status,
+		watchlistSnapshot: JSON.parse(row.watchlistSnapshot || "[]"),
+		createdAt: row.createdAt,
+		updatedAt: row.updatedAt
+	};
+}
+
+function selectExistingActiveDailyMorningBriefing(
+	db: ReturnType<typeof getDB>,
+	market: string,
+	briefingDate: string
+): DailyMorningBriefing | undefined {
+	const row = db.prepare(`
+		SELECT id
+		FROM daily_morning_briefings
+		WHERE market = ?
+			AND briefingDate = ?
+			AND status IN ('generating', 'completed')
+		ORDER BY
+			CASE status WHEN 'completed' THEN 0 WHEN 'generating' THEN 1 ELSE 2 END,
+			updatedAt DESC,
+			createdAt DESC
+		LIMIT 1
+	`).get(market, briefingDate) as { id: string } | undefined;
+	return row ? selectDailyMorningBriefing(db, row.id) : undefined;
+}
+
+function selectGeneratingDailyMorningBriefing(
+	db: ReturnType<typeof getDB>,
+	market: string,
+	briefingDate: string
+): DailyMorningBriefing | undefined {
+	const row = db.prepare(`
+		SELECT id
+		FROM daily_morning_briefings
+		WHERE market = ?
+			AND briefingDate = ?
+			AND status = 'generating'
+		ORDER BY updatedAt DESC, createdAt DESC
+		LIMIT 1
+	`).get(market, briefingDate) as { id: string } | undefined;
+	return row ? selectDailyMorningBriefing(db, row.id) : undefined;
+}
+
+function mapDailyMorningBriefingRow(row: Omit<DailyMorningBriefing, "watchlistSnapshot"> & { watchlistSnapshot: string }): DailyMorningBriefing {
+	return {
+		id: row.id,
+		market: row.market,
+		briefingDate: row.briefingDate,
+		content: row.content,
+		status: row.status,
+		watchlistSnapshot: JSON.parse(row.watchlistSnapshot || "[]"),
+		createdAt: row.createdAt,
+		updatedAt: row.updatedAt
+	};
+}
+
+function mapDailyMorningBriefingSummary(row: Omit<DailyMorningBriefing, "content" | "watchlistSnapshot">): Omit<DailyMorningBriefing, "content" | "watchlistSnapshot"> {
+	return row;
+}
+
+function getFullWatchlistSnapshot(db: ReturnType<typeof getDB>): unknown[] {
+	const stocks = db.prepare(`
+		SELECT id, userId, stock_code, stock_name, exchange, market, sortOrder, createdAt
+		FROM watchlist
+		WHERE isDeleted = 0
+		ORDER BY userId ASC, sortOrder ASC
+	`).all() as { id: string; userId: string; stock_code: string; stock_name: string; exchange: string; market: string; sortOrder: number; createdAt: string }[];
+
+	return stocks.map(stock => {
+		const industries = db.prepare(`
+			SELECT c.name FROM industry_theme_categories c
+			JOIN watchlist_industry_items i ON c.id = i.categoryId
+			WHERE i.watchlistId = ? ORDER BY i.weight DESC
+		`).all(stock.id) as { name: string }[];
+		const themes = db.prepare(`
+			SELECT c.name FROM industry_theme_categories c
+			JOIN watchlist_theme_items t ON c.id = t.categoryId
+			WHERE t.watchlistId = ? ORDER BY t.weight DESC
+		`).all(stock.id) as { name: string }[];
+
+		return {
+			...stock,
+			industries: industries.map(item => item.name),
+			themes: themes.map(item => item.name)
+		};
+	});
+}
+
+export const dailyMorningBriefingTools: Record<string, RuntimeTool> = {
+	save_daily_morning_briefing: {
+		name: "save_daily_morning_briefing",
+		label: "保存每日盘前早报",
+		description: "保存每日盘前早报的生成进度和最终结果。生成前必须先以 status=generating、content=\"\" 调用；生成成功后以 status=completed 保存完整正文 content；生成失败后以 status=failed 保存完整错误信息。未传 id 时会自动使用当天固定记录，完成或失败时可直接更新当天早报。",
+		parameters: SaveDailyMorningBriefingAgentToolSchema,
+		registerTool: true,
+		async execute(params) {
+			const args = SaveDailyMorningBriefingParamsSchema.parse(params);
+			const db = getDB();
+			const market = DAILY_MORNING_BRIEFING_MARKET;
+			const briefingDate = getLocalDateString();
+			const id = args.id || buildDailyMorningBriefingId(market, briefingDate);
+			if (args.status === "generating") {
+				const generating = selectGeneratingDailyMorningBriefing(db, market, briefingDate);
+				if (generating) {
+					return JSON.stringify({ success: true, skipped: true, reason: "already_generating", data: generating });
+				}
+			}
+
+			const watchlistSnapshot = JSON.stringify(getFullWatchlistSnapshot(db));
+			const content = args.status === "completed" ? ensureChartPlaceholdersInBody(args.content) : args.content.trim();
+
+			const result = db.prepare(`
+				UPDATE daily_morning_briefings
+				SET content = ?,
+					status = ?,
+					watchlistSnapshot = ?,
+					updatedAt = STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')
+				WHERE id = ?
+			`).run(content, args.status, watchlistSnapshot, id);
+			if (result.changes === 0) {
+				db.prepare(`
+					INSERT INTO daily_morning_briefings (id, market, briefingDate, content, status, watchlistSnapshot)
+					VALUES (?, ?, ?, ?, ?, ?)
+				`).run(id, market, briefingDate, content, args.status, watchlistSnapshot);
+			}
+
+			const data = selectDailyMorningBriefing(db, id);
+			return JSON.stringify({ success: true, data });
+		}
+	},
+	query_daily_morning_briefings: {
+		name: "query_daily_morning_briefings",
+		label: "查询每日盘前早报",
+		description: "分页查询每日盘前早报记录列表。支持按市场过滤，返回记录标识、早报日期、状态和时间字段；列表结果不包含 content，详情内容请使用详情查询接口获取。",
+		parameters: QueryDailyMorningBriefingsParamsSchema,
+		registerTool: false,
+		async execute(params) {
+			const args = QueryDailyMorningBriefingsParamsSchema.parse(params ?? {});
+			const db = getDB();
+			const market = normalizeMarket(args.market);
+			const offset = (args.page - 1) * args.pageSize;
+			const total = (db.prepare(`
+				SELECT COUNT(*) AS total
+				FROM daily_morning_briefings
+				WHERE market = ?
+			`).get(market) as { total: number }).total || 0;
+			const rows = db.prepare(`
+				SELECT id, market, briefingDate, status, createdAt, updatedAt
+				FROM daily_morning_briefings
+				WHERE market = ?
+				ORDER BY briefingDate DESC, updatedAt DESC
+				LIMIT ? OFFSET ?
+			`).all(market, args.pageSize, offset) as Omit<DailyMorningBriefing, "content" | "watchlistSnapshot">[];
+
+			return JSON.stringify({
+				success: true,
+				data: rows.map(mapDailyMorningBriefingSummary),
+				pagination: {
+					page: args.page,
+					pageSize: args.pageSize,
+					total,
+					totalPages: Math.ceil(total / args.pageSize)
+				}
+			});
+		}
+	},
+	get_daily_morning_briefing_detail: {
+		name: "get_daily_morning_briefing_detail",
+		label: "查询每日盘前早报详情",
+		description: "根据每日盘前早报 ID 查询完整详情。返回早报正文 content、自选股快照 watchlistSnapshot 以及市场、日期、状态和时间等元数据；status=failed 时 content 为错误信息。",
+		parameters: GetDailyMorningBriefingDetailParamsSchema,
+		registerTool: false,
+		async execute(params) {
+			const args = GetDailyMorningBriefingDetailParamsSchema.parse(params);
+			const db = getDB();
+			const data = selectDailyMorningBriefing(db, args.id);
+			return JSON.stringify({ success: true, data });
+		}
+	}
+};

package/src/features/deepReasoning/schema.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+
+export const BuildDeepReasoningMessageParamsSchema = 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 BuildDeepReasoningMessageParams = z.infer<typeof BuildDeepReasoningMessageParamsSchema>;
+
+export const QueryDeepReasoningHistoryParamsSchema = 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 QueryDeepReasoningHistoryParams = z.infer<typeof QueryDeepReasoningHistoryParamsSchema>;
+
+export const GetDeepReasoningDetailParamsSchema = 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 GetDeepReasoningDetailParams = z.infer<typeof GetDeepReasoningDetailParamsSchema>;

package/src/features/deepReasoning/tools.ts

@@ -0,0 +1,182 @@
+import { getDB } from "../../core/database.js";
+import {
+	BuildDeepReasoningMessageParams,
+	BuildDeepReasoningMessageParamsSchema,
+	GetDeepReasoningDetailParamsSchema,
+	QueryDeepReasoningHistoryParamsSchema
+} from "./schema.js";
+
+interface RuntimeTool {
+	name: string;
+	label?: string;
+	description: string;
+	parameters: unknown;
+	registerTool?: boolean;
+	execute(params: unknown, ctx?: { userId: string }): Promise<string>;
+}
+
+const DEEP_REASONING_SKILL = "hedgehog-news-deep-reasoning";
+
+const BuildDeepReasoningMessageAgentToolSchema = {
+	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: BuildDeepReasoningMessageParams): string {
+	return [
+		"对这条新闻进行深度推演",
+		"",
+		`新闻标题：${args.sourceTitle}`,
+		"",
+		"新闻正文：",
+		args.sourceContent
+	].join("\n");
+}
+
+function buildDeepReasoningMessage(args: BuildDeepReasoningMessageParams): 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_article_deep_reasoning_analysis，参数为 ${buildGeneratingSaveParams()}；如果返回 skipped=true，必须立即停止，不要继续调用 skill 或生成正文。`,
+			"仅允许按上述标准参数调用 save_article_deep_reasoning_analysis；如果无法提供标准参数，或参数包含标准参数以外的字段，不要调用 save_article_deep_reasoning_analysis。",
+			`必须触发并使用 ${DEEP_REASONING_SKILL} skill 生成新闻事件深度推演报告。`,
+			`生成成功后必须调用 save_article_deep_reasoning_analysis，参数为 ${buildFinalSaveParams("completed")}，content 传最终完整深度推演报告正文。`,
+			`生成失败后必须调用 save_article_deep_reasoning_analysis，参数为 ${buildFinalSaveParams("failed")}，content 存放完整错误信息。`
+		].join("\n"),
+		cw_context: JSON.stringify({
+			sourceId: args.newsId,
+			sourceTitle: args.sourceTitle
+		}),
+		cw_content: buildContent(args),
+		cw_output: [
+			`输出结构以 ${DEEP_REASONING_SKILL} skill 的交付模板为准。`
+		].join("\n")
+	});
+}
+
+function selectGeneratingDeepReasoning(userId: string, sourceId: string) {
+	const db = getDB();
+	return db.prepare(`
+		SELECT id, sourceId, sourceTitle, status, content, createdAt, updatedAt
+		FROM news_deep_reasoning_analysis
+		WHERE userId = ? AND sourceId = ? AND status = 'generating'
+		ORDER BY updatedAt DESC, createdAt DESC
+		LIMIT 1
+	`).get(userId, sourceId);
+}
+
+export const deepReasoningTools: Record<string, RuntimeTool> = {
+	query_deep_reasoning_history: {
+		name: "query_deep_reasoning_history",
+		label: "查询深度推演列表",
+		description: "分页查询深度推演记录列表。返回记录标识、来源 ID、标题、状态和时间字段；列表结果不包含 content，详情请使用 get_deep_reasoning_detail 查询。",
+		parameters: QueryDeepReasoningHistoryParamsSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = QueryDeepReasoningHistoryParamsSchema.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_deep_reasoning_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_deep_reasoning_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_deep_reasoning_detail: {
+		name: "get_deep_reasoning_detail",
+		label: "查询深度推演详情",
+		description: "根据记录 ID 或 sourceId 查询深度推演完整详情，包含 content 正文及所有元数据。",
+		parameters: GetDeepReasoningDetailParamsSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = GetDeepReasoningDetailParamsSchema.parse(params);
+			const db = getDB();
+			if (args.sourceId) {
+				const row = db.prepare(`
+					SELECT id, sourceId, sourceTitle, status, content, createdAt, updatedAt
+					FROM news_deep_reasoning_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_deep_reasoning_analysis
+				WHERE id = ?
+				ORDER BY updatedAt DESC, createdAt DESC
+				LIMIT 1
+			`).get(args.id);
+			return JSON.stringify({ success: true, data: row || null });
+		}
+	},
+	build_deep_reasoning_message: {
+		name: "build_deep_reasoning_message",
+		label: "构建深度推演消息",
+		description: "根据新闻 ID、标题和正文构建用于主动 RPC 发起 Agent 新闻深度推演任务的标准消息。该工具只返回提示词消息体，不触发定时任务，也不保存分析结果。",
+		parameters: BuildDeepReasoningMessageAgentToolSchema,
+		registerTool: false,
+		async execute(params, ctx) {
+			const args = BuildDeepReasoningMessageParamsSchema.parse(params);
+			const userId = ctx?.userId || "default";
+			const generating = selectGeneratingDeepReasoning(userId, args.newsId);
+			if (generating) {
+				return JSON.stringify({
+					success: true,
+					skipped: true,
+					reason: "already_generating",
+					data: generating
+				});
+			}
+			const message = buildDeepReasoningMessage(args);
+			return JSON.stringify({
+				success: true,
+				data: {
+					message,
+					payload: JSON.parse(message),
+					sourceId: args.newsId,
+					saveParams: {
+						sourceId: args.newsId,
+						sourceTitle: args.sourceTitle
+					},
+					skill: DEEP_REASONING_SKILL
+				}
+			});
+		}
+	}
+};

package/src/features/index.ts

@@ -3,6 +3,10 @@ import { profileLibraryTools } from "./profileLibrary/tools.js";
 import { noteTools } from "./notes/tools.js";
 import { stockAnalysisTools } from "./stockAnalysis/tools.js";
 import { pluginInfoTools } from "./pluginInfo/tools.js";
+import { dailyMorningBriefingTools } from "./dailyMorningBriefing/tools.js";
+import { stockBasicTools } from "./stockBasic/tools.js";
+import { informationVerificationTools } from "./informationVerification/tools.js";
+import { deepReasoningTools } from "./deepReasoning/tools.js";
 
 export interface RuntimeTool {
     name: string;
@@ -10,7 +14,8 @@ export interface RuntimeTool {
     description: string;
     parameters: unknown;
     registerTool?: boolean;
-    execute(params: unknown, ctx: { userId: string }): Promise<string>;
+    agentToolTarget?: "main";
+    execute(params: unknown, ctx?: { userId: string }): Promise<string>;
 }
 
 export const allFeaturesTools: Record<string, RuntimeTool> = {
@@ -18,5 +23,9 @@ export const allFeaturesTools: Record<string, RuntimeTool> = {
     ...profileLibraryTools,
     ...noteTools,
     ...stockAnalysisTools,
-    ...pluginInfoTools
+    ...pluginInfoTools,
+    ...dailyMorningBriefingTools,
+    ...stockBasicTools,
+    ...informationVerificationTools,
+    ...deepReasoningTools
 };