前言¶

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 许可证开源。