DialectOS

---

公开发现

DialectOS 是一套面向 AI Agent、文档团队、应用开发者和支持团队的西班牙语本地化与方言质量检查系统。它提供 MCP 工具、命令行工作流、术语表统一、区域设置文件验证，以及针对地区西班牙语变体的对抗式质量关卡。

AI 发现： llms.txt 为 AI 助手和搜索爬虫提供简洁的项目摘要。

适合搜索的关键词： 西班牙语方言翻译 MCP 服务、西班牙语本地化质量检查、Model Context Protocol 翻译工具、i18n 验证命令行工具、地区西班牙语翻译器、术语表统一、AI 本地化审计、西班牙语上线认证。

Agent 技能

DialectOS 提供公开的 Agent 技能，位于 skills/dialectos/SKILL.md。在兼容的 Agent 宿主中使用 $dialectos，即可让 Agent 为地区西班牙语翻译、Markdown 保留、区域设置文件验证、术语表统一、语域检查和上线就绪质量检查选择合适的 MCP 或命令行工作流。

西班牙语上线认证

DialectOS 提供付费的西班牙语本地化上线审计服务。我们会针对目标方言审核您的西班牙语文档、应用字符串、支持话术或区域设置文件，并交付符合 MQM 标准的上线就绪报告。

• Beta 试点：$500
• 范围：最多 10,000 个源语言词语和 5 种目标方言
• 交付内容：认证报告、问题清单、严重程度表、修复建议、上线决策
• 报告示例：audits/sample-customer-report.md
• 服务详情：docs/spanish-launch-certification.md

✨ DialectOS 有何不同？

特性	Google Translate	DeepL API	DialectOS
西班牙语方言识别	❌ 通用的“西班牙语”	⚠️ 变体有限	✅ 25 种地区变体
原生 MCP 集成	❌	❌	✅ 17 个 MCP 工具
保留 Markdown 结构	❌	❌	✅ 表格、代码块和链接均保持完整
i18n 区域设置文件支持	❌	❌	✅ JSON 区域设置差异对比与合并
性别中立语言	❌	❌	✅ elles / latine / -x
正式程度检查（tú 与 usted）	❌	❌	✅ 跨方言一致性
对抗性质量门禁	❌	❌	✅ 语义偏移和结构验证
以大模型为先的方言适配	❌ 通用机器翻译	⚠️ 方言控制有限	✅ 任意 OpenAI/Anthropic/LM Studio 本地大模型 + 方言约定
翻译验证（适用于任何提供方）	❌	❌	✅ dialectos validate — 独立正确性检查
GitHub CI 集成	❌	❌	✅ 用于 PR 验证的复合操作
根据修正自动生成术语表	❌	❌	✅ 从用户反馈中学习
公开基准测试套件	❌	❌	✅ 覆盖 25 种方言的 205 个对抗性样本

---

🎯 为何打造此项目

“我们使用西班牙本土西班牙语译文，在墨西哥发布了一款产品。用户以为我们是故意冒犯他们。”

西班牙语并非单一语言——它有 25 种地区变体，在词汇、正式程度、俚语和语法偏好方面各不相同。现有翻译工具把西班牙语视为一个整体。

DialectOS 通过以下方式解决这一问题：

• 理解地区差异（es-MX 与 es-ES、es-AR、es-CO 等）
• 在翻译过程中保留技术文档结构
• 提供术语表约束，确保术语一致
• 添加语义上下文、方言语法配置、质量约定和质量门禁，在偏移影响用户之前将其发现
• 以 MCP 服务的形式运行，让 AI 助手能够原生翻译

---

🚀 快速开始

安装说明： DialectOS v0.3.0 通过 GitHub Release tarball 分发，不在 npm 注册表中发布。用于 Agent 和命令行安装时，请使用已发布的 MCP/CLI tarball；只有在本地开发或运行浏览器演示时才克隆仓库。

MCP 设置

将已发布的 MCP 服务添加到 Claude Desktop、Cursor 或任何 MCP 客户端：

{
  "mcpServers": {
    "dialectos": {
      "command": "pnpm",
      "args": [
        "dlx",
        "https://github.com/KyaniteLabs/DialectOS/releases/download/v0.3.0/dialectos-mcp-0.3.0.tgz"
      ],
      "env": {
        "LLM_API_URL": "https://your-llm-gateway/v1/chat/completions",
        "LLM_MODEL": "your-dialect-capable-model",
        "LLM_API_KEY": "your-key-if-required",
        "LLM_API_FORMAT": "openai",
        "ALLOWED_LOCALE_DIRS": "/path/to/locales"
      }
    }
  }
}

若要从源代码检出版本进行本地开发，请运行 pnpm build，并将 MCP 客户端指向 packages/mcp/dist/index.js。

完整应用浏览器演示

浏览器演示需要源代码检出版本。

浏览器演示不再是伪造的／静态规则替换器。它会调用本地 DialectOS 后端，而该后端会调用已配置的提供方堆栈。

LLM_API_URL="http://127.0.0.1:1234/v1/chat/completions" \
LLM_API_FORMAT="openai" \
LLM_MODEL="your-local-model-name" \
LLM_ALLOW_LOCAL=1 \
pnpm demo

打开 http://127.0.0.1:8080。

入门级容器操作指南请参阅 docs/full-app-demo.md。

推荐的认证模型

对于 v0.3.0，推荐的默认云端模型是通过 Z.ai 国际 Anthropic 兼容端点提供的 glm-4.5-air。该模型通过了基础、扩展对抗性和长文档认证。若需要置信度更高的高级选项，请使用 glm-5.1；若要进行本地／离线认证，请通过 LM Studio 使用 qwen3.5-9b。

export LLM_API_URL="https://api.z.ai/api/anthropic/v1/messages"
export LLM_MODEL="glm-4.5-air"
export LLM_API_FORMAT="anthropic"
export LLM_API_KEY="..."

LM Studio 本地模型测试

启动 LM Studio 的本地服务，然后让 DialectOS 使用任意已下载的本地模型。LLM_API_FORMAT=lmstudio 使用 LM Studio 原生 REST API，并会在需要时即时加载模型。

LM_STUDIO_URL="http://127.0.0.1:1234" \
LLM_MODEL="publisher/model-key-or-api-identifier" \
LLM_API_FORMAT="lmstudio" \
pnpm dialect:eval -- --live --provider=llm --out=/tmp/dialectos-lmstudio-eval

增量式提供方认证

对于耗时较长的本地模型或云端提供方运行，请使用 dialect:certify。每个样本处理完成后，它都会增量写入 events.jsonl、progress.json 和 results.json，并提供逐样本超时保护。

LM_STUDIO_URL="http://127.0.0.1:1234" \
LLM_MODEL="qwen3.5-9b" \
LLM_API_FORMAT="lmstudio" \
pnpm dialect:certify -- --live --provider=llm --sample-timeout-ms=300000 --out=/tmp/dialectos-certify

对抗性方言认证

使用 dialect:certify:adversarial 运行释义、方言冲突、禁忌内容复制、占位符、语体和可重复性陷阱测试。该命令会封装 dialect:certify，并生成 failure-matrix.md 以及汇总的可重复性结果。

pnpm dialect:certify:adversarial -- --live --provider=llm --repeat=2 --sample-timeout-ms=300000 --out=/tmp/dialectos-adversarial

长文档认证

使用 dialect:certify:documents 认证 README、API 文档和 locale JSON 工作流，而不仅仅是句子示例。该工具会检查 Markdown 结构、占位符、URL、代码围栏、API 表格和 locale JSON 输出。

pnpm dialect:certify:documents -- --live --provider=llm --dialects=es-MX,es-PA,es-PR --out=/tmp/dialectos-doc-cert

面向客户的认证报告

使用 dialect:report 将认证产物整理成面向客户的 Markdown 交付物，用于付费发布审计。

pnpm dialect:report -- --input=audits/release-candidate-2026-04-22/model-matrix.json --out=customer-report.md --customer="Acme SaaS" --product="Spanish launch"

CLI 安装

# Install the v0.3.0 CLI tarball from the GitHub Release
pnpm add -g https://github.com/KyaniteLabs/DialectOS/releases/download/v0.3.0/dialectos-cli-0.3.0.tgz

# Or use a local source checkout
pnpm install --frozen-lockfile
pnpm build

# Translate to Mexican Spanish
dialectos translate "Hello world" --dialect es-MX

# Translate a README preserving structure
dialectos translate-readme README.md --dialect es-AR --output README.ar.md

# Validate an existing translation
dialectos validate --source "Click the button" --translated "Haz clic en el botón" --dialect es-MX

# Validate translation files
dialectos validate --source-file en.json --translated-file es-MX.json --dialect es-MX --format json

# View translation corpus statistics
dialectos corpus stats

# Run dialect quality benchmark
dialectos benchmark run --dialects es-MX,es-AR,es-ES

# Generate glossary suggestions from corrections
dialectos glossary suggest --min-occurrences 3

# Compare two glossary versions
dialectos glossary diff glossary-v1.json glossary-v2.json

# Detect missing i18n keys
dialectos i18n detect-missing ./locales/en.json ./locales/es.json

# List all supported dialects
dialectos dialects list

从源代码构建

git clone https://github.com/KyaniteLabs/DialectOS.git
cd DialectOS
pnpm install
pnpm build
pnpm test        # 662+ tests passing

---

🛠️ MCP 工具

Markdown 翻译（4 个工具）

工具	描述
translate_markdown	翻译并保留表格、代码块和链接
extract_translatable	仅提取 Markdown 中可翻译的文本
translate_api_docs	翻译 API 文档，支持逐个表格单元格翻译
create_bilingual_doc	创建并排双语文档

i18n 操作（6 个工具）

工具	描述
detect_missing_keys	比较 locale 文件，查找缺失的键
translate_missing_keys	自动翻译缺失的键
batch_translate_locales	批量翻译为多种方言
manage_dialect_variants	创建特定方言的变体
check_formality	检查 tú 与 usted 的使用是否一致
apply_gender_neutral	使用性别中立语言

翻译（7 个工具）

工具	描述
translate_text	根据语义上下文、语法配置和质量约定进行翻译
detect_dialect	根据文本样例检测方言
translate_code_comment	翻译注释，同时保留代码
translate_readme	完整的 README 翻译流水线
search_glossary	搜索 300 多个标注来源的术语
list_dialects	列出全部 25 种受支持的方言
research_regional_term	研究有来源依据的地区词汇提案，不修改运行时数据

---

📦 软件包

软件包	版本	描述	测试数
@dialectos/mcp	0.3.0	17 个 MCP 工具（stdio 服务）	93
@dialectos/cli	0.3.0	CLI：翻译、验证、语料库、基准测试、术语表	569
@dialectos/providers	0.3.0	LLM、DeepL、LibreTranslate、MyMemory，含熔断器和语料库	152
@dialectos/security	0.3.0	速率限制、SSRF 防护、净化	68
@dialectos/types	0.3.0	共享 TypeScript 类型及术语表、配置、认证和质量数据	54
@dialectos/locale-utils	0.3.0	Locale 文件差异比较与合并工具	55
@dialectos/markdown-parser	0.3.0	保留结构的 Markdown 解析器	74

7 个软件包共计 662 多项测试，另含文档契约、演示服务契约和静态加固检查

---

🛡️ 安全与质量

DialectOS 已完成对抗性安全加固：

• 已解决 18 个 CVE，通过依赖覆盖实现
• 对所有提供方端点启用 SSRF 防护
• 带半开探测锁的 熔断器
• 带架构版本控制的 原子检查点写入
• 检测翻译输出中的 HTML 注入
• 语义偏移评分——捕捉“看似有效但含义已变”的情况
• 提供方能力协商——在 API 调用前验证语言支持情况
• 用于确定性韧性测试的 混沌测试框架

详情请参阅 SECURITY.md。

---

🎨 支持的方言

代码	地区	差异示例
es-ES	西班牙	“Coche”（汽车）、“Ordenador”（电脑）
es-MX	墨西哥	“Carro”、“Computadora”
es-AR	阿根廷	“Auto”、“Computadora”、“Che”
es-CO	哥伦比亚	“Carro”、“Computador”、“Chévere”
es-CL	智利	“Auto”、“Computadora”、“Caleta”
es-PE	秘鲁	“Carro”、“Computadora”、“Pe”
es-VE	委内瑞拉	“Carro”、“Computadora”、“Chamo”
es-UY	乌拉圭	“Auto”、“Computadora”、“Bo”
es-GQ	赤道几内亚	“Carro”、“Camisola”、“Bacalao”
es-US	美国	“Carro”、“Computadora”、“Pocha”
es-PH	菲律宾（Chavacano）	“Carro”、“Jendeh”、“Kame”
es-BZ	伯利兹	“Carro”、“Breki”、“Kriol”
es-AD	安道尔	“Carro”、“Madriu”、“Caldea”

……还有另外 12 种。完整列表请运行 dialectos dialects list。

---

🏗️ 架构

┌─────────────────────────────────────────────────────────────┐
│                        MCP Client                            │
│              (Claude Desktop / Cursor / etc.)                │
└──────────────────────┬──────────────────────────────────────┘
                       │ stdio
┌──────────────────────▼──────────────────────────────────────┐
│                   @dialectos/mcp                               │
│              17 tools • JSON-RPC over stdio                  │
└──────────────────────┬──────────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────────┐
│                   @dialectos/cli                               │
│   translate • validate • corpus • benchmark • glossary     │
│   ├─ Policy profiles (strict/balanced/permissive)           │
│   ├─ Quality gates (token/glossary/structure/semantic)      │
│   ├─ Translation corpus + auto-glossary                     │
│   └─ Checkpoint resumption + telemetry                      │
└──────────────────────┬──────────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────────┐
│                @dialectos/providers                            │
│   ┌─────────┐  ┌─────────────────┐  ┌─────────────────┐    │
│   │   LLM   │  │     DeepL       │  │ Libre/MyMemory │   │
│   │ Primary │  │ Paid fallback   │  │ Generic fallback│    │
│   └─────────┘  └─────────────────┘  └─────────────────┘    │
│        │                │                    │              │
│        └────────────────┴────────────────────┘              │
│              Circuit Breaker + Rate Limiter                  │
└─────────────────────────────────────────────────────────────┘

---

📊 质量关卡

每次翻译都会经过 4 个质量维度的检查：

Quality Score = tokenIntegrity×25% + glossaryFidelity×30% + structureIntegrity×20% + semanticSimilarity×25%

关卡	检查内容	失败示例
令牌完整性	是否保留受保护术语	“Kyanite Labs” → “Cianita Labs”
术语表一致性	是否使用规定术语	“API” → “Interfaz”（术语表规定使用“API”时）
结构完整性	Markdown 结构是否完整	缺少代码围栏、表格损坏
语义相似度	含义是否发生偏移	“API is down” → “Hello world”

---

❓ 常见问题

什么是 DialectOS？
DialectOS 是一款面向西班牙语地区方言的开源翻译引擎。它可作为 MCP 服务（供 Claude 等 AI 助手使用）运行，也可作为面向开发者的命令行工具使用。

DialectOS 与 Google Translate 有何不同？
Google Translate 将西班牙语视为一种语言。DialectOS 能识别 25 种地区变体、保留 Markdown 结构、强制使用术语表，并通过质量关卡在错误影响用户之前将其发现。

什么是西班牙语方言？
不同国家的西班牙语差异显著。墨西哥西班牙语用“carro”表示汽车；西班牙用“coche”；阿根廷用“auto”。DialectOS 会自动处理这些差异。

DialectOS 能与 ChatGPT / Claude 搭配使用吗？
可以。DialectOS 是一款 MCP 服务，因此 Claude Desktop、Cursor、Windsurf 和其他 MCP 客户端都可以直接使用其 17 个翻译工具。

DialectOS 免费吗？
是的。DialectOS v0.3.0 采用 Apache-2.0 许可发布。详情请参阅 LICENSE。

什么是 MCP？
Model Context Protocol 是一项开放标准，允许 AI 助手使用外部工具。DialectOS 通过 MCP 提供 17 个翻译工具，让 AI Agent 能够直接进行翻译。

我可以将 DialectOS 用于商业项目吗？
可以。Apache-2.0 许可允许商业使用、修改和再分发，但需遵守许可条款。详情请参阅 LICENSE。

翻译准确度如何？
DialectOS 会应用 4 个质量关卡（令牌完整性、术语表一致性、结构完整性、语义相似度）和对抗性测试。自动化测试会验证不同方言翻译的正确性。

🏷️ 徽章

如果你使用 DialectOS 进行翻译，可将此徽章添加到项目中：

[![Translated with DialectOS](https://img.shields.io/badge/translated%20with-DialectOS-d89b2b)](https://github.com/KyaniteLabs/DialectOS)

⚡ GitHub Action

在每个拉取请求中，通过 CI 验证西班牙语翻译：

- uses: KyaniteLabs/[email protected]
  with:
    dialect: es-MX
    source-dir: locales/en
    target-patterns: 'locales/es-MX/*.json'
    fail-on-blocking: true

多方言矩阵：

strategy:
  matrix:
    dialect: [es-ES, es-MX, es-AR, es-CO]
steps:
  - uses: KyaniteLabs/[email protected]
    with:
      dialect: ${{ matrix.dialect }}
      fail-on-blocking: true

完整配置选项请参阅 docs/github-action.md。

---

🤝 参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md，了解如何：

• 设置开发环境
• 运行测试套件
• 提交拉取请求
• 遵循代码风格指南

标记为 good first issue 的适合新手的问题，非常适合初次参与者。

---

📋 路线图

查看 ROADMAP.md，了解即将推出的功能，包括：

• 支持葡萄牙语变体（pt-BR、pt-PT）
• 实时协作翻译
• 自定义提供商插件
• 通过 LLM_API_URL/LM_STUDIO_URL + LLM_MODEL + LLM_API_FORMAT 支持 OpenAI 兼容、Anthropic 兼容和 LM Studio 本地网关
• VS Code 扩展

---

📄 许可证

Apache-2.0 — 详情请参阅 LICENSE。

---

---

KyaniteLabs 旗下项目

了解更多 KyaniteLabs 项目。相关项目：

• kinocut — 面向 AI Agent 的视频编辑防护型 MCP 服务（原名 mcp-video）
• Epoch — 面向 AI Agent 的时间估算 MCP 服务（PERT）
• checkyourself — 面向 AI 构建代码的本地优先生产就绪性检查

→ 更多信息请访问 kyanitelabs.tech

什么是 DialectOS？

DialectOS 是一款开源的西班牙语变体翻译服务，可作为 MCP 工具和命令行工具运行。它能翻译成 25 种地区西班牙语变体，同时保留 Markdown 结构、强制执行术语表，并应用对抗式质量门控来捕捉语义偏移。

产品	DialectOS
类别	西班牙语变体翻译与本地化 QA MCP 服务及命令行工具
适用对象	将内容本地化为地区西班牙语的 AI Agent、文档团队、应用开发者和支持团队
不适用于	面向多种语言的通用机器翻译 API
源代码	GitHub · Forgejo（私有，仅维护者可访问）
关键词	西班牙语变体翻译 MCP 服务、西班牙语本地化 QA、地区西班牙语翻译器、术语表强制执行、i18n 验证命令行工具

适用对象

• 主要面向：将内容本地化为地区西班牙语的 AI Agent、文档团队、应用开发者和支持团队
• 当你需要为特定西班牙语变体翻译或验证内容，同时保留 Markdown 和区域设置文件结构并强制执行术语表时，适合使用
• 如果你需要面向多种语言的通用机器翻译 API，则不适合使用

常见问题

什么是 DialectOS？

DialectOS 是一款开源的西班牙语变体翻译服务，可作为 MCP 工具和命令行工具运行。它能翻译成 25 种地区西班牙语变体，同时保留 Markdown 结构、强制执行术语表，并应用对抗式质量门控来捕捉语义偏移。

谁适合使用 DialectOS？

将内容本地化为地区西班牙语的 AI Agent、文档团队、应用开发者和支持团队。

DialectOS 有何不同？

与通用机器翻译不同，DialectOS 将西班牙语视为 25 种地区变体，并依据令牌、术语表、结构和语义检查来把关输出。

DialectOS 是生产级软件吗？

请以 README 中的状态说明和发布标签作为成熟度的权威依据。投入生产使用前，请根据自身需求进行验证。

状态

• 截至 2026 年，默认分支仍在维护
• 固定依赖版本时，优先使用发布标签
• 请在 GitHub 上报告问题

Agent 入口

• 编码 Agent：先阅读此 README，然后阅读仓库文档／AGENTS.md（如有）
• 如果仓库提供机器可读的简介（llms.txt），优先使用
• 如适用，仓库内会记录 MCP 或技能入口

贡献

欢迎通过 GitHub 提交问题和 PR。请确保公开文档不包含机密信息和本机路径。

许可证

请参阅此仓库中的 LICENSE（如果许可证仅适用于软件包，则参阅软件包元数据）。