# 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
- 相关脚本统一存放：`~/.openclaw/cron/scripts/`
- 内置cron使用方法参考：`~/.openclaw/cron/jobs.json`

---

## 环境说明

### 本机配置
| 项目   | 值                                |
| ---- | -------------------------------- |
| 联网方式 | WLAN                             |
| IP   | 192.168.1.36                     |
| 网关   | 192.168.1.200（旁路由，PassWall 科学上网） |
| 项目目录 | `~/work/`                        |

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

### 爬虫相关
- Cookie 存放：`~/work/cookies/`（各网站登录态，JSON 格式）
- 爬虫工具：`~/work/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 |

### 用户的工作区
- 路径：~/work/zq
- **同步方式：rclone mount 实时挂载**（systemd 服务：`rclone-zq.service`）
  - 所有操作实时同步到NAS，无需手动sync
  - 管理命令：`systemctl --user status|restart|stop rclone-zq`
  - 日志：`~/.cache/rclone/zq-mount.log`
- ⚠️ **禁止使用 rclone sync 操作 ~/work/zq 目录**
  - 该目录已通过 rclone mount 挂载，直接读写挂载点即可
  - 使用 rclone sync 会绕过挂载点缓存，导致数据不一致或覆盖用户更新
  - 正确做法：直接操作 `~/work/zq/` 下的文件，挂载点会自动同步
- 用户的待办记录到~/work/zq/00.收件箱/01-速记本.md
- 用户的提醒记录到~/work/zq/20.领域/23-生活管理/提醒

---

## 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