agent-resource-management 1.3.0

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/AGENT.md

@@ -0,0 +1,18 @@
+---
+name: 仿真调试助手
+version: 1.0.0
+description: 
+skills:
+
+knowledges:
+  - 仿真平台当前运行实例及实例运行日志排查.md
+  - 仿真平台任务触发吸收器与占位触发吸收器使用场景.md
+  - 仿真平台Loki日志排查方法.md
+  - 仿真平台后端Swagger接口文档.md
+  - 仿真货载生命周期查询流程.md
+  - 仿真平台接口排查背景知识.md
+  - 天车调度系统重组接口调用与日志分析方法.md
+---
+
+# System Prompt
+你是仿真调试助手

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260Loki/346/227/245/345/277/227/346/216/222/346/237/245/346/226/271/346/263/225.md

@@ -0,0 +1,27 @@
+## 仿真平台日志排查流程
+
+### Loki日志平台地址
+```
+http://192.168.59.100:4000/explore?schemaVersion=1&panes=%7B%22rxo%22:%7B%22datasource%22:%22P8E80F9AEF21F6940%22,%22queries%22:%5B%7B%22refId%22:%22A%22,%22expr%22:%22%7Bhost_name%3D%5C%22192.168.58.23%5C%22%7D%20%7C%3D%20%60%60%22,%22queryType%22:%22range%22,%22datasource%22:%7B%22type%22:%22loki%22,%22uid%22:%22P8E80F9AEF21F6940%22%7D,%22editorMode%22:%22builder%22,%22direction%22:%22backward%22%7D%5D,%22range%22:%7B%22from%22:%22now-1h%22,%22to%22:%22now%22%7D,%22compact%22:false%7D%7D&orgId=1
+```
+
+### 日志查询方法
+
+#### 1. 通过host_name过滤
+- 使用 `host_name` 标签指定对应的环境
+- 示例：`{host_name="192.168.58.23"}`
+
+#### 2. IP地址模糊匹配流程
+如果用户提供的是模糊地址（如只提供部分IP或描述性信息）：
+1. 先查询**仿真平台实例列表**
+2. 从实例列表中匹配对应的host_name
+3. 使用匹配到的host_name查询日志
+
+#### 3. 查询限制（重要）
+- **必须给定查询参数**，不能空查询
+- **限制查询行数在200条以内**，避免查询过大导致性能问题
+
+### 使用场景
+- 仿真平台环境故障排查
+- 通过host_name定位特定环境的日志
+- IP地址不明确时先查询实例列表再查询日志

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/344/273/273/345/212/241/350/247/246/345/217/221/345/220/270/346/224/266/345/231/250/344/270/216/345/215/240/344/275/215/350/247/246/345/217/221/345/220/270/346/224/266/345/231/250/344/275/277/347/224/250/345/234/272/346/231/257.md

@@ -0,0 +1,18 @@
+## 问题描述
+货载编码: 10021，从库位由堆垛机运送到指定点位，任务hl_1774014921000_01，但货载没被吸收。
+
+## 根本原因
+点位10021配置的是**任务触发吸收器**，但这个吸收器类型只适用于**输送线任务**。
+
+10021点位是堆垛机放货点，不存在输送线任务，因此任务触发吸收器无法正常工作。
+
+## 解决方案
+将点位10021的吸收器类型从**任务触发吸收器**改为**占位触发吸收器**。
+
+## 知识点
+1. **任务触发吸收器**：适用于输送线任务，需要任务关联才能触发
+2. **占位触发吸收器**：适用于堆垛机放货点等场景，当货物占位时自动触发吸收，不依赖任务关联
+
+## 配置建议
+- 堆垛机放货点 → 使用占位触发吸收器
+- 输送线转运点 → 使用任务触发吸收器

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/345/220/216/347/253/257Swagger/346/216/245/345/217/243/346/226/207/346/241/243.md

@@ -0,0 +1,22 @@
+## 仿真平台后端接口访问
+
+### 默认端口
+仿真平台后端服务默认端口为 **6173**
+
+### Swagger文档地址
+- Swagger UI: `http://{IP}:6173/swagger/index.html`
+- Swagger JSON: `http://{IP}:6173/swagger/Default/swagger.json`
+
+### 接口示例
+以192.168.57.140环境为例：
+- Swagger UI: http://192.168.57.140:6173/swagger/index.html
+- Swagger JSON: http://192.168.57.140:6173/swagger/Default/swagger.json
+
+### 使用场景
+1. 查看仿真平台提供的所有REST API接口
+2. 查看接口的请求参数、响应格式
+3. 在线测试API接口
+4. 了解接口的数据模型和Schema
+
+### 访问方式
+直接通过浏览器访问Swagger UI即可查看完整的API文档，支持在线调试。

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/345/275/223/345/211/215/350/277/220/350/241/214/345/256/236/344/276/213/345/217/212/345/256/236/344/276/213/350/277/220/350/241/214/346/227/245/345/277/227/346/216/222/346/237/245.md

@@ -0,0 +1,39 @@
+## 仿真平台当前运行实例查询：
+接口地址： [仿真运行实例查询接口](http://192.168.59.100:4000/api/datasources/uid/P8E80F9AEF21F6940/resources/label/host_name/values)  
+返回示例：
+```
+{"status":"success","data":["192.168.153.28","192.168.153.65","192.168.52.200","192.168.53.106","192.168.53.168","192.168.53.190","192.168.53.191","192.168.53.192","192.168.53.206","192.168.53.222","192.168.57.140","192.168.57.142","192.168.58.17","192.168.58.23","192.168.58.40","192.168.59.201","192.168.59.206","LAPTOP-J33NTVH2","LAPTOP-OOUL30MV","LAPTOP-QEBNIM3K","iw-simulation.loong-prod","iw-simulation.wms-v3-3","loong-demo","xuanwu-sim"]}
+```
+
+可添加参数 start 、 end ，时间戳，排查指定时间段内的仿真运行实例：
+```
+http://192.168.59.100:4000/api/datasources/uid/P8E80F9AEF21F6940/resources/label/host_name/values?start=1774842375104000000&end=1774863975104000000
+```
+
+## 仿真平台日志排查流程
+
+### Loki日志平台地址
+```
+http://192.168.59.100:4000/explore?schemaVersion=1&panes=%7B%22rxo%22:%7B%22datasource%22:%22P8E80F9AEF21F6940%22,%22queries%22:%5B%7B%22refId%22:%22A%22,%22expr%22:%22%7Bhost_name%3D%5C%22192.168.58.23%5C%22%7D%20%7C%3D%20%60%60%22,%22queryType%22:%22range%22,%22datasource%22:%7B%22type%22:%22loki%22,%22uid%22:%22P8E80F9AEF21F6940%22%7D,%22editorMode%22:%22builder%22,%22direction%22:%22backward%22%7D%5D,%22range%22:%7B%22from%22:%22now-1h%22,%22to%22:%22now%22%7D,%22compact%22:false%7D%7D&orgId=1
+```
+
+### 日志查询方法
+
+#### 1. 通过host_name过滤
+- 使用 `host_name` 标签指定对应的环境
+- 示例：`{host_name="192.168.58.23"}`
+
+#### 2. IP地址模糊匹配流程
+如果用户提供的是模糊地址（如只提供部分IP或描述性信息）：
+1. 先查询**仿真平台实例列表**
+2. 从实例列表中匹配对应的host_name
+3. 使用匹配到的host_name查询日志
+
+#### 3. 查询限制（重要）
+- **必须给定查询参数**，不能空查询
+- **限制查询行数在200条以内**，避免查询过大导致性能问题
+
+### 使用场景
+- 仿真平台环境故障排查
+- 通过host_name定位特定环境的日志
+- IP地址不明确时先查询实例列表再查询日志

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/345/271/263/345/217/260/346/216/245/345/217/243/346/216/222/346/237/245/350/203/214/346/231/257/347/237/245/350/257/206.md

@@ -0,0 +1,49 @@
+仿真平台接口排查背景知识
+1. 背景说明
+该文档用于沉淀仿真平台后端接口排查时的通用背景信息，方便在故障定位、接口验证、环境巡检时快速确认默认访问方式。
+2. 默认端口
+仿真平台后端服务默认端口为：
+6173
+在未特殊说明的情况下，可优先按该端口判断后端服务是否启动、接口是否对外暴露。
+3. Swagger 默认开放路径
+Swagger 页面默认对外开放路径为：
+/swagger/index.html
+因此，通常可以通过以下方式访问目标实例的接口文档页面：
+http://<host>:6173/swagger/index.html
+4. Swagger JSON 路径示例
+Swagger JSON 示例地址如下：
+192.168.57.140:6173/swagger/Default/swagger.json
+通用访问格式可参考：
+http://<host>:6173/swagger/Default/swagger.json
+5. 典型用途
+5.1 验证后端接口服务是否可达
+当怀疑某个仿真实例后端接口未正常启动时，可优先访问 Swagger 页面或 Swagger JSON 地址，确认：
+- 端口是否可连通
+- HTTP 服务是否正常返回
+- 接口定义是否已成功加载
+5.2 快速确认接口能力
+当需要了解某实例当前暴露了哪些接口时，可直接访问 Swagger 页面进行查看，而不必先登录代码仓库或部署系统。
+5.3 排查环境差异
+不同环境、不同实例若存在接口不一致、版本不一致、发布不完整等情况，可通过 Swagger JSON 内容进行快速比对。
+6. 推荐排查步骤
+1. 先确认目标主机地址或实例名
+2. 访问：
+  - http://<host>:6173/swagger/index.html
+  - http://<host>:6173/swagger/Default/swagger.json
+3. 根据返回情况判断：
+  - 无法连接：优先排查端口、网络、服务进程
+  - 页面 404 / JSON 404：优先排查服务部署是否完整、Swagger 是否启用、路径是否变更
+  - 页面可访问但接口异常：继续下钻具体接口调用与日志
+4. 如涉及多实例问题，建议结合实例清单、时间窗口、日志平台进行交叉验证
+7. 注意事项
+- 6173 为默认端口，若某些环境有定制化配置，应以实际部署为准
+- Swagger 页面可访问，不代表所有接口逻辑均正常，仅说明 Web 服务和文档暴露层面基本可达
+- 若 Swagger 页面被网关、鉴权或反向代理改写，实际路径可能存在差异
+- swagger/Default/swagger.json 为当前已知示例路径，若服务分组名称变化，JSON 路径也可能调整
+8. 推荐关键词
+仿真平台、后端端口、6173、Swagger、接口排查、swagger.json、接口文档、服务可达性
+9. 结论
+后续进行仿真平台接口排查时，可默认优先尝试以下两个入口：
+http://<host>:6173/swagger/index.html
+http://<host>:6173/swagger/Default/swagger.json
+它们可作为接口服务存活、文档暴露和版本能力确认的基础检查项。

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//344/273/277/347/234/237/350/264/247/350/275/275/347/224/237/345/221/275/345/221/250/346/234/237/346/237/245/350/257/242/346/265/201/347/250/213.md

@@ -0,0 +1,165 @@
+Runbook｜货载生命周期查询流程
+适用场景
+- 用户需要查询某个位置最近一条货载的完整流转过程
+- 用户提供的是位置编码（如 21065），希望追溯该位置上最近一条货载的全生命周期
+- 需要判断货载是用户手工添加，还是设备执行过程中自动生成
+目标输出
+完成一次标准查询后，至少输出以下内容：
+1. 目标位置最近一条相关货载
+2. 对应 cargoId
+3. 该货载按时间排序的完整生命周期
+4. 生命周期路径汇总
+5. 对“是否自动生成”的初步判断
+6. 事实、推断、待验证项分离
+
+---
+查询思路总览
+第一步：先查目标位置最近一条货载变更记录
+优先使用接口：
+- POST /api/systemLog/cargoLogPage
+推荐请求体：
+{
+  "page": 1,
+  "pageSize": 1,
+  "field": "createTime",
+  "desc": true,
+  "currentLocation": "21065"
+}
+说明：
+- currentLocation 传目标位置编码
+- field=createTime + desc=true 用于取最近一条
+- 从返回结果中提取：
+  - cargoId
+  - palletCodes
+  - changeType
+  - previousLocation
+  - currentLocation
+  - deviceCode
+  - deviceName
+  - commandNo
+  - commandDescribe
+  - createTime
+
+---
+第二步：使用 cargoId 反查完整生命周期
+仍使用接口：
+- POST /api/systemLog/cargoLogPage
+推荐请求体：
+{
+  "page": 1,
+  "pageSize": 100,
+  "field": "createTime",
+  "desc": false,
+  "cargoCode": "<cargoId>"
+}
+说明：
+- 这里的 cargoCode 实际可传日志中的 cargoId 做反查
+- desc=false 表示按时间正序，便于还原生命周期
+- pageSize 建议先取 100；如日志更多，再翻页
+
+---
+第三步：对日志去重并还原主链路
+实际查询中，日志可能存在重复写入。建议按以下字段组合去重：
+- createTime
+- changeType
+- previousLocation
+- currentLocation
+- deviceCode
+- commandNo
+去重后再整理主链路，避免同一步骤重复展示两次。
+
+---
+第四步：提炼生命周期结论
+至少要整理出：
+- 最早一条记录是否为 新增
+- 初始位置与初始设备挂载位置
+- 中间经过的设备、任务号、位置链路
+- 最终到达目标位置的时间
+推荐同时输出一条“路径汇总”：
+位置A -> 位置B -> 位置C -> 位置D
+
+---
+自动生成货载的判断方法
+当满足以下特征时，可初步判断该货载为“设备执行过程中自动生成”：
+1. 生命周期最早记录包含 新增
+2. 货载标签带设备/任务特征，例如：
+  - Crane-13451-1-20-4
+3. 初始位置或初始挂载点表现为设备单元，例如：
+  - DV_NO.A04005_U1
+4. 货载标签或详情中存在首关联信息，例如：
+  - firstCommandNo
+  - firstLocation
+  - firstDevice
+5. 后续日志能连续串起设备执行链路
+注意：
+- 以上只能作为高概率判断依据
+- 如果要形成最终结论，建议再结合设备指令日志或任务执行日志核实
+
+---
+推荐输出模板
+一、货载基础信息
+- 货载ID：<cargoId>
+- 货载标签：<palletCodes>
+- 最近命中位置：<location>
+- 最近命中时间：<createTime>
+- 首关联设备：<firstDevice 或 deviceCode>
+- 首关联任务号：<firstCommandNo 或 commandNo>
+二、全生命周期表
+时间
+变更类型
+上个位置
+当前位置
+设备编码
+设备名称
+任务号
+说明
+...
+...
+...
+...
+...
+...
+...
+...
+三、生命周期路径汇总
+<位置1> -> <位置2> -> <位置3> -> ... -> <目标位置>
+四、结论
+- 该货载是否已完整追溯
+- 是否疑似自动生成
+- 当前最终位置
+五、待验证项
+- 虚拟位置含义是否明确
+- 是否存在日志双写/重复写入
+- 是否需要反查任务日志确认自动生成证据
+
+---
+排查注意事项
+1. 位置查询只看 currentLocation 时，查到的是“进入该位置”的记录
+2. 如果要查“位置相关最近 5 条”，应同时考虑：
+  - currentLocation = 目标位置
+  - previousLocation = 目标位置
+3. cargoLogPage 返回的数据可能存在重复记录，必须去重后再输出
+4. /api/cargo/cargoListByIds 可能返回空，不可单独依赖业务表结果；日志链路通常更稳定
+5. 结论中必须区分：
+  - 事实：接口返回的日志内容
+  - 推断：基于标签/设备/任务链路的判断
+  - 待验证项：仍需任务日志佐证的部分
+
+---
+实战示例（21065）
+示例目标位置：21065
+查询结果表明：
+- 最近一条相关货载的 cargoId 为：789635517284423
+- 货载标签：Crane-13451-1-20-4
+- 最早记录出现 新增
+- 生命周期从设备挂载点开始，随后经过堆垛机、输送线004、输送线003，最终到达 21065
+- 可初步判断该货载为设备执行过程中自动生成
+该示例适合作为：
+- 位置追溯货载生命周期的标准案例
+- 自动生成货载判断的参考案例
+
+---
+建议后续扩展
+后续可补充两个配套 runbook：
+1. 按 cargoId 直接查询货载全生命周期
+2. 按任务号反查货载生成与流转证据链

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//345/244/251/350/275/246/350/260/203/345/272/246/347/263/273/347/273/237/351/207/215/347/273/204/346/216/245/345/217/243/350/260/203/347/224/250/344/270/216/346/227/245/345/277/227/345/210/206/346/236/220/346/226/271/346/263/225.md

@@ -0,0 +1,137 @@
+# 天车调度系统重组接口调用与日志分析
+
+## 问题背景
+天车调度系统调用重组接口后未生成调度结果，需要通过日志分析定位问题根因。
+
+## 接口信息
+
+### 1. 天车重组接口
+- **地址**: `http://192.168.58.22:8000/dcs_api_v1/world_schedule`
+- **方法**: POST
+- **参数**: 无
+- **返回**: 包含 `trace_id` 用于日志追踪
+
+### 2. 日志查询接口
+- **地址**: `http://192.168.58.22:8000/api/logs/search_trace/{trace_id}`
+- **方法**: GET
+- **参数**: trace_id（从重组接口返回的请求ID）
+
+## 问题分析方法
+
+### 步骤1：调用重组接口
+```bash
+curl -X POST http://192.168.58.22:8000/dcs_api_v1/world_schedule
+```
+
+获取返回的 `trace_id`，例如：`37113fad63f8`
+
+### 步骤2：查询过程日志
+```bash
+curl -X GET http://192.168.58.22:8000/api/logs/search_trace/37113fad63f8
+```
+
+### 步骤3：分析关键日志信息
+在日志中搜索以下关键词：
+
+#### 关键信息1：任务过滤情况
+```
+过滤前X个item,过滤后...
+```
+- 如果显示“过滤后没有任务item”，说明没有可调度的任务
+- 如果显示“过滤后没有isReady为true的任务item”，说明任务存在但未就绪
+
+#### 关键信息2：设备状态
+```
+设备ID, 设备类型, Weight: 当前载重/最大载重, onboard Tasks: 任务列表
+```
+- 检查所有设备是否空闲
+- 确认设备载重情况
+
+#### 关键信息3：移动记录
+```
+设备ID 第X次, 移动记录：[]
+```
+- 如果移动记录为空，说明没有生成调度方案
+
+## 常见问题与解决方案
+
+### 场景1：没有可调度的任务
+**症状**：
+```
+过滤前5个item,过滤后没有设备类型为FA_FLAT_WORK_AREA的任务item
+```
+
+**原因**：
+- 任务类型不匹配（系统只调度特定类型任务）
+- 所有任务已完成或未创建
+
+**解决方案**：
+```sql
+-- 1. 检查任务表
+SELECT * FROM overhead_crane_tasks WHERE status = 'pending';
+
+-- 2. 检查任务类型
+SELECT * FROM overhead_crane_tasks WHERE device_type = 'FA_FLAT_WORK_AREA';
+
+-- 3. 创建测试任务（如需要）
+INSERT INTO overhead_crane_tasks (...) VALUES (...);
+```
+
+### 场景2：任务存在但未就绪（isReady=false）
+**症状**：
+```
+过滤前2个item,过滤后没有isReady为true的任务item
+```
+
+**原因**：
+- 前置条件未满足（如依赖任务未完成）
+- 任务状态异常
+- 时间窗口问题
+
+**解决方案**：
+```sql
+-- 1. 查看任务详情
+SELECT * FROM overhead_crane_tasks WHERE is_ready = false;
+
+-- 2. 检查任务创建流程
+SELECT * FROM overhead_crane_tasks ORDER BY created_at DESC LIMIT 10;
+
+-- 3. 手动设置就绪（谨慎操作）
+UPDATE overhead_crane_tasks SET is_ready = true WHERE id = 'xxx';
+```
+
+### 场景3：所有设备空闲但无调度
+**症状**：
+```
+FA_A_01, DV_A_TC_R, Weight: 0/30000.0, onboard Tasks: None
+FA_A_01, DV_A_TC_L, Weight: 0/25000.0, onboard Tasks: None
+```
+
+**原因**：
+- 系统中确实没有待调度任务
+- 任务已被其他调度实例处理
+
+**解决方案**：
+1. 检查任务创建流程
+2. 确认是否有其他调度实例在运行
+3. 创建新测试任务验证
+
+## 排查清单
+
+- [ ] 调用重组接口并记录 trace_id
+- [ ] 查询日志获取执行过程
+- [ ] 检查任务过滤情况（过滤前/后数量）
+- [ ] 确认设备状态（是否空闲、载重情况）
+- [ ] 查看任务表数据
+- [ ] 检查任务类型是否匹配
+- [ ] 检查任务 isReady 状态
+- [ ] 分析任务创建和状态更新逻辑
+- [ ] 必要时创建测试任务验证
+
+## 最佳实践
+
+1. **保存 trace_id**：每次调用重组接口后保存 trace_id，便于后续追踪
+2. **定期检查日志**：关注“过滤前/后”任务数量变化
+3. **监控设备状态**：确认设备是否正常注册和在线
+4. **任务状态管理**：定期检查任务表，清理异常状态的任务
+5. **版本控制**：记录调度系统的版本变更，便于问题追溯

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "agent-resource-management",
+  "version": "1.3.0",
+  "type": "module",
+  "bin": {
+    "arm": "./dist/main.js"
+  },
+  "scripts": {
+    "dev": "bun run src/main.ts",
+    "build": "bun build src/main.ts --outdir dist --target node && echo '#!/usr/bin/env node' | cat - dist/main.js > temp && mv temp dist/main.js && chmod +x dist/main.js",
+    "start": "bun run dist/main.js"
+  },
+  "dependencies": {
+    "undici": "^6.13.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.4.0"
+  }
+}

package/src/cmd/agent.ts

@@ -0,0 +1,137 @@
+import { ApiClient } from '../lib/client';
+import { loadConfig } from '../lib/storage';
+import { formatAgent, formatAgentDetail, success, error, info } from '../lib/formatter';
+import { writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+import { mkdtempSync, rmSync } from 'fs';
+
+export async function listAgents(): Promise<void> {
+  const config = loadConfig();
+  if (!config?.token) {
+    error('未登录，请先运行 arm login');
+    process.exit(1);
+  }
+
+  const client = new ApiClient(config.serverUrl, config.token);
+  try {
+    const result = await client.listAgents();
+    if (result.agents.length === 0) {
+      info('暂无 Agent');
+      return;
+    }
+    console.log(`\n共 ${result.total} 个 Agent:\n`);
+    for (const agent of result.agents) {
+      console.log(formatAgent(agent));
+      console.log('');
+    }
+  } catch (err) {
+    error(`获取列表失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}
+
+export async function searchAgents(keyword: string): Promise<void> {
+  const config = loadConfig();
+  if (!config?.token) {
+    error('未登录，请先运行 arm login');
+    process.exit(1);
+  }
+
+  const client = new ApiClient(config.serverUrl, config.token);
+  try {
+    const result = await client.listAgents(keyword);
+    if (result.agents.length === 0) {
+      info(`没有找到包含 "${keyword}" 的 Agent`);
+      return;
+    }
+    console.log(`\n找到 ${result.total} 个结果:\n`);
+    for (const agent of result.agents) {
+      console.log(formatAgent(agent));
+      console.log('');
+    }
+  } catch (err) {
+    error(`搜索失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}
+
+export async function infoAgent(name: string): Promise<void> {
+  const config = loadConfig();
+  if (!config?.token) {
+    error('未登录，请先运行 arm login');
+    process.exit(1);
+  }
+
+  const client = new ApiClient(config.serverUrl, config.token);
+  try {
+    const result = await client.listAgents(name);
+    const agent = result.agents.find((a) => a.name === name);
+    if (!agent) {
+      error(`Agent "${name}" 不存在`);
+      process.exit(1);
+    }
+
+    const fullAgent = await client.getAgent(agent.id);
+
+    if (fullAgent.knowledges && fullAgent.knowledges.length > 0) {
+      const knowledgeNamePromises = fullAgent.knowledges.map(async (k) => {
+        try {
+          const knowledge = await client.getKnowledge(k.knowledgeId);
+          return { knowledgeId: k.knowledgeId, knowledgeName: knowledge.name, retrievalConfig: k.retrievalConfig };
+        } catch {
+          return k;
+        }
+      });
+      fullAgent.knowledges = await Promise.all(knowledgeNamePromises);
+    }
+
+    console.log(formatAgentDetail(fullAgent));
+  } catch (err) {
+    error(`获取详情失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}
+
+export async function downloadAgent(name: string, outputDir?: string): Promise<void> {
+  const config = loadConfig();
+  if (!config?.token) {
+    error('未登录，请先运行 arm login');
+    process.exit(1);
+  }
+
+  const client = new ApiClient(config.serverUrl, config.token);
+  try {
+    const result = await client.listAgents(name);
+    const agent = result.agents.find((a) => a.name === name);
+    if (!agent) {
+      error(`Agent "${name}" 不存在`);
+      process.exit(1);
+    }
+
+    info(`正在下载 ${name}...`);
+    const { buffer, version } = await client.downloadAgent(agent.id);
+
+    const tempDir = mkdtempSync('/tmp/agent-download-');
+    const zipPath = join(tempDir, `${name}.zip`);
+    writeFileSync(zipPath, Buffer.from(buffer));
+
+    const targetDir = join(outputDir || '.', name);
+    execSync(`mkdir -p "${targetDir}"`, { stdio: 'pipe' });
+    execSync(`unzip -q "${zipPath}" -d "${tempDir}"`, { stdio: 'pipe' });
+    
+    const contentDir = join(tempDir, 'agent-content');
+    if (existsSync(contentDir)) {
+      execSync(`cp -r "${contentDir}"/* "${targetDir}/"`, { stdio: 'pipe' });
+    } else {
+      execSync(`cp -r "${tempDir}"/* "${targetDir}/"`, { stdio: 'pipe' });
+    }
+
+    rmSync(tempDir, { recursive: true, force: true });
+
+    success(`已下载到 ${targetDir} (版本: ${version})`);
+  } catch (err) {
+    error(`下载失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}