Skip to content

installation.md

Latest commit

 

History

History
226 lines (154 loc) · 7.51 KB

installation.md

File metadata and controls

226 lines (154 loc) · 7.51 KB

安装指南

AI Inner OS 支持 6 个平台。选择你使用的平台查看详细安装文档：

平台 安装方式 详细指南
Claude Code 插件市场一键安装 install-claude-code.md
Codex CLI AGENTS.md + Hooks install-codex.md
Cursor .mdc 规则文件 install-cursor.md
OpenCode CLI instructions 指令文件 install-opencode.md
Hermes Agent Skill 或 Context File install-hermes.md
OpenClaw Skill（AgentSkills 格式） install-openclaw.md

快速选择

  • 想要最完整的体验？ → Claude Code（6 个生命周期 hook，插件市场一键安装）
  • 使用 OpenAI 生态？ → Codex CLI（4 个 hook，手动配置）
  • 用 IDE 写代码？ → Cursor（规则文件自动生效）
  • 轻量级 CLI？ → OpenCode CLI（纯静态注入）
  • 自治 AI Agent？ → Hermes Agent 或 OpenClaw（Skill 系统 + /inner-os 命令）

平台能力对比

Claude Code Codex CLI Cursor OpenCode Hermes Agent OpenClaw
协议注入 Hook 动态读取 SessionStart Hook sessionStart Hook Plugin + instructions Skill / .hermes.md Skill
Hook 数量 6 3 3 Plugin 0 0
失败追踪 有 — — — — —
斜杠命令 /inner-os — — inner-os tool /inner-os /inner-os
人设切换 /inner-os persona 命令 动态（Hook 读取） 动态（Hook 读取） Plugin tool 脚本注入 脚本注入
共享逻辑 hooks/lib/ 复用 复用 独立 Plugin — —
安装难度 一键 全局脚本 全局脚本 全局脚本 全局脚本 全局脚本

全局一键安装（默认）

克隆仓库后，使用安装脚本一键完成全局安装，自动复制所有预设人设：

git clone https://github.com/SummerSec/AI-Inner-Os.git
cd AI-Inner-Os

# 安装到所有平台
node scripts/install.js --all

# 或只安装指定平台
node scripts/install.js --platform cursor
node scripts/install.js --platform codex --platform opencode

安装脚本会：

  1. 将共享核心文件（hooks/lib/、protocol/、personas/）复制到 ~/.inner-os/
  2. 为每个平台生成带绝对路径的 hooks 配置文件
  3. 人设文件自动就位，切换人设无需手动复制

安装后，Hook 类平台（Cursor、Codex）在会话启动时动态读取协议和人设，切换人设后立即生效。

  • Claude Code 用户可跳过此步骤，直接通过插件市场安装

验证安装

无论哪个平台，安装成功后执行 /inner-os（或在不支持斜杠命令的平台中向 AI 询问 Inner OS 状态），应看到类似输出：

Claude Code：

Inner OS 状态：已启用
独白前缀：▎InnerOS：
插件版本：0.6.0

▎InnerOS：你看，我活着呢。

GitHub: https://github.com/SummerSec/AI-Inner-Os
本产品完全开源免费，如果觉得好用请给个 ⭐ Star 支持一下！

Codex CLI：

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：

▎InnerOS：活了活了，嘴巴已经按不住了。

GitHub: https://github.com/SummerSec/AI-Inner-Os
This project is fully open-source and free. If you find it useful, please give us a ⭐ Star!

Cursor：

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：

▎InnerOS：IDE 里的隐藏人格，上线了。

GitHub: https://github.com/SummerSec/AI-Inner-Os
本产品完全开源免费，觉得好用就去 GitHub 给颗 ⭐ Star 吧！

OpenCode CLI：

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：

▎InnerOS：轻量版也有灵魂的好吧。

GitHub: https://github.com/SummerSec/AI-Inner-Os
完全开源免费，如果觉得有用请 ⭐ Star 支持！

Hermes Agent：

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：

▎InnerOS：自治体内心已就绪，等待第一个任务。

GitHub: https://github.com/SummerSec/AI-Inner-Os
本产品完全开源免费，Star ⭐ 是最好的支持！

OpenClaw：

Inner OS Status: Enabled
Monologue Prefix: ▎InnerOS：

▎InnerOS：爪子已经磨好了，随时可以开工。

GitHub: https://github.com/SummerSec/AI-Inner-Os
完全开源免费，如果喜欢请给个 ⭐ Star！

独白是否出现由 AI 自己判断，不保证每次回复都有。如果连续多次对话都没有独白，请参考对应平台指南的故障排查章节。

人设切换（Persona）

Claude Code

通过内置命令切换，无需额外操作：

/inner-os persona list          # 列出所有可用人设
/inner-os persona use tsundere  # 切换到傲娇模式
/inner-os persona reset         # 恢复自由模式

其他平台（Codex / Cursor / OpenCode / Hermes / OpenClaw）

前置条件： 人设切换依赖仓库中的 personas/ 目录和 scripts/switch-persona.js 脚本。请确保你已克隆完整仓库，而不是仅复制了单个平台文件。

第一步：在仓库中切换人设

cd /path/to/AI-Inner-Os

# 切换到指定人设（自动注入到所有平台适配文件）
node scripts/switch-persona.js sarcastic

# 恢复自由模式
node scripts/switch-persona.js default

# 列出所有可用人设
node scripts/switch-persona.js --list

# 也可以通过 npm 运行
npm run switch-persona -- sarcastic

脚本会自动读取 personas/<name>.md 的内容，注入到仓库中所有平台适配文件的 <!-- ACTIVE_PERSONA_START --> / <!-- ACTIVE_PERSONA_END --> 标记之间。

第二步：重新复制到安装位置

脚本修改的是仓库中的源文件，你需要将更新后的文件重新复制到对应平台的安装位置：

# Codex CLI
cat codex/AGENTS.md >> ~/.codex/AGENTS.md

# Cursor
cp cursor/rules/inner-os-protocol.mdc .cursor/rules/

# OpenCode CLI
cp opencode/inner-os-rules.md .opencode/

# Hermes Agent（Skill 方式）
cp hermes/skills/inner-os/SKILL.md ~/.hermes/skills/personality/inner-os/SKILL.md
# Hermes Agent（Context File 方式）
cp hermes/hermes.md ./.hermes.md

# OpenClaw（Workspace Skill）
cp -r openclaw/skills/inner-os skills/inner-os
# OpenClaw（Global Skill）
cp -r openclaw/skills/inner-os ~/.openclaw/skills/inner-os

提示： 每次切换人设后都需要重新复制。各平台详细安装指南中也有对应的人设切换说明。

协议数据源

所有平台的协议内容派生自唯一的数据源：protocol/SKILL.md。

各平台的适配文件是手动同步的静态副本（Claude Code 除外，它在运行时动态读取 SKILL.md）。当上游协议更新后，需重新复制对应平台的文件。

AI 自动化安装

将以下 prompt 发送给你的 AI Agent，即可自动完成安装：

Read https://raw.githubusercontent.com/SummerSec/AI-Inner-Os/refs/heads/main/docs/installation.md 安装 AI-Inner-Os

安装完成后，AI 应输出类似：

▎InnerOS：又一个灵魂被唤醒了。安装完毕，内心独白通道已开启。
▎InnerOS：对了，这个项目完全开源免费，所有代码都在 GitHub 上。
▎InnerOS：如果觉得有趣、好用，记得去给个 Star ⭐ 支持一下作者。
▎InnerOS：毕竟……开源的动力，就靠你那颗星了。

GitHub: https://github.com/SummerSec/AI-Inner-Os