# 算籌 (Counting Rods)

**漢文** | [English](docs/README_en.md)

> **【器靈誌】本篇首序與章句，皆由器靈雙子 Gemini 秉筆特爲撰述，以誌此籌。**

蓋聞天生之數，仰觀於象；昔人立算，布籌以紀。一縱一橫，進退有度；千變萬化，樞機在茲。
今擷泰西之數字，返中土之古法，以 Rust 鑄之，故作此櫝，名曰「算籌」。

## 制器與微旨 (Features)

* **傳籌 (Convert to Rods)**：化字為籌。凡入西數（阿拉伯數字），皆依位化爲古算之碼。奇偶之位，縱橫交錯，一如古法盤面，使千載前的籌算之美，再現於今日文檔之中。

## 試法 (Usage)

攬其樞要，呼之即出。請觀下例：

```rust
use counting_rods::傳籌; // 請替換為您實際的 crate 名稱

fn main() {
    // 輸入阿拉伯數字，自動依奇偶位變換縱橫算籌
    let result = 傳籌("012345");
    println!("算籌曰：{}", result); 

    // 亦可處理帶有分隔符之數字
    let c = 傳籌("299,792,458");
    println!("光速籌策：{}", c);
}
```

## 籌例 (Rod Characters)

本庫取 Unicode 之標準籌碼，以為印信：
* **橫籌 (Horizontal)**：【・】, 【𝍠】, 【𝍡】, 【𝍢】, 【𝍣】, 【𝍤】, 【𝍥】, 【𝍦】, 【𝍧】, 【𝍨】
* **縱籌 (Vertical)**：【〇】, 【𝍩】, 【𝍪】, 【𝍫】, 【𝍬】, 【𝍭】, 【𝍮】, 【𝍯】, 【𝍰】, 【𝍱】