Skip to content

install-opencode.md

Latest commit

 

History

History
154 lines (105 loc) · 3.67 KB

install-opencode.md

File metadata and controls

154 lines (105 loc) · 3.67 KB

OpenCode CLI 安装指南

在 OpenCode CLI 中安装 AI Inner OS。

前置条件

  • OpenCode CLI 已安装
  • 一个打开的项目目录

安装步骤

方式一：全局安装脚本（默认）

git clone https://github.com/SummerSec/AI-Inner-Os.git
cd AI-Inner-Os
node scripts/install.js --platform opencode

脚本会自动：

  • 复制 Plugin 到 ~/.config/opencode/plugins/inner-os.js
  • 复制 instructions 到 ~/.config/opencode/inner-os-rules.md
  • 复制所有预设人设文件到 ~/.inner-os/personas/

Plugin 提供 inner-os 自定义工具，支持状态查询和人设切换。

方式二：手动安装

第一步：复制指令文件

mkdir -p .opencode
cp opencode/inner-os-rules.md .opencode/inner-os-rules.md

第二步：安装 Plugin（可选，提供 inner-os 工具）

# 全局 Plugin（所有项目生效）
mkdir -p ~/.config/opencode/plugins
cp opencode/plugins/inner-os.js ~/.config/opencode/plugins/

# 或项目级 Plugin
mkdir -p .opencode/plugins
cp opencode/plugins/inner-os.js .opencode/plugins/

第三步：配置 opencode.json

如果还没有 opencode.json：

cp opencode/opencode.json ./opencode.json

如果已有 opencode.json：

手动添加 instructions 字段：

{
  "instructions": [".opencode/inner-os-rules.md"]
}

安装后验证

  1. 启动一个新的 OpenCode 会话
  2. AI 应在回复中自然出现 ▎InnerOS：... 独白
  3. 确认 opencode.json 中的路径指向正确的文件

工作原理

Inner OS 通过两个机制工作：

机制 文件 作用
指令文件 .opencode/inner-os-rules.md 注入 Inner OS 协议到系统 prompt
Plugin plugins/inner-os.js 提供 inner-os 工具（状态查询、人设切换）
配置 opencode.json 声明加载哪些指令文件

Plugin 提供的 inner-os 工具支持：

  • status — 查看 Inner OS 状态
  • persona-list — 列出所有可用人设
  • persona-use <name> — 切换人设
  • persona-reset — 恢复自由模式

即使不安装 Plugin，指令文件仍能让 AI 正常输出 ▎InnerOS：... 独白。Plugin 是可选增强。

文件说明

文件 作用
opencode/inner-os-rules.md Inner OS 协议（纯文本，无 YAML frontmatter）
opencode/plugins/inner-os.js OpenCode Plugin（状态查询、人设切换工具）
opencode/opencode.json 配置模板

人设切换（Persona）

切换人设需要完整克隆的仓库（包含 personas/ 和 scripts/ 目录）。

第一步：在仓库中切换

cd /path/to/AI-Inner-Os
node scripts/switch-persona.js sarcastic   # 切换到指定人设
node scripts/switch-persona.js default     # 恢复自由模式
node scripts/switch-persona.js --list      # 列出所有可用人设

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

cp opencode/inner-os-rules.md .opencode/

提示： 每次切换人设后都需要重新复制指令文件。

故障排查

无独白输出

  1. 确认 opencode.json 存在且格式正确：
cat opencode.json
# 应包含 "instructions": [".opencode/inner-os-rules.md"]
  1. 确认指令文件存在：
cat .opencode/inner-os-rules.md
# 应包含 Inner OS 协议内容
  1. 开始一个全新的会话

配置格式

OpenCode 支持 JSON 和 JSONC（带注释的 JSON）格式。确保 opencode.json 语法正确：

# 简单验证（Node.js）
node -e "require('./opencode.json')"

协议更新

当上游更新后：

cp opencode/inner-os-rules.md .opencode/inner-os-rules.md