xby-char-index

Readme

# xby-char-index

DeepSeek Harness (DSH) 的插件：字符索引字符串处理工具

一个基于字符索引的字符串操作协议服务器，适用于需要精确字符定位的测试代码生成和数据处理场景。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **find_nth_char** — Find index of nth occurrence of a character. Returns -1 if not found.
- **find_all_char_indices** — Find all indices where a character appears. Returns empty list if not found.
- **find_nth_substring** — Find starting index of nth occurrence of a substring. Returns -1 if not found.
- **find_all_substring_indices** — Find all starting indices where a substring appears (includes overlaps).
- **split_at_indices** — Split text at exact index positions. Indices auto-sorted and deduplicated.
- **insert_at_index** — Insert text at index position without replacing. Supports negative indices.
- **delete_range** — Delete characters in range [start, end).
- **replace_range** — Replace characters in range [start, end) with new text.
- **find_regex_matches** — Find all regex matches with positions. Returns list of {start, end, match} dicts.
- **extract_between_markers** — Extract content between markers with positions. Returns dict with content and position info.
- **count_chars** — Count character statistics. Returns dict with total, without_spaces, letters, digits, spaces, special.
- **extract_substrings** — Extract substrings by index ranges. Supports negative indices and omitting end. Returns list of {start, end, substring, length} dicts.

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-char-index
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-char-index
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。