kurihada/ai-terminal-assistant
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
111 Commits 2 Branches 0 Tags
df811395f8c07355f1e4406bf67b8cb91623793a
Commit Graph

34 Commits

Author SHA1 Message Date
kurihada df811395f8 feat(core): 增强 General 和 Explore Agent 预设 
General Agent:
- 添加详细的 prompt 引导子代理行为
- 禁用 todo_read/todo_write（避免与父 Agent 冲突）
- 增加 maxSteps 到 20

Explore Agent:
- 支持 thoroughness 参数 (quick/medium/thorough)
- 启用只读 bash 命令（ls, tree, find, git log 等）
- 禁用写入工具和 Todo 工具
- bash 默认策略改为 deny（比 Plan 更严格）
- 添加详细的探索深度指导 prompt

Plan Agent:
- 添加 web: 'ask' 权限配置
 2025-12-15 22:01:53 +08:00
kurihada 35d87a04fb feat(core): 增强 Plan Agent 支持细粒度 bash 权限和模式切换 
- Plan Agent 细粒度 bash 权限：允许只读命令 (ls, grep, git log 等)，
  禁止危险操作 (rm, mv, git commit 等)
- 新增 plan_mode_respond 工具：结构化输出计划、进度和探索状态
- Agent.switchMode() 方法：支持 Build ↔ Plan 模式切换保留对话历史
- WebSocket mode_switch 消息：支持运行时动态切换模式
- 更新 Plan Agent prompt 引导使用 plan_mode_respond 工具
 2025-12-15 20:51:57 +08:00
kurihada ec3c7bccf9 feat(ui): 实现 Agent 模式切换和 Auto Edit 功能 
- 添加 AgentModeSelector 组件，支持 Build/Plan 模式切换
- Build 模式下显示 Auto Edit 开关，自动授权文件写入/编辑
- 扩展 useChat hook 添加会话级别的 agentMode/autoApprove 状态
- 服务端支持解析和应用 Agent 模式配置
- 权限处理器实现 auto-approve 检查（仅 write/edit，不含 delete）
 2025-12-15 19:42:51 +08:00
kurihada f09f8f2b03 fix: 修复多个问题 
- fix(core): 修复 todoManager 未初始化导致待办工具无法使用
- fix(core): 为 LSP 初始化添加 10 秒超时，防止 write_file 卡住
- fix(ui): 停止对话时保留已流式输出的内容
 2025-12-15 18:40:07 +08:00
kurihada 11d4abfc50 feat(core): 实现 Doom Loop 检测和软性 maxSteps 限制 
- 新增 doom-loop.ts: 实现 Doom Loop 检测器，检测连续 3 次相同工具调用
- 修改 agent.ts: 集成检测器，添加 onDoomLoop 回调，动态 maxSteps
- 修改 registry.ts: 默认 maxSteps 从 10 改为 50
- 更新 index.ts: 导出新模块

参考 OpenCode/OpenHands 等开源项目的多层防御策略
 2025-12-15 18:14:09 +08:00
kurihada 3fd8fd98b8 feat(ui): 优化流式输出工具调用渲染 
- 添加 tool_start/tool_end WebSocket 事件支持
- 流式消息复用 ChatMessage 组件渲染工具调用卡片
- 修复 AI SDK v5 格式兼容问题（input/output 字段）
- 修复会话恢复时 tool-result 格式错误
- 放宽 ToolState schema 中 input 字段类型为 unknown
 2025-12-15 17:35:39 +08:00
kurihada 865e0906b9 feat(ui): 实现 @ 文件提及自动补全功能 
- Core: 添加 file-index 模块，使用 ripgrep 索引文件，fuzzysort 模糊搜索
- Server: 添加 /api/files/search 端点，支持文件模糊搜索
- Server: WebSocket 消息处理中将 @filepath 转换为 ./filepath 格式
- UI: 新增 FileMenu 组件，显示文件搜索结果列表
- UI: 新增 FileMentionTag 组件，高亮显示文件提及
- UI: 新增 useFileMention hook，管理文件提及状态
- UI: ChatInput 集成 @ 触发的文件自动补全
- UI: ChatMessage 用户消息中高亮显示 @filepath
 2025-12-15 16:32:59 +08:00
kurihada 2150abde7c feat(agent): 实现流式输出取消功能 
- 添加 AbortController 管理，支持取消正在进行的请求
- Agent.chat() 新增 abortSignal 参数，传递给 streamText/generateText
- 取消时保存用户消息和 AI 已输出的部分内容
- cancelProcessing 实际调用 abort() 中止流式请求
 2025-12-15 14:21:24 +08:00
kurihada d54b9788fa fix(storage): 修复 multi-step 对话产生多个 assistant 消息问题 
- 同一轮对话的后续 assistant 消息追加 Parts 到现有消息
- 修复 AI SDK tool-call 参数字段名（input 而非 args）
- 修复 setToolCompleted/setToolError 中 discriminated union 类型访问
 2025-12-15 13:58:10 +08:00
kurihada 9f456c1029 refactor(storage): 重构消息存储为 2-message 格式 
采用 OpenCode 风格的消息存储架构：
- 只有 user 和 assistant 两种角色，移除 tool/system
- ToolPart 使用状态机模式 (pending → running → completed/error)
- 新增 toModelMessages() 转换函数用于调用 AI SDK
- 删除 message-merger.ts，存储层直接返回正确格式

主要改动：
- parts.ts: ToolState 状态机（pending/running/completed/error）
- message.ts: 移除 system role，添加 parentId 关联
- converter.ts: 新增 toModelMessages() 格式转换
- manager.ts: 重构 syncMessages/partsToModelMessages
- sessions.ts: 简化路由，直接从 Core Storage 读取
 2025-12-15 13:35:32 +08:00
kurihada eda2ccb171 feat(api): 实现消息合并 API，支持工具调用显示 
- 新增 MergedMessage、ToolCallInfo 类型定义
- 创建 message-merger.ts 消息合并工具
- 更新 sessions 路由使用合并后的消息格式
- 前端新增 ToolCallsDisplay 组件展示工具调用
- 工具调用显示状态、时长，可展开查看参数和结果
 2025-12-15 12:21:16 +08:00
kurihada e9e8bfa30a fix(storage): 修复 ToolPart args 字段缺失导致的验证错误 2025-12-15 11:30:43 +08:00
kurihada 527692ec03 refactor(storage): 采用 OpenCode 风格三层存储结构 
重构消息存储系统，从"每条消息一个文件"改为分层存储：
- Session → Message → Parts 三层结构
- 12 种 Part 类型（TextPart, ToolPart, ReasoningPart 等）
- ToolPart 状态机（pending → running → completed/error）
- 通用 Storage API（read/write/list/remove）

新增文件:
- parts.ts: Part 类型定义（Zod schema）
- message.ts: MessageInfo 类型定义
- id.ts: ID 生成器
- storage/: 分层存储实现

删除旧文件:
- storage.ts, types.ts, migration.ts

存储路径:
~/.local/share/ai-assist/
├── session/{projectId}/{sessionId}.json
├── message/{sessionId}/{messageId}.json
├── part/{messageId}/{partId}.json
└── todo/{sessionId}.json
 2025-12-15 11:16:10 +08:00
kurihada 6342a46e59 refactor(storage): 统一消息存储到 Core 层 
问题：Server 端只存储最终文本响应，工具调用的中间消息丢失。

解决方案：
- Agent.chat() 返回 ChatResult，包含完整消息链
- Server SessionManager 简化为只管理会话元数据
- 消息 API 改为从 Core Storage 读取
- 移除 Server 端的消息存储和 addMessage 方法

影响范围：
- core: Agent.chat() 返回类型变更
- server: SessionManager 接口变更，移除消息存储
- server: GET /sessions/:id/messages 从 Core 读取
- server: 移除 POST /sessions/:id/messages 端点
 2025-12-15 10:04:22 +08:00
kurihada 503e4c4ccd fix(init): 确保 Registry 在服务启动时正确初始化 
- AgentRegistry: 在构造函数中同步初始化预设 Agent
- AgentRegistry: 添加 isInitialized() 方法
- initCore(): 添加 ProviderRegistry.init() 调用
- initCore(): 添加 AgentRegistry.init() 调用

修复用户配置（Provider、Agent）重启后丢失的问题
 2025-12-14 23:40:33 +08:00
kurihada aefea715b1 feat(context): 根据模型动态设置 contextLimit 
- AgentConfig 添加 contextWindow 字段
- ProviderRegistry 添加 getModelInfo() 方法查询模型信息
- loadConfig() 从 ProviderRegistry 获取模型的 contextWindow
- Agent 构造函数使用 contextWindow 初始化压缩管理器

效果：
- Anthropic Claude: 168k (200k - 32k 输出预留)
- DeepSeek: 32k (64k - 32k 输出预留)
- 未知模型回退到默认 200k
 2025-12-14 23:34:32 +08:00
kurihada cacd9914fd fix(config): 优化配置错误提示信息 
- 未选择 provider 时提示"选择并配置模型提供商"
- 已选择 provider 但未配置 API Key 时提示配置该 provider
 2025-12-14 22:44:13 +08:00
kurihada 32064a3531 fix(config): 优雅处理 Provider 未配置错误 
- 添加 ConfigurationError 类替代 process.exit(1)
- Server 端捕获配置错误并返回友好消息
- UI 端支持 config_error 类型的 WebSocket 消息
- 服务器不再因配置缺失而崩溃
 2025-12-14 22:24:51 +08:00
kurihada c307cd3a7c refactor(agent): 将 Summary Model 改造为内置 Sub Agent 
- 扩展 AgentMode 类型添加 'internal' 模式
- 新增 summary agent preset (claude-3-5-haiku)
- AgentRegistry 添加 getInternal/listInternalAgents 方法
- CompressionManager 添加 setSummaryModelFromAgentConfig
- Agent 构造函数改用 Registry 配置初始化 Summary 模型
- 清理旧的 SummaryConfig 配置系统
- UI AgentsPanel 分离显示 System/Preset/Custom agents
- UI AgentEditor 为 internal agent 显示简化编辑界面
 2025-12-14 22:12:36 +08:00
kurihada 9e011476c8 refactor(config): 移除环境变量依赖，统一使用 Provider 配置系统 
- 移除 .env.example 文件
- 简化 resolveApiKey 函数，只从配置文件读取 API Key
- 重构 loadConfig/loadVisionConfig/loadSummaryConfig 使用 ProviderRegistry
- 更新测试以 mock Provider 系统
 2025-12-14 21:29:36 +08:00
kurihada c9d0cbce5b fix(session): 修复 getOrCreateProject 死锁问题 
读写锁嵌套导致死锁：在持有读锁的情况下尝试获取写锁。
改为先释放读锁再获取写锁，并使用双重检查模式防止竞态条件。
 2025-12-14 20:44:55 +08:00
kurihada 70a9a154a4 feat(context): 添加上下文压缩 API 和 UI 组件 
Server API:
- 扩展 Agent Adapter 接口添加压缩相关方法
- 新增 context.ts 路由 (GET /sessions/:id/context, POST /sessions/:id/compress)
- 扩展 config.ts 添加摘要模型配置接口 (GET/PUT /config/summary)

UI 组件:
- 新增 ContextUsage 组件显示上下文使用情况
- 扩展 ConfigPanel 添加摘要模型配置区域
- 添加 API 客户端方法和类型定义

Web 集成:
- 在 Chat 页面头部集成 ContextUsage 紧凑模式显示
 2025-12-14 20:33:51 +08:00
kurihada f54f24b079 feat(context): 优化对话压缩系统 
- 添加独立摘要模型配置支持（SUMMARY_PROVIDER/MODEL/API_KEY/BASE_URL）
- 添加 CompressionStatus 枚举和 DetailedCompressionResult 详细返回类型
- 实现压缩失败检测（空摘要、token膨胀）
- 添加首条 user-assistant 对保护，确保上下文连贯性
- CompressionManager 支持独立摘要模型（优先使用小模型降低成本）
- Agent 自动压缩时显示详细状态信息
- 更新相关测试用例
 2025-12-13 11:13:20 +08:00
kurihada 9ff2934089 refactor(session): 升级存储系统架构 
- 添加读写锁机制防止并发写入冲突
- 实现数据迁移框架支持版本化升级
- 分层存储结构：项目/会话/消息独立存储
- 使用 Git root commit hash 作为稳定项目 ID
- 增量消息同步避免重复写入
- 每条消息独立文件，按序号命名 (0001.json, 0002.json)
 2025-12-13 10:41:36 +08:00
kurihada 6ec6fe2f9f feat(provider): 添加独立的 Provider 模块管理模型提供商 
实现可扩展的 Provider 系统，支持动态注册自定义提供商：

Core 模块 (packages/core/src/provider/):
- types.ts: Provider 相关类型定义
- builtin/: 内置提供商 (Anthropic, OpenAI, DeepSeek)
- registry.ts: ProviderRegistry 单例类
- config.ts: 配置持久化 (~/.ai-terminal-assistant/providers.json)
- utils.ts: 连接测试等工具函数

Server API (packages/server/src/routes/providers.ts):
- GET/POST/PUT/DELETE /providers 提供商管理
- POST /providers/:id/test 连接测试
- 自定义模型管理接口

Frontend (packages/ui/):
- ProvidersPanel 组件用于管理提供商
- API client 函数和类型定义

主要功能：
- 支持动态注册 OpenAI 兼容服务 (Ollama, vLLM 等)
- 每个提供商独立的 API Key 配置
- 预设模型列表 + 自定义模型输入
- 连接测试验证
 2025-12-13 01:50:27 +08:00
kurihada 1d69fd876d feat(permission): 实现 WebSocket 权限确认机制 
重构权限系统，将终端 UI 代码从 core 模块移除，实现基于 WebSocket 的权限确认流程：

Core 模块清理：
- 删除 permission/prompt.ts 和 file-prompt.ts（终端交互）
- 删除 diff.ts 中的 chalk 渲染函数
- 删除 config.ts 中的 inquirer 交互
- 移除 chalk 依赖

Server 权限处理：
- 新增 permission/handler.ts，实现 WebSocket 权限请求/响应
- 更新 agent/adapter.ts 设置权限回调
- 更新 ws.ts 处理 permission_response 消息

Web 权限组件：
- 新增 PermissionDialog 组件，显示权限请求详情和 Diff
- 更新 useChat hook 管理权限状态
- 更新 Chat 页面集成权限弹窗
 2025-12-13 01:09:35 +08:00
kurihada 5d4afecd48 refactor(core): 移除 UI 交互层，保持 core 为纯能力模块 
- 删除 terminal.ts 及其测试（UI 交互应属于 cli 包）
- 清理 index.ts 中的 CLI 入口代码
- 合并 lib.ts 导出到 index.ts
- 移除 commander、inquirer 依赖
- 更新 package.json 导出配置
 2025-12-13 00:42:07 +08:00
kurihada cb554c65b4 feat(checkpoint): 添加 Checkpoint 可视化管理功能 
Core 层增强:
- 添加 safety.ts: 7点安全检查机制
- 添加 session-tracker.ts: 会话级检查点跟踪
- 添加 lock.ts: 并发控制文件锁
- 添加 lfs.ts: Git LFS 大文件支持
- 添加 path-validator.ts: 路径验证
- 添加 commit-message.ts: 智能提交消息生成
- 增强 manager.ts: 支持三种恢复模式、unrevert 撤销回滚

Server 层:
- 添加 checkpoints.ts: 16个 REST API 端点
  - GET/POST /checkpoints: 列表/创建检查点
  - GET/DELETE /checkpoints/🆔 获取/删除检查点
  - GET /checkpoints/:id/diff: 获取差异
  - POST /checkpoints/:id/restore: 恢复到检查点
  - POST /checkpoints/unrevert: 撤销回滚
  - GET /checkpoints/:id/safety-check: 安全检查

UI 层:
- 添加 CheckpointPanel.tsx: 检查点列表面板
- 添加 CheckpointDiffViewer.tsx: 差异查看器
- 添加 RestoreDialog.tsx: 恢复确认对话框
- 添加 16 个 API 客户端函数
- 添加完整的 TypeScript 类型定义

Web/Desktop 集成:
- 添加 History 按钮到工具栏
- 集成 CheckpointPanel 组件
 2025-12-12 22:52:27 +08:00
kurihada f0385ef221 feat(commands): 实现命令 CRUD 完整功能 
Core:
- 新增 CommandManager 类，支持创建、更新、删除命令
- 验证命令名称防止路径遍历攻击
- 自动生成 Markdown 文件（含 YAML frontmatter）
- 内置命令保护（不可修改/删除）

Server:
- POST /api/commands - 创建命令
- GET /api/commands/:name/content - 获取命令完整内容
- PUT /api/commands/:name - 更新命令
- DELETE /api/commands/:name - 删除命令

UI:
- 新增 createCommand、updateCommand、deleteCommand、getCommandContent 函数
- 新增 CreateCommandInput、UpdateCommandInput、CommandContent 类型
 2025-12-12 18:51:38 +08:00
kurihada c25faa13b5 fix(core): 导出命令系统函数供 Server 使用 2025-12-12 18:29:24 +08:00
kurihada 563224fa73 docs: 添加中文文档 2025-12-12 15:31:38 +08:00
kurihada 40afa10ed9 feat(server): 添加 session 持久化支持 
- 复用 core 包的 SessionStorage 实现文件持久化
- sessions 保存到 ~/.local/share/ai-assist/sessions/
- 服务启动时自动加载已持久化的 sessions
- create/addMessage/delete 操作自动同步到文件
 2025-12-12 15:27:16 +08:00
kurihada b17649930b docs: 更新项目文档 2025-12-12 14:28:34 +08:00
kurihada 5e32375f0e feat: 重构为 Monorepo 架构并实现 HTTP Server 
架构变更:
- 采用 pnpm workspaces 实现 Monorepo 结构
- 将现有代码迁移到 packages/core
- 新增 packages/server HTTP 服务层

Server 功能:
- REST API: 会话管理、工具管理、配置管理
- WebSocket: 实时双向通信支持
- SSE: 服务端事件推送
- Hono + Bun 作为运行时

API 端点:
- GET/POST /api/sessions - 会话 CRUD
- GET/POST /api/sessions/:id/messages - 消息管理
- GET /api/sessions/:id/events - SSE 事件流
- WS /api/ws/:sessionId - WebSocket 连接
- GET/POST /api/tools - 工具管理
- GET/PUT /api/config - 配置管理
 2025-12-12 10:42:20 +08:00