fi-pool-server 0.1.0

package/dist/services/session.js

@@ -0,0 +1,176 @@
+/**
+ * LLM 会话管理（运行时内存存储）
+ *
+ * 管理多角色 LLM 分析过程中的会话状态。
+ * 每个会话存储一系列消息，支持自动裁剪以避免超出上下文窗口。
+ * 会话数据不持久化，仅在内存中维护。
+ *
+ * @module services/session
+ */
+// ─── 模块级状态 ────────────────────────────────────────────
+/** 内存中的会话存储 */
+const sessions = new Map();
+/** 当前激活的会话 ID */
+let currentSessionId;
+/** 单个会话允许的最大消息数 */
+const MAX_MESSAGES = 20;
+/**
+ * 超过 MAX_MESSAGES 时一次性裁剪的消息数。
+ * 从最早的消息开始移除。
+ */
+const TRIM_COUNT = 5;
+// ─── 工具函数 ──────────────────────────────────────────────
+/**
+ * 生成一个简短随机字符串作为会话 ID。
+ * 格式：8 位十六进制字符。
+ *
+ * @returns 随机 ID
+ */
+function generateId() {
+    return Math.random().toString(16).slice(2, 10);
+}
+// ─── 公开 API ──────────────────────────────────────────────
+/**
+ * 创建一个新的空会话并将其设为当前会话。
+ *
+ * @returns 新会话的 ID
+ *
+ * @example
+ * const sessionId = createSession();
+ * console.log(sessionId); // 'a1b2c3d4'
+ */
+export function createSession() {
+    const id = generateId();
+    const session = {
+        id,
+        createdAt: new Date().toISOString(),
+        messages: [],
+    };
+    sessions.set(id, session);
+    currentSessionId = id;
+    return id;
+}
+/**
+ * 切换到指定会话作为当前会话。
+ * 如果指定 ID 不存在则会自动创建新会话。
+ *
+ * @param sessionId - 目标会话 ID
+ * @returns 包含当前会话 ID 和上一个会话 ID 的对象
+ *
+ * @example
+ * const { sessionId, previousId } = switchSession('a1b2c3d4');
+ * // 如果之前有活动会话，previousId 是其 ID
+ */
+export function switchSession(sessionId) {
+    const previousId = currentSessionId;
+    // 如果会话不存在则自动创建
+    if (!sessions.has(sessionId)) {
+        const session = {
+            id: sessionId,
+            createdAt: new Date().toISOString(),
+            messages: [],
+        };
+        sessions.set(sessionId, session);
+    }
+    currentSessionId = sessionId;
+    return { sessionId, previousId };
+}
+/**
+ * 向指定会话追加一条消息。
+ * 如果会话消息数超过 MAX_MESSAGES，自动裁剪最早的非系统消息。
+ *
+ * @param sessionId - 目标会话 ID
+ * @param role - 消息角色
+ * @param content - 消息内容
+ *
+ * @example
+ * appendMessage('a1b2c3d4', 'user', '分析贵州茅台');
+ * appendMessage('a1b2c3d4', 'assistant', '贵州茅台最新股价...');
+ */
+export function appendMessage(sessionId, role, content) {
+    const session = sessions.get(sessionId);
+    if (!session) {
+        throw new Error(`会话不存在: ${sessionId}`);
+    }
+    session.messages.push({ role, content });
+    // 超出限制时裁剪最早的消息（保留系统消息）
+    if (session.messages.length > MAX_MESSAGES) {
+        // 计算需要移除的消息数
+        const excess = session.messages.length - MAX_MESSAGES;
+        const toRemove = Math.min(excess + TRIM_COUNT, session.messages.length);
+        // 保留所有 system 消息，移除最早的非 system 消息
+        const systemMessages = session.messages.filter((m) => m.role === 'system');
+        const nonSystemMessages = session.messages.filter((m) => m.role !== 'system');
+        const trimmed = nonSystemMessages.slice(toRemove);
+        session.messages = [...systemMessages, ...trimmed];
+    }
+}
+/**
+ * 获取指定会话的完整数据。
+ *
+ * @param sessionId - 会话 ID
+ * @returns 会话对象，不存在返回 undefined
+ *
+ * @example
+ * const session = getSession('a1b2c3d4');
+ * if (session) console.log(session.messages.length);
+ */
+export function getSession(sessionId) {
+    return sessions.get(sessionId);
+}
+/**
+ * 列出所有已创建的会话（摘要信息）。
+ *
+ * @returns 会话摘要列表，包含 id 和 createdAt
+ *
+ * @example
+ * const list = listSessions();
+ * list.forEach(s => console.log(s.id, s.createdAt));
+ */
+export function listSessions() {
+    return Array.from(sessions.values()).map((s) => ({
+        id: s.id,
+        createdAt: s.createdAt,
+    }));
+}
+/**
+ * 获取当前激活的会话。
+ *
+ * @returns 当前会话对象，无活动会话时返回 undefined
+ *
+ * @example
+ * const session = getCurrentSession();
+ * if (session) console.log(session.id);
+ */
+export function getCurrentSession() {
+    if (!currentSessionId)
+        return undefined;
+    return sessions.get(currentSessionId);
+}
+/**
+ * 清空会话消息。
+ *
+ * - 不指定 sessionId：清空所有会话（重置整个内存存储）
+ * - 指定 sessionId：仅清空该会话的消息列表（会话保留）
+ *
+ * @param sessionId - 可选的目标会话 ID
+ *
+ * @example
+ * // 清空特定会话
+ * clearSession('a1b2c3d4');
+ * // 清空全部
+ * clearSession();
+ */
+export function clearSession(sessionId) {
+    if (sessionId) {
+        const session = sessions.get(sessionId);
+        if (session) {
+            session.messages = [];
+        }
+    }
+    else {
+        sessions.clear();
+        currentSessionId = undefined;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/services/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,yDAAyD;AAEzD,eAAe;AACf,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE5C,iBAAiB;AACjB,IAAI,gBAAoC,CAAC;AAEzC,mBAAmB;AACnB,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,0DAA0D;AAE1D;;;;;GAKG;AACH,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,OAAO,GAAY;QACvB,EAAE;QACF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,EAAE;KACb,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1B,gBAAgB,GAAG,EAAE,CAAC;IACtB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAI7C,MAAM,UAAU,GAAG,gBAAgB,CAAC;IAEpC,eAAe;IACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,SAAS;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,IAAY,EACZ,OAAe;IAEf,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzC,uBAAuB;IACvB,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QAC3C,aAAa;QACb,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAExE,kCAAkC;QAClC,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC3E,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO,CAAC,QAAQ,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,SAAkB;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,gBAAgB,GAAG,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/services/stock.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 股票基础信息 CRUD 服务
+ *
+ * 对 stock 表进行增删改查操作。
+ * 每个股票存储 6 位代码、名称、最新价格和更新时间。
+ *
+ * @module services/stock
+ */
+/**
+ * 根据股票代码获取单只股票信息。
+ *
+ * @param code - 六位股票代码（如 '600519'）
+ * @returns 股票对象，未找到时返回 null
+ *
+ * @example
+ * const s = await getStockByCode('600519');
+ * if (s) console.log(s.name);
+ */
+export declare function getStockByCode(code: string): Promise<{
+    name: string;
+    updatedAt: string;
+    code: string;
+    currentPrice: number;
+}>;
+/**
+ * 根据关键词搜索股票（模糊匹配名称或代码）。
+ *
+ * @param keyword - 搜索关键词，自动在前后添加 % 通配符
+ * @returns 匹配的股票列表
+ *
+ * @example
+ * const results = await searchStocks('茅台');
+ */
+export declare function searchStocks(keyword: string): Promise<{
+    name: string;
+    updatedAt: string;
+    code: string;
+    currentPrice: number;
+}[]>;
+/**
+ * 插入或更新股票信息。
+ * 当 code 已存在时更新名称、价格和更新时间；不存在时新增记录。
+ *
+ * @param code - 六位股票代码
+ * @param name - 股票名称
+ * @param price - 当前价格
+ * @returns 插入或更新后的股票对象
+ *
+ * @example
+ * const s = await upsertStock('600519', '贵州茅台', 1915.00);
+ */
+export declare function upsertStock(code: string, name: string, price: number): Promise<{
+    name: string;
+    updatedAt: string;
+    code: string;
+    currentPrice: number;
+}>;
+/**
+ * 列出数据库中所有股票，按代码升序排列。
+ *
+ * @returns 全部股票列表
+ *
+ * @example
+ * const all = await listAllStocks();
+ */
+export declare function listAllStocks(): Promise<{
+    name: string;
+    updatedAt: string;
+    code: string;
+    currentPrice: number;
+}[]>;
+/**
+ * 根据股票代码删除一条股票记录。
+ * 注意：会因外键约束失败而拒绝删除，如果存在关联的 pool_stock 或 daily_info 记录。
+ *
+ * @param code - 六位股票代码
+ *
+ * @example
+ * await deleteStock('600519');
+ */
+export declare function deleteStock(code: string): Promise<void>;
+//# sourceMappingURL=stock.d.ts.map

package/dist/services/stock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.d.ts","sourceRoot":"","sources":["../../src/services/stock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM;;;;;GAIhD;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM;;;;;KAQjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;GAiB1E;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa;;;;;KAGlC;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,iBAG7C"}

package/dist/services/stock.js

@@ -0,0 +1,99 @@
+/**
+ * 股票基础信息 CRUD 服务
+ *
+ * 对 stock 表进行增删改查操作。
+ * 每个股票存储 6 位代码、名称、最新价格和更新时间。
+ *
+ * @module services/stock
+ */
+import { getDatabase } from '../db/index.js';
+import { stock } from '../db/schema.js';
+import { eq, like, or, sql } from 'drizzle-orm';
+/**
+ * 根据股票代码获取单只股票信息。
+ *
+ * @param code - 六位股票代码（如 '600519'）
+ * @returns 股票对象，未找到时返回 null
+ *
+ * @example
+ * const s = await getStockByCode('600519');
+ * if (s) console.log(s.name);
+ */
+export async function getStockByCode(code) {
+    const db = getDatabase();
+    const rows = db.select().from(stock).where(eq(stock.code, code)).all();
+    return rows[0] ?? null;
+}
+/**
+ * 根据关键词搜索股票（模糊匹配名称或代码）。
+ *
+ * @param keyword - 搜索关键词，自动在前后添加 % 通配符
+ * @returns 匹配的股票列表
+ *
+ * @example
+ * const results = await searchStocks('茅台');
+ */
+export async function searchStocks(keyword) {
+    const db = getDatabase();
+    const pattern = `%${keyword}%`;
+    return db
+        .select()
+        .from(stock)
+        .where(or(like(stock.code, pattern), like(stock.name, pattern)))
+        .all();
+}
+/**
+ * 插入或更新股票信息。
+ * 当 code 已存在时更新名称、价格和更新时间；不存在时新增记录。
+ *
+ * @param code - 六位股票代码
+ * @param name - 股票名称
+ * @param price - 当前价格
+ * @returns 插入或更新后的股票对象
+ *
+ * @example
+ * const s = await upsertStock('600519', '贵州茅台', 1915.00);
+ */
+export async function upsertStock(code, name, price) {
+    const db = getDatabase();
+    db.insert(stock)
+        .values({ code, name, currentPrice: price })
+        .onConflictDoUpdate({
+        target: stock.code,
+        set: {
+            name,
+            currentPrice: price,
+            updatedAt: sql `datetime('now')`,
+        },
+    })
+        .run();
+    // 重新查询以返回完整记录
+    const rows = db.select().from(stock).where(eq(stock.code, code)).all();
+    return rows[0];
+}
+/**
+ * 列出数据库中所有股票，按代码升序排列。
+ *
+ * @returns 全部股票列表
+ *
+ * @example
+ * const all = await listAllStocks();
+ */
+export async function listAllStocks() {
+    const db = getDatabase();
+    return db.select().from(stock).orderBy(stock.code).all();
+}
+/**
+ * 根据股票代码删除一条股票记录。
+ * 注意：会因外键约束失败而拒绝删除，如果存在关联的 pool_stock 或 daily_info 记录。
+ *
+ * @param code - 六位股票代码
+ *
+ * @example
+ * await deleteStock('600519');
+ */
+export async function deleteStock(code) {
+    const db = getDatabase();
+    db.delete(stock).where(eq(stock.code, code)).run();
+}
+//# sourceMappingURL=stock.js.map

package/dist/services/stock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.js","sourceRoot":"","sources":["../../src/services/stock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC;IAC/B,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,KAAK,CAAC;SACX,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;SAC/D,GAAG,EAAE,CAAC;AACX,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa;IACzE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;SACb,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;SAC3C,kBAAkB,CAAC;QAClB,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,GAAG,EAAE;YACH,IAAI;YACJ,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,GAAG,CAAA,iBAAiB;SAChC;KACF,CAAC;SACD,GAAG,EAAE,CAAC;IAET,cAAc;IACd,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC,CAAC,CAAE,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IACzB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACrD,CAAC"}

package/dist/services/word-count.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 字数统计与截断工具
+ *
+ * 职责：
+ * - 统计中文字符数、综合字数（中文 + 英文）
+ * - 按限制截断文本
+ * - 估算 Token 数（用于 LLM 上下文窗口控制）
+ *
+ * @module services/word-count
+ */
+/**
+ * 统计字符串中的中文字符数。
+ * 仅统计 Unicode 中的 CJK 统一表意文字（一-鿿）。
+ *
+ * @param text - 待统计的文本
+ * @returns 中文字符数量
+ *
+ * @example
+ * countChineseChars('Hello 世界') // => 2
+ */
+export declare function countChineseChars(text: string): number;
+/**
+ * 综合字数统计。
+ * - 中文字符：每个计 1 字
+ * - 英文单词：按空白或标点分隔的连续字母序列，每个计 1 词
+ * - 数字序列：每个连续数字序列计 1 词
+ *
+ * @param text - 待统计的文本
+ * @returns 综合字数
+ *
+ * @example
+ * countWords('Hello 世界 foo bar') // => 4 (Hello + 世界 + foo + bar)
+ */
+export declare function countWords(text: string): number;
+/**
+ * 将文本截断至指定字数限制，保留完整单词。
+ * 截断后追加 `[已截断]` 标记。
+ * 如果文本已在限制内，则原样返回。
+ *
+ * @param text - 原始文本
+ * @param limit - 字数上限
+ * @returns 截断后的文本（带标记）或原文本
+ *
+ * @example
+ * truncateToLimit('这是一段很长的文本内容', 3)
+ * // => '这是一[已截断]'
+ */
+export declare function truncateToLimit(text: string, limit: number): string;
+/**
+ * 粗略估算 Token 数。
+ * - 中文：约每 1.5 个字符计 1 token
+ * - 英文：按空格分词，每词约 1.3 token
+ *
+ * @param text - 待估算的文本
+ * @returns 预估 Token 数量
+ *
+ * @example
+ * estimateTokens('Hello 世界') // => ~3 (2 english tokens + 1.3 chinese tokens)
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=word-count.d.ts.map

package/dist/services/word-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-count.d.ts","sourceRoot":"","sources":["../../src/services/word-count.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqCnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/services/word-count.js

@@ -0,0 +1,120 @@
+/**
+ * 字数统计与截断工具
+ *
+ * 职责：
+ * - 统计中文字符数、综合字数（中文 + 英文）
+ * - 按限制截断文本
+ * - 估算 Token 数（用于 LLM 上下文窗口控制）
+ *
+ * @module services/word-count
+ */
+/**
+ * 统计字符串中的中文字符数。
+ * 仅统计 Unicode 中的 CJK 统一表意文字（一-鿿）。
+ *
+ * @param text - 待统计的文本
+ * @returns 中文字符数量
+ *
+ * @example
+ * countChineseChars('Hello 世界') // => 2
+ */
+export function countChineseChars(text) {
+    const matches = text.match(/[一-鿿]/g);
+    return matches ? matches.length : 0;
+}
+/**
+ * 综合字数统计。
+ * - 中文字符：每个计 1 字
+ * - 英文单词：按空白或标点分隔的连续字母序列，每个计 1 词
+ * - 数字序列：每个连续数字序列计 1 词
+ *
+ * @param text - 待统计的文本
+ * @returns 综合字数
+ *
+ * @example
+ * countWords('Hello 世界 foo bar') // => 4 (Hello + 世界 + foo + bar)
+ */
+export function countWords(text) {
+    const chineseCount = countChineseChars(text);
+    // 移去中文字符后，按空白和标点分割英文/数字单词
+    const nonChinese = text.replace(/[一-鿿]/g, ' ');
+    const englishWords = nonChinese
+        .split(/[\s,.;:!?()\[\]{}"'\-_/@#$%^&*+=<>~`|]+/)
+        .filter(Boolean);
+    return chineseCount + englishWords.length;
+}
+/**
+ * 将文本截断至指定字数限制，保留完整单词。
+ * 截断后追加 `[已截断]` 标记。
+ * 如果文本已在限制内，则原样返回。
+ *
+ * @param text - 原始文本
+ * @param limit - 字数上限
+ * @returns 截断后的文本（带标记）或原文本
+ *
+ * @example
+ * truncateToLimit('这是一段很长的文本内容', 3)
+ * // => '这是一[已截断]'
+ */
+export function truncateToLimit(text, limit) {
+    if (limit <= 0)
+        return '[已截断]';
+    const currentCount = countWords(text);
+    if (currentCount <= limit)
+        return text;
+    // 按字符遍历，逐个检查累计字数
+    let result = '';
+    let accumulated = 0;
+    for (const char of text) {
+        const isChinese = /[一-鿿]/.test(char);
+        const isSpaceOrPunct = /[\s,.;:!?()\[\]{}"'\-_/@#$%^&*+=<>~`|]/.test(char);
+        if (isChinese) {
+            if (accumulated + 1 > limit)
+                break;
+            result += char;
+            accumulated += 1;
+        }
+        else if (isSpaceOrPunct) {
+            // 标点和空白不计入字数，但保留
+            result += char;
+        }
+        else {
+            // 英文字母或数字：尝试读入完整单词
+            const remaining = text.slice(text.length - text.slice(result.length).length);
+            const wordMatch = remaining.match(/^[^\s一-鿿]+/);
+            if (wordMatch) {
+                const word = wordMatch[0];
+                if (accumulated + 1 > limit)
+                    break;
+                result += word;
+                accumulated += 1;
+            }
+            else {
+                result += char;
+            }
+        }
+    }
+    return result + '[已截断]';
+}
+/**
+ * 粗略估算 Token 数。
+ * - 中文：约每 1.5 个字符计 1 token
+ * - 英文：按空格分词，每词约 1.3 token
+ *
+ * @param text - 待估算的文本
+ * @returns 预估 Token 数量
+ *
+ * @example
+ * estimateTokens('Hello 世界') // => ~3 (2 english tokens + 1.3 chinese tokens)
+ */
+export function estimateTokens(text) {
+    const chineseCount = countChineseChars(text);
+    const chineseTokens = Math.ceil(chineseCount / 1.5);
+    const nonChinese = text.replace(/[一-鿿]/g, ' ');
+    const englishWords = nonChinese
+        .split(/[\s,.;:!?()\[\]{}"'\-_/@#$%^&*+=<>~`|]+/)
+        .filter(Boolean);
+    const englishTokens = englishWords.reduce((sum, w) => sum + Math.ceil(w.length / 3), 0);
+    return chineseTokens + englishTokens;
+}
+//# sourceMappingURL=word-count.js.map

package/dist/services/word-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-count.js","sourceRoot":"","sources":["../../src/services/word-count.ts"],"names":[],"mappings":"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"}

package/dist/tools/auxiliary.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 辅助类工具（Auxiliary）
+ *
+ * 提供帮助信息、资源列表、状态查询、版本信息、配置管理等功能。
+ * 返回值均为元信息，不涉及业务数据。
+ *
+ * @module tools/auxiliary
+ */
+/**
+ * 输出所有可用的命令和工具帮助信息。
+ *
+ * @param command - 可选命令名称，不指定则输出所有
+ * @returns 帮助文本
+ */
+export declare function help(command?: string): Promise<string>;
+/**
+ * 列出可用资源。
+ *
+ * @param type - 资源类型 "pools" | "stocks" | "tools"
+ * @returns 资源列表
+ */
+export declare function listResources(type: 'pools' | 'stocks' | 'tools'): Promise<{
+    items: {
+        id: string;
+        name: string;
+    }[];
+}>;
+/**
+ * 查看系统简要运行状态。
+ *
+ * @returns { status: 'running' | 'error', version: string, uptime: number }
+ */
+export declare function showState(): Promise<{
+    status: "running";
+    version: string;
+    uptime: number;
+}>;
+/**
+ * 输出版本信息。
+ *
+ * @returns 版本字符串
+ */
+export declare function showVersion(): Promise<string>;
+/**
+ * 查看指定配置项或所有配置。
+ *
+ * 查询优先级：DB → process.env → null。
+ * DB 中不存在的键会 fallback 到 .env 环境变量。
+ *
+ * @param key - 可选配置键名，不指定则返回所有配置
+ * @returns 配置键值对
+ */
+export declare function getConfig(key?: string): Promise<{
+    key: string;
+    value: string;
+    source?: undefined;
+    config?: undefined;
+} | {
+    key: string;
+    value: string;
+    source: string;
+    config?: undefined;
+} | {
+    key: string;
+    value: null;
+    source?: undefined;
+    config?: undefined;
+} | {
+    config: Record<string, string>;
+    key?: undefined;
+    value?: undefined;
+    source?: undefined;
+}>;
+/**
+ * 修改配置项。
+ *
+ * 同时更新 DB 和运行时的 process.env，确保对同一进程后续读取生效。
+ *
+ * @param key   - 配置键名
+ * @param value - 配置值
+ * @returns { success: true }
+ */
+export declare function setConfig(key: string, value: string): Promise<{
+    success: true;
+    error?: undefined;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+//# sourceMappingURL=auxiliary.d.ts.map

package/dist/tools/auxiliary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.d.ts","sourceRoot":"","sources":["../../src/tools/auxiliary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqD5D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO;;;;;GAoCrE;AAED;;;;GAIG;AACH,wBAAsB,SAAS;;;;GAM9B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;GA+B3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;;;GAiBzD"}