tisfeng/SelectedTextKit

آخر نشاط مصدر مسجل: ٢٠ سبتمبر ٢٠٢٦ في ١٦:٤٧

آخر تحديث لفهرس SkillsMP: ٩ نوفمبر ٢٠٢٦ في ١٤:٢٢

skills مجمعة: ٧

نجوم GitHub: ٥٩
تفرعات GitHub: ٩

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/tisfeng/SelectedTextKit.

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# SelectedTextKit A modern macOS library for getting selected text with multiple fallback strategies, smart volume management, and powerful pasteboard utilities. It's a part of [Easydict](https://github.com/tisfeng/Easydict). ## Features - ✅ **Multiple Text Retrieval Strategies** - **Accessibility**: Get selected text via Accessibility API (AXUI) - **Menu Action**: Get selected text by menu bar copy action - **Keyboard Shortcut**: Get selected text by `Cmd+C` with muted system volume - **AppleScript**: Get selected text from browsers using AppleScript - **Auto**: Intelligent fallback with multiple methods - **Custom Strategy Arrays**: Define your own combination of strategies - ✅ **Smart Fallback System** - Configurable strategy combinations - Automatic retry with different methods - Graceful error handling and recovery - ✅ **Pasteboard Protection** - Backup and restore pasteboard contents - Execute temporary tasks without polluting user's pasteboard - Volume management to prevent system beep sounds - ✅ **Cross-Language Support** - Modern Swift API with async/await - Objective-C compatibility - ✅ **Clean Architecture** - Manager-based design - Separate concerns (Text, Accessibility, Pasteboard) - Extensible and maintainable code structure ## Installation ### Swift Package Manager Add the following to your `Package.swift`: ```swift dependencies: [ .package(url: "https://github.com/tisfeng/SelectedTextKit.git", from: "2.0.0") ] ``` Or add it through Xcode: File → Add Package Dependencies ## Usage ### Swift (Recommended) ```swift import SelectedTextKit private let textManager = SelectedTextManager.shared func example() async { do { // Option 1: Use auto strategy (recommended for most cases) if let selectedText = try await textManager.getSelectedText(strategy: .auto) { print("Selected text: \(selectedText)") } // Option 2: Use custom strategy array with ordered fallbacks let strategies: [TextStrategy] = [.accessibility, .menuAction, .shortcut] if let text = try await textManager.getSelectedText(strategies: strategies) { print("Text from custom strategies: \(text)") } // Option 3: Use specific strategies for browsers (order matters) let browserStrategies: [TextStrategy] = [.appleScript, .accessibility] if let text = try await textManager.getSelectedText(strategies: browserStrategies) { print("Text from browser: \(text)") } // Option 4: Use individual strategy methods if let text = try await textManager.getSelectedText(strategy: .menuAction) { print("Text from menu copy: \(text)") } // Option 5: Use shortcut strategy with muted volume if let text = try await textManager.getSelectedText(strategy: .shortcut) { print("Text from shortcut copy: \(text)") } } catch { print("Error: \(error)") } } ``` #### Available Text Strategies ```swift // All available strategies public enum TextStrategy { case auto // Intelligent fallback (accessibility → menu action) case accessibility // Get text via Accessibility API case appleScript // Get text from browsers via AppleScript case menuAction // Get text via menu bar copy action case shortcut // Get text via Cmd+C (with muted volume) } // Create ordered strategy arrays (execution order matters!) let browserStrategies: [TextStrategy] = [.appleScript, .accessibility, .menuAction, .shortcut] let fallbackStrategies: [TextStrategy] = [.accessibility, .menuAction, .shortcut] ``` ## API Reference ### Core Methods - `getSelectedText(strategy: TextStrategy)` - Get text using a specific strategy - `getSelectedText(strategies: [TextStrategy])` - Get text using multiple strategies with ordered fallback ### Available Strategies | Strategy | Description | Best For | |----------|-------------|----------| | `.auto` | Smart fallback (accessibility → menu action) | **Recommended** - Most reliable | | `.accessibility` | Direct Accessibility API | Fast, lightweight access | | `.appleScript` | Browser automation via AppleScript | Safari, Chrome, Firefox | | `.menuAction` | System menu bar copy action | When accessibility is limited | | `.shortcut` | Cmd+C with muted system volume | Universal compatibility | ## Requirements - macOS 11.0+ - Swift 5.7+ ## Dependencies - [AXSwift](https://github.com/tmandry/AXSwift) - Accessibility framework - [KeySender](https://github.com/tisfeng/KeySender) - Keyboard event simulation ## Acknowledgments - Menu bar copy action inspired by [Copi](https://github.com/s1ntoneli/Copi) by [s1ntoneli](https://github.com/s1ntoneli) ## License MIT License - see [LICENSE](LICENSE) for details.

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

محللو ضمان جودة البرمجيات والمختبرون مطوّرو البرمجيات

٢ فئات مهنية · 29% مصنفة

skill

المهنة

الوصف

آخر تحديث

git-commit

غير مصنف

起草、创建或汇报 Angular-style 本地 Git 提交。用于明确的提交交付；分支集成使用 worktree-rebase-merge，不 push。

لغة النص الأصلي: الصينية

2026-09-20

review-pr

غير مصنف

审查 GitHub PR 的准确 head/base diff、关联 issue、CI 和 review threads，交付前刷新。创建 PR 使用 submit-pr；本地审查使用 review。

لغة النص الأصلي: الصينية

2026-09-20

submit-pr

غير مصنف

创建或复用当前 checkout 已提交变更的 GitHub PR，必要时推送任务分支。PR 审查使用 review-pr；仅本地提交使用 git-commit。

لغة النص الأصلي: الصينية

2026-09-20

worktree-rebase-merge

غير مصنف

将当前 worktree 的任务提交 rebase 到本地目标分支，并从目标 worktree 合并。用于明确要求本地集成；仅创建提交使用 git-commit。

لغة النص الأصلي: الصينية

2026-09-20

fireworks-tech-graph

غير مصنف

Create precise SVG technical diagrams, export PNG or offline HTML, and animate supported semantic SVGs to GIF. Use for architecture, UML, agent, cloud or workflow diagrams; not photos, raster art or statistical charts.

لغة النص الأصلي: الإنجليزية

2026-09-09

code-simplifier

مطوّرو البرمجيات

在完整保留功能的前提下简化和改进代码，提升清晰度、一致性与可维护性。适用于用户要求简化代码、清理代码、重构以提升可读性，或检查近期修改是否简洁得体。除非另有说明，只关注近期修改的代码。

لغة النص الأصلي: الصينية

2026-09-06

review

محللو ضمان جودة البرمجيات والمختبرون

审查本地任务变更、工作树、提交或提交范围，以及文件或模块的正确性。提供有证据的缺陷与修复建议；GitHub PR 上下文和线程操作由 review-pr 编排。

لغة النص الأصلي: الصينية

2026-09-06

عرض ٧ من أصل ٧ skills مجمعة.