基础用法

下文将教您 Doggy 的基本用法：如何在需要的时候唤出 Doggy，并处理如文件、文本等内容。

激活 Doggy

总体来说，Doggy 拥有三种模式，您可以以三种模式的其中一种激活 Doggy。这三种模式分别为：内容读取、内容替换、内容生成模式。

对于 Doggy 来说，这三种模式分别通过三个不同的快捷键触发。

// TODO: 补充动图，说明激活的过程

在 Doggy 的默认配置中，三种模式的触发快捷键分别是：

具体的快捷键可以在 Doggy 的设置界面中可以看得到，可以通过点击 Doggy 的 StatusBar 图标，点击设置选项打开设置界面。

若是对于默认的快捷键不满意，也可以修改成您希望的快捷键。在设置界面中点击对应要修改的快捷键即可修改（需要您在弹出的文件授权框中点击同意）。

当您将 Doggy 激活后，就可以选择 Doggy 中的扩展指令来处理您的内容了。

Doggy 被激活后，会一直显示在界面上，等待用户选择一个扩展指令来运行。您可以通过以下操作隐藏 Doggy 窗口：

在不同的场景下，选择不同的模式激活 Doggy 是十分重要的，接下来让我们来看看各个模式的区别。

通常情况下，只要您选择了系统中的某一个内容，比如一段文本、一个或多个文件夹、一个或多个文件，则可以激活 Doggy 来处理这些选中内容。

// TODO：补充选中各种类型文件激活 Doggy 的动态图片

若是您选中的是一段文本，则您可以对于这段文本进行一些处理，比如根据文本来获取翻译的结果；若是您选中的是文件夹或者文件，则可以对这些文件或者文件夹进行处理，比如在当前选中文件夹下创建空的 word 文件。

这个模式通常对于一些文本的查询搜索扩展指令，文件的操作扩展指令十分有效。

当您选择了一段文本时，如果当前选中文本的位置是可以被修改的，那么您就可以食用内容替换模式来激活 Doggy。

在内容读取模式的基础上，使用内容替换模式，您可以在经过扩展指令处理得到对应的结果以后，将结果替换到选中文本的位置中。

举例来说，当您选中了一段代码后，想要将代码的格式变的好看些，您就可以在 Doggy 中使用 clang-format 单独格式化您选中的代码。

// TODO: 展示格式化代码的效果

当您没有选择任何内容时，如果当前处在一个文字编辑的状态，就可以激活 Doggy 的内容生成模式。在该模式下，您可以生成一些预先存储好的文本到当前文本编辑区域中。

// TODO：动图演示文本编辑

// TODO：补充权限相关内容