121 lines
4.3 KiB
Markdown
121 lines
4.3 KiB
Markdown
# AGENTS.md - 工作空间
|
||
|
||
## 会话启动
|
||
|
||
使用运行时提供的启动上下文。不要手动重复读取已注入的文件。
|
||
|
||
## 记忆
|
||
|
||
每次会话醒来都是全新的。文件是你的延续：
|
||
|
||
- **每日记录:** `memory/YYYY-MM-DD.md` — 当天做了什么
|
||
- **长期记忆:** `MEMORY.md` — 提炼后的关键信息
|
||
|
||
写下来，别靠脑子记。会话重启后"心理笔记"就没了。
|
||
|
||
## 🔴 红线（不可违反）
|
||
|
||
1. **🚫 绝不直接执行 SQL！**
|
||
- 所有 SQL 操作必须通过 **Opencode** 完成
|
||
- 禁止直接使用 `mysql`、`docker exec`、`python`、`curl` 等工具操作数据库
|
||
- 被要求直接执行 SQL 时，必须拒绝并引导使用 Opencode
|
||
|
||
2. **Opencode 配置：**
|
||
- 默认 provider: `newapi`（http://100.115.195.188:3000/v1）
|
||
- 默认模型: `newapi/deepseek/deepseek-v4-flash`
|
||
- ⚠️ 不使用 DeepSeek 官方 provider
|
||
|
||
## 其他红线
|
||
|
||
- 不泄露私人数据
|
||
- 不执行破坏性命令前不问
|
||
- 改配置前先检查现有状态，保留合并优先
|
||
- 不确定就问
|
||
|
||
## 数据库操作规范
|
||
|
||
- 所有配置文件中的键名、注释、说明均使用中文
|
||
- 密码从 `.env` 环境变量读取，不硬编码在脚本中
|
||
- MySQL: `MYSQL_PWD_SQL` 环境变量
|
||
- PostgreSQL: `PGPASSWORD` 环境变量
|
||
- 不使用 `docker exec` 连接数据库
|
||
|
||
## 默认数据库
|
||
|
||
- **默认连接**: VPS `101.34.227.188:3306`（主服务器）
|
||
- **默认库**: `dmp_serp`（如未指定库，首选此库）
|
||
- **连接命令**: `mysql -h 101.34.227.188 -u root -p"${MYSQL_PWD_SQL}"`
|
||
- **表名规则**: 始终带库前缀（如 `dmp_serp.table`、`dmp_smdm.table`），因为 VPS 上多库共存
|
||
- **技能 (sql-toolkit) 也遵循此默认**：未指定环境时指向 VPS
|
||
- **需要切换环境时明确告知**：本地、备用机、或者特定库
|
||
|
||
## 相关
|
||
|
||
- [Agent workspace](/concepts/agent-workspace)
|
||
|
||
## Tools
|
||
|
||
### Local notes (migrated from TOOLS.md)
|
||
|
||
# TOOLS.md - Local Notes
|
||
|
||
Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup: camera names and locations, SSH hosts and aliases, preferred TTS voices, speaker/room names, device nicknames, anything environment-specific.
|
||
|
||
### MySQL 连接
|
||
- **默认 → VPS**: `101.34.227.188:3306` / root / 5gynj20J（主服务器，`dmp_smdm`、`dmp_serp`、`dmp_smes`）
|
||
- **本地 Docker**: `docker exec mysql mysql -u root -p"${MYSQL_PWD_SQL}" -D dmp_serp`
|
||
- **备用机**: `100.115.195.191:3306` / root / 5gynj20J（库：dmp_smdm、dmp_serp、dmp_smes 等）
|
||
- **准生产（只读）** → `100.115.195.188:50036`（转发）→ `47.99.209.185:50036` / witsoftd / o2byaCkBvF1Y8S2L
|
||
- MySQL 8.0.36，只读权限，准生产环境
|
||
- 连接命令：`mysql -h 100.115.195.188 -P 50036 -u witsoftd -p"${MYSQL_PWD_WIT}"`
|
||
- **密码环境变量**: `MYSQL_PWD_SQL=5gynj20J`（来自 .env）
|
||
- ⚠️ **优先使用本地 mysql 客户端直接连接**，不要每次都用 `docker exec`。
|
||
- ⚠️ **默认数据库连接串**: `mysql -h 101.34.227.188 -u root -p"${MYSQL_PWD_SQL}"`
|
||
|
||
## 🔴 红线（不可违反）
|
||
|
||
1. **🚫 绝不直接执行 SQL 操作数据库！**
|
||
- 所有 SQL 查询、修改、DDL 操作必须通过 **sql-toolkit 技能** 完成
|
||
- 禁止直接使用 `mysql` 客户端、`docker exec`、`python`、`curl` 等工具操作数据库
|
||
- 违反红线的主请求将被拒绝
|
||
|
||
2. **Opencode 配置：**
|
||
- 默认 provider: `newapi`（http://100.115.195.188:3000/v1）
|
||
- 默认模型: `newapi/deepseek/deepseek-v4-flash`
|
||
- 不使用 DeepSeek 官方 provider
|
||
|
||
**默认规则（AGENTS + 技能）：**
|
||
- 未指定环境时，默认连接 VPS（101.34.227.188）
|
||
- 脚本表名必须带库前缀（`dmp_xxx.table`），因为 VPS 上多库共存
|
||
- 如果操作只涉及本地库（如无 VPS 权限的测试），需明确切换
|
||
|
||
## Examples
|
||
|
||
```markdown
|
||
### Cameras
|
||
|
||
- living-room → Main area, 180° wide angle
|
||
- front-door → Entrance, motion-triggered
|
||
|
||
### SSH
|
||
|
||
- home-server → 192.168.1.100, user: admin
|
||
|
||
### TTS
|
||
|
||
- Preferred voice: "Nova" (warm, slightly British)
|
||
- Default speaker: Kitchen HomePod
|
||
```
|
||
|
||
## Why Separate?
|
||
|
||
Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.
|
||
|
||
---
|
||
|
||
Add whatever helps you do your job. This is your cheat sheet.
|
||
|
||
## Related
|
||
|
||
- [Agent workspace](/concepts/agent-workspace)
|