用途:把需要长期保留的数据写入运行中的 Cognee 知识图谱。写入通过 HTTP 发送到 Cognee 服务器的 /api/v1/remember,属于权威路径;cognee-cli 仅在服务器确实不可达且存在 cognee 源码检出时作为最后手段使用。空白的 CLI 输出不能证明写入成功,需向服务器确认。
主要能力:按 node_set 标签把数据分为三类。user 对应 user_context,用于用户偏好、纠正、个人事实与沟通风格;project 对应 project_docs,用于仓库文档、代码上下文、架构决策与公司数据;agent 对应 agent_actions,用于工具调用日志、推理轨迹与生成产物(常规工具日志由 hooks 自动捕获)。上传文件时用 --file 保留真实文件名,扩展名是服务器路由信号,代码文件会走零 LLM 的代码路径而非按散文处理。整个仓库的跨文件索引应改用 cognee-code 技能。
使用方式:根据用户意图选择类别后运行脚本,例如写入用户数据用 ${CLAUDE_PLUGIN_ROOT}/scripts/cognee-remember.sh "$ARGUMENTS" --node-set user_context,项目数据用 --node-set project_docs,代理笔记用 --node-set agent_actions;存储文件可用 ${CLAUDE_PLUGIN_ROOT}/scripts/cognee-remember.sh --file src/payments.py --node-set project_docs。可用 ${CLAUDE_PLUGIN_ROOT}/scripts/cognee-doctor.sh --json 查看模式、server_url 与可达性。
限制与状态:默认后台提交(run_in_background=true),POST 入队后返回 dataset_id 与 pipeline_run_id,status 为 running 表示已提交但尚未进入永久图谱;会话缓存立即可搜索,图谱需 cognify 完成后才可查询。包装脚本默认有界等待(COGNEE_REMEMBER_WAIT_SECONDS 默认 8)并返回 queryable 与 wait_outcome;timeout 表示仍在处理,errored 表示失败,unknown 表示无法确认。可设 COGNEE_REMEMBER_WAIT_SECONDS=0 跳过等待,或设 COGNEE_REMEMBER_BACKGROUND=false 改为同步写入(仅适合小内容)。服务器不可达时才用 cognee-cli,例如 cognee-cli remember "$ARGUMENTS" -d "${COGNEE_PLUGIN_DATASET:-agent_sessions}" --node-set user_context;若 CLI 也不可用,应告知无法持久化并展示 doctor 输出,不能宣称已保存。相关环境变量如 COGNEE_API_KEY、COGNEE_PLUGIN_DATASET 及更多限制资料未完整提供。