From d70de00176018bcd8137bd820a4ac825ab7b2e52 Mon Sep 17 00:00:00 2001
From: mangmang <362165265@qq.com>
Date: Sun, 8 Mar 2026 00:51:42 +0800
Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=B7=BB=E5=8A=A0AI=E5=B7=A5?=
 =?UTF-8?q?=E5=85=B7=E7=9B=B8=E5=85=B3=E6=96=87=E7=AB=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/ai/README.md       |  21 ++++
 src/ai/chatgpt.md      |  17 ++++
 src/ai/iflow.md        |  17 ++++
 src/ai/openclaw.md     |  17 ++++
 src/ai/opencode-tui.md | 179 +++++++++++++++++++++++++++++++++
 src/ai/opencode.md     | 218 +++++++++++++++++++++++++++++++++++++++++
 6 files changed, 469 insertions(+)
 create mode 100644 src/ai/README.md
 create mode 100644 src/ai/chatgpt.md
 create mode 100644 src/ai/iflow.md
 create mode 100644 src/ai/openclaw.md
 create mode 100644 src/ai/opencode-tui.md
 create mode 100644 src/ai/opencode.md

diff --git a/src/ai/README.md b/src/ai/README.md
new file mode 100644
index 0000000..fd08554
--- /dev/null
+++ b/src/ai/README.md
@@ -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
diff --git a/src/ai/chatgpt.md b/src/ai/chatgpt.md
new file mode 100644
index 0000000..4cc83d0
--- /dev/null
+++ b/src/ai/chatgpt.md
@@ -0,0 +1,17 @@
+---
+title: ChatGPT
+icon: mdi:chat-processing-outline
+date: 2026-03-06
+category:
+  - AI
+tag:
+  - ChatGPT
+---
+
+# ChatGPT
+
+ChatGPT 使用记录与实践。
+
+<!-- more -->
+
+后续补充：提问模板、工作流和常见问题。
diff --git a/src/ai/iflow.md b/src/ai/iflow.md
new file mode 100644
index 0000000..9c8d7f1
--- /dev/null
+++ b/src/ai/iflow.md
@@ -0,0 +1,17 @@
+---
+title: iFlow
+icon: mdi:sitemap-outline
+date: 2026-03-06
+category:
+  - AI
+tag:
+  - iFlow
+---
+
+# iFlow
+
+iFlow 使用记录与实践。
+
+<!-- more -->
+
+后续补充：流程编排、集成方式与落地经验。
diff --git a/src/ai/openclaw.md b/src/ai/openclaw.md
new file mode 100644
index 0000000..7a2cec9
--- /dev/null
+++ b/src/ai/openclaw.md
@@ -0,0 +1,17 @@
+---
+title: OpenClaw
+icon: mdi:robot-outline
+date: 2026-03-06
+category:
+  - AI
+tag:
+  - OpenClaw
+---
+
+# OpenClaw
+
+OpenClaw 使用记录与实践。
+
+<!-- more -->
+
+后续补充：场景、配置和最佳实践。
diff --git a/src/ai/opencode-tui.md b/src/ai/opencode-tui.md
new file mode 100644
index 0000000..1ce111a
--- /dev/null
+++ b/src/ai/opencode-tui.md
@@ -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/
diff --git a/src/ai/opencode.md b/src/ai/opencode.md
new file mode 100644
index 0000000..3896436
--- /dev/null
+++ b/src/ai/opencode.md
@@ -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/