relation-keeper

Relation Keeper 是一款专注于个人社交关系管理的本地化 Agent Skill，通过构建「人物肖像维护-未来事件提醒-过去经历归档」的完整闭环，帮助用户系统性地沉淀人脉资产。其核心用法围绕三类数据展开：在 portraits.json 中维护联系人基础信息与动态事实（如喜好、职位变迁），在 future_events.json 中记录生日、约会等需提醒事项并通过 Cron 定时扫描实现 7 天/3 天/当天分级提醒，在 past_events.json 中归档聚餐、会议等历史互动。所有数据均以 JSON 格式本地存储，通过 Node.js 脚本提供命令行与对话式交互接口。

该 Skill 的显著优点在于极致的隐私安全性和架构轻量性。数据完全存储于本地目录（可通过 RELATION_KEEPER_DATA 自定义路径），无任何网络上传行为，特别适合对隐私敏感的用户；零外部依赖设计（仅使用 Node.js 内置模块）杜绝了供应链攻击风险。功能设计上采用「扫描式提醒」而非「一次性定时任务」，通过每 15 分钟运行的 Cron 任务统一检查所有待办事项，逻辑简洁且易于维护。此外，自然语言触发示例丰富，支持「记一下」「下周有什么安排」等口语化指令，降低了使用门槛。

潜在局限性包括：当前为单机版架构，无法多设备同步或团队协作；JSON 文件存储在超大规模数据（数千人级）场景下性能可能受限；作为 T3 级社区来源，长期维护的可持续性需观察。此外，虽然安装脚本自动配置定时任务，但若 OpenClaw 环境不稳定可能导致提醒失效。

该 Skill 特别适合需要维护深度社交关系的职场人士、销售、自由职业者，或任何希望系统性记住朋友生日、重要纪念日及个人喜好的用户。它不适用于需要企业级 CRM 功能或多端实时同步的场景。

使用风险主要涉及数据管理与环境依赖：用户需自行定期备份 $RELATION_KEEPER_DATA 目录，防止误删；时区配置错误（RELATION_KEEPER_TZ）可能导致提醒时间偏差；定时任务依赖 OpenClaw 的 Cron 机制，若主程序退出则提醒中断。建议重要数据采用版本控制或云盘同步备份目录。