云边协同科研写作

本 skill 位于提交文件夹根目录，作为赛方评审入口。真实功能由源码目录直接实现，skill 不重新生成项目。

自动启动

在提交文件夹根目录运行：

powershell -ExecutionPolicy Bypass -File test-skill-validation\scripts\start-source.ps1

该脚本会自动启动源码工程：

• EDGE/main_npu.py：边端 OpenVINO 本地推理服务。
• EDGE/aithesis：边端 Vue 前端。
• clean_src/src/app.py：云端 RAG/科研写作 Gradio 服务。

默认端口：

• 边端本地模型 API：http://localhost:5000
• 边端前端：http://localhost:5173
• 云端 RAG UI：http://localhost:7007

本地模型配置

默认模型目录如下。如果模型放在这里，就不需要额外配置模型地址：

EDGE/models/Qwen3-8b-ov-npu
EDGE/models/HY-MT1.5-1.8B-int4-ov

每个模型目录应包含 OpenVINO 导出的模型文件，例如 openvino_model.xml、.bin 权重文件、tokenizer 文件和 generation config 等。

如果模型放在其他磁盘或目录，通过环境变量指定：

$env:PAPERAGENTS_EDGE_GENERAL_MODEL_DIR = "D:\models\Qwen3-8b-ov-npu"
$env:PAPERAGENTS_EDGE_TRANSLATE_MODEL_DIR = "D:\models\HY-MT1.5-1.8B-int4-ov"
$env:PAPERAGENTS_EDGE_GENERAL_DEVICE = "NPU"
$env:PAPERAGENTS_EDGE_TRANSLATE_DEVICE = "CPU"

API Key 配置

交付物已脱敏，不包含真实 API key 或 token。评审或部署者需要自行配置：

$env:LLM_API_KEY = "自己的 DeepSeek 或兼容 OpenAI API Key"
$env:MINERU_API_TOKEN = "自己的 MinerU Token，可选"

验证命令

curl http://localhost:5000/api/health
curl http://localhost:5000/api/stats

curl -X POST http://localhost:5000/api/grammar-check-stream `
  -F "text_content=She go to school every day."

curl -X POST http://localhost:5000/api/polish-stream `
  -F "text_content=This paper give a method which is good."

curl -X POST http://localhost:5000/api/translate-stream `
  -F "text_content=This study investigates edge intelligence."

交付重点

• 云端 DeepSeek/RAG 可以保留为远端大脑。
• 语法检查、规范润色、智能翻译是本地工具任务。
• Qwen3 默认跑在 NPU，用于语法检查和润色。
• HY-MT1.5 默认跑在 CPU，用于翻译。
• 边端服务是常驻进程，模型加载后保留在内存中，不会每次请求重新加载。