Ghostie

ghostie 智能助手

[ghostie](https://ghostie.wangenius.com) 是一款基于 Tauri + React 开发的跨平台智能助手应用。它提供简洁优雅的界面，让你轻松与各种 AI 模型交互。

教程 示例

✨ 主要功能

🤖 AI 与 Agent 系统

• 支持多种 AI 模型（OpenAI、通义等）
• 配备不同角色与能力的多 Agent 系统
• 智能上下文管理与对话流程
• 可自定义 Agent 个性与行为
• Agent 协作与任务委派

🌐 MCP 支持

• MCP 市场：一键开启
• 更多其他来源

💻 桌面集成

• 完整访问和控制桌面系统
• 无需 MCP 服务即可执行本地脚本
• 系统级自动化能力
• 原生文件系统集成
• 跨平台支持（Windows、macOS、Linux，目前支持 Windows）

🔌 插件架构

• 可扩展的插件系统
• 支持自定义插件开发
• 插件市场
• 插件热重载能力
• 插件权限管理

⚡ 工作流引擎

• 可视化工作流设计器
• 多 Agent 工作流编排
• 条件分支与循环
• 错误处理与恢复
• 工作流模板与共享

📚 知识管理

• 支持本地知识库
• 文档解析与索引
• 支持多种格式（PDF、Word、Markdown、TXT）
• 知识库搜索与筛选
• 知识共享与协作

🎯 用户体验

• 快捷键快速唤起（Alt + Space）
• 基于 Tailwind CSS 的现代 UI
• 自动更新
• 跨平台一致性
• 全栈 TypeScript 开发

📸 界面预览

🚀 快速开始

系统要求

• Windows 10 或更高版本
• macOS 或 Linux（即将推出）

📖 用户指南

基本用法

1. 快速启动

   • 随时使用快捷键 Alt + Space 唤起助手窗口
     • 窗口优雅地显示在屏幕中央
     • 支持自动记忆窗口位置
     • 可在设置中自定义快捷键组合

2. 对话交互

   • 输入功能
     • 支持多行输入（Shift + Enter 换行）
     • 自动识别并格式化代码块
     • 使用 Ctrl + L 快捷键清除输入
     • 使用向上/向下箭头键快速查看历史记录
   • 对话功能
     • 支持 Markdown 格式显示
     • 一键复制代码块
   • 上下文管理
     • 自动维护对话上下文
     • 手动清除上下文（Ctrl + R）
     • 支持固定上下文设置
     • 智能调整上下文长度

3. 切换助手

   • 预设助手类型
     • 通用助手：日常对话与问答
     • 代码助手：编程相关问题
     • 写作助手：内容创作
     • 分析助手：数据分析与处理
   • 自定义助手
     • 在设置 > 助手管理中创建
     • 导入/导出助手配置
     • 克隆现有助手
     • 自定义助手图标与样式

高级功能

1. 知识库管理

   • 文档支持
     • 支持的格式：PDF、Word、Markdown、TXT
     • 自动解析和索引文档
     • 支持批量导入文件夹
     • 自动同步文档
   • 知识库操作
     • 创建多个知识库组
     • 知识库搜索与筛选
     • 支持合并知识库
     • 导入/导出功能
   • 问答功能
     • 基于知识库进行精准问答
     • 支持联合查询多个知识库
     • 可调整相关性阈值
     • 追溯答案来源

2. 工作流自动化

   • 工作流创建
     • 可视化工作流编辑器
     • 条件分支与循环
     • 组合多个操作节点
     • 错误处理与重试机制
   • 触发条件
     • 定时触发器
     • 事件触发器
     • 消息触发器
     • API 触发器
   • 执行控制
     • 并行/顺序执行控制
     • 执行状态监控
     • 日志记录与追踪
     • 执行结果通知

3. 历史记录与导出

   • 历史记录管理
     • 按日期/助手类别查看
     • 支持全文搜索
     • 标签管理系统
     • 为重要对话添加星标
   • 导出功能
     • 导出为 Markdown 格式
     • 导出为 HTML 网页
     • 导出为 PDF 文档
     • 批量导出功能

💡 核心功能

ChatModel

• 支持集成多个模型（OpenAI、Azure 等）
• 智能上下文管理
• 自定义模型参数配置
• 完整的对话历史记录
• 支持流式输出

Agent/Agent/Proxy/Assistant

• 可配置的对话策略
• 多助手切换
• 支持工作流和插件
• 集成知识库
• 助手个性化设置

工作流

• 支持自定义工作流
• 任务链处理
• 多 Agent 协作
• 可扩展的插件系统

MCP（多云平台）

• 地理位置服务（地址解析、地点搜索、天气查询）
• 路线规划与导航服务（驾车、步行、公交、骑行）
• IP 定位服务
• 距离测量与周边搜索
• 可扩展的 API 集成框架

⚙️ 开发环境配置

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Build application
npm run build:tauri

🤝 参与贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到该分支（git push origin feature/AmazingFeature）
5. 创建 Pull Request

📄 许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

🙏 致谢

• Tauri
• React
• 所有贡献者和用户