前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在通過可組合的組件構建智能體。在編寫測試代碼或處理結構化數據時，經常需要基於精確的字符索引進行字符串操作。xby-char-index 插件由 xby-skill 維護，提供了一套基於字符索引的字符串操作協議服務器，適用於需要精確字符定位的測試代碼生成和數據處理場景。

核心功能¶

該插件提供以下字符串操作能力：

• API 密鑰管理：

  • set_xby_apikey：在對話中設置 API 密鑰，設置後自動持久化，重啓有效。

• 字符定位：

  • find_nth_char：查找指定字符第 n 次出現的索引，未找到返回 -1。
  • find_all_char_indices：查找指定字符所有出現的索引，未找到返回空列表。
  • find_nth_substring：查找指定子串第 n 次出現的起始索引，未找到返回 -1。
  • find_all_substring_indices：查找指定子串所有出現的起始索引（包含重疊情況）。

• 字符串編輯：

  • split_at_indices：在精確索引處分割文本，索引會自動排序和去重。
  • insert_at_index：在索引位置插入文本（不替換原有內容），支持負索引。
  • delete_range：刪除指定範圍內的字符。
  • replace_range：用新文本替換指定範圍內的字符。

• 正則與提取：

  • find_regex_matches：查找所有正則匹配項及位置信息。
  • extract_between_markers：提取標記之間的內容及位置信息。

• 統計與切片：

  • count_chars：統計字符數量，返回總數、非空格、字母、數字、空格、特殊字符的統計信息。
  • extract_substrings：按索引範圍提取子串，支持負索引和省略結束索引。

安裝¶

從 GitHub 倉庫安裝：

dsh plugin --profile web add github:xby_skill/xby-char-index

配置¶

使用該插件前，需要註冊小笨羊官網並獲取 API 密鑰。設置 API 密鑰後，配置會自動持久化，重啓 DSH 後依然有效。

典型用法¶

• 查找字符或子串的所有索引，用於後續的分割或替換操作。
• 在特定索引位置插入文本，用於構造特定格式的測試數據。
• 使用正則表達式提取目標內容及其位置信息。
• 統計字符串中的字符分佈情況。

適用場景¶

該插件主要面向需要高精度字符串操作的智能體開發場景，例如生成測試代碼時需要精確控制字符位置，或進行復雜的數據清洗與提取。代碼基於 MIT 許可證開源。