Agent Skills
返回列表
Codex Agentmemory Windows 配置修复

Codex Agentmemory Windows 配置修复

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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 会话噪声的自动化维护者,想过滤后台建议任务造成的重复会话。