From 4d646a5189e3e7199747bd381ebef27f21707c05 Mon Sep 17 00:00:00 2001
From: kang <wankang2050@gmail.com>
Date: Sat, 25 Apr 2026 18:18:57 +0800
Subject: [PATCH] auto-save 2026-04-25 18:18 (+3, ~1)

---
 .memory/worklog.json | 14 +++++++-------
 AGENTS.md            | 21 +++++++++++++++++++++
 CLAUDE.md            | 21 +++++++++++++++++++++
 RULES.md             | 37 +++++++++++++++++++++++++++++++++++++
 4 files changed, 86 insertions(+), 7 deletions(-)
 create mode 100644 AGENTS.md
 create mode 100644 CLAUDE.md
 create mode 100644 RULES.md

diff --git a/.memory/worklog.json b/.memory/worklog.json
index fa38e62..21b8258 100644
--- a/.memory/worklog.json
+++ b/.memory/worklog.json
@@ -1,12 +1,5 @@
 {
   "entries": [
-    {
-      "ts": "2026-04-23T08:19:25+08:00",
-      "type": "commit",
-      "message": "auto-save 2026-04-23 08:19 (~1)",
-      "hash": "36ca2ef",
-      "files_changed": 1
-    },
     {
       "ts": "2026-04-23T08:25:17+08:00",
       "type": "commit",
@@ -3499,6 +3492,13 @@
       "message": "auto-save 2026-04-25 18:07 (~1)",
       "hash": "272f037",
       "files_changed": 1
+    },
+    {
+      "ts": "2026-04-25T18:13:28+08:00",
+      "type": "commit",
+      "message": "auto-save 2026-04-25 18:13 (~1)",
+      "hash": "7e1e38f",
+      "files_changed": 1
     }
   ]
 }
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..2fa00a1
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# Hermes Glass UI · 个人版 Agent Rules
+
+## Must Read First
+
+- `.project.json` 是机器真源：公网链接、快捷登录、凭证引用都以它为准
+- `RULES.md` 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
+- 不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充
+
+## Deployment Metadata Contract
+
+- 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 `.project.json`
+- `urls[]` 推荐显式写 `type`：`app`、`backend`、`docs`、`admin`、`repo`
+- 项目专属的网页登录信息，如果允许放进仓库，就写 `.project.json.quick_login`
+- 不能直接入库的敏感登录，不要伪造 `quick_login`，改为写 `.project.json.credentials` 引用
+- 数据库密码、API Key、服务器 root 密码，不属于 `quick_login`
+
+## Completion Gate
+
+- 部署完成后，不允许在 `.project.json` 缺少最新公网链接的状态下结束任务
+- 部署完成后，必须同步更新 `RULES.md` 的部署事实
+- 如果只更新了代码但没回写部署元数据，这个任务不算完成
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..2fa00a1
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,21 @@
+# Hermes Glass UI · 个人版 Agent Rules
+
+## Must Read First
+
+- `.project.json` 是机器真源：公网链接、快捷登录、凭证引用都以它为准
+- `RULES.md` 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
+- 不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充
+
+## Deployment Metadata Contract
+
+- 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 `.project.json`
+- `urls[]` 推荐显式写 `type`：`app`、`backend`、`docs`、`admin`、`repo`
+- 项目专属的网页登录信息，如果允许放进仓库，就写 `.project.json.quick_login`
+- 不能直接入库的敏感登录，不要伪造 `quick_login`，改为写 `.project.json.credentials` 引用
+- 数据库密码、API Key、服务器 root 密码，不属于 `quick_login`
+
+## Completion Gate
+
+- 部署完成后，不允许在 `.project.json` 缺少最新公网链接的状态下结束任务
+- 部署完成后，必须同步更新 `RULES.md` 的部署事实
+- 如果只更新了代码但没回写部署元数据，这个任务不算完成
diff --git a/RULES.md b/RULES.md
new file mode 100644
index 0000000..ff00948
--- /dev/null
+++ b/RULES.md
@@ -0,0 +1,37 @@
+# Hermes Glass UI · 个人版
+
+## 启动
+- `待补充`
+
+## 部署事实
+- 平台：待定
+- 发布状态：已部署
+- 主站 / 前端：https://hermes.milejoy.com
+- API / 后端：待定
+- 文档 / 解析：https://styles.kang-kang.com
+- 管理后台：待定
+- 代码仓：待定
+
+## 快捷登录
+- 登录地址：https://hermes.kang-kang.com
+- 用户名：kang
+- 密码：elErZOoJ35ywNlq222UTQnm3IbN9pv24
+- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
+
+## 元数据回写清单
+- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
+- 如果有网页后台登录：
+  - 可直接入库：写 `.project.json.quick_login`
+  - 不应入库：写 `.project.json.credentials` 引用
+- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
+
+## 环境变量
+- 待补充
+
+## 规则
+- 不允许编造不存在的部署域名、账号、密码
+- 没有公网地址时，`.project.json.urls` 保持空数组
+- 任何部署或域名变化，都要先改元数据，再视为任务完成
+
+## 注意事项
+- 待补充