🎯 Logitum自适应环
你的硬件变得更智能了
人工智能驱动、上下文感知的操作触手可及。字面上。
特性 •
运作原理 •
安装 •
演示 •
建筑
🤔 问题
你知道当你淹没在标签页中、不断切换上下文、在菜单中寻找你想要的功能时的那种感觉 知道 存在于某个地方?```
┌─────────────────────────────────────────────┐
│ Monday, 9:47 AM │
│ • 27 browser tabs open │
│ • Switched apps 184 times │
│ • Clicked through menus... so many menus │
│ • Lost in tool overload │
└─────────────────────────────────────────────┘
**我们都去过那里。** 这就像生活在90年代,但RAM更多。
## 💡 解决方案
如果你的罗技设备 _只是知道_ 你需要什么?如果它适应了你的工作流程,学习了你的模式,并将正确的工具带到了你的指尖,那会怎么样 **正好在你需要的时候**?
### 输入: **Logitum自适应环** 🎉
罗技插件,将您的MX设备转换为智能、自适应的命令中心,由 **6000多种人工智能工具** 通过模型上下文协议。
### ✨ 三个字: **情报。适应。零配置。**
______________________________________________________________________
## 🚀 主要特点
### 🎯 **即时智能**
切换到VS代码?获取 _提交_, _推_, _调试_, _运行测试_.\
切换到Slack?获取 _发送消息_, _@提及_, _反应_, _搜索_.\
切换到Chrome?获取 _书签_, _新建标签页_, _历史_, _搜索_.
**全部自动。** 没有配置。没有设置。只是工作。
### 🧠 **了解您的工作流程**
系统会跟踪您的行为(始终在您的许可下):
- 注意您每周在VS Code中运行20次测试
- 自动将其添加到您的操作环中
- **适合您的硬件**
### 🌐 **通过MCP提供6000多个应用程序**
建立在 模型上下文协议 --以下机构采用的开放标准:
- ✅ OpenAI(2025年3月)
- ✅ 谷歌DeepMind(2025年4月)
- ✅ 微软与Anthropic
- ✅ 6480+台服务器,而且还在增长
### 🔮 **未来考验**
明天发布新的MCP服务器? **你会自动得到它。** 没有插件更新。没有配置。它只是出现。
______________________________________________________________________
## 🎬 运作原理```
┌─────────────────────────────────────────────────────────────────┐
│ 🔄 THE ADAPTIVE CYCLE │
└─────────────────────────────────────────────────────────────────┘
1️⃣ You switch apps → Process Monitor detects it
↓
2️⃣ Query MCP Registry → Find relevant servers
↓
3️⃣ AI suggests workflows → "Commit", "Push", "Debug"
↓
4️⃣ Actions Ring updates → Instantly available
↓
5️⃣ You click action → MCP executes the tool
↓
6️⃣ UI Monitor tracks patterns → "Hmm, they do this a lot..."
↓
7️⃣ AI interprets behavior → "User runs tests frequently"
↓
8️⃣ Vector clustering → Similar actions group together
↓
9️⃣ Frequency threshold hit → "Want to add 'Run Tests'?"
↓
🔟 Ring updated → Ring adapts permanently
♻️ REPEAT. IMPROVE. ADAPT.
🏗️ 建筑
三层智能系统```
┌─────────────────────────────────────────────────────┐
│ TIER 1: DISCOVERY (Instant) │
│ • MCP Registry lookup on app switch │
│ • AI suggests 6-8 common workflows │
│ • Actions Ring populates in <500ms │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ TIER 2: OBSERVATION (Passive) │
│ • Windows UI Automation monitors clicks │
│ • Tracks focus changes, inputs, shortcuts │
│ • Stores interaction data (24-hour TTL) │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ TIER 3: ADAPTATION (Intelligent) │
│ • Gemini AI interprets action sequences │
│ • VoyageAI embeddings cluster similar patterns │
│ • clustering algorithm identifies workflows │
└─────────────────────────────────────────────────────┘
### 技术栈
|Layer |技术|我们为什么喜欢它|
| ------------------ | --------------------------- | ------------------------------------------- |
| 🎮 **插件** |Logitech Actions SDK(C#)|本机硬件集成|
| 🤖 **AI大脑** |Google Gemini |工作流程理解和建议|
| 🧮 **嵌入** |VoyageAI(`voyage-code-3`)|语义相似度检测|
| 📊 **聚类** |NN+余弦相似度|模式识别|
| 👀 **UI跟踪** |Windows UI自动化|行为学习|
| 🗄️ **存储** |SQLite3 |快速、本地、私有|
| 🌐 **生态系统** |模型上下文协议|6000多种工具,一个标准|
______________________________________________________________________
## 🎨 是什么让这个特别?
### 与传统解决方案
|方法|限制|逻辑|
| -------------------------- | ---------------------------------- | ----------------------------------------- |
| **键盘快捷键** |记住100多种组合|✅ 视觉、上下文,一次最多8个|
| **命令选项板** |仍需要键入和搜索|✅ 物理按钮,即时|
| **克劳德桌面** |显示所有工具,手动导航|✅ 显示相关工具,学习|
| **罗技智能操作** |手动设置,无MCP,静态|✅ 自动MCP发现,人工智能驱动,适应|
| **其他插件** |特定于应用程序,范围有限|✅ 通用(6k+应用程序),面向未来|
### 🎯 杀手组合
1. **物理接口** -触觉、即时、无上下文切换
1. **AI驱动** -理解背景和意图
1. **自我学习** -随着您的使用而改进
1. **开放标准** -MCP意味着无限的可扩展性
1. **零配置** -立即工作,自动改进
______________________________________________________________________
## 🔧 安装
### 先决条件
- **硬件**:罗技MX Master 3/4、Loupedeck CT/Live/Live S或Razer流控制器
- **操作系统**:Windows 10/11(计划支持macOS)
- **软件**:罗技选项+/Loupedeck软件
- **.NET**:8.0或更高
### 设置```bash
# Clone the repo
git clone https://github.com/yourusername/logitum.git
cd logitum/AdaptiveRingPlugin
# Set up environment variables
$env:GEMINI_API_KEY="your-gemini-api-key"
$env:VOYAGEAI_API_KEY="your-voyageai-api-key"
# Build the plugin
cd src
dotnet build -c Release
# Plugin auto-deploys to:
# C:\Users\\AppData\Local\Logi\LogiPluginService\Plugins\
获取API密钥(可用的免费层!)
- 双子座: aistudio.google.com
- Voyageai: 旅行.com
🎥 演示
🧪 发展
项目结构```
logitum/
├── AdaptiveRingPlugin/
│ ├── src/
│ │ ├── Actions/ # Command implementations
│ │ ├── Services/ # Core intelligence
│ │ │ ├── ProcessMonitor.cs # App detection
│ │ │ ├── MCPRegistryClient.cs # MCP integration
│ │ │ ├── GeminiActionSuggestor.cs # AI suggestions
│ │ │ ├── UIInteractionMonitor.cs # Behavior tracking
│ │ │ ├── SemanticWorkflowProcessor.cs # Pattern analysis
│ │ │ ├── VoyageAIClient.cs # Embeddings
│ │ │ ├── VectorClusteringService.cs # Neighrest Neighbour Clustering
│ │ │ └── ActionRankingService.cs # Smart sorting
│ │ ├── Models/ # Data structures
│ │ ├── Helpers/ # Utilities
│ │ └── Scripts/ # Python AI services
│ └── bin/Release/ # Compiled plugin
├── PLAN.md # Original hackathon plan
├── FEATURE_IMPLEMENTATION_SUMMARY.md # Technical docs
└── README.md # You are here! 👋
### 从源代码构建```bash
# Debug build
dotnet build
# Release build (optimized)
dotnet build -c Release
# Watch mode (auto-rebuild)
dotnet watch build
运行测试```bash
Unit tests
dotnet test
Integration tests (requires hardware)
dotnet test --filter Category=Integration
______________________________________________________________________
## 🗄️ 数据库模式```sql
-- Core tables
apps → Registered applications
app_actions → MCP actions per app
mcp_servers → Known MCP registry entries
-- Intelligence tables
ui_interactions → Raw UI events (24h TTL)
semantic_workflows → AI-interpreted patterns
workflow_embeddings → Vector representations
workflow_clusters → Grouped similar actions
-- All stored locally in:
-- C:\Users\\AppData\Local\Logitum\adaptive_ring.db
🔐 隐私和安全
我们跟踪的内容(如果您启用学习)
✅ 应用程序名称 (例如,“chrome.exe”、“lack.exe”)\
✅ 按钮点击 (例如,“点击‘提交’”)\
✅ 窗口标题 (例如,“Gmail-收件箱”)\
✅ 动作序列 (例如,“类型→Click→提交”)
我们不跟踪的内容
❌ 密码 (面具如 ******)\
❌ 电子邮件/消息内容\
❌ 浏览历史URL\
❌ 文件路径或代码
数据所在之处
🏠 100%本地 -存储在您的机器上的所有内容(如果您使用本地LLM,则可以保留在那里)
🔒 无云同步 (除非您启用它)\
🗑️ 24小时自动删除 用于原始UI事件
API调用
仅发送至 双子座 (工作流程解释)和 Voyageai (嵌入)。\
您可以控制API密钥。
🌟 路线图
✅ 已完工(HackaTUM 2025)
- [x] MCP注册表集成
- [x] Gemini AI工作流程建议
- [x] Windows UI自动化跟踪
- [x] 向量嵌入聚类
- [x] 适应性行动学习
- [x] 带矢量嵌入的SQLite3
🚧 进行中
- []macOS支持(通过NSAccessibility)
- []手动操作编辑器UI
- []导出/导入操作配置文件
- []性能优化(缓存)
🔮 未来愿景
- []多设备同步(加密云)
- []语音控制集成
- []跨应用程序工作流自动化
- []团队协作(共享配置文件)
- []罗技市场提交
- []用于自定义操作的插件SDK
🤝 贡献
我们很乐意得到你的帮助!方法如下:
🐛 报告Bug
通过以下方式打开问题:
- 操作系统版本
- 罗技设备型号
- 重现步骤
- 日志文件(位于
C:\Users\\AppData\Local\Logi\LogiPluginService\Logs\)
💡 建议功能
打开一个问题 enhancement 标签。
📝 改进文档
发现拼写错误?解释不清楚?PR欢迎!
🙏 致谢
构建于
- 罗技操作SDK -硬件魔术
- 模型上下文协议 -开放式AI标准
- 谷歌双子座 -工作流智能
- Voyageai -语义嵌入
- MCP注册表 -工具发现
灵感
- 标签超载的挫败感
- 有形计算的愿景
- 开放标准的力量
- 6000多台MCP服务器的社区
特别感谢
- 罗技 -制造令人难以置信的硬件并向开发人员开放
- HackaTUM -为了引发这一挑战
- MCP社区 -构建人工智能互操作性的未来
- 你 -来看看这个项目! 🙌
📞 联系与支持
获取帮助
- 💬 GitHub问题: github/mrsladoje/logitum/oissues
- 📧 电子邮件: mrsladoje@gmail.com
保持更新
⭐ 标记此回购 跟随发展\
👀 手表 用于发布通知\
🔔 订阅 讨论问题
🚀 准备好让你的硬件更智能了吗?
⬇️ 下载最新版本 • 🎥 观看演示
“预测未来的最好方法就是建造它。”
由...制作❤️ 在HackaTUM 2025的36小时内
返回顶部↑
