Update nexus wiki content
This commit is contained in:
@@ -1,40 +1,42 @@
|
||||
---
|
||||
title: "OpenCode Integration"
|
||||
title: "Qwen Code Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-26
|
||||
date: 2026-05-02
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[raw/Agent/agency-agents/scripts/i18n/README.md]]
|
||||
- [[Agent/agency-agents/integrations/qwen/README.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:OpenCode 的子 Agent 集成机制——如何将 .md 文件格式的 Agent 转换为 OpenCode 可调用的子代理
|
||||
- 问题域:OpenCode IDE 中的多 Agent 协作与按需调用
|
||||
- 方法/机制:通过 YAML frontmatter 中的 `mode: subagent` 标记,将具名 Agent 从 Tab 循环列表中分离,改为按需 `@agent-name` 调用;颜色通过命名颜色到十六进制的自动映射实现
|
||||
- 结论/价值:提供了一种轻量级、无需修改主 Agent 系统的子 Agent 扩展方案,支持项目级和全局级两种安装范围
|
||||
- 核心主题:Agency Agents 项目如何将 SubAgent 定义导出为 Qwen Code 可用的格式
|
||||
- 问题域:AI Agent 的跨平台复用与工具无关的 SubAgent 文件标准化
|
||||
- 方法/机制:通过 `scripts/convert.sh --tool qwen` 将 agency agents 转换为 Qwen Code 的 `.qwen/agents/` SubAgent Markdown 文件;通过 `install.sh --tool qwen` 部署到目标项目
|
||||
- 结论/价值:实现 Agent 定义的"一次编写,多工具导出",降低多 AI 工具生态中的重复配置成本
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- OpenCode Agent 通过在 `.opencode/agents/` 目录存储 .md 文件(带 YAML frontmatter)实现——文件格式与 The Agency 的 Agent 定义格式兼容
|
||||
- `mode: subagent` 配置使 Agent 仅在 `@agent-name` 触发时出现,不会在 Tab 循环列表中占位——保持主 Agent 列表的简洁性
|
||||
- 命名颜色(如 `cyan`)在安装脚本中被自动转换为十六进制颜色代码——无需手动查表
|
||||
- Agent 支持两种安装范围:项目级(`.opencode/agents/`)和全局级(`~/.config/opencode/agents/`)——通过不同路径实现作用域隔离
|
||||
- 转换脚本 `./scripts/convert.sh --tool opencode` 负责将 The Agency 的标准 Agent 文件转换为 OpenCode 兼容格式
|
||||
- Agency Agents 通过项目级 `.md` SubAgent 文件在 `.qwen/agents/` 中管理 Agent 定义
|
||||
- `convert.sh --tool qwen` 脚本负责将 agency agents 逐一转换为 Qwen Code SubAgent Markdown 格式
|
||||
- Qwen Code 为项目级作用域(project-scoped),而非 home-scoped
|
||||
- Qwen SubAgent 文件采用最小化 frontmatter(name、description、tools)
|
||||
- 更新 agency agents 后需重新生成并重新安装
|
||||
|
||||
## Key Quotes
|
||||
> "mode: subagent — agent is available on-demand, not shown in the primary Tab-cycle list"
|
||||
> — Agent YAML frontmatter 的核心语义,说明 subagent 模式与普通 agent 的本质区别
|
||||
> "Qwen Code is project-scoped, not home-scoped" — Qwen Code 的作用域设计原则,说明其 Agent 配置与特定项目绑定
|
||||
> "If you update agents in this repo, regenerate the Qwen output before reinstalling" — 使用建议:SubAgent 源变更后必须重新生成
|
||||
> "run `/agents manage` in Qwen Code to refresh the agent list, or restart the current Qwen Code session" — Qwen Code 中的 Agent 刷新方式
|
||||
|
||||
## Key Concepts
|
||||
- [[Subagent]]:按需调用的辅助 Agent,通过 `@agent-name` 语法触发,不参与 Tab 循环
|
||||
- [[OpenCode]]:一个支持多 Agent 协作的 IDE/编辑器扩展平台
|
||||
- [[SubAgent]]:一种以 Markdown 文件定义的 AI Agent 描述格式,支持 frontmatter 元数据
|
||||
- [[Tool Integration Export]]:将同一套 Agent 定义转换为不同 AI 工具(Qwen Code、Claude Code 等)的专属格式
|
||||
|
||||
## Key Entities
|
||||
- [[The Agency]]:OpenCode Agent 的来源框架,提供 147 个专业化 Agent 定义
|
||||
- [[Agency Agents]]:开源多 Agent 框架,支持生成多种 AI 工具的 SubAgent 文件
|
||||
- [[Qwen Code]]:阿里巴巴的 AI 编程助手,采用项目级作用域的 Agent 管理方式
|
||||
|
||||
## Connections
|
||||
- [[contributing]] ← 贡献来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
|
||||
- [[The Agency]] ← Agent 定义来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
|
||||
- [[Contributing]] ← extends ← [[Qwen Code Integration]](Qwen 集成是 Agency Agents 对外扩展的一部分)
|
||||
- [[Qwen Code Integration]] ← generates ← [[SubAgent Files]]
|
||||
|
||||
## Contradictions
|
||||
- (未检测到与其他页面的明显冲突)
|
||||
- 无明显冲突
|
||||
|
||||
Reference in New Issue
Block a user