ulthon/ulthon_admin
1
0
Fork 0
mirror of https://gitee.com/ulthon/ulthon_admin.git synced 2026-08-30 12:45:32 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,129 Commits 5 Branches 139 Tags
0d20fd77860816f5cff9847679746e352021b4f0
Commit Graph

38 Commits

Author SHA1 Message Date
augushong
af0988118a docs(rules): 新增 project-update-strategy 更新策略规则模板 2026-08-08 19:09:36 +08:00
augushong
a7a80417ef docs(skill): 新增纯拉取模式工作流与更新策略规则机制 2026-08-08 19:09:26 +08:00
augushong
ad96755ff5 docs(permission): 统一校准权限节点措辞，消除更新节点误解 
admin:permission:nodes 是查看型命令（实时扫描注解、不写库、改注解即生效），但文档/注释多处用一键更新/自动更新/生成等动作词描述，导致开发者系统性误以为它是更新权限节点命令。本次校准 8 个文件 10 处误导措辞，并在命令输出末尾追加机制提示。@NodeAnotation 拼写保持不变（框架故意少一个 t）。
 2026-08-08 18:21:25 +08:00
augushong
8faa52ce90 feat(nginx-log): 多节点适配（node_id 全链路 + 全局/按节点聚合 + 节点筛选 + v2.4.0 升级脚本） 
- 6 张表加 node_id 字段 + position/stat 改复合唯一键（migration）
- 6 个 Scheme 同步 node_id 注解 + 唯一键
- Reader 带 node_id 参数 + 懒加载接管（getLastPosition 回退查 node_id=''）
- Aggregator 全局行（node_id=''）+ 按节点循环 insertAggregatesForScope
- Stat 所有查询方法加 where node_id 条件
- Dashboard 控制器/视图加节点筛选下拉框 + AJAX 带 node_id
- AccessLog 列表加节点列 + 采集进度卡片显示节点信息
- import 定时任务 run_type 改 all（每节点采集自己的日志）
- v2.4.0 升级脚本追加 ALTER TABLE（幂等 check-then-alter）
- 菜单调整：去掉 Nginx 顶级菜单 + 读取位置管理，改为系统管理下挂两个子菜单
- ulthon-timer 文档补充 run_type=all 多节点部署注意事项
 2026-08-08 10:33:20 +08:00
augushong
f48e0947cb docs(timer): 技能文档补充 Docker 模式自动启动说明 
新增 Docker 部署章节：server 模式自动启动 timer（nohup + --local --quiet），多节点天然隔离（runtime/node_id.lock 独立）。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-26 09:53:45 +08:00
augushong
1b0be9a29b docs(timer): 定时器动态管控技能文档补充四章节 
新增并发数动态调整、手动触发定向、多节点协调、clamp 有效域钳制四章节，含 12 个示例对照与 4 个坑位说明。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:58:48 +08:00
augushong
8dce4ab48a docs(deploy): 补充多环境 .env 管理约定 
各环境配置文件（.env.test/.env.prod/.env.demo）放在仓库根目录，
部署时流水线将目标文件覆盖为 .env，代码完全一样只有 .env 不同
 2026-07-23 22:22:52 +08:00
augushong
3de1b3c058 docs(deploy): 记录义务补充非默认端口要求 
开发者修改了框架模板默认端口（HTTP 8000/MySQL 13306/Redis 16379 等）
时必须记录，否则智能体调试（如 tools:http:call）会用默认端口连接失败
 2026-07-23 22:07:57 +08:00
augushong
1620af9ff2 refactor(stack): 删除 stack.json，README 改为模板使用指南 
- 删除 source/stack/stack.json（与 README 模式表重复，无实际用途）
- README 新增使用方式说明：可直接用，推荐复制后自定义
  （admin:update 只更新原始模板，不覆盖开发者副本）
- 同步清理 ulthon-deploy-environment.md 和
  ulthon-update-workflow SKILL.md 中对 stack.json 的引用
- ulthon-deploy-environment.md 补充记录义务规则：
  智能体应确认 project-dev-runtime-deploy.md 是否已记录运行方式，
  必须包含命令执行方式（容器内 vs 宿主机）
 2026-07-23 22:01:38 +08:00
augushong
0adc497818 docs(stack): restore docker-dev-sync as independent mode in docs 2026-07-22 22:47:46 +08:00
augushong
560e0f6a5e docs(update-workflow): 以 B 路线检测替代 admin:stack:mode 2026-07-22 01:05:23 +08:00
augushong
9f5ffc34c4 docs(stack): 重写框架规则、stack README 与项目模板提示 2026-07-22 00:56:43 +08:00
augushong
600ee5b085 refactor(agents): 删除 tools:agent:publish 命令，补全 helper.php 函数覆盖机制，修正多处文档 bug 
- 删除 tools:agent:publish 整套（不再兼容多套 IDE，只保留 .agents 目录）
- helper.php 全部 27 个全局函数加 if (!function_exists()) 包裹，项目侧可在 app/common.php 定义同名函数覆盖
- ulthon-file-override-mechanism.md 新增全局函数覆盖章节
- AGENTS.md 删除智能体指导章节，PHP 8+ 改为 8.0+，MySQL 8+ 改为 5.7+
- AGENTS.md 项目结构树补全 tests/、extend/think/、source/ 子项
- README.md PHP 版本统一为 8.0+
- ulthon-base-app-architecture SKILL 路径补 admin/service/ 段
- ulthon-tools-http-call SKILL 补 --page-data 参数
- ulthon-naming-convention 补元数据头
- ulthon-update-workflow 统一 extend/think/ 归类
 2026-07-21 19:35:28 +08:00
augushong
4a4155070d docs(agents): 新增控制器响应陷阱与 sysconfig 机制规则 
- ulthon-controller-response-throw 规则：揭露 success/error/result/redirect 都是 throw HttpResponseException 的陷阱，含两种正确范式（try 外 / 放行 HttpResponseException）与 grep 自查方法
- ulthon-system-config 规则：sysconfig 完整机制（存储/读取/保存/视图扩展），含新增配置项两种方式（加入已有组 / 新建独立 Tab）
- AGENTS.md 索引同步：零散规则表 +2 行，工作流列表 +2 行（含上一 commit 的技能）
 2026-07-19 12:03:22 +08:00
augushong
98dd244e61 docs(agents): 新增后台表格机制与页面验证技能 
- ulthon-admin-table 技能：后台表格完整指南（核心机制/init/cols/内置渲染器/按钮系统/搜索系统/后端配套/常见模式与排错/实测代码引用表），含页面分类标准 A/B/C/D 与项目2 实战经验
- ulthon-page-qa 技能：AI 自测页面验证 6 步 checklist（HTML 冒烟→API→Page Data→浏览器→搜索→分辨率），零项目依赖原则，三模式验证策略
 2026-07-19 12:00:21 +08:00
augushong
e392db007a docs(agents): 落实按主题单一文档原则，合并规则到对应技能 
- AGENTS.md 代码分层铁律精简为入口摘要，链接指向技能详情
- 合并 ulthon-timer-multi-node 规则到 ulthon-timer 技能（多节点协调章节）
- 合并 ulthon-database-design 规则到 ulthon-scheme-definition 技能（含字段约定、组件类型）
- 合并 ulthon-testing 规则到 ulthon-testing 技能（含设计哲学、决策树、测试约束）
- rules-manager 边界原则从规则/技能二分改为按主题单一文档
- AGENTS.md 通用基础规范中表结构规范链接改向技能
- 工作流索引中三个技能描述扩充（明确承载原规则内容）
 2026-07-19 09:07:42 +08:00
augushong
1f91abe9d2 docs(agents): 修正规则与技能文档的索引缺漏、错误引用与表述冲突 
- AGENTS.md 工作流索引：补充 ulthon-update-workflow 与 ulthon-rules-manager，移除不存在的 ulthon-tools-log
- ulthon-naming-convention.md：删除对 ulthon-source-directory.md 的错误引用，明确框架应用目录与控制器子目录命名规范
- ulthon-database-design.md / ulthon-scheme-definition：统一关联表 onlyFileds 键名说明，修正示例字段拼写
- ulthon-scheme-curd-workflow.md：CURD 表名参数表述与参数表对齐
- ulthon-permission-cli.md：章节改写为节点分配原则，去除变更痕迹叙事
- README.md：文档主页 URL 与 AGENTS.md 对齐
 2026-07-19 00:44:41 +08:00
augushong
46f0d62852 docs(rules): 新增文件级覆盖机制规则并修正索引职责互斥 
- 新增 ulthon-file-override-mechanism.md：阐述 app/ 覆盖 extend/base/ 的三类机制（视图模板、include 标签、app_file_path）与不支持覆盖的反例清单
- ulthon-base-app-architecture：升格原孤立描述为独立小节"5. 文件级覆盖机制"
- ulthon-timer：在 app_file_path 覆盖说明处增加规则引用
- AGENTS.md：登记新规则到框架内置规则索引
- ulthon-rules-manager：修订索引职责（AGENTS.md 仅 ulthon-、PROJECT.md 仅 project-，互斥不重复维护）；索引格式从 4 列改为 3 列与项目实际一致；维护规则补充对称约束；泛化"迁移现有内容"章节
 2026-07-19 00:30:05 +08:00
augushong
37cb8291f8 feat(test): 引入测试规则文档与参数化测试库初始化脚本 
对齐 wkbox 衍生项目的测试规则体系，剥离业务特定内容后移植到框架：

- 规则 .agents/rules/ulthon-testing.md（设计哲学/决策树/4层模型/安全规范/fixture原则）
- 技能 .agents/skills/ulthon-testing（运行/编写/模板/决策/回归验证）
- 参数化建库脚本 tests/setup_test_db.{php,ps1,sh} + README
- AGENTS.md 索引补充

与 wkbox 差异：测试库参数化（复用 .env 连接，database=env+'_test'），不硬编码 Docker；删去 canBind Oracle 业务约束与具体 fixture 工厂，业务工厂由衍生项目自行实现。
 2026-07-18 23:56:32 +08:00
augushong
ce8a0c795b docs: 更新 agent 规则并新增项目约束文档 2026-07-18 23:35:04 +08:00
augushong
62a17647e1 docs(timer): 补充定时器技能文档 - execute 日志包裹机制说明与本地开发常见坑位 2026-06-02 23:06:27 +08:00
augushong
76b23d4c70 refactor(timer): 使用 CurlMultiHandler 替代 Workerman，统一为非阻塞模式 
- 删除 runParallel() 方法和所有 Workerman 引用（死代码）
- 重写 runLoop() 为 Guzzle CurlMultiHandler 非阻塞事件循环
- 新增 pending 数组追踪进行中的请求，handler.tick() 非阻塞推进
- 自适应 sleep 策略（有任务 50ms，空闲 200ms）
- 简化 config/timer.php：移除 mode，适配 Guzzle 参数
- 更新 SKILL.md：移除 parallel 描述，修正 --quit 文档 bug
- 验证发现：--quiet 是 ThinkPHP 全局选项，不需要在 configure() 注册
- 验证发现：方法名不能用 run()，与 ThinkPHP Command::run() 签名冲突
 2026-06-02 21:19:53 +08:00
augushong
65e2d35821 docs: 将在线文档规范落地为本地零散规则文件 
- 新增 ulthon-naming-convention.md（命名规范）
- 新增 ulthon-database-design.md（表结构设计规范）
- AGENTS.md 通用基础规范章节改为引用本地规则文件
- 代码风格直接指向项目根目录 .php-cs-fixer.php
 2026-06-01 23:14:41 +08:00
augushong
c5ebf86ad9 refactor(rules): 精简 AGENTS.md，下沉模块级规则，迁移 skill 为 rule 
- tp-controller-url-rules skill 迁移为 rule ulthon-controller-url.md
- AGENTS.md「其他规则」中的 source/ 约定下沉为 ulthon-source-directory.md
- AGENTS.md「其他规则」中的部署栈+命令执行环境下沉为 ulthon-deploy-environment.md
- AGENTS.md 精简：其他规则从 10 条减至 5 条，规则维护机制从 10 行减至 4 行
- ulthon-rules-manager 技能增加 rules/skills 边界判定说明
- rules 定位拓宽：约束、约定、设计决策均可作为 rule
 2026-06-01 21:48:27 +08:00
augushong
4d05a73949 fix(rules): 清理 PROJECT.md 中框架预填内容，恢复为使用者模板 2026-06-01 21:28:30 +08:00
augushong
f867c42a72 feat(rules): 新增零散规则管理机制 
- 新增 .agents/rules/ 目录，存放模块级/场景级独立规则文件
- 新增 ulthon-rules-manager 技能，指导规则的新增/索引/格式
- 新增 ulthon-timer-multi-node 规则文件（从 PROJECT.md 迁移）
- AGENTS.md 新增「零散规则」章节，含框架级规则索引表
- PROJECT.md 新增「规则索引」章节，含全量规则索引表
- 命名约定：ulthon- 前缀为框架内置，project- 前缀为使用者业务
 2026-06-01 21:26:16 +08:00
augushong
1c4f7ac5d5 docs(timer): 技能文档补充 timer.php 配置项说明 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-06-01 20:28:57 +08:00
augushong
5fe6e3df74 docs(timer): 定时器技能新增按时间窗口循环处理的推荐方法 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-06-01 20:20:58 +08:00
augushong
20dc1b944c docs(stack): 命令执行环境描述改为引导查看 stack 命令，不再硬编码模式列表 2026-05-27 21:42:43 +08:00
augushong
3f8f79b445 feat(update): 新增 --keep-repo 参数，dry-run 模式下保留上游克隆目录便于对比 2026-05-26 21:38:16 +08:00
augushong
6dceb028b3 docs(timer): 更新 SKILL.md 和 PROJECT.md 多节点协调文档 
T13: E2E single-node regression - all PASS
T14: E2E multi-node coordination - 7/7 PASS
T15: Document multi-node features in ulthon-timer SKILL.md and PROJECT.md
 2026-05-26 18:33:43 +08:00
augushong
20d0b5f22b docs(skills): 新增 ulthon-update-workflow AI 技能文档 2026-05-25 22:51:17 +08:00
augushong
42b31202c6 docs(skills): 更新方案定义技能文档的编写规范 
- 将“编写建议”标题改为“编写规范”
- 明确时间字段统一使用 int 类型存储 Unix 时间戳
- 说明软删除字段的自动机制
- 调整编号顺序使规范更清晰
 2026-05-06 20:25:34 +08:00
augushong
c7b6865458 docs: 重构智能体规范文档并新增项目业务总览模板 
- 将业务侧增量规则记录从 `.agents/AGENTS.md` 迁移至 `.agents/PROJECT.md` 的「增量规则记录」章节
- 新增 `.agents/PROJECT.md` 作为项目业务总览模板，包含项目定位、核心模块等结构化章节
- 更新根目录 `AGENTS.md` 中的引用与说明，明确 `.agents/PROJECT.md` 的用途
- 为技能文件添加命名约定说明（ulthon- 与 project- 前缀）
 2026-05-06 20:07:51 +08:00
augushong
167dfe110e docs(AGENTS): 更新调试与验证指南并移除冗余技能文档 
- 将调试与验证部分简化为优先使用框架内置命令行工具
- 删除已整合的 CLI 命令参考技能文档，避免信息冗余
 2026-05-06 19:41:23 +08:00
augushong
e44efb33e0 docs(agents): 重构开发流程文档，优化结构并增加详细指引 
- 将 AGENTS.md 中的标准开发流程从步骤列表重构为表格形式，并链接到具体技能文件
- 重写 ulthon-scheme-curd-workflow 技能文档，明确区分首次生成和已有业务代码时的安全重新生成流程
- 新增业务定制、验证交付等详细章节，提供完整的检查清单和命令行验证示例
 2026-05-06 19:25:45 +08:00
augushong
77da693d80 docs(agents): 重构技能文档，合并扩展模式到架构指南 
- 删除独立的 ulthon-core-extend-pattern 技能文档
- 将扩展模式内容整合到 ulthon-base-app-architecture 架构指南
- 简化 AGENTS.md 中的架构说明，移除冗余内容
- 在架构指南中按角色（框架使用者/作者）分章节组织内容
 2026-04-29 21:37:35 +08:00
augushong
8cc08bcb8c feat: 发布智能体版 2026-03-26 20:22:34 +08:00