From 2883402b9655259db6de36404c4c6f1f0706a230 Mon Sep 17 00:00:00 2001
From: fish <fish@fish.com>
Date: Fri, 24 Jul 2026 12:52:47 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E7=8E=AF=E5=A2=83=E6=90=AD?=
 =?UTF-8?q?=E5=BB=BA=E8=AF=B4=E6=98=8E=EF=BC=8C=E5=88=9B=E5=BB=BA=20financ?=
 =?UTF-8?q?e-talk=20=E5=AE=B9=E5=99=A8=E5=B9=B6=E5=AE=89=E8=A3=85=20tushar?=
 =?UTF-8?q?e/akshare?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 CLAUDE.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 108 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index f8f2cc7..0ac3475 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,60 @@ AI 协助分析交易数据和回测的仓库。主要用来做策略回测、
 - 无可用镜像时才允许拉取，默认拉取 `python:3.11-slim`
 - 示例: `docker images | grep python` 查看已有镜像，再用已有镜像执行
 
+## 环境搭建（首次使用）
+
+### 1. 创建容器
+
+检查是否已有 `finance-talk` 容器（名称固定，在终端中运行）：
+
+```bash
+docker ps -a --filter "name=finance-talk" --format "{{.Names}}"
+```
+
+若无输出，则按以下步骤创建：
+
+```bash
+# 查看已有 Python 镜像，优先复用
+docker images | grep python
+
+# 无可用镜像时才拉取（默认 python:3.11-slim）
+docker pull python:3.11-slim
+
+# 创建并启动容器（映射当前目录到 /workspace）
+docker run -d \
+  --name finance-talk \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  python:3.13.11-slim \
+  sleep infinity
+```
+
+### 2. 安装依赖包
+
+```bash
+docker exec finance-talk pip install tushare akshare
+```
+
+### 3. 验证
+
+```bash
+docker exec finance-talk python -c "import tushare; import akshare; print('OK')"
+```
+
+### 4. 日常使用
+
+Python 脚本通过 `docker exec` 在容器中执行：
+
+```bash
+docker exec finance-talk python your_script.py
+```
+
+若容器已存在但未运行，先启动：
+
+```bash
+docker start finance-talk
+```
+
 ## Data Sources
 
 按优先级排序：
diff --git a/CLAUDE.md b/CLAUDE.md
index 7e425c2..0dc1298 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,6 +14,60 @@ AI 协助分析交易数据和回测的仓库。主要用来做策略回测、
 - 无可用镜像时才允许拉取，默认拉取 `python:3.11-slim`
 - 示例: `docker images | grep python` 查看已有镜像，再用已有镜像执行
 
+## 环境搭建（首次使用）
+
+### 1. 创建容器
+
+检查是否已有 `finance-talk` 容器（名称固定，在终端中运行）：
+
+```bash
+docker ps -a --filter "name=finance-talk" --format "{{.Names}}"
+```
+
+若无输出，则按以下步骤创建：
+
+```bash
+# 查看已有 Python 镜像，优先复用
+docker images | grep python
+
+# 无可用镜像时才拉取（默认 python:3.11-slim）
+docker pull python:3.11-slim
+
+# 创建并启动容器（映射当前目录到 /workspace）
+docker run -d \
+  --name finance-talk \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  python:3.13.11-slim \
+  sleep infinity
+```
+
+### 2. 安装依赖包
+
+```bash
+docker exec finance-talk pip install tushare akshare
+```
+
+### 3. 验证
+
+```bash
+docker exec finance-talk python -c "import tushare; import akshare; print('OK')"
+```
+
+### 4. 日常使用
+
+Python 脚本通过 `docker exec` 在容器中执行：
+
+```bash
+docker exec finance-talk python your_script.py
+```
+
+若容器已存在但未运行，先启动：
+
+```bash
+docker start finance-talk
+```
+
 ## Data Sources
 
 按优先级排序：