feat(role): 新增閒置小睡整理
This commit is contained in:
Jeffery
+26
-5
@@ -11,12 +11,12 @@ description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI
|
||||
| 元件 | 觸發者 | 職責 |
|
||||
| --- | --- | --- |
|
||||
| `hooks/hooks.json` 的 `SessionStart` hook | harness 自動 | 啟動 CLI 時依字元預算載入角色定義＋高價值記憶，並要求角色在本工作階段第一則回覆主動問候；睡眠時段只回報「角色睡覺中」不載入 |
|
||||
| `hooks/hooks.json` 的 `Stop` hook | harness 自動 | 每輪結束先用本地規則過濾低價值短回合 → 值得保存時才濃縮成一則輕量 inbox 記憶 → 遮蔽 → 寫入 `inbox/` |
|
||||
| cron 排程（本 skill 安裝） | 系統排程 | 睡眠時段每小時檢查一次：**有 AI 在運行就不睡**，沒有才進入 NREM/REM 兩階段記憶整理 |
|
||||
| `hooks/hooks.json` 的 `Stop` hook | harness 自動 | 每輪結束先記錄最後互動時間 → 用本地規則過濾低價值短回合 → 值得保存時才濃縮成一則輕量 inbox 記憶 → 遮蔽 → 寫入 `inbox/` |
|
||||
| cron 排程（本 skill 安裝） | 系統排程 | 睡眠時段每小時檢查一次：**有 AI 在運行就不睡**；另可依 CLI 閒置時間自動小睡整理 |
|
||||
| 本 skill `/jsc:role` | 使用者／助理手動 | `--new`／`--use`／`--list`／`--sleep`／`--status`／`--install-cron`／`--forget-preview` |
|
||||
| `scripts/role/role_load.sh` | SessionStart hook | 角色與記憶載入；參考 OpenClaw 的 SOUL／AGENTS／USER／MEMORY 分層，把人格、操作邊界、使用者記憶分開注入，並提供第一則回覆問候提示（單一實作，避免漂移） |
|
||||
| `scripts/role/role_capture.sh` | Stop hook | 對話 → 記憶（固定欄位格式） |
|
||||
| `scripts/role/role_sleep.sh` | cron／補跑／手動 | 睡眠判斷、記憶整理、排程安裝、狀態輸出 |
|
||||
| `scripts/role/role_sleep.sh` | cron／小睡／補跑／手動 | 睡眠與小睡判斷、記憶整理、排程安裝、狀態輸出 |
|
||||
| `scripts/role/memory.js` | 上述共用 | 記憶檔讀寫、分類、去重合併、優先度、心理學記憶型態與關聯 metadata、壓縮歸檔、遺忘、載入組裝 |
|
||||
| `scripts/role/transcript.js` | 上述共用 | 抽本輪對話片段、機密與個資遮蔽 |
|
||||
| `scripts/role/role_lib.sh` | 上述共用 | log、角色解析、睡眠時段、AI 行程偵測、CLI 選擇、記憶鎖 |
|
||||
@@ -95,6 +95,10 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
| `ROLE_SLEEP_BATCH` | | 單次睡眠整理最多處理的 inbox 筆數 | `60` |
|
||||
| `ROLE_SLEEP_EXISTING_LIMIT` | | 睡眠整理素材中可放入的既有記憶索引筆數 | `120` |
|
||||
| `ROLE_SLEEP_OUTPUT_LIMIT` | | 睡眠整理模型輸出套用前的字元上限 | `8000` |
|
||||
| `ROLE_NAP_ENABLED` | | 小睡整理開關；CLI 閒置一段時間且 inbox 達門檻時自動整理 | `1` |
|
||||
| `ROLE_NAP_IDLE_MINUTES` | | 小睡前需連續閒置的分鐘數，由 Stop hook 記錄最後互動時間 | `45` |
|
||||
| `ROLE_NAP_MIN_INBOX` | | 小睡整理所需的最少待整理 inbox 筆數 | `3` |
|
||||
| `ROLE_NAP_INTERVAL_MINUTES` | | 小睡排程檢查間隔分鐘數（cron 每 `*/N` 分鐘觸發） | `10` |
|
||||
| `ROLE_SCOPE` | | 冒號分隔的路徑前綴，僅這些路徑下的 session 載入／記錄 | 全部 session |
|
||||
| `ROLE_ERRLOG` | | 錯誤訊息額外寫入的檔案路徑 | 只走 stderr |
|
||||
|
||||
@@ -149,7 +153,7 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
|
||||
多個來源可各寫一則，或合併同主題後以最主要來源作 `--source`。不可寫入憑證或個資。
|
||||
10. 若尚未有啟用角色，或使用者要求，寫入 `~/.roles/.active`（單行角色 ID）。
|
||||
11. 執行 `ROLE_NAME="<id>" "${ROLE_DIR}/role_sleep.sh" --install-cron` 安裝睡眠排程（已安裝則更新）。
|
||||
11. 執行 `ROLE_NAME="<id>" "${ROLE_DIR}/role_sleep.sh" --install-cron` 安裝睡眠與小睡排程（已安裝則更新；小睡預設啟用，可用 `ROLE_NAP_ENABLED=0` 關閉）。
|
||||
12. 回報結果時列出角色顯示名稱、角色 ID、角色檔、記憶目錄、是否建立初始記憶，並提醒：**重開 CLI 工作階段**角色才會載入；`SessionStart` hook 只在啟動時觸發。
|
||||
|
||||
### `--use <角色 ID>`
|
||||
@@ -170,6 +174,16 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
|
||||
輸出整理結果（新增／合併／捨棄／歸檔筆數與遺忘清單）。
|
||||
|
||||
### `--nap`
|
||||
|
||||
小睡整理：由 cron 全天依 `ROLE_NAP_INTERVAL_MINUTES` 檢查一次；當 Stop hook 記錄的最後互動時間已超過 `ROLE_NAP_IDLE_MINUTES`，且 `inbox/` 至少有 `ROLE_NAP_MIN_INBOX` 則待整理記憶時，自動執行一次記憶整理：
|
||||
|
||||
```bash
|
||||
"${ROLE_DIR}/role_sleep.sh" --nap
|
||||
```
|
||||
|
||||
小睡不受 `ROLE_SLEEP_START`／`ROLE_SLEEP_END` 限制；它只避開整理用的 headless 子 CLI，讓互動式 CLI 長時間閒置時仍可整理記憶。若未設定環境變數，預設為 `ROLE_NAP_ENABLED=1`、`ROLE_NAP_IDLE_MINUTES=45`、`ROLE_NAP_MIN_INBOX=3`、`ROLE_NAP_INTERVAL_MINUTES=10`。
|
||||
|
||||
### 額度控制策略
|
||||
|
||||
角色系統預設避免因常駐人格與記憶造成大量模型額度占用：
|
||||
@@ -179,6 +193,7 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
| SessionStart | 預設 `ROLE_LOAD_LIMIT=4000`，只載入高優先度全文與中高優先度摘要；低 priority、無 links、久未更新的記憶不進 context |
|
||||
| SessionStop | 先用本地規則略過短回合與無記憶線索的對話，只有值得保存才呼叫模型做輕量編碼 |
|
||||
| Sleep | 高成本的去重、合併、抽象化、links 建立與長期記憶型態標記留到睡眠週期，但仍受 `ROLE_SLEEP_COLLECT_LIMIT`、`ROLE_SLEEP_BATCH`、`ROLE_SLEEP_EXISTING_LIMIT` 與 `ROLE_SLEEP_OUTPUT_LIMIT` 控制；沒有 inbox 時只做本地遺忘檢查 |
|
||||
| Nap | Stop hook 記錄最後互動時間；小睡排程只在閒置時間與 inbox 筆數達門檻時執行，使用同一套 NREM/REM 整理流程 |
|
||||
| 手動節流 | 可設 `ROLE_CAPTURE_ENABLED=0` 關閉 Stop 記錄，或調低 `ROLE_LOAD_LIMIT`／調高 `ROLE_LOAD_FULL_MIN_PRIORITY` |
|
||||
|
||||
Stop hook 只做「編碼前處理」，輸出粗分類、summary、tags、priority、relevance、memory_type 與要點；系統會把 inbox 標為 `retention_stage: working`。完整 NREM/REM 整理與 `declarative`／`retention_stage: long_term` 判定只在睡眠週期進行。
|
||||
@@ -197,7 +212,7 @@ node "${ROLE_DIR}/memory.js" forget --role "<角色 ID>" --dry-run
|
||||
"${ROLE_DIR}/role_sleep.sh" --status
|
||||
```
|
||||
|
||||
輸出角色、定義檔、睡眠時段、目前是否睡眠中、cron 排程與服務狀態、摘要 CLI、各分類記憶筆數、上次整理與遺忘時間。**角色沒有載入時**再逐項檢查：
|
||||
輸出角色、定義檔、睡眠時段、小睡條件、目前是否睡眠中、cron 排程與服務狀態、摘要 CLI、各分類記憶筆數、上次互動、上次整理與遺忘時間。**角色沒有載入時**再逐項檢查：
|
||||
|
||||
| 檢查項 | 判準 |
|
||||
| --- | --- |
|
||||
@@ -276,6 +291,7 @@ updated: <yyyy/MM/dd HH:mm:ss>
|
||||
- 每天 **22:00 至隔天 06:00 為睡眠時段**（可用 `ROLE_SLEEP_START`／`ROLE_SLEEP_END` 調整）。
|
||||
- 睡眠時段內啟動 CLI **不會載入角色**：以一般助理身分回應，不自稱角色、不使用角色語氣與簽名 emoji。此時對話仍會被記錄成記憶。
|
||||
- 睡眠排程每小時檢查一次，**偵測到有 AI 正在運行就不睡**，留到下個整點再試；沒有 AI 運行才進入睡眠並整理記憶。
|
||||
- 小睡排程預設啟用：CLI 最後互動時間超過 45 分鐘且 `inbox/` 至少 3 則待整理記憶時，可不等睡眠時段自動整理；可用 `ROLE_NAP_ENABLED`、`ROLE_NAP_IDLE_MINUTES`、`ROLE_NAP_MIN_INBOX` 與 `ROLE_NAP_INTERVAL_MINUTES` 調整。
|
||||
|
||||
### 記憶
|
||||
|
||||
@@ -283,6 +299,7 @@ updated: <yyyy/MM/dd HH:mm:ss>
|
||||
- 整理規則採睡眠分期模型：**NREM 鞏固**先分類成重要／興趣／新知／技能／日常／其他六類，去除雜訊、去重、合併、設定標籤、摘要與優先度；**REM 整合**再建立跨記憶關聯、抽出可重複使用的規則與提取線索，並標記 `memory_type`（semantic／episodic／procedural／emotional／preference／rule）、`declarative`（explicit／implicit）與 `retention_stage`；原始記錄壓縮保存在 `archive/raw/`。
|
||||
- **日常與其他**兩類會依使用頻率、優先度、型態與關聯適當遺忘：久未再次出現、命中次數低、優先度低且沒有關聯者，壓縮到 `archive/forgotten/` 後移出常用記憶；`episodic` 短期事件更容易遺忘，`rule`／`preference`／`procedural` 會提高保留權重。
|
||||
- 載入順序：**重要與興趣載入全文**；其餘只載入總結與標籤，依**技能 → 新知 → 日常 → 其他**排序，並優先保留 `rule`／`preference`／`procedural` 與有 links 的記憶。需要細節時自行讀取對應分類的記憶檔。
|
||||
- 未整理記憶（`inbox/`）累積到一批睡眠整理量（預設 `ROLE_SLEEP_BATCH=60`）以上時，角色應主動以符合自身設定的語氣提醒「想睡覺」或需要整理記憶；這是建議整理／歸檔的提醒，不代表停止協助使用者。
|
||||
- 使用者明確要求記住某件事時，主動補寫一則記憶（載入時會提供補寫指令）。
|
||||
- **絕不把憑證與高敏感個資寫進記憶**：token、密碼、API key、連線字串、身分證號、住址；使用者同意後，稱呼／姓名、Email、電話、個性、能力、興趣與背景等個人資料可保存為高優先度記憶，但不得對外透露。
|
||||
<!-- JSC-ROLE-COMMON:END -->
|
||||
@@ -350,6 +367,10 @@ flowchart TD
|
||||
L[SessionStart：白天啟動 CLI] --> M{距上次整理 ≥ 20 小時<br/>且 inbox 有內容?}
|
||||
M -- 是 --> N[背景補跑 --catchup]
|
||||
M -- 否 --> O[正常載入角色與記憶]
|
||||
P[Stop hook：每輪結束] --> Q[更新 last_activity]
|
||||
R[小睡 cron<br/>每 ROLE_NAP_INTERVAL_MINUTES 分鐘] --> S{閒置 ≥ ROLE_NAP_IDLE_MINUTES<br/>且 inbox ≥ ROLE_NAP_MIN_INBOX?}
|
||||
S -- 是 --> D
|
||||
S -- 否 --> T[略過]
|
||||
```
|
||||
|
||||
整理失敗（模型無回應、輸出非合法 JSON）時**保留 inbox 不動**，留到下個週期重做，寧可晚整理也不遺失記憶。
|
||||
|
||||
Reference in New Issue
Block a user