Lodestar

夜航星 (Lodestar)

AI 不是帮手,是倍率。它放大的不是体力,是你 —— 你的直觉、判断和品味,每一样都被乘以一个你以前不敢想的系数。

夜航星让这件事真正发生:在你思考的地方接住想法,在你转身之后继续推向终点。

---

🚀 用起来

跨平台 (Windows / macOS / Linux),npm 全局安装后由 Node.js 运行,需要 Node.js ≥ 18；Bun 只用于源码开发和发布构建。

🧠 双后端:Claude Code + Codex

夜航星同时接入 Claude Code 和 Codex 两个 agent 后端,**默认 Claude Code**。群里发 `model` 会按“账号 → 动态模型 → effort”选择,结果按群持久化；可用项以当前账号和上游实时返回为准。

使用 GLM Coding Plan 时,夜航星会从端点动态获取模型，并根据真实 turn 观测上下文窗口。`hi` 控制台会展示套餐档位、滚动窗口与月度用量；每条回复的 footer 也会带上当前窗口用量。

**1. 装包**

npm i -g @leviyuan/lodestar

装完得到 5 个命令:

命令	作用
lodestar-setup	首次配置向导
lodestar-daemon	启动 daemon
lodestar-stop	停止 daemon
lodestar-update	升级到最新版(含 Codex CLI、Claude Code 和 Claude SDK)
lodestar-version	查看 Lodestar 和 Codex CLI 版本

**2. 跑向导**

lodestar-setup

手把手带你装 Claude Code、可选配 GLM Coding Plan(1M 上下文)、建飞书应用、启动 lodestar。Codex 是可选第二后端。

Claude 订阅(Pro/Max OAuth 登录)不支持本项目,需走 API 方式(GLM Coding Plan 或自备 Anthropic API key)。

**3. 拉机器人进群**

群名 = `projects_root` 下的目录名(没建会自动建)。发条消息后由当前默认 Claude source 接管；群里发 `model` 可选择其他已配置账号、模型与 effort。

群里发这些**裸词**(不要斜杠,大小写不敏感)可以控 daemon:

指令	行为
hi	未运行时同一张卡动态启动并收束为控制台;运行中弹控制台
stop / st	软打断当前 turn,子进程保活,排队消息打 ❌
kill / kl	用状态卡展示关闭当前 agent 进程,resume id 落盘
restart / rs	进程存活:打断 + 放弃后台任务 + 恢复当前会话;进程已停:列出同一 cwd 的历史会话，选一个在本群创建独立分支
clear / cl	用状态卡展示杀进程并开新 thread(等价 /clear)
compact / cm	主动触发当前 thread 的上下文压缩,完成后状态卡收束
model / md	展示账号→动态模型→effort 面板,按群持久化
task	打开项目任务清单面板,启用飞书任务清单自动化（预览版）

**并发 worktree 群**

在项目主群发:

指令	行为
wt / worktree	列出本项目 work/* 分支状态(clean/dirty/merged/stale),已合并且未挂载的归档分支会折叠隐藏,卡片上可点 删。
wt feature-x / worktree feature-x	创建或加入同级目录/群 [feature-x],分支为 work/feature-x;重新激活已合并归档分支时会先更新到主线。