跳转到内容
DevGlish Docs

安装与初始设置

系统要求

Section titled “系统要求”
  • macOS 13.0 或更高版本
  • Intel 或 Apple Silicon 架构均支持
  • 3 MB 磁盘空间
  • 互联网连接（用于 AI 查询和更新；部分功能离线可用）

安装方式

Section titled “安装方式”

方式 1：从网站下载 DMG（推荐）

Section titled “方式 1：从网站下载 DMG（推荐）”
  1. 访问 DevGlish 官网
  2. 点击 Download 按钮，下载最新的 DevGlish.dmg
  3. 双击 .dmg 文件打开安装程序
  4. 将 DevGlish 应用拖到 Applications 文件夹
  5. 完成！你可以在 Applications 文件夹中找到 DevGlish 并启动它

方式 2：TestFlight 测试版本

Section titled “方式 2：TestFlight 测试版本”

想尝试最新的功能？加入 TestFlight 测试计划：

  1. 在 Apple Mail 中接收邀请链接（或在 DevGlish 官网 申请）
  2. 点击链接，在 TestFlight 应用中点击 Accept
  3. TestFlight 会自动下载 DevGlish 测试版本
  4. 完成安装后，你可以在 TestFlight 应用中启动 DevGlish

关键设置：授予辅助功能权限

Section titled “关键设置：授予辅助功能权限”

DevGlish 使用 macOS 辅助功能 API（AXUIElement）来读取你选中的文本。这是应用正常工作的必要条件。

为什么需要这个权限？

Section titled “为什么需要这个权限？”

DevGlish 需要访问你在任何应用中选中的文本。无论你是在 Xcode 中选择代码片段、在 Slack 中选择聊天消息、还是在浏览器中选择网页内容，DevGlish 都能通过这个权限获取你的选中内容，然后调用 AI 查询。

步骤 1：打开系统设置

Section titled “步骤 1：打开系统设置”
  1. 点击菜单栏左上角的苹果 logo
  2. 选择 System Settings（系统设置）

步骤 2：导航到隐私与安全

Section titled “步骤 2：导航到隐私与安全”
  1. 在左侧边栏中找到 Privacy & Security（隐私与安全）
  2. 点击进入

步骤 3：找到并启用辅助功能

Section titled “步骤 3：找到并启用辅助功能”
  1. 向下滚动，找到 Accessibility（辅助功能）选项
  2. 点击 Accessibility
  3. 在右侧窗口中，查找 DevGlish 应用
  4. 如果 DevGlish 还没有在列表中，点击 + 按钮，然后从 Applications 文件夹中选择 DevGlish
  5. 确保 DevGlish 旁边的切换开关已打开（绿色）

步骤 4：启动 DevGlish

Section titled “步骤 4：启动 DevGlish”
  1. 关闭系统设置
  2. 从 Applications 文件夹中启动 DevGlish，或使用 Spotlight 搜索（⌘Space，输入 “DevGlish”）
  3. DevGlish 会出现在菜单栏的右上角（齿轮图标）

登录

Section titled “登录”

启动 DevGlish 后，你需要登录以同步你的学习进度和保存的单词。

选项 1：使用 Apple Sign In（推荐）

Section titled “选项 1：使用 Apple Sign In（推荐）”
  1. 点击菜单栏中的 DevGlish 图标
  2. 选择 Sign in with Apple
  3. 使用你的 Apple ID 完成登录
  4. 授予 DevGlish 访问你的 Apple 账户权限（仅用于认证，DevGlish 不会存储你的密码）

选项 2：使用魔法链接（邮件登录）

Section titled “选项 2：使用魔法链接（邮件登录）”
  1. 点击菜单栏中的 DevGlish 图标
  2. 选择 Sign in with Email
  3. 输入你的邮箱地址
  4. 检查邮箱，点击收到的魔法链接
  5. 链接会自动登录 DevGlish

故障排除

Section titled “故障排除”

问题：按 ⌘⇧D 没有反应

Section titled “问题：按 ⌘⇧D 没有反应”

解决方案：

  1. 确认 DevGlish 已启动（菜单栏右上角应该有图标）
  2. 确认 DevGlish 已在 System Settings > Privacy & Security > Accessibility 中启用
  3. 尝试重启 DevGlish：点击菜单栏图标 → Quit DevGlish，然后重新启动
  4. 在 Accessibility 设置中重新切换 DevGlish 的权限开关（关闭后再打开）

问题：无法登录或收不到邮件

Section titled “问题：无法登录或收不到邮件”

解决方案：

  1. 检查网络连接
  2. 如果使用邮件登录，检查垃圾邮件文件夹（Magic Link 邮件有时会被过滤）
  3. 尝试使用 Apple Sign In 代替
  4. 如果问题持续，请联系 [email protected]

问题：DevGlish 无法访问选中的文本

Section titled “问题：DevGlish 无法访问选中的文本”

解决方案：

  1. 确认你已在 Accessibility 中授予权限（参见上面的步骤 3）
  2. 一些应用（如某些安全应用）可能阻止辅助功能访问。尝试在其他应用中测试（如 Notes、TextEdit）
  3. 重启 DevGlish（点击菜单栏图标 → Quit，然后重新启动）

下一步

Section titled “下一步”

现在你已经安装并设置好 DevGlish 了！前往 3 分钟快速上手 学习如何进行第一次查询。