看得见的技术细节

Cipher 的技术架构和实现方式,每个功能都是实际可用的,不是概念演示。

Agent 工具系统

Agent 支持 Plan 和 Auto 两种执行模式。Plan 模式先生成执行计划,等你确认后再执行。Auto 模式自动调用工具链,最多 15 轮迭代循环:思考 → 执行 → 观察 → 再思考。

  • 6 个内置工具:read_file / write_file / edit_file / run_command / search_code / list_directory
  • RAG 上下文自动注入 + 项目树自动加载
  • package.json 自动解析,识别技术栈

Auto-Heal 自动修复

Agent 写完代码后的自动检测修复流程。先跑 tsc / eslint / lint / build 等验证命令,检测到错误自动修复,最多 3 轮。修复停滞时自动停止,不浪费 Tokens。

  • 自动检测项目配置:tsconfig / eslint / package.json scripts
  • 修复停滞检测:error 不再减少时停止

API 用量追踪

基于发布-订阅模式的用量追踪系统。每次 AI 请求结束后自动记录 Prompt Tokens、Completion Tokens 和费用,持久化到 localStorage + Electron Store 双存储。

  • 26+ 模型精确计价表(DeepSeek / GPT-4o / Claude / Gemini 等)
  • 基于字符数的 Tokens 近似估算,区分中英文
  • 累计统计 + 会话统计双维度,用量更新时自动通知 UI

RAG 代码搜索

基于 TF-IDF 相似度算法的引擎。建索引时按函数和类边界自动分割代码文件,搜索时用驼峰分词 + 中英同义词扩展。

  • 500+ 中英同义词对:login ↔ auth ↔ 登录 ↔ 认证
  • 30+ 文件类型支持:ts / tsx / js / py / rs / go 等
  • 文件变更自动重建索引 + import/require 依赖提取

技能系统

技能是封装好的 AI 助手配置。每个技能有自己的 Prompt、可用工具、模型参数。内置 4 个技能,支持导入导出。

  • 内置技能:Cipher Agent / 小说助手 / PPT 设计 / Excel 数据
  • 导入格式:.zip / .json / .md,导出格式:.zip / .json
  • 技能附加文件:额外 prompts / 脚本 / 配置文件

多服务商架构

7 个内置服务商预设,每个可独立启用/禁用。自定义服务商支持自定义 API URL、Key 和模型列表。一键切换默认服务商,内置连接测试功能。

  • 预设:小米 / NVIDIA NIM / DeepSeek / OpenAI / Anthropic / OpenRouter
  • 参数配置:maxTokens / temperature / topP / toolCallRounds

规则系统

全局规则跨项目通用,项目规则特定于当前项目。自动读取项目目录下的 CLAUDE.md、.cursorrules、.windsurfrules 文件。每条规则可独立启用或禁用。

IPC 通信架构

Electron 主进程和渲染进程通过 13 个 IPC 处理器通信。涵盖文件读写、终端执行、配置持久化、安全信任确认等功能。安全沙箱模式隔离进程。

  • 路径信任确认:首次打开文件夹需用户确认
  • 信任列表持久化,已信任路径自动保存

主题系统

4 种主题模式(深色 / 深蓝 / 亮色 / 跟随系统),约 50 个语义化 CSS 变量。Glassmorphism 磨砂玻璃效果通过 backdrop-filter + 半透明背景实现,主题切换 300ms 平滑过渡。

记忆系统

工作记忆追踪会话内的文件操作(新建 / 修改 / 删除),24 小时 TTL 自动过期。项目笔记跨会话持久化。记忆内容自动格式化后注入 Agent 上下文。

技术栈一览

桌面端技术栈,所有 AI 功能都在本地运行。

Electron 32
React 18
TypeScript 5
Vite
Monaco Editor
xterm.js
TailwindCSS
Framer Motion
Zustand