二、核心功能详解

1. AI 小说痕迹检测

对正文片段进行多维规则分析，识别机械写作、模板化表达与 AI 痕迹，输出 AI 倾向分（0–100%） 及各维度证据，帮助作者定位需优化段落。

检测维度与参数说明：

综合与降权：

• AI 倾向分：各维度加权计算（重复、句长、词汇、模板、标点、对白、情绪、语义等），0–100 分，分数越高 AI 痕迹越明显。
• 短文本降权：当 token<80 且句数<5 时，对句长波动、对白比例、情绪密度、标点节奏做降权，避免短文本被过度惩罚。

2. 开篇 6000 字建议

默认分析前 6000 字开篇，输出 开篇完成度、亮点、风险 及可执行修改建议，支持体裁与目标平台设置。

检测维度与参数说明：

输出说明：

• 综合质量评分：0–100，越高开篇完成度越好
• 亮点：得分≥65 的维度
• 风险：得分≤60 的维度
• 建议：基于风险维度的可执行修改建议

3. 封面和简介质量检测

从 读者点击意愿 和 平台规则 两个视角评估封面与简介，输出「会点/不会点」结论、原因及改进建议，支持主流平台（番茄、起点等）。

检测维度与参数说明：

输出说明：

• 综合点击潜力：0–100，由读者视角与平台规则视角加权
• reader_view_score：读者视角评分
• platform_rule_score：平台规则视角评分
• conclusion：明确说明「为什么会点 / 为什么不会点」
• click_reasons / no_click_reasons：会点理由、不会点理由
• red_flags：雷点/槽点列表
• suggestions：修复建议

4. AI 小说润色功能

在保留剧情的前提下，对原创内容进行文笔优化，支持 轻度/中度/强力 三种强度和多种风格目标（如电影感、细腻抒情、凝练有力、悬疑张力）。

参数说明：

输出说明：

• polished_text：润色后完整文本
• summary：本次润色方向说明
• highlights：主要改进点
• applied_mode：llm（模型）或 fallback（规则兜底）
• fallback_reason：若未使用 LLM，说明降级原因（如积分不足、模型未配置等）

三、用户体系与积分说明

• 注册/登录：手机号 + 短信验证码
• 普通用户：可使用全部功能，按次扣积分
• 会员：积分消费享有折扣（默认 0.5，可配置）
• 新用户福利：注册赠送 100 积分，每日登录赠送 10 积分

四、附录：安装与搭建

（以下内容取自 README.md，作为本地运行与服务器部署的快速参考。）

产品介绍（简要）

优雅草·写作中枢 由成都市一颗优雅草科技有限公司出品，专为网文作者、传统写作者及内容创作团队打造。产品整合「AI 痕迹检测」「开篇建议」「AI 润色」「封面与简介评估」四大核心能力。

本地运行与预览

注意：项目根目录没有 package.json，在根目录执行 npm run dev 不会启动任何服务。

方式一：预览已打包前端

1. 安装并启动后端（项目根目录）：

# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux/macOS
python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

1. 打包前端（新终端，项目根目录）：

cd frontend
npm install
npm run build

1. 浏览器访问：http://127.0.0.1:8000/（由 FastAPI 提供静态资源）

方式二：前端开发模式（热更新）

1. 启动后端（终端一）：uvicorn app.main:app --reload --port 8000
2. 启动前端（终端二）：cd frontend && npm install && npm run dev
3. 浏览器访问：http://localhost:5173（Vite 开发服务器）

安装与启动

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

可选（开启 embedding 指标）：

pip install sentence-transformers scikit-learn

管理端

• 路径：admin-frontend/
• 开发：cd admin-frontend && npm install && npm run dev
• 构建：cd admin-frontend && npm run build
• 访问：http://127.0.0.1:8000/admin
• 默认账号：ADMIN_DEFAULT_USERNAME / ADMIN_DEFAULT_PASSWORD，首次登录需修改密码

服务端部署（Ubuntu 示例）

1. 环境：Python 3.10+、Node.js 18+、Nginx
2. 项目目录示例：/var/www/xiezuo-youyacao
3. 后端：创建 venv、安装依赖、配置 .env
4. 前端：frontend 与 admin-frontend 分别 npm run build
5. systemd 服务：运行 uvicorn
6. Nginx：反向代理到 127.0.0.1:8000
7. HTTPS：certbot --nginx -d 你的域名
8. 更多细节见 docs/DEPLOYMENT.md

感谢使用 优雅草·写作中枢，期待您的反馈与建议。

成都市一颗优雅草科技有限公司 | 国家高新技术企业 GR202251001737