@leviyuan/lodestar 0.1.0 → 2.0.14

package/README.md

@@ -1,10 +1,16 @@
+[English](docs/README-en.md) | 中文
+
 <p align="center">
-  <img src="https://raw.githubusercontent.com/leviyuan/lodestar/main/promo.jpg" alt="夜航星 Lodestar" width="100%">
+  <img src="promo-cn.jpg" alt="夜航星 Lodestar" width="100%">
 </p>
 
-# 夜航星 (Lodestar)
+# 夜航星 (Lodestar) v2
+
+> **DeepSeek TUI 迁移版**
+>
+> 夜航星已从 Claude Code 迁移至 DeepSeek TUI。核心交互逻辑由 Runtime API + SSE 事件流替代了原有的 tmux spawn + JSONL 文件 IPC。飞书群的协作体验保持不变。
 
-**在你最熟悉的飞书群里，开一段不熄灯的 Claude Code 会话。**
+飞书 (Lark) 协作通道，用于 [DeepSeek TUI](https://github.com/deepseek-ai/deepseek-tui) — 在飞书群里和 DeepSeek 协作，会话持久化、多项目并行、7×24 可用。
 
 ## 项目哲学
 
@@ -12,93 +18,96 @@ AI 不是帮手，是倍率。它放大的不是体力，是你——你的直
 
 夜航星让这件事真正发生：在你思考的地方接住想法，在你转身之后继续把它推向终点。一个群，一个项目，一段不熄灯的对话。你醒着它在听，你睡了它还在跑。
 
-## 怎么用
-
-每个飞书群对应一个 Claude 会话。**群名 = `~/` 下的项目目录名**。
-
-- 在群里发任意文字 — Claude 接管这一轮，回复以**流式打字机**实时渲染在一张飞书卡片里。
-- 思考过程、每一次工具调用都在卡片里被收纳为**可展开折叠面板**：折起来是概述，展开是详情。你随时能审阅它在做什么。
-- 需要授权的操作（执行命令、修改文件……）会单独弹一张橙色**权限卡片**，你在群里点 `允许` / `始终允许` / `拒绝` 就行。
-- **图片、文件双向互传**：用户发到群里的图/文件，Claude 通过消息里的 `[file: /abs/path]` 提示就能读；Claude 想把文件发回来，在回复任意位置写 `[[send: /abs/path]]`，标记会被剥离，文件以独立消息出现在群里。出站路径限制在该会话的工作目录、`/tmp/lodestar-*` 与 inbox 之内，`/etc`、`~/.ssh`、`~/.config` 等敏感目录被白名单拒绝。
-- 一轮跑完，卡片合上、可转发；下一句话开新一轮。
-
-### 文本控制指令
-
-直接发这四个**裸词**（不需要斜杠，不区分大小写），daemon 拦截、不转发给 Claude：
-
-| 指令 | 行为 |
-| --- | --- |
-| `hi` | 未运行时启动；运行中弹一张**控制台卡片**（状态行 + 中断/clear/终止/ls 按钮） |
-| `kill` | 优雅关闭 Claude 进程；记住 `sessionId`，下次 `restart` 还能 resume |
-| `restart` | 用上一次的 `sessionId` 重启会话（保留上下文） |
-| `clear` | 杀掉进程并启动一个全新 session（等价于 Claude Code 的 `/clear`） |
-
-> 这四个词被全局保留：在群里发 "hi" 当问候也会触发控制台卡片，不会到 Claude 那边。换来的是手机上单手打字的便利。
+## 核心功能
 
-整个对话在群里、在手机上、在桌面上完整发生。**离开终端，但不离开 Claude Code。**
+- **Markdown 卡片渲染** — 标题、列表、代码块自动转为飞书富文本卡片
+- **实时反馈** — 👌→✅ 表情追踪消息进度，输出流式转发到群里
+- **权限审批卡片** — 一键批准或拒绝，群里点按钮就能远程授权
+- **图片与文件双向传输** — 截图发给 DeepSeek，DeepSeek 也能传文件回来
+- **会话管理** — 发 `hi` 开工，`restart` / `kill` / `clear` 随时管控
+- **邮件通道** — 受控协作入口：白名单准入、预算上限、权限隔离
+- **状态仪表盘** — 赛博朋克风格监控面板，所有会话一目了然
+- **可靠性保障** — WS 指数退避重连、断线自动恢复、7×24 无人值守
 
 ## 安装
 
-### 1. 准备
-
-- 一台能常跑后台进程的机器（自家服务器或闲置主机）
-- [Bun](https://bun.sh) 运行时
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 已登录 Anthropic 账号 (`claude auth login`)
-- 一个飞书自建应用 (`cli_xxx`)，开通：
-  - `im:message:send_as_bot` / `im:message` / `im:chat:readonly` / `im:resource`
-  - `cardkit:card:read` `cardkit:card:write`
-    `cardkit:card.element:read` `cardkit:card.element:write`
-    `cardkit:card.settings:read` `cardkit:card.settings:write`
-
-### 2. 配置
+```bash
+npm i -g @leviyuan/lodestar
+lodestar configure               # 生成 ~/.deepseek/lodestar.toml
+vi ~/.deepseek/lodestar.toml     # 填入飞书凭证
+lodestar daemon                  # 启动
+```
 
-把凭据写到 `~/.config/lodestar/config.toml`：
+配置文件 `~/.deepseek/lodestar.toml`：
 
 ```toml
 [feishu]
-app_id     = "cli_xxxxxxxxxxxxxxxx"
-app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+app_id = "cli_xxxxxxxxxxxxxxxx"
+app_secret = "your_app_secret_here"
 
 [runtime]
-projects_root = "~/"        # 可选，新建群对应的项目目录会落到这里
+port = 7878
+api_token = "your_token_here"
 ```
 
-也支持 `LODESTAR_CONFIG=/abs/path.toml` 或 `XDG_CONFIG_HOME` 覆盖。
-
-### 3. 启动
+前置：`deepseek serve --http` 已运行：
 
 ```bash
-git clone https://github.com/leviyuan/lodestar.git ~/lodestar
-cd ~/lodestar
-bun install
-bun daemon.ts
+DEEPSEEK_RUNTIME_TOKEN=lodestar-runtime-token-v2 deepseek serve --http --port 7878
 ```
 
-把机器人拉进任意飞书群，发一条消息——Claude 就上线了。
-
-> **小贴士**：群名首次出现时，daemon 会自动在 `~/{群名}/` 创建项目目录并 `git init`。换句话说，开新群 = 开新项目。
+## 指令
 
-### 4. 守护进程（可选）
+| 指令 | 作用 |
+|------|------|
+| `hi` | 创建或查看会话状态 |
+| `restart` | 重启会话（fork 保留上下文） |
+| `kill` | 关闭会话（archive） |
+| `clear` | 清空上下文（新建 thread） |
+| `ls [path]` | 查看项目目录树 |
+| 普通消息 | 注入为 turn，DeepSeek 处理后回复 |
 
-要让 daemon 7×24 跑，最简单的方法是配一个 `systemd --user` 单元：
+## CLI 命令
 
-```ini
-[Unit]
-Description=Lodestar daemon
-After=network-online.target
+| 命令 | 作用 |
+|------|------|
+| `lodestar daemon` | 启动守护进程 |
+| `lodestar mcp` | 单独启动 MCP server（调试用） |
+| `lodestar configure` | 生成配置文件 |
+| `lodestar status` | 查看运行状态 |
 
-[Service]
-Type=simple
-ExecStart=/home/USER/.bun/bin/bun /home/USER/lodestar/daemon.ts
-Restart=always
-RestartSec=3
+## 架构
 
-[Install]
-WantedBy=default.target
 ```
+飞书服务器
+    │ WebSocket
+    ▼
+daemon.ts (消息路由进程)
+    │
+    ├── Lark WS Client  (指数退避重连)
+    ├── RuntimeApiClient ────HTTP──┐
+    ├── MessageQueue              │
+    ├── SseEventHandler ←──SSE────┤
+    │                             │
+    │  hi    → POST /v1/threads   │
+    │  restart → fork + archive   │
+    │  kill   → archive           │
+    │  clear  → archive + new     │
+    └─────────────────────────────┼── localhost:7878
+                                  ▼
+                    ┌──────────────────────────┐
+                    │ deepseek serve --http     │
+                    │ Runtime API               │
+                    │                           │
+                    │ 加载 feishu MCP server    │
+                    └──────────────────────────┘
+```
+
+## 仓库
 
-`systemctl --user enable --now lodestar`。
+- **GitHub**: https://github.com/leviyuan/lodestar
+- **npm**: https://www.npmjs.com/package/@leviyuan/lodestar
 
-## 许可
+## 许可证
 
 [MIT](LICENSE)

package/cli.ts

@@ -0,0 +1,176 @@
+#!/usr/bin/env bun
+/**
+ * 夜航星 (Lodestar) CLI — npm 全局命令入口
+ *
+ * 用法:
+ *   lodestar daemon       启动飞书消息路由守护进程
+ *   lodestar mcp           启动 Feishu MCP Server (供 DeepSeek TUI 加载)
+ *   lodestar configure     生成默认配置文件 ~/.deepseek/lodestar/.env
+ *   lodestar status        查看运行状态
+ *   lodestar --help        显示帮助
+ *
+ * npm 全局安装后: npm i -g lodestar
+ */
+
+import { mkdirSync, writeFileSync, existsSync, readFileSync, chmodSync } from 'fs'
+import { homedir } from 'os'
+import { join } from 'path'
+
+const STATE_DIR = join(homedir(), '.deepseek', 'lodestar')
+const CONFIG_FILE = join(homedir(), '.deepseek', 'lodestar.toml')
+
+function printHelp(): void {
+  console.log(`
+夜航星 (Lodestar) v2.0.0 — DeepSeek TUI 飞书群协作通道
+
+用法: lodestar <command>
+
+命令:
+  daemon        启动飞书消息路由守护进程
+  mcp           启动 Feishu MCP Server (供 deepseek serve 加载)
+  configure     生成/更新配置文件 ~/.deepseek/lodestar.toml
+  status        查看运行状态
+
+示例:
+  lodestar configure                     # 首次安装后运行
+  lodestar daemon                        # 启动守护进程
+  lodestar mcp                           # 单独启动 MCP server (调试用)
+
+配置:
+  飞书凭证配置在 ~/.deepseek/lodestar/.env
+  格式: FEISHU_APP_ID=xxx\\nFEISHU_APP_SECRET=xxx
+`.trim())
+}
+
+async function cmdDaemon(): Promise<void> {
+  console.log('启动夜航星守护进程...')
+  try {
+    await import('./daemon.ts')
+  } catch (err) {
+    console.error('daemon 启动失败:', err)
+    process.exit(1)
+  }
+}
+
+async function cmdMcp(): Promise<void> {
+  console.log('启动 Feishu MCP Server...')
+  try {
+    await import('./feishu-mcp.ts')
+  } catch (err) {
+    console.error('MCP server 启动失败:', err)
+    process.exit(1)
+  }
+}
+
+function cmdConfigure(): void {
+  mkdirSync(STATE_DIR, { recursive: true })
+
+  if (!existsSync(CONFIG_FILE)) {
+    const template = [
+      '# 夜航星 (Lodestar) 配置文件',
+      '# 从飞书开发者后台获取凭证: https://open.feishu.cn/app',
+      '',
+      '[feishu]',
+      'app_id = "cli_xxxxxxxxxxxxxxxx"',
+      'app_secret = "your_app_secret_here"',
+      '',
+      '[projects]',
+      '# 项目根目录 (默认 ~/)',
+      'root = "~/"',
+      '',
+      '[runtime]',
+      '# DeepSeek Runtime API 端口 (deepseek serve --http --port)',
+      'port = 7878',
+      'api_token = "your_token_here"',
+      '',
+    ].join('\n')
+    writeFileSync(CONFIG_FILE, template)
+    chmodSync(CONFIG_FILE, 0o600)
+    console.log(`✅ 配置文件已生成: ${CONFIG_FILE}`)
+    console.log('   请编辑此文件填入你的飞书 App ID 和 Secret')
+  } else {
+    console.log(`配置文件已存在: ${CONFIG_FILE}`)
+  }
+
+  // Also ensure other state dirs
+  mkdirSync(join(STATE_DIR, 'inbox'), { recursive: true })
+  mkdirSync(join(STATE_DIR, 'messages'), { recursive: true })
+}
+
+function cmdStatus(): void {
+  console.log('夜航星 运行状态')
+  console.log('────────────────')
+
+  // Check daemon
+  const pidFile = join(STATE_DIR, 'daemon.pid')
+  if (existsSync(pidFile)) {
+    try {
+      const pid = parseInt(readFileSync(pidFile, 'utf8').trim())
+      process.kill(pid, 0) // check if alive
+      console.log(`🟢 daemon  运行中 (PID ${pid})`)
+    } catch {
+      console.log('🔴 daemon  已停止 (stale PID)')
+    }
+  } else {
+    console.log('⚪ daemon  未启动')
+  }
+
+  // Check config
+  if (existsSync(CONFIG_FILE)) {
+    const content = readFileSync(CONFIG_FILE, 'utf8')
+    const hasId = content.includes('app_id = "cli_') && !content.includes('cli_xxxxxxxxxxxxxxxx')
+    const hasSecret = content.includes('app_secret = "') && !content.includes('your_app_secret_here')
+    console.log(hasId && hasSecret ? '🟢 凭证   已配置' : '🟡 凭证   未配置 (运行 lodestar configure 查看)')
+  } else {
+    console.log('🔴 凭证   配置文件不存在 (运行 lodestar configure)')
+  }
+
+  // Check serve
+  try {
+    const resp = require('child_process').execSync('curl -sf http://localhost:7878/health 2>/dev/null', { timeout: 3000 }).toString()
+    if (resp.includes('ok')) console.log('🟢 serve   运行中 (localhost:7878)')
+  } catch {
+    console.log('⚪ serve   未运行 (启动: deepseek serve --http --port 7878)')
+  }
+
+  // MCP config
+  const mcpFile = join(homedir(), '.deepseek', 'mcp.json')
+  if (existsSync(mcpFile)) {
+    try {
+      const mcp = JSON.parse(readFileSync(mcpFile, 'utf8'))
+      if (mcp.feishu) console.log('🟢 MCP     已注册')
+      else console.log('🟡 MCP     未注册 (启动 daemon 自动注入)')
+    } catch {
+      console.log('🟡 MCP     配置解析失败')
+    }
+  } else {
+    console.log('⚪ MCP     未配置')
+  }
+}
+
+// ── Main ──
+const cmd = process.argv[2]
+
+switch (cmd) {
+  case 'daemon':
+    cmdDaemon()
+    break
+  case 'mcp':
+    cmdMcp()
+    break
+  case 'configure':
+    cmdConfigure()
+    break
+  case 'status':
+    cmdStatus()
+    break
+  case '--help':
+  case '-h':
+  case undefined:
+    printHelp()
+    break
+  default:
+    console.error(`未知命令: ${cmd}`)
+    console.error('运行 lodestar --help 查看帮助')
+    process.exit(1)
+}

package/config.ts

@@ -0,0 +1,135 @@
+/**
+ * 夜航星配置加载器 — 从 ~/.deepseek/lodestar.toml 读取配置
+ *
+ * TOML 格式:
+ *   [feishu]
+ *   app_id = "cli_xxx"
+ *   app_secret = "xxx"
+ *
+ *   [projects]
+ *   root = "~/projects"   # 可选，默认 ~/
+ *
+ *   [runtime]
+ *   port = 7878
+ *   api_token = "your_token_here"
+ *
+ *   [email]  # 可选
+ */
+
+import { readFileSync, existsSync } from 'fs'
+import { homedir } from 'os'
+import { join } from 'path'
+
+export interface LodestarConfig {
+  feishu: {
+    app_id: string
+    app_secret: string
+  }
+  projects: {
+    root: string
+  }
+  runtime: {
+    port: number
+    api_token: string
+  }
+  email?: {
+    imap_host?: string
+    imap_port?: number
+    imap_user?: string
+    imap_pass?: string
+    smtp_host?: string
+    smtp_port?: number
+    smtp_user?: string
+    smtp_pass?: string
+  }
+}
+
+const CONFIG_PATH = join(homedir(), '.deepseek', 'lodestar.toml')
+
+function expandTilde(v: string): string {
+  return v.replace(/^~(?=\/|$)/, homedir())
+}
+
+let cached: LodestarConfig | null = null
+
+export function loadConfig(): LodestarConfig {
+  if (cached) return cached
+
+  const defaults: LodestarConfig = {
+    feishu: { app_id: '', app_secret: '' },
+    projects: { root: homedir() },
+    runtime: {
+      port: 7878,
+      api_token: 'your_token_here',
+    },
+  }
+
+  if (!existsSync(CONFIG_PATH)) return defaults
+
+  try {
+    const raw = readFileSync(CONFIG_PATH, 'utf8')
+    const parsed = (Bun as any).TOML.parse(raw) as Record<string, any>
+
+    const config: LodestarConfig = { ...defaults }
+
+    if (parsed.feishu) {
+      config.feishu = {
+        app_id: parsed.feishu.app_id ?? '',
+        app_secret: parsed.feishu.app_secret ?? '',
+      }
+    }
+
+    if (parsed.projects?.root) {
+      config.projects.root = expandTilde(String(parsed.projects.root))
+    }
+
+    if (parsed.runtime) {
+      if (parsed.runtime.port) config.runtime.port = Number(parsed.runtime.port)
+      if (parsed.runtime.api_token) config.runtime.api_token = String(parsed.runtime.api_token)
+    }
+
+    if (parsed.email) {
+      config.email = {
+        imap_host: parsed.email.imap_host,
+        imap_port: parsed.email.imap_port ? Number(parsed.email.imap_port) : undefined,
+        imap_user: parsed.email.imap_user,
+        imap_pass: parsed.email.imap_pass,
+        smtp_host: parsed.email.smtp_host,
+        smtp_port: parsed.email.smtp_port ? Number(parsed.email.smtp_port) : undefined,
+        smtp_user: parsed.email.smtp_user,
+        smtp_pass: parsed.email.smtp_pass,
+      }
+    }
+
+    cached = config
+    return config
+  } catch (err) {
+    console.error('lodestar: failed to parse config:', err)
+    return defaults
+  }
+}
+
+/** Populate process.env from config for backward compat with env-based code. */
+export function populateEnv(): void {
+  const cfg = loadConfig()
+
+  if (cfg.feishu.app_id && !process.env.FEISHU_APP_ID) {
+    process.env.FEISHU_APP_ID = cfg.feishu.app_id
+  }
+  if (cfg.feishu.app_secret && !process.env.FEISHU_APP_SECRET) {
+    process.env.FEISHU_APP_SECRET = cfg.feishu.app_secret
+  }
+  if (cfg.projects.root && !process.env.FEISHU_PROJECTS_ROOT) {
+    process.env.FEISHU_PROJECTS_ROOT = cfg.projects.root
+  }
+  if (cfg.runtime.port && !process.env.DEEPSEEK_API_URL) {
+    process.env.DEEPSEEK_API_URL = `http://localhost:${cfg.runtime.port}`
+  }
+  if (cfg.runtime.api_token && !process.env.DEEPSEEK_API_TOKEN) {
+    process.env.DEEPSEEK_API_TOKEN = cfg.runtime.api_token
+  }
+}
+
+export function getStateDir(): string {
+  return join(homedir(), '.deepseek', 'lodestar')
+}