lifeos

LifeOS

这是已安装的 LifeOS 技能副本，而非发行版根目录。 其 install/ 目录仅包含引导文件。要更新，请遵循 Intents/Update.md：它会先运行 bash <configRoot>/skills/LifeOS/install/install.sh，以获取完整的发行版技能。之后才能运行 负载工具——OverlaySystem、InstallHooks 和 ScaffoldUser，这些工具需要完整负载。 运行每个工具时都要使用其完整路径：bun <configRoot>/skills/LifeOS/Tools/<Tool>.ts。

LifeOS（生活操作系统）的安装和引导界面。一条命令就能让任何使用任意运行环境的陌生用户从零开始，完成可用且个性化的安装，并让 Pulse 仪表板显示其当前状态与理想状态，而无需让他们改用一套全新的运行环境。

理想状态

• 任何使用受支持操作系统和运行环境的陌生用户，最终都能完成可用且个性化的安装：只需同意一次即可放置 Core；安装所有他们未拒绝的增强功能；移除身份占位符；接入 lifeos 启动命令；并让 Pulse 显示其自身的当前状态和理想状态。
• 对用户设备所做的每项更改都事先展示，并且可撤销：先备份设置和 shell rc；更新和卸载时采取移动或备份，而非删除；绝不覆盖用户创作的内容。
• 安装及其钩子和集成都完成就位后，Interview 才会写入任何内容。
• 安装期间及之后，未经明确同意不会发生任何更改；除非用户启用了可选的 automode 组件（Intents/Setup.md 第 7 步），该组件默认关闭，且需要明确同意。
• 每项“已安装”“已更新”或“已移除”的声明，都以意图文件中指定的证据为依据；用户拒绝的功能应报告为已拒绝，而非故障。
• 仅在用户明确同意后，才会将经过脱敏、可复现的反馈发送至上游。

意图路由

意图	触发词	文件
设置	setup、/LifeOS setup、"install LifeOS"、"integrate into my harness"	Intents/Setup.md
访谈	interview、"onboard me"、"run the interview"、TELOS capture	Intents/Interview.md
诊断	doctor、"check my install"、"what's broken"、"what capabilities are live"	运行 bun <configRoot>/LIFEOS/TOOLS/Doctor.ts（Intents/Setup.md 步骤 9.6）
Pulse	"set up pulse"、"pulse setup"、"audit pulse setup"、"is Pulse healthy"	Intents/Setup.md 步骤 8.6：bun Tools/PulseHealth.ts audit 以只读方式报告 Pulse 健康状况
更新	update、"update LifeOS"、版本升级后	Intents/Update.md
卸载	uninstall、"remove LifeOS"	Intents/Uninstall.md
报告	report、"report this bug"、"file an issue"、"contribute this fix"、"open a PR"、"suggest this to the project"、"ask the LifeOS project"	Intents/Report.md

文件	何时阅读
INSTALL.md	AI 原生安装文档（发布于 ourlifeos.ai/install；主机名为 <configRoot>/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/LifeOS/Config.md 中的 install_host）：能力门槛、先决条件、获取发布版本、DetectEnv、框架集成、支持表和安装规则；获取完成后的所有步骤都在 Intents/Setup.md 中
Workflows/Update.md	适用于 2026-10-08 之前的安装，其 Update 步骤会重新读取此路径：此处是指向 Intents/Update.md 的指引
GETTING-STARTED.md	安装后阅读：可选外部工具（codex、Interceptor、cf、Fish Audio、gh 及其他小型工具）、各工具提供的功能，以及如何验证它们已启用
References/HermesSidecar.md	用户在 Setup 步骤 9.5 中接受了 Hermes sidecar 提议：固定版本的安装、独立的设备代码登录、基于证据的守卫检查，以及需要说明的两项披露
install/	整个系统的载荷（技能、钩子、系统提示词、Algorithm、文档、运行时工具；在获得许可后于设置期间放置）和引导脚本 install/install.sh（发布于 ourlifeos.ai/install.sh）；这是安装工具读取并放置的数据，切勿手动编辑。LifeOS/ 目录包含完整发行版：没有发布根目录中的 install.sh，也没有 .claude/ 副本

doctor 是唯一由工具驱动的路径：Doctor.ts 会显示每项能力的状态，以及任何故障对应的修复方法。转达结果并尊重 decline（Setup 步骤 9.6）。

数据与配置

<configRoot> 是 DetectEnv 报告的框架配置目录（在 Claude Code 中，若已设置则为 $CLAUDE_CONFIG_DIR，否则为 ~/.claude）。LinkUser 完成链接后，可通过 <configRoot>/LIFEOS/USER 访问用户目录树。

• USER/CONFIG/LIFEOS_CONFIG.toml 保存 DA 名称和声音，以及 [principal] 身份信息。Interview 会写入此文件；Update 会读取它，以重新渲染身份占位符。
• USER/PRINCIPAL/PRINCIPAL_IDENTITY.md（仅含正文；名称和声音保存在 LIFEOS_CONFIG.toml 中）与 USER/TELOS/TELOS.md 由 Interview 写入；SeedPulse 会据此生成 LIFEOS_STATE.json 和 PRINCIPAL_TELOS.md。
• USER/CUSTOMIZATIONS/SKILLS/LifeOS/Config.md 保存 install_host（提供 INSTALL.md 和 install/install.sh 的主机；本技能中写为 ourlifeos.ai）、spinner_verbs_file（可选的 spinnerVerbs.json 文件，位于其旁边；spinnerverbs 组件会部署该文件，以替代随附列表），以及 pulse_templates_dir（用户模板目录树；Tools/ScaffoldUser.ts 从中复制内容，Tools/PulseHealth.ts audit 会据此检查 USER/；默认为 <configRoot>/skills/LifeOS/install/USER；对于 ScaffoldUser，显式指定的 --skill-root 优先）。每个键、文件格式和验证运行示例见 Setup.md。
• <configRoot>/LIFEOS/MEMORY/STATE/reports/current/ 保存 Report 意图正在进行的报告；Report.ts reset 会清除此目录。

注意事项

• frontmatter 中的 version: 是组件版本行，不是发行版本。 Claude Code 会忽略它；维护者端的 BumpSkillVersions（不随产品发布）会在源代码仓库中维护它。分发版本，也就是用户所说的“LifeOS 7.x”，由 GitHub 发行版标签、LIFEOS_RELEASES/<version>/ 和 install.sh 获取内容共同决定。切勿将组件版本行当作发行版本号。
• 配置根目录保留其规范名称。 用户目录树位于配置目录下，并链接到 harness 目录树中；“LifeOS”是品牌，解析后的配置路径不会更名（更名会破坏身份 @ 导入）。
• 开发目录检测只检查一个标记。 安装工具会拒绝在 LifeOS 源代码仓库内运行。detectDevTree（Tools/InstallEngine.ts）只检查一项：配置根目录下是否存在维护者端的发行版提示词目录。它不会检查 git 远程仓库，因此无法检测缺少该私有提示词的源代码检出目录。接受 --allow-dev 的工具（InstallSettings.ts、ActivateImports.ts 等）可通过该参数覆盖拒绝限制。切勿修改作者正在使用的系统。
• 配置格式是 .toml，绝不是 .yaml。 LifeosConfig.ts 会读取 TOML；旧版 .yaml 模板已于 2026-06-19 停用。
• 所有安装工具在未指定 --apply 时都会执行试运行（InstallAll 使用 --yes）。在 2026-07-08 至 2026-07-31 期间，文档中的更新路径遗漏了该参数，用户看到看似成功的输出，实际上却没有任何更改。

示例

• “install LifeOS” → 依次完成 Setup 和 Interview：Core 及所有未被拒绝的增强功能均已就绪，每一步都会征求许可，钩子会触发，用户随后直接进入引导流程。
• “run the lifeos interview” → 完成 Interview：记录 TELOS 和当前／理想状态，合并用户的来源，并让 Pulse 显示真实环形图。
• “lifeos doctor” → Doctor.ts：显示能力表，并为任何故障项提供修复命令。
• “audit pulse setup” → PulseHealth.ts audit：显示一个状态块，其中包含架构工具的真实计数、USER 模板副本的来源信息、缺失模板和 /healthz；未运行的项目会明确显示为 NOT RUN。
• “update LifeOS” → 完成 Update：安装内容更新到最新发行版，同时不触碰用户数据；如果已是最新版本，则会报告这一情况。
• “report this bug to LifeOS” → 完成 Report：生成包含五个字段且已脱敏的问题报告，用户阅读后，仅在用户同意时才会发布。“contribute this fix”还会额外运行一遍绿色检查并创建 PR；“suggest this to the project”则会提交一条讨论。