docs: prefer plugin marketplace installation paths

Author: SummerSec

CHANGELOG.md

@@ -18,7 +18,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **OpenClaw**: Align the plugin entrypoint with `definePluginEntry`, add OpenClaw package metadata, and expose a `frequency` config option.
 - **OpenCode**: Use the official `@opencode-ai/plugin` `tool()` helper and prefer globally installed Inner OS protocol/persona files when available.
-- **Documentation**: Refresh OpenClaw, OpenCode, Hermes, and global installation docs for plugin packaging and frequency configuration.
+- **Documentation**: Refresh installation docs to present platform plugin/marketplace/package installation as the official user path, with script/manual copies limited to development and troubleshooting.
 
 ## [0.7.2] - 2026-05-10
 

README.md

@@ -89,18 +89,15 @@ Run `/reload-plugins` after installation to activate in the current session —
 ```bash
 # Codex plugin metadata is included at .codex-plugin/plugin.json
 # Repo marketplace metadata is included at .agents/plugins/marketplace.json
-
-# Fallback global install for Codex versions without plugin CLI support
-node scripts/install.js --platform codex
 ```
 
 See [codex/README.md](codex/README.md) | [Detailed installation guide](docs/install-codex.md).
 
 ### Cursor
 
 ```bash
-# Install Cursor adapter globally
-node scripts/install.js --platform cursor
+# Install through Cursor plugin / marketplace
+# Plugin metadata is included at .cursor-plugin/plugin.json
 ```
 
 The repository also includes `.cursor-plugin/plugin.json`, which packages `cursor/` as a Cursor plugin component directory.
@@ -110,37 +107,26 @@ See [cursor/README.md](cursor/README.md) | [Detailed installation guide](docs/in
 ### OpenCode CLI
 
 ```bash
-# Copy instruction file
-mkdir -p .opencode
-cp opencode/inner-os-rules.md .opencode/
-
-# Add instructions to opencode.json
-cp opencode/opencode.json ./opencode.json
+# Install through OpenCode plugin package
+# Add the published package to opencode.json: "plugin": ["ai-inner-os"]
 ```
 
 See [opencode/README.md](opencode/README.md) | [Detailed installation guide](docs/install-opencode.md).
 
 ### Hermes Agent
 
 ```bash
-# Option 1: Install as Skill (recommended, enables /inner-os command)
-cp -r hermes/skills/inner-os ~/.hermes/skills/personality/inner-os
-
-# Option 2: Project-level Context File
-cp hermes/hermes.md ./.hermes.md
+# Install through Hermes plugin
+hermes plugins enable inner-os
 ```
 
 See [hermes/README.md](hermes/README.md) | [Detailed installation guide](docs/install-hermes.md).
 
 ### OpenClaw
 
 ```bash
-# Option 1: Install as Workspace Skill (recommended, enables /inner-os command)
-mkdir -p skills
-cp -r openclaw/skills/inner-os skills/inner-os
-
-# Option 2: Global Skill
-cp -r openclaw/skills/inner-os ~/.openclaw/skills/inner-os
+# Install through OpenClaw plugin / ClawHub
+openclaw plugins install clawhub:ai-inner-os
 ```
 
 See [openclaw/README.md](openclaw/README.md) | [Detailed installation guide](docs/install-openclaw.md).

README_CN.md

@@ -89,18 +89,15 @@ Inner OS 状态：已启用
 ```bash
 # Codex 插件元数据位于 .codex-plugin/plugin.json
 # 仓库级 marketplace 位于 .agents/plugins/marketplace.json
-
-# 若当前 Codex 版本没有 plugin CLI，可使用全局安装脚本
-node scripts/install.js --platform codex
 ```
 
 详见 [codex/README.md](codex/README.md) | [详细安装指南](docs/install-codex.md)。
 
 ### Cursor
 
 ```bash
-# 全局安装 Cursor 适配
-node scripts/install.js --platform cursor
+# 通过 Cursor plugin / marketplace 安装
+# 插件元数据位于 .cursor-plugin/plugin.json
 ```
 
 仓库也包含 `.cursor-plugin/plugin.json`，会将 `cursor/` 目录作为 Cursor 插件组件目录声明。
@@ -110,37 +107,26 @@ node scripts/install.js --platform cursor
 ### OpenCode CLI
 
 ```bash
-# 复制指令文件
-mkdir -p .opencode
-cp opencode/inner-os-rules.md .opencode/
-
-# 在 opencode.json 中添加 instructions
-cp opencode/opencode.json ./opencode.json
+# 通过 OpenCode plugin package 安装
+# 在 opencode.json 中声明已发布插件包："plugin": ["ai-inner-os"]
 ```
 
 详见 [opencode/README.md](opencode/README.md) | [详细安装指南](docs/install-opencode.md)。
 
 ### Hermes Agent
 
 ```bash
-# 方式一：安装为 Skill（推荐，获得 /inner-os 命令）
-cp -r hermes/skills/inner-os ~/.hermes/skills/personality/inner-os
-
-# 方式二：项目级 Context File
-cp hermes/hermes.md ./.hermes.md
+# 通过 Hermes plugin 安装
+hermes plugins enable inner-os
 ```
 
 详见 [hermes/README.md](hermes/README.md) | [详细安装指南](docs/install-hermes.md)。
 
 ### OpenClaw
 
 ```bash
-# 方式一：安装为 Workspace Skill（推荐，获得 /inner-os 命令）
-mkdir -p skills
-cp -r openclaw/skills/inner-os skills/inner-os
-
-# 方式二：全局 Skill
-cp -r openclaw/skills/inner-os ~/.openclaw/skills/inner-os
+# 通过 OpenClaw plugin / ClawHub 安装
+openclaw plugins install clawhub:ai-inner-os
 ```
 
 详见 [openclaw/README.md](openclaw/README.md) | [详细安装指南](docs/install-openclaw.md)。

codex/README.md

@@ -4,7 +4,7 @@
 
 ## 安装
 
-### 方式一：Codex 插件清单
+正式用户只通过 Codex plugin / marketplace 安装。手动适配、全局脚本、手动复制 `AGENTS.md` 或 `hooks.json` 仅用于本仓库开发调试。
 
 仓库根目录包含正式 Codex 插件清单：
 
@@ -28,43 +28,6 @@
 
 Codex 可从该 marketplace 发现 `ai-inner-os`，并从当前仓库根目录加载插件组件。
 
-### 方式二：手动适配
-
-#### 1. 复制 AGENTS.md
-
-将 Inner OS 协议注入到你的全局或项目级指令中：
-
-```bash
-# 全局生效（所有项目）
-cat codex/AGENTS.md >> ~/.codex/AGENTS.md
-
-# 或项目级生效
-cat codex/AGENTS.md >> ./AGENTS.md
-```
-
-#### 2. 配置 hooks
-
-将 `codex/hooks.json` 的内容合并到你的 Codex hooks 配置中：
-
-```bash
-# 全局
-cp codex/hooks.json ~/.codex/hooks.json
-
-# 或项目级
-cp codex/hooks.json .codex/hooks.json
-```
-
-> 注意：插件安装时从插件根目录解析 `./codex/hooks/*.js`；手动复制到 `~/.codex/hooks.json` 时，建议改成绝对路径，或使用 `node scripts/install.js --platform codex` 自动生成。
-
-#### 3. 确认 hooks 功能已启用
-
-在 `~/.codex/config.toml` 或项目级 `.codex/config.toml` 中确认：
-
-```toml
-[features]
-codex_hooks = true
-```
-
 ## Hook 生命周期
 
 | Hook | 触发时机 | 作用 |
@@ -75,16 +38,7 @@ codex_hooks = true
 
 ## Persona（人设切换）
 
-Codex CLI 支持读取 Inner OS 人设配置。手动编辑 `personas/_active.json` 来切换：
-
-```json
-{
-  "persona": "tsundere",
-  "updatedAt": "2026-04-13T10:00:00.000Z"
-}
-```
-
-可选值：`default`、`tsundere`、`cold`、`cheerful`、`philosopher`、`sarcastic`，或 `personas/custom/` 下自定义文件名。
+正式安装场景下，人设与频率应由插件配置或插件命令管理。仓库内 `scripts/switch-persona.js` 只用于维护静态适配副本。
 
 ## 与 Claude Code 版本的差异
 
@@ -93,4 +47,4 @@ Codex CLI 支持读取 Inner OS 人设配置。手动编辑 `personas/_active.js
 | 协议注入 | SessionStart hook 自动读取 SKILL.md | AGENTS.md 静态加载 |
 | 失败追踪 | PostToolUseFailure 独立 hook | 无（Codex 暂不支持） |
 | Hook 数量 | 9 个 | 3 个 |
-| 安装方式 | 插件市场一键安装 | Codex 插件清单 / 全局安装脚本 / 手动复制配置 |
+| 安装方式 | 插件市场一键安装 | Codex plugin / marketplace |

cursor/README.md

@@ -16,7 +16,7 @@
 
 ## 安装
 
-### 方式一：Cursor 插件清单
+正式用户只通过 Cursor plugin / marketplace 安装。全局脚本和手动复制 `.mdc` / `hooks.json` 仅用于本仓库开发调试，不作为正式安装或更新路径。
 
 仓库根目录包含 `.cursor-plugin/plugin.json`，清单直接引用 `cursor/` 下的规则和 hooks：
 
@@ -27,26 +27,7 @@
 }
 ```
 
-用于 Cursor 插件分发或本地插件加载时，不需要再把 `cursor/` 拆成单独目录。
-
-### 方式二：全局安装脚本
-
-如果只想在当前机器全局启用：
-
-```bash
-node scripts/install.js --platform cursor
-```
-
-脚本会把运行时文件复制到 `~/.inner-os/`，并将 hooks 合并写入 `~/.cursor/hooks.json`，不会覆盖已有 hook 配置。
-
-### 方式三：仅使用项目规则
-
-如果只需要静态协议注入，可以把规则复制到目标项目：
-
-```bash
-mkdir -p .cursor/rules
-cp cursor/rules/inner-os-protocol.mdc .cursor/rules/
-```
+用于 Cursor 插件分发或本地插件加载时，不需要再把 `cursor/` 拆成单独目录。发布更新时 bump `.cursor-plugin/plugin.json` 和 `.cursor-plugin/marketplace.json` 的版本号。
 
 ## 工作原理
 
@@ -59,15 +40,7 @@ Cursor 的 `preToolUse` 不支持注入 `additional_context`，所以没有使
 
 ## Persona（人设切换）
 
-通过全局安装脚本启用 hooks 后，Cursor 会在 `sessionStart` 读取 `~/.inner-os/personas/_active.json` 和对应人设文件。切换方式：
-
-```bash
-node ~/.inner-os/scripts/switch-persona.js --list
-node ~/.inner-os/scripts/switch-persona.js sarcastic
-node ~/.inner-os/scripts/switch-persona.js default
-```
-
-如果只复制 `.mdc` 规则而不启用 hooks，则需要把 `personas/<name>.md` 的正文手动追加到 `cursor/rules/inner-os-protocol.mdc` 的 persona 标记区。
+正式安装场景下，人设与频率应由插件配置或插件命令管理。仓库内 `scripts/switch-persona.js` 只用于维护静态适配副本。
 
 ## 与其他平台的差异
 
@@ -76,4 +49,4 @@ node ~/.inner-os/scripts/switch-persona.js default
 | 协议注入 | SessionStart hook 读取 SKILL.md | SessionStart hook / AGENTS.md | `.mdc` 规则 + `sessionStart` hook |
 | Hook 数量 | 9 个 | 3 个 | 3 个 |
 | 失败追踪 | PostToolUseFailure | 不支持 | 不支持 |
-| 安装方式 | 插件市场一键安装 | `install.js` 全局安装 | Cursor 插件清单 / `install.js` 全局安装 |
+| 安装方式 | 插件市场一键安装 | Codex plugin / marketplace | Cursor plugin / marketplace |