110 lines
3.4 KiB
Markdown
110 lines
3.4 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与Nas同步，修改内容之前必须先从Nas成功同步到本地，修改内容之后必须同步到Nas。
|
|
- 用户的待办记录到~/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
|