plugins/jsc-companion/README.md

@@ -2,66 +2,82 @@
 
 ## 指令
 
-### `/companion status`
+### `/jsc-companion:companion status`
 
-查看目前角色與狀態。
+查看目前角色、心情、好感與待辦數量。
 
 ```text
-/companion status
+/jsc-companion:companion status
 ```
 
-### `/companion switch <角色>`
+### `/jsc-companion:companion switch <角色>`
 
-切換角色。
+切換角色；不給角色會列出可用角色。
 
 ```text
-/companion switch 小明
+/jsc-companion:companion switch 小明
 ```
 
-### `/companion setup`
+### `/jsc-companion:companion off`
 
-進行設定。
+關閉陪伴，所有資料保留。
 
 ```text
-/companion setup
+/jsc-companion:companion off
 ```
 
-### `/companion todo add <內容> [due=YYYY-MM-DDTHH:MM]`
+### `/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
-/companion todo add 買牛奶 due=2026-10-15T18:00
+/jsc-companion:companion setup nickname=阿明 wake=07:30 sleep=23:30 tz=+0800 careLimit=3 quietStart=22:00 quietEnd=08:00
 ```
 
-### `/companion todo done <編號>`
+### `/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
-/companion todo done 1
+/jsc-companion:companion todo done 1
 ```
 
-### `/companion quiet [分鐘]`
+### `/jsc-companion:companion quiet [分鐘]`
 
-暫時安靜，不主動關心。
+暫時靜音，不主動關心；預設 60 分鐘，`0` 取消靜音。
 
 ```text
-/companion quiet 30
+/jsc-companion:companion quiet 30
 ```
 
-### `/companion off`
+### `/jsc-companion:ingest`
 
-關閉陪伴。
+解析單章小說（txt／md），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時也會自動使用。
 
 ```text
-/companion off
-```
-
-### `ingest skill`
-
-解析單章小說（txt／md），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時自動使用。
-
-```text
-幫我用 ingest 解析 chapter1.md，章節編號 1
+/jsc-companion:ingest chapter1.md 章節編號 1
 ```