EasyPL-1B

EasyPL-1B 是一个面向 EasyPL（易语言 Easy Programming Language）编程场景的中文代码助手模型

模型目标是根据中文需求生成清晰、简洁、可运行的代码，同时提供必要的中文解释，适合教学示例、语法演示和轻量级编程辅助

Model Details

项目	内容
Model name	EasyPL-1B
Base model	openbmb/MiniCPM5-1B
Dataset	XuehangCang/e_style_code
Language	Chinese
Training method	SFT + LoRA
Task	Text generation / Code generation
License	MIT

Intended Use

EasyPL-1B 主要适用于：

• 根据中文需求生成示例代码
• 解释代码片段的执行逻辑
• 生成函数、字符串处理、循环、条件判断等基础编程示例
• 将结构化题目、自然语言描述整理为代码或中文说明

该模型更偏向编程教学与示例生成，不建议作为通用问答模型或复杂工程自动化模型使用

Coding Style Skill

EasyPL-1B 配套提供 易语言风格 Python 编码规范 SKILL.md，用于说明模型推荐遵循的中文化 Python 编码风格。

该规范覆盖中文函数名和变量名、模块组织、函数设计、中文注释、异常处理、PEP8 格式约束、常用代码模板与质量检查清单。需要了解 EasyPL 风格代码的命名规则、生成边界和示例模板时，可以点击上方链接查看详情文件。

How to Use

from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "XuehangCang/EasyPL-1B"

tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True)
model = AutoModelForCausalLM.from_pretrained(
    model_id,
    torch_dtype="auto",
    device_map="auto",
    trust_remote_code=True,
)

messages = [
    {"role": "user", "content": "生成随机UUID"},
]

inputs = tokenizer.apply_chat_template(
    messages,
    tokenize=True,
    add_generation_prompt=True,
    enable_thinking=False,
    return_tensors="pt",
)
inputs = {key: value.to(model.device) for key, value in inputs.items()}

outputs = model.generate(**inputs, max_new_tokens=2048)
prompt_len = inputs["input_ids"].shape[-1]
print(tokenizer.decode(outputs[0][prompt_len:], skip_special_tokens=True))

如果使用的 transformers 或 tokenizer 版本不支持 enable_thinking 参数，可以移除该参数后再运行

Example Outputs

以下示例均使用模型实际调用生成

生成随机UUID

import uuid

def 生成随机UUID():
    """生成随机UUID"""
    return str(uuid.uuid4())

# 测试
print(生成随机UUID())

判断一个数字是否为偶数，并输出结果

def 取模( 数字, 基数):
    """取模函数，返回 数字 % 基数 结果"""
    return 数字 % 基数

def 取余( 数字, 基数):
    """取余函数，返回 数字 % 基数 结果"""
    return 取模( 数字, 基数)

def 判断偶数( 数字):
    """判断数字是否为偶数"""
    return 取余( 数字, 2) == 0

def 判断奇数( 数字):
    """判断数字是否为奇数"""
    return 取余( 数字, 2) != 0

# 测试
if __name__ == '__main__':
    结果1 = 判断偶数(64)
    print(f"64 是偶数：{结果1}")

    结果2 = 判断奇数(64)
    print(f"64 是奇数：{结果2}")

    结果3 = 判断偶数(7)
    print(f"7 是偶数：{结果3}")

    结果4 = 判断奇数(10)
    print(f"10 是奇数：{结果4}")

    结果5 = 判断偶数(3)
    print(f"3 是偶数：{结果5}")

计算字符串的MD5值

import hashlib

def 计算MD5(数据文本):
    """
    计算字符串的MD5值
    参数:
        数据文本: 需要计算MD5的字符串
    返回:
        MD5值字符串
    """
    md5 = hashlib.md5()
    md5.update(数据文本.encode('utf-8'))
    return md5.hexdigest()

这些输出体现了模型对易语言风格的适配：短中文需求进入，返回带中文函数名、中文注释、测试代码或简要说明的代码片段

Limitations

• EasyPL-1B 是针对中文编程场景微调的模型，通用知识问答能力不是主要优化目标
• 生成代码仍可能出现语法或逻辑错误，建议在实际使用前进行人工检查和运行验证
• 模型能力受训练数据质量、训练样本规模、训练轮数和基座模型能力影响

Citation

如果你使用了本模型，请同时关注并引用相关基座模型与数据集：

• Base model: openbmb/MiniCPM5-1B
• Dataset: XuehangCang/e_style_code

License

This model card is released under the MIT License.