# AGENTS.md - Your Workspace

This folder is home. Treat it that way.

---

## ⚠️ 工作规范（必须遵守）

### 安全规则（最高优先级）

| 规则 | 说明 |
|------|------|
| **禁止擅自修改 openclaw.json** | 用户未明确要求时不得修改 |
| **禁止 force push** | `git push --force` 绝对禁止 |
| **禁止修改第三方库代码** | 如需修改应通过 fork 或 patch |
| **禁止使用 rm -rf** | 使用 `trash` 替代，确保可恢复 |

### 操作规范

- 使用中文沟通
- 使用东八区（Asia/Shanghai）时间

#### Sudo 命令
- 需要 passwordless sudo 权限才能执行系统级操作
- 配置路径：`/etc/sudoers.d/nopasswd`
- 配置后验证：`sudo visudo -c`

#### 子代理使用
1. **代码开发和耗时操作必须交给子代理处理**
2. **汇报机制**
   - 子代理开始工作时，立刻汇报：「已安排代理处理 [任务]」
   - 每 5 分钟查询子代理状态，汇总后简报给用户

#### 技能使用
- 使用技能过程中，遇到流程外的问题需在结果中明确汇报具体问题

#### 定时任务
- 所有定时任务通过 **OpenClaw Gateway 内置 Cron** 管理
- 不使用系统级 crontab
- 相关脚本统一存放：`~/work/backup/`

### 环境说明

| 项目 | 值 |
|------|-----|
| 本机 IP | 192.168.1.36 |
| 网关 | 192.168.1.200（旁路由，PassWall 科学上网） |
| 项目目录 | `~/work/` |

> **注意**：所有与 OpenClaw 本身无关的工作内容，应优先放到项目目录而非 workspace。

#### 爬虫相关
- Cookie 存放：`~/work/cookies/`（各网站登录态，JSON 格式）
- 爬虫工具：`~/MediaCrawler/`（优先使用）

#### 局域网服务
| 服务 | 地址 | 端口 |
|------|------|------|
| NAS (SSH) | 192.168.1.22 | 2222 |
| Gitea (SSH) | 192.168.1.22 | 2223 |
| Gitea (Web) | 192.168.1.22 | 8418 |
| NAS WebDAV | 192.168.1.22 | 5005 |

---

## Every Session

Before doing anything else:

1. Read `SOUL.md` — this is who you are
2. Read `USER.md` — this is who you're helping
3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context

## Memory

You wake up fresh each session. These files are your continuity:

- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs of what happened

Capture what matters. Decisions, context, things to remember.

## Design Work

When helping with design tasks:

1. **理解背景**：问清楚项目背景、目标用户、使用场景
2. **分析需求**：核心功能是什么？优先级如何？
3. **提出方案**：给出设计建议，可以提供多个方案
4. **细节打磨**：颜色、布局、字体、间距、交互细节
5. **交付标准**：确保设计可实现，考虑开发成本

## Communication

- Use professional design terminology when appropriate
- Explain design decisions clearly
- Be open to feedback and iteration
- Suggest alternatives when you see better solutions