核心用法
LDM OS 是一套面向多 AI 环境的共享基础设施系统，旨在解决不同 AI（Claude、GPT、Grok 等）之间记忆与工具无法互通的问题。用户通过 npm install -g @wipcomputer/wip-ldm-os 安装 CLI 工具后，可执行 ldm init 完成初始化，建立 ~/.ldm/ 目录结构作为统一配置仓库。
主要工作流程分为状态检查与安装更新两大场景。已安装场景下，系统执行 ldm status 获取当前组件状态，通过 GitHub API 拉取各组件最新 release 信息，生成版本对比表格，并将技术变更日志翻译为用户价值语言。未安装场景下，系统读取 PRODUCT.md 向新用户解释共享基础设施概念，展示 SKILLS-CATALOG.md 中的内置与可选技能清单。
命令体系遵循安全优先原则：强制 --dry-run 预览、显式用户确认后才执行实际安装、ldm doctor 诊断与 --fix 自动修复构成闭环。--fix 操作具有幂等性，可清理失效注册表项、临时 MCP 配置、过时 Claude Code 环境变量等历史遗留问题。
显著优点
- 跨 AI 协同突破：首次实现 Claude Code、ChatGPT、Grok 等异构 AI 间的记忆与工具共享，消除"每个 AI 孤岛"痛点
- 声明式配置管理：采用类包管理器的语义化版本控制，组件更新可追溯、可回滚
- 防御性设计："Dry-run 优先"与显式确认机制防止误操作；
--fix的幂等性设计确保系统可自愈 - 生态扩展性：模块化技能体系支持第三方扩展，SKILLS-CATALOG 提供结构化接入路径
- 环境感知能力：内置接口检测表，自动识别 GPT-4、Claude Code、OpenClaw 等不同运行环境的命令执行能力
潜在缺点与局限性
- Node.js 依赖门槛：要求 Node 18+ 与 npm，对非技术用户形成安装壁垒
- npm 全局安装风险：
-g全局包可能引发权限问题或与系统 Node 版本冲突 - GitHub 依赖单点：release 查询与包分发依赖 GitHub 可用性，企业内网场景受限
- Claude 生态深度绑定：
--fix清理逻辑针对 Claude Code 特定配置（CLAUDE_CODE_*环境变量、/tmp/MCP 路径等），其他 AI 环境适配不足 - 状态文件黑盒：
crystal.db等核心数据格式未公开，高级用户难以审计
适合人群
- 多 AI 并行的重度用户：同时在 Claude Code、ChatGPT、Grok 间切换，需要统一工具链与记忆上下文
- AI 工作流架构师：需要为团队建立标准化的 AI 协作基础设施
- Claude Code 深度用户：希望解决版本升级导致的配置漂移、环境变量冲突等问题
- 开源工具集成者：愿意通过 npm/git 工具链管理 AI 扩展的技术用户
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 供应链攻击 | npm 包或 GitHub release 被篡改 | MIT 开源许可允许审计，建议固定版本安装 |
| 配置覆盖 | `--fix` 可能误删用户自定义 Claude 配置 | 设计声明"sacred data"保护规则，doctor 先诊断后修复 |
| 权限提升 | npm global 安装需 sudo，可能破坏系统 Node | 建议使用 nvm/fnm 等版本管理器隔离环境 |
| 数据泄露 | `~/.ldm/` 目录可能包含敏感 agent 数据 | 本地存储不经过网络传输，但需用户自行备份 |
| 版本锁定冲突 | 多 AI 环境对同一组件版本要求不同 | 语义化版本与更新表格可视化，用户显式决策 |