For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Use/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Use/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Use/index.md.
  • 简体中文
  • OPEN SOURCE · AI NATIVE PACKAGE MANAGER

    为软件安装包。为 Agent 安装能力。

    A3S Use 为 Linux、macOS 与 Windows 上的原生工具和 A3S 认知插件提供统一、可验证的包生命周期。

    v0.2 包管理基础已可用认知插件平台开发中
    安装已验证版本通过 A3S CLI 安装完整发布包
    $ a3s install use --source release
    PACKAGE INSPECTIONschema v3
    $ a3s-use capability snapshot --json
    acme/research@2.0.0
    目标
    darwin-arm64
    信任
    TUF · SHA-256 verified
    代际
    0042 · 7f3a…e91c
    ToolconvertREADY
    MCPlibraryREADY
    SkillreviewREADY
    UIreviewREADY
    OKFdomain-knowledgeTARGET
    能力投影已就绪
    TRUST PATHroot → snapshot → target
    TARGETSLINUX · MACOS · WINDOWS
    ONE PACKAGE · TWO PLANES

    一个不可变身份,同时承载原生程序与认知表面

    传统包管理器在文件落盘后结束。目标平台还会验证包声明的 Tool、MCP、Skill、UI 与 OKF 知识,并将可用证据投影给宿主。

    NATIVE PLANE

    平台原生执行

    目标相关的可执行文件、运行时资产、原生 argv 与标准进程状态。

    COGNITIVE PLANE

    Agent 可发现能力

    内容绑定的指令、工具依赖、MCP 服务、沙箱 UI 与可共享 OKF 知识,不从文本获得额外权限。

    选择一个表面查看它的运行边界

    ToolTASK / SERVICE

    保留原生 CLI 或 HTTP 合约

    Tool 是由 Runtime 管理的工作负载,不是私有 action 协议,也不是 MCP tools/list 项。

    • provider evidence
    • exact generation
    • bounded I/O
    TRUSTED LIFECYCLE

    先证明,再发布能力

    搜索只读取已签名元数据;真正变更之前,目标、权限、提供者和影响都被绑定进不可变计划。

    01

    发现

    刷新并搜索 TUF 签名目录,不下载包体。

    02

    计划

    固定包摘要、表面、权限与 Runtime 证据。

    03

    授权

    ACL 策略和用户确认绑定同一个计划摘要。

    04

    暂存

    在有界目录中验证归档、ACL 清单与内容。

    05

    协调

    准备授权、Runtime 绑定、投影与依赖闭包。

    06

    发布

    原子切换能力代际,并排空旧代际调用。

    CLEAR OWNERSHIP

    一个 Manager,一套生命周期事实

    CLI、Web 与 Agent 管理 MCP 共用同一个 Plugin Manager。A3S Use 管包与证据;Runtime 管工作负载;宿主管策略、凭据和渲染。

    阅读架构说明
    LOCALRELEASETUF
    包来源共享 Plugin Manager目录 · 策略 · 确认 · plan/apply · replay
    A3S Use 包引擎verify · stage · receipt · grant · reconcile
    原生 + 认知表面Tool · MCP · Skill · UI · OKF
    A3S 宿主A3S Code · Web · Knowledge · agents
    SECURE BY EVIDENCE

    包内容不能给自己授权

    Skill 文本、UI 消息、OKF 知识、工具输出和远端内容都被视为数据。权限只能来自宿主策略、明确授权与代际绑定的收据。

    PROVENANCE

    可验证供应链

    固定 TUF 根、签名元数据、长度与 SHA-256,并拒绝回滚和过期状态。

    PLAN DIGEST

    默认拒绝漂移

    应用前重新解析;版本、内容、权限或提供者变化都会要求重新审查。

    NO AMBIENT AUTHORITY

    精确代际授权

    Grant、Runtime binding、route lease 与能力快照都绑定同一包代际。

    CROSS-PLATFORM

    一个包模型,覆盖三类桌面平台

    macOS 与 Linux 已覆盖完整发布包和包生命周期;Windows x86_64 当前为 Preview,并持续补齐运行时与插件生命周期门禁。

    LLinuxSUPPORTED
    MmacOSSUPPORTED
    WWindowsPREVIEW
    START WITH THE FOUNDATION

    先检查本机能力,再构建认知包

    安装 v0.2 发布版,运行 doctor 和 capability snapshot;认知插件开发请以 schema-v3 合约与路线图为准。