使用说明

🎯 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+应用程序），面向未来

🎯 杀手组合

物理接口 -触觉、即时、无上下文切换
AI驱动 -理解背景和意图
自我学习 -随着您的使用而改进
开放标准 -MCP意味着无限的可扩展性
零配置 -立即工作，自动改进

🔧 安装

先决条件

硬件：罗技MX Master 3/4、Loupedeck CT/Live/Live S或Razer流控制器
操作系统：Windows 10/11（计划支持macOS）
软件：罗技选项+/Loupedeck软件
.NET：8.0或更高

设置

# 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\<YOU>\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! 👋

从源代码构建

# Debug build
dotnet build

# Release build (optimized)
dotnet build -c Release

# Watch mode (auto-rebuild)
dotnet watch build

运行测试

# Unit tests
dotnet test

# Integration tests (requires hardware)
dotnet test --filter Category=Integration

🗄️ 数据库模式

-- 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\<YOU>\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\<YOU>\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小时内

返回顶部↑