# [REDACTED_PHONE] 工作日志

## 重要决策：venv使用规范固化

### 背景
用户明确要求：所有Python代码必须使用venv环境运行。

### 已实施的固化措施

#### 1. 行为层（SOUL.md）
在SOUL.md中新增**铁律四：必须使用venv运行Python（绝对！）**

内容：
- 每次运行Python代码前必须检查shebang
- 允许的运行方式（3种）
- 绝对禁止的方式（2种）
- 记忆锚点（venv路径、runner脚本、环境变量）

#### 2. 记忆层（MEMORY.md）
创建了完整的venv规范文档，包含：
- 核心原则
- 关键记忆点
- 决策原因
- 运行方式优先级
- 检查清单
- 历史教训

#### 3. 启动层（STARTUP_CHECKLIST.md）
每次会话开始时的检查清单：
- 必须读取的文件
- Python/venv检查项
- 自问三问题
- 禁止事项
- 正确示例

#### 4. 自动化工具
创建了4个shell脚本：
- `venv_runner.sh` — 通用运行脚本
- `check_venv_compliance.sh` — 合规性检查
- `fix_shebang.sh` — 自动修复shebang
- `venv_aliases.sh` — Bash别名

#### 5. 脚本层
修复了62个Python脚本的shebang，全部指向venv Python。

#### 6. 会话层（AGENTS.md）
修改了Every Session规范，现在必须读取：
1. SOUL.md
2. MEMORY.md — 重要决策和venv规则
3. STARTUP_CHECKLIST.md — 快速参考
4. USER.md
5. memory/YYYY-MM-DD.md

### 如何确保自动使用venv？

#### 对AI（我自己）的约束：
1. **SOUL.md铁律** — 行为准则，每次决策时自动检查
2. **MEMORY.md** — 长期记忆，固化venv重要性
3. **STARTUP_CHECKLIST.md** — 每次启动时的提醒
4. **AGENTS.md会话规范** — 强制读取上述文件

#### 对用户调用：
所有脚本shebang已修复，直接运行即可：
```bash
./tools/script.py  # 自动使用venv
```

或使用wrapper：
```bash
./venv_runner.sh tools/script.py
```

### 验证结果
- ✅ 62个脚本已修复shebang
- ✅ 所有脚本合规性检查通过
- ✅ 长桥API测试成功（使用venv）

### 教训
之前曾因未使用venv导致长桥API调用失败，现在已全面固化，确保不再犯同样错误。

---

## 收盘报告模板固化 (v6.0)

### 背景
用户要求：收盘报告要包含外围市场、龙虎榜、Exa新闻、操作建议等深度分析。

### 模板结构（8大模块）
1. **外围市场环境** - 美股、港股、地缘政治
2. **A股市场全景** - 涨跌分布、成交额
3. **板块表现** - 科创板/创业板/主板/北交所
4. **热点新闻** - Exa实时搜索
5. **龙虎榜数据** - 机构净买入/卖出TOP5
6. **涨幅榜 TOP10**
7. **跌幅榜 TOP10**
8. **明日展望与操作建议** - 技术面、策略、风险提示

### 已创建文件
- `tools/daily_market_report_template_v6.py` - 主脚本
- `docs/daily_report_template_v6.md` - 模板说明文档
- `generate_daily_report.sh` - 快捷生成脚本

### 定时任务更新
HEARTBEAT.md已更新，收盘报告任务改为：
- 时间: 15:05（收盘后5分钟）
- 脚本: `tools/daily_market_report_template_v6.py`
- 超时: 10分钟

### 数据源
- 长桥API: A股全市场行情
- 腾讯API: 美股/港股指数
- Exa搜索: 实时新闻/地缘政治
- Akshare: 龙虎榜数据

### 使用方式
```bash
# 方式1: 快捷命令
./generate_daily_report.sh

# 方式2: venv_runner
./venv_runner.sh tools/daily_market_report_template_v6.py

# 方式3: 直接运行（自动使用venv）
./tools/daily_market_report_template_v6.py
```

### 输出文件
`data/daily_report_YYYYMMDD.md`

---

## 其他工作

### 收盘报告
- 创建了多API版本收盘报告（v3、v4）
- API优先级：长桥 > efinance > 腾讯
- 成功生成[REDACTED_PHONE]报告（长桥API，5190只股票）

### 数据回补
- 2026年因子计算进行中
- [REDACTED_PHONE]历史数据回补后台运行

### Skill化封装完成

创建标准Skill目录结构：
```
skills/daily-market-report/
├── SKILL.md                          # Skill说明文档
├── scripts/
│   └── generate_report.py            # 主脚本
└── docs/
    └── template_guide.md             # 使用指南
```

**快捷命令:**
```bash
./generate_market_report.sh           # 生成收盘报告
```

**定时任务更新:**
HEARTBEAT.md已更新指向Skill路径:
- `skills/daily-market-report/scripts/generate_report.py`

---

## 明日待办
- [ ] 检查2026年因子计算进度
- [ ] 验证Heartbeat定时任务
- [ ] 监控数据回补状态