From fe90f64a5651cb4f2ac862625d61e60835a389bf Mon Sep 17 00:00:00 2001 From: AskaEth Date: Sun, 4 Oct 2026 13:18:26 +0800 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E7=99=BB=E8=AE=B0=E4=B8=BB?= =?UTF-8?q?=E4=BA=BA=E6=96=B0=E7=BA=A2=E7=BA=BF=E3=80=8C=E5=90=8E=E7=AB=AF?= =?UTF-8?q?=E5=B8=B8=E9=A9=BB=E3=80=8D=E2=80=94=E2=80=94=E4=B8=8B=E4=B8=80?= =?UTF-8?q?=E6=AC=A1=E6=9E=84=E5=BB=BA=E4=BA=A7=E7=89=A9=E5=B0=B1=E7=BB=AA?= =?UTF-8?q?=E5=89=8D=E4=B8=8D=E5=87=86=E5=85=B3=E5=90=8E=E7=AB=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - AGENTS.md §9 新增一条:运行中的后端(cyrene.exe,:10942)在**下一次构建产物就绪之前不准关**, 除非出现恶性 Bug(进程致命错误/必须阻断的严重故障) - 推论写入铁律:① 跑 go test/build/git/验收都不需要停后端;② 换二进制只允许「先 build 到位、 再一次 restart」,不留空窗;③ 启动不许用前台阻塞式包装(ctrl.bat start/restart 会守着进程轮询健康, 工具超时会连带杀进程树)——必须确认进程脱离工具;④ 压缩/中断后先探活(netstat + /api/v1/health)再判断 - 同步记进 DevDocs/工作小结/00-当前态.md 的红线区(含本次实测:TaskStop 掉包装后后端存活、PID 文件已写) --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index c6e959d..ba757d6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -47,6 +47,7 @@ - **记忆三类作用域隔离**:用户习惯(全局共享)/ 角色日常(他角色只读)/ 项目(人人读写 + 项目索引分层);**群聊 / 陌生人:查记忆只读不写、不入主会话上下文、不泄露主人敏感信息**。 - **敏感操作主代理代审 + 审计日志 + 前端小字**(「xxx 想要干什么,我审查后批准了」)。 - **模型**:per-role 路由 + 接口报错自动降级(主→备→本地);多模态/流式。 +- 🔴 **后端常驻(主人 2026-10-04 追加要求)**:在**下一次构建产物就绪之前,正在运行的后端(`cyrene.exe`,`:10942`)不准关**,除非出现**恶性 Bug**(进程致命错误/必须阻断的严重故障)。推论:① **禁止**为「跑全树验收 / 重启清理 / 图省事」而停它——`go test`/`go build`/`git` 都不需要停后端;② 换二进制**只允许**在**新产物已构建好之后**一次性 `restart`(即「先 build 到位,再一次切换」,不得留空窗);③ **启动后端不许用前台阻塞式命令**(`scripts\ctrl.bat start` 会守着进程不返回)——必须确认它**脱离工具进程**,否则工具超时会**连带杀掉后端**(2026-10-04 实测:`TaskStop` 掉阻塞包装后进程存活、PID 文件已写 `757788`,属脱离式启动);④ 上下文压缩/会话中断后:**先探活**(`netstat -ano | grep 10942` + `curl /api/v1/health`)再决定,不要凭印象以为它停了。 ## 9.5 学习成熟开源实现,禁止闭门造车(⚠️ 用户强制红线) - **已成熟的能力/模块,必须优先学习并复用现有开源项目的业务逻辑与交互范式**,**严禁闭门造车/按设计文档凭空推演**。对照基准(按 design 主题):