Codex Agentmemory Windows 配置修复
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-codex-agentmemory-windows。
技能介绍
问题
Codex App 在 Windows 下接入 agentmemory 时,常见故障不是“没有数据”,而是记忆无法稳定注入会话、钩子命令因 PowerShell 引号与路径报错、知识图谱节点和边长期不增长,或后台建议任务被误记成重复会话。
技能如何工作
- 修复钩子链路:生成
agentmemory-hook.cmd,用cmd.exe调用session-start.mjs、prompt-submit.mjs、pre-tool-use.mjs等脚本,并同步hooks.json、config.toml、可信哈希与插件钩子开关。 - 修复记忆注入:要求钩子输出
hookSpecificOutput.additionalContext和hookEventName,而不是只把 XML 文本打到标准输出;再检查会话 JSONL 中是否出现 developer 上下文消息。 - 修复知识图谱:检查
GRAPH_EXTRACTION_ENABLED,小批量调用graph/extract,修补边 ID 重映射,并可用已有观察数据做保守回填。 - 过滤噪声:识别 Codex Desktop 后台建议任务,避免把
# Overview Generate...一类自动任务记录为用户会话。
适用边界
适合排查 Windows 环境、PowerShell 钩子、agentmemory 服务补丁和数据目录漂移;不适用于重新设计记忆模型或替代 Codex 自身的权限控制。升级 @agentmemory/agentmemory 后可能覆盖补丁,需要重新检查 stop.mjs 与 dist\index.mjs。
使用场景
- 在 Windows Codex App 中新会话看不到历史记忆,需要排查钩子是否输出 additionalContext。
- PowerShell 调用钩脚本报 Unexpected token,需要改用 cmd.exe wrapper 并校验所有事件退出码。
- agentmemory 观察到数据在增长但图谱节点停滞,需要检查 Stop finalizer 和 graph/extract 批次。
- Codex 后台建议被记录成重复会话,需要识别并忽略 # Overview Generate 前缀。
适合人员
- 维护 Codex 本地钩子的工程师,想修复 Windows 路径与 PowerShell 调用报错。
- 部署 agentmemory 的运维工程师,想确认记忆注入、数据目录和钩子哈希一致。
- 排查知识图谱异常的开发者,想让 Stop 结束后批量抽取并回填节点边。
- 处理 Codex 会话噪声的自动化维护者,想过滤后台建议任务造成的重复会话。