首次运行

本页带你走一遍第一次启动之后的界面。还没有安装的话，先看快速开始。

启动时发生了什么复制锚点链接

hoshimi serve

• 不需要配置文件。 没有 config.json 时，Hoshimi 使用全部默认值：监听 127.0.0.1:10600，不设任何密钥，只启用两个匿名渠道。config.json 在你第一次保存设置、添加账户或执行 hoshimi config set 时才会创建。
• 数据目录。 服务器在数据目录里创建 hoshimi.db（用量、签到记录、探测结果和 Playground 对话）和 server.json（正在运行的服务器的地址和 PID）。数据目录的位置见数据目录，也显示在 设置 › 关于 中。
• 后台定时任务。 凭据续期（每 30 分钟）和每日签到随服务器启动，日志里会各有一行。还会在后台向 PyPI 查询是否有新版本。这三项都可以关闭，见配置。
• 浏览器。 大约一秒后浏览器打开 http://127.0.0.1:10600，地址随即变成 http://127.0.0.1:10600/#/overview。页面地址都在 # 之后，可以直接收藏，例如 #/playground、#/settings?tab=access。

界面布局复制锚点链接

界面语言默认跟随系统（支持英文、简体中文和日文），可以在 设置 › 常规 › 语言 中固定为某一种。主题、主题色、对比度和动画在 设置 › 外观 中调整。这些界面偏好只保存在当前浏览器里，不写入服务器。

登录（设置了工具访问密钥时）复制锚点链接

默认没有任何密钥，打开就能用。概览 页 接口 一栏底部会写着 尚未设置工具访问密钥。

设置了工具访问密钥（server.access_token）之后，浏览器第一次访问时会弹出 请输入工具访问密钥 对话框：

1. 在 工具访问密钥 中输入密钥。
2. 点 登录（或按 Enter）。密钥错误时提示 工具访问密钥不正确。，原来保存的密钥不受影响。

验证通过后，密钥保存在这个浏览器的 localStorage 中，之后不再询问；换一个浏览器或设备需要重新登录。在 设置 › 访问 › 密钥 中修改或清除密钥后，当前浏览器自动更新，其他浏览器需要重新登录。

设置密钥的三种方式：

hoshimi config set server.access_token "换成一个长随机字符串"   # 写入配置，重启后生效
hoshimi serve --access-token "换成一个长随机字符串"              # 只作用于这一次启动

或者在 设置 › 访问 › 密钥 › 工具访问密钥 中保存，立即生效。

工具访问密钥保护 Web UI 和管理接口（/api/v1/*、/docs、/openapi.json）；模型接口 /v1/* 由另一把独立的 模型 API 密钥 保护。Playground 走的是管理接口，所以只需要工具访问密钥。两把密钥的区别和局域网访问见安全。

默认的两个匿名渠道复制锚点链接

不做任何配置，Hoshimi 就启用了两个不需要账户的渠道：

它们在 概览 和 渠道 页显示为 就绪，账户一栏写着 无需账户；打开渠道页会看到提示 此渠道无需账户即可使用；添加账户可获得更多额度。 能用哪些模型、额度多少，取决于上游当时的目录和服务状态，随时可能变化；添加自己的账户后，上游返回的目录也可能不同。

在命令行里确认：

$ hoshimi check
ok: 2 provider(s), 0 account(s) — kilo:0 (keyless), opencode:0 (keyless)
config: /home/you/.local/share/hoshimi/config.json

不需要它们时，在渠道页关闭 已启用 开关，或者：

hoshimi config set providers.kilo.enabled false
hoshimi config set providers.opencode.enabled false

（命令行修改在服务器重启后生效。）两个匿名入口的细节见匿名渠道。

各个页面复制锚点链接

东西在哪里复制锚点链接

接下来复制锚点链接

• 添加第一个自己的账户：渠道。
• 把客户端接到 Hoshimi：接入客户端。
• 不打开浏览器完成同样的事：命令行。