【AI开发】二、AI工具安装与配置（opencode）

打开Linux子系统

使用Win+R键，输入cmd或者wt(如果你安装了这个终端的话)。

就可以看到下面界面：

ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$

安装nvm程序

我们先来安装nvm，方便后续安装nodejs。

# 使用国内源进行安装
bash -c "$(curl -fsSL https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh)"

执行完成之后，会出现下面提示：

Turn off this advice by setting config variable advice.detachedHead to false
HEAD is now at 62387b8 v0.40.4
=> 添加nvm环境变量，使用淘宝镜像(Bash)
=> 安装nvm-update，升级更新请使用该命令
[sudo: authenticate] Password:
=> 安装完成! 请重启终端生效
=> 推荐您使用 https://gitee.com/RubyMetric/chsrc 全平台多语言/OS/软件自动换源
=> chsrc set npm
ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$

这时候就可以执行：

# 激活环境变量
source ~/.bashrc

验证nvm是否安装成功：

ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$ nvm --version
0.40.4
ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$

如果成功输出版本号，说明安装成功。

(备用) 安装镜像切换

chsrc 可换源 65+ 目标，所以我要用这个方法来切换nvm或者其它的源。

# x64
$ curl -LO https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc_latest-1_amd64.deb

# 也可以使用 Wget
wget https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc_latest-1_amd64.deb

$ sudo apt install ./chsrc_latest-1_amd64.deb
# 或
$ sudo sudo dpkg -i chsrc_latest-1_amd64.deb

使用chsrc切换nvm的源。

chsrc set nvm

可以看到换源过程和测速，非常丝滑。

ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$ chsrc set nvm
[chsrc 测速] 测速中

  ^ 上游默认源 (https://nodejs.org/dist/) [精准测速] ... 221.96 KByte/s
  - npmmirror (阿里云赞助) [精准测速] ... 679.00 Byte/s | HTTP码 404
  - 清华大学开源软件镜像站 [精准测速] ... 1.08 MByte/s
  - 北京外国语大学开源软件镜像站 [精准测速] ... 5.61 MByte/s
  - 中国科学技术大学开源软件镜像 [精准测速] ... 17.73 MByte/s
  - 华为开源镜像站 [精准测速] ... 5.26 MByte/s
  - 腾讯软件源(公网) [精准测速] ... 3.25 MByte/s

最快镜像站: 中国科学技术大学开源软件镜像
选中镜像站: USTC (ustc)
--------------------------------
[chsrc 写入] ~/.bashrc
--------------------------------
全自动换源完成, 感谢镜像提供方: 中国科学技术大学开源软件镜像
食源检查: 2025-06-19  食谱更新: 2025-06-19  后厨人数: 1  (详查 chsrc ls nvm)
ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$

使用nvm安装nodejs

# 建议nodejs 20以上，因为现在的ai工具都需要20以上的了。
nvm install 24

使用npm安装opencode

# 给npm换源
chsrc set npm


# 直接安装opencode
npm i -g opencode-ai

完美安装

ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$ chsrc set npm
[chsrc 测速] 测速中

  ^ 上游默认源 (https://registry.npmjs.org/) [精准测速] ... 1.41 MByte/s
  - npmmirror (阿里云赞助) [精准测速] ... 8.50 MByte/s
  - 华为开源镜像站 [精准测速] ... 5.64 MByte/s
  - 腾讯软件源(公网) [精准测速] ... 12.05 MByte/s

最快镜像站: 腾讯软件源(公网)
选中镜像站: Tencent Public (tencent)
--------------------------------
[chsrc 运行] npm config set registry https://mirrors.cloud.tencent.com/npm/
[chsrc 运行] ✓ 命令执行成功
--------------------------------
全自动换源完成, 感谢镜像提供方: 腾讯软件源(公网)
食源检查: 2025-07-11  食谱更新: 2025-07-11  后厨人数: 2  (详查 chsrc ls npm)
ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$ npm i -g opencode-ai

added 5 packages in 12s
ubuntu@DESKTOP-OCEQVCJ:/mnt/c/Users/win3090$

配置opencode的模型

opencode auth login

配置一个Skill记忆

为了可以让AI有记忆和对话可归档，我们需要额外安装一个Skill。

Smart-Codebase 通过 SKILL 文件为你的 AI 提供永久记忆。它利用 AI Agent 自主从你的对话和项目文件中提取并沉淀知识。

⚙️ 工作原理

1. 你正常工作 - 编辑文件、调试问题、做架构决策。
2. 首次初始化 - 运行一次 /sc-init，扫描源代码并生成完整的 SKILL 文件。
3. 持续更新 - 达到里程碑时，运行 /sc-update 从当前会话中提取知识。
4. AI Agent 分析 - 子 AI 会话会分析你的对话记录或项目代码，理解发生了什么变化以及为什么。
5. 知识沉淀 - Agent 会自主编写或更新符合 OpenCode 标准格式的 SKILL 文件。
6. 下次会话开始 - 新会话会自动发现项目 SKILLs，让 AI 立即获得项目上下文。

手动控制意味着你决定何时保存知识，而 AI Agent 则承担了编写文档的繁重工作。

📦 安装Skill

# 需要安装jq字符串处理工具
sudo apt install -y jq

# 进入 `~/.config/opencode` 目录
cd ~/.config/opencode

# 命令二选一
# 使用 bun
bun add smart-codebase
# 或使用 npm
npm install smart-codebase

写入配置文件：

[ -f opencode.json ] && jq '.plugin = ["smart-codebase"]' opencode.json > tmp.json && mv tmp.json opencode.json || echo '{"plugin":["smart-codebase"]}' > opencode.json

效果如下：

ubuntu@DESKTOP-OCEQVCJ:~/.config/opencode$ [ -f opencode.json ] && jq '.plugin = ["smart-codebase"]' opencode.json > tmp.json && mv tmp.json opencode.json || echo '{"plugin":["smart-codebase"]}' > opencode.json

ubuntu@DESKTOP-OCEQVCJ:~/.config/opencode$ ls
node_modules  opencode.json  opencode.jsonc  package-lock.json  package.json

ubuntu@DESKTOP-OCEQVCJ:~/.config/opencode$ cat opencode.json
{"plugin":["smart-codebase"]}

ubuntu@DESKTOP-OCEQVCJ:~/.config/opencode$

我们在命令行输入opencode，确认一下是否安装完成skill。

配置模型理解
请自己查看下命令，看看有没有问题，不要无脑复制！！！这个命令是配置的是deepseek模型。

mkdir -p ~/.config/opencode && [ -f ~/.config/opencode/smart-codebase.json ] && jq '.enabled = true | .extractionModel = "deepseek/deepseek-v4-flash" | .extractionMaxTokens = 180000' ~/.config/opencode/smart-codebase.json > tmp.json && mv tmp.json ~/.config/opencode/smart-codebase.json || echo '{"enabled":true,"extractionModel":"deepseek/deepseek-v4-flash","extractionMaxTokens":180000}' > ~/.config/opencode/smart-codebase.json

效果图如下：

可以看到已经能执行/sc-init和/sc-update这两个技能。