跳到主要内容

什么是 Anyy

Anyy 是一个常驻、本地优先、多端的个人助理。它以一个长期运行的进程驻留在 你自己的机器上，把会话与记忆保存在本地存储中，并且可以同时从多个端访问 —— 终端 界面、命令行、本地仪表盘，以及消息渠道。

本页是整个 wiki 的概念入口。它介绍 Anyy 的心智模型、它面向谁，以及各部分如 何协作，然后链接到深入讲解每个领域的页面。

一分钟了解 Anyy​

你只需启动 Anyy 一次，它便会持续运行。此后你可以从终端与它对话、在命令行里 抛出一个一次性问题，或者从聊天应用给它发消息 —— 而每个端背后都是同一个助理，拥有 相同的会话与记忆。

在底层，它运行一个 agent loop，可以调用工具（读写文件、执行命令、管理提醒、搜索 网络等），加载可复用的技能（skills），跨会话记住信息，并代你运行定时任务或后台 工作。任何会改变真实状态的操作 —— 编辑文件、执行命令、应用配置 —— 都会经过一个审批 环节，因此不会有任何有风险的事情在你不知情的情况下悄悄发生。

Anyy 用 Go 编写，以单个二进制 anyy 发布。驱动其推理的模型是一个可配置 的后端：你在初始化设置时选择并配置 provider。Anyy 本身才是产品 —— 它不是任何 某一个模型或 provider。

备注

Anyy 始终以 Anyy 的身份出现。底层模型是你配置的可替换后端，而不是产品的 身份。参见 配置模型。

适合谁​

Anyy 适合那些希望个人助理运行在自己可控硬件上、而不是别人云端的人：

  • 本地优先用户：希望会话、记忆和凭据都保留在自己的机器上。
  • 在多个端之间切换的人：白天在桌前用终端、在手机上用聊天应用，希望得到一个连贯的 助理，而不是若干个互不相连的助理。
  • 爱折腾的人和高级用户：希望用自己的 技能 扩展 助理，让它在系统上使用真实的 工具，同时把会改变状态 的操作保留在明确的 审批 之后。

当你为此启用可选的能力包（capability pack）时，Anyy 可以在 Linux 主机上运行并 控制本地系统，但这是可选项：默认体验是一个通用的个人助理，而不是一个系统管理工具。

心智模型​

三个词描述了 Anyy 的行为方式。记住它们，会让你在 wiki 其余部分中更容易找到方向。

常驻​

Anyy 是常驻的：一个长期运行的进程（即 gateway），你启动一次，它便在后台 持续运行。正因为它一直在线，它才能持有你的活动会话、运行定时任务和提醒、轮询消息渠道， 并接手后台工作 —— 这些对于只在单条命令执行期间存在的助理来说都是做不到的。你交互所用的 客户端（终端界面、CLI、仪表盘）只是与常驻 gateway 通信的轻量前端。参见 Gateway。

本地优先​

Anyy 是本地优先的：你的数据保存在自己机器上的 Anyy home 目录下。会话、 记忆、技能和凭据都存储在本地 —— 一个本地 SQLite 数据库 是权威存储。secrets 保存在磁盘上，并在日志和诊断中被脱敏，而模型 provider 只是你指向的 一个后端，因此你始终掌控有哪些内容会离开你的机器。

多端​

Anyy 是多端的：同一个助理可以同时从许多地方访问。用于交互式工作的终端界面、 命令行上的一次性命令、本地 Web 仪表盘，以及诸如聊天应用之类的 消息渠道，都连接到同一个常驻运行时。会话与记忆在各端 之间共享，因此你在一个地方开始的对话，换到别处继续时仍然连贯一致。

核心概念​

这就是概念地图。下面每个领域在这里只用一两句话介绍，并各自配有一个完整讲解的专门页面 —— 从最贴合你想做的事情的那个开始即可。

会话与记忆​

一个 **session（会话）**是一段持续进行、拥有自身历史的对话；Anyy 会保留 session， 以便你跨端恢复、搜索、分支和压缩它们。记忆则是持久层，它跨 session 保存事实与偏好， 让助理日后能够回忆起来。

  • Sessions —— 对话如何被跟踪、恢复，以及跨端共享。
  • 持久化记忆 —— 事实如何在单个 session 之外持续保留。

另见术语表中的 Session 与 Memory。

工具、工具集与技能​

**工具（tools）**是助理可以采取的具体动作 —— 读写文件、执行命令、管理提醒、搜索网络。 **工具集（toolsets）**把相关工具分组，让你可以控制暴露哪些能力，并让助理保持专注。 **技能（skills）**是可复用、自包含的指令包（采用 SKILL.md 格式），用于教会助理如何完成 某项特定任务，并且只在需要时才加载。

  • 工具 —— 助理能做什么，以及工具使用如何被治理。
  • 工具集 —— 对能力进行分组和暴露。
  • 技能 —— 以渐进式披露打包可复用的专门知识。

渠道与网关​

**gateway（网关）**是常驻运行时，它持有 session、运行后台工作，并居中调度每一个端。 **渠道（channels）**把外部消息平台接入该运行时，让你能从聊天应用与 Anyy 对话，并 得到与终端中相同的那个助理。

  • Gateway —— 这个常驻运行时及其所掌管的内容。
  • 消息网关 —— 把聊天平台接入为渠道。

审批与 ChangePlan​

在 Anyy 执行会改变状态或有风险的操作之前，它会暂停并等待你的明确审批。对于较大的 操作，它会准备一个 ChangePlan —— 一份结构化的提案，描述将要改变什么、涉及哪些命令、 如何验证结果，以及如何回滚 —— 由你审阅并批准后才会真正执行。

  • 审批与 ChangePlan —— 何时需要审批， 以及 ChangePlan 的生命周期如何运作。

另见术语表中的 ChangePlan。

画像与角色​

一个 **profile（画像）**是一个隔离的 Anyy 身份 —— 拥有自己的 home 目录、session、 记忆、技能和配置 —— 因此你可以把例如个人配置与工作配置分开。一个 **role（角色）**是 profile 之内更轻量的一层：它塑造人设、语气和工作方式，但不会改变 Anyy 的产品身份， 也不拥有数据、工具或权限。

  • Profiles —— 隔离的身份及其数据边界。
  • Roles —— profile 之内的人设与语气。

另见术语表中的 Profile 与 Role。

各部分如何协作​

把它们组合起来，整体图景就很清晰了。gateway 是常驻核心。你从任意端 —— 终端界面、 CLI、仪表盘，或一个消息渠道 —— 访问它。每个端驱动着由 gateway 持有的 session；这些 session 依靠记忆进行长期回忆，依靠技能获取可复用的专门知识。在一个回合中，助理调用 工具（按工具集组织）来完成真正的工作。当某个工具将要改变真实状态时，gateway 会把一个 审批 —— 对较大的改动则是一个 ChangePlan —— 路由回你当前所在的那个端。整个过程运行在一个 隔离你数据的 profile 之内，并可由一个设定人设的 role 进行点缀。

本概览之外的所有内容都在各自的页面中讲解；沿着上面的链接，即可深入任何一个领域。

下一步去哪​

准备好使用了？快速入门 会带你从安装、运行初始化设置、 开始第一次对话，一直到尝试各项关键功能。当遇到不熟悉的术语时， 术语表 定义了本 wiki 通篇使用的词汇。