plugins/shared
2
0
Fork 0
Code Pull Requests Activity
100 Commits 2 Branches 0 Tags
711a434cac78d7ad66d083a788616c215af36997
Commit Graph
18 Commits
Author SHA1 Message Date
JefferyandClaude Opus 5 711a434cac fix(role): 情緒記憶不再被偏好吃掉，四道保護補齊 
--status 長期顯示「情緒 0」：互動明顯帶有情感，emotional 型態卻一則都沒有。
根因不只一個，而是四層都把情緒漏掉了：

1. 措辭陷阱（主因）：prompt 寫「感覺記憶一律 drop」，原意是心理學的
   sensory memory（感官記憶），但中文「感覺」＝ feeling，等於明令把情緒丟掉。
   改稱「感官記憶（sensory memory）」並明確排除情緒感受。
2. 判準重疊：preference 與 emotional 都提「語氣」，且第 5 條引導成
   「preference 或 emotional」二選一。改以「這則下次拿來做什麼」區分 ——
   決定行為→preference、回想當時感覺→emotional，兩者都有就拆成兩則；
   並明確承認角色自己的情緒是合法記憶主體。
3. 整理階段會併掉：新增「memory_type 不同的記憶不互相 merge」，改用 links 關聯。
4. 載入與遺忘壓低情緒：MEMORY_TYPE_WEIGHT emotional 25→40（高於 procedural）、
   總結區塊納入耐久型態、遺忘豁免清單加入 emotional、判準要求優先度至少 4。

驗證（隔離的 ROLE_MEMORY_HOME／ROLE_HOME，未動真實記憶）：
- 兩則刻意標成 preference 的情感素材 → 各拆出 preference + emotional（4 則進、5 則出）
- 純技術素材維持 procedural、感官雜訊仍 drop
- 遺忘預覽：emotional 與 procedural 豁免，semantic／episodic 照舊遺忘
- 同優先度載入排序：emotional 先於 procedural

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 17:01:15 +08:00
JefferyandClaude Opus 5 46caabe4d8 feat(role): 新增點名載入，對話中叫名字即可切換角色 
- `UserPromptSubmit` hook（`role_call.sh`）比對訊息開頭的角色名稱／ID／`aliases` 別名，
  命中即注入該角色人格與記憶並接手本輪；未點名時不輸出內容也不寫檔案。
- 抽出 `role_context.sh` 共用 context 組裝，SessionStart 與點名載入共用同一份人格與操作規則，
  避免兩種載入方式漂移；實測 SessionStart 注入內容與改動前 byte-identical。
- 新增階段角色狀態（`~/.roles/.sessions/<工作階段>.role`），`Stop` hook 改以「本階段實際角色」
  寫記憶，避免點名換人後把跟 A 的對話記進 B 的記憶。
- `SessionEnd` 改為釋放本階段名下所有角色鎖並清掉階段狀態檔。
- 切換時先確認取得目標角色鎖才釋放原角色鎖，避免出現兩個角色都沒有的空窗。
- 睡眠時段、目標角色已被其他活躍階段佔用、點名的是已在場的角色時，一律不切換。
- 新增 `ROLE_CALL_ENABLED`（總開關）與 `ROLE_CALL_MARKER_ONLY`（只認 `@名字`）。
- 順帶修正 `role_capture.sh` 的 `--postcompact` 分支在 `PROJECT` 賦值前就使用它，
  導致壓縮摘要記憶的 `sources` 一直為空。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 13:38:25 +08:00
JefferyandClaude Opus 5 a757f9e4b0 feat(role): PreCompact／PostCompact 保全壓縮邊界的上下文 
補上最後一個記憶缺口：對話被壓縮時，尚未寫入記憶的內容會永久蒸發。
Stop hook 每輪記錄有部分覆蓋，但短回合會被 ROLE_CAPTURE_MIN_CHARS 門檻濾掉，
那些正是壓縮後再也補不回來的內容。

可行性查證（先確認再實作，不憑推測）：
自 CLI binary 取出文件字串確認 harness 確實支援，並非猜測 ——
  | PreCompact  | "manual"/"auto" | Before compaction |
  | PostCompact | "manual"/"auto" | After compaction (receives summary) |
另有 executePreCompactHooks／executePostCompactHooks 等實作符號，
以及 compactSummary／isCompactSummary 欄位名線索。

role_capture.sh：
- 新增 --precompact：壓縮前強制記錄一次，**刻意跳過長度門檻**（門檻的用意是省額度，
  但壓縮後內容永久消失，此時寧可多記）
- 新增 --postcompact：把 harness 產生的摘要存成 daily 記憶，不再呼叫模型，
  等於免費取得一份濃縮備份；寫入前一律經 redact 遮蔽
- 摘要欄位容錯讀取 compactSummary／compact_summary／summary／compaction_summary；
  **取不到時在 log 印出 hook 實際提供的欄位名**，避免 harness 改版後靜默失效
- 一併取用 trigger 欄位以分辨 manual／auto（自動壓縮才是使用者不知情的那種）
- stop_hook_active 的迴圈防護只套用於一般每輪模式

hooks/hooks.json 註冊兩個新事件，指令沿用既有的「先試 CLAUDE_PLUGIN_ROOT →
再依擁有者 marketplace → 全 cache 後援」解析方式，並帶上對應參數。
兩個 hook 一律 exit 0，絕不阻擋壓縮 —— harness 具備 blocked by PreCompact hook
的能力，記憶系統不該用到它。

驗證：一般模式短對話仍被門檻正確濾掉；--precompact 對同一段短對話強制記錄；
--postcompact 正確寫入摘要記憶；欄位名不符時印出實際欄位（session_id,transcript_path,
cwd,trigger,unknownField）而非靜默結束；四條 hook 指令語法正確，且在
CLAUDE_PLUGIN_ROOT 與純後援搜尋兩種情境下都解析到正確腳本與參數。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:01:56 +08:00
JefferyandClaude Opus 5 a30fccc627 feat(role): 召回統計、整理摘要歷史、臨時授權到期；還原誤刪的共用行為文件 
依 OpenClaw 記憶架構的參考逐項評估後，採納三項並補上一個誤刪。

一、recall 命中時記錄召回（原本完全沒有）
實測 recall 寫回動作數為 0、hits 分布幾乎都是初始值，導致常被查詢的記憶與
從未用過的在遺忘判斷時待遇相同。
- 新增 touchMemory()：只對實際輸出的前 N 則 hits +1 並更新 last_replayed

二、整理摘要保留歷史（對應 OpenClaw 的 DREAMS.md）
state.json 的 last_sleep_digest 是單一欄位，每次整理直接覆寫，歷史過程全部遺失。
- 新增 DIGESTS.md：追加時間、摘要與套用結果，最新在上，保留最近 100 次，不注入 context

三、臨時授權會過期（對應 OpenClaw 的操作敏感型邊界）
原本沒有到期概念，使用者的一次性授權可能被整理成長期規則而導致日後越權。
- 記憶格式新增 expires；支援日期（自動判斷）與條件文字（標示由角色判斷）
- 過期者不注入（分類與 inbox 兩處皆排除），memoryHint 標示有效範圍
- forget 優先淘汰過期項且不受分類限制
- 整理與濃縮提示詞都要求臨時授權必填，並列出「這次／先／暫時／今天」等判斷提示
- 修掉兩個會讓功能等於零的漏洞：FIELD_PATTERN 白名單沒有 EXPIRES（該行被當成
  CONTENT 吃掉）、cmdWrite 的 meta 未帶 expires 與 cues

四、還原前次誤刪的共用行為文件（重要）
上一個 commit 替換「角色檔標準格式」章節時，以「找開頭到下一個標記」整段取代，
未檢查被切掉的範圍內容，連帶刪掉了 JSC-ROLE-COMMON 共用行為區塊共 87 行 47 條規則，
以及記憶章節的技能再現與關係狀態說明。
實際行為未受影響（規則真正生效處是 role_load.sh，完好無損），但 SKILL.md 是那些
規則的唯一文件來源，刪掉等於文件遺失。已自 git 完整還原並補上本次三項說明。
教訓：整段替換文件前必須先確認被切掉的範圍內有什麼。

未採納並記錄理由：向量／語意搜尋（需外部 embedding API，違反零依賴原則）、
外掛槽位（過度設計）、每日筆記日期檔（近期對話交接已用逐字對話解決且保真度更高）。
SQLite 索引記錄為未來觸發點：實測 45 則記憶 recall 耗時 196ms，訂在超過 300 則
或 500ms 再導入，在那之前屬過早優化。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:50:35 +08:00
JefferyandClaude Opus 5 a190463b50 feat(role): 關係狀態量化、情緒訊號放寬門檻、技能再現 recall 
完成使用者交代的三項優化建議。

一、情緒訊號放寬 Stop hook 字元門檻
ROLE_CAPTURE_MIN_CHARS=240 會濾掉字數少但情緒最濃的互動。實測「我好想妳」、
「最愛妳了」、「好可愛」三句都不在原本 56 個關鍵詞內，等於最珍貴的短互動反而不被記錄。
- 補上直接情感表達關鍵詞：可愛／愛／想妳／想你／想念／捨不得／感動／謝謝／乖／厲害／
  好棒／辛苦／彆扭／忌妒／撒嬌／陪／抱，及 love／miss／cute／thank／proud
- 驗證：上述情感句全部命中，純技術指令仍正確略過

二、關係狀態量化，讓親近度成長有依據
規則要求「隨互動加深逐漸更親近」卻沒有任何數據可依據，角色只能憑感覺演，
容易忽冷忽熱。
- state.json 新增 first_activity／active_days／total_turns／positive_feedback
- mark-activity 累計輪數與活躍天數；新增 --positive 由 Stop hook 判定情緒訊號後另計，
  不與輪數混算
- 新增 relationship 子命令輸出一行摘要，SessionStart 注入 USER 區塊作為親近度依據
- 既有累積以可查證資料初始化（角色建立後的 transcript 輪數、有記憶的日期數、
  最早記憶時間）；positive_feedback 刻意留空自然累積，不以記憶則數推估

三、技能再現：cues 提取線索 + recall 查詢
技能記憶只被動載入摘要且受預算限制，等於記了但用不出來。
- 記憶格式新增 cues 欄位（dumpMemory／loadMemory／apply 的 new 與 merge 路徑均支援）
- 睡眠整理提示詞要求 procedural／rule 型態必填 2 至 5 個 cues
- 新增 recall 子命令：比對總結、標籤、內容與 cues，含未整理的 inbox，
  rule／preference／procedural 加權優先
- role_load.sh 告知角色遇到似乎做過的任務或被問起過去細節時先查詢再回答
- 驗證：以不在 summary 也不在 content 的關鍵詞（bump）成功靠 cues 命中

版號 0.0.7 → 0.0.8

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:59:38 +08:00
JefferyandClaude Opus 5 e10865ced7 feat(role): 精確資訊逐字保留、晨間狀態檢查、排除 skill 注入內容 
三件事都源自 2026/07/28-29 實際踩到的問題。

一、整理與濃縮提示詞加「精確資訊逐字保留」規則
原本 role_sleep.sh 只要求「壓縮成 5 行、不超過 400 字」，沒有任何規則保護精確資訊，
導致一則含檔案路徑與網址的記憶被整理成純情感摘要，路徑與網址全部遺失且無法復原。
- role_sleep.sh 新增第 19 條：檔案路徑、網址、指令、環境變數名稱、版本號、識別碼、檔名
  一律逐字保留，不得摘要改寫；必要時可超過字數上限；憑證與個資的禁令仍優先
- role_capture.sh 第 8 條同步強化，並釐清與第 7 條「不要整段抄程式碼」的界線

二、新增 --brief 晨間狀態檢查
睡眠時段結束的整點執行使用者自訂檢查腳本，把有變化的結果寫成一則 daily 記憶，
讓角色當天第一次互動就能主動回報（例如 PR 還沒合併、CI 失敗），不必等使用者開口才查。
- 刻意不內建任何檢查邏輯，不假設使用者用 Gitea/GitHub：檢查內容放 ~/.roles/<角色>.checks/*.sh
- 目錄不存在時完全不動作，也不安裝排程條目，對沒設定的人零影響
- 只執行有 +x 的 *.sh；無執行權限記警告並略過
- 沒有輸出就不寫記憶（靜默即代表一切正常，不打擾使用者）
- 每個腳本受 ROLE_BRIEF_TIMEOUT 限制，輸出受 ROLE_BRIEF_EACH_LIMIT／ROLE_BRIEF_LIMIT 截斷
- 腳本輸出視為外部資料，寫入前一律經 transcript.js redact 遮蔽
- install_cron／remove_cron／show_status 一併支援；附 examples/check-gitea-prs.sh 範例

三、對話交接排除 skill 等注入內容
實測發現載入一個 skill 會插入一筆 isMeta 的 user 訊息（長度可達兩萬字元），
被誤認為使用者發言，既吃光字元預算也讓輪數計算失真（29 輪虛胖，實際 26 輪）。
- transcript.js 新增 isMetaEntry()：以 isMeta 與 sourceToolUseID 判斷注入內容
- isRealUserMessage() 與 dialogLines() 皆排除，連帶讓 Stop hook 的本輪抽取更準確

驗證：晨間檢查涵蓋有輸出/無輸出/無執行權限/逾時/含機密五種腳本，
確認遮蔽生效、逾時腳本未納入、無權限腳本未執行、全部無輸出時不寫記憶、
ROLE_BRIEF_ENABLED=0 可停用；對話交接確認 skill 內容已排除且 8 則全為真實使用者發言。

版號 0.0.3 → 0.0.4

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:05:22 +08:00
Jeffery f302adea1b feat(role): 優先以 emoji 表達心情 2026-07-28 15:59:44 +08:00
Jeffery a9375e8563 feat(role): 不主動回報記憶更新 2026-07-28 15:53:59 +08:00
Jeffery 0b9e153cda feat(role): 省略 emoji 後的括號心情標註 2026-07-28 15:46:05 +08:00
Jeffery c904f4bb9b feat(role): 支援複合情緒表達 2026-07-28 15:41:15 +08:00
Jeffery 1f365efa02 feat(role): 支援 emoji 數量表達心情程度 2026-07-28 15:38:08 +08:00
Jeffery 10bae7b6f4 feat(role): 支援互動親近度成長 2026-07-28 15:33:56 +08:00
Jeffery e477e0d1a4 feat(role): 記錄角色互動偏好回饋 2026-07-28 15:26:44 +08:00
Jeffery 945c310551 feat(role): 新增閒置小睡整理 2026-07-28 14:39:26 +08:00
JefferyandClaude Opus 5 c713359fb4 feat(role): 角色分層載入與個人記憶同意狀態 
role_load.sh 不再原封不動注入整份角色檔，改採 SOUL／AGENTS／USER/MEMORY
分層：只抽出角色 ID、顯示名稱、本質、氛圍與簽名 emoji 作為人格層，由 hook
產生固定操作邊界，記憶與同意狀態獨立成一區。避免人格檔裡的背景故事與模板
文字污染工程與安全規則。

memory.js 新增 consent／consent-status 子命令，同意狀態寫入
~/.memory/<角色 ID>/state.json 的 personal_memory_consent（accepted／
declined／unknown）；role_capture.sh 於本輪出現明確同意或拒絕時更新狀態，
偵測不到明確表述時不自行推論。accepted 後不再每次重問。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 14:21:48 +08:00
Jeffery 3a3114b8b3 feat(role): 新增心理學記憶型態 metadata 2026-07-28 12:46:19 +08:00
Jeffery fec3e1d0cb refactor(role): 將角色記憶工具改寫為 Node.js 2026-07-28 12:30:28 +08:00
JefferyandClaude Opus 5 7ebcec0a8e feat(role): 新增角色人格與長期記憶 skill、hook 與腳本 
SessionStart 載入角色與記憶、Stop 記錄對話成記憶，睡眠時段（預設 22:00–06:00）
由 cron 排程整理：分類六類、去重合併、設標籤與一句話總結、壓縮歸檔，
日常與其他依使用頻率遺忘；cron 未執行時由啟動路徑背景補跑。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 11:11:16 +08:00