文档 · Lunaris

快速开始

登录或注册。打开网页版，用邮箱登录。是否开放注册由管理员决定：可能直接注册、需要审核，或需要邀请。
选一个模型。输入框上方的模型选择器里列出你能用的模型；锁着的模型会标出需要的会员档位。
开始提问。可以直接拖入文件或图片。需要联网、跑代码时，模型会自己调用工具，你也可以在输入框的“＋”菜单里手动开关。

提示　联网搜索、语音、沙箱等能力需要管理员先配置；没配置时对应按钮不会出现。

兑换码

会员和额外用量都通过兑换码开通。登录后打开「设置 → 套餐与账单」，输入兑换码即可。

会员激活码：开通某个会员档位一段时间。
额外用量积分码：给额外用量充值，窗口用满并开启额外用量后才会消耗。
重置卡：立即清空 5 小时与 7 天窗口的已用量。

连续输错多次会被临时锁定一段时间。各档位的区别见会员档位。

开放 API

平台提供 OpenAI 兼容的接口，可以在支持自定义地址的工具、SDK 和脚本里直接使用。调用算你自己的额度，与网页端共用会员档位和用量窗口。

1. 创建 API Key

打开「设置 → API Key」新建一个 Key。创建时可以限定这个 Key 能用哪些模型。Key 只在创建时显示一次，请立即复制保存；不用时可以随时删除。

2. 接口地址

https://你的域名/v1

目前支持 GET /v1/models 与 POST /v1/chat/completions（含流式输出与工具调用）。请求里的 model 填模型列表返回的 id。

3. 调用示例

curl https://你的域名/v1/chat/completions \
  -H "Authorization: Bearer $LUNARIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "模型 id", "messages": [{"role": "user", "content": "你好"}], "stream": true}'

from openai import OpenAI

client = OpenAI(base_url="https://你的域名/v1", api_key="你的 API Key")
r = client.chat.completions.create(
    model="模型 id",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)

常见错误

403 plan.feature_disabled：当前会员档位没有开放 API 权限。
403 model_not_allowed：这个 Key 或当前档位不能使用该模型。
429：请求太频繁、同时生成的数量超过档位上限，或用量窗口已满。

MCP 连接器

MCP 让模型可以调用外部服务提供的工具。打开「设置 → 连接器」添加：

填写名称和地址。远程 MCP 服务器的地址必须是 https；需要鉴权时可以加请求头，请求头会加密保存，不会回显。
测试连接。连接成功后会列出这个服务器提供的工具。
设置权限。每个工具可以单独设成允许、询问或禁止。默认每次调用前都会问你。

管理员也可以把一组连接器和技能打包成插件，你在「设置 → 插件」里一键安装。Windows 客户端还能在本地 Agent 里运行本机的 stdio 类 MCP，见下方本地 Agent。

Skills

Skill 是一份写给模型的操作说明，可以附带脚本、模板和参考资料。格式与 Agent Skills 一致：根目录下有一个带 name 和 description 的 SKILL.md。

---
name: 周报格式
description: 按团队模板整理周报，结论放最前面
---

1. 先写三条最重要的结论。
2. 再按“已完成 / 进行中 / 风险”分组……

在「设置 → 技能」上传 .zip、.skill，或单个带 frontmatter 的 .md 文件。上传时会检查结构。对话里只放技能的名称和描述，模型判断需要时才读取完整内容。

Windows 本地 Agent

Windows 客户端可以让模型操作你电脑上的文件和命令。所有工具都在本机执行，服务端只负责下发和接收结果。

授权文件夹：文件工具只能访问你添加的文件夹；指向文件夹外的符号链接会被拒绝。
三档权限：每个工具可设为允许、询问或禁止。写入、删除、执行命令、打开网页、所有 MCP 工具默认“询问”。
确认框：显示完整命令或文件改动，按回车默认是“拒绝”。删除、下载并执行、关机、修改系统设置这类命令即使设成允许也会每次确认。

数据与隐私

导出：「设置 → 隐私」可以导出你的全部数据（对话、记忆、项目、助手等），得到一个 zip 文件。
记忆：每条记忆都能查看、修改和删除；临时对话不读写记忆、不保存历史。
注销：注销账号会删除账号和你的全部数据，且不可恢复。

平台在安全上的做法见关于 · 安全与隐私。