卢克里奥·麦克普
Docs解雇了Luxriot EVO助理（EVO 1.32）。
快速入门
- 摄入文档（写入
datastore/evo_1_32/):
python3 -m venv .venv
. .venv/bin/activate
pip install -r backend/requirements.txt
python3 backend/cli/ingest_evo_1_32.py --docs-dir docs --out-dir datastore/evo_1_32- 运行后端（FastAPI）：
uvicorn backend.app.main:app --reload --port 8000- 打开
http://localhost:8000/在您的浏览器中。
要在局域网上服务，请运行：
uvicorn backend.app.main:app --host 0.0.0.0 --reload --port 8000版本控制
- 应用程序版本存储在
VERSION（默认格式：Luxriot SA 0.x.y). - 发布说明live in
CHANGELOG.md. /health现在回来了app_version因此UI可以显示它。- 您可以用以下命令覆盖版本
LUXRIOT_APP_VERSION.
从UI重新索引
打开 Administrator tools → Docs 然后单击 RE-INDEX 重建 datastore/evo_1_32/ 从“文档”文件夹中。 使用 REFRESH 从当前数据存储中重新索引（仅包含已摄入的文档+已发布的编辑）。
笔记：
- 如果嵌入摄取不稳定（LM Studio返回
400 {"error":"Model has unloaded or crashed.."})，较低Emb max chars（试试看448或384)和/或更低Emb batch（试试看4).
流媒体聊天（SSE）
POST /chat/stream流服务器状态+模型输出增量（SSE超过fetch).- UI默认使用流式传输，并回退到
POST /chat如果流媒体不可用。 - 流式传输时，UI显示
STOP取消生成的按钮（在聊天中保留部分输出；服务器端不保存助手消息）。
网络抓取（可选）
在 Administrator tools → Web，启用web工具，然后：
- 在聊天中粘贴URL（例如。
fetch https://www.luxriot.com/)获取+总结它。 - 使用
search:/web:在上下文中包含DuckDuckGo HTML搜索结果。 - 当使用Web上下文时，UI在答案下显示“Web源”部分。
身份验证和角色
- 违约：
anonymous（文档阅读器+聊天；没有聊天记录）。 - Bootstrap管理员：如果数据库没有用户
admin用户在启动时创建。集LUXRIOT_ADMIN_USERNAME/LUXRIOT_ADMIN_PASSWORD控制凭证；否则，将生成密码并将其打印到服务器日志中。 - 重置/创建管理员而不删除DB:set
LUXRIOT_ADMIN_PASSWORD_RESET=1和LUXRIOT_ADMIN_PASSWORD=...一次重启。 - 角色：
admin（完全访问），redactor（编解码器+调试+历史记录），support（调试+历史），client（历史），anonymous（无历史记录）。 - 登录支持用户名或电子邮件。
- 基于角色的系统提示可在中编辑
Administrator tools → System prompt并且按登录的用户角色应用。
文档编辑器（alpha）
- 打开
Documentation→ 选择一个页面→ 单击铅笔图标进入编辑模式。 - 访问是基于权限的：
docs_edit允许编辑，docs_publish允许发布。管理员可以为每个用户切换这些选项。 - 如果用户有
docs_edit但不是docs_publish，他们可以提交发布请求以供管理员批准。 - 在编辑模式下上传截图（图像按钮）以存储在
datastore//assets/user/....
身份验证端点：
POST /auth/login,POST /auth/logout,GET /auth/me- 管理员：
GET/POST/PATCH /auth/users（支持disabled: true/false),POST /auth/users/{id}/password/reset - 自我：
POST /auth/password/change - 发布请求：
GET /admin/publish-requests,POST /docs/page/{doc_id}/{page_id}/publish/request,POST /admin/publish-requests/{doc_id}/{page_id}/approve|reject
环境变量
LMSTUDIO_BASE_URL（默认值http://localhost:1234)LMSTUDIO_MODEL（可选；未设置时自动检测）LUXRIOT_APP_VERSION（覆盖VERSION)LUXRIOT_DOCS_VERSION（默认值evo_1_32)LUXRIOT_APP_DB_PATH（默认值backend/data/app.sqlite)
MCP服务器
看 mcp-server/README.md 和 mcp-server/mcp.sample.json.