# jsc-companion

## 指令

### `/jsc-companion:companion status`

查看目前角色、心情、好感與待辦數量。

```text
/jsc-companion:companion status
```

### `/jsc-companion:companion switch <角色>`

切換角色；不給角色會列出可用角色。

```text
/jsc-companion:companion switch 小明
```

### `/jsc-companion:companion off`

關閉陪伴，所有資料保留。

```text
/jsc-companion:companion off
```

### `/jsc-companion:companion setup [key=value…]`

不給參數時顯示目前設定；給 key=value 則儲存。可設定：`nickname`、`wake=HH:MM`、`sleep=HH:MM`、`tz=+0800`、`careLimit=N`（每日主動關心上限）、`quietStart=HH:MM`、`quietEnd=HH:MM`。

```text
/jsc-companion:companion setup nickname=阿明 wake=07:30 sleep=23:30 tz=+0800 careLimit=3 quietStart=22:00 quietEnd=08:00
```

### `/jsc-companion:companion todo [list]`

列出未完成的待辦。

```text
/jsc-companion:companion todo
```

### `/jsc-companion:companion todo add <內容> [due=YYYY-MM-DDTHH:MM]`

新增待辦，可指定到期時間（依 `tz` 設定換算）。

```text
/jsc-companion:companion todo add 買牛奶 due=2026-10-15T18:00
```

### `/jsc-companion:companion todo promise <內容> [due=YYYY-MM-DDTHH:MM]`

記錄角色答應使用者的事（列表中標示【承諾】），用法同 `todo add`。

```text
/jsc-companion:companion todo promise 週末一起討論新章節 due=2026-10-17T10:00
```

### `/jsc-companion:companion todo done <編號>`

將待辦標為完成。

```text
/jsc-companion:companion todo done 1
```

### `/jsc-companion:companion quiet [分鐘]`

暫時靜音，不主動關心；預設 60 分鐘，`0` 取消靜音。

```text
/jsc-companion:companion quiet 30
```

### `/jsc-companion:ingest`

解析單章小說（txt／md），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時也會自動使用。

```text
/jsc-companion:ingest chapter1.md 章節編號 1
```