feat(docs): 添加AI工具相关文章
This commit is contained in:
21
src/ai/README.md
Normal file
21
src/ai/README.md
Normal 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
17
src/ai/chatgpt.md
Normal 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
17
src/ai/iflow.md
Normal 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
17
src/ai/openclaw.md
Normal 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
179
src/ai/opencode-tui.md
Normal 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
218
src/ai/opencode.md
Normal 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
|
||||
```
|
||||
|
||||
如果你把外部工具接到 OpenCode,MCP 是关键路径。
|
||||
|
||||
---
|
||||
|
||||
## 三、一个顺手的工作流(推荐)
|
||||
|
||||
我现在更常用这套顺序:
|
||||
|
||||
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/
|
||||
Reference in New Issue
Block a user