tabby-ai-assistant 1.0.5 → 1.0.6

package/dist/providers/tabby/ai-config.provider.d.ts

@@ -6,13 +6,65 @@ import { ConfigProviderService } from '../../services/core/config-provider.servi
  */
 export declare class AiConfigProvider extends ConfigProvider {
     private configService;
-    constructor(configService: ConfigProviderService);
     /**
-     * 提供配置项定义
+     * 默认配置
      */
-    provideConfig(): any;
+    defaults: {
+        hotkeys: {
+            'ai-assistant-toggle': string[];
+            'ai-command-generation': string[];
+            'ai-explain-command': string[];
+        };
+        aiAssistant: {
+            enabled: boolean;
+            defaultProvider: string;
+            autoSuggestCommands: boolean;
+            enableSecurityChecks: boolean;
+            providers: {
+                openai: {
+                    apiKey: string;
+                    model: string;
+                    baseURL: string;
+                };
+                anthropic: {
+                    apiKey: string;
+                    model: string;
+                    baseURL: string;
+                };
+                minimax: {
+                    apiKey: string;
+                    model: string;
+                    baseURL: string;
+                };
+                glm: {
+                    apiKey: string;
+                    model: string;
+                    baseURL: string;
+                };
+                openaiCompatible: {
+                    apiKey: string;
+                    model: string;
+                    baseURL: string;
+                };
+            };
+            security: {
+                passwordProtection: boolean;
+                riskAssessmentLevel: string;
+                consentPersistenceDays: number;
+            };
+        };
+    };
     /**
-     * 配置就绪后的处理
+     * 平台特定默认配置
      */
-    onConfigLoaded(): Promise<void>;
+    platformDefaults: {
+        macOS: {
+            hotkeys: {
+                'ai-assistant-toggle': string[];
+                'ai-command-generation': string[];
+                'ai-explain-command': string[];
+            };
+        };
+    };
+    constructor(configService: ConfigProviderService);
 }

package/dist/providers/tabby/ai-hotkey.provider.d.ts

@@ -1,21 +1,15 @@
-import { HotkeyProvider, HotkeyDescription } from 'tabby-core';
-import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
-import { AiAssistantService } from '../../services/core/ai-assistant.service';
+import { HotkeyProvider, HotkeyDescription, TranslateService } from 'tabby-core';
+import { AiSidebarService } from '../../services/chat/ai-sidebar.service';
 /**
  * Tabby热键提供者
  * 为Tabby添加AI助手热键支持
+ *
+ * 注意：热键 ID 必须与 AiConfigProvider.defaults.hotkeys 中定义的一致
  */
 export declare class AiHotkeyProvider extends HotkeyProvider {
-    private modal;
-    private aiService;
-    constructor(modal: NgbModal, aiService: AiAssistantService);
+    private sidebarService;
+    private translate;
+    hotkeys: HotkeyDescription[];
+    constructor(sidebarService: AiSidebarService, translate: TranslateService);
     provide(): Promise<HotkeyDescription[]>;
-    /**
-     * 打开AI聊天界面
-     */
-    private openAiChat;
-    /**
-     * 打开命令生成功能
-     */
-    private openCommandGeneration;
 }

package/dist/providers/tabby/ai-toolbar-button.provider.d.ts

@@ -1,17 +1,16 @@
-import { ToolbarButtonProvider, ToolbarButton } from 'tabby-core';
-import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
-import { AiAssistantService } from '../../services/core/ai-assistant.service';
+import { ToolbarButtonProvider, ToolbarButton, AppService } from 'tabby-core';
+import { AiSidebarService } from '../../services/chat/ai-sidebar.service';
 /**
  * Tabby工具栏按钮提供者
- * 为Tabby工具栏添加AI助手按钮
+ * 为Tabby工具栏添加AI助手按钮，使用侧边栏方式
  */
 export declare class AiToolbarButtonProvider extends ToolbarButtonProvider {
-    private modal;
-    private aiService;
-    constructor(modal: NgbModal, aiService: AiAssistantService);
+    private app;
+    private sidebarService;
+    constructor(app: AppService, sidebarService: AiSidebarService);
     provide(): ToolbarButton[];
     /**
-     * 打开AI聊天界面
+     * 打开设置页面
      */
-    private openAiChat;
+    private openSettings;
 }

package/dist/services/chat/ai-sidebar.service.d.ts

@@ -0,0 +1,89 @@
+import { ComponentFactoryResolver, ApplicationRef, Injector } from '@angular/core';
+import { ConfigService } from 'tabby-core';
+/**
+ * AI Sidebar 配置接口
+ */
+export interface AiSidebarConfig {
+    enabled?: boolean;
+    position?: 'left' | 'right';
+    showInToolbar?: boolean;
+    sidebarVisible?: boolean;
+    sidebarCollapsed?: boolean;
+}
+/**
+ * AI Sidebar 服务 - 管理 AI 聊天侧边栏的生命周期
+ *
+ * 采用 Flexbox 布局方式，将 sidebar 插入到 app-root 作为第一个子元素，
+ * app-root 变为水平 flex 容器，sidebar 在左侧
+ */
+export declare class AiSidebarService {
+    private componentFactoryResolver;
+    private appRef;
+    private injector;
+    private config;
+    private sidebarComponentRef;
+    private sidebarElement;
+    private styleElement;
+    private _isVisible;
+    private readonly SIDEBAR_WIDTH;
+    /**
+     * 侧边栏是否可见
+     */
+    get sidebarVisible(): boolean;
+    constructor(componentFactoryResolver: ComponentFactoryResolver, appRef: ApplicationRef, injector: Injector, config: ConfigService);
+    /**
+     * 显示 sidebar
+     */
+    show(): void;
+    /**
+     * 隐藏 sidebar
+     */
+    hide(): void;
+    /**
+     * 切换 sidebar 显示状态
+     */
+    toggle(): void;
+    /**
+     * 获取当前显示状态
+     */
+    get visible(): boolean;
+    /**
+     * 初始化 - 应用启动时调用
+     */
+    initialize(): void;
+    /**
+     * 创建 sidebar 组件
+     *
+     * 使用固定定位方案：
+     * 1. 侧边栏 position: fixed，固定在左侧
+     * 2. 主内容区通过 margin-left 推开
+     * 这样不改变任何现有元素的 flex 布局
+     */
+    private createSidebar;
+    /**
+     * 销毁 sidebar 组件
+     */
+    private destroySidebar;
+    /**
+     * 调整 .content 元素样式 - 只处理第二个（更深层的）.content
+     */
+    private adjustContentStyles;
+    /**
+     * 注入布局 CSS - 使用 margin-left 把主内容推开
+     *
+     * 固定定位方案：侧边栏 fixed，主内容区 margin-left
+     */
+    private injectLayoutCSS;
+    /**
+     * 移除布局 CSS
+     */
+    private removeLayoutCSS;
+    /**
+     * 获取插件配置
+     */
+    private getPluginConfig;
+    /**
+     * 保存插件配置
+     */
+    private savePluginConfig;
+}

package/dist/services/chat/chat-history.service.d.ts

@@ -8,6 +8,22 @@ export interface SavedSession {
     createdAt: Date;
     updatedAt: Date;
     messageCount: number;
+    contextInfo?: {
+        tokenUsage?: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        };
+        compactionHistory?: Array<{
+            timestamp: Date;
+            type: 'prune' | 'compact' | 'truncate';
+            tokensSaved: number;
+            condenseId?: string;
+        }>;
+        hasCompression?: boolean;
+        lastCompactionAt?: Date;
+    };
 }
 /**
  * 聊天历史服务
@@ -64,4 +80,66 @@ export declare class ChatHistoryService {
     private saveToStorage;
     private generateSessionTitle;
     private trimMessages;
+    /**
+     * 更新会话的上下文信息（压缩标记支持）
+     */
+    updateContextInfo(sessionId: string, contextInfo: SavedSession['contextInfo']): void;
+    /**
+     * 导出会话（包含压缩状态）
+     */
+    exportSessionWithContext(sessionId: string): string | undefined;
+    /**
+     * 导出会话历史（包含所有压缩状态）
+     */
+    exportAllHistoryWithContext(): string;
+    /**
+     * 导入会话（包含压缩状态）
+     */
+    importSessionWithContext(data: string): void;
+    /**
+     * 清理压缩数据
+     */
+    cleanupCompressedData(sessionId?: string): void;
+    /**
+     * 获取压缩统计信息
+     */
+    getCompressionStatistics(): {
+        totalSessions: number;
+        sessionsWithCompression: number;
+        totalTokensSaved: number;
+        averageTokensSaved: number;
+        lastCompactionAt?: Date;
+        compactionHistory: Array<{
+            sessionId: string;
+            type: 'prune' | 'compact' | 'truncate';
+            timestamp: Date;
+            tokensSaved: number;
+        }>;
+    };
+    /**
+     * 记录压缩事件
+     */
+    recordCompactionEvent(sessionId: string, type: 'prune' | 'compact' | 'truncate', tokensSaved: number, condenseId?: string): void;
+    /**
+     * 检查会话是否有压缩标记
+     */
+    hasCompressionMarkers(sessionId: string): boolean;
+    /**
+     * 获取会话的压缩历史
+     */
+    getCompactionHistory(sessionId: string): Array<{
+        timestamp: Date;
+        type: 'prune' | 'compact' | 'truncate';
+        tokensSaved: number;
+        condenseId?: string;
+    }>;
+    /**
+     * 更新Token使用统计
+     */
+    updateTokenUsage(sessionId: string, tokenUsage?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    }): void;
 }

package/dist/services/chat/chat-session.service.d.ts

@@ -1,7 +1,8 @@
 import { Observable } from 'rxjs';
-import { ChatMessage } from '../../types/ai.types';
+import { ChatMessage, Checkpoint } from '../../types/ai.types';
 import { AiAssistantService } from '../core/ai-assistant.service';
 import { LoggerService } from '../core/logger.service';
+import { ChatHistoryService } from './chat-history.service';
 /**
  * 聊天会话服务
  * 管理聊天会话的生命周期、消息历史和状态
@@ -9,14 +10,17 @@ import { LoggerService } from '../core/logger.service';
 export declare class ChatSessionService {
     private aiService;
     private logger;
+    private chatHistoryService;
     private currentSessionId;
     private messagesSubject;
     private isTypingSubject;
     private errorSubject;
+    private checkpointsSubject;
     messages$: Observable<ChatMessage[]>;
     isTyping$: Observable<boolean>;
     error$: Observable<string>;
-    constructor(aiService: AiAssistantService, logger: LoggerService);
+    checkpoints$: Observable<Checkpoint[]>;
+    constructor(aiService: AiAssistantService, logger: LoggerService, chatHistoryService: ChatHistoryService);
     /**
      * 创建新会话
      */
@@ -55,4 +59,55 @@ export declare class ChatSessionService {
     importSession(sessionData: string): void;
     private generateSessionId;
     private generateMessageId;
+    /**
+     * 创建检查点
+     */
+    createCheckpoint(label?: string): Checkpoint;
+    /**
+     * 恢复检查点
+     */
+    restoreCheckpoint(checkpointId: string): void;
+    /**
+     * 删除检查点
+     */
+    deleteCheckpoint(checkpointId: string): void;
+    /**
+     * 获取指定检查点
+     */
+    getCheckpoint(checkpointId: string): Checkpoint | undefined;
+    /**
+     * 列出所有检查点
+     */
+    listCheckpoints(sessionId?: string): Checkpoint[];
+    /**
+     * 清空检查点
+     */
+    clearCheckpoints(sessionId?: string): void;
+    /**
+     * 压缩存储检查点
+     */
+    compressCheckpoint(checkpointId: string): Checkpoint;
+    /**
+     * 导出会话（包含检查点）
+     */
+    exportSessionWithCheckpoints(): string;
+    /**
+     * 导入会话（包含检查点）
+     */
+    importSessionWithCheckpoints(sessionData: string): void;
+    /**
+     * 获取检查点统计信息
+     */
+    getCheckpointStatistics(): {
+        totalCheckpoints: number;
+        averageMessagesPerCheckpoint: number;
+        totalTokenUsage: number;
+        oldestCheckpoint?: Date;
+        newestCheckpoint?: Date;
+    };
+    private generateCheckpointId;
+    private generateCheckpointSummary;
+    private truncateText;
+    private calculateInputTokens;
+    private calculateOutputTokens;
 }

package/dist/services/context/compaction.d.ts

@@ -0,0 +1,90 @@
+import { LoggerService } from '../core/logger.service';
+import { ApiMessage, ContextConfig, CompactionResult, PruneResult, TruncationResult } from '../../types/ai.types';
+/**
+ * 压缩算法实现类
+ * 提供Prune、Compact、Truncate三种压缩算法的具体实现
+ */
+export declare class Compaction {
+    private logger;
+    private config;
+    constructor(logger: LoggerService);
+    /**
+     * Prune算法 - 移除工具输出中的冗余信息
+     * 保留关键信息，移除重复、冗长或无关的内容
+     */
+    prune(messages: ApiMessage[]): Promise<PruneResult>;
+    /**
+     * Compact算法 - 使用AI生成摘要压缩上下文
+     * 将多个消息合并为一个摘要，保留核心信息
+     */
+    compact(messages: ApiMessage[]): Promise<CompactionResult>;
+    /**
+     * Truncate算法 - 滑动窗口截断
+     * 保留最近的消息，移除较早的消息
+     */
+    truncate(messages: ApiMessage[]): TruncationResult;
+    /**
+     * 智能压缩 - 根据消息类型和重要性选择最佳压缩策略
+     */
+    smartCompact(messages: ApiMessage[], tokenBudget: number): Promise<{
+        strategy: 'prune' | 'compact' | 'truncate';
+        result: PruneResult | CompactionResult | TruncationResult;
+        messages: ApiMessage[];
+    }>;
+    /**
+     * 更新配置
+     */
+    updateConfig(newConfig: Partial<ContextConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): ContextConfig;
+    /**
+     * 裁剪单条消息
+     */
+    private pruneMessage;
+    /**
+     * 裁剪字符串内容
+     */
+    private pruneStringContent;
+    /**
+     * 裁剪复杂内容（工具调用结果等）
+     */
+    private pruneComplexContent;
+    /**
+     * 应用Prune结果到消息
+     */
+    private applyPruneResult;
+    /**
+     * 格式化消息用于摘要
+     */
+    private formatMessagesForSummary;
+    /**
+     * 提取文本内容
+     */
+    private extractTextContent;
+    /**
+     * 生成摘要（集成AI API）
+     */
+    private generateSummary;
+    /**
+     * 创建简单摘要（适用于短对话）
+     */
+    private createSimpleSummary;
+    /**
+     * 创建降级摘要（当AI API不可用时）
+     */
+    private createFallbackSummary;
+    /**
+     * 创建智能摘要（简化版）
+     */
+    private createIntelligentSummary;
+    /**
+     * 计算总Token数
+     */
+    private calculateTotalTokens;
+    /**
+     * 估算Token数量
+     */
+    private estimateTokens;
+}

package/dist/services/context/manager.d.ts

@@ -0,0 +1,69 @@
+import { LoggerService } from '../core/logger.service';
+import { ChatHistoryService } from '../chat/chat-history.service';
+import { ApiMessage, ContextConfig, TokenUsage, CompactionResult, PruneResult, TruncationResult } from '../../types/ai.types';
+/**
+ * 上下文管理器 - 上下文工程的核心组件
+ * 负责Token预算管理、压缩触发决策、历史过滤等核心功能
+ */
+export declare class ContextManager {
+    private logger;
+    private chatHistoryService;
+    private config;
+    constructor(logger: LoggerService, chatHistoryService: ChatHistoryService);
+    /**
+     * 计算Token使用量
+     */
+    calculateTokenUsage(messages: ApiMessage[]): TokenUsage;
+    /**
+     * 计算使用率
+     */
+    calculateUsageRate(tokenUsage: TokenUsage): number;
+    /**
+     * 判断是否需要管理上下文
+     */
+    shouldManageContext(sessionId: string): boolean;
+    /**
+     * 统一管理上下文入口
+     */
+    manageContext(sessionId: string): Promise<{
+        compactionResult?: CompactionResult;
+        pruneResult?: PruneResult;
+        truncationResult?: TruncationResult;
+    }>;
+    /**
+     * 获取有效历史（过滤被压缩/截断的消息）
+     */
+    getEffectiveHistory(sessionId: string): ApiMessage[];
+    /**
+     * 滑动窗口截断
+     */
+    truncate(sessionId: string, messages: ApiMessage[]): Promise<TruncationResult>;
+    /**
+     * 清理孤儿标记
+     */
+    cleanupOrphanedTags(sessionId: string): number;
+    /**
+     * 更新配置
+     */
+    updateConfig(newConfig: Partial<ContextConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): ContextConfig;
+    /**
+     * 压缩（Compact）- 使用AI生成摘要
+     */
+    private compact;
+    /**
+     * 裁剪（Prune）- 移除工具输出中的冗余信息
+     */
+    private prune;
+    /**
+     * 格式化消息用于摘要
+     */
+    private formatMessagesForSummary;
+    /**
+     * 估算Token数量（简化版）
+     */
+    private estimateTokens;
+}

package/dist/services/context/memory.d.ts

@@ -0,0 +1,116 @@
+import { LoggerService } from '../core/logger.service';
+import { ApiMessage } from '../../types/ai.types';
+/**
+ * 记忆层类型
+ */
+export declare enum MemoryLayer {
+    SHORT_TERM = "short_term",
+    MID_TERM = "mid_term",
+    LONG_TERM = "long_term"
+}
+/**
+ * 记忆项接口
+ */
+export interface MemoryItem {
+    id: string;
+    layer: MemoryLayer;
+    content: string;
+    metadata: {
+        timestamp: number;
+        sessionId?: string;
+        importance: number;
+        tags?: string[];
+        source?: string;
+    };
+    accessCount: number;
+    lastAccessed: number;
+}
+/**
+ * 记忆摘要
+ */
+export interface MemorySummary {
+    id: string;
+    layer: MemoryLayer;
+    summary: string;
+    keyPoints: string[];
+    createdAt: number;
+    relatedMemories: string[];
+}
+/**
+ * 记忆统计信息
+ */
+export interface MemoryStatistics {
+    totalItems: number;
+    shortTermCount: number;
+    midTermCount: number;
+    longTermCount: number;
+    totalAccessCount: number;
+    averageImportance: number;
+    oldestMemory?: Date;
+    newestMemory?: Date;
+}
+/**
+ * 三层记忆系统
+ * 实现 Claude Code 架构的记忆管理
+ */
+export declare class Memory {
+    private logger;
+    private shortTermMemories;
+    private midTermMemories;
+    private longTermMemories;
+    private readonly MAX_SHORT_TERM_ITEMS;
+    private readonly MAX_MID_TERM_ITEMS;
+    private readonly MAX_LONG_TERM_ITEMS;
+    private readonly IMPORTANCE_THRESHOLD;
+    constructor(logger: LoggerService);
+    /**
+     * 存储记忆
+     */
+    store(content: string, layer: MemoryLayer, metadata?: Partial<MemoryItem['metadata']>): string;
+    /**
+     * 检索记忆
+     */
+    retrieve(memoryId: string): MemoryItem | undefined;
+    /**
+     * 搜索记忆
+     */
+    search(query: string, layer?: MemoryLayer): MemoryItem[];
+    /**
+     * 从消息创建记忆
+     */
+    createFromMessages(messages: ApiMessage[], layer: MemoryLayer): string[];
+    /**
+     * 生成中期记忆摘要
+     */
+    createMidTermSummary(sessionId: string): Promise<string>;
+    /**
+     * 保存到长期记忆（项目级）
+     */
+    saveToLongTerm(content: string, metadata?: Partial<MemoryItem['metadata']>): string;
+    /**
+     * 从长期记忆加载
+     */
+    loadFromLongTerm(query?: string): MemoryItem[];
+    /**
+     * 获取记忆统计
+     */
+    getStatistics(): MemoryStatistics;
+    /**
+     * 清理过期记忆
+     */
+    cleanup(): number;
+    /**
+     * 清空指定层级
+     */
+    clearLayer(layer: MemoryLayer): void;
+    /**
+     * 获取相关记忆
+     */
+    getRelatedMemories(memoryId: string): MemoryItem[];
+    private generateMemoryId;
+    private enforceLimit;
+    private generateIntelligentSummary;
+    private calculateSimilarity;
+    private saveToStorage;
+    private loadFromStorage;
+}