From b1bc8e50d016dc2d00adc37e3850c1f23f33a319 Mon Sep 17 00:00:00 2001
From: kang <wankang2050@gmail.com>
Date: Sat, 25 Apr 2026 21:40:43 +0800
Subject: [PATCH] init repo

---
 .gitignore           | 26 ++++++++++++++++++++++++++
 .memory/worklog.json |  3 +++
 .project.json        | 13 +++++++++++++
 AGENTS.md            | 21 +++++++++++++++++++++
 CLAUDE.md            | 21 +++++++++++++++++++++
 RULES.md             | 37 +++++++++++++++++++++++++++++++++++++
 6 files changed, 121 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 .memory/worklog.json
 create mode 100644 .project.json
 create mode 100644 AGENTS.md
 create mode 100644 CLAUDE.md
 create mode 100644 RULES.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..310df25
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,26 @@
+# OS
+.DS_Store
+
+# Env
+.env
+.env.*
+
+# Python
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.venv/
+venv/
+
+# Node
+node_modules/
+.next/
+dist/
+build/
+.nuxt/
+.output/
+
+# Misc
+*.log
+
+# bootstrap-gitea-no-git
diff --git a/.memory/worklog.json b/.memory/worklog.json
new file mode 100644
index 0000000..046955d
--- /dev/null
+++ b/.memory/worklog.json
@@ -0,0 +1,3 @@
+{
+  "entries": []
+}
diff --git a/.project.json b/.project.json
new file mode 100644
index 0000000..d7fad99
--- /dev/null
+++ b/.project.json
@@ -0,0 +1,13 @@
+{
+  "name": "XodYH3Gezef",
+  "description": "",
+  "status": "active",
+  "kind": "app",
+  "created": "2026-04-05",
+  "urls": [],
+  "worklog": {
+    "path": ".memory/worklog.json",
+    "auto": true
+  },
+  "ownership": "company"
+}
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..1caecf9
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# XodYH3Gezef 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..1caecf9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,21 @@
+# XodYH3Gezef 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..c91ae81
--- /dev/null
+++ b/RULES.md
@@ -0,0 +1,37 @@
+# XodYH3Gezef
+
+## 启动
+- `待补充`
+
+## 部署事实
+- 平台：待定
+- 发布状态：未部署
+- 主站 / 前端：待定
+- API / 后端：待定
+- 文档 / 解析：待定
+- 管理后台：待定
+- 代码仓：待定
+
+## 快捷登录
+- 登录地址：待补充
+- 用户名：待补充
+- 密码：待补充
+- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
+
+## 元数据回写清单
+- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
+- 如果有网页后台登录：
+  - 可直接入库：写 `.project.json.quick_login`
+  - 不应入库：写 `.project.json.credentials` 引用
+- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
+
+## 环境变量
+- 待补充
+
+## 规则
+- 不允许编造不存在的部署域名、账号、密码
+- 没有公网地址时，`.project.json.urls` 保持空数组
+- 任何部署或域名变化，都要先改元数据，再视为任务完成
+
+## 注意事项
+- 待补充