
LifeOS 联系人记忆层 CONTACTS.md 实战指南模板格式、DA 上下文消费与安全治理【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOSLifeOS 的CONTACTS.md是身份层Identity Layer中专门承载数字助理DA应该认识的人的轻量记忆文件位于LifeOS/install/USER/CONTACTS.md。它以极简的短条目格式记录每个人与你的关系上下文让 DA 在对话消歧义、起草消息、提醒逾期联系时拥有可靠的事实依据。本文将从模板字段规范出发结合仓库源码深入讲解该文件的填充流程、系统消费链路、变更治理规则与安全分级帮助你在实际安装中正确使用这一核心记忆载体。一、CONTACTS.md 的定位一份小而诚实的关系记忆在 LifeOS 的整体设计中USER/目录承载系统对使用者本人的全部认知——身份、声音、目标、项目与工作上下文。目录中的文件会在每次会话启动时被CLAUDE.md的-import 机制加载使 DA 启动时就知道你是谁、你在做什么见 USER/README.md。其中CONTACTS.md专门存放人际关系的结构化事实其模板头部一句话点明了设计意图People the DA should know about — short entries, relational context. DA 应该认识的人——短条目、关系上下文。模板末尾的维护原则同样关键The DA uses this file to disambiguate names in conversation (which Sarah?), recall context when drafting messages, and flag overdue touches. Keep it small and honest — names without context dont help. DA 用此文件在对话中消除名字歧义哪个 Sarah、起草消息时回忆上下文并标记逾期未联系的人。保持小而诚实——没有上下文的姓名毫无帮助。这意味着CONTACTS.md不是通讯录不是 CRM而是一份供 DA 快速消费的关系语境索引。它要求每个条目精炼到一行为什么这个人重要拒绝堆砌无上下文的姓名。二、模板字段规范每个条目的最小结构CONTACTS.md本身是一个安装模板frontmatter 标记provenance: template定义了每个联系人的标准条目格式。原文档规定每条目包含name姓名、relationship关系、context上下文、last touch最近联系时间可选、handle/email账号/邮箱可选具体 Markdown 结构如下### Name **Relationship:** collaborator / friend / client / family / other **Context:** one-line why they matter **Handle:** username / email (if relevant) **Last touch:** YYYY-MM-DD (optional)逐字段说明字段是否必填取值建议### Name条目标题必填人名本身这是 DA 消歧义的锚点Relationship必填collaborator协作者/friend朋友/client客户/family家人/other其他Context必填一句话说明为什么这个人重要如 leads the design system migrationHandle可选username或邮箱用于消息起草与触达Last touch可选YYYY-MM-DD格式用于逾期联系提醒该文件通过### Name二级标题区分不同条目**字段名:**加粗标签保证 DA 解析的稳定性。保持条目短小精悍是本文件最核心的书写规范。三、如何填充/interview contacts与 Phase 0 引导模板中明确标注了填充入口(interview — add people one at a time via /interview contacts)即通过 LifeOS 的Interview 技能逐个添加联系人而非一次性手动灌入。这背后是两条源码可证的机制链路3.1 Interview 技能的会话式填充Interview 技能Interview/SKILL.md是一个以证据为基线的上下文刷新会话它先读取宪法文件TELOS、身份、项目等与 CURRENT_STATE / IDEAL_STATE 维度文件检查新鲜度再用观察数据睡眠、应用使用时间、工作注册表、git 节奏、开支账本对照过时声明驱动一场声明 vs 证据的对话逐条起草修正案供你批准。在全新安装时Interview 会路由到Phase0SetupWorkflows/Phase0Setup.md按顺序走完六个引导目标DA 身份、Principal 身份、语音 ID、凭据、第一个项目、工作仓库。而联系人这类持续增量的内容则在日常/interview会话中以一次一个人的方式通过contacts目标录入遵循一次只问一个问题、每步可跳过、已填字段不重复询问的对话规则。3.2 InterviewScan 的完整性扫描支撑Interview 的路由与优先级由InterviewScan.tsLIFEOS/TOOLS/InterviewScan.ts驱动。该工具对统一 TELOS 各节与 setup/identity 文件做完整性扫描计算completeness_score0–100按杠杆权重排序并输出缺口报告支持的 CLI 参数包括bun ~/.claude/LIFEOS/TOOLS/InterviewScan.ts # 人类可读缺口报告默认 bun ~/.claude/LIFEOS/TOOLS/InterviewScan.ts --json # 供 Interview 技能消费的 JSON 计划 bun ~/.claude/LIFEOS/TOOLS/InterviewScan.ts --next # 只显示下一个高优先级目标与提示 bun ~/.claude/LIFEOS/TOOLS/InterviewScan.ts --file path # 深度扫描单个文件从源码的REGISTRY注册表看扫描器把访谈目标分为多个 phasePhase 0 为首次运行设置、Phase 1 为基础 TELOS 上下文、Phase 3 为偏好区bands/movies/restaurants 等、Phase 4 为当前状态与身份。联系人录入作为持续的上下文维护由会话驱动的对话流程完成而review_mode完整性 ≥ 80% 时进入复核而非填空模式保证了已填条目不会被反复追问。四、系统如何消费 CONTACTS.md源码级证据CONTACTS.md的价值体现在 DA 的三类运行时消费中——名字消歧义、消息起草上下文、逾期联系标记。仓库中的多处实现直接印证了这一点4.1 身份表面注册启动即知在 hooks/lib/system-surfaces.ts 中CONTACTS.md被注册为tier: identity、label: CONTACTS的系统表面文件在 PULSE/modules/user-index.ts 中则登记为category: identity、kind: reference、publish: false——即它是身份层引用数据默认不对外发布。CLAUDE.template.mdCLAUDE.template.md在Principal — Identity Voice章节也将Contacts — CONTACTS.md列为身份文件的组成部分。4.2 记忆系统联系人条目的自动提议在 LifeOS 的记忆系统中CONTACTS.md有专门的路由类型。见 DOCUMENTATION/Memory/MemorySystem.md 的触发条件表|contacts|USER/CONTACTS.md| {{PRINCIPAL_NAME}} mentions a person 3 times with role, relationship, and why they matter | 当主理人提到某个人 3 次以上且带有角色、关系与重要性说明时触发联系人条目提议对应地LIFEOS/TOOLS/MemoryTypes.ts 定义了CONTACTS_PATH常量、contacts这一ProposalTargetKind提议子类型并通过PROPOSAL_KIND_TO_FILES白名单将contacts提议严格绑定到CONTACTS.mdclosed allowlist、默认拒绝防止提议落到任意文件。4.3 变更治理Tier B 审计追加CONTACTS.md的写入权限由四层变异分类器MutationTier.tsLIFEOS/TOOLS/MutationTier.ts管控。该分类器是纯代码白名单无配置文件、默认拒绝CONTACTS.md被明确列入Tier BTier B — logged-append only. Reviewer Phase 2 may append, writing a row to tier-b-writes.jsonl per write. (PROJECTS.md, CONTACTS.md, anything under MEMORY/KNOWLEDGE/)也就是说记忆审查器Memory Reviewer对CONTACTS.md只能审计式追加——每次写入都会在tier-b-writes.jsonl中留下一条审计行绝不允许静默覆盖。这一设计让联系人记录既保持增量更新能力又具备完整变更可追溯性。4.4 自愈与派生保护CONTACTS.md还被纳入系统的自我修复与派生一致性保障RULES/SelfHealing.md 将其列为可自愈的项目/联系人/意见类状态文件之一LIFEOS/TOOLS/DeriveDenyHashes.ts 将其纳入派生拒绝哈希管理LIFEOS/TOOLS/DerivedSync.ts 在派生同步中保留其内容确保衍生文件不会破坏联系人主记录。五、安全与隐私RESTRICTED 级敏感数据联系人是高敏数据。在 LifeOS 的数据分级中DOCUMENTATION/Security/DataClassification.md 将LIFEOS/USER/CONTACTS.md明确列为RESTRICTED级RESTRICTED— auth material, third-party PII, customer-owned data... contacts PII... Paths: ...LIFEOS/USER/CONTACTS.md.Also the fail-closed default.RESTRICTED——认证材料、第三方 PII、客户自有数据、联系人 PII……路径含LIFEOS/USER/CONTACTS.md且为默认兜底级别。同时 skills/Daemon/Docs/SecurityClassification.md 也标注LIFEOS/USER/CONTACTS.mdContains real names, emails, phones包含真实姓名、邮箱、电话。隐私层面USER/README.md 明确说明USER/目录下的所有内容均为私有绝不会随任何 LifeOS 发行版发布发布构建器会在暂存阶段删除整个USER/树并以通用脚手架取而代之。因此你在本地填写联系人信息时无需担心随仓库分发泄露。六、实操建议把小而诚实落到日常综合模板规范与源码机制维护CONTACTS.md的推荐做法是通过/interview contacts逐条录入让 DA 用会话方式确认关系与上下文而非一次性粘贴大段数据新安装时优先完成 Phase 0 引导再进入日常访谈。坚持字段最小化每条目必有Relationship与一行ContextHandle、Last touch按需补充。没有上下文的姓名对 DA 是噪音应删除。用Last touch驱动逾期提醒日期统一为YYYY-MM-DDDA 据此标记久未联系的人。接受审计式追加由于CONTACTS.md属于 Tier B系统写入均带tier-b-writes.jsonl审计日志人工编辑时也应保持追加而非大段重写便于追溯。注意隐私边界文件内容属 RESTRICTED 级涉及真实姓名、邮箱与电话避免在非本机会话中回显或分享。CONTACTS.md是 LifeOS 身份层中体积最小、却直接影响 DA 社交智能的关键文件。掌握它的格式、填充入口、消费链路与治理规则你就能让 DA 在每一次对话中准确区分哪个 Sarah、起草消息时有据可依、联系疏漏时及时得到提醒。【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考