This file provides guidance to codex when working in this repository.
website项目地址: E:\docs_sphinx_test
- 与用户讨论架构、方案、文档时,默认使用中文。
- 代码注释与标识符风格,默认遵循当前代码文件已有风格。
- 新增代码默认使用驼峰风格命名;只有在需要兼容第三方接口、Python 特定约定或历史 YAML 字段时例外。
- 命名分层原则:内部实现字段、方法、运行态对象默认沿用仓库现有驼峰风格;对外暴露的返回协议、reader 汇总结果、导出 payload 优先使用
snake_case。不要为了导出格式去反推内部实现统一成snake_case。 - 与 codex 相关的草稿、计划、记忆文件,如果将来需要新增,统一放在
.codex/下;但要先确认是否真的需要保留,避免再次堆积历史文档。 - 目前不需要向后兼容,正在开发阶段。
Problem.evaluate的正式返回协议现在是Eval,不是dict。后续如果在触达文件中遇到res['objs']/res['cons']这类旧用法,顺手改成res.objs/res.cons,不需要专门做一次全仓库扫描。problem模块旧 transform 接口不再作为正式接口维护。后续如果在触达文件中扫到旧名字,顺手替换即可,不需要专门做一次全仓库扫描:_transform_unit_X->unit_to_space_transform_to_I_D->apply_var_type_transform_int_var->cast_int_vars_transform_discrete_var->map_discrete_vars