专为终端工程师打造的
原生双核 AI 编程智能体

# 1. 快速上手 (Getting Started)

LingXiAgent 可以在 macOS（Apple Silicon M系列及 Intel 芯片）和主流 Linux 发行版上原生运行。安装只需一条命令，即可完成环境探测、可执行文件安装与 Shell 变量配置。

步骤一：一键自动安装

步骤二：刷新终端并首次启动

# 2. 终端 TUI 使用指南 (TUI Usage)

LingXiAgent 具备业界领先的 60FPS 原生终端界面，采用双栏式布局，支持思考流折叠、代码 Patch 高亮审查与键盘一键导航。

常用快捷键

Slash 快捷命令

• /model — 唤起模型选择弹窗，支持在官方订阅模型与自定义 API 模型间毫秒切换。
• /auth — 查看已登录账号状态、额度及重新登录。
• /clear — 清理当前会话上下文并保留核心项目知识库。
• /cost — 查看本次会话的 Token 消耗、缓存命中率及累计费用预估。

常用 CLI 实用子命令

# 3. 提供商与认证体系 (Providers & Auth)

LingXiAgent 确立了“官方内置渠道与自定义渠道物理隔离”的核心架构。内置渠道无需也不允许写入用户配置文件，确保升级平滑无污染。

官方订阅登录命令 (OAuth 认证)

自定义 API 提供商配置 (~/.lingxiagent/providers.json)

若想接入 DeepSeek、硅基流动、Ollama 等第三方 API，在配置文件中添加即可：

{
  "version": "1.0",
  "providers": [
    {
      "id": "deepseek",
      "name": "DeepSeek 官方",
      "options": {
        "baseURL": "https://api.deepseek.com/v1",
        "apiKey": "sk-your-deepseek-api-key"
      },
      "models": [
        { "id": "deepseek-chat", "name": "DeepSeek V3" },
        { "id": "deepseek-reasoner", "name": "DeepSeek R1" }
      ]
    }
  ]
}

# 4. 反检测伪装与客户端指纹 (Client Fingerprint)

针对 Cloudflare、Akamai、DataDome 等企业级防爬与人机验证系统，LingXiAgent 内置了独有的动态宿主感知防封机制。

动态出站指纹一览

# 5. 扩展能力与 MCP 协议 (Extensions & MCP)

LingXiAgent 具备完整的 Model Context Protocol (MCP) 支持，可以一键连接数据库、浏览器自动化、文档分析及各类自定义微服务。

配置文件 (~/.lingxiagent/mcp.json)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/lingxifox/Projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
    }
  }
}

# 6. 常见问题与排错 (Troubleshooting)