一个可本地运行的 自进化 humanizer agent:把长英文按语义切块,生成多种风格候选句,接收用户选择与反馈,并通过在线权重更新持续改进输出。
当前发布流程默认面向 macOS + Apple Silicon,请先在本机安装
mlxcel-server,再按下方步骤初始化。
- 自进化闭环:用户选择/反馈 -> 在线样本 -> 快慢轨训练 -> 8082 热切换新权重
- 双层输出防护:本地 TinyLlama 生成 + DeepSeek 语义校对,减少无关信息和提示词污染
- 前端可见:
Styled与Fallback卡片有不同背景色,结果来源一眼可见 - 本地优先:FastAPI + Next.js +
mlxcel-server,适合 Apple Silicon 本机运行
- 完整前后端源码
- 训练 / 评测 / 自进化脚本
- 安全的
.env.example - 空的
data/目录占位
仓库 不包含:
.env、API key、本地数据库、日志- 上传过的源文档、训练集、评测结果
- 基座模型权重
- 本地工作区私有文件
git clone https://github.com/kevin0818-lxd/humanizer-self-evolution.git
cd humanizer-self-evolution确认以下命令可用:
mlxcel-server --help如果你的二进制不在默认 PATH,也可以稍后在 .env 里设置:
MLXCEL_SERVER_BIN=/absolute/path/to/mlxcel-serverhuggingface-cli download TinyLlama/TinyLlama-1.1B-Chat-v1.0 \
--local-dir data/models/tinyllama-1.1b-chat-v1.0从本仓库的 GitHub Releases 下载最新 asset:
humanizer-self-evolution-adapter-online-policy-v2-20260805.zip
./scripts/setup_public.sh --adapter-zip /path/to/humanizer-self-evolution-adapter-online-policy-v2-20260805.zip这个脚本会:
- 创建运行目录
- 复制
.env.example为.env - 解压 Release 里的 adapter 到
data/models/tinyllama-1.1b-online-policy-v2-20260805 - 安装后端与前端依赖
./scripts/start_public.sh启动后默认会拉起:
8081:质询者 / critic8082:当前在线权重代理8083:生成实例8000:FastAPI3000:Next.js
打开:
默认配置已经能跑起来,通常只需要改一项:
DEEPSEEK_API_KEY=- 留空:系统仍可运行,但不会启用 DeepSeek 语义校对层
- 填入有效 key:会额外清洗无关信息、提示词回显和闲聊开场
如需固定 8081 的 critic 权重,可以在 .env 中设置:
CRITIC_ADAPTER_PATH=/path/to/another/adapter留空时,启动脚本默认复用当前公开 adapter。
前端里最直观的三个信号:
- 卡片颜色:
Styled是青绿色,Fallback是琥珀色虚线 - 生成模式徽章:悬停可看到完整
generation_mode - 重复生成后的变化:随着反馈积累,
Fallback变少、Styled变多、语义污染减少
# 仅初始化环境,不安装依赖
./scripts/setup_public.sh --adapter-zip /path/to/adapter.zip --skip-install
# 自动下载基座模型(需要 huggingface-cli)
./scripts/setup_public.sh --download-base-model --adapter-zip /path/to/adapter.zip代码仓库只放源码;当前可运行 adapter 放在 Release。
建议发布物至少包含:
humanizer-self-evolution-adapter-online-policy-v2-20260805.zip
zip 内建议保留以下文件:
adapter_model.safetensorsadapter_config.jsontraining_manifest.jsontokenizer.jsontokenizer.modeltokenizer_config.jsonspecial_tokens_map.jsonchat_template.jinja
本项目沿用仓库内的 LICENSE。