docs: note that workspace config files are hot-reloaded (#1747)

* docs: note that workspace config files are hot-reloaded via mtime tracking

* refactor files

* refactor files
This commit is contained in:
Mauro 2026-03-19 04:30:08 +01:00 committed by GitHub
parent e931756fee
commit 14a28ae93e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
6 changed files with 18 additions and 7 deletions

View file

@ -42,13 +42,15 @@ PicoClaw stores data in your configured workspace (default: `~/.picoclaw/workspa
├── state/ # Persistent state (last channel, etc.) ├── state/ # Persistent state (last channel, etc.)
├── cron/ # Scheduled jobs database ├── cron/ # Scheduled jobs database
├── skills/ # Custom skills ├── skills/ # Custom skills
├── AGENTS.md # Agent behavior guide ├── AGENT.md # Agent behavior guide
├── HEARTBEAT.md # Periodic task prompts (checked every 30 min) ├── HEARTBEAT.md # Periodic task prompts (checked every 30 min)
├── IDENTITY.md # Agent identity ├── IDENTITY.md # Agent identity
├── SOUL.md # Agent soul ├── SOUL.md # Agent soul
└── USER.md # User preferences └── USER.md # User preferences
``` ```
> **Note:** Changes to `AGENT.md`, `SOUL.md`, `USER.md` and `memory/MEMORY.md` are automatically detected at runtime via file modification time (mtime) tracking. You do **not** need to restart the gateway after editing these files — the agent picks up the new content on the next request.
### Skill Sources ### Skill Sources
By default, skills are loaded from: By default, skills are loaded from:

View file

@ -42,13 +42,14 @@ PicoClaw stocke les données dans votre workspace configuré (par défaut : `~/.
├── state/ # État persistant (dernier canal, etc.) ├── state/ # État persistant (dernier canal, etc.)
├── cron/ # Base de données des tâches planifiées ├── cron/ # Base de données des tâches planifiées
├── skills/ # Compétences personnalisées ├── skills/ # Compétences personnalisées
├── AGENTS.md # Guide de comportement de l'agent ├── AGENT.md # Guide de comportement de l'agent
├── HEARTBEAT.md # Invites de tâches périodiques (vérifiées toutes les 30 min) ├── HEARTBEAT.md # Invites de tâches périodiques (vérifiées toutes les 30 min)
├── IDENTITY.md # Identité de l'agent
├── SOUL.md # Âme de l'agent ├── SOUL.md # Âme de l'agent
└── USER.md # Préférences utilisateur └── USER.md # Préférences utilisateur
``` ```
> **Remarque :** Les modifications apportées à `AGENT.md`, `SOUL.md`, `USER.md` et `memory/MEMORY.md` sont détectées automatiquement au moment de l'exécution via le suivi de la date de modification (mtime). Il n'est **pas nécessaire de redémarrer le gateway** après avoir modifié ces fichiers — l'agent charge le nouveau contenu à la prochaine requête.
### Sources de Compétences ### Sources de Compétences
Par défaut, les compétences sont chargées depuis : Par défaut, les compétences sont chargées depuis :

View file

@ -42,13 +42,15 @@ PicoClaw は設定されたワークスペース(デフォルト: `~/.picoclaw
├── state/ # 永続化状態 (最後のチャネルなど) ├── state/ # 永続化状態 (最後のチャネルなど)
├── cron/ # スケジュールジョブデータベース ├── cron/ # スケジュールジョブデータベース
├── skills/ # カスタムスキル ├── skills/ # カスタムスキル
├── AGENTS.md # Agent 動作ガイド ├── AGENT.md # Agent 動作ガイド
├── HEARTBEAT.md # 定期タスクプロンプト (30 分ごとにチェック) ├── HEARTBEAT.md # 定期タスクプロンプト (30 分ごとにチェック)
├── IDENTITY.md # Agent アイデンティティ ├── IDENTITY.md # Agent アイデンティティ
├── SOUL.md # Agent ソウル/性格 ├── SOUL.md # Agent ソウル/性格
└── USER.md # ユーザー設定 └── USER.md # ユーザー設定
``` ```
> **注意:** `AGENT.md``SOUL.md``USER.md` および `memory/MEMORY.md` への変更は、ファイル更新時刻mtimeの追跡により実行時に自動検出されます。これらのファイルを編集した後に **gateway を再起動する必要はありません** — Agent は次のリクエスト時に最新の内容を自動的に読み込みます。
### スキルソース ### スキルソース
デフォルトでは、スキルは以下の順序で読み込まれます: デフォルトでは、スキルは以下の順序で読み込まれます:

View file

@ -42,13 +42,15 @@ O PicoClaw armazena dados no seu workspace configurado (padrão: `~/.picoclaw/wo
├── state/ # Estado persistente (último canal, etc.) ├── state/ # Estado persistente (último canal, etc.)
├── cron/ # Banco de dados de tarefas agendadas ├── cron/ # Banco de dados de tarefas agendadas
├── skills/ # Skills personalizadas ├── skills/ # Skills personalizadas
├── AGENTS.md # Guia de comportamento do agente ├── AGENT.md # Guia de comportamento do agente
├── HEARTBEAT.md # Prompts de tarefas periódicas (verificados a cada 30 min) ├── HEARTBEAT.md # Prompts de tarefas periódicas (verificados a cada 30 min)
├── IDENTITY.md # Identidade do agente ├── IDENTITY.md # Identidade do agente
├── SOUL.md # Alma do agente ├── SOUL.md # Alma do agente
└── USER.md # Preferências do usuário └── USER.md # Preferências do usuário
``` ```
> **Nota:** Alterações em `AGENT.md`, `SOUL.md`, `USER.md` e `memory/MEMORY.md` são detectadas automaticamente em tempo de execução via rastreamento de data de modificação (mtime). **Não é necessário reiniciar o gateway** após editar esses arquivos — o agente carrega o novo conteúdo na próxima requisição.
### Fontes de Skills ### Fontes de Skills
Por padrão, as skills são carregadas de: Por padrão, as skills são carregadas de:

View file

@ -42,13 +42,15 @@ PicoClaw lưu trữ dữ liệu trong workspace đã cấu hình (mặc định:
├── state/ # Trạng thái bền vững (kênh cuối, v.v.) ├── state/ # Trạng thái bền vững (kênh cuối, v.v.)
├── cron/ # Cơ sở dữ liệu tác vụ lên lịch ├── cron/ # Cơ sở dữ liệu tác vụ lên lịch
├── skills/ # Skill tùy chỉnh ├── skills/ # Skill tùy chỉnh
├── AGENTS.md # Hướng dẫn hành vi agent ├── AGENT.md # Hướng dẫn hành vi agent
├── HEARTBEAT.md # Prompt tác vụ định kỳ (kiểm tra mỗi 30 phút) ├── HEARTBEAT.md # Prompt tác vụ định kỳ (kiểm tra mỗi 30 phút)
├── IDENTITY.md # Danh tính agent ├── IDENTITY.md # Danh tính agent
├── SOUL.md # Linh hồn agent ├── SOUL.md # Linh hồn agent
└── USER.md # Tùy chọn người dùng └── USER.md # Tùy chọn người dùng
``` ```
> **Lưu ý:** Các thay đổi đối với `AGENT.md`, `SOUL.md`, `USER.md``memory/MEMORY.md` được tự động phát hiện trong thời gian chạy thông qua theo dõi thời gian sửa đổi file (mtime). **Không cần khởi động lại gateway** sau khi chỉnh sửa các file này — agent sẽ tải nội dung mới vào yêu cầu tiếp theo.
### Nguồn Skill ### Nguồn Skill
Mặc định, skill được tải từ: Mặc định, skill được tải từ:

View file

@ -42,13 +42,15 @@ PicoClaw 将数据存储在您配置的工作区中(默认:`~/.picoclaw/work
├── state/ # 持久化状态 (最后一次频道等) ├── state/ # 持久化状态 (最后一次频道等)
├── cron/ # 定时任务数据库 ├── cron/ # 定时任务数据库
├── skills/ # 自定义技能 ├── skills/ # 自定义技能
├── AGENTS.md # Agent 行为指南 ├── AGENT.md # Agent 行为指南
├── HEARTBEAT.md # 周期性任务提示词 (每 30 分钟检查一次) ├── HEARTBEAT.md # 周期性任务提示词 (每 30 分钟检查一次)
├── IDENTITY.md # Agent 身份设定 ├── IDENTITY.md # Agent 身份设定
├── SOUL.md # Agent 灵魂/性格 ├── SOUL.md # Agent 灵魂/性格
└── USER.md # 用户偏好 └── USER.md # 用户偏好
``` ```
> **提示:**`AGENT.md``SOUL.md``USER.md``memory/MEMORY.md` 的修改会通过文件修改时间mtime在运行时自动检测。**无需重启 gateway**Agent 将在下一次请求时自动加载最新内容。
### 技能来源 (Skill Sources) ### 技能来源 (Skill Sources)
默认情况下,技能会按以下顺序加载: 默认情况下,技能会按以下顺序加载: