work-agent 0.1.0

package/lib/db.ts

@@ -0,0 +1,2250 @@
+/**
+ * 数据库层 - 使用 better-sqlite3 (原生 Node.js SQLite 绑定)
+ * 比 sql.js 更稳定，性能更好，不会出现 Segmentation fault
+ */
+
+import Database from 'better-sqlite3';
+import { mkdirSync, existsSync, rmSync } from 'fs';
+import { join } from 'path';
+
+// Initialize skills directories
+import './skills-init';
+
+// 数据库文件路径（存储在项目根目录的 data 文件夹中）
+const DB_DIR = join(process.cwd(), 'data');
+const DB_PATH = join(DB_DIR, 'assistant.db');
+
+// 确保数据目录存在
+if (!existsSync(DB_DIR)) {
+	try {
+		mkdirSync(DB_DIR, { recursive: true });
+	} catch (error) {
+		// 目录可能已创建，忽略错误
+	}
+}
+
+// 使用 globalThis 来存储数据库实例
+declare global {
+	var _assistantDb: Database.Database | null | undefined;
+}
+
+/**
+ * 获取数据库实例（单例模式）
+ */
+export function getDb(): Database.Database {
+	if (!globalThis._assistantDb) {
+		console.log('[db] Opening database at:', DB_PATH);
+		globalThis._assistantDb = new Database(DB_PATH);
+		// 启用 WAL 模式以提高并发性能
+		globalThis._assistantDb.pragma('journal_mode = WAL');
+		// 启用外键约束
+		globalThis._assistantDb.pragma('foreign_keys = ON');
+		// 创建表结构
+		createSchema(globalThis._assistantDb);
+		// 运行迁移
+		runMigrations(globalThis._assistantDb);
+		// 修复旧数据库缺少的列
+		fixUserSkillsTable(globalThis._assistantDb);
+		console.log('[db] Database initialized successfully');
+	}
+	return globalThis._assistantDb;
+}
+
+/**
+ * 创建数据库表结构
+ */
+function createSchema(db: Database.Database): void {
+	db.exec(`
+		-- 工单表
+		CREATE TABLE IF NOT EXISTS tickets (
+			id TEXT PRIMARY KEY,
+			type TEXT NOT NULL,
+			title TEXT NOT NULL,
+			description TEXT,
+			status TEXT NOT NULL,
+			priority TEXT NOT NULL,
+			command TEXT,
+			command_type TEXT,
+			skill_name TEXT,
+			script_content TEXT,
+			script_path TEXT,
+			output TEXT,
+			error TEXT,
+			risk_level TEXT NOT NULL DEFAULT 'medium',
+			affected_resources TEXT,
+			approvals TEXT NOT NULL,
+			created_by TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL,
+			ai_session_id TEXT,
+			ai_generated INTEGER DEFAULT 0
+		);
+
+		-- 审计日志表
+		CREATE TABLE IF NOT EXISTS audit_logs (
+			id TEXT PRIMARY KEY,
+			timestamp TEXT NOT NULL,
+			action TEXT NOT NULL,
+			user_id TEXT NOT NULL,
+			ticket_id TEXT,
+			session_id TEXT,
+			details TEXT,
+			status TEXT NOT NULL
+		);
+
+		-- 文档表
+		CREATE TABLE IF NOT EXISTS documents (
+			id TEXT PRIMARY KEY,
+			title TEXT NOT NULL,
+			content TEXT,
+			category TEXT,
+			tags TEXT,
+			author TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		);
+
+		-- 定时任务表
+		CREATE TABLE IF NOT EXISTS scheduled_tasks (
+			id TEXT PRIMARY KEY,
+			title TEXT NOT NULL,
+			description TEXT,
+			command TEXT NOT NULL,
+			status TEXT NOT NULL,
+			schedule_type TEXT NOT NULL,
+			schedule_expression TEXT NOT NULL,
+			next_run_at TEXT,
+			last_run_at TEXT,
+			created_by TEXT NOT NULL,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		);
+
+		-- 任务执行历史表
+		CREATE TABLE IF NOT EXISTS task_executions (
+			id TEXT PRIMARY KEY,
+			task_id TEXT NOT NULL,
+			status TEXT NOT NULL,
+			started_at TEXT,
+			completed_at TEXT,
+			ticket_id TEXT,
+			error_message TEXT,
+			created_at TEXT NOT NULL
+		);
+
+		-- 索引
+		CREATE INDEX IF NOT EXISTS idx_tickets_status ON tickets(status);
+		CREATE INDEX IF NOT EXISTS idx_audit_logs_ticket_id ON audit_logs(ticket_id);
+		CREATE INDEX IF NOT EXISTS idx_audit_logs_timestamp ON audit_logs(timestamp);
+		CREATE INDEX IF NOT EXISTS idx_documents_category ON documents(category);
+		CREATE INDEX IF NOT EXISTS idx_documents_author ON documents(author);
+		CREATE INDEX IF NOT EXISTS idx_scheduled_tasks_status ON scheduled_tasks(status);
+		CREATE INDEX IF NOT EXISTS idx_scheduled_tasks_next_run_at ON scheduled_tasks(next_run_at);
+		CREATE INDEX IF NOT EXISTS idx_task_executions_task_id ON task_executions(task_id);
+		CREATE INDEX IF NOT EXISTS idx_task_executions_status ON task_executions(status);
+
+		-- 用户表
+		CREATE TABLE IF NOT EXISTS users (
+			id TEXT PRIMARY KEY,
+			username TEXT NOT NULL UNIQUE,
+			role TEXT DEFAULT 'guest',
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL,
+			last_login_at TEXT,
+			settings TEXT
+		);
+
+		-- 内置Skill配置表
+		CREATE TABLE IF NOT EXISTS builtin_skills (
+			id TEXT PRIMARY KEY,
+			skill_name TEXT NOT NULL UNIQUE,
+			enabled INTEGER DEFAULT 1,
+			config TEXT,
+			created_at TEXT NOT NULL
+		);
+
+		-- 用户已安装的Skill表
+		CREATE TABLE IF NOT EXISTS user_skills (
+			id TEXT PRIMARY KEY,
+			user_id TEXT NOT NULL,
+			skill_name TEXT NOT NULL,
+			dir_name TEXT,
+			source TEXT NOT NULL,
+			skill_data TEXT,
+			skill_id TEXT,
+			use_count INTEGER DEFAULT 0,
+			installed_at TEXT NOT NULL,
+			last_used_at TEXT,
+			UNIQUE(user_id, skill_name)
+		);
+
+		-- Skill使用统计表
+		CREATE TABLE IF NOT EXISTS skill_usage (
+			id TEXT PRIMARY KEY,
+			skill_name TEXT NOT NULL,
+			session_id TEXT NOT NULL,
+			user_id TEXT NOT NULL,
+			context TEXT,
+			result TEXT,
+			success INTEGER,
+			called_at TEXT NOT NULL
+		);
+
+		-- 新增索引
+		CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+		CREATE INDEX IF NOT EXISTS idx_user_skills_user_id ON user_skills(user_id);
+		CREATE INDEX IF NOT EXISTS idx_skill_usage_skill_name ON skill_usage(skill_name);
+		CREATE INDEX IF NOT EXISTS idx_skill_usage_session_id ON skill_usage(session_id);
+
+		-- 会话列表表（用于快速查询会话）
+		CREATE TABLE IF NOT EXISTS sessions (
+			session_id TEXT PRIMARY KEY,
+			user_id TEXT,
+			source TEXT,
+			source_user_id TEXT,
+			created_at TEXT NOT NULL,
+			last_accessed_at TEXT NOT NULL,
+			message_count INTEGER DEFAULT 0,
+			recent_summary TEXT
+		);
+
+		CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
+	`);
+
+	// Try to create index on source column - may fail if column doesn't exist yet (old DB)
+	try {
+		db.exec(`CREATE INDEX IF NOT EXISTS idx_sessions_source ON sessions(source)`);
+	} catch (error: any) {
+		if (!error.message.includes('no such column')) {
+			console.warn('[db] Warning creating idx_sessions_source:', error.message);
+		}
+	}
+}
+
+/**
+ * 获取数据库版本
+ */
+function getUserVersion(db: Database.Database): number {
+	const result = db.pragma('user_version', { simple: true });
+	return result as number;
+}
+
+/**
+ * 设置数据库版本
+ */
+function setUserVersion(db: Database.Database, version: number): void {
+	db.pragma(`user_version = ${version}`);
+}
+
+/**
+ * 创建技能市场相关表
+ */
+function createSkillMarketSchema(db: Database.Database): void {
+	db.exec(`
+		-- 技能市场表
+		CREATE TABLE IF NOT EXISTS skill_market (
+			id TEXT PRIMARY KEY,
+			name TEXT NOT NULL UNIQUE,
+			display_name TEXT NOT NULL,
+			description TEXT,
+			version TEXT NOT NULL,
+			author TEXT NOT NULL,
+			author_name TEXT,
+			status TEXT NOT NULL DEFAULT 'pending',
+			is_official INTEGER DEFAULT 0,
+			rating_avg REAL DEFAULT 0,
+			rating_count INTEGER DEFAULT 0,
+			download_count INTEGER DEFAULT 0,
+			file_path TEXT,
+			reviewed_by TEXT,
+			reviewed_at TEXT,
+			review_comment TEXT,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		);
+
+		-- 技能评分表
+		CREATE TABLE IF NOT EXISTS skill_ratings (
+			id TEXT PRIMARY KEY,
+			skill_id TEXT NOT NULL,
+			user_id TEXT NOT NULL,
+			rating INTEGER NOT NULL,
+			comment TEXT,
+			created_at TEXT NOT NULL,
+			UNIQUE(skill_id, user_id),
+			FOREIGN KEY (skill_id) REFERENCES skill_market(id) ON DELETE CASCADE
+		);
+
+		-- 创建索引
+		CREATE INDEX IF NOT EXISTS idx_skill_market_status ON skill_market(status);
+		CREATE INDEX IF NOT EXISTS idx_skill_market_author ON skill_market(author);
+		CREATE INDEX IF NOT EXISTS idx_skill_ratings_skill_id ON skill_ratings(skill_id);
+	`);
+}
+
+/**
+ * 运行数据库迁移（添加新字段到现有表）
+ */
+function runMigrations(db: Database.Database): void {
+	// 版本控制迁移
+	const currentVersion = getUserVersion(db);
+	const targetVersion = 2; // 新版本号
+
+	if (currentVersion < targetVersion) {
+		console.log('[db] Running migration to version', targetVersion);
+		createSkillMarketSchema(db);
+		setUserVersion(db, targetVersion);
+	}
+
+	// 知识库功能 - 添加新字段（向后兼容的 ALTER TABLE 迁移）
+	const migrations = [
+		{ sql: 'ALTER TABLE documents ADD COLUMN type TEXT', name: 'type' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN source_type TEXT', name: 'source_type' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN session_id TEXT', name: 'session_id' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN is_active INTEGER DEFAULT 1', name: 'is_active' },
+		// 市场相关字段
+		{ sql: 'ALTER TABLE documents ADD COLUMN market_status TEXT', name: 'market_status' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN market_downloads INTEGER DEFAULT 0', name: 'market_downloads' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN market_rating REAL DEFAULT 0', name: 'market_rating' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN market_rating_count INTEGER DEFAULT 0', name: 'market_rating_count' },
+		// 用户角色
+		{ sql: "ALTER TABLE users ADD COLUMN role TEXT DEFAULT 'guest'", name: 'role' },
+		// 审计日志会话ID
+		{ sql: 'ALTER TABLE audit_logs ADD COLUMN session_id TEXT', name: 'audit_session_id' },
+		// user_skills 新字段
+		{ sql: 'ALTER TABLE user_skills ADD COLUMN dir_name TEXT', name: 'user_skills_dir_name' },
+		{ sql: 'ALTER TABLE user_skills ADD COLUMN skill_id TEXT', name: 'user_skills_skill_id' },
+		{ sql: "ALTER TABLE user_skills ADD COLUMN source TEXT DEFAULT 'market'", name: 'user_skills_source' },
+		// sessions 表标题字段
+		{ sql: 'ALTER TABLE sessions ADD COLUMN title TEXT', name: 'sessions_title' },
+		// 飞书用户信息
+		{ sql: 'ALTER TABLE users ADD COLUMN feishu_union_id TEXT', name: 'feishu_union_id' },
+		{ sql: 'ALTER TABLE users ADD COLUMN feishu_open_id TEXT', name: 'feishu_open_id' },
+		// 用户显示信息（新字段）
+		{ sql: 'ALTER TABLE users ADD COLUMN display_name TEXT', name: 'display_name' },
+		{ sql: 'ALTER TABLE users ADD COLUMN avatar TEXT', name: 'avatar' },
+		// 会话来源字段
+		{ sql: 'ALTER TABLE sessions ADD COLUMN source TEXT', name: 'sessions_source' },
+		{ sql: 'ALTER TABLE sessions ADD COLUMN source_user_id TEXT', name: 'sessions_source_user_id' },
+		// 文件管理字段
+		{ sql: 'ALTER TABLE documents ADD COLUMN file_metadata TEXT', name: 'file_metadata' },
+		{ sql: 'ALTER TABLE documents ADD COLUMN is_public INTEGER DEFAULT 0', name: 'is_public' },
+	];
+
+	for (const migration of migrations) {
+		try {
+			db.exec(migration.sql);
+			console.log(`[db] Migration: Added ${migration.name}`);
+		} catch (error: any) {
+			// 只忽略 "duplicate column" 错误
+			if (!error.message.includes('duplicate column')) {
+				console.warn(`[db] Migration warning for ${migration.name}:`, error.message);
+			}
+		}
+	}
+
+	// 存量数据迁移：将 dir_name 设为与 skill_name 相同（兼容旧数据）
+	try {
+		const updateStmt = db.prepare('UPDATE user_skills SET dir_name = skill_name WHERE dir_name IS NULL');
+		const result = updateStmt.run();
+		if (result.changes > 0) {
+			console.log(`[db] Migration: Updated ${result.changes} rows to set dir_name = skill_name`);
+		}
+	} catch (error: any) {
+		console.warn('[db] Migration warning for dir_name migration:', error.message);
+	}
+
+	// 迁移旧飞书字段数据到新字段
+	try {
+		const migrateStmt = db.prepare(`
+			UPDATE users 
+			SET display_name = feishu_name, 
+			    avatar = feishu_avatar 
+			WHERE feishu_name IS NOT NULL OR feishu_avatar IS NOT NULL
+		`);
+		const migrateResult = migrateStmt.run();
+		if (migrateResult.changes > 0) {
+			console.log(`[db] Migration: Migrated ${migrateResult.changes} rows of feishu user info`);
+		}
+	} catch (error: any) {
+		console.warn('[db] Migration warning for feishu data migration:', error.message);
+	}
+
+	// 删除旧字段（如果存在）
+	try {
+		db.exec('ALTER TABLE users DROP COLUMN feishu_avatar');
+		console.log('[db] Migration: Dropped column feishu_avatar');
+	} catch (error: any) {
+		if (!error.message.includes('no such column')) {
+			console.warn('[db] Migration warning for dropping feishu_avatar:', error.message);
+		}
+	}
+	try {
+		db.exec('ALTER TABLE users DROP COLUMN feishu_name');
+		console.log('[db] Migration: Dropped column feishu_name');
+	} catch (error: any) {
+		if (!error.message.includes('no such column')) {
+			console.warn('[db] Migration warning for dropping feishu_name:', error.message);
+		}
+	}
+}
+
+// 修复 user_skills 表缺少 source 列的问题（兼容旧数据库）
+function fixUserSkillsTable(db: Database.Database): void {
+	try {
+		// 检查 source 列是否存在
+		const result = db.prepare("PRAGMA table_info(user_skills)").all() as any[];
+		const hasSourceColumn = result.some((col: any) => col.name === 'source');
+		
+		if (!hasSourceColumn) {
+			db.exec("ALTER TABLE user_skills ADD COLUMN source TEXT NOT NULL DEFAULT 'market'");
+			console.log('[db] Fixed: Added source column to user_skills table');
+		}
+	} catch (error: any) {
+		console.warn('[db] Fix warning for user_skills source column:', error.message);
+	}
+}
+
+// ==================== 类型定义 ====================
+
+export type TicketType = 'bash-execute' | 'skill-script';
+
+export type TicketStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'executing' | 'completed' | 'failed' | 'deleted';
+
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+
+export interface Ticket {
+	id: string;
+	type: TicketType;
+	title: string;
+	description: string;
+	status: TicketStatus;
+	priority: RiskLevel;
+
+	// Command info (for bash-execute)
+	command?: string;
+	commandType?: string;
+
+	// Skill info (for skill-script)
+	skillName?: string;
+	scriptContent?: string;
+	scriptPath?: string;
+
+	// Execution result
+	output?: string;
+	error?: string;
+
+	// Risk assessment
+	riskLevel: RiskLevel;
+	affectedResources?: string[];
+
+	approvals: Approval[];
+	createdBy: string;
+	createdAt: Date;
+	updatedAt: Date;
+
+	// AI 相关字段
+	aiSessionId?: string;
+	aiGenerated?: boolean;
+}
+
+export interface Approval {
+	id: string;
+	approver: string;
+	decision: 'approved' | 'rejected' | 'pending';
+	comment?: string;
+	timestamp: Date;
+}
+
+export interface AuditLog {
+	id: string;
+	timestamp: Date;
+	action: string;
+	userId: string;
+	ticketId?: string;
+	sessionId?: string;
+	details?: unknown;
+	status: 'success' | 'failure';
+}
+
+// 知识类型
+export type KnowledgeType =
+	| 'documentation'      // 文档型知识
+	| 'troubleshooting'    // 问题排查
+	| 'best-practice'      // 最佳实践
+	| 'conversation-summary'; // 会话总结
+
+// 知识来源
+export type KnowledgeSourceType =
+	| 'manual'             // 手动创建
+	| 'ai-generated'       // AI生成
+	| 'conversation-summary'; // 会话总结
+
+export interface FileMetadata {
+	size: number;
+	mimeType: string;
+	md5?: string;
+	storageKey: string;
+	storageType: 'local' | 's3' | 'minio';
+	originalName?: string;
+}
+
+export interface Document {
+	id: string;
+	title: string;
+	content: string;
+	category?: string;
+	tags?: string[];
+	author: string;
+	createdAt: Date;
+	updatedAt: Date;
+	// 新增字段 - 知识库功能
+	type?: KnowledgeType | 'file';
+	sourceType?: KnowledgeSourceType;
+	sessionId?: string;
+	isActive?: boolean;
+	// 市场功能
+	marketStatus?: 'published' | 'draft' | 'archived';
+	marketDownloads?: number;
+	marketRating?: number;
+	marketRatingCount?: number;
+	// 文件管理功能
+	fileMetadata?: FileMetadata;
+	isPublic?: boolean;
+}
+
+export interface ScheduledTask {
+	id: string;
+	title: string;
+	description?: string;
+	command: string;  // 要执行的命令
+	status: 'active' | 'paused' | 'disabled';
+	scheduleType: 'cron' | 'interval' | 'once';
+	scheduleExpression: string;
+	nextRunAt?: Date;
+	lastRunAt?: Date;
+	createdBy: string;
+	createdAt: Date;
+	updatedAt: Date;
+}
+
+export interface TaskExecution {
+	id: string;
+	taskId: string;
+	status: 'pending' | 'running' | 'completed' | 'failed';
+	startedAt?: Date;
+	completedAt?: Date;
+	ticketId?: string;
+	errorMessage?: string;
+	createdAt: Date;
+}
+
+// ==================== 新增类型定义 ====================
+
+export interface User {
+	id: string;
+	username: string;
+	role: 'admin' | 'guest';
+	createdAt: Date;
+	updatedAt: Date;
+	lastLoginAt?: Date;
+	settings?: Record<string, unknown>;
+	feishuUnionId?: string;
+	feishuOpenId?: string;
+	displayName?: string;
+	avatar?: string;
+}
+
+export interface BuiltinSkill {
+	id: string;
+	skillName: string;
+	enabled: boolean;
+	config?: Record<string, unknown>;
+	createdAt: Date;
+}
+
+export interface UserSkill {
+	id: string;
+	userId: string;
+	skillName: string;
+	source: 'market' | 'builtin' | 'personal';
+	skillData?: Record<string, unknown>;
+	useCount: number;
+	installedAt: Date;
+	lastUsedAt?: Date;
+}
+
+export interface SkillUsage {
+	id: string;
+	skillName: string;
+	sessionId: string;
+	userId: string;
+	context?: string;
+	result?: string;
+	success?: boolean;
+	calledAt: Date;
+}
+
+// ==================== 工单操作 ====================
+
+export function createTicket(ticket: Omit<Ticket, 'id' | 'createdAt' | 'updatedAt'>): Ticket {
+	const db = getDb();
+	const id = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	const now = new Date();
+	const newTicket: Ticket = {
+		...ticket,
+		id,
+		createdAt: now,
+		updatedAt: now,
+	};
+
+	const stmt = db.prepare(`
+		INSERT INTO tickets (
+			id, type, title, description, status, priority, command,
+			command_type, skill_name, script_content, script_path, output, error,
+			risk_level, affected_resources, approvals, created_by, created_at, updated_at,
+			ai_session_id, ai_generated
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	stmt.run(
+		newTicket.id,
+		newTicket.type,
+		newTicket.title,
+		newTicket.description,
+		newTicket.status,
+		newTicket.priority,
+		newTicket.command ?? null,
+		newTicket.commandType ?? null,
+		newTicket.skillName ?? null,
+		newTicket.scriptContent ?? null,
+		newTicket.scriptPath ?? null,
+		newTicket.output ?? null,
+		newTicket.error ?? null,
+		newTicket.riskLevel,
+		newTicket.affectedResources ? JSON.stringify(newTicket.affectedResources) : null,
+		JSON.stringify(newTicket.approvals),
+		newTicket.createdBy,
+		now.toISOString(),
+		now.toISOString(),
+		newTicket.aiSessionId ?? null,
+		newTicket.aiGenerated ? 1 : 0,
+	);
+
+	return newTicket;
+}
+
+export function getTicket(id: string): Ticket | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM tickets WHERE id = ?');
+	const row = stmt.get(id) as any;
+
+	if (!row) return null;
+
+	return parseTicketRow(row);
+}
+
+export function getTickets(filters?: {
+	status?: string;
+	type?: string;
+	createdBy?: string;
+	aiSessionId?: string;
+	limit?: number;
+}): Ticket[] {
+	const db = getDb();
+
+	let query = 'SELECT * FROM tickets WHERE 1=1';
+	const params: any[] = [];
+
+	if (filters?.status) {
+		query += ' AND status = ?';
+		params.push(filters.status);
+	}
+
+	if (filters?.type) {
+		query += ' AND type = ?';
+		params.push(filters.type);
+	}
+
+	if (filters?.createdBy) {
+		query += ' AND created_by = ?';
+		params.push(filters.createdBy);
+	}
+
+	if (filters?.aiSessionId) {
+		query += ' AND ai_session_id = ?';
+		params.push(filters.aiSessionId);
+	}
+
+	query += ' ORDER BY created_at DESC';
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+
+	return rows.map(row => parseTicketRow(row));
+}
+
+export function updateTicket(id: string, updates: Partial<Omit<Ticket, 'id' | 'createdAt' | 'createdBy'>>): Ticket | null {
+	const db = getDb();
+	const current = getTicket(id);
+	if (!current) return null;
+
+	const updated = {
+		...current,
+		...updates,
+		updatedAt: new Date(),
+	};
+
+	const stmt = db.prepare(`
+		UPDATE tickets SET
+			type = ?, title = ?, description = ?, status = ?, priority = ?,
+			command = ?, command_type = ?, skill_name = ?,
+			script_content = ?, script_path = ?, output = ?, error = ?,
+			risk_level = ?, affected_resources = ?,
+			approvals = ?, updated_at = ?, ai_session_id = ?, ai_generated = ?
+		WHERE id = ?
+	`);
+
+	stmt.run(
+		updated.type,
+		updated.title,
+		updated.description,
+		updated.status,
+		updated.priority,
+		updated.command ?? null,
+		updated.commandType ?? null,
+		updated.skillName ?? null,
+		updated.scriptContent ?? null,
+		updated.scriptPath ?? null,
+		updated.output ?? null,
+		updated.error ?? null,
+		updated.riskLevel,
+		updated.affectedResources ? JSON.stringify(updated.affectedResources) : null,
+		JSON.stringify(updated.approvals),
+		updated.updatedAt.toISOString(),
+		updated.aiSessionId ?? null,
+		updated.aiGenerated ? 1 : 0,
+		id,
+	);
+
+	return updated;
+}
+
+export function deleteTicket(id: string): boolean {
+	const db = getDb();
+	const current = getTicket(id);
+	if (!current) return false;
+
+	const stmt = db.prepare('DELETE FROM tickets WHERE id = ?');
+	stmt.run(id);
+
+	return true;
+}
+
+export function addApproval(ticketId: string, approval: Omit<Approval, 'id' | 'timestamp'>): Approval | null {
+	const ticket = getTicket(ticketId);
+	if (!ticket) return null;
+
+	const newApproval: Approval = {
+		...approval,
+		id: `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`,
+		timestamp: new Date(),
+	};
+
+	const approvals = [...ticket.approvals, newApproval];
+	updateTicket(ticketId, { approvals });
+
+	return newApproval;
+}
+
+// ==================== 审计日志操作 ====================
+
+export function createAuditLog(log: Omit<AuditLog, 'id' | 'timestamp'>): AuditLog {
+	const db = getDb();
+	const id = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	const now = new Date();
+	const newLog: AuditLog = {
+		...log,
+		id,
+		timestamp: now,
+	};
+
+	const stmt = db.prepare(`
+		INSERT INTO audit_logs (id, timestamp, action, user_id, ticket_id, session_id, details, status)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	stmt.run(
+		newLog.id,
+		now.toISOString(),
+		newLog.action,
+		newLog.userId,
+		newLog.ticketId ?? null,
+		newLog.sessionId ?? null,
+		newLog.details ? JSON.stringify(newLog.details) : null,
+		newLog.status,
+	);
+
+	return newLog;
+}
+
+export function getAuditLogs(filters?: {
+	userId?: string;
+	ticketId?: string;
+	sessionId?: string;
+	limit?: number;
+}): AuditLog[] {
+	const db = getDb();
+
+	let query = 'SELECT * FROM audit_logs WHERE 1=1';
+	const params: any[] = [];
+
+	if (filters?.userId) {
+		query += ' AND user_id = ?';
+		params.push(filters.userId);
+	}
+
+	if (filters?.ticketId) {
+		query += ' AND ticket_id = ?';
+		params.push(filters.ticketId);
+	}
+
+	if (filters?.sessionId) {
+		query += ' AND session_id = ?';
+		params.push(filters.sessionId);
+	}
+
+	query += ' ORDER BY timestamp DESC';
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+
+	return rows.map(row => ({
+		id: row.id,
+		timestamp: new Date(row.timestamp),
+		action: row.action,
+		userId: row.user_id,
+		ticketId: row.ticket_id ?? undefined,
+		sessionId: row.session_id ?? undefined,
+		details: row.details ? JSON.parse(row.details) : undefined,
+		status: row.status as 'success' | 'failure',
+	}));
+}
+
+// ==================== 工具函数 ====================
+
+// Safe JSON parse helper
+function safeJsonParse<T>(value: unknown, fallback: T): T {
+	if (value === null || value === undefined) return fallback;
+	if (typeof value === 'string') {
+		try {
+			return JSON.parse(value);
+		} catch {
+			return fallback;
+		}
+	}
+	return value as T;
+}
+
+function parseTicketRow(row: any): Ticket {
+	return {
+		id: row.id,
+		type: row.type as TicketType,
+		title: row.title,
+		description: safeJsonParse<string>(row.description, ''),
+		status: row.status as TicketStatus,
+		priority: row.priority as RiskLevel,
+		command: row.command ?? undefined,
+		commandType: row.command_type ?? undefined,
+		skillName: row.skill_name ?? undefined,
+		scriptContent: row.script_content ?? undefined,
+		scriptPath: row.script_path ?? undefined,
+		output: row.output ?? undefined,
+		error: row.error ?? undefined,
+		riskLevel: row.risk_level as RiskLevel,
+		affectedResources: safeJsonParse<string[] | undefined>(row.affected_resources, undefined),
+		approvals: safeJsonParse<Approval[]>(row.approvals, []),
+		createdBy: row.created_by,
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+		aiSessionId: row.ai_session_id ?? undefined,
+		aiGenerated: row.ai_generated === 1,
+	};
+}
+
+// ==================== 文档操作 ====================
+
+export function createDocument(document: Omit<Document, 'id' | 'createdAt' | 'updatedAt'>): Document {
+	const db = getDb();
+	const id = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	const now = new Date();
+	const newDocument: Document = {
+		...document,
+		id,
+		createdAt: now,
+		updatedAt: now,
+	};
+
+	const stmt = db.prepare(`
+		INSERT INTO documents (id, title, content, category, tags, author, created_at, updated_at, type, source_type, session_id, is_active, file_metadata, is_public)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	stmt.run(
+		newDocument.id,
+		newDocument.title,
+		newDocument.content,
+		newDocument.category ?? null,
+		newDocument.tags ? JSON.stringify(newDocument.tags) : null,
+		newDocument.author,
+		now.toISOString(),
+		now.toISOString(),
+		newDocument.type ?? null,
+		newDocument.sourceType ?? null,
+		newDocument.sessionId ?? null,
+		newDocument.isActive !== false ? 1 : 0,
+		newDocument.fileMetadata ? JSON.stringify(newDocument.fileMetadata) : null,
+		newDocument.isPublic ? 1 : 0,
+	);
+
+	return newDocument;
+}
+
+export function getDocument(id: string): Document | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM documents WHERE id = ?');
+	const row = stmt.get(id) as any;
+
+	if (!row) return null;
+
+	return parseDocumentRowWithKnowledge(row);
+}
+
+export function getDocuments(filters?: {
+	category?: string;
+	author?: string;
+	limit?: number;
+	offset?: number;
+	isActive?: boolean;
+	type?: string;
+	search?: string;
+}): Document[] | { documents: Document[]; total: number } {
+	const db = getDb();
+
+	let whereClause = 'WHERE 1=1';
+	const params: any[] = [];
+
+	if (filters?.category) {
+		whereClause += ' AND category = ?';
+		params.push(filters.category);
+	}
+
+	if (filters?.author) {
+		whereClause += ' AND author = ?';
+		params.push(filters.author);
+	}
+
+	if (filters?.isActive !== undefined) {
+		whereClause += ' AND is_active = ?';
+		params.push(filters.isActive ? 1 : 0);
+	}
+
+	if (filters?.type) {
+		whereClause += ' AND type = ?';
+		params.push(filters.type);
+	}
+
+	if (filters?.search) {
+		whereClause += ' AND (title LIKE ? OR content LIKE ?)';
+		const searchTerm = `%${filters.search}%`;
+		params.push(searchTerm, searchTerm);
+	}
+
+	// 如果请求了分页参数，返回分页结果
+	if (filters?.offset !== undefined || filters?.search) {
+		// 获取总数
+		const countStmt = db.prepare(`SELECT COUNT(*) as count FROM documents ${whereClause}`);
+		const countResult = countStmt.get(...params) as { count: number };
+		const total = countResult.count;
+
+		// 获取分页数据
+		let query = `SELECT * FROM documents ${whereClause} ORDER BY updated_at DESC`;
+
+		if (filters?.limit) {
+			query += ' LIMIT ?';
+			params.push(filters.limit);
+		}
+
+		if (filters?.offset) {
+			query += ' OFFSET ?';
+			params.push(filters.offset);
+		}
+
+		const stmt = db.prepare(query);
+		const rows = stmt.all(...params) as any[];
+
+		return {
+			documents: rows.map(row => parseDocumentRowWithKnowledge(row)),
+			total,
+		};
+	}
+
+	// 原有逻辑，返回数组
+	let query = `SELECT * FROM documents ${whereClause} ORDER BY updated_at DESC`;
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+
+	return rows.map(row => parseDocumentRowWithKnowledge(row));
+}
+
+export function updateDocument(id: string, updates: Partial<Omit<Document, 'id' | 'createdAt' | 'author'>>): Document | null {
+	const db = getDb();
+	const current = getDocument(id);
+	if (!current) return null;
+
+	const updated = {
+		...current,
+		...updates,
+		updatedAt: new Date(),
+	};
+
+	const stmt = db.prepare(`
+		UPDATE documents SET
+			title = ?, content = ?, category = ?, tags = ?, updated_at = ?,
+			type = ?, source_type = ?, session_id = ?, is_active = ?,
+			market_status = ?, market_downloads = ?, market_rating = ?, market_rating_count = ?,
+			file_metadata = ?, is_public = ?
+		WHERE id = ?
+	`);
+
+	stmt.run(
+		updated.title,
+		updated.content,
+		updated.category ?? null,
+		updated.tags ? JSON.stringify(updated.tags) : null,
+		updated.updatedAt.toISOString(),
+		updated.type ?? null,
+		updated.sourceType ?? null,
+		updated.sessionId ?? null,
+		updated.isActive !== false ? 1 : 0,
+		updated.marketStatus ?? null,
+		updated.marketDownloads ?? 0,
+		updated.marketRating ?? 0,
+		updated.marketRatingCount ?? 0,
+		updated.fileMetadata ? JSON.stringify(updated.fileMetadata) : null,
+		updated.isPublic ? 1 : 0,
+		id,
+	);
+
+	return updated;
+}
+
+export function deleteDocument(id: string): boolean {
+	const db = getDb();
+	const current = getDocument(id);
+	if (!current) return false;
+
+	const stmt = db.prepare('DELETE FROM documents WHERE id = ?');
+	stmt.run(id);
+
+	return true;
+}
+
+// ==================== 知识库操作 ====================
+
+/**
+ * 获取所有激活的知识条目（用于注入AI会话）
+ */
+export function getActiveKnowledge(): Document[] {
+	const db = getDb();
+
+	try {
+		const stmt = db.prepare(`
+			SELECT * FROM documents
+			WHERE is_active = 1 OR is_active IS NULL
+			ORDER BY updated_at DESC
+		`);
+		const rows = stmt.all() as any[];
+
+		return rows.map(row => parseDocumentRowWithKnowledge(row));
+	} catch {
+		// 如果字段不存在，返回所有文档（兼容旧数据库）
+		return getDocuments({}) as Document[];
+	}
+}
+
+/**
+ * 根据关键词搜索知识条目
+ */
+export function searchKnowledge(keywords: string, limit: number = 5): Document[] {
+	const db = getDb();
+	
+	if (!keywords.trim()) {
+		return [];
+	}
+
+	const searchPattern = `%${keywords}%`;
+	
+	try {
+		const stmt = db.prepare(`
+			SELECT * FROM documents
+			WHERE (title LIKE ? OR content LIKE ?)
+			  AND (is_active = 1 OR is_active IS NULL)
+			ORDER BY updated_at DESC
+			LIMIT ?
+		`);
+		const rows = stmt.all(searchPattern, searchPattern, limit) as any[];
+
+		return rows.map(row => parseDocumentRowWithKnowledge(row));
+	} catch {
+		// 如果字段不存在，返回空数组
+		return [];
+	}
+}
+
+/**
+ * 从会话创建知识条目
+ */
+export function createKnowledgeFromSession(
+	sessionId: string,
+	summary: string,
+	title?: string
+): Document {
+	const knowledgeTitle = title || `会话总结 - ${new Date().toLocaleDateString('zh-CN')}`;
+
+	return createDocument({
+		title: knowledgeTitle,
+		content: summary,
+		category: '会话总结',
+		author: 'ai-assistant',
+		type: 'conversation-summary',
+		sourceType: 'conversation-summary',
+		sessionId,
+		isActive: true,
+	});
+}
+
+/**
+ * 更新知识条目的激活状态
+ */
+export function updateKnowledgeActive(id: string, isActive: boolean): Document | null {
+	const db = getDb();
+	const current = getDocument(id);
+	if (!current) return null;
+
+	const stmt = db.prepare('UPDATE documents SET is_active = ?, updated_at = ? WHERE id = ?');
+	stmt.run(isActive ? 1 : 0, new Date().toISOString(), id);
+
+	return { ...current, isActive, updatedAt: new Date() };
+}
+
+/**
+ * 解析包含知识库字段的文档行
+ */
+function parseDocumentRowWithKnowledge(row: any): Document {
+	return {
+		id: row.id,
+		title: row.title,
+		content: row.content ?? '',
+		category: row.category ?? undefined,
+		tags: row.tags ? JSON.parse(row.tags) : undefined,
+		author: row.author,
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+		// 新字段 - 可能不存在（兼容旧数据）
+		type: row.type as KnowledgeType | undefined,
+		sourceType: row.source_type as KnowledgeSourceType | undefined,
+		sessionId: row.session_id ?? undefined,
+		isActive: row.is_active === 1 || row.is_active === undefined,
+		// 市场字段
+		marketStatus: row.market_status ?? undefined,
+		marketDownloads: row.market_downloads ?? 0,
+		marketRating: row.market_rating ?? 0,
+		marketRatingCount: row.market_rating_count ?? 0,
+		// 文件管理字段
+		fileMetadata: row.file_metadata ? safeJsonParse<FileMetadata | undefined>(row.file_metadata, undefined) : undefined,
+		isPublic: row.is_public === 1,
+	};
+}
+
+// ==================== 定时任务操作 ====================
+
+export function createScheduledTask(task: Omit<ScheduledTask, 'id' | 'createdAt' | 'updatedAt'>): ScheduledTask {
+	const db = getDb();
+	const id = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	const now = new Date();
+	const newTask: ScheduledTask = {
+		...task,
+		id,
+		createdAt: now,
+		updatedAt: now,
+	};
+
+	const stmt = db.prepare(`
+		INSERT INTO scheduled_tasks (
+			id, title, description, command, status, schedule_type, schedule_expression,
+			next_run_at, last_run_at, created_by, created_at, updated_at
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	stmt.run(
+		newTask.id,
+		newTask.title,
+		newTask.description ?? null,
+		newTask.command,
+		newTask.status,
+		newTask.scheduleType,
+		newTask.scheduleExpression,
+		newTask.nextRunAt?.toISOString() ?? null,
+		newTask.lastRunAt?.toISOString() ?? null,
+		newTask.createdBy,
+		now.toISOString(),
+		now.toISOString(),
+	);
+
+	return newTask;
+}
+
+export function getScheduledTask(id: string): ScheduledTask | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM scheduled_tasks WHERE id = ?');
+	const row = stmt.get(id) as any;
+
+	if (!row) return null;
+
+	return parseScheduledTaskRow(row);
+}
+
+export function getScheduledTasks(filters?: {
+	status?: string;
+	type?: string;
+	createdBy?: string;
+	limit?: number;
+}): ScheduledTask[] {
+	const db = getDb();
+
+	let query = 'SELECT * FROM scheduled_tasks WHERE 1=1';
+	const params: any[] = [];
+
+	if (filters?.status) {
+		query += ' AND status = ?';
+		params.push(filters.status);
+	}
+
+	if (filters?.type) {
+		query += ' AND type = ?';
+		params.push(filters.type);
+	}
+
+	if (filters?.createdBy) {
+		query += ' AND created_by = ?';
+		params.push(filters.createdBy);
+	}
+
+	query += ' ORDER BY created_at DESC';
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+
+	return rows.map(row => parseScheduledTaskRow(row));
+}
+
+export function updateScheduledTask(id: string, updates: Partial<Omit<ScheduledTask, 'id' | 'createdAt' | 'createdBy'>>): ScheduledTask | null {
+	const db = getDb();
+	const current = getScheduledTask(id);
+	if (!current) return null;
+
+	const updated = {
+		...current,
+		...updates,
+		updatedAt: new Date(),
+	};
+
+	const stmt = db.prepare(`
+		UPDATE scheduled_tasks SET
+			title = ?, description = ?, command = ?, status = ?, schedule_type = ?,
+			schedule_expression = ?, next_run_at = ?, last_run_at = ?, updated_at = ?
+		WHERE id = ?
+	`);
+
+	stmt.run(
+		updated.title,
+		updated.description ?? null,
+		updated.command,
+		updated.status,
+		updated.scheduleType,
+		updated.scheduleExpression,
+		updated.nextRunAt?.toISOString() ?? null,
+		updated.lastRunAt?.toISOString() ?? null,
+		updated.updatedAt.toISOString(),
+		id,
+	);
+
+	return updated;
+}
+
+export function deleteScheduledTask(id: string): boolean {
+	const db = getDb();
+	const current = getScheduledTask(id);
+	if (!current) return false;
+
+	const stmt = db.prepare('DELETE FROM scheduled_tasks WHERE id = ?');
+	stmt.run(id);
+
+	return true;
+}
+
+export function getScheduledTasksDueForExecution(): ScheduledTask[] {
+	const db = getDb();
+	const now = new Date().toISOString();
+
+	const stmt = db.prepare(`
+		SELECT * FROM scheduled_tasks
+		WHERE status = 'active'
+		AND next_run_at IS NOT NULL
+		AND next_run_at <= ?
+		ORDER BY next_run_at ASC
+	`);
+
+	const rows = stmt.all(now) as any[];
+
+	return rows.map(row => parseScheduledTaskRow(row));
+}
+
+function parseScheduledTaskRow(row: any): ScheduledTask {
+	return {
+		id: row.id,
+		title: row.title,
+		description: row.description ?? undefined,
+		command: row.command,
+		status: row.status as ScheduledTask['status'],
+		scheduleType: row.schedule_type as ScheduledTask['scheduleType'],
+		scheduleExpression: row.schedule_expression,
+		nextRunAt: row.next_run_at ? new Date(row.next_run_at) : undefined,
+		lastRunAt: row.last_run_at ? new Date(row.last_run_at) : undefined,
+		createdBy: row.created_by,
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+	};
+}
+
+// ==================== 任务执行历史操作 ====================
+
+export function createTaskExecution(execution: Omit<TaskExecution, 'id' | 'createdAt'>): TaskExecution {
+	const db = getDb();
+	const id = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	const now = new Date();
+	const newExecution: TaskExecution = {
+		...execution,
+		id,
+		createdAt: now,
+	};
+
+	const stmt = db.prepare(`
+		INSERT INTO task_executions (
+			id, task_id, status, started_at, completed_at, ticket_id, error_message, created_at
+		) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+
+	stmt.run(
+		newExecution.id,
+		newExecution.taskId,
+		newExecution.status,
+		newExecution.startedAt?.toISOString() ?? null,
+		newExecution.completedAt?.toISOString() ?? null,
+		newExecution.ticketId ?? null,
+		newExecution.errorMessage ?? null,
+		now.toISOString(),
+	);
+
+	return newExecution;
+}
+
+export function getTaskExecution(id: string): TaskExecution | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM task_executions WHERE id = ?');
+	const row = stmt.get(id) as any;
+
+	if (!row) return null;
+
+	return parseTaskExecutionRow(row);
+}
+
+export function getTaskExecutions(filters?: {
+	taskId?: string;
+	status?: string;
+	limit?: number;
+}): TaskExecution[] {
+	const db = getDb();
+
+	let query = 'SELECT * FROM task_executions WHERE 1=1';
+	const params: any[] = [];
+
+	if (filters?.taskId) {
+		query += ' AND task_id = ?';
+		params.push(filters.taskId);
+	}
+
+	if (filters?.status) {
+		query += ' AND status = ?';
+		params.push(filters.status);
+	}
+
+	query += ' ORDER BY created_at DESC';
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+
+	return rows.map(row => parseTaskExecutionRow(row));
+}
+
+export function updateTaskExecution(id: string, updates: Partial<Omit<TaskExecution, 'id' | 'taskId' | 'createdAt'>>): TaskExecution | null {
+	const db = getDb();
+	const current = getTaskExecution(id);
+	if (!current) return null;
+
+	const updated = {
+		...current,
+		...updates,
+	};
+
+	const stmt = db.prepare(`
+		UPDATE task_executions SET
+			status = ?, started_at = ?, completed_at = ?, ticket_id = ?, error_message = ?
+		WHERE id = ?
+	`);
+
+	stmt.run(
+		updated.status,
+		updated.startedAt?.toISOString() ?? null,
+		updated.completedAt?.toISOString() ?? null,
+		updated.ticketId ?? null,
+		updated.errorMessage ?? null,
+		id,
+	);
+
+	return updated;
+}
+
+function parseTaskExecutionRow(row: any): TaskExecution {
+	return {
+		id: row.id,
+		taskId: row.task_id,
+		status: row.status as TaskExecution['status'],
+		startedAt: row.started_at ? new Date(row.started_at) : undefined,
+		completedAt: row.completed_at ? new Date(row.completed_at) : undefined,
+		ticketId: row.ticket_id ?? undefined,
+		errorMessage: row.error_message ?? undefined,
+		createdAt: new Date(row.created_at),
+	};
+}
+
+// ==================== 用户相关函数 ====================
+
+export function createUser(username: string, role: 'admin' | 'guest' = 'guest'): User {
+	const db = getDb();
+	const id = `user-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+	const now = new Date().toISOString();
+
+	const stmt = db.prepare(`
+		INSERT INTO users (id, username, role, created_at, updated_at, last_login_at)
+		VALUES (?, ?, ?, ?, ?, ?)
+	`);
+	stmt.run(id, username, role, now, now, now);
+
+	return {
+		id,
+		username,
+		role,
+		createdAt: new Date(now),
+		updatedAt: new Date(now),
+		lastLoginAt: new Date(now),
+	};
+}
+
+export function getUserByUsername(username: string): User | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM users WHERE username = ?');
+	const row = stmt.get(username) as any;
+	if (!row) return null;
+	return {
+		id: row.id,
+		username: row.username,
+		role: (row.role || 'guest') as 'admin' | 'guest',
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+		lastLoginAt: row.last_login_at ? new Date(row.last_login_at) : undefined,
+		settings: row.settings ? JSON.parse(row.settings) : undefined,
+		feishuUnionId: row.feishu_union_id || undefined,
+		feishuOpenId: row.feishu_open_id || undefined,
+		displayName: row.display_name || undefined,
+		avatar: row.avatar || undefined,
+	};
+}
+
+export function getUserById(id: string): User | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM users WHERE id = ?');
+	const row = stmt.get(id) as any;
+	if (!row) return null;
+	return {
+		id: row.id,
+		username: row.username,
+		role: (row.role || 'guest') as 'admin' | 'guest',
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+		lastLoginAt: row.last_login_at ? new Date(row.last_login_at) : undefined,
+		settings: row.settings ? JSON.parse(row.settings) : undefined,
+		feishuUnionId: row.feishu_union_id || undefined,
+		feishuOpenId: row.feishu_open_id || undefined,
+		displayName: row.display_name || undefined,
+		avatar: row.avatar || undefined,
+	};
+}
+
+export function updateUserLogin(id: string): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const stmt = db.prepare('UPDATE users SET last_login_at = ?, updated_at = ? WHERE id = ?');
+	stmt.run(now, now, id);
+}
+
+export function updateUserRole(id: string, role: 'admin' | 'guest'): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const stmt = db.prepare('UPDATE users SET role = ?, updated_at = ? WHERE id = ?');
+	stmt.run(role, now, id);
+}
+
+export function getUserByFeishuUnionId(unionId: string): User | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM users WHERE feishu_union_id = ?');
+	const row = stmt.get(unionId) as any;
+	if (!row) return null;
+	return {
+		id: row.id,
+		username: row.username,
+		role: (row.role || 'guest') as 'admin' | 'guest',
+		createdAt: new Date(row.created_at),
+		updatedAt: new Date(row.updated_at),
+		lastLoginAt: row.last_login_at ? new Date(row.last_login_at) : undefined,
+		settings: row.settings ? JSON.parse(row.settings) : undefined,
+		feishuUnionId: row.feishu_union_id || undefined,
+		feishuOpenId: row.feishu_open_id || undefined,
+		displayName: row.display_name || undefined,
+		avatar: row.avatar || undefined,
+	};
+}
+
+export function updateUserFeishuInfo(
+	id: string,
+	feishuInfo: { unionId?: string; openId?: string; avatar?: string; displayName?: string }
+): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const updates: string[] = ['updated_at = ?'];
+	const params: any[] = [now];
+
+	if (feishuInfo.unionId !== undefined) {
+		updates.push('feishu_union_id = ?');
+		params.push(feishuInfo.unionId);
+	}
+	if (feishuInfo.openId !== undefined) {
+		updates.push('feishu_open_id = ?');
+		params.push(feishuInfo.openId);
+	}
+	if (feishuInfo.avatar !== undefined) {
+		updates.push('avatar = ?');
+		params.push(feishuInfo.avatar);
+	}
+	if (feishuInfo.displayName !== undefined) {
+		updates.push('display_name = ?');
+		params.push(feishuInfo.displayName);
+	}
+
+	params.push(id);
+	const stmt = db.prepare(`UPDATE users SET ${updates.join(', ')} WHERE id = ?`);
+	stmt.run(...params);
+}
+
+// ==================== 内置Skill相关函数 ====================
+
+export function getBuiltinSkills(): BuiltinSkill[] {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM builtin_skills ORDER BY skill_name');
+	const rows = stmt.all() as any[];
+	return rows.map(row => ({
+		id: row.id,
+		skillName: row.skill_name,
+		enabled: !!row.enabled,
+		config: row.config ? JSON.parse(row.config) : undefined,
+		createdAt: new Date(row.created_at),
+	}));
+}
+
+export function setBuiltinSkill(skillName: string, enabled: boolean, config?: Record<string, unknown>): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const id = `builtin-${skillName}`;
+
+	const stmt = db.prepare(`
+		INSERT INTO builtin_skills (id, skill_name, enabled, config, created_at)
+		VALUES (?, ?, ?, ?, ?)
+		ON CONFLICT(id) DO UPDATE SET enabled = ?, config = ?
+	`);
+	stmt.run(id, skillName, enabled ? 1 : 0, config ? JSON.stringify(config) : null, now, enabled ? 1 : 0, config ? JSON.stringify(config) : null);
+}
+
+// ==================== 用户Skill相关函数 ====================
+
+export function getUserSkills(userId: string): UserSkill[] {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM user_skills WHERE user_id = ? ORDER BY use_count DESC');
+	const rows = stmt.all(userId) as any[];
+	return rows.map(row => ({
+		id: row.id,
+		userId: row.user_id,
+		skillName: row.skill_name,
+		source: row.source as UserSkill['source'],
+		skillData: row.skill_data ? JSON.parse(row.skill_data) : undefined,
+		useCount: row.use_count,
+		installedAt: new Date(row.installed_at),
+		lastUsedAt: row.last_used_at ? new Date(row.last_used_at) : undefined,
+	}));
+}
+
+export function installUserSkill(userId: string, skillName: string, source: UserSkill['source'], skillData?: Record<string, unknown>): UserSkill {
+	const db = getDb();
+	const id = `us-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+	const now = new Date().toISOString();
+
+	const existing = db.prepare('SELECT id FROM user_skills WHERE user_id = ? AND skill_name = ?').get(userId, skillName) as { id: string } | undefined;
+	
+	if (existing) {
+		db.prepare(`
+			UPDATE user_skills SET source = ?, skill_data = ? WHERE user_id = ? AND skill_name = ?
+		`).run(source, skillData ? JSON.stringify(skillData) : null, userId, skillName);
+		return {
+			id: existing.id as string,
+			userId,
+			skillName,
+			source,
+			skillData,
+			useCount: 0,
+			installedAt: new Date(now),
+		};
+	}
+
+	const stmt = db.prepare(`
+		INSERT INTO user_skills (id, user_id, skill_name, source, skill_data, use_count, installed_at)
+		VALUES (?, ?, ?, ?, ?, 0, ?)
+	`);
+	stmt.run(id, userId, skillName, source, skillData ? JSON.stringify(skillData) : null, now);
+
+	return {
+		id,
+		userId,
+		skillName,
+		source,
+		skillData,
+		useCount: 0,
+		installedAt: new Date(now),
+	};
+}
+
+export function uninstallUserSkill(userId: string, skillName: string): void {
+	const db = getDb();
+	
+	const row = db.prepare(
+		'SELECT dir_name FROM user_skills WHERE user_id = ? AND skill_name = ?'
+	).get(userId, skillName) as { dir_name: string } | undefined;
+	
+	const dirName = row?.dir_name || skillName;
+	const skillDir = join(process.cwd(), 'data', 'skills', 'users', userId, dirName);
+	
+	if (existsSync(skillDir)) {
+		try {
+			rmSync(skillDir, { recursive: true });
+		} catch (error) {
+			console.error(`Failed to delete skill directory ${skillDir}:`, error);
+		}
+	}
+	
+	const stmt = db.prepare('DELETE FROM user_skills WHERE user_id = ? AND skill_name = ?');
+	stmt.run(userId, skillName);
+}
+
+export function incrementUserSkillUseCount(userId: string, skillName: string): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const stmt = db.prepare(`
+		UPDATE user_skills SET use_count = use_count + 1, last_used_at = ?
+		WHERE user_id = ? AND skill_name = ?
+	`);
+	stmt.run(now, userId, skillName);
+}
+
+// ==================== Skill目录名映射函数 ====================
+
+export function findDirNameBySkillName(userId: string, skillName: string): string | null {
+	const db = getDb();
+	const row = db.prepare(
+		'SELECT dir_name FROM user_skills WHERE user_id = ? AND skill_name = ?'
+	).get(userId, skillName) as { dir_name: string } | undefined;
+	return row?.dir_name || null;
+}
+
+export function findSkillNameByDirName(userId: string, dirName: string): string | null {
+	const db = getDb();
+	const row = db.prepare(
+		'SELECT skill_name FROM user_skills WHERE user_id = ? AND dir_name = ?'
+	).get(userId, dirName) as { skill_name: string } | undefined;
+	return row?.skill_name || null;
+}
+
+// ==================== Skill使用统计相关函数 ====================
+
+export function recordSkillUsage(usage: Omit<SkillUsage, 'id' | 'calledAt'>): SkillUsage {
+	const db = getDb();
+	const id = `su-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+	const now = new Date().toISOString();
+
+	const stmt = db.prepare(`
+		INSERT INTO skill_usage (id, skill_name, session_id, user_id, context, result, success, called_at)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+	stmt.run(id, usage.skillName, usage.sessionId, usage.userId, usage.context, usage.result, usage.success ? 1 : 0, now);
+
+	return {
+		...usage,
+		id,
+		calledAt: new Date(now),
+	};
+}
+
+export function getSkillUsageStats(skillName: string): { total: number; success: number; fail: number } {
+	const db = getDb();
+	const stmt = db.prepare(`
+		SELECT 
+			COUNT(*) as total,
+			SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) as success_count,
+			SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as fail_count
+		FROM skill_usage WHERE skill_name = ?
+	`);
+	const row = stmt.get(skillName) as any;
+	return {
+		total: row?.total || 0,
+		success: row?.success_count || 0,
+		fail: row?.fail_count || 0,
+	};
+}
+
+// ==================== 市场知识相关函数 ====================
+
+export function getMarketKnowledge(filters?: { category?: string; search?: string; limit?: number; offset?: number }): Document[] | { documents: Document[]; total: number } {
+	const db = getDb();
+	let whereClause = 'WHERE market_status = ?';
+	const params: any[] = ['published'];
+
+	if (filters?.category) {
+		whereClause += ' AND category = ?';
+		params.push(filters.category);
+	}
+
+	if (filters?.search) {
+		whereClause += ' AND (title LIKE ? OR content LIKE ?)';
+		const searchTerm = `%${filters.search}%`;
+		params.push(searchTerm, searchTerm);
+	}
+
+	// 如果有分页参数，返回分页结果
+	if (filters?.offset !== undefined) {
+		// 获取总数
+		const countStmt = db.prepare(`SELECT COUNT(*) as count FROM documents ${whereClause}`);
+		const countResult = countStmt.get(...params) as { count: number };
+		const total = countResult.count;
+
+		// 获取分页数据
+		let query = `SELECT * FROM documents ${whereClause} ORDER BY market_downloads DESC, market_rating DESC`;
+
+		if (filters?.limit) {
+			query += ' LIMIT ?';
+			params.push(filters.limit);
+		}
+
+		if (filters?.offset) {
+			query += ' OFFSET ?';
+			params.push(filters.offset);
+		}
+
+		const stmt = db.prepare(query);
+		const rows = stmt.all(...params) as any[];
+
+		return {
+			documents: rows.map(row => parseDocumentRowWithKnowledge(row)),
+			total,
+		};
+	}
+
+	// 原有逻辑，返回数组
+	let query = `SELECT * FROM documents ${whereClause} ORDER BY market_downloads DESC, market_rating DESC`;
+
+	if (filters?.limit) {
+		query += ' LIMIT ?';
+		params.push(filters.limit);
+	}
+
+	const stmt = db.prepare(query);
+	const rows = stmt.all(...params) as any[];
+	return rows.map(row => parseDocumentRowWithKnowledge(row));
+}
+
+export function publishKnowledgeToMarket(id: string, author: string): Document | null {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const stmt = db.prepare(`
+		UPDATE documents SET market_status = ?, updated_at = ? WHERE id = ?
+	`);
+	stmt.run('published', now, id);
+
+	const getStmt = db.prepare('SELECT * FROM documents WHERE id = ?');
+	const row = getStmt.get(id) as any;
+	if (!row) return null;
+	return parseDocumentRowWithKnowledge(row);
+}
+
+// ==================== 技能市场相关类型 ====================
+
+export interface SkillMarket {
+	id: string;
+	name: string;
+	displayName: string;
+	description?: string;
+	version: string;
+	author: string;
+	authorName?: string;
+	status: 'pending' | 'approved' | 'rejected' | 'archived';
+	isOfficial: boolean;
+	ratingAvg: number;
+	ratingCount: number;
+	downloadCount: number;
+	filePath?: string;
+	reviewedBy?: string;
+	reviewedAt?: string;
+	reviewComment?: string;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface SkillRating {
+	id: string;
+	skillId: string;
+	userId: string;
+	rating: number;
+	comment?: string;
+	createdAt: string;
+}
+
+export interface UserInstalledSkill {
+	id: string;
+	userId: string;
+	skillId: string;
+	installedAt: string;
+}
+
+// ==================== 会话列表相关类型 ====================
+
+export interface Session {
+	sessionId: string;
+	userId?: string;
+	source?: 'web' | 'feishu_bot' | 'api';
+	sourceUserId?: string;
+	createdAt: Date;
+	lastAccessedAt: Date;
+	messageCount: number;
+	recentSummary?: string;
+	title?: string;
+}
+
+// ==================== 会话列表操作 ====================
+
+export function saveSession(session: Omit<Session, 'createdAt' | 'lastAccessedAt'> & { createdAt: string | Date; lastAccessedAt: string | Date }): Session {
+	const db = getDb();
+	const now = new Date();
+	const createdAt = session.createdAt instanceof Date ? session.createdAt.toISOString() : session.createdAt;
+	const lastAccessedAt = session.lastAccessedAt instanceof Date ? session.lastAccessedAt.toISOString() : session.lastAccessedAt;
+
+	const stmt = db.prepare(`
+		INSERT INTO sessions (session_id, user_id, source, source_user_id, created_at, last_accessed_at, message_count, recent_summary)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+		ON CONFLICT(session_id) DO UPDATE SET
+			user_id = excluded.user_id,
+			source = excluded.source,
+			source_user_id = excluded.source_user_id,
+			last_accessed_at = excluded.last_accessed_at,
+			message_count = excluded.message_count,
+			recent_summary = excluded.recent_summary
+	`);
+	stmt.run(
+		session.sessionId,
+		session.userId ?? null,
+		session.source ?? null,
+		session.sourceUserId ?? null,
+		createdAt,
+		lastAccessedAt,
+		session.messageCount,
+		session.recentSummary ?? null
+	);
+
+	return {
+		sessionId: session.sessionId,
+		userId: session.userId,
+		source: session.source,
+		sourceUserId: session.sourceUserId,
+		createdAt: new Date(createdAt),
+		lastAccessedAt: new Date(lastAccessedAt),
+		messageCount: session.messageCount,
+		recentSummary: session.recentSummary,
+	};
+}
+
+export function getSession(sessionId: string): Session | null {
+	const db = getDb();
+	const stmt = db.prepare('SELECT * FROM sessions WHERE session_id = ?');
+	const row = stmt.get(sessionId) as any;
+
+	if (!row) return null;
+
+	return {
+		sessionId: row.session_id,
+		userId: row.user_id ?? undefined,
+		source: row.source ?? undefined,
+		sourceUserId: row.source_user_id ?? undefined,
+		createdAt: new Date(row.created_at),
+		lastAccessedAt: new Date(row.last_accessed_at),
+		messageCount: row.message_count,
+		recentSummary: row.recent_summary ?? undefined,
+		title: row.title ?? undefined,
+	};
+}
+
+export function getAllSessions(userId?: string): Session[] {
+	const db = getDb();
+
+	let stmt;
+	let rows: any[];
+
+	if (userId) {
+		stmt = db.prepare('SELECT * FROM sessions WHERE user_id = ? ORDER BY last_accessed_at DESC');
+		rows = stmt.all(userId);
+	} else {
+		stmt = db.prepare('SELECT * FROM sessions ORDER BY last_accessed_at DESC');
+		rows = stmt.all();
+	}
+
+	return rows.map(row => ({
+		sessionId: row.session_id,
+		userId: row.user_id ?? undefined,
+		createdAt: new Date(row.created_at),
+		lastAccessedAt: new Date(row.last_accessed_at),
+		messageCount: row.message_count,
+		recentSummary: row.recent_summary ?? undefined,
+		title: row.title ?? undefined,
+	}));
+}
+
+export function deleteSession(sessionId: string): boolean {
+	const db = getDb();
+	const stmt = db.prepare('DELETE FROM sessions WHERE session_id = ?');
+	const result = stmt.run(sessionId);
+	return result.changes > 0;
+}
+
+export function updateSessionLastAccessed(sessionId: string): void {
+	const db = getDb();
+	const now = new Date().toISOString();
+	const stmt = db.prepare('UPDATE sessions SET last_accessed_at = ? WHERE session_id = ?');
+	stmt.run(now, sessionId);
+}
+
+export function updateSessionTitle(sessionId: string, title: string): void {
+	const db = getDb();
+	const stmt = db.prepare('UPDATE sessions SET title = ? WHERE session_id = ?');
+	stmt.run(title, sessionId);
+}
+
+// ==================== 统计分析相关函数 ====================
+
+export interface SessionStats {
+	totalSessions: number;
+	activeUsers: number;
+	totalMessages: number;
+	totalSkillCalls: number;
+	aiGeneratedTickets: number;
+	dateRange: { start: string; end: string };
+}
+
+export interface TrendData {
+	date: string;
+	sessionCount: number;
+	userCount: number;
+}
+
+export interface UserStats {
+	userId: string;
+	sessionCount: number;
+	messageCount: number;
+	skillCallCount: number;
+	lastActiveAt: string;
+}
+
+export interface SkillStats {
+	skillName: string;
+	callCount: number;
+	successCount: number;
+	failCount: number;
+	successRate: number;
+	lastCalledAt: string;
+}
+
+export interface KnowledgeStats {
+	documentId: string;
+	title: string;
+	category: string;
+	引用次数: number;
+}
+
+export function getSessionStats(period: '7d' | '30d' | 'all'): SessionStats {
+	const db = getDb();
+	const now = new Date();
+	let startDate: Date;
+	let dateClause = '';
+
+	if (period === '7d') {
+		startDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+	} else if (period === '30d') {
+		startDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+	} else {
+		startDate = new Date(0);
+	}
+
+	if (period !== 'all') {
+		dateClause = `WHERE created_at >= '${startDate.toISOString()}'`;
+	}
+
+	// 总会话数
+	const sessionStmt = db.prepare(`SELECT COUNT(*) as total FROM sessions ${dateClause}`);
+	const totalSessions = (sessionStmt.get() as any)?.total || 0;
+
+	// 活跃用户数（指定时间段内有会话的用户）
+	const activeUserStmt = db.prepare(`
+		SELECT COUNT(DISTINCT user_id) as total 
+		FROM sessions 
+		WHERE user_id IS NOT NULL AND created_at >= ?
+	`);
+	const activeUsers = (activeUserStmt.get(startDate.toISOString()) as any)?.total || 0;
+
+	// 总会话消息数
+	const messageStmt = db.prepare(`SELECT COALESCE(SUM(message_count), 0) as total FROM sessions ${dateClause}`);
+	const totalMessages = (messageStmt.get() as any)?.total || 0;
+
+	// 技能调用总次数
+	let skillDateClause = period !== 'all' ? `WHERE called_at >= '${startDate.toISOString()}'` : '';
+	const skillStmt = db.prepare(`SELECT COUNT(*) as total FROM skill_usage ${skillDateClause}`);
+	const totalSkillCalls = (skillStmt.get() as any)?.total || 0;
+
+	// AI生成的工单数
+	let ticketDateClause = period !== 'all' ? `AND created_at >= '${startDate.toISOString()}'` : '';
+	const ticketStmt = db.prepare(`SELECT COUNT(*) as total FROM tickets WHERE ai_generated = 1 ${ticketDateClause}`);
+	const aiGeneratedTickets = (ticketStmt.get() as any)?.total || 0;
+
+	return {
+		totalSessions,
+		activeUsers,
+		totalMessages,
+		totalSkillCalls,
+		aiGeneratedTickets,
+		dateRange: {
+			start: startDate.toISOString(),
+			end: now.toISOString(),
+		},
+	};
+}
+
+export function getSessionTrends(period: '7d' | '30d' | 'all'): TrendData[] {
+	const db = getDb();
+	const now = new Date();
+	let days = period === '7d' ? 7 : period === '30d' ? 30 : 90;
+	let startDate = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+
+	const stmt = db.prepare(`
+		SELECT 
+			DATE(created_at) as date,
+			COUNT(*) as sessionCount,
+			COUNT(DISTINCT user_id) as userCount
+		FROM sessions 
+		WHERE created_at >= ?
+		GROUP BY DATE(created_at)
+		ORDER BY date ASC
+	`);
+
+	const rows = stmt.all(startDate.toISOString()) as any[];
+
+	// 补齐没有数据的日期
+	const result: TrendData[] = [];
+	const dataMap = new Map(rows.map(r => [r.date, r]));
+
+	for (let i = 0; i < days; i++) {
+		const d = new Date(startDate.getTime() + i * 24 * 60 * 60 * 1000);
+		const dateStr = d.toISOString().split('T')[0];
+		const existing = dataMap.get(dateStr);
+		result.push({
+			date: dateStr,
+			sessionCount: existing?.sessioncount || 0,
+			userCount: existing?.usercount || 0,
+		});
+	}
+
+	return result;
+}
+
+export function getUserStats(period: '7d' | '30d' | 'all'): UserStats[] {
+	const db = getDb();
+	const now = new Date();
+	let startDate: Date;
+
+	if (period === '7d') {
+		startDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+	} else if (period === '30d') {
+		startDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+	} else {
+		startDate = new Date(0);
+	}
+
+	const stmt = db.prepare(`
+		SELECT 
+			s.user_id,
+			COUNT(s.session_id) as sessionCount,
+			COALESCE(SUM(s.message_count), 0) as messageCount,
+			COALESCE((SELECT COUNT(*) FROM skill_usage su WHERE su.user_id = s.user_id AND su.called_at >= ?), 0) as skillCallCount,
+			MAX(s.last_accessed_at) as lastActiveAt
+		FROM sessions s
+		WHERE s.user_id IS NOT NULL AND s.created_at >= ?
+		GROUP BY s.user_id
+		ORDER BY sessionCount DESC
+		LIMIT 50
+	`);
+
+	const rows = stmt.all(startDate.toISOString(), startDate.toISOString()) as any[];
+
+	return rows.map(row => ({
+		userId: row.user_id,
+		sessionCount: row.sessioncount || 0,
+		messageCount: row.messagecount || 0,
+		skillCallCount: row.skillcallcount || 0,
+		lastActiveAt: row.lastactiveat || '',
+	}));
+}
+
+export function getSkillStats(period: '7d' | '30d' | 'all'): SkillStats[] {
+	const db = getDb();
+	const now = new Date();
+	let startDate: Date;
+
+	if (period === '7d') {
+		startDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+	} else if (period === '30d') {
+		startDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+	} else {
+		startDate = new Date(0);
+	}
+
+	const stmt = db.prepare(`
+		SELECT 
+			skill_name,
+			COUNT(*) as callCount,
+			SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) as successCount,
+			SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as failCount,
+			MAX(called_at) as lastCalledAt
+		FROM skill_usage
+		WHERE called_at >= ?
+		GROUP BY skill_name
+		ORDER BY callCount DESC
+		LIMIT 20
+	`);
+
+	const rows = stmt.all(startDate.toISOString()) as any[];
+
+	return rows.map(row => ({
+		skillName: row.skill_name,
+		callCount: row.callcount || 0,
+		successCount: row.successcount || 0,
+		failCount: row.failcount || 0,
+		successRate: row.callcount > 0 ? Math.round((row.successcount / row.callcount) * 100) : 0,
+		lastCalledAt: row.lastcalledat || '',
+	}));
+}
+
+export function getKnowledgeStats(period: '7d' | '30d' | 'all'): KnowledgeStats[] {
+	const db = getDb();
+	const now = new Date();
+	let startDate: Date;
+
+	if (period === '7d') {
+		startDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+	} else if (period === '30d') {
+		startDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+	} else {
+		startDate = new Date(0);
+	}
+
+	const stmt = db.prepare(`
+		SELECT 
+			d.id,
+			d.title,
+			d.category,
+			(SELECT COUNT(*) FROM audit_logs al 
+			 WHERE al.details LIKE '%' || d.id || '%' 
+			 AND al.action = 'knowledge-used'
+			 AND al.timestamp >= ?) as 引用次数
+		FROM documents d
+		WHERE d.is_active = 1
+		ORDER BY 引用次数 DESC
+		LIMIT 20
+	`);
+
+	const rows = stmt.all(startDate.toISOString()) as any[];
+
+	return rows.map(row => ({
+		documentId: row.id,
+		title: row.title || '未命名',
+		category: row.category || '未分类',
+		引用次数: row.引用次数 || 0,
+	})).filter(k => k.引用次数 > 0);
+}