# 本地接入 DeepSeek / Kimi

先在“账号与团队”查看当前空间 ID。接口密钥只放服务端，不要填入品牌问题、导入文件或提交 Git。

1. 复制项目根目录 `.dev.vars.example` 为 `.dev.vars`。
2. 在 `GEO_MODEL_PROVIDERS` 的 JSON 中填写供应商密钥、账号可用的模型名称和授权空间 ID。可以只保留一个供应商；一个接口可授权多个空间。
3. 重启本地服务。对应空间的“应用与模型”会显示可用接口；未授权空间看不到该接口。
4. 添加观测品牌，保存提问库；在“月度监测”创建本月任务，渠道选择 API，应用勾选 DeepSeek 或 Kimi。
5. 选择任务和接口，确认采集。问题逐题发送，原文、实际模型、采集时间与品牌关联保存；失败项可以单独重试。

密钥需自行向供应商申请。模型名称随供应商与账号权限变化，以控制台为准。参考：[DeepSeek 官方文档](https://api-docs.deepseek.com/)、[Kimi 官方文档](https://platform.kimi.com/docs/api/chat)。

## 采集行为

- 保持月度监测页面打开，离开后不再开始下一题；正在执行的一题可能继续保存。回来可继续队列，已成功的问题不再重复调用。
- 请求异常或超时可重试。供应商可能已处理但本地未收到响应，重试可能再次计费。
- 当前按本月采集；过去月份需导入当时的真实回答，不会把新回答改写成历史数据。
- API 回答与网页/APP 消费端分渠道统计。本版本不抓取消费端、不自动开启供应商联网搜索，也不模拟消费端排名。
- 品牌提及由原文关键词匹配，界面标注为待核实；不自动判断情感。引用只保存接口明确返回的结构化 URL 引用，未返回则为空。
- 没有后台定时调度。没有密钥时可完整使用手工 CSV/JSON 导入流程。

## 品牌与空间

每个品牌有独立的问题库、记录、任务和备份。官网识别使用公开知识库候选，图标来自公开网站图标服务；同名品牌可能需要手动选择或输入官网，图标不代表经过商标权属验证。查询时品牌词会发送给公开知识库，官网域名会发送给图标服务。

本地可创建独立邮箱密码账号。团队成员需先注册，再由空间管理员生成绑定该账号邮箱的一次性邀请码；成员登录后在“账号与团队”加入空间。查看者只能读，编辑者可导入与采集，管理员可管理品牌和成员。各空间权限独立。

账号密码至少 12 位；本地尚无邮箱验证和邮件找回。线上认证、邮件、部署与负载验收留到部署阶段。