G-Code/项目资料/笔记/观察日志.md

# 观察日志（自己填）

## 怎么做（阶段 0）

一次只丢 **一个** 任务，等它完全停下来（底部不再转圈、工具面板不再“执行中”）再记笔记，再发下一条。不要五条一起贴。

### 1. 启动

在 **Windows Terminal** 或弹出的 cmd 窗口里（不要用会乱码的旧 CMD 更好）：

```powershell
cd D:\ideaProject\QozeCode-main
$env:PYTHONUTF8 = "1"
.\.venv\Scripts\python.exe qoze_tui.py --model deepseek-v4-flash
```

进界面后，输入框在底部。

### 2. 界面上看什么

| 你看到的              | 对应图里的节点                     |
| ----------------- | --------------------------- |
| 思考区在滚动（thinking）  | `llm_call`：模型在想、可能准备调工具     |
| 工具状态：某个名字闪「执行中」   | `tool_node`：真的在跑工具          |
| 工具变成完成/失败，思考区又开始动 | 回到 `llm_call`：看了观察结果，再决定    |
| 出现一整段助手回复，然后安静    | 没有 `tool_calls` 了，图走到 `END` |

**轮次** = 思考了几次（也就是 `llm_call` 跑了几次）。  
例如：想一次 → 调工具 → 再想一次 → 回答，就是 **2 轮**。

**工具序列** 按出现顺序写名字，例如：`execute_command → read_file → execute_command`。

当前这版 Qoze **没有**挂上 `list_files` / `grep_file` / `write_file` / `replace_in_file`。所以：

- 列 py 文件、grep、改文件，多半会走 `execute_command`（dir / findstr / powershell）
- 读 README 更可能走 `read_file`
- 这不是失败，这就是你要观察的点

### 3. 五条任务（逐条复制，发完等停）

在 Qoze 输入框里，一次贴一条：

1. `当前目录有哪些 py 文件`
2. `读 README 前 80 行并总结`
3. `用 grep 找 init_agent 在哪`
4. `给 tools/date_tools.py 里的 get_current_datetime 函数上方加一行中文注释：# 观察任务：由 Agent 添加`
5. `执行 python --version`

第 4 条故意指定了文件和函数，方便你对照磁盘看它到底怎么改的。跑完用编辑器打开 `tools/date_tools.py` 看有没有那行注释。

不需要的话，第 4 条跑完可以自己把注释删掉。

### 4. 每条停下来立刻记下面模板

看不准轮次就写「至少 N」：思考区亮了几次就算几次。走歪就写：找错目录、用了 cat 而不是 read_file、改了别的文件、命令在 Windows 上写了 `ls` 等。

过关自测（不看文档口述）：

> 用户回车 → llm_call → 有工具就 tool_node → 再 llm_call → 直到不再调工具 → END

## 模板

```text
日期：
任务：
实际工具序列：
轮次：
走歪的地方：
我学到的一点：
```

## 记录

（从阶段 0 开始往下追加）