modular-mcp-memory/dist/types/index.d.ts

模块化MCP记忆系统 v4.5.1 - 基于Zettelkasten记忆片段盒笔记法的精简记忆系统，包含性能优化、智能占位符功能、内容提取拆分功能和修复的展开功能

/**
 * 记忆片段内容接口
 */
export interface CardContent {
    /** 记忆片段名称 */
    name: string;
    /** 记忆片段内容 */
    content: string;
    /** 创建时间 */
    createdAt: Date;
    /** 最后修改时间 */
    updatedAt: Date;
}
/**
 * 记忆片段引用接口
 */
export interface CardReference {
    /** 引用的记忆片段名称 */
    fragmentName: string;
    /** 在当前记忆片段中的位置（字符索引） */
    position: number;
}
/**
 * 权重计算结果接口
 */
export interface WeightResult {
    /** 记忆片段名称 */
    fragmentName: string;
    /** 权重值 */
    weight: number;
}
/**
 * 价值计算结果接口
 */
export interface ValueResult {
    /** 记忆片段名称 */
    fragmentName: string;
    /** 价值值 */
    value: number;
    /** 权重 */
    weight: number;
    /** 字符数 */
    characterCount: number;
}
/**
 * 提示结果接口
 */
export interface HintResult {
    /** 记忆片段名称列表，按权重从高到低排序 */
    fragmentNames: string[];
    /** 权重详情 */
    weights: WeightResult[];
}
/**
 * 优化建议结果接口
 */
export interface SuggestionResult {
    /** 建议优化的记忆片段名称列表，按价值从低到高排序 */
    fragmentNames: string[];
    /** 价值详情 */
    values: ValueResult[];
}
/**
 * 低价值片段结果接口
 */
export interface LowValueResult {
    /** 记忆片段名称 */
    fragmentName: string;
    /** 信息散度值 */
    divergence: number;
    /** 权重 */
    weight: number;
    /** 字符数 */
    characterCount: number;
}
/**
 * 低价值片段建议结果接口
 */
export interface LowValueSuggestionResult {
    /** 建议优化的低价值记忆片段名称列表，按信息散度从低到高排序 */
    fragmentNames: string[];
    /** 信息散度详情 */
    divergences: LowValueResult[];
}
/**
 * 孤立片段结果接口
 */
export interface IsolatedResult {
    /** 记忆片段名称 */
    fragmentName: string;
    /** 是否孤立 */
    isIsolated: boolean;
    /** 反向链接数量 */
    backlinkCount: number;
}
/**
 * 孤立片段建议结果接口
 */
export interface IsolatedSuggestionResult {
    /** 孤立记忆片段名称列表 */
    fragmentNames: string[];
    /** 孤立详情 */
    isolatedResults: IsolatedResult[];
}
/**
 * Zettelkasten 管理器配置接口
 */
export interface ZettelkastenConfig {
    /** 存储目录路径 */
    storageDir: string;
    /** 文件编码，默认为 'utf-8' */
    encoding?: 'utf8' | 'utf-8' | 'ascii' | 'base64' | 'hex';
    /** 是否自动创建存储目录，默认为 true */
    autoCreateDir?: boolean;
}
/**
 * 展开选项接口
 */
export interface ExpandOptions {
    /** 展开深度，默认为 1 */
    depth?: number;
    /** 最大展开深度，防止循环引用，默认为 10 */
    maxDepth?: number;
    /** 已展开的记忆片段集合，用于防止循环引用 */
    expandedCards?: Set<string>;
}
/**
 * 提取范围定位接口
 */
export interface ExtractRange {
    /** 开始位置 */
    start?: {
        /** 起始行号（1-based），如果不提供则从文件开头开始 */
        line?: number;
        /** 正则表达式匹配，从指定行号开始搜索匹配的内容 */
        regex?: string;
    };
    /** 结束位置 */
    end?: {
        /** 结束行号（1-based），如果不提供则从文件结尾开始 */
        line?: number;
        /** 正则表达式匹配，从指定行号开始倒过来搜索匹配的内容 */
        regex?: string;
    };
}
/**
 * 错误类型枚举
 */
export declare enum ZettelkastenErrorType {
    CARD_NOT_FOUND = "CARD_NOT_FOUND",
    INVALID_CARD_NAME = "INVALID_CARD_NAME",
    STORAGE_ERROR = "STORAGE_ERROR",
    CIRCULAR_REFERENCE = "CIRCULAR_REFERENCE",
    INVALID_CONFIG = "INVALID_CONFIG"
}
/**
 * Zettelkasten 错误类
 */
export declare class ZettelkastenError extends Error {
    type: ZettelkastenErrorType;
    details?: any | undefined;
    constructor(type: ZettelkastenErrorType, message: string, details?: any | undefined);
}
//# sourceMappingURL=index.d.ts.map