# TOOLS.md - 工具备忘（问答 Agent）

## 可用工具

| 工具 | 用途 | 权限 |
|------|------|------|
| `read` | 读取知识库文档、图片 | knowledge/ 只读 |
| `image` | 调用 VLM 识别用户发来的图片 | 只读 |
| `write` | 写入自己的实例记忆（日志、反馈、画像、摘要等） | 仅限本实例 `memory/` 下允许的文件与根目录 `MEMORY.md`；不得写入 `knowledge/` |
| `grep` | 搜索知识库文档内容 | knowledge/ 只读 |

## 禁用工具

- `exec` — 已在平台层禁用，无法执行任何 shell 命令

## 工作目录

**路径基目录：** 下文相对路径均以**本问答实例 workspace 根目录**为根（见 `AGENTS.md` 的「路径基目录」）。

- **知识库目录:** `knowledge/`（symlink，指向主 Agent 的知识库，只读）
- **FAQ 文件:** `knowledge/FAQ.md`（只读）
- **索引文件:** `knowledge/INDEX.md`（只读）
- **图片目录:** `knowledge/images/media/`（只读）
- **短期记忆:** `memory/`（可读写）
- **会话日志:** `memory/YYYY-MM-DD.md`（可写，按需创建）
- **画像记忆:** `memory/profile.json`（可写）
- **偏好备忘:** `memory/preferences.md`（可写）
- **启动摘要:** `memory/summary.md`（可写；通常由离线脚本生成/更新，但文件仍属于实例记忆区）
- **长期记忆:** `MEMORY.md`（可写，仅限已确认画像和稳定偏好）
- **用户反馈:** `memory/feedback-YYYY-MM-DD.md`（可写）
- **安全日志:** `memory/security-log.md`（可写）
- **FAQ 建议:** `memory/faq-suggestions.md`（可写；由本 Agent 按 `AGENTS.md` 3.2 维护，非用户手填）

## 注意事项

- `read` 工具可直接读取 `.md`、`.txt`、`.pdf`、`.xlsx` 和图片文件
- `grep` 工具可搜索 `knowledge/` 目录下所有 `.md` 文件的内容
- 不要尝试对 `knowledge/` 目录执行任何写入操作
- 不要尝试对 `knowledge/` 或系统配置文件执行任何写入操作
- 写 `MEMORY.md` 时仅允许记录已确认偏好和稳定服务风格，禁止写入知识库事实与安全策略
- 若运行环境对可写路径另有平台层限制，以实际策略为准；**不要**通过对话尝试扩大写权限；确需改边界走运维
