Update nexus wiki content
This commit is contained in:
43
wiki/sources/i18n-readme.md
Normal file
43
wiki/sources/i18n-readme.md
Normal file
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: "Chinese (zh-CN) Localization"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-05-02
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/scripts/i18n/README.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:将 GitHub Copilot Agent 的 name 和 description 字段本地化为简体中文
|
||||
- 问题域:AI Agent 在 Copilot Chat Agent 选择器中的中文用户本地化体验
|
||||
- 方法/机制:通过 PowerShell 脚本读取 JSON 翻译映射表,自动替换 YAML frontmatter 中的 name/description 字段
|
||||
- 结论/价值:实现 Agent 界面的中文本地化,提升中文用户的使用体验;JSON 文件作为翻译的唯一数据源
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- PowerShell 脚本 `localize-agents-zh.ps1` 读取 UTF-8 编码的 `agent-names-zh.json` 翻译映射表
|
||||
- 脚本仅修改已安装副本(`~/.github/agents/` 和 `~/.copilot/agents/`),不修改源文件
|
||||
- 仅替换 YAML frontmatter 中的 `name:` 和 `description:` 字段
|
||||
- JSON 文件是翻译的唯一真实来源,新增 Agent 需先添加到 JSON 中
|
||||
- 脚本采用纯 ASCII 编码(避免 PowerShell 编码问题),所有中文文本存储在 JSON 文件中
|
||||
- 每次运行 `install.sh --tool copilot` 更新后需重新运行本地化脚本
|
||||
|
||||
## Key Quotes
|
||||
> "Only modifies **installed copies** (in `~/.github/agents/`), not source files" — 关键约束:只修改安装副本
|
||||
> "JSON file is the single source of truth for translations — add new agents there" — JSON 文件作为翻译唯一数据源的设计原则
|
||||
> "Script is pure ASCII (avoids PowerShell encoding issues); all Chinese text lives in the JSON" — 纯 ASCII 脚本 + UTF-8 JSON 的分工设计
|
||||
|
||||
## Key Concepts
|
||||
- [[Global-First-Architecture]]:国际化/本地化(i18n/l10n)作为产品架构的先天前提条件,而非上线后的补救措施
|
||||
- [[YAML-Configuration]]:YAML frontmatter 配置格式,存储 Agent 的 name 和 description 元数据
|
||||
|
||||
## Key Entities
|
||||
- [[The-Agency]]:开源多 Agent 框架,提供了 Copilot Agent 的安装脚本 `install.sh --tool copilot`
|
||||
- [[GitHub-Copilot]]:微软的 AI 编程助手,其 Chat 支持自定义 Agent,Agent 以 Markdown + YAML frontmatter 格式定义
|
||||
|
||||
## Connections
|
||||
- [[Qwen Code Integration]] ← related_to ← [[i18n-readme]](均为 Agency Agents 的多工具集成功能)
|
||||
- [[i18n-readme]] ← extends ← [[GitHub-Copilot]](将英文 Copilot Agent 本地化为中文)
|
||||
|
||||
## Contradictions
|
||||
- 无明显冲突
|
||||
Reference in New Issue
Block a user