项目概览：认识 AI 桌面工作台

useAiWork 是一款个人 AI 桌面工作台。打开后，你可以直接和 AI 聊天，也可以创建一个项目，关联电脑上的文件夹，让 AI 围绕其中的文件帮你阅读、分析和修改内容。

在这个项目实践中，我们会一步步做出这款桌面应用。这一篇先认识它的几个主要部分：项目用来关联文件，聊天用来讨论需求，AI 根据需求查看和修改文件，工作台则保留处理过程，供你检查和继续。

工作台由哪些部分组成

假设你有一个个人网站，希望请 AI 帮忙调整首页文案。工作台需要知道网站文件在哪里，也需要记住你想改什么，最后还要让你看到修改结果。围绕这件事，可以把工作台分成下面几部分：

这几部分连起来，就形成了一条工作流程：选定项目 → 在聊天中说明要求 → AI 查看相关文件 → 按要求处理 → 检查结果 → 继续讨论。

其中，项目回答“处理哪份文件”，聊天回答“这次要做什么”。文件操作把修改真正保存到电脑上，处理记录则帮助你核对发生了什么。后续即使调整页面布局，这些功能之间的关系仍然是认识工作台的基础。

日常问答，直接放进公共聊天

不涉及本机文件的问题，可以从公共聊天开始。解释一个概念、讨论一个想法，或者把一段文字贴进来请 AI 帮忙整理，都可以在这里进行。

每条聊天保留自己的消息和草稿。发出问题后，AI 的回复会逐步显示，你可以继续追问，也可以复制需要的内容。

生成过程中可以停止，失败后可以查看错误并重试。尚未发送的文字作为草稿保留，便于切换聊天后回来继续写。

公共聊天没有本机文件操作能力。要让 AI 查看电脑上的项目，需要先把这份工作放进项目聊天。

一个项目，收拢一组相关的文件和聊天

工作台里的“项目”可以理解为一个工作分组：它有自己的名称，关联一组本机文件夹，下面可以创建多条聊天。

例如，你可以创建一个“个人网站”项目，关联网站代码和素材文件夹，再把不同目标分开讨论：

这些名称只是使用示例。实际使用时，可以按自己的目标命名和组织聊天。

这样安排以后，查找一项工作可以先找到项目，再找到对应的讨论。同一份网站文件不必为了每个目标重复添加，几个不同目标的聊天也各自保留记录。

项目可以关联多个文件夹，因此代码、文档和素材分放在不同位置时，仍然可以归到同一项工作中。添加文件夹只是建立关联，不会把整份目录搬进工作台，也不会立即扫描并上传其中的所有内容。

项目和聊天可以重命名、置顶和排序。暂时不用的聊天可以归档，需要时再恢复；聊天也可以在项目之间移动，或移回公共聊天。移除项目配置不会删除磁盘上的文件夹。

一次文件处理怎样完成

继续以个人网站为例。关联网站文件夹以后，可以在项目中创建一条聊天，先请 AI 了解已有内容：

看一下这个项目的目录和说明文件，告诉我它主要做什么，暂时不要修改文件。

AI 会根据这次要求浏览目录、读取相关文件，再说明它看到的内容。工作台会记录文件操作及其结果，让你能核对它读了什么；操作失败时，也能查看原因。这一步先建立对现有内容的共同理解。

了解项目后，再给出更具体的修改要求。例如：

找到首页的欢迎文案，把它改为“欢迎来到我的个人网站”。保留其他内容，修改后告诉我改了哪里。

接下来，AI 查找对应内容并进行修改，工作台保留修改前后的片段。你可以检查它是否找对了文案、是否保留了其他内容。如果还要调整，就在同一条聊天里补充要求；新的目标则可以另开一条聊天。

这里需要分清两种结果：AI 在回复里给出一段建议文案，供你参考；文件修改成功，则表示电脑上的文件已经发生变化。检查任务是否完成，要同时看回复和实际文件操作的结果。

项目聊天会直接影响关联文件夹中的文件。 阅读和讨论可以先进行，准备修改时再把目标、范围和需要保留的内容说清楚。点击停止后，已经保存的修改仍会保留，需要结合操作记录检查结果。

当前版本尚未接入终端执行，不能替你启动网站、安装依赖或运行测试，也没有完整的代码编辑器和整个仓库的变更对比页面。它现阶段适合先完成“看文件、理解内容、做一处明确修改”这样的协作。

设置与记录，支持下一次继续工作

工作台还需要管理使用环境。设置中可以调整主题、界面语言和开屏动画，查看本机服务连接、模型配置状态以及应用更新信息。使用 AI 聊天前，需要具备可用的模型配置；本机服务已连接，并不代表模型一定能够正常回复。

设置中还有“伴侣资料”，可以编辑伴侣名称、简介、对你的称呼和交流偏好。这是工作台里的一个独立功能。目前保存这些资料，并不意味着它们已经用于所有聊天的回答。

项目配置、聊天记录和草稿等保留在本机，方便下次打开后接着工作。不过，使用远程模型时，本次回答需要的消息和相关文件片段仍会发送给模型服务。“安装在电脑上”并不等于完全离线。

项目的当前范围

目前，工作台的主要能力集中在聊天、项目管理和本机文件处理。围绕一个项目提出要求，让 AI 阅读内容、完成一处明确的修改，再检查结果，是当前可以认识和实践的主要流程。

项目中也有定时任务、资料库和插件等功能区。其中，定时任务仍是配置预览，尚不能保存并自动执行；资料库尚未接入资料导入，第三方插件安装与执行也尚未开放。它们可以帮助了解项目准备扩展的方向，但不能作为已经可用的能力。

带着一项小任务认识整个项目

如果把这款应用放到一次具体使用中，它的轮廓就很清楚了：你创建“个人网站”项目，关联本机目录，在项目下面新建“认识项目”聊天，让 AI 先阅读说明；确认它理解了文件内容，再提出一处文案修改，查看修改记录并核对文件。下次打开工作台，还能从这段聊天继续。

这就是 useAiWork 当前的主要面貌：以聊天推进工作，以项目组织文件和讨论，让本机文件处理的过程也能在对话里查看。 后续的项目实践会围绕这条流程，逐步完成项目管理、聊天、文件处理和记录保存等功能。