117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
# 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
|