feat(docs): 添加AI工具相关文章

This commit is contained in:
2026-03-08 00:51:42 +08:00
parent 8cf81f6055
commit d70de00176
6 changed files with 469 additions and 0 deletions

21
src/ai/README.md Normal file
View File

@@ -0,0 +1,21 @@
---
title: AI 工具导航
icon: mdi:robot-outline
date: 2026-03-06
category:
- AI
tag:
- AI
- 工具
---
# AI 工具导航
这里整理常用的 AI 工具记录。
<!-- more -->
- OpenCode
- ChatGPT
- OpenClaw
- iFlow

17
src/ai/chatgpt.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: ChatGPT
icon: mdi:chat-processing-outline
date: 2026-03-06
category:
- AI
tag:
- ChatGPT
---
# ChatGPT
ChatGPT 使用记录与实践。
<!-- more -->
后续补充:提问模板、工作流和常见问题。

17
src/ai/iflow.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: iFlow
icon: mdi:sitemap-outline
date: 2026-03-06
category:
- AI
tag:
- iFlow
---
# iFlow
iFlow 使用记录与实践。
<!-- more -->
后续补充:流程编排、集成方式与落地经验。

17
src/ai/openclaw.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: OpenClaw
icon: mdi:robot-outline
date: 2026-03-06
category:
- AI
tag:
- OpenClaw
---
# OpenClaw
OpenClaw 使用记录与实践。
<!-- more -->
后续补充:场景、配置和最佳实践。

179
src/ai/opencode-tui.md Normal file
View File

@@ -0,0 +1,179 @@
---
title: OpenCode TUI 实战指南
icon: mdi:monitor-dashboard
date: 2026-03-06
category:
- AI
- 开发工具
tag:
- OpenCode
- TUI
- AI编程
---
# OpenCode TUI 实战指南
这篇文章基于 OpenCode 官方文档的 TUI 章节,聚焦终端交互界面的
高频用法:怎么聊、怎么调、怎么把会话真正用起来。
<!-- more -->
---
## 一、先启动 TUI
直接在当前目录启动:
```bash
opencode
```
或者指定项目目录启动:
```bash
opencode /path/to/project
```
进入后就能直接提问,例如:
```text
先给我快速总结一下这个仓库结构和技术栈。
```
---
## 二、两个最实用的输入能力
### 2.1 `@` 文件引用
在消息里用 `@` 引用文件OpenCode 会做模糊匹配并把文件内容带入上下文。
```text
@src/.vuepress/config.ts 这个配置里有哪些容易踩坑的点?
```
适合代码审查、定位问题、讲解现有实现。
### 2.2 `!` Bash 命令
输入 `!` 开头的内容,会按 shell 命令执行并把输出注入会话。
```text
!git status
!npm run docs:build
```
这个能力非常适合“边看代码边验证”。
---
## 三、必须掌握的斜杠命令
### 3.1 会话与整理
```text
/new
/sessions
/compact
```
- `/new`:开新会话(清空当前上下文)。
- `/sessions`:快速切换历史会话。
- `/compact`:压缩上下文,长对话时很有用。
### 3.2 可视化与排障
```text
/details
/thinking
/models
```
- `/details`:显示或隐藏工具执行细节。
- `/thinking`:切换推理块显示(仅控制展示)。
- `/models`:查看可用模型并确认当前选择。
### 3.3 输出与分享
```text
/export
/share
/unshare
```
- `/export`:导出当前对话为 Markdown。
- `/share`:分享当前会话。
- `/unshare`:取消分享。
---
## 四、`undo` / `redo` 的正确理解
```text
/undo
/redo
```
这两个命令不仅会撤销或重做消息,也会回滚或恢复文件变更。
注意:它依赖 Git 管理改动,所以项目目录最好是一个 Git 仓库。
---
## 五、编辑器联动(很建议配)
`/editor``/export` 都依赖 `EDITOR` 环境变量。
Linux / macOS 示例:
```bash
export EDITOR="code --wait"
```
如果你使用 `vim` / `nvim` / `nano` 也可以直接设置对应命令。
推荐使用带 `--wait` 的 GUI 编辑器,这样 TUI 会等待你编辑完成再返回。
---
## 六、TUI 配置项(滚动最常用)
可以在配置文件中设置:
```json
{
"$schema": "https://opencode.ai/config.json",
"tui": {
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
}
}
}
```
- `scroll_speed`:滚动速度(最小 `1`)。
- `scroll_acceleration.enabled`:类 macOS 滚动加速。
当加速开启时,会覆盖 `scroll_speed` 的效果。
---
## 七、一套我常用的 TUI 习惯
1. 先用 `@` 精准挂载关键文件,再提任务。
2. 单次只做一类改动,必要时 `/compact`
3. 关键节点 `/export`,形成可复盘记录。
4. 大改前先确认 Git 状态,便于 `/undo` 使用。
5. 需要自动化时再切到 `opencode run`
---
## 八、结语
TUI 的核心不是“会聊天”,而是把上下文、命令执行和文件改动放在同一条工作流里。
如果你平时就在终端里开发OpenCode TUI 会比网页对话更顺手。
> 参考文档:
> https://opencode.ai/docs/zh-cn/tui/

218
src/ai/opencode.md Normal file
View File

@@ -0,0 +1,218 @@
---
title: OpenCode
icon: mdi:application-braces-outline
date: 2026-03-06
category:
- AI
- 开发工具
tag:
- OpenCode
- CLI
- AI编程
---
# OpenCode
这篇文章基于 OpenCode 官方文档的 CLI 章节,整理出一套更偏实战的
使用方式:先跑起来,再把它接入日常开发流程。
<!-- more -->
---
## 一、先有一个可用的 OpenCode CLI
OpenCode 在不带参数运行时会进入 TUI终端交互界面
```bash
opencode
```
如果你只想快速问一个问题,不进 TUI直接用 `run`
```bash
opencode run "解释一下 Go 的 context 使用场景"
```
这两个入口就够你先开始:
- `opencode`:适合持续交互、改代码、看上下文。
- `opencode run ...`:适合脚本、自动化、一次性问答。
---
## 二、我最常用的 CLI 命令
### 2.1 会话与续接
```bash
# 继续上一次会话
opencode -c
# 指定会话 ID 继续
opencode -s <session-id>
# 在继续时分叉一个新分支会话
opencode -c --fork
```
当你在做“同一任务的不同方案”时,`--fork` 非常好用。
### 2.2 非交互执行(脚本友好)
```bash
# 一次性执行
opencode run "为当前仓库生成提交说明"
# 继续历史会话执行
opencode run -c "继续刚才的重构任务"
# 指定模型
opencode run -m anthropic/claude-sonnet-4 "审查这次变更"
# 附件文件
opencode run -f README.md "总结这份文档"
```
### 2.3 模型与认证
```bash
# 登录模型提供商(会写入本地凭据文件)
opencode auth login
# 查看已登录提供商
opencode auth ls
# 查看可用模型
opencode models
# 刷新模型缓存
opencode models --refresh
```
### 2.4 MCP 相关
```bash
# 添加 MCP 服务
opencode mcp add
# 查看 MCP 列表和状态
opencode mcp ls
# OAuth 认证
opencode mcp auth
```
如果你把外部工具接到 OpenCodeMCP 是关键路径。
---
## 三、一个顺手的工作流(推荐)
我现在更常用这套顺序:
1. `opencode` 进入 TUI先理解项目结构。
2. 用自然语言给任务边界(目标、限制、验收)。
3. 小步执行:每次只改一类问题。
4. 关键节点用 `session list` 记录上下文。
5. 需要批处理时切到 `opencode run`
相关命令:
```bash
# 查看会话
opencode session list
# 导出会话(便于复盘)
opencode export <session-id>
# 从 JSON 或分享链接导入
opencode import <file-or-url>
```
---
## 四、服务化与远程连接
当你希望“一个后端 + 多端连接”时:
```bash
# 启动无界面服务
opencode serve
# 启动 web 版本
opencode web --port 4096 --hostname 0.0.0.0
# 其他终端附着到服务
opencode attach http://127.0.0.1:4096
```
这样可以减少重复冷启动,尤其是 MCP 场景更明显。
---
## 五、几个高频实用命令
```bash
# 统计 token 和费用
opencode stats --days 7 --models 5
# 查看全局帮助
opencode -h
# 查看版本
opencode -v
# 升级
opencode upgrade
```
卸载前建议先 dry run
```bash
opencode uninstall --dry-run
```
---
## 六、环境变量里最值得记住的几个
```bash
# 为 serve / web 打开基础认证
export OPENCODE_SERVER_PASSWORD="your-password"
# 指定配置目录
export OPENCODE_CONFIG_DIR="$HOME/.config/opencode"
# 关闭自动更新检查
export OPENCODE_DISABLE_AUTOUPDATE=true
# 启用实验特性总开关
export OPENCODE_EXPERIMENTAL=true
```
建议:实验变量只在测试环境开,不要直接进生产脚本。
---
## 七、踩坑提醒
1. `run` 很方便,但复杂任务建议先进 TUI 再拆步骤。
2. 多提供商混用时,模型名要写 `provider/model` 全名。
3. `serve` / `web` 对外开放时,优先配 `OPENCODE_SERVER_PASSWORD`
4. MCP 连接异常先看 `opencode mcp ls``opencode mcp debug <name>`
---
## 八、结语
如果你是第一次用 OpenCode先记住三条就够了
- `opencode`:主入口(交互式)。
- `opencode run`:自动化入口(非交互)。
- `opencode auth login` + `opencode models`:先把模型链路打通。
后面再逐步接入 MCP、会话导入导出、以及 `serve/web` 的多端协作。
> 参考文档:
> https://opencode.ai/docs/zh-cn/cli/