Commit Graph

2 Commits (5c433ea20e9b7871c12f9319db707d9769472b09)

Author SHA1 Message Date
Council 5c433ea20e docs: 新增插件静态文件引用规范 + 经验条目18($public_host最佳实践)
- EXPERIENCES.md: 新增第18条(P2)— 插件模板静态文件引用规范
  - 根因一:cdn.jsdelivr.net 大陆阻断
  - 根因二:$public_host 在插件视图不可用
  - 规范:控制器显式传递 public_host,模板用 {{}}
  - 优先级:本地文件 > 国内CDN > 国际CDN
- EXPERIENCES.md: 检查清单新增2项(本地文件优先 + $public_host 显式传递)
- DEVELOPMENT_GUIDELINES.md: 新增第8条 — 插件模板静态文件引用规范(完整代码示例)
- README.md: 实现参考新增 DEVELOPMENT_GUIDELINES.md(置顶)
2026-04-25 08:55:00 +08:00
Council 068c673dd0 docs: add DEVELOPMENT_GUIDELINES for agent behavior constraints
定义 ShopXO 核心文件修改边界、铁律和 pre-commit 自检要求:

铁律:
- 禁止修改 ShopXO 核心文件(shopxo/app/、shopxo/config/ 等),
  除非用户明确书面同意
- 禁止直接操作数据库,必须以 migration 文件形式提交
- 禁止直接操作 Docker 容器内环境

实践:
- 调试代码(var_dump/bak文件/log注入)必须立即清理
- pre-commit 自检清单
- Council/subagent commit 必须约束在 feat/ 分支内
- 配置文件隔离原则

并记录已知 ShopXO 核心文件状态:common.php/event.php 已回退干净,
Goods.php/AdminPowerService.php 有业务必需改动。

关联历史教训:2026-04-23 antigravity 失控导致调试代码污染核心文件
2026-04-24 00:24:47 +08:00