Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

docs: refine release and local dev rules

tianma-if0044fed00172
diff --git a/AGENTS.md b/AGENTS.md
index d4cf4d5e..2d834369 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -12,7 +12,9 @@
## GitHub Issue 与 Release 约束
-正式版本遵循 Semantic Versioning。发布前检查最新 Release 和远端标签,选择未使用的版本号。Git 标签与 Release 标题必须完全一致,格式为 `vX.Y.Z`。
+正式版本遵循 Semantic Versioning。发布前检查最新 Release 和远端标签,选择未使用的版本号。Git 标签与 Release 标题必须完全一致,格式为 `vX.Y.Z`。每个正式版本标签必须与一个已发布的 GitHub Release 一一对应,不得遗留只有标签、没有 Release 的正式版本;发现历史遗留的孤立正式标签时,应先识别并处理其影响,再继续发布新版本。
+
+Release 正文必须以上一个实际发布的正式 GitHub Release 为变更基线,完整审计从该 Release 标签到本次发布提交之间的全部提交,并面向用户汇总其中所有可感知变化,不得直接复制提交记录,也不得只说明当前任务或最新一次提交。若中间存在只有 Git 标签、没有对应 GitHub Release 的版本,不得将其视为发布基线;应继续回溯到最近一个实际存在的正式 Release。正文应覆盖该完整区间内的功能、修复、界面、文档及其他用户可感知变化;变更较多、需要审计或方便开发者追溯时,可按需附上 GitHub Compare 链接。
Release 标签必须指向 `main` 上经过验证的发布提交;默认发布为非 Draft、非 Prerelease。发布正文使用以下结构:
@@ -36,11 +38,9 @@ Release 标签必须指向 `main` 上经过验证的发布提交;默认发布
## 本地启动约束
-本地预览或调试时,必须优先使用 `bun run dev` 启动完整的纯本地开发环境。该命令使用本地 D1/R2 和固定演示种子,不得读取或连接 `.env.local` 中的远程个性化实例。
-
-只有用户明确要求连接远程实例时,才能使用 `EDGE_EVER_INSTANCE=<实例名> bun run dev:remote`。实例名称、D1/R2 资源、账号等本机私有配置均以 `.env.local` 为准,严禁在代理指令或代码中硬编码个人实例名;禁止在未显式指定实例的情况下启动远程开发环境。
-
-除非用户明确要求只启动前端静态界面,否则不要单独运行 `bun run dev:web`;该命令不会启动 API,容易导致前端请求 `127.0.0.1:8787` 失败或误判环境。
+- 默认使用 `bun run dev` 启动完整本地环境(本地 D1/R2 和固定演示种子),不得连接 `.env.local` 中的远程实例。
+- 仅在用户明确指定远程实例并要求连接时,使用 `EDGE_EVER_INSTANCE=<实例名> bun run dev:remote`;私有配置以 `.env.local` 为准,不得硬编码实例名。
+- 仅在用户明确要求只启动前端时使用 `bun run dev:web`。
## 组件复用与造轮子约束