world/skill/SKILL.md

name	description
world	world 模块技能文档——世界定义与管理（根模块，平台入口域）。提供 world 表 CRUD、列表查询接口、创建自动编码，通过 load_world() 挂载。

world 模块

概述

世界定义与管理，是平台的根模块/入口域，无业务依赖，最先开发。依赖 appbase（appcodes 字典）、rbac（权限）。

数据模型

表 world（models/world.json）

字段	类型	说明
id	str(32)	主键
name	str(255)	世界名称
code	str(64)	世界编码（唯一）
description	text	描述
world_type	str(16)	世界类型（appcodes world_type，默认 '0'）
status	str(16)	状态（appcodes world_status，默认 '0'）
config_json	text	世界配置 JSON
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

• 主键：["id"]
• 唯一索引：idx_world_code(code)
• 字典：world_type → appcodes_kv(parentid='world_type')、status → appcodes_kv(parentid='world_status')

关键接口

ServerEnv 注册函数（load_world() 挂载）

• list_worlds(params) → [{value:id, text:name}]
• get_world({id}) → 单条
• create_world(ns) → 自动生成 id/code、写 created_at
• update_world(ns) → 写 updated_at、剔除 _text 后缀
• delete_world({id})

wwwroot/api/*.dspy

• list_worlds.dspy：世界列表（下拉/菜单）
• create_world.dspy：创建
• world_update.dspy：更新
• world_delete.dspy：删除
• get_search_world_type.dspy / get_search_status.dspy：字典下拉

陷阱

• 库名禁止硬编码，统一 ServerEnv().get_module_dbname("world")（.py）/ get_module_dbname("world")（.dspy）
• dspy 无 import（json/get_sor_context/debug 均为预加载全局）
• create_world 必须设置 created_at = curDateString()，否则 sor.C 静默丢记录
• update_world 需剔除 Tabular 传来的 _text 后缀字段
• CRUD json 的 new_data_url 指向自定义 api/create_world.dspy

依赖

• appbase（appcodes 字典）、rbac（权限）