开始使用

Serein 是什么

Serein（司睿）是跑在你自己电脑上的 AI 编程助手。你用一句话说需求，它在你的项目目录里读代码、改代码、跑命令和测试、自己验证结果，每一步都摊开在界面上给你看；改坏了可以一键回滚。

它由三部分组成：

• 桌面端（macOS / Windows / Linux）：真正干活的地方，所有文件读写、命令执行都发生在你的电脑上。
• 手机端（Android，iOS 准备中）：连上你的电脑，随时看进度、插话、确认操作或叫停，不需要守在屏幕前。
• sjxi.cn 账号：登录后可直接使用平台提供的模型（不用自己申请 API Key），设置随账号在多台电脑间同步，手机免配对连上电脑。

下载与安装

1. 打开 下载区，页面会自动识别你的系统并把对应安装包排在最前面；某个平台显示「桌面安装包暂未发布」时，可以先按卡片提示安装命令行版。
2. macOS：打开 .dmg，把 Serein 拖进「应用程序」。首次打开如提示「无法验证开发者」，到「系统设置 → 隐私与安全性」点「仍要打开」。
3. Windows：运行 .exe 安装程序；SmartScreen 拦截时点「更多信息 → 仍要运行」。
4. Linux：AppImage 加执行权限后直接运行（chmod +x Serein-*.AppImage）。

安装包自带运行时，不需要另装 Node 或 Python。之后的版本会在后台自动检查并下载，只改动引擎时还会走体积很小的热更新，提示「重启生效」后重启即可。

登录账号

点左下角头像（或「设置 → 通用设置 → 账号」）进入登录：

• 账号密码登录：直接在应用里输入 sjxi.cn 的账号（或邮箱）和密码。密码只用于这一次登录请求，不会保存在电脑上。
• 改用浏览器授权：用 QQ 等第三方方式注册、没有设置密码的账号，点「改用浏览器授权」，在网页上确认后自动回到应用。

登录后左下角会显示头像、昵称、会员等级和模型钱包余额；平台模型会自动出现在模型列表的「账号模型」分组里。

退出登录：头像菜单里点「退出登录」。账号模型会被移除，登录前你自己配置的模型和默认模型会恢复。

第一次对话

1. 选项目目录：新建对话时选择要工作的文件夹。Serein 只在这个目录里读写文件（除非你打开「完全访问」，见 安全与权限）。
2. 选模式：输入框上方切换工作模式（见下一节）。不确定就用 AUTO。
3. 说需求：像对同事说话一样描述，越具体越好，例如「切到华氏度后温度显示不对，帮我修好并补测试」。
4. 看它干活：过程区会显示计划、读了哪些文件、执行了哪些命令、测试结果；完成后底部有「本轮变更」卡片，可逐文件查看改动。
5. 不满意就回滚：本轮变更卡片上点「回滚」，或在「设置 → 检查点回滚」里回到任意一个之前的状态。

新对话的起步页会根据当前项目给出几条建议任务，点一下就能直接开始。

桌面端

五种工作模式

任务运行中也可以继续在输入框里补充要求（插话），它会在下一步立即看到，不需要先停止。

输入框技巧

• @ 引用文件：输入 @ 搜索项目里的文件，引用后它会优先阅读这些文件。
• / 命令与技能：输入 / 打开命令面板，例如 /auto /plan 切模式、/new 新对话、/status 看当前模型/成本/目标/git 状态、/diff 看改动、/compact 压缩上下文、/goal 设定会话目标、/schedule 定时任务；已安装的技能也在这里调用。
• 图片：直接粘贴或拖入截图（报错截图、设计稿）。模型不支持看图时会自动用视觉模型先转述。
• 思考深度：模型名旁边可调「思考」档位，难题调高、简单活调低更快更省。
• 编辑重发：点自己发过的消息可修改后重新发送。

模型：账号模型与自定义模型

点输入框下方的模型名切换模型。列表分两组：

• 账号模型：登录后由 sjxi.cn 下发，按 模型中心 的规则计费、扣每日额度。网站上新上架的模型会自动同步到桌面端（登录时、启动时以及之后每 30 分钟），下架的会自动移除；某个模型的上游渠道临时故障时，名称后会标「暂不可用」，恢复后自动去掉。
• 自定义模型：你在「设置 → 模型与渠道」里用自己的 API Key 添加的模型，费用由你的服务商直接结算，Serein 不经手。

每个模型可以单独设置上下文上限、最大输出、温度和思考能力（「模型与渠道」里编辑模型）。在「Agent 路由」里还可以为推理、写代码、看图等不同角色指定不同模型。

联网搜索同样开箱即用：登录账号后由平台统一提供，不需要申请任何 Key。

更多功能（设置里都能找到）

检查点回滚

每轮改动前自动建检查点，可回到任意一轮之前的状态，包括新建和删除的文件。

项目索引

为项目建立代码索引，让它更快找到相关代码；还会记住在这个项目里验证过的构建/测试命令。

知识库

把文档、规范、接口说明加进来，回答和编码时会自动检索引用。

记忆与画像

记住你的偏好和项目约定（例如「这个项目用 pnpm」），下次不用再说。可随时查看和删除。

技能 Skills

可复用的做事方法（如生成图表、写周报），可从技能商店安装或自己编写，用 /技能名 调用。

MCP 数据源

接入数据库、浏览器、设计稿等外部工具（MCP 协议），内置常用预设，一步接入。

定时任务

让它按时间自动执行任务（如每天早上跑一遍测试并汇报），结果会回到对话里。

后台任务

长时间运行的命令（构建、开发服务器）转到后台，完成后自动唤醒继续。

内置浏览器

做网页时它能自己打开页面、点按钮、看截图来验证效果。

用量统计

按模型、按天查看 tokens 与花费。

外观偏好

深色 / 浅色 / 跟随系统，另有多套图片主题。

手机端

安装手机端

• Android：在 下载区「手机端」 用手机扫码或直接下载安装包（Android 7.0 及以上）。浏览器提示「此类文件可能有害」时选择仍然下载；安装时按提示允许「安装未知应用」。
• iPhone / iPad（iOS 16 及以上）：苹果不允许从网页直接安装应用，iOS 版通过苹果官方渠道提供——
  • App Store：上架后在 下载区「iPhone / iPad」 点「在 App Store 下载」（电脑上可用 iPhone 相机扫码）。
  • TestFlight 公测（上架前的公测版）：先在 App Store 安装苹果官方的「TestFlight」，再在下载区点「通过 TestFlight 安装」或扫码，在 TestFlight 里点「接受」→「安装」。有新版本时 TestFlight 会提示更新。
  下载区还没出现 iOS 按钮时说明仍在上架准备中，可以先用电脑端。

下载卡片上有安装包的 SHA-256 校验值，介意来源时可以核对。

连接你的电脑

手机端有两种连接方式，任选其一：

方式一：登录同一个账号（推荐）

1. 电脑端登录 sjxi.cn 账号；
2. 手机端点「用 Serein 账号登录」，输入同一账号。

不需要扫码、不限网络（公司、家里、4G 都行），同账号下的电脑会自动出现在手机里，多台电脑可在顶部切换。通讯经 sjxi.cn 加密转发，对话内容不在服务器保存。

方式二：扫码配对（不登录账号也能用）

1. 电脑端打开「设置 → 手机远程控制」，开启后点「配对新设备」，屏幕上出现二维码和一次性配对码（几分钟后过期）；
2. 手机端「连接电脑」页点扫码，或者直接用手机相机扫码；扫不了码时点「手动输入」，填电脑地址、端口和配对码。

默认要求手机和电脑在同一个 Wi-Fi 下；电脑上开启「外网访问」后在哪都能连。配对成功后电脑会给这台手机一个独立凭据，在「手机远程控制」的设备列表里可以随时撤销。

在手机上能做什么

• 看进度：会话列表与电脑同步，进入会话能看到实时流出的回答、执行过程和本轮改动的文件。
• 发任务、插话：直接发新需求，或在任务运行中补充要求；可以附上手机里的图片。
• 确认操作：需要你确认的命令或改动会推送到手机，点「允许 / 拒绝」即可，不用回到电脑前。
• 叫停：点停止按钮立即结束当前任务；停止后不会再自动续跑后台任务。
• 看图：回答里引用的电脑本地图片（截图、生成的图表）会经电脑转发到手机显示，点开可全屏查看。
• 新建会话、切换模式：选择电脑上的项目目录新建会话，在输入框切换 CHAT / AUTO 等模式。
• 通知：任务完成、需要确认时推送提醒（可在手机端设置里关闭，或隐藏会话标题）。

账号与额度

换电脑也不用重新配置：设置同步

登录后，「设置 → 通用设置 → 账号同步」会把以下内容随账号带到每台电脑（可按项勾选）：

• 模型列表（你自己添加的模型及其 API Key，加密后上传）
• 偏好配置、外观主题、界面语言
• 用户画像与记忆
• MCP 数据源、联网搜索配置、技能

本机改动约 3 秒后自动上传，其他电脑会收到通知并拉取；也可以点「立即同步」。工作电脑不想带个人模型密钥或画像时，取消对应勾选即可。

额度、免费模型与计费

使用账号模型时按 模型中心 的规则计费，打开它可以看到你的等级、今日额度用量、钱包余额和每次调用明细。

• 等级与套餐：登录用户、普通会员、高级会员、钻石会员各有一套每日额度（每日赠送金额、付费模型次数、免费模型次数、联网搜索次数、每分钟请求数、每日 tokens）。登录用户就有免费体验额度。
• 随时看用量：桌面端输入框右下角的额度（¥）实时显示今天还能用多少，每轮对话结束自动刷新；点开能看每项额度的进度、钱包余额和重置倒计时。手机端在「设置 → Serein 账号」里也能看到。
• 免费模型：标「免费」的模型不扣钱，只计免费次数。
• 付费模型：按实际 tokens 计费（输入、缓存命中、输出分别定价，单位为元 / 百万 tokens），先扣每日赠送额度，用完再扣钱包。
• 每日重置：额度按北京时间每天 0 点重置。

领取更多额度

• 新用户礼金：第一次登录自动发到钱包。
• 兑换码：活动或客服发放的兑换码，在桌面端额度弹层或 模型中心 输入，金额直接进钱包。
• 邀请好友：额度弹层里复制你的邀请码发给好友，好友开始使用后 7 天内填写，双方各得奖励。

常见提示的含义：

安全与隐私

安全与权限

• 只在项目目录里工作：默认只读写当前会话选择的目录，命令在沙箱里执行。
• 高风险操作要你点头：删除文件、推送代码、安装依赖等会弹出确认（手机上也能确认）；勾选「本项目不再询问」后同一条命令以后自动放行。
• 完全访问：输入框里的开关，按会话生效，打开后允许访问项目目录以外的文件、命令不套沙箱（开启前会再确认一次）。处理系统级任务时再开，用完关掉。
• 随时回滚：所有改动都有检查点，改坏了一键回到之前的状态。
• 隐私：代码和对话只在你的电脑上；使用账号模型时，请求内容会经 sjxi.cn 转发给模型服务商，平台只记录用量（tokens、金额、耗时），不保存对话正文。

常见问题

常见问题

还有问题？到 sjxi.cn 留言，或在 Serein 里直接问它「Serein 的 xx 功能怎么用」——它了解自己的功能。