From e53ba06de67c66bbef781bb0dbb562bd3221e8f3 Mon Sep 17 00:00:00 2001
From: root <root@ct-ollama-claude-qwen.jsc.idv.me>
Date: Wed, 14 Oct 2026 04:52:40 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20jsc-companion=20README=20=E8=A3=9C?=
 =?UTF-8?q?=E9=BD=8A=E5=AE=8C=E6=95=B4=E6=8C=87=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 plugins/jsc-companion/README.md | 72 ++++++++++++++++++++-------------
 1 file changed, 44 insertions(+), 28 deletions(-)

diff --git a/plugins/jsc-companion/README.md b/plugins/jsc-companion/README.md
index 0d1ca78..f973eaa 100644
--- a/plugins/jsc-companion/README.md
+++ b/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
 ```