@raolin2025/claude-code-node 2.2.6 → 2.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raolin2025/claude-code-node",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened, multi-channel notifications",
   "type": "module",
   "main": "src/index.js",

package/src/core/cli.js

@@ -116,14 +116,102 @@ function startSocketServer(engine, session, sessionManager, channelManager, verb
 // Banner & Help
 // ============================================================
 
-const BANNER = `
-╔═══════════════════════════════════════════════╗
-║   AI Code Agent — Node.js Edition            ║
-║   OpenAI-Compatible · DeepSeek Default        ║
-║   Type '/help' for commands                   ║
-║   Type '/exit' or Ctrl+C to quit              ║
-╚═══════════════════════════════════════════════╝
-`.trim()
+// ============================================================
+// Banner & Help
+// ============================================================
+
+// 版本号（从 package.json 读取或手动更新）
+let CC_NODE_VERSION = '2.2.7'
+try {
+  const pkgPath = new URL('../../package.json', import.meta.url)
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+  CC_NODE_VERSION = pkg.version || CC_NODE_VERSION
+} catch {}
+
+// 生成 Claude Code 风格的三栏 Banner
+function buildBanner({ model, permissionMode, session, maxTokens }) {
+  const width = 112
+  const inner = width - 2
+  const leftLabel = ` CC-Node v${CC_NODE_VERSION} `
+  const top = `╭${leftLabel}${'─'.repeat(inner - leftLabel.length)}╮`
+  const bottom = `╰${'─'.repeat(inner)}╯`
+
+  const col1 = 30 // 机器人列
+  const col2 = 42 // 标题列
+  const col3 = inner - col1 - col2 - 2 // 信息列
+
+  // ANSI 颜色
+  const BLUE = '\x1b[34m'
+  const CYAN = '\x1b[36m'
+  const RESET = '\x1b[0m'
+
+  // 原始机器人（宽21）
+  const robotRaw = [
+    '      ╭───────╮      ',
+    '┌───────────────────┐',
+    '│    ██       ██    │',
+    '│                   │',
+    '│      ██████       │',
+    '└───────────────────┘'
+  ]
+
+  // 颜色化：边框蓝，眼睛/嘴巴青
+  const colorize = (line) =>
+    line
+      .replace(/[┌└─╭╮]/g, BLUE + '$&' + RESET)
+      .replace(/[█]/g, CYAN + '$&' + RESET)
+
+  const robotColored = robotRaw.map(colorize)
+
+  // 在 col1 内居中（考虑 ESC 序列不看长度，按可见长度21 计算）
+  const leftPad = 4 // (30 - 21) / 2 = 4.5 => 4 left, 5 right
+  const rightPad = 5
+  const robotLines = robotColored.map(line => ' '.repeat(leftPad) + line + ' '.repeat(rightPad))
+
+  // 标题列（居中）
+  const pad = (s, w, align = 'center') => {
+    if (s.length >= w) return s
+    const sp = w - s.length
+    if (align === 'center') {
+      const l = Math.floor(sp / 2)
+      return ' '.repeat(l) + s + ' '.repeat(sp - l)
+    }
+    return s + ' '.repeat(sp)
+  }
+
+  const titleLines = [
+    pad('AI Code Agent', col2, 'center'),
+    pad('Node.js Edition', col2, 'center'),
+    pad('', col2, 'center'),
+    pad('─'.repeat(col2 - 2), col2, 'center'),
+    pad('/help — commands · /exit — quit', col2, 'center'),
+    pad('', col2, 'center')
+  ]
+
+  // 信息列（右对齐）
+  const sessionId = session?.id || '??????'
+  const infoLines = [
+    pad(`Turns: ${session?.state?.turnCount ?? 0}  •  Tools: 0`, col3, 'right'),
+    pad(`Model: ${model}`, col3, 'right'),
+    pad(`Permission: ${permissionMode}`, col3, 'right'),
+    pad(`Budget: 0 / ${maxTokens ?? 200000}`, col3, 'right'),
+    pad(`Session: ${sessionId?.toString().slice(-6)}`, col3, 'right'),
+    pad('', col3, 'right')
+  ]
+
+  // 构建每行：│ col1 │ col2 │ col3 │
+  const lines = [top]
+  const empty = `│${' '.repeat(inner)}│`
+  lines.push(empty)
+
+  for (let i = 0; i < robotLines.length; i++) {
+    lines.push(`│${robotLines[i]}│${titleLines[i]}│${infoLines[i]}│`)
+  }
+
+  lines.push(empty)
+  lines.push(bottom)
+  return lines.join('\n')
+}
 
 const HELP_TEXT = `
 Commands:
@@ -143,8 +231,43 @@ Commands:
   /allow [tool]  — Allow a tool for the current session (default: all)
   /exit          — Exit (also Ctrl+C)
   /quit          — Same as /exit
+
+  Use "/help <cmd>" for detailed help on a specific command.
 `
 
+const DETAILED_HELP = {
+  help:    "/help [command]\n  Show help. Without argument: list all commands.\n  With a command name: show detailed help for that command.\n\n  Example: /help model",
+
+  model:   "/model <model_name>\n  Switch the LLM model in real-time.\n  The change takes effect immediately for the next message.\n  You can use any model name supported by your current API provider.\n\n  Example: /model deepseek-chat\n  Example: /model gpt-4o",
+
+  models:  "/models\n  Fetch and display all available models from the current API provider.\n  Shows a numbered list, then prompts you to select by number or name.\n  Requires a configured API key (the one you used to start cc-node).\n  Uses the endpoint: <apiBase>/models",
+
+  tools:   "/tools\n  List all available tools that cc-node can use.\n  Shows tool names with their short descriptions.\n\n  Tools include: Bash, Read, Edit, Write, Glob, Grep,\n  WebFetch, WebSearch, AskUserQuestion, GitTool",
+
+  session: "/session\n  Show current session information:\n  - Session ID\n  - Session title\n  - Number of messages\n  - Number of tool call turns",
+
+  sessions:"/sessions\n  List all saved sessions.\n  Shows session ID, title, message count, and last update time.",
+
+  clear:   "/clear\n  Clear the current conversation context.\n  Starts a fresh session. Previous messages are not sent to the API anymore.\n\n  Note: Does not delete saved sessions.",
+
+  config:  "/config [key]\n  Without key: show the entire config as JSON.\n  With a key path: show the value for that specific path.\n\n  Example: /config\n  Example: /config model",
+
+  budget:  "/budget\n  Show token budget usage for the current session.\n  Displays how many tokens have been used vs the limit.",
+
+  channel: "/channel <list|send|test>\n  Manage notification channels.\n\n  Subcommands:\n    list       — List all configured notification channels\n    send <msg> — Send a message via all channels\n    test       — Send a test message to verify channels\n\n  Requires channel environment variables to be set at startup.",
+
+  cost:    "/cost\n  Show API cost report.\n  Displays total tokens used and estimated cost in USD.\n  Supports pricing for: DeepSeek, OpenAI, Qwen, GLM, Kimi.",
+
+  compact: "/compact\n  Manually trigger context compression.\n  Compresses the conversation history to fit within the token budget.\n  Keeps recent turns intact, compresses older ones.\n\n  Typically triggered automatically at 80% budget usage.",
+
+  cd:      "/cd <path>\n  Change the working directory of cc-node.\n  Affects all subsequent tool executions (Bash, Read, Write, etc.).\n\n  Without path: show the current working directory.\n\n  Example: /cd /home/raolin/projects\n  Example: /cd ..",
+
+  allow:   "/allow [tool_name]\n  Allow a tool to execute without confirmation for this session.\n  Without tool name: allows ALL tools.\n\n  Example: /allow\n  Example: /allow Bash",
+
+  exit:    "/exit\n  Exit cc-node. Same as Ctrl+C or /quit.",
+  quit:    "/quit\n  Exit cc-node. Same as Ctrl+C or /exit.",
+}
+
 // ============================================================
 // 参数解析
 // ============================================================
@@ -329,7 +452,7 @@ export async function main() {
   }
   engine.config.readline = rl
 
-  console.log(BANNER)
+  console.log(buildBanner({ model, permissionMode, session, maxTokens: tokenBudget.maxTokens }))
   console.log(`Model: ${model} | Permission: ${permissionMode} | Tools: ${registry.getNames().join(', ')}`)
   console.log(`Socket: ${SOCK_PATH} (cc-notify can connect)`)
   if (channelManager.list().length > 0) {
@@ -352,7 +475,15 @@ export async function main() {
     if (input.startsWith('/')) {
       const [cmd, ...rest] = input.slice(1).split(' ')
       switch (cmd) {
-        case 'help': console.log(HELP_TEXT); break
+        case 'help':
+          if (rest[0]) {
+            const detail = DETAILED_HELP[rest[0].toLowerCase()]
+            if (detail) console.log(detail)
+            else console.log(`No detailed help for /${rest[0]}. Type /help for all commands.`)
+          } else {
+            console.log(HELP_TEXT)
+          }
+          break
         case 'model':
           if (rest[0]) { engine.config.model = rest.join(' '); console.log(`Model → ${engine.config.model}`) }
           else console.log(`Model: ${engine.config.model}`)