DriFox 飘狐 — 轻量化 AI 桌面对话助手 CLI 版

These details have not been verified by PyPI

Project description

logo

Python License Stars Downloads Last Commit

DriFox 飘狐 — 一个轻量化 AI 桌面对话助手

设计理念

不做大而全的 IDE。 DriFox 只是一个对话框 —— 随时调出，随意提问，随性分支。

软件介绍

核心特性

特性	说明
🎯 极简界面	仅一个悬浮置顶对话框，随开随用
🔀 分支会话	问题分叉，多个窗口并行探索不同答案，互不干扰
🔄 会话并行	多窗口并行处理不同任务，会话管理+历史追踪
🌲 Git Worktree	直接管理 git worktree，并行开发互不干扰
🧠 长记忆	越用越懂你的偏好、习惯、禁忌
📊 上下文压缩	智能 Token 预算控制，长对话自动摘要压缩
📈 交互式图表	支持 ````echarts` 代码块渲染交互式 ECharts 图表，可缩放、悬停、高亮
☁️ 词云会话总结	`/wordcloud` 一键将当前会话总结为交互式 ECharts 词云，可视化提取关键术语
🖼️ 图片渲染	Markdown 图片、HTML `<img>` 标签原生渲染，本地图片自动解析为绝对路径
🔗 SubAgent DAG	有向无环图编排子智能体，自动拓扑排序，并行执行无依赖节点，实时可视化
🤖 多智能体并行	20+ 子智能体同时执行，独立 LLM 循环+工具环境，实时状态监控
📎 Gitee 图床	本地文件自动上传至 Gitee 仓库返回公开链接，Gateway 消息图片直发
🧩 插件系统	革命性插件架构，33+ 即装即用插件，颠覆原有系统能力边界
🔌 Hook 系统	可扩展的事件钩子系统，支持在特定事件触发自定义脚本
🌐 MCP 系统	Model Context Protocol 支持，连接任意 MCP Server 扩展工具能力
🧩 Skill 系统	支持自动检测系统 Agent、Skill 模块，自带有 20+ 常用技能
🛠️ 代码工具	35+ 工具：读、写、搜索、执行、diff、ECharts 图表、Gitee 上传等
🔌 多模型	OpenAI / Claude / DeepSeek / MiniMax / 通义等随时切换
🛡️ 穿透模式	悬浮窗口可穿透点击，不阻断其他应用
🚀 自动更新	自动检查新版本，随时保持更新

快速开始

环境要求

Python 3.14+
PyQt5 >= 5.15.0

安装（推荐 uv）

git clone https://github.com/martin98-afk/DriFox.git
cd DriFox

# 安装 uv（如果尚未安装）
pip install uv  # 或参考 https://docs.astral.sh/uv/#installation

# 创建虚拟环境并安装核心依赖
uv sync

# 如需安装可选组件，选择以下之一：
uv sync --group gateway   # 通讯平台（钉钉/Telegram/Discord/飞书/Slack）
uv sync --group dev       # 开发工具（pytest/ruff/mypy/pyinstaller）
uv sync --all-groups      # 全部安装

可选依赖组说明：

gateway — 多平台通讯适配（钉钉、Telegram、Discord、Slack、飞书）

dev — 开发与构建工具

不指定组则只装核心依赖，功能不受影响。

运行

python main.py

核心功能详解

会话并行

DriFox 支持多窗口并行处理不同任务，让你可以同时探索多个解决方案。

会话并行

功能	说明
分支会话	从当前对话分叉，创建独立的新窗口
会话管理	查看最近会话和最活跃会话，方便任务切换
并行探索	多个窗口同时运行，互不干扰
待办追踪	内置待办清单功能，跟踪任务进度

Git Worktree 并行开发

DriFox 内置 git worktree 管理，让你能在不污染主仓库代码的情况下，自由切换分支进行开发。

Git Worktree

功能	说明
🌲 分支树展示	自动检测 git 仓库，以树状列表展示所有 worktree 分支
🔵 当前分支标识	蓝点标识当前活跃分支，一目了然
🔄 一键切换	点击「切换」立即将工作目录指向对应 worktree
➕ 新建分支	直接从 UI 创建新分支 + worktree，自动切换到新分支
🗑 安全删除	删除 worktree 时自动同步删除对应分支（`git branch -D`）
🏠 根目录固定	原始仓库文件夹始终显示为「根目录」，worktree 切换不影响
🧠 AI 感知 worktree	提示词自动注入当前 worktree 上下文，AI 清楚知道在哪个分支工作

使用场景：

同时修复多个 bug，每个 bug 一个独立 worktree
并行开发多个 feature，互不干扰
在主分支稳住的情况下，安全试错新思路

示例流程：

1. 添加项目文件夹到关键文档，设为工作目录
2. 展开 worktree 树 → 点击「＋ 新建 worktree」
3. 输入分支名 drifox/xxx → 自动创建并切换
4. AI 在 worktree 上编辑代码，不影响主仓库
5. 完成工作后「切换」回主分支，或「✕」删除 worktree

代码差异对比

DriFox 内置可视化的代码差异对比工具，让你可以清晰看到 AI 助手的修改内容。

代码差异对比

功能	说明
文件列表	侧边栏显示所有已修改的文件及其增减行数
差异高亮	新增内容绿色显示，删除内容红色显示
多文件对比	支持同时查看多个文件的修改
统计摘要	显示总体的代码增减统计

上下文压缩

DriFox 内置智能的上下文压缩系统，确保长对话不会超出 Token 限制。

上下文压缩

机制	说明
Token 预算控制	实时显示当前上下文占用和预算上限
智能压缩策略	尾保留策略 + 工具调用配对保护
LLM 摘要	使用专门的 compaction agent 生成摘要
可视化显示	通过环形图直观显示占用比例

压缩触发条件：

Token 占用超过预算阈值（默认 80%）
工具迭代中自动增量压缩
手动触发压缩（通过指令）

交互式图表渲染

DriFox 的消息卡片原生支持 ECharts 交互式图表 渲染。当 AI 输出 ````echarts` 代码块时，会直接渲染为可交互的图表，支持缩放、悬停、高亮、拖拽等操作。

高级MD样式显示

特性	说明
🎨 ECharts 代码块	`echarts {json}` 自动渲染为交互式图表
🔄 暗色主题	内置 ECharts dark 主题，与界面风格统一
🖱️ 交互操作	缩放、拖拽、悬停 Tooltip、邻接高亮
📊 图表类型	折线图、柱状图、饼图、散点图、关系图(力导向)、雷达图等
🔗 DAG 工作流图	SubAgent DAG 执行时自动生成力导向节点图，实时反映执行状态
📐 自适应布局	ResizeObserver 自动适配窗口大小变化
🌏 中文支持	TextDecoder 解码确保中文标签正常显示

使用方式（AI 自动输出）：

组件配置结果如下：
```echarts
{
  "title": { "text": "性能对比", "left": "center" },
  "xAxis": { "data": ["A", "B", "C"] },
  "yAxis": {},
  "series": [{ "type": "bar", "data": [120, 200, 150] }]
}

图表将自动渲染为交互式柱状图/折线图/关系图等。

应用场景：

DAG 工作流可视化：子智能体节点图实时展示执行状态（待执行/运行中/已完成/失败/跳过）
Token 用量分析：上下文压缩前后的用量对比
代码统计分析：文件变更行数、模块覆盖率等
数据对比：AI 生成各类统计图表的即时展示

词云会话总结

DriFox 内置 /wordcloud 命令，一键将当前会话内容总结为交互式 ECharts 词云，可视化呈现关键术语与主题焦点。

词云会话总结

特性	说明
🎯 一键生成	输入 `/wordcloud` 即可将整段对话提炼为词云，无需手动提取
🎨 焦点提取	支持可选参数指定提取方向，如 `/wordcloud 技术栈`、`/wordcloud 需求点`
📊 ECharts 词云	基于 echarts-wordcloud 渲染，支持缩放、悬停、高亮交互
🏷️ 品牌配色	DriFox 五色品牌色系（靛蓝/紫/粉/琥珀/翠绿），按权重自动分配
🔄 自动分析	自动提取 15-30 个关键术语，按重要程度分配字号和颜色
🧠 深度理解	结合会话上下文分析，不止统计词频，更理解语义重要性

使用方式：

/wordcloud                  # 自动提取全量关键术语
/wordcloud 技术栈           # 聚焦技术栈相关术语
/wordcloud 问题点           # 聚焦问题与瓶颈
/wordcloud 需求             # 聚焦用户需求与待办

技术细节：

基于 echarts-wordCloud 扩展实现，配置通过 ````echarts` 代码块输出
所有颜色通过静态 data[i].textStyle.color 指定，规避 JSON.parse 无法处理 JS 函数的问题
支持 shape（circle/polar）、sizeRange、rotationRange、gridSize 等布局参数
词云使用 DriFox 品牌色系按权重分层着色

图片与富媒体显示

DriFox 的消息卡片支持丰富的图片与富媒体渲染能力，让 AI 回复中的图片内容可以直接展示。

特性	说明
📷 Markdown 图片	支持 `![alt](path)` 语法，本地图片自动解析为绝对路径
🖼️ HTML 图片	`<img>` 标签原生渲染，支持相对/绝对路径、HTTP/HTTPS/Data URI
🔗 路径自动解析	相对路径自动转为 `file:///` 绝对路径，确保 QWebEngineView 正常加载
🌐 远程图片	支持 HTTP/HTTPS 网络图片直链加载
🎨 背景自定义	支持从主题配置加载背景图片（PNG/JPG/WebP）
🧩 多模态支持	上下文压缩智能处理历史图片，避免重复发送 base64 大负载
📎 Gateway 图片发送	消息网关模式下自动提取 Markdown 图片并发送到目标平台（钉钉/飞书/Discord 等）

支持的图片格式：

PNG, JPG/JPEG, GIF, WebP, BMP

工作机制：

AI 回复包含 ![图](images/chart.png)
    → backend._extract_markdown_images() 提取图片路径
    → _resolve_image_src() 将相对路径转为 file:/// 绝对路径
    → QWebEngineView 加载渲染

Gateway 模式下：
    → 提取本地图片 → adapter.send_image() → 平台原生发送

子智能体 DAG 工作流

DriFox 支持通过 DAG（有向无环图） 编排多个子智能体，自动拓扑排序，并行执行无依赖节点，并实时生成可视化工作流图。

SubAgent DAG

特性	说明
🔗 DAG 编排	定义 nodes + edges，支持 Pipeline / Fan-out / Hybrid 三种拓扑模式
🔄 自动拓扑排序	入度为 0 的节点自动并行启动，完成后级联触发下游
🧠 结果自动注入	下游节点 context 中自动注入所有上游节点的执行结果
⚡ 并行执行	无依赖关系的节点同时运行，互不干扰
🎯 智能体自动匹配	按任务类型描述自动选择合适的子智能体
📊 实时可视化	ECharts 力导向图实时展示节点状态（颜色编码）
🛡️ 环检测	自动检测环路，防止死循环
❌ 级联失败	上游失败 → 下游自动 skip，不浪费算力
🔍 结果追溯	每个节点独立可查询，通过 subagent_status 获取详细日志

状态颜色编码：

状态	颜色	说明
⏳ pending	黄色	等待执行
🔵 running	蓝色	正在执行中
✅ completed	绿色	执行成功完成
❌ failed	红色	执行失败
⏭️ skipped	灰色	因上游失败自动跳过

支持的 DAG 拓扑模式：

模式	说明	适用场景
Pipeline	严格的串行链	A → B → C，依赖关系明确
Fan-out	先并行再汇聚	多路探索 → 汇总分析
Hybrid	分支 + 汇合点混合	复杂任务：分析 → 多路实现 → 审查汇总

执行流程：

1. AI 分析任务 → 标记依赖 → 设计拓扑
2. 调用 subagent_dag(nodes=[...], edges=[...])
3. SubAgentManager 验证 DAG（节点存在性 + 环检测）
4. 入度为 0 的节点并行启动（独立 QThread + LLM 调用 + 工具环境）
5. 节点完成后自动更新 ECharts 节点图状态
6. 级联检查下游 → 入度为 0 时启动
7. 全部完成 → 清理状态 → 汇总结果

示例：

# AI 自动生成 DAG 调用
subagent_dag(
    nodes=[
        {"id": "plan", "agent": "plan", "description": "分析需求制定方案"},
        {"id": "explore_1", "agent": "explore", "description": "研究模块A"},
        {"id": "explore_2", "agent": "explore", "description": "研究模块B"},
        {"id": "build", "agent": "build", "description": "编码实现"},
        {"id": "review", "agent": "code-reviewer", "description": "代码审查"},
    ],
    edges=[
        {"from": "plan", "to": "explore_1"},
        {"from": "plan", "to": "explore_2"},
        {"from": "explore_1", "to": "build"},
        {"from": "explore_2", "to": "build"},
        {"from": "build", "to": "review"},
    ]
)

Hook 系统

DriFox 支持通过可视化界面配置和管理 Hook 事件钩子。

Hook配置

支持的事件类型

事件	触发时机
SessionStart	新会话启动时
PreUserMessage	用户消息发送前
PostUserMessage	用户消息发送后
PreAssistantMessage	AI 助手回复前
PreToolUse	工具执行前（可 BLOCK）
PostToolUse	工具执行后

Hook 配置

通过设置界面可视化配置 Hook
支持启用/禁用单个 Hook
支持自定义工作目录和环境变量
支持输出结构化显示
支持三种类型：command / http / python function

决策控制

Hook 可通过以下方式控制流程：

Exit code 2 → BLOCK（跳过工具执行）
JSON 输出 {"decision": "block"} → BLOCK
JSON 输出 {"decision": "continue"} → 继续

MCP 系统

DriFox 支持通过 Model Context Protocol (MCP) 扩展 AI 工具能力，可连接任意 MCP Server 并直接调用其提供的工具。

MCP配置

支持的服务器类型

类型	说明
stdio	通过标准输入/输出通信，适用于本地命令行工具（如 `npx @modelcontextprotocol/server-filesystem`）
sse	通过 Server-Sent Events 通信，适用于 HTTP 服务器
http	通过 Streamable HTTP 通信，适用于现代 MCP HTTP 端点

MCP 工具使用

配置好 MCP Server 后，工具会自动出现在 AI 的可用工具列表中
MCP 工具名格式：mcp__{server_name}__{tool_name}，如 mcp__github__create_issue
连接/断开服务器无需重启软件，配置变更即时生效
多窗口共享同一个 MCP 连接池，高效利用系统资源

常用 MCP Server 推荐

# 文件系统
npx -y @modelcontextprotocol/server-filesystem /path/to/directory

# GitHub API
npx -y @modelcontextprotocol/server-github

# Playwright 浏览器自动化
npx -y @modelcontextprotocol/server-playwright

# PostgreSQL 数据库
npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# Google Maps
npx -y @modelcontextprotocol/server-google-maps

权限控制

所有 MCP 工具默认需要用户确认（ask），可在设置中调整权限规则。

插件系统

DriFox 的 插件系统（Plugin System） 是其能力扩展的核心基石，从根本上颠覆了原生系统的功能边界。插件架构将命令、智能体、技能、主题、Hooks、MCP 配置等所有扩展能力统一纳入插件化治理，实现"即装即用、热插拔、可组合"。

架构总览

项目根目录/
├── plugins/
│   └── system/              # 系统内置插件（打包在 exe 中）
│       ├── .drifox-plugin/
│       │   └── plugin.json   # 插件清单（声明组件）
│       ├── commands/         # 系统命令（/explore, /plan, /dag 等）
│       ├── agents/           # 系统智能体（explore, build, review 等）
│       ├── skills/           # 系统技能（brainstorming, tdd 等）
│       ├── themes/           # 系统主题
│       ├── hooks/            # 系统 Hooks
│       └── .mcp.json         # 默认 MCP 配置
│
├── .drifox/
│   └── plugins/              # 用户安装的第三方插件（33+ 个）
│       ├── superclaude/      # 18 个专业子智能体（架构师/审计师等）
│       ├── feature-dev/      # 功能开发全流程（code-architect/explorer）
│       ├── code-review/      # 代码审查增强
│       ├── code-simplifier/  # 代码简化重构
│       ├── hookify/          # 行为钩子系统
│       ├── pyright-lsp/      # Python 语言服务器
│       ├── rust-analyzer-lsp/# Rust 语言服务器
│       ├── github/           # GitHub MCP 集成
│       ├── playwright/       # 浏览器自动化 MCP
│       ├── security-guidance/# 安全审计指导
│       ├── user-custom/      # 用户自定义配置（MCP/Hooks）
│       └── ...               # 33+ 插件持续增长

核心机制

机制	说明
🧩 统一插件化	命令、Agent、Skill、主题、Hook、MCP 全部以插件形式管理，系统不与任何组件紧耦合
📦 双源发现	扫描 `plugins/system/`（系统）和 `.drifox/plugins/`（用户），用户插件自动覆盖同名系统插件
🔖 清单驱动	每个插件含 `.drifox-plugin/plugin.json`，声明含有的组件类型
🔄 热插拔	启用/禁用插件无需重启，运行时 `rescan()` 检测新增/移除，各子系统自动重载
🏷️ 命名空间隔离	用户插件添加命名空间前缀（如 `/my-plugin:command`），避免冲突
🧬 兼容 Claude	兼容 `.claude-plugin/plugin.json` 格式，无缝迁移现有生态插件
⚙️ MCP 配置合并	多个插件各自的 `.mcp.json` 自动合并去重，同名策略高阶覆盖低阶

插件生命周期

发现 (scan_plugins) → 注册 (PluginInfo) → 启用 (enable_plugin)
    → 各子系统查询 (get_plugin_dirs) → 运行时重扫 (rescan) → 禁用 (disable_plugin)

初始化时：PluginManager 扫描系统 + 用户插件目录，构建插件映射表
运行时重扫：检测新增/移除的插件目录，rescan() 返回 change set
热重载：启用/禁用插件立即反映到命令列表、Agent 列表、MCP 配置等

插件能做什么

组件	说明	示例
commands/	自定义命令，`/xxx` 形式触发	`/explore`、`/plan`、`/dag`、`/wordcloud`
agents/	新增子智能体角色	`architecture-critic`、`security-auditor`、`deep-research`
skills/	安装技能模块	`@brainstorming`、`@tdd`、`@diagnose`
themes/	主题样式文件	深色主题、自定义配色
hooks/	事件钩子脚本	SessionStart、PreToolUse 等 6 种事件
.mcp.json	MCP 服务器配置	GitHub、Playwright、数据库等

已安装插件精选（33+）

语言服务器类：

插件	说明
pyright-lsp	Python 类型检查与代码分析
rust-analyzer-lsp	Rust 语言服务器
jdtls-lsp	Java 语言服务器
typescript-lsp	TypeScript/JavaScript 语言服务器
gopls-lsp	Go 语言服务器
csharp-lsp	C# 语言服务器
kotlin-lsp	Kotlin 语言服务器
ruby-lsp	Ruby 语言服务器
php-lsp	PHP 语言服务器
lua-lsp	Lua 语言服务器
clangd-lsp	C/C++ 语言服务器

开发增强类：

插件	说明
superclaude	18 个专业子智能体：backend-architect、frontend-architect、deep-research-agent、security-engineer、performance-engineer、quality-engineer、refactoring-expert、pm-agent、root-cause-analyst、devops-architect、system-architect、learning-guide、python-expert、security-auditor、technical-writer、socratic-mentor、requirements-analyst、code-reviewer
feature-dev	功能开发全流程：code-architect（架构设计）、code-explorer（代码探索）、code-reviewer（审查）
code-review	代码审查增强（commands + hooks）
code-simplifier	专注于代码简化和重构的智能体
code-modernization	代码现代化：architecture-critic、legacy-analyst、security-auditor、business-rules-extractor、test-engineer
hookify	可视化行为钩子编辑器，分析对话→自动生成 Hook
security-guidance	安全编码指导与 OWASP 检查
commit-commands	Git 提交辅助命令
mcp-server-dev	MCP 服务器开发工具包
mcp-tunnels	MCP 隧道连接管理
plugin-dev	插件开发脚手架（agents + commands + skills）
skill-creator	技能创建向导
session-report	会话报告生成技能
ralph-loop	自定义执行循环模式
playground/sandbox	实验性功能沙盒

MCP 集成类：

插件	说明
github	GitHub API MCP 服务器
playwright	浏览器自动化 MCP 服务器

工作原理

用户安装插件 → PluginManager 扫描发现
    → 解析 plugin.json → 注册组件路径
    → 各子系统按需查询：
        ├── CommandManager.get_command_files() → 加载所有插件的命令
        ├── AgentManager 扫描 agents/ → 注册新的子智能体
        ├── SkillManager 扫描 skills/ → 技能可被 @技能名 触发
        ├── ThemeManager 扫描 themes/ → 新增主题选项
        ├── HookManager 加载 hooks/ → 事件触发
        └── MCP 配置合并 → 所有 .mcp.json 合并为一个列表

命名空间规则：

系统插件命令：  /explore, /plan, /dag         （短名称）
用户插件命令：  /my-plugin:custom-command      （命名空间前缀，避免冲突）
用户智能体：    自动追加命名空间到描述中
用户技能：      通过 @技能名 触发，同名时用户覆盖系统

插件与技能的关系：

插件（Plugin） 是容器，可以包含命令、Agent、技能、主题、Hooks、MCP 配置
技能（Skill） 是插件的一种组件类型，存放在 skills/ 目录下

浮动窗口特性

特性	说明
穿透模式	鼠标可穿透窗口到达下层应用
透明度调节	0-100% 可调
锁定按钮	在穿透模式下仍可交互的独立控制点

核心架构

┌─────────────────────────────────────────────────────────────────┐
│                       DriFox 架构                               │
├─────────────────────────────────────────────────────────────────┤
│  UI 层                                                          │
│  ├── ToolPopupDialog – 浮动窗口容器（穿透/透明）                │
│  ├── OpenAIChatToolWindow – 主聊天窗口                          │
│  ├── MessageCard – 消息卡片渲染（Markdown/代码高亮/ECharts/图片)│
│  ├── DiffViewer (QWebEngineView) – 代码差异对比视图             │
│  ├── SegmentWidget – 分段任务窗口                               │
│  ├── SubAgentCompactFloatingWidget – 子智能体运行状态悬浮框     │
│  ├── HookSettingCard – Hook 设置卡片                            │
│  ├── MCPListSettingCard – MCP Server 配置卡片                   │
│  ├── ContextUsageRing – 上下文用量环形图                        │
│  ├── CodingPlanRing – 套餐用量三层环图                          │
│  └── BottomInputArea – 底部输入区                              │
├─────────────────────────────────────────────────────────────────┤
│  渲染层                                                         │
│  ├── render_helpers – 工具块 HTML 渲染（参数表格/diff/ECharts）│
│  ├── message_content – 消息内容格式化与 echarts 字段序列化      │
│  ├── diff_viewer – Git 风格差异 HTML 生成器                     │
│  ├── _resolve_image_src – 图片相对路径→绝对路径自动解析         │
│  └── ECharts 5 (CDN) – 交互式图表（DAG节点图/统计图）          │
├─────────────────────────────────────────────────────────────────┤
│  引擎层                                                         │
│  ├── ChatEngine – 对话上下文组装与 LLM 调用                     │
│  ├── ContextBuilder – 消息规范化与系统提示注入                 │
│  ├── ToolExecutor – 工具执行（文件/终端/网络/子智能体/DAG）    │
│  ├── AgentManager – Agent 定义加载与切换（含插件扩展）         │
│  ├── PluginManager（单例）– 插件发现/热插拔/资源查询           │
│  │   ├── scan_plugins – 系统+用户双源扫描                     │
│  │   ├── rescan – 运行时热重载，检测新增/移除                   │
│  │   ├── get_plugin_dirs – 向各子系统提供组件路径               │
│  │   ├── get_mcp_servers – 多插件 MCP 配置合并                 │
│  │   └── enable/disable – 插件启用/禁用持久化                  │
│  ├── HistoryCompactor – 上下文压缩（含图片多模态处理）         │
│  ├── SubAgentManager – 子智能体 DAG 编排与执行引擎              │
│  │   ├── execute_dag – DAG 验证+拓扑排序+并行启动              │
│  │   ├── SubAgentExecutor – 单子智能体 QThread 执行器          │
│  │   └── _build_dag_echarts_json – DAG 节点图生成              │
│  ├── HookManager – Hook 生命周期管理与事件触发                  │
│  └── Gateway – 多平台消息网关（含图片发送）                    │
├─────────────────────────────────────────────────────────────────┤
│  存储层                                                         │
│  ├── SessionManager – 会话管理                                 │
│  ├── MemoryManager – 长期记忆（SQLite）                        │
│  ├── HistoryManager – 归档与检索                               │
│  ├── SubAgentLogRepository – 子智能体日志持久化                │
│  └── SessionStore – SQLite 持久化                              │
└─────────────────────────────────────────────────────────────────┘

Agent 系统

采用 Primary / Subagent / Hidden 三层设计，通过 Markdown + YAML frontmatter 定义。Agent 可通过 DAG 工作流 编排，自动拓扑排序、并行执行、结果注入。

类型	Agent	说明
Primary	`plan`	任务规划与分解（只读）
Primary	`build`	代码构建（全工具权限）
Primary	`code-reviewer`	代码审查
Subagent	`explore`	代码库探索
Subagent	`general`	通用任务并行执行
Subagent	`architecture-critic`	架构评审（反向验证）
Subagent	`security-auditor`	安全审计（OWASP）
Subagent	`test-engineer`	测试用例编写
Subagent	`legacy-analyst`	遗留代码分析
Subagent	`business-rules-extractor`	业务规则提取
Subagent	`root-cause-analyst`	根因分析
Subagent	`code-simplifier`	代码简化重构
Subagent	`deep-research`	深度研究分析
Subagent	`backend-architect`	后端架构设计
Subagent	`frontend-architect`	前端架构设计
Hidden	`summary`	信息总结
Hidden	`compaction`	上下文压缩
Hidden	`title`	会话标题生成
Hidden	`auto_loop`	自动循环模式

Agent 定义示例

---
name: build
mode: all
temperature: 0.3
permission:
  "*": allow
---

# Role
你是一个专业的 coding builder...

工具系统（35+）

内置工具

类别	工具
文件	read, write, edit, multi_edit, patch, grep, glob, list, diff, upload_file
执行	bash, bg_start, bg_stop, bg_logs, bg_list
网络	webfetch, websearch
代码	get_diagnostics
记忆	memory_save, memory_search, memory_list
任务	todowrite, todoread, task, task_batch, task_wait, skill, list_skills
子智能体	subagent_para（并行分发）, subagent_dag（DAG 工作流）, subagent_status（状态查询）
MCP	`mcp__server__tool` — 连接 MCP Server 后自动出现
其他	scan_repo, stage_files, question, read_project_note, edit_project_note

Skills 系统

Skills 是扩展 AI 能力的可安装模块，每个 Skill 包含 SKILL.md 定义工作流程。Skill 可作为插件组件，由插件系统的 skills/ 目录提供；也支持通过 .drifox/skills/<name>/ 直接安装。

内置 Skills (20+)

Skill	功能	触发条件
brainstorming	头脑风暴与创意发散	用户表达创意需求
caveman	极简压缩沟通（减少75% token）	用户说 "caveman mode"
diagnose	硬 bug 与性能回归诊断	用户报告 bug
find-skills	发现和安装新技能	用户询问如何做某事
tdd	测试驱动开发（红-绿-重构）	用户要求 TDD 开发
to-issues	将计划转换为 Issue 清单	用户需要拆解任务
write-a-skill	创建新的 Skill	用户要创建技能
writing-plans	计划文档编写	用户有需求要规划
git-commit	智能 git 提交	用户要求提交代码
grill-me	挑战性提问评审	用户需要挑战性反馈
grill-with-docs	基于文档的问答评审	用户提供文档审查
triage	任务分类与优先级排序	用户需要任务分诊
improve-codebase-architecture	代码架构改进	用户要重构代码
setup-matt-pocock-skills	Matt Pocock 学习路径	用户想学习技能
minimax-image-understanding	MiniMax 图片理解	用户发送截图
zoom-out	宏观视角分析	用户需要全局视野
to-prd	需求文档生成	用户需要 PRD
skill-creator	Skill 创建指南	用户要创建技能

Skill 标准结构

skill-name/
├── SKILL.md              # 主文件 (必需)
├── references/           # 参考文档 (可选)
├── scripts/               # 工具脚本 (可选)
└── assets/               # 资源文件 (可选)

自定义 Skill

在 .drifox/skills/<name>/ 或安装在插件 skills/ 目录下添加 Skill，使用 /技能名 触发。

记忆系统

自动学习用户偏好，支持：

置信度评分：每条记忆有 0-1 的置信度
冲突管理：相同组的新记忆压制旧记忆
分类组织：偏好/约束/习惯分类存储

SQLite 数据库

数据库文件：.drifox/sessions.db

表名	用途	主要字段
sessions	会话历史	session_id, title, messages, compaction_state, created_at
memories	长期记忆	memory_id, content, confidence, category, source
file_operations	文件操作撤销	id, tool_name, file_path, backup_path

数据目录

.drifox/
├── sessions.db            # SQLite 数据库
├── skills/                # 用户自定义 skills
├── issues/               # Issue 追踪
├── tasks/                # 定时任务
├── backups/             # 增量备份
└── archived/            # 会话归档

Roadmap

以下功能正在规划中：

功能	说明	状态
🧩 多窗口粘合	窗口组管理，多个窗口粘合后可一起拖动一起管理	✅ 已实现
🌲 Git Worktree	直接管理 git worktree，并行开发互不干扰	✅ 已实现
📈 交互式图表渲染	支持 ````echarts` 代码块渲染交互式 ECharts 图表	✅ 已实现
🖼️ 图片与富媒体显示	Markdown/HTML 图片原生渲染，本地图片路径自动解析	✅ 已实现
🔗 SubAgent DAG 工作流	有向无环图编排子智能体，拓扑排序+并行执行+实时可视化	✅ 已实现
🤖 多智能体并行	20+ 子智能体并行执行，独立 LLM 循环+工具环境	✅ 已实现
📊 上下文用量环形图	实时显示 Token 占用比例和缓存命中率的环形可视化	✅ 已实现

Issue 格式

在 .drifox/issues/ 创建 0001_问题名称.md：

# Issue 标题

## 严重程度: 高/中/低
## 状态: 待修复/进行中/已解决

## 问题描述
...

## 建议的修复方向
...

项目结构

DriFox/
├── main.py                       # 运行入口
├── requirements.txt              # 依赖
├── plugins/
│   └── system/                   # 系统内置插件（打包在 exe 中）
│       ├── .drifox-plugin/       # 插件清单
│       ├── commands/             # 系统命令（/explore, /plan 等）
│       ├── agents/               # 系统智能体（explore, build 等）
│       ├── skills/               # 系统技能（tdd, brainstorming 等）
│       ├── themes/               # 系统主题（11 个主题）
│       ├── hooks/                # 系统 Hooks
│       └── .mcp.json             # 默认 MCP 配置
├── app/
│   ├── main_widget.py            # 主窗口
│   ├── side_dock_area.py         # 浮动窗口管理
│   ├── core/                     # 核心引擎
│   │   ├── plugin_manager.py     # 插件系统（单例，发现/热插拔/MCP合并）
│   │   ├── backend.py            # 后端初始化 + 插件热更新
│   │   ├── context_builder.py    # 上下文构建
│   │   ├── history_compactor.py  # 上下文压缩
│   │   ├── hook_manager.py       # 事件钩子系统
│   │   ├── command_manager.py    # 命令系统
│   │   ├── memory_manager.py     # 长期记忆
│   │   ├── agent.py              # Agent 定义与管理
│   │   ├── chat_session.py       # 会话管理
│   │   ├── tool_executor.py      # 工具执行引擎
│   │   ├── message_content.py    # 消息内容格式化
│   │   ├── model_capabilities.py # 模型能力配置
│   │   ├── token_estimator.py    # Token 估算
│   │   ├── tool_call_parser.py   # 工具调用解析
│   │   ├── tool_result_persister.py # 工具结果持久化
│   │   ├── webengine_profile.py  # WebEngine 配置
│   │   ├── coding_plan_fetcher.py # 套餐用量查询
│   │   ├── project_notes_manager.py # 项目笔记管理
│   │   ├── single_instance.py    # 单实例守护
│   │   ├── builtin_commands.py   # 内置命令
│   │   ├── chat_engine/          # 对话引擎子包
│   │   ├── conversation/         # 会话领域子包
│   │   ├── store/                # 存储层子包
│   │   └── workers/              # 后台工作线程
│   │       ├── subagent_worker.py # 子智能体 + DAG 执行引擎
│   │       └── chat_worker.py    # 对话工作线程
│   ├── tools/                    # 工具实现
│   │   ├── file_tools.py         # 文件工具（含 gitee_upload）
│   │   ├── terminal_tools.py     # 终端执行工具
│   │   ├── web_tools.py          # 网络工具
│   │   ├── task_tools.py         # subagent_para/dag/status
│   │   ├── mcp_tools.py          # MCP 工具适配
│   │   └── result.py             # ToolResult 数据类
│   ├── widgets/                  # UI 组件
│   │   ├── message_card.py       # 消息卡片（Markdown/ECharts/图片）
│   │   ├── render_helpers.py     # HTML 渲染辅助
│   │   ├── context_usage_ring.py # 上下文用量环形图
│   │   ├── coding_plan_ring.py   # 套餐用量环图
│   │   ├── cards/floating/       # 悬浮 UI 组件
│   │   └── cards/settings/       # 设置面板卡片
│   ├── gateway/                  # 消息网关
│   │   └── utils/
│   │       ├── gitee_uploader.py # Gitee 图床上传
│   │       └── ...               # 平台适配器
│   └── utils/                    # 工具模块
│       ├── diff_viewer.py        # 差异对比查看器
│       ├── git_worktree.py       # Git Worktree 管理
│       └── config.py             # 配置管理
├── .drifox/                      # 应用数据
│   ├── plugins/                  # 用户安装的第三方插件（33+）
│   │   ├── superclaude/          # 18 个子智能体框架
│   │   ├── feature-dev/          # 功能开发全流程
│   │   ├── pyright-lsp/          # Python 语言服务器
│   │   └── ...                   # 更多插件
│   ├── sessions.db               # SQLite 数据库
│   ├── skills/                   # 用户自定义技能
│   └── backups/                  # 增量备份
└── images/                       # 图片资源

技术选型

技术	用途
PyQt5	GUI 框架
PyQt-Fluent-Widgets	Fluent Design 组件库
PyQtWebEngine	HTML/Markdown/ECharts/图片渲染
ECharts 5	交互式图表（消息卡片 + DAG 图）
Loguru	日志系统
SQLite	会话与记忆持久化
OpenAI Python Client	LLM API 调用
watchfiles	插件目录热更新监听
markdown + Pygments	Markdown → HTML + 代码高亮
orjson	高性能 JSON 序列化
uv	Python 包管理与项目构建
httpx	异步 HTTP 客户端
fastapi + uvicorn	本地 HTTP 服务
mcp	Model Context Protocol

更新日志

v0.2.6 (2026-06-16)

📎 Gitee 图床上传工具：本地文件自动上传至 Gitee 仓库返回公开下载链接，Gateway 消息中的图片/文件自动经 Gitee 上传后发送
🔧 修复 Gateway 适配器转义字符处理和 HTTP 客户端用法
🔧 优化消息卡片样式和附件重置行为

v0.2.5 (2026-06-07)

🧩 项目选择器：优化界面结构，支持显示根目录和异步归档扫描
📦 消息导出：支持导出消息卡片为 PNG 图片格式
🔧 修复多窗口命令处理器冲突和 UI 组件销毁后访问问题
🔧 修复权限配置中通配符规则被忽略问题
♻️ 优化子智能体上下文继承逻辑
♻️ 同步工作目录到新窗口的记忆卡片实例

v0.2.4 (2026-06-04)

📊 套餐用量查询：支持 OpenAI / MiniMax / 火山方舟 API 用量实时查询与同心圆环形展示
🔗 SubAgent DAG 工作流：有向无环图编排子智能体，拓扑排序+并行执行+实时可视化节点图
📝 上下文压缩命令：/compact 支持自定义焦点和清空选项
🌟 底部工具栏重构：输入区域卡片堆叠设计，支持发光效果和主题配置
🔧 解决多窗口项目隔离和 DAG 任务执行异常
♻️ 移除 Mermaid 支持，优化 ECharts 图表渲染
♻️ 重构编码计划环形图绘制与用量抓取逻辑

v0.2.3 (2026-05-31)

⌨️ 命令快捷键：支持为常用命令绑定快捷键
📎 Gateway 文件发送：支持发送本地图片/文件到多平台
🏷️ 命令名后缀识别：支持跨类型重名命令处理
🎨 组件级主题引擎：QSSGenerator + 15 新颜色令牌，组件级样式配置
📋 命令卡片参数交互：参数提示显示和交互式输入
🤖 /subagents 命令：子智能体运行状态紧凑卡片展示
🔧 修复 MCP 服务器列表热重载和编辑问题
🔧 修复 PyQt 信号发射异常和工具调用权限检查
♻️ 重构 MCP 配置多格式支持（stdio/SSE/HTTP）

v0.2.2 (2026-05-28)

🔄 插件系统热重载：运行时增量重载+去重，无需重启即时生效
🔀 多窗口隔离：命令处理器、子智能体管理器实例隔离
🤖 子智能体紧凑悬浮框：实时查看所有子智能体运行状态
🔄 AutoLoop 自动循环：三阶段执行（规划→执行→归档）
🪟 窗口管理：吸附对齐、网格排列、批量选中操作
📐 代码差异展示：可视化对比工具
🔍 工具调用参数预览：执行前查看参数详情
🔠 超级大字体：多级字体缩放支持
♻️ 子智能体会话隔离，任务状态跨窗口独立
♻️ 插件技能命名空间和优先级管理

v0.2.1 (2026-05-24)

🌐 多平台网关：新增飞书/Discord 等适配器支持
✏️ 标题行内编辑：手动编辑会话标题，防止自动覆盖
📜 输入历史浏览：上下键浏览历史输入
🎨 用户主题系统：设计令牌重构，支持自定义主题
⚙️ 内置命令管理器：统一管理所有命令
🗑️ 消息删除撤销：删除后支持撤销恢复
🛡️ 单实例守护：禁止重复启动，自动激活已有窗口
❓ 多问题选项：question 工具支持单次多问题带选项
🔧 修复子代理回调时流式输出中断问题
🔧 修复网关适配器错误处理和状态管理

v0.2.0 (2026-05-23)

🧩 插件系统：革命性架构，33+ 即装即用插件，PluginManager 热插拔引擎
☁️ 词云会话总结：/wordcloud 命令一键生成 ECharts 词云，可视化提取会话关键术语
📈 交互式图表渲染：支持 ````echarts` 代码块渲染交互式 ECharts 图表
🖼️ 图片与富媒体显示：Markdown/HTML 图片原生渲染，本地路径自动解析
🔗 SubAgent DAG 工作流：有向无环图编排子智能体，拓扑排序+并行执行+实时可视化
🤖 多智能体并行：20+ 子智能体并行执行，独立 LLM 循环+工具环境
📊 上下文用量环形图：实时显示 Token 占用比例和缓存命中率

v0.1.9 (2026-05-21)

✨ Git Worktree：内置 worktree 管理，支持分支树展示/切换/新建/删除

v0.1.8 (2026-05-19)

✨ 上下文压缩系统：长对话自动摘要压缩，Token 预算控制
✨ 代码差异对比视图
🐛 修复 Windows 兼容性问题

v0.1.7 (2026-05-17)

✨ 长期记忆系统：SQLite 持久化，置信度评分和冲突管理
✨ 会话归档与检索
🔧 性能和内存优化

v0.1.6 (2026-05-15)

✨ 多模型支持：OpenAI / Claude / DeepSeek / MiniMax / 通义
✨ 穿透模式：悬浮窗口可穿透点击
🔧 聊天工作器优化

v0.1.5 (2026-05-15)

✨ 插件发现机制：系统和用户双源扫描
🔧 架构调整

v0.1.4 (2026-05-15)

✨ Hook 管理系统：可视化 UI 配置界面
✨ 自动更新：自动检查更新功能
🐛 Windows 兼容：修复路径分隔符和编码问题
🔧 重构聊天引擎架构和后端内存管理
🔧 技能管理重构
🎨 UI 优化

v0.1.3 (2026-05-14)

✨ MCP 系统：支持 stdio/SSE/HTTP 三种服务器类型
✨ 技能系统（Skills）：20+ 内置技能
🔧 工具系统扩展

v0.1.2 (2026-05-13)

✨ 多窗口粘合功能
✨ 分支会话
🎨 多窗口布局优化

v0.1.1 (2026-05-12)

✨ 基础对话功能
✨ 工具系统（35+ 内置工具）
✨ 记忆系统初版

许可证

MIT License

致谢

PyQt-Fluent-Widgets – UI 库
Loguru – 日志
OpenAI Python Client – API 客户端

Star History

Project details

These details have not been verified by PyPI

Release history Release notifications | RSS feed

0.2.12

Jun 20, 2026

0.2.11

Jun 20, 2026

This version

0.2.10

Jun 20, 2026

0.2.9

Jun 20, 2026

0.2.8

Jun 20, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

drifox_cli-0.2.10.tar.gz (2.1 MB view details)

Uploaded Jun 20, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

drifox_cli-0.2.10-py3-none-any.whl (2.3 MB view details)

Uploaded Jun 20, 2026 Python 3

File details

Details for the file drifox_cli-0.2.10.tar.gz.

File metadata

Download URL: drifox_cli-0.2.10.tar.gz
Upload date: Jun 20, 2026
Size: 2.1 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for drifox_cli-0.2.10.tar.gz
Algorithm	Hash digest
SHA256	`4b7ce3551109f7d50b12718b9fd2709f3830ce7da66ee12f423e7096859aa128`
MD5	`c2b8bee14f3c95556289f79bbbebc925`
BLAKE2b-256	`604c0445dde6110277de4f13106f380d3a2fd8124a20648231ba1f63ef4d6ff3`

See more details on using hashes here.

File details

Details for the file drifox_cli-0.2.10-py3-none-any.whl.

File metadata

Download URL: drifox_cli-0.2.10-py3-none-any.whl
Upload date: Jun 20, 2026
Size: 2.3 MB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for drifox_cli-0.2.10-py3-none-any.whl
Algorithm	Hash digest
SHA256	`606073afc99dc4c5261e4b3543d721447e68b384ff804a203fad74ebf928f01e`
MD5	`4fb05352c430332f2c07247ec9754d03`
BLAKE2b-256	`454684733c9873317059bd88b3bdc0da3a6160c0d5b2c9a89bf125868ddae391`

See more details on using hashes here.

drifox-cli 0.2.10

Navigation

Verified details

Maintainers

Unverified details

Meta

Classifiers

Project description

DriFox 飘狐 — 一个轻量化 AI 桌面对话助手

设计理念

核心特性

快速开始

环境要求

安装（推荐 uv）

运行

核心功能详解

会话并行

Git Worktree 并行开发

代码差异对比

上下文压缩

交互式图表渲染

词云会话总结

图片与富媒体显示

子智能体 DAG 工作流

Hook 系统

支持的事件类型

Hook 配置

决策控制

MCP 系统

支持的服务器类型

MCP 工具使用

常用 MCP Server 推荐

权限控制

插件系统

架构总览

核心机制

插件生命周期

插件能做什么

已安装插件精选（33+）

工作原理

浮动窗口特性

核心架构

Agent 系统

Agent 定义示例

工具系统（35+）

内置工具

Skills 系统

内置 Skills (20+)

Skill 标准结构

自定义 Skill

记忆系统

SQLite 数据库

数据目录

Roadmap

Issue 格式

项目结构

技术选型

更新日志

v0.2.6 (2026-06-16)

v0.2.5 (2026-06-07)

v0.2.4 (2026-06-04)

v0.2.3 (2026-05-31)

v0.2.2 (2026-05-28)

v0.2.1 (2026-05-24)

v0.2.0 (2026-05-23)

v0.1.9 (2026-05-21)

v0.1.8 (2026-05-19)

v0.1.7 (2026-05-17)

v0.1.6 (2026-05-15)

v0.1.5 (2026-05-15)

v0.1.4 (2026-05-15)

v0.1.3 (2026-05-14)

v0.1.2 (2026-05-13)

v0.1.1 (2026-05-12)

许可证

致谢

Star History

Project details

Verified details

Maintainers