@xagent-ai/cli 1.0.1

package/README_CN.md

@@ -0,0 +1,280 @@
+# 🤖 xAgent CLI - 你的自主生活智能助手
+
+<div align="center">
+
+![许可](https://img.shields.io/badge/License-MIT-yellow?style=flat-square&logo=opensourceinitiative)
+![Node.js](https://img.shields.io/node/v/%40xagent-ai%2Fcli?logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?style=flat-square&logo=typescript)
+![版本](https://img.shields.io/npm/v/%40xagent-ai%2Fcli?logo=npm)
+![下载量](https://img.shields.io/npm/dt/%40xagent-ai%2Fcli)
+
+</div>
+
+<div align="center">
+
+![xAgent CLI 截图](./assets/xagent-cli.png)
+
+**[English](README.md)** | **[中文](README_CN.md)**
+
+</div>
+
+---
+
+<div align="center">
+
+### 🚀 AI 助手的未来已经到来
+
+**xAgent CLI** 不仅仅是一个 AI 编程助手 — 它是一个**面向个人 PC 和自主生活的智能代理**，彻底改变你与数字生活的互动方式。
+
+</div>
+
+---
+
+## ✨ 为什么选择 xAgent CLI?
+
+| 🎯 | 全能 AI 助手 |
+|------|------------------------|
+| 🏠 | **生活自动化** - 从文件整理到智能日程管理 |
+| 💻 | **专业开发** - 代码编写、调试、部署一体化 |
+| 🌐 | **多模型支持** - 免费使用 Kimi K2、Qwen3 Coder、DeepSeek v3 |
+| 🔧 | **GUI 自动化** - 精确的鼠标键盘控制 |
+| 🔒 | **灵活安全** - 5 种执行模式，从 YOLO 到 DEFAULT |
+
+---
+
+## ⚡ 快速开始
+
+```bash
+# 安装
+npm i -g xagent-cli
+
+# 启动
+xagent
+```
+
+**就这么简单！** 几秒钟内开始自动化你的数字生活。
+
+---
+
+## 📊 功能对比
+
+| 功能特性 | xAgent CLI | Claude Code | Gemini CLI |
+|:--------|:----------:|:-----------:|:----------:|
+| **生活自动化** | ✅ | ❌ | ❌ |
+| **PC 智能管理** | ✅ | ❌ | ❌ |
+| Todo 任务规划 | ✅ | ✅ | ❌ |
+| SubAgent 系统 | ✅ | ✅ | ❌ |
+| 计划模式 | ✅ | ✅ | ❌ |
+| 任务工具集 | ✅ | ✅ | ❌ |
+| 对话历史恢复 | ✅ | ✅ | ❌ |
+| 上下文自动压缩 | ✅ | ✅ | ✅ |
+| 网络搜索 | ✅ | ❌ | ⚠️ |
+| 思考模式 | ✅ | ✅ | ❌ |
+| 工作流系统 | ✅ | ❌ | ❌ |
+
+---
+
+## 🎯 xAgent 能做什么？
+
+### 🏠 生活助手
+```text
+> 整理桌面，按类型自动分类
+> 设置每日云端备份
+> 下午3点提醒开会
+> 找出占用磁盘空间的大文件
+```
+
+### 💼 效率办公
+```text
+> 批量重命名文件（日期格式）
+> 下载网页所有 PDF
+> 分析 Excel 数据，生成图表
+> 翻译文档，保留原格式
+```
+
+### 👨‍💻 开发助手
+```text
+> 分析项目架构
+> 找出并修复 bug
+> 创建带认证的 RESTful API
+> 自动审查 PR
+```
+
+### 🔄 自动化专家
+```text
+> 下载股票行情，发送邮件提醒
+> 自动更新项目依赖
+> 监控网站，宕机时告警
+```
+
+---
+
+## 🛠️ 执行模式
+
+| 模式 | 权限 | 适用场景 |
+|------|-------------|----------|
+| 🟢 **YOLO** | 完全控制 | AI 完全自主 |
+| 🟡 **ACCEPT_EDITS** | 仅文件 | 安全编码 |
+| 🔵 **PLAN** | 先计划后执行 | 复杂任务 |
+| ⚪ **DEFAULT** | 需授权确认 | 安全优先 |
+| 🟣 **SMART** | 智能模式 | 日常使用（推荐） |
+
+---
+
+## 🔑 免费使用
+
+xAgent 提供**完全免费**的多种认证方式：
+
+| 方式 | 说明 |
+|--------|-------------|
+| 🔐 **xAgent 账号** | 浏览器登录（推荐） |
+| 🔑 **API Key** | 服务器环境 |
+| 🌐 **第三方 API** | GLM-4、DeepSeek、通义千问、月之暗面等 |
+
+---
+
+## 🏗️ 技术栈
+
+<div align="center">
+
+![Node.js](https://img.shields.io/badge/Node.js-22+-green?style=for-the-badge&logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue?style=for-the-badge&logo=typescript)
+![React](https://img.shields.io/badge/React-Ink-purple?style=for-the-badge&logo=react)
+![esbuild](https://img.shields.io/badge/esbuild-orange?style=for-the-badge)
+![Vitest](https://img.shields.io/badge/Vitest-测试?style=for-the-badge&logo=vitest)
+
+</div>
+
+---
+
+## 📦 项目结构
+
+```
+@xagent-ai/cli/
+├── src/
+│   ├── tools/              # 12+ 内置工具
+│   ├── agents/             # SubAgent 系统
+│   ├── gui-subagent/       # GUI 自动化
+│   ├── workflow/           # 工作流引擎
+│   ├── checkpoint/         # 状态持久化
+│   └── mcp/                # MCP 集成
+├── dist/                   # 编译输出
+├── docs/                   # 文档
+├── test/                   # 测试套件
+└── package.json
+```
+
+---
+
+## 🧪 测试与质量
+
+```bash
+npm test          # 单元测试
+npm run lint      # ESLint
+npm run format    # Prettier
+npm run typecheck # TypeScript
+```
+
+---
+
+## ⚙️ 配置说明
+
+通过编辑 `~/.xagent/settings.json` 自定义 xAgent：
+
+```json
+{
+  "theme": "Default",
+  "selectedAuthType": "openai_compatible",
+  "apiKey": "your-api-key",
+  "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
+  "modelName": "glm-4.7",
+  "guiSubagentModel": "doubao-1-5-ui-tars-250428",
+  "guiSubagentBaseUrl": "https://ark.cn-beijing.volces.com/api/v3",
+  "guiSubagentApiKey": "your-api-key",
+  "searchApiKey": "",
+  "executionMode": "smart",
+  "approvalMode": "smart",
+  "checkpointing": {
+    "enabled": false,
+    "autoCreate": true,
+    "maxCheckpoints": 10
+  },
+  "thinking": {
+    "enabled": true,
+    "mode": "normal",
+    "displayMode": "compact"
+  },
+  "contextCompression": {
+    "enabled": true,
+    "maxMessages": 30,
+    "maxContextSize": 1500000,
+    "preserveRecentMessages": 0,
+    "enableSummary": true
+  },
+  "contextFileName": "XAGENT.md",
+  "mcpServers": {},
+  "language": "zh",
+  "autoUpdate": true,
+  "telemetryEnabled": true,
+  "showToolDetails": false,
+  "showAIDebugInfo": false,
+  "loggerLevel": "info",
+  "contextCompress": {
+    "enabled": false,
+    "autoTrigger": false,
+    "messageThreshold": 50,
+    "tokenThreshold": 100000,
+    "strategy": "summary",
+    "preserveRecent": 5
+  },
+  "type": "openai_compatible"
+}
+```
+
+---
+
+## 📚 文档
+
+- 📖 [架构设计](docs/architecture/overview.md)
+- 🔧 [工具系统](docs/architecture/tool-system-design.md)
+- 🔌 [SKILL, Worflow和MCP 集成](docs/architecture/mcp-integration-guide.md)
+- 💻 [CLI 命令](docs/cli/commands.md)
+- 🤝 [贡献指南](CONTRIBUTING.md)
+- 🔑 [第三方模型](docs/third-party-models.md)
+
+---
+
+## 🤝 贡献
+
+欢迎贡献代码！参与方式：
+
+1. 🍴 Fork 本仓库
+2. 🌿 创建特性分支
+3. ✅ 确保测试通过
+4. 📝 提交 PR
+
+---
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](./LICENSE)
+
+---
+
+## 🙏 致谢
+
+<div align="center">
+
+❤️ 基于 [Ink](https://github.com/vadimdemedes/ink) 构建 • 由 [xAgent 平台](https://platform.xagent.cn/) 支持
+
+</div>
+
+---
+
+<div align="center">
+
+### 🌟 给我们点个 Star！
+
+**用 AI 点亮你的数字生活**
+
+</div>

package/dist/agents.d.ts

@@ -0,0 +1,21 @@
+import { AgentConfig, ExecutionMode } from './types.js';
+export declare class AgentManager {
+    private agents;
+    private globalAgentsPath;
+    private projectAgentsPath;
+    constructor(projectRoot?: string);
+    loadAgents(): Promise<void>;
+    private loadAgentsFromDirectory;
+    private applyJsonAgentConfig;
+    private parseAgentConfig;
+    getAgent(agentType: string): AgentConfig | undefined;
+    getAllAgents(): AgentConfig[];
+    addAgent(agent: AgentConfig, scope?: 'global' | 'project'): Promise<void>;
+    private formatAgentConfig;
+    removeAgent(agentType: string, scope?: 'global' | 'project'): Promise<void>;
+    getAvailableToolsForAgent(agent: AgentConfig, executionMode: ExecutionMode): string[];
+    getAvailableMcpsForAgent(agent: AgentConfig): string[];
+}
+export declare function getAgentManager(projectRoot?: string): AgentManager;
+export declare const DEFAULT_AGENTS: AgentConfig[];
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,WAAW,CAAC,EAAE,MAAM;IAO1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAanB,uBAAuB;IA2BrC,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,gBAAgB;IA8CxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIpD,YAAY,IAAI,WAAW,EAAE;IAIvB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,GAAE,QAAQ,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzF,OAAO,CAAC,iBAAiB;IA8CnB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,QAAQ,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3F,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,EAAE;IAgBrF,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE;CAOvD;AAID,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAKlE;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EA2PvC,CAAC"}