22 Commits
Author SHA1 Message Date
AskaEth dfac06bbeb docs(agents): 记下 internal/webui/dist/.gitkeep 占位不可删(干净 checkout 可构建的前提)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
2026-10-25 00:09:56 +08:00
AskaEth a4efbffe60 docs(架构): 插件开端口的四条护栏转为「已确认采纳」
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
主人 2026-10-07:「其他几个选项按你的最优解来」⇒ 四条护栏正式采纳,
去掉 AGENTS.md §9 与契约 v0.88 里的「待主人逐条确认」字样。

护栏内容不变:显式配置 / 默认绑 127.0.0.1 / 日志与审计 / 不得绕过身份判定。
2026-10-07 16:16:29 +08:00
AskaEth 5b8c7a3ef3 docs(架构): 澄清单端口红线只约束框架自身,扩展插件可开端口
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
主人 2026-10-07 口径补充:原先把这条红线读成「任何组件都不许开端口」过宽了。

- AGENTS.md §9:红线加限定语(只约束 Cyrene 框架自身);qq-obv11 那条已登记
  例外升格为一般规则的实例;新增插件开端口的四条护栏(显式配置 / 默认绑
  127.0.0.1 / 日志与审计 / 不得绕过身份判定)—— 护栏由主代理拟,待主人逐条确认
- Docs/api-client.md v0.88:澄清「插件监听端口不在契约范围内」;零破坏性变更,
  无新端点 / 无新帧 / 无字段形状变化,路由计数不变(14 + 25 + 40 = 79)
- README.md:用户侧表述同步

DevDocs 侧同步(不进 git):design/13 §0、design/09 §5、design/08 §4、恢复提示词红线节。
2026-10-07 14:09:01 +08:00
AskaEth 9c9a6d26c9 docs(env): .env 冻结最终口径 —— 基础键已定、以后不准改(不加/不改/不删)
主人 2026-10-06 二次收口:只求『统一不新增』且『基础键已定好、以后不准改』。
- AGENTS §10 与 design/13 §2.1 同步改写:新配置一律走 $DATA_DIR/config/** + 代码默认值;
  既有基础键与 env: tag 保持现状(不迁移/不改默认值/不删键);E6 作废
- 新增一条判据:模板与代码若出现差异 ⇒ 那是**事故**(有人动了被冻结的东西),要回退而不是同步文档
2026-10-06 18:46:25 +08:00
AskaEth 3d7af019d4 docs(env): .env 冻结为「只保证最小化功能可跑」的引导面(主人红线)
- 撤出今日新增的 env 键:MEMORY_REVIEW_*(我加的 4 键)与 MEMORY_TIDY_COMPARE_LIMIT
  (MT-A 加的 1 键)⇒ 代码默认值 2000 / true / 256 / 200 / 20 仍然生效,行为零变化
- 既有条目保持现状:MEMORY_TIDY_CANDIDATE_LIMIT 的默认值 20→200 属**既有键**的如实更新,
  模板必须跟(冻结不等于让文档说谎)
- AGENTS §10 的协同 E6 改写:原「新 env 键必须同步模板」作废 ⇒ 「新键不进模板;
  确属最小化引导必需者须主人明确批准」;既有键与既有 env: tag 保持现状(不迁移)
2026-10-06 08:23:48 +08:00
AskaEth df8fc660c0 docs(agents): §10 补铁律——提交一律逐文件 git add(实测吞过别人在途文件)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
2026-10-05 11:31:24 +08:00
AskaEth afd56ffd99 docs(agents): §10 补两条铁律(换二进制前先确认前端变更 / 裁定必须带完成状态)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
2026-10-05 11:22:27 +08:00
AskaEth 46caa724f2 docs(agents): 修一处被上一次编辑破坏的条目 + 增「等待子代理不许长 WaitFor」规矩
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
- 修复:上一条「压测纪律」的编辑把「仓库根产物卫生」的标题吃掉,导致该条只剩半句孤儿文本(已恢复标题与分隔)。

- 新增:等待子代理**不许用长 WaitFor 阻塞回合**(主人反馈:等待期间无法给补充输入)——派完就结束回合(完成通知会自动唤醒);确需同回合等,单次 ≤60s;有并行工作就先做工作。
2026-10-04 21:53:24 +08:00
AskaEth 367abf2c8e docs(agents): 铁律 §10 增「压测纪律」(yes 风暴占满整机 15 分钟的事故)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
- 事故:子代理做负载验证时用 30 个 yes,第一次 kill 没杀干净 ⇒ 12 核被占满约 15 分钟,所有 go build/test 近乎停滞,并把工具链误判成死锁。

- 规矩:负载限核(GOMAXPROCS/单包并行/-p)或限时,优先用「可控对抗条件 + 注入时钟 + 门控」而不是堆进程;压测结束必须确认无残留进程再出证据;出现「整机变慢/命令不动」先查自己刚起的压测进程。
2026-10-04 21:11:39 +08:00
AskaEth 834ef3683e docs(agents): 铁律 §10 增「.env.example 与实现同步」固定动作(E6 的根治)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
与「改帧就同步 api-client.md」同一类:新增/改名/删除任何 env 键即同步模板;键名逐字一致、值一律占位符、废弃键显式标注。附自查口径(键集合 comm 差值只许剩已说明噪声)。
2026-10-04 17:14:56 +08:00
AskaEth f2c12b1921 docs(agents): 铁律 §10 增「仓库根产物卫生」红线(实测事故)
- 事故:子代理跑 go build ./cmd/cyrene/...(单 main 包)把可执行文件写到当前目录,
  静默覆盖正在用的发布产物 cyrene.exe(且未 strip,39.3 MB → 49.1 MB)。
- 规矩:子代理不许跑会在仓库根产出可执行文件的构建;换二进制只允许
  scripts\ctrl.bat build(唯一权威构建)+ 一次 restart,且必须在整树验收通过之后。
2026-10-04 17:08:41 +08:00
AskaEth fe90f64a56 docs(agents): 登记主人新红线「后端常驻」——下一次构建产物就绪前不准关后端
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
- 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 文件已写)
2026-10-04 13:18:26 +08:00
AskaEth a35bcb8aa9 docs(agents): 锚点路径统一为 DevDocs/工作小结/00-当前态.md(目录规范化:入口文件按本目录 NN- 编号约定改名)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
配合工作小结目录规范化(agent-79):当前态文件由自造名 当前态.md 改为 00-当前态.md,
与 00-索引.md 同属入口类编号;本提交只改 AGENTS.md 里 5 处路径文本,其它一字未动。
DevDocs 侧引用(恢复提示词/开发时间线/开发习惯与约定/02-constraints/00-索引)同批更新;
DevDocs/audit/** 与重构前归档里的旧文件名是历史证据,故意保留。
2026-10-04 11:17:32 +08:00
AskaEth e3ae0129c9 docs(agents): 锚点路径更新为 DevDocs/工作小结/当前态.md(工作小结已整体收进其目录)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
主人 2026-10-04 指出:工作小结应当整体住在 `DevDocs/工作小结/` 目录里,不该有一个入口文件留在目录外。
据此把 `DevDocs/工作小结.md` 搬进目录、改名为 `当前态.md`(该目录因此自洽:
`当前态.md`(当前态)+ `00-索引.md`(历史索引)+ 按时间分片的历史文档 + 重构前全量归档)。

本提交只更新 AGENTS.md 里 5 处引用路径(§2 先读锚点 / §5 每步更新 / §7 关键决策位置 /
§8 监工动作 / §8 压缩后恢复);DevDocs 侧的引用由并行任务统一修正;
`DevDocs/audit/**` 里出现的旧文件名是当时的现场证据快照,故意保留不改。
2026-10-04 11:08:35 +08:00
AskaEth 5a9f161fe3 docs(agents): 登记两处已裁决例外(OneBot 反连端口 / 表名复数命名)
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
主人 2026-10-04 裁决后按执行方案(DevDocs/audit/_plan.md P1-G1F)登记,两处均为
「按例外处理并写清边界」,不放松其它情形:

- §9 单端口红线 ♢ 例外:仅 `qq-obv11` 渠道的 OneBot **反连(server)模式**可另开
  监听端口,且必须由配置显式给出(`listen_addr`)、**不得默认开启**;其余渠道/模式
  一律不得新开端口。(对应裁决 1.4 / 12.4.1;规格见 design/08 §4、design/13 §0)
- §10 命名条款 ♢ 例外:表名**统一用复数**、以既有迁移为准——原「表名单数」**不再作为
  硬约束**,命名口径以 design/13 / design/16 为准(对应裁决 1.11 / 09.4.2)。
2026-10-04 11:01:12 +08:00
Aska 1a6ea45b9e docs: 强化改动前后推仓库纪律(用户红线,留恢复误操作余地)——每个模块/功能改动前后都 push,绝不攒到阶段末
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
2026-09-07 05:15:54 +08:00
Aska 54f0b75646 docs(AGENTS): 新增 §9.5 学习成熟开源实现/禁止闭门造车铁律
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
已成熟能力/模块必须优先学习并复用现有开源项目业务逻辑(OpenClaw/Claude Code/MCP SDK/
Swarm/CrewAI/OneBot/Miuix 等),严禁凭空推演。每个 design 主题实现前先查开源对照清单
(DevDocs/开源对照清单.md),未对照不得开工。上下文压缩后本铁律强制生效。
2026-09-06 16:07:11 +08:00
Aska 01a4e29f84 docs(api): 新增用户侧跨平台客户端 API 文档(契约+端点登记表);AGENTS 立「随实现更新 API 文档」铁律 2026-09-06 05:32:57 +08:00
Aska 10c0069fa7 feat(logger): WithSource/Scoped 日志来源标注;AGENTS 追加日志标来源+客户端API契约红线 2026-09-06 05:22:00 +08:00
Aska 3da189e856 docs(AGENTS): 追加 §9 全球红线 + §10 代码/流程硬性规范(模块拆多文件/每阶段 push/遇设计冲突阻塞询问) 2026-09-06 05:14:17 +08:00
Aska 1defd46d14 docs(AGENTS): 补充「可并行项交后台子代理、主会话当监工」的上下文保护铁律 2026-09-06 04:17:54 +08:00
Aska 62c7a2aa12 docs: 新增项目级开发铁律 AGENTS.md 2026-09-06 04:12:37 +08:00