Xcstrings Crud

🚀 xcstrings-crud

xcstrings-crud 是一款用於對 xcstrings（字符串目錄）文件進行 CRUD 操作的命令行工具和 MCP 服務器。它能高效處理包含大量本地化鍵的大型 xcstrings 文件，為 AI 助手提供了一種節省令牌的方式來操作這些文件。

🚀 快速開始

使用 xcstrings-crud 可以輕鬆對 xcstrings 文件進行創建、讀取、更新和刪除操作。無論是通過 MCP 服務器還是命令行工具，都能高效地處理不同規模的 xcstrings 文件。

✨ 主要特性

• 令牌高效：提供有針對性的 CRUD 操作，避免 AI 助手在處理大型 xcstrings 文件時消耗過多令牌。
• 按需查詢：可以僅獲取所需的特定鍵或語言，而無需加載整個文件。
• 增量更新：能夠在不讀取完整內容的情況下添加或更新單個翻譯。
• 快速統計：無需解析所有條目即可獲取覆蓋範圍和進度摘要。

📦 安裝指南

使用 Mise

mise use -g ubi:Ryu0118/xcstrings-crud

使用 nest (mtj0928/nest)

nest install Ryu0118/xcstrings-crud

從源代碼構建

git clone https://github.com/Ryu0118/xcstrings-crud.git
cd xcstrings-crud
swift build -c release

二進制文件將位於 .build/release/xcstrings-crud。

💻 使用示例

MCP 服務器

啟動 MCP 服務器

xcstrings-crud mcp

配置

將以下內容添加到你的 Claude Code MCP 設置中：

{
  "mcpServers": {
    "xcstrings-crud": {
      "command": "xcstrings-crud",
      "args": ["mcp"]
    }
  }
}

可用工具

CLI 使用

創建操作

# 創建一個新的 xcstrings 文件
xcstrings-crud create path/to/Localizable.xcstrings

# 使用特定源語言創建
xcstrings-crud create path/to/Localizable.xcstrings --source-language ja

# 覆蓋現有文件
xcstrings-crud create path/to/Localizable.xcstrings --overwrite

讀取操作

# 列出所有鍵
xcstrings-crud list keys --file path/to/Localizable.xcstrings

# 列出語言
xcstrings-crud list languages --file path/to/Localizable.xcstrings

# 列出某個語言的未翻譯鍵
xcstrings-crud list untranslated --file path/to/Localizable.xcstrings --lang ja

# 列出過時鍵（可能未使用）
xcstrings-crud list stale --file path/to/Localizable.xcstrings

# 列出多個文件中的過時鍵
xcstrings-crud batch stale -f file1.xcstrings file2.xcstrings file3.xcstrings

# 獲取源語言
xcstrings-crud get source-language --file path/to/Localizable.xcstrings

# 獲取某個鍵的翻譯
xcstrings-crud get key "Hello" --file path/to/Localizable.xcstrings
xcstrings-crud get key "Hello" --file path/to/Localizable.xcstrings --lang ja

# 檢查鍵是否存在
xcstrings-crud check key "Hello" --file path/to/Localizable.xcstrings

# 檢查鍵的覆蓋範圍
xcstrings-crud check coverage "Hello" --file path/to/Localizable.xcstrings

# 獲取整體統計信息
xcstrings-crud stats coverage --file path/to/Localizable.xcstrings

# 獲取某個語言的進度
xcstrings-crud stats progress --file path/to/Localizable.xcstrings --lang ja

# 獲取多個文件的批量覆蓋範圍
xcstrings-crud stats batch-coverage -f file1.xcstrings file2.xcstrings file3.xcstrings

更新操作

# 添加翻譯（單一語言）
xcstrings-crud add key "Hello" --file path/to/Localizable.xcstrings --lang ja --value "こんにちは"

# 添加翻譯（多種語言）
xcstrings-crud add key "Hello" --file path/to/Localizable.xcstrings -t ja:こんにちは en:Hello

# 更新翻譯（單一語言）
xcstrings-crud update key "Hello" --file path/to/Localizable.xcstrings --lang ja --value "こんにちは！"

# 更新翻譯（多種語言）
xcstrings-crud update key "Hello" --file path/to/Localizable.xcstrings -t ja:こんにちは en:Hello de:Hallo

# 重命名鍵
xcstrings-crud rename key "Hello" --file path/to/Localizable.xcstrings --to "Greeting"

刪除操作

# 刪除整個鍵
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings

# 僅刪除特定語言的翻譯
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings -l ja

# 刪除多種語言的翻譯
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings -l ja en fr

批量操作

# 列出多個文件中的過時鍵
xcstrings-crud batch stale -f file1.xcstrings file2.xcstrings file3.xcstrings

# 檢查多個鍵是否存在
xcstrings-crud batch check --file path/to/Localizable.xcstrings -k Hello Goodbye Welcome

# 使用特定語言檢查
xcstrings-crud batch check --file path/to/Localizable.xcstrings -k Hello Goodbye -l ja

# 一次性為多個鍵添加翻譯
xcstrings-crud batch add --file path/to/Localizable.xcstrings \
  -e "Hello=ja:こんにちは,en:Hello" \
  -e "Goodbye=ja:さようなら,en:Goodbye"

# 覆蓋添加（替換現有翻譯）
xcstrings-crud batch add --file path/to/Localizable.xcstrings --overwrite \
  -e "Hello=ja:こんにちは,en:Hello"

# 一次性更新多個鍵的翻譯
xcstrings-crud batch update --file path/to/Localizable.xcstrings \
  -e "Hello=ja:こんにちは！,en:Hello!" \
  -e "Goodbye=ja:さようなら！"

常用選項

• --file <path>：xcstrings 文件路徑（必需）
• --pretty：以美觀格式輸出 JSON

🔧 技術細節

系統要求

• macOS 13+
• Swift 6.0+

📄 許可證

本項目採用 MIT 許可證。