feat(role): 新增角色記憶預算與心理學記憶型態 #9

2026-07-28T03:48:23Z

jiantw83 commented

2026-07-28 03:48:23 +00:00

變更摘要

新增角色啟動問候與新建角色初始記憶流程，角色檔名、記憶目錄與環境變數統一使用英文大寫 ID 加數字索引。
將角色記憶工具由 Python 改寫為 Node.js，移除 Python 版本並更新 hook 呼叫鏈。
調整 SessionStart 記憶載入策略，依字元預算載入高價值記憶，避免角色記憶大量占用額度。
調整 Stop hook：先本地過濾低價值回合，再以輕量編碼寫入 inbox；睡眠時段仍記錄但不載入角色。
調整 Sleep 流程：遵守 collect/batch/existing/output 預算，將高成本去重、合併、抽象化與 links 建立留到睡眠週期。
新增心理學記憶型態 metadata：memory_type（semantic／episodic／procedural／emotional／preference／rule）、declarative（explicit／implicit）、retention_stage（working／long_term）。
將 inbox/ 定義為工作記憶，睡眠整理後才進長期記憶；感覺記憶與無結論工具雜訊不落檔。
更新 README 與 role skill 文件，並同步 plugin manifest 最終版本至 0.0.5（origin/master 目前為 0.0.4）。

記憶結構調整

保留既有資料夾分類：important／interest／news／skill／daily／other，避免破壞現有載入邏輯與舊記憶。
新增 frontmatter metadata 補足心理學分類，不用搬遷既有記憶檔。
舊記憶讀取時依分類與路徑補預設值：例如 skill 預設 procedural，daily 預設 episodic，inbox 預設 working。
載入排序提高 rule／preference／procedural 權重；低優先度但具長期行為價值的記憶不會被過早排除。
遺忘規則仍只作用於 daily／other，episodic 較早遺忘，rule／preference／procedural 受保護。

影響範圍

scripts/role/memory.js：角色記憶讀寫、載入排序、睡眠套用、遺忘與統計。
scripts/role/role_capture.sh：Stop hook 記憶編碼欄位與提示詞。
scripts/role/role_sleep.sh：睡眠整理 JSON schema、長期記憶判定與預算控制。
scripts/role/role_load.sh、scripts/role/role_lib.sh：Node 工具呼叫與載入預算流程。
README.md、skills/role/SKILL.md：角色 ID、初始記憶、載入預算與心理學記憶型態說明。
plugin.json、.codex-plugin/plugin.json、.claude-plugin/plugin.json：最終版本 0.0.5。

驗證

node --check scripts/role/memory.js scripts/role/transcript.js
bash -n scripts/role/role_capture.sh scripts/role/role_load.sh scripts/role/role_sleep.sh scripts/role/role_lib.sh
manifest JSON parse：plugin.json、.codex-plugin/plugin.json、.claude-plugin/plugin.json
git diff --check
role memory smoke test：collect／apply／load／stats／forget --dry-run

## 變更摘要 - 新增角色啟動問候與新建角色初始記憶流程，角色檔名、記憶目錄與環境變數統一使用英文大寫 ID 加數字索引。 - 將角色記憶工具由 Python 改寫為 Node.js，移除 Python 版本並更新 hook 呼叫鏈。 - 調整 SessionStart 記憶載入策略，依字元預算載入高價值記憶，避免角色記憶大量占用額度。 - 調整 Stop hook：先本地過濾低價值回合，再以輕量編碼寫入 inbox；睡眠時段仍記錄但不載入角色。 - 調整 Sleep 流程：遵守 collect/batch/existing/output 預算，將高成本去重、合併、抽象化與 links 建立留到睡眠週期。 - 新增心理學記憶型態 metadata：`memory_type`（semantic／episodic／procedural／emotional／preference／rule）、`declarative`（explicit／implicit）、`retention_stage`（working／long_term）。 - 將 `inbox/` 定義為工作記憶，睡眠整理後才進長期記憶；感覺記憶與無結論工具雜訊不落檔。 - 更新 README 與 role skill 文件，並同步 plugin manifest 最終版本至 `0.0.5`（`origin/master` 目前為 `0.0.4`）。 ## 記憶結構調整 - 保留既有資料夾分類：important／interest／news／skill／daily／other，避免破壞現有載入邏輯與舊記憶。 - 新增 frontmatter metadata 補足心理學分類，不用搬遷既有記憶檔。 - 舊記憶讀取時依分類與路徑補預設值：例如 skill 預設 procedural，daily 預設 episodic，inbox 預設 working。 - 載入排序提高 rule／preference／procedural 權重；低優先度但具長期行為價值的記憶不會被過早排除。 - 遺忘規則仍只作用於 daily／other，episodic 較早遺忘，rule／preference／procedural 受保護。 ## 影響範圍 - `scripts/role/memory.js`：角色記憶讀寫、載入排序、睡眠套用、遺忘與統計。 - `scripts/role/role_capture.sh`：Stop hook 記憶編碼欄位與提示詞。 - `scripts/role/role_sleep.sh`：睡眠整理 JSON schema、長期記憶判定與預算控制。 - `scripts/role/role_load.sh`、`scripts/role/role_lib.sh`：Node 工具呼叫與載入預算流程。 - `README.md`、`skills/role/SKILL.md`：角色 ID、初始記憶、載入預算與心理學記憶型態說明。 - `plugin.json`、`.codex-plugin/plugin.json`、`.claude-plugin/plugin.json`：最終版本 `0.0.5`。 ## 驗證 - `node --check scripts/role/memory.js scripts/role/transcript.js` - `bash -n scripts/role/role_capture.sh scripts/role/role_load.sh scripts/role/role_sleep.sh scripts/role/role_lib.sh` - manifest JSON parse：`plugin.json`、`.codex-plugin/plugin.json`、`.claude-plugin/plugin.json` - `git diff --check` - role memory smoke test：collect／apply／load／stats／forget --dry-run

jiantw83 added 3 commits 2026-07-28 03:48:23 +00:00

feat(role): 新增角色啟動問候與初始記憶種子 c7b7e684a5

docs(README): 說明角色 ID 與初始記憶流程 716fd2c26e

chore(plugin 版本): 三家 manifest 升版 0.0.6 e71f165e9a

jiantw83 added 3 commits 2026-07-28 04:31:06 +00:00

refactor(role): 將角色記憶工具改寫為 Node.js fec3e1d0cb

docs(role): 補充記憶預算與 Node 工具說明 57a493e612

chore(plugin 版本): 升版 generic 至 0.0.8 78f4086a48

jiantw83 changed title from ~~feat(role): 新增角色啟動問候與初始記憶種子~~ to refactor(role): 將角色記憶工具改寫為 Node.js

2026-07-28 04:31:56 +00:00

jiantw83 added 3 commits 2026-07-28 04:46:39 +00:00

feat(role): 新增心理學記憶型態 metadata 3a3114b8b3