diff --git a/README.md b/README.md
index 23043d2..079e384 100644
--- a/README.md
+++ b/README.md
@@ -131,9 +131,9 @@ Long-running work continues in background agent or shell sessions. Use `list_age
 ## Testing
 
 ```bash
-bun run hx:test              # full regression
-bun run hx:test:unit         # unit tests
-bun run hx:test:integration  # integration tests
+npm run hx:test              # full regression
+npm run hx:test:unit         # unit tests
+npm run hx:test:integration  # integration tests
 ```
 
 ---
diff --git a/README.zh.md b/README.zh.md
index de7986c..79285f9 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -114,6 +114,12 @@ runtime:
 
 ---
 
+## Agent 会话
+
+长任务会在后台 agent 或 shell 会话中持续执行。用 `list_agents` 和 `read_agent` 查看 agent 输出，仅在 idle 且明确等待输入时使用 `write_agent`。shell 会话使用 `list_bash`、`read_bash`、`write_bash`；不要混用两类接口。
+
+---
+
 ## 环境要求
 
 - Bun >= 1.0.0；未安装 Bun 时可通过 `npx tsx` 执行脚本
@@ -123,9 +129,9 @@ runtime:
 ## 测试
 
 ```bash
-bun run hx:test              # 全量回归
-bun run hx:test:unit         # 单元测试
-bun run hx:test:integration  # 集成测试
+npm run hx:test              # 全量回归
+npm run hx:test:unit         # 单元测试
+npm run hx:test:integration  # 集成测试
 ```
 
 ---