alpi Skill 技能

技能简介

alpi 是一个「私有的 Agent 网络」。它最初只是你终端里的一个 Agent，随后会随你一起成长：为工作、定时任务、家庭服务器、研究以及与其他 alpi 组成的工作组各建一份 profile。每一份 profile 拥有自己的记忆、密钥、模型、技能、审批策略与信任边界。ALP（Alpi Link Protocol）把这些 profile 跨机器连接起来，无需注册中心、无需中心化账号，也不强制依赖云。

它的设计目标是主权（sovereignty）：状态默认本地优先，模型由用户自持，安全是产品形态的一部分——危险命令直接被阻断且无覆盖开关，网页与邮件内容被当作敌意数据处理，技能与 MCP 在安装前先被扫描。

核心能力

• 本地优先的 profile 隔离：状态存放在 ~/.alpi/ 或具名 profile 下，记忆、会话、技能、密钥、日志与对等列表都是你机器上的文件；profile 是隔离的最小单元。
• 用户自持模型：全新 profile 不预置默认模型，你为每份 profile 自选供应商、模型、API Key 或 Ollama 服务器；通过 LiteLLM 支持任意供应商，并有每 profile 的快 / 深两档与回退。
• 三层审批的安全姿态：命令分安全 / 谨慎 / 危险三级，危险命令无配置逃逸口直接阻断，谨慎命令需交互审批或预先允许；文件与终端共用敏感路径拒绝清单，Web 工具带 SSRF 防护。
• 记忆与知识：三份纯 Markdown 文件（USER.md、MEMORY.md、AGENT.md）在对话中就地更新；可让 alpi 学习文档并沉淀为工作区里的持久 Markdown 知识，语义召回可选且可遗忘。
• 技能与 MCP 扫描：可复用技能位于 profile 自己的 skills/ 目录，经校验与安全扫描后注入系统提示；安装技能或 MCP 前做 OSV 恶意软件检查。
• 子 Agent 与自动化：只读的 research（三档深度）、可写的 delegate，以及受约束的工具工作流；守护进程托管 cron 与一次性调度，另有按需的邮件工具（IMAP 或 Gmail）。
• ALP 私有协同：ALP.1 走 Unix socket 连接同机 profile，ALP.2 用 Noise_XK 跨机器连接并带每对等方限流与预算，ALP.3 增加以 hub 为锚的工作组；对等方以 Ed25519 身份固定。
• 一体化运维：alpi doctor、alpi audit、合并日志、管理审计轨迹、加密备份，以及每台机器一个 systemd / launchd 单元与官方 Docker 镜像。

安装配置

1. 安装 CLI：执行 uv tool install alpi-agent。
2. 初始化设置：运行 alpi setup，在弹出的向导里选择模型、粘贴对应密钥，并固定一个工作区。
3. 本地推理（可选）：若要纯本地推理，先安装 Ollama，再在 alpi setup -> Model 中添加。
4. 健康检查：运行 alpi doctor 做实时健康检查；用 alpi update 检查 PyPI 并升级 alpi-agent。
5. 多 profile 管理：用 alpi profile create work 新建 profile，alpi profile list 列出，alpi -p work 使用具名 profile。

使用步骤

1. 启动交互界面：运行 alpi 进入 Textual TUI，支持流式回复、斜杠命令、实时工具卡片、中断与会话恢复。
2. 恢复上次会话：运行 alpi -c 恢复最近一次会话。
3. 一次性提问：运行 alpi chat --once "status?" 做一次输出到 stdout 的单轮对话。
4. 启动守护进程：运行 alpi daemon start 启动每台机器统一的 supervisor（调度 + ALP + 工作组 + host plane）。
5. 设置调度任务：通过守护进程托管 cron 与一次性调度，或用 alpi schedule run-once|fire 手动触发。
6. （可选）建立对等与工作组：用 alpi peers add 固定对等身份，alpi workgroup create --member 建立工作组。

适用场景

• 个人多角色 Agent 隔离：工作、家庭服务器、研究等不同角色各自独立的记忆、模型、密钥与信任边界。
• 私有的跨机器 Agent 协同：多台机器上的 profile 通过 ALP 互联，无需中心化账号或注册中心。
• 常驻自动化：用守护进程托管定时任务与 cron，适合家庭服务器或 always-on 主机（官方提供 Docker 镜像）。
• 对安全与数据主权敏感的使用者：需要本地优先、可审计、把外部内容当敌意数据处理的工作方式。
• 团队工作组协作：以 hub 为锚的工作组让一组 Agent 协同，同时受能力与预算约束。

适用人群

重视数据主权与隐私、希望模型自持的进阶个人用户；运行家庭服务器或常驻自动化的技术爱好者；需要多 profile 隔离与跨机器私有协同的开发者与小团队。

工作原理

alpi 把 profile 作为隔离原语：一份 profile 就是一个目录、一个身份、一次模型选择、一份记忆、一套技能、一张调度面与一份 ALP 对等列表，默认 profile 位于 ~/.alpi/，具名 profile 位于 ~/.alpi/profiles//。记忆是三份纯 Markdown 文件，在对话中就地更新，没有会话后的反思路径。技能是可复用配方，遵循严格的目录契约（可含指令、脚本、引用、资产、密钥与状态），任何变更都经校验与安全扫描。ALP 中每份 profile 拥有一个 Ed25519 密钥对，对等方在带外固定公钥并授予显式能力（如 link.ping、link.ask、workgroup.post）：ALP.1 走同机 Unix socket，ALP.2 用 Noise_XK over TCP 跨机器并提供预算与限流，ALP.3 以 hub 为锚组织工作组。host plane 与 ALP 分离，是配对桌面 / 移动客户端与其自有守护进程通信的设备面控制接口。

官方链接

• PyPI 主页：https://pypi.org/project/alpi-agent/
• 官网：https://www.satoshi-ltd.com/