全程在时间线上可观测
思考、工具调用、文件改动都收进一条左侧时间线，AI 每一步在做什么一目了然，不再是看不见的「黑盒一把梭」。
Serein Code CLI · v1.6.9
把 AI 编程，变成
可控的工程流程
面向工程实践的命令行 AI 编程助手。思考、工具调用、文件改动全收进一条左侧时间线， 过程实时可见；多模型、自动执行、多 Agent 并行协作，内置 GB 级知识库与自主学习， 跑在 macOS、Linux、Windows 的终端里。
macOSLinuxWindowsNode.js 18+
shaojiaxi@MacBook-Pro project % serein
· 记忆 官人 · 偏好 2 条 · 摘要 ● Balance deepseek-v4-pro ￥16.97
▌ 当前项目完整度
╭ 当前项目完整度
💭 思考 · high
├ ◇ 概览，读取 .Serein/product/INDEX.md
💭 思考 · high
├ ◇ 检索 **/*-style.css，读取 word/word-ui.js
╰ ✓ 完成 · 12.3s
● 官人，项目已就绪。这是一套纯前端零依赖在线 Office 工具（Word + Excel）。
❯ 输入需求开始…▏
⏵⏵ 交互模式 | idle | …/WebstormProjects/project | 余额 ￥16.97
为什么使用它
把不可控的「AI 一把梭」，变成看得见的工程流程
计划即契约
复杂任务先识别类型、采样证据、形成计划契约，影响文件 / 禁改项 / 验证方式写清楚，证据不足会明确标注，再动手。
多 Agent 并行协作
项目经理 Agent 把大需求拆成互不影响的子任务，并行派发多个 auto 应用，最后统一验收。
多模型管理
支持 DeepSeek、通义千问、GLM、Kimi、豆包、OpenAI 兼容接口等多家渠道，还能给不同角色绑定不同模型。
自动执行 + 自我纠错
定位 → 修改 → 验证 → 纠错全自动推进，安全闸门约束文件边界与高风险操作，越界即拦。
会话可恢复
历史会话用 /resume 继续，复杂任务保留目标、进度与技术方案上下文，断点接着干。
GB 级知识库
把整个目录的资料（PDF / Word / Excel）一键摄入知识库，SQLite FTS5 倒排索引，百万文档块也是毫秒级检索，问一句就能从资料里找到答案。
越用越懂你
从反馈里自主沉淀经验与教训——「好了」记成有效方案、「还是报错」记成勿重复，下次遇到相似问题自动召回，跨项目复用。
看得见运行态
排查跑起来才暴露的 bug：探测进程 / 端口 / 多实例，直接调接口看真实返回，不再对着静态代码瞎猜方向。
读得懂文档
直接读取 Office / PDF / Excel 资料并抽取内容，把零散的需求文档、接口表沉淀成可检索的项目知识。
终端也能看图
回复里的 mermaid 流程图、数学公式直接在终端渲染成可读形式，表格、代码、时序图清清楚楚。
四种模式
从聊天到项目经理并行协作
对话模式
解释、讨论、轻量问答，由 AI 自行判断下一步。
Shift+Tab 切换自动执行
全自动完成任务，覆盖定位、修改、验证与纠错。
Shift+Tab 切换只生成计划
先把复杂需求拆成计划契约，不直接改动项目。
Shift+Tab 切换项目经理并行
可拆分的大任务多 Agent 并行推进，统一验收。
Shift+Tab 切换安装指南
一行命令，安装到本机终端
01
macOS / Linux
打开终端执行一行命令，脚本会下载发行包并注册全局 serein 命令。
curl -fsSL https://sjxi.cn/serein/install.sh | bash02
Windows PowerShell
在 PowerShell 中执行；如遇权限限制，改用管理员 PowerShell。
irm https://sjxi.cn/serein/install.ps1 | iex03
Windows 权限受限
系统阻止脚本时，临时放行当前命令，无需修改全局执行策略。
powershell -ExecutionPolicy Bypass -Command "irm https://sjxi.cn/serein/install.ps1 | iex"
需先装 Node.js 18+（知识库等能力依赖），用 node -v 检查 ——
打开 Node.js 官网 →
首次使用
新开终端，输入 serein
$ serein首次进入会自动引导：选择模型渠道、填写 API Key、选择模型并测试连通。配置完成后直接在终端输入需求即可。
Shift+Tab在 CHAT / AUTO / PLAN / PROMAX 四种模式间切换/resume恢复历史会话，保留目标、进度与方案上下文serein model管理模型渠道与模型名，随时切换
常用命令
记住这些就够开始了
serein 进入交互模式serein "给登录页加个验证码" 直接执行一次性任务或对话serein --auto "重构 X 模块" 使用全自动模式执行任务serein promax "做个博客系统" 使用 ProMax 并行协作模式/plan 美化重构 word 编辑页 只排计划、不执行，确认后再「开始执行」/kb add 把当前目录资料（PDF/Word/Excel）导入知识库/kb search 签字收阅需求 按意思检索知识库里的资料与沉淀的经验serein model 管理模型、渠道与连通性测试serein agents 为 planner / coder / reviewer / chat 绑定不同模型serein setup 重新运行初始化向导疑难解答
安装时最常见的问题
提示 serein 不是内部或外部命令怎么办？
通常是 PATH 没刷新。关闭当前终端重新打开；仍不行可重启系统后再试。
Windows 脚本中文乱码或 UnexpectedToken 怎么办？
优先用 PowerShell 的 irm 安装命令；若执行策略拦截，加 -ExecutionPolicy Bypass 临时放行当前命令。
安装后 serein 仍不可用怎么办？
一般是 PATH 没刷新。关闭终端重新打开；Windows 可再用管理员 PowerShell 跑一次安装命令。
首次启动提示未找到 API Key 怎么办？
运行 serein model add 添加模型，或 serein setup 重新进入初始化向导。