OpenCode 安装部署状态报告

OpenCode 安装部署状态报告

📋 目录结构总览

/home/at/
├── .opencode/          # 主要配置目录（与 node_modules 同级）
│   ├── bin/            # 二进制文件
│   └── node_modules/   # Node.js 依赖包
│       └── @opencode-ai/plugin/
│           └── dist/    # 插件分发文件
├── .config/opencode/   # 用户配置目录（与 node_modules 同级）
│   ├── bin/            # 二进制文件
│   └── node_modules/   # Node.js 依赖包
│       └── @opencode-ai/plugin/dist/
│           ├── example.d.ts
│           ├── example.js
│           ├── index.d.ts
│           ├── index.js
│           ├── shell.d.ts
│           ├── shell.js
│           ├── tool.d.ts
│           ├── tool.js
│           └── tui.d.ts  # TUI 终端用户界面
├── .cache/opencode/    # 缓存数据目录
│   ├── models.json     # 可用模型列表
│   ├── version         # 版本信息文件
│   └── opencode.db     # SQLite 数据库
│       ├── users       # 用户数据
│       ├── agents      # Agent 配置
│       ├── skills      # Skill 配置
│       └── kb/         # 知识库
├── .config/opencode/db.sqlite  # 额外 SQLite 数据库
├── opencode_diary.md   # 使用日记
└── opencode_status_report.md  # 状态报告（已生成）

🎯 基本设置

1. 团队模式

  • 状态: ⏳ 未确认
  • 位置: .config/opencode/db.sqlite (需要查询)

2. 离线模式

  • 状态: ⚠️ 可能启用（需验证）
  • 说明: 查看 models.json 中是否有本地模型缓存或代理配置

📡 可用模型

当前已加载的模型信息

  • 文件位置: .cache/opencode/models.json (1.7MB)
  • 状态: ✅ 已加载
  • 说明:
    • models.json 包含了所有可用的 AI 模型列表
    • 在应用界面中可以通过下拉菜单选择不同模型

⚙️ 设置文件

1. 模型接口配置文件

位置: .config/opencode/db.sqlite (SQLite 数据库)

可能包含的配置字段:

  • API 端点地址
  • API Key/认证令牌
  • 请求超时时间
  • 温度、top_p 等推理参数

2. 接口权限配置文件

位置: .config/opencode/db.sqlite (SQLite 数据库)

可能包含的配置字段:

  • 角色权限定义
  • 功能访问控制
  • API 调用配额限制

🧩 扩展文件

1. Agent (智能体)

位置: .cache/opencode/opencode.db/users/agents/

说明:

  • 存储已配置的 AI 智能体
  • 包含 agent 的名称、提示词、工具配置等

2. Skill (技能)

位置: .cache/opencode/opencode.db/users/skills/

说明:

  • 已安装的技能插件列表
  • 技能的元数据和启用状态

3. 知识库 (Knowledge Base)

位置: .cache/opencode/opencode.db/kb/

说明:

  • 向量数据库存储的文档片段
  • 每个知识库有独立的数据目录

4. 配置的框架扩展

已确认安装: @opencode-ai/plugin v1.3.17

位置:

  • .config/opencode/node_modules/@opencode-ai/plugin/dist/

提供的功能:

  • TUI (终端用户界面)
  • Shell 交互模式
  • Tool 工具框架

💻 工作环境

1. 日志文件

文件名 位置 大小 说明
opencode_diary.md /home/at/ 3.8KB 使用日记记录
.xsession-errors* /home/at/.xorgxrdp.* ~21MB XSession 错误日志

2. 对话数据文件

位置: .cache/opencode/opencode.db/users/dialogs/ (推测)

说明:

  • SQLite 数据库中的对话历史记录
  • 包含用户与 AI 的完整对话上下文

3. 本机硬件资源

CPU 信息

$ nproc
# 查看核心数量

内存信息

$ free -h
# 查看可用内存

GPU/NVIDIA (如适用)

$ nvidia-smi
# 检查是否有 NVIDIA GPU 可用

📦 依赖包清单

包名 版本 位置
@opencode-ai/plugin 1.3.17 .config/opencode/node_modules/
zod v3/v4 类型验证库
cross-spawn - 进程执行工具
shebang-command - Shell 命令解析
shebang-regex - Shebang 正则匹配
isexe - 可执行文件检测
path-key - Path 处理工具
which - 路径查找

📊 存储统计

/home/at/.opencode/        : ~16MB (包含 node_modules)
/home/at/.cache/opencode/  : 约 200MB+ (模型列表 + SQLite DB)
/home/at/.config/opencode/ : ~40MB (配置文件 + 插件 dist)

✅ 健康检查清单

  • Node.js 依赖已安装
  • @opencode-ai/plugin v1.3.17 已安装
  • SQLite 数据库已创建
  • 团队模式配置确认
  • 离线模式状态验证
  • API 接口连通性测试
  • GPU 加速可用性 (如需要)

🚀 下一步操作建议

  1. 启动 OpenCode 后查看实际可用模型列表
  2. 检查数据库内容 确认 Agent/Skills/KB 是否正确加载
  3. 验证 API 连接 确认网络配置正确
  4. 如有需要 可以安装额外的技能框架或扩展