如何让 Favonis 用你的电脑？

在电脑上安装 Favonis 桌面端并添加文件夹后，可以开一个本地对话：Favonis 直接在你选的文件夹里读写文件，用你电脑上的软件和命令完成任务，例如整理一个文件夹里的表格、修改项目代码并运行测试、把报告存回原来的位置。本地对话只能在工作模式中开启，Favonis 改过的你电脑上的文件无法撤销。

添加电脑和文件夹

桌面端支持 macOS 14、Windows 10 及以上版本和 Linux。连接账号用的凭证存在系统钥匙串里，Linux 上需要有钥匙串服务（GNOME 钥匙串或 KWallet）。读不到钥匙串时，设置 → 我的电脑显示“无法读取系统钥匙串，这台电脑暂时不能连接。”，允许访问或解锁钥匙串后点击重试。

1. 在下载页下载并安装桌面端。第一次打开时点击开始使用，再登录你的账号。
2. 进入设置 → 我的电脑，在文件夹中点击添加文件夹，选择要授权的文件夹。
3. 第一次添加时，这台电脑会连接到你的账号，出现在下方的电脑列表中，显示为在线。

在 macOS 上，选的文件夹在“桌面”“文稿”“下载”或外接磁盘里时，系统会接着询问能否让 Favonis 访问这一整处。建议允许：Favonis 在你电脑上运行的命令有时要读文件夹外面的内容（例如构建工具往上层找配置），允许后不会在做到一半时停下来等这个询问。不允许也能使用这个文件夹，只是这些命令读不到它外面的内容。桌面端更新后，打开时系统可能会再问一次。

开始本地对话

新建工作对话时，输入框里的位置默认是云端。点击它，选择一台在线的电脑和它的一个文件夹，再发送第一条消息；在桌面端里也可以选择打开文件夹…，选中的文件夹同时完成授权。对话开始后位置不能更换，对话顶部显示电脑名和文件夹名，点击它可以查看完整路径、复制路径，或者在同一个文件夹里新建对话。在对话所在电脑的桌面端里还可以选择在访达中显示（Windows 上是在文件资源管理器中显示，Linux 上是在文件管理器中显示），打开上一级文件夹并选中这个文件夹。侧边栏中，本地对话的右侧有一个电脑图标：电脑在线时图标右上角有一个绿点，离线时图标上有一道斜线。

把这个文件夹里这个月的发票整理成一张表，按日期排好，存成“发票汇总.xlsx”。

Favonis 只能使用这个文件夹里的文件，命令在你自己的 shell 和环境变量里运行。新装的软件（例如 Python、Node.js）和改过的环境变量几分钟内就会生效，不用重启桌面端。做到一半用的中间文件和脚本放在这台电脑的临时文件夹里，不放进你的文件夹。在云端对话里遇到要用你电脑上的文件或软件的任务，Favonis 也会建议你开一个本地对话。

本地子任务和云端子任务

任务比较大时，Favonis 会把其中几部分交给子任务同时做。在本地对话里，子任务分两种：

• 本地子任务和 Favonis 一样在这台电脑上、这个文件夹里工作，用你电脑上的软件，适合把能分开的几部分同时做完。
• 云端子任务在云端电脑上运行。生成 Office 文档、处理图片和音频、操作浏览器这类要用云端能力的工作，以及不适合放在你电脑上做的事（例如运行来路不明的代码），Favonis 会交给它。要用的文件先传到项目的“上传”文件夹，按电脑名和文件夹路径分开存放（项目成员看得到），结果写回你的文件夹。

点开一个子任务查看详情时，云端子任务的标题前有一个云朵图标。

在工作区查看文件夹

本地对话的工作区（对话页右上角的打开工作区）和云端对话是同一套页签，内容换成了这台电脑上的。

文件页签列出这个文件夹里的文件，顶上一行写着电脑名和文件夹路径，前面的电脑图标和侧边栏一样表示电脑在不在线。在对话所在电脑的桌面端里点击文件，都在右边打开：能预览的直接预览，gradlew、gradle.properties 这类没有常见扩展名的文本文件也一样；预览不了的（如压缩包、Word 文档）显示“不支持预览该文件类型”，下面有在访达中显示，文档、图片、音频和视频还有用默认应用打开。右键可以在访达中显示、用默认应用打开（文档、图片、音频和视频）、复制路径或添加到对话。Favonis 改完文件后列表自己更新，不用刷新。在其他设备上能看到有哪些文件，但打不开；电脑离线时列不出来。

本地电脑页签记录 Favonis 在这台电脑上做过的事。终端里是它运行过的命令；文件里一次改动一行，点开一行能看到这一次改了哪几行，行尾的在文件夹中打开跳到文件页签并找到这个文件；派过子任务时还有子任务。网站由 Favonis 交给云端子任务搭建和发布，做好后显示在网站页签。

文件夹里有 Git 仓库时，可以在 Git 管理页签中查看改动、提交和同步，见如何用 Git 管理项目？。

引用文件夹里的文件

在输入框中输入 @，可以引用这个文件夹里的文件和文件夹，Favonis 需要时会读取它们。依赖、缓存这类文件夹里的文件，以及 .gitignore 里排除的文件不会列出；文件很多时只列出一部分，没列出的可以直接输入 @ 和它在文件夹里的路径。电脑在线时才列得出来。在对话所在电脑的桌面端里，菜单中的图片、视频和文档带着缩略图，由这台电脑的系统生成，和文件管理器里看到的一样；在其他设备上只显示文件类型图标。

有风险的命令

Favonis 在你电脑上运行命令前会先判断风险。命令权限按文件夹设置，有两种：

• 自动权限（默认）：删除或覆盖文件（能重新生成的依赖、构建产物除外）、改动文件夹以外的内容、安装软件、修改系统设置这类命令，输入框会变成一道题“允许 Favonis 运行‘…’吗？”，下面是这条命令。点击允许才会运行，点击拒绝则换别的做法；也可以在第 3 行写下想让 Favonis 怎么做，点击提交回答，这条命令不会运行，Favonis 按你说的接着做。其余命令直接运行。
• 全部授权：所有命令都直接运行，不再询问。

本地子任务要运行有风险的命令时，同样的题出现在主对话的输入框里，最上面写明是哪个子任务想运行，由你回答，Favonis 不会替你作答；你回答之前，这个子任务停在原处等着。几道题同时在等时，右上角显示一共几道，答完一道换下一道。

本地对话的输入框里显示这个文件夹当前的命令权限，点击它就能切换，对这个文件夹里的所有对话生效，正在进行的任务从下一条命令开始按新的权限运行。也可以在设置 → 我的电脑的文件夹中修改。每个文件夹第一次切换到全部授权时，Favonis 会先请你确认。定时任务运行时没有人确认，自动权限下有风险的命令直接不运行。

电脑需要在线

电脑在线时，你在手机、网页或另一台电脑上登录同一个账号，都能接着这个对话：查看进度、补充要求、回答卡片。电脑离线时，输入框显示“打开这台电脑上的 Favonis 后继续”，进行中的任务仍可以暂停或停止。本地对话里的定时任务到点时电脑不在线，这一次会跳过。

任务进行中电脑断开了（合上笔记本、退出桌面端或者断网），Favonis 和本地子任务会停下来等，回复下方显示“Favonis 正在等电脑连回来，连上后自动继续”，电脑连回来后它接着做。4 小时内没有连回来，任务会暂停，之后电脑在线时点击继续即可。

关闭窗口后桌面端仍在后台运行。macOS 的菜单栏、Windows 和 Linux 的系统托盘里有 Favonis 的图标，点击它重新打开窗口。右键点击图标会弹出菜单，可以新建对话、打开设置；菜单里的我的电脑一行写着这台电脑在线、离线还是尚未添加文件夹，点击它打开设置 → 我的电脑。要退出时选择退出 Favonis，在 macOS 上也可以按 ⌘Q。Linux 上点击图标会直接弹出这个菜单，Windows 可能把图标收在任务栏右下角的 ^ 里。有对话回复完、你还没有查看时，图标右上角会出现一个绿点；有对话停下来等你处理（例如等你批准命令）时是橙点。在 Favonis 里打开这个对话后，点就会消失。

不想显示这个图标时，在设置 → 行为偏好的桌面端中关闭菜单栏（Windows 和 Linux 上是系统托盘）。关闭后在 macOS 上关窗口仍在后台运行，点击程序坞里的图标重新打开；在 Windows 和 Linux 上关闭窗口就会退出。

电脑睡眠时也算离线。想在离开电脑时让本地对话接着做、定时任务照常运行，在同一处打开保持电脑唤醒（菜单栏图标的菜单里也能直接勾选）：Favonis 打开期间，电脑不会因为闲置而睡眠。显示器仍会按时关闭，合上笔记本仍会让电脑睡眠。设置里没有桌面端这一节，说明桌面端版本较旧，在下载页下载新版本覆盖安装后就有。

想让电脑一开机就能被 Favonis 使用，在同一处打开开机时启动：登录电脑后 Favonis 自动打开，在 macOS 上不弹出窗口，只在程序坞和菜单栏里。之后在系统设置的登录项（Windows 上是任务管理器的启动应用）里关掉它，这里也会跟着显示为关闭。

查看交付的文件

Favonis 交付的文件和文件夹显示在回答下方，写着格式、大小和修改时间。在对话所在电脑的桌面端里，图片、视频和有缩略图的文档排成带画面的方格，点开文件会直接从这台电脑读取并预览，不经过云端；Word 文档和旧版的 PowerPoint、Excel 文件要由 Favonis 转换后才能预览，仍会取一份副本。文件右侧的在文件夹中打开跳到工作区的文件页签并找到它；在访达中显示（Windows 上是在文件资源管理器中显示，Linux 上是在文件管理器中显示）打开它所在的文件夹并选中它，点开交付的文件夹或预览不了的文件也是这样。预览这台电脑上的文件时，顶部也是在访达中显示，没有下载。

在其他设备上，电脑在线时点开文件，Favonis 从电脑取一份副本来预览，也可以下载；电脑离线时只显示名字，文件夹要在电脑上打开。

消息里引用的文件和回复里的文件链接，指的也是这个文件夹里的文件。在对话所在电脑的桌面端里点击它们，会跳到工作区的文件页签找到这个文件，能预览的同时打开预览；在其他设备上它们只显示名字，不能打开。

管理电脑

在设置 → 我的电脑中，文件夹按电脑列出所有授权的文件夹和它们的命令权限，电脑中可以重命名、移除电脑。文件夹只能在那台电脑的桌面端中添加和移除，打不开的文件夹（被删除、移动，或者所在的磁盘没有连接）会标上无法访问，macOS 不允许 Favonis 读取的会标上没有权限，在系统设置 → 隐私与安全性 → 文件和文件夹中为 Favonis 打开后即可使用；移除文件夹后，用它开过的本地对话输入框显示“在这台电脑的桌面端重新添加这个文件夹后继续”，重新添加后可以接着用。移除电脑后，它的桌面端会清除授权的文件夹，用它开过的本地对话只能查看。修改密码或重置两步验证后，所有电脑都会被移除，需要在桌面端重新添加文件夹。桌面端提示版本过旧时，在下载页下载新版本覆盖安装。