跳到主要内容

术语表

本术语表定义 Anyy wiki 中使用的核心词汇。这里保持简短；链接到的概念页面会讲具体 行为和工作流。

Agent Loop​

把用户消息和组装好的上下文转成模型请求、工具调用和最终助理输出的内层循环。在 Anyy 中，这个循环是 internal/agent 下的小内核；sessions、persistence、approvals、 tools、gateway delivery、channels、compaction 等常驻运行时关注点都在它之外。

Approval​

需要用户同意或 policy confirmation 的显式 runtime gate。Approval 可以是直接确认、hook 决策， 也可以是针对更高风险工作的已批准 ChangePlan。

Artifact​

由 Anyy 跟踪的类文件对象。Artifact 可以是生成的媒体、channel attachment、可信本地 文件，或 skill 的辅助文件。Metadata 位于 state.db；bytes 可能位于 profile home 下的 private blob storage，也可能在外部可信路径中。

Background Job​

由 session 拥有的异步 child run 或托管进程。它可以在发起 reply 之后继续运行，可被查看或取消， 并通过 gateway 回报结果。

ChangePlan​

针对高风险或会改变状态的操作生成的结构化提案。ChangePlan 记录将要改变什么、受影响的 服务、验证步骤、回滚步骤、过期时间和 hash。运行时必须看到已批准的 plan ID 且 hash 匹配， 才会执行需要 ChangePlan 的操作。

Channel​

把外部消息 surface 接入常驻运行时的消息适配器。例如 Telegram、Slack、Discord、Weixin、 Email、SMS、IRC、LINE、WhatsApp、Feishu、DingTalk、QQ Bot 和 Facebook Messenger。每个 channel 都会把平台身份映射到 Anyy sessions，并把回复路由回同一平台。

Context Reference​

指向上下文的结构化指针，用于在 turn 中展开内容，而不是把所有内容直接粘到 prompt 里。 Context reference 让 Anyy 可以包含文件、artifacts、session material 和 runtime facts， 同时保持上下文组装显式、可检查。

Cron​

常驻 scheduled work。Cron job 会把 prompt 和 schedule 存在 profile state 中；gateway 稍后按配置的 role 和 workspace 执行。

Delegation​

在 child session 或 background job 中运行工作，让 parent session 仍然可用。Delegation 用于 长任务、后台 agents，以及需要自己 session state 但又要回报给发起对话的工作流。

Gateway​

常驻的 Anyy runtime。Gateway 拥有 sessions、queues、runtime state、channels、 background jobs、MCP/tool visibility、approvals 和 delivery。TUI、dashboard 和一次性 CLI 等客户端通过本地 RPC 边界与它通信。

Anyy Home​

包含某个 profile 的 config.yaml、state.db、secrets/、memory/、skills/、logs/、 raw/、workspace/、gateway socket 和 runtime metadata 的目录。

Heartbeat​

一种轻量后台状态机制，用于记录运行时服务仍然存活，并在 status 和 doctor 输出中暴露健康信息。

Memory​

跨越单个 conversation 的持久事实和偏好。Anyy 把 memory 存在本地文件中，并在 state 中 建立索引，以便后续 sessions 可以回忆相关材料。Memory 不等同于 session history：session history 是一段对话；memory 是跨 session 的回忆层。

MCP​

Model Context Protocol 集成。Anyy 可以连接已配置的 MCP servers、发现 tools，并通过 mcp-* toolsets 暴露被选中的 server tools。

Profile​

一个隔离的 Anyy 身份，拥有自己的 home directory、config、state database、secrets、 sessions、memory、skills、roles、cron jobs、channels 和 gateway socket。Profiles 可通过 --profile NAME、--profile-root PATH、ANYY_HOME 或 active-profile 文件选择。

Provider​

配置在 providers 下的模型或能力后端。Provider config 解析 credentials、model IDs、fallback routing，以及 image generation 或 TTS 等可选能力。

Residency​

把 Anyy 作为长期运行的本地服务运行，而不是单条命令调用的模式。Residency 让同一个 助理可以持续从 TUI、CLI、dashboard、channels、cron 和 background jobs 访问。

Raw Log​

存放在 raw/YYYY/MM/DD/ 下的 per-session JSONL records。Raw logs 为 retention、inspection 和 summary workflows 保留可恢复细节，而 state database 保存紧凑引用。

Role​

一个 profile 内部的人设层。Role 可以改变新 sessions 的语气、工作方式和 SOUL.md 指令， 但它不会改变 Anyy 的产品身份，也不拥有数据、权限、工具或 secrets。一个 profile 可以包含多个 roles。

Session​

一段正在进行的对话。Session 包含 messages、tool calls、selected model metadata、summaries、 lineage 和 source/surface metadata。Session 可以恢复、列出、分支、压缩、中断，或作为后台 工作的 parent。

Secret Ref​

形如 secret:path/name、env:NAME、file:/absolute/path 或 literal:value 的配置值，用于告诉 Anyy 如何解析 credential，而不是把它硬编码到主配置里。

Skill​

可复用的指令包，通常由 SKILL.md 定义，用于教 Anyy 完成某个领域任务。Skills 可以 包含辅助文件和命令。Skills runtime 只在相关时加载它们。

Tool​

运行时暴露给助理调用的能力。Tools 可以读取状态、写文件、执行命令、管理任务、搜索网络、 检查 sessions，或与已配置 integrations 交互。会改变状态的 tools 受 approval 和 ChangePlan 规则治理。

Tool Governance​

决定可见 tool calls 是直接运行、需要 approval、需要 ChangePlan，还是被拒绝的 policy 层。它包含 descriptor risk、overrides 和 MCP server policy。

Toolset​

一组具名 tools。Toolsets 让 profile 或 session 只暴露当前任务需要的能力，例如 web、 sessions、memory、file、terminal、skills、messaging 或 mcp-* toolset。

Surface​

用户与 Anyy 交互的位置，例如 TUI、one-shot CLI、dashboard、API client、cron job 或 messaging channel。

Workspace​

Profile-local context 和 artifact storage。它适合存放文件与输出，但不是安全边界或权限模型。