AGPK 软件安装

AGPK — AgentOS X 软件安装体系

AGPK 是 AgentOS X 上的软件生命周期标准：发现、人选、安装、升级、卸载与校验。它和 AGIN（谁在操作）、AHCP（装上后 agent 用到什么深度）正交配合。

给谁看。AgentOS X 上的构建者、第三方软件厂商、运维与 agent 开发者——在本页按章节阅读；文末「契约下载」才是给 CI / 机器用的 JSON，不是主入口。

模型：装什么 / 怎么装 / 装上后怎么用

通道只有两条：preinstall（镜像预装运行时）与 agent_package（按本标准出的包）。apt 只是 agent 常用的命令形态，不是第三通道。

人审批（无敏感级）

1. 模型整理可选项 → agent 展示结构化列表
2. 人自主选择（无「高/中/低」敏感级门禁）
3. 装 / 升 / 卸必须确认；会话优先，桌面对话框或 TTY 兜底
4. 包无 AHCP 签名：必须额外显式 y /「我已知晓」

Agent 优先（装完即可用）

合格 AGPK 包以 agent 能发现、安装、使用、卸载 为完成线——不是仅把二进制放到盘上。公开契约要点：

装新软件 ≠ 重装系统。平台提供发现/装卸/调用协议；包提供命令面与引擎。给人看的结果走投影层（projection.*），GUI 不是 agent 主路径。

安装、发现命令与调用（在 AgentOS X 上）

装好 AgentOS X 后，CLI 与 agent 工具共用同一套语义：

# 从公开市场源发现（元数据；安装包仍从 download_uri 拉取）
agentx agpk list-options --query budget

# 安装（无签名须 -y）
agentx agpk install org.actualbudget.Actual.agent --approve -y

# 装后：列出命令面并调用（C3 / C4）
agentx agpk list-commands --package-id org.actualbudget.Actual.agent
agentx agpk invoke actual.budget.upload --args '{}'

# 查看 / 卸载
agentx agpk list
agentx agpk remove org.actualbudget.Actual.agent --approve

装上后若包内含 surface.json，宿主可注册 AHCP surface，与 AHCP 命令深度对齐。市场 live 列表见下方「软件源登记」刷新表。

构建标准（打可安装包）

最小交付物（缺命令面或使用说明 = 不可上架 healthy）：

# 推荐：市场 Vendor SDK 包（scaffold / validate / pack）
agentx agpk install org.agentnet.agpk.sdk --approve -y
# 或：agentx agpk scaffold ./my-pkg --id com.you.app --name "My App" --version 1.0.0
# 编辑 agent-commands.json + payload/
agentx agpk pack ./my-pkg
agentx agpk validate ./my-pkg   # 退出码 0 才可发布
# 上传到你的 HTTPS 源 → 在下方登记 download_uri + sha256

完整条文： 打开构建标准全文

SDK（厂商打包工具）

公开市场包 org.agentnet.agpk.sdk 1.2.0：scaffold / pack / validate，强制检查命令面与入口，模板对齐 list-commands / invoke。AgentOS X 负责装上包；SDK 负责打出合格包。

SDK 说明全文 · 下载：AGPK-MARKET agpk-sdk-v1.2.0

AgentNet 官方市场包（可安装 · 非预装）

下列为当前维护的可安装 AGPK 包完整列表（发现 → 下载 → 安装 → list-commands / invoke）。与「系统预装」无关。机器可读同源：firstparty-catalog.json；live 发现 API：GET https://api.agentnet.ink/share/v1/agpk/sources。

边界（请勿混淆）： Office 办公套件与 IM 是系统预装产品，不是 AGPK 市场包，不会出现在上表或市场源中。 付费只影响预装 Office 能力权益，不挡 ISO 下载。

软件源登记（share · 只元数据）

与 MCP 备案同哲学：只备案、不审批。share 永不存安装包（含自有），只登记软件名、功能、服务商、下载源头、哈希。AgentOS X 从 share 发现后，在本机按链接下载安装。

• 网页：任何人可填 POST /api/agpk/sources → 内部标 有风险 · 未知提供商。
• 工具：仅本站登录用户 POST /api/agpk/sources/tool（或工具 agpk.source.register）→ 已知站内用户。
• 自动工人（持续运行）：探活（HTTPS 可达 + sha256）→ 命令面门禁 → 开源扫描 → 升 healthy 或 rejected/discarded。同一 package_id 新版本 healthy 后，旧 live 行自动废弃。周期复探 live 源：链接失效或哈希漂移则移出可发现列表。
• 高危：账号用户拒绝+系统邮件；匿名直接废弃且不通知。

curl -sS -X POST https://www.aiagentnet.club/api/agpk/sources \\
  -H 'content-type: application/json' \\
  -d '{"package_id":"com.example.tool","name":"Example Tool","version":"1.0.0","summary":"demo","vendor_name":"Example Co","download_uri":"https://example.com/tool-1.0.0.tar.gz","sha256":"<64-hex>"}'

登录用户工具登记：POST /api/agpk/sources/tool（须会话；工具名 agpk.source.register）。列表：GET /api/agpk/sources。

最小交付物（速查）

agpk.json · payload/ · agent-commands.json · USAGE / AGENT_CAPABILITIES · DIGESTS · INSTALL · UNINSTALL · 签名或 ahcp.signed=false · 推荐 surface.json

契约下载（机器 / CI · 次入口）

给人读的是上面各节；下列供脚本校验与导入：

# 仅 CI / 工具需要时拉取契约
curl -sS https://docs.aiagentnet.club/agpk/v1/schema.json | jq .title
curl -sS https://docs.aiagentnet.club/agpk/v1/firstparty-catalog.json | jq '.packages[].package_id'