1 line
52 KiB
JSON
1 line
52 KiB
JSON
{"repo": "blcacola/adva-code", "files": {"README.md": {"55b267842ff88a69b750d00c45f4cae3b4d4a87f": {"t": 1785747259.744885, "n": 6846, "h": "ed04eea160c3b32a", "c": "# ADVA Code 🚀\n\n[English](README.en.md) | 简体中文\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\n> 一个会写代码的 AI 助手，现在有了自己的个性 🤖✨\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。它不是官方仓库，也不是简单的镜像，而是一个充满个性的\"魔改版\"——就像给你的 AI 助手换了一套新衣服，还教了它几招新技能。\n\n## 🎯 你能得到什么\n\n- **独立空间**：`~/.adva` 配置目录，和原版 Claude Code 井水不犯河水\n- **开发利器**：Bun + TypeScript + Ink 的现代化 CLI/TUI 开发环境\n- **萌宠伴侣**：内置完整的 Buddy 宠物系统，增加中英双语支持、外观定制、属性加点\n- **无限可能**：可继续扩展的命令、工具、桥接和 shim 结构\n- **🔑 API 自由**：支持 OpenAI 格式 API key，不再局限于 Anthropic（重要！）\n\n## 🏗️ 项目结构\n\n```\nADVA-Code/\n├── src/ # 主源码目录（大脑所在）\n│ ├── bootstrap-entry.ts # 启动入口（大门）\n│ ├── main.tsx # 主程序入口（客厅）\n│ ├── dev-entry.ts # 开发模式入口（后门）\n│ ├── commands/ # 斜杠命令实现（工具箱）\n│ │ ├── install-slack-app/ # Slack 应用安装\n│ │ ├── install-github-app/ # GitHub 应用安装\n│ │ └── ... # 更多命令\n│ ├── components/ # Ink/React 终端组件（家具）\n│ │ ├── App.tsx # 顶层应用组件\n│ │ ├── REPL.tsx # 交互式命令行界面\n│ │ ├── design-system/ # 设计系统组件\n│ │ ├── tasks/ # 任务相关组件\n│ │ └── ... # 更多组件\n│ ├── services/ # 运行期服务（管家）\n│ │ ├── mcp/ # MCP 客户端服务\n│ │ ├── tools/ # 工具执行服务\n│ │ ├── analytics/ # 分析服务\n│ │ ├── plugins/ # 插件服务\n│ │ └── ... # 更多服务\n│ ├── tools/ # 工具层实现（工具库）\n│ │ ├── BashTool/ # Bash 命令工具\n│ │ ├── FileEditTool/ # 文件编辑工具\n│ │ ├── FileReadTool/ # 文件读取工具\n│ │ ├── AgentTool/ # 代理工具\n│ │ └── ... # 更多工具\n│ ├── cli/ # CLI 相关功能（控制台）\n│ │ ├── handlers/ # CLI 处理器\n│ │ ├── transports/ # 传输层\n│ │ ├── print.ts # 打印功能\n│ │ └── ... # 更多 CLI 功能\n│ ├── transports/ # 传输层（通信管道）\n│ │ ├── Transport.ts # 传输接口\n│ │ ├── WebSocketTransport.ts # WebSocket 传输\n│ │ ├── SSETransport.ts # SSE 传输\n│ │ └── ... # 更多传输方式\n│ ├── state/ # 状态管理（记忆）\n│ │ ├── AppState.ts # 应用状态\n│ │ └── ... # 更多状态管理\n│ ├── screens/ # 界面（房间）\n│ │ ├── REPL.tsx # REPL 界面\n│ │ ├── Doctor.tsx # 诊断界面\n│ │ └── ... # 更多界面\n│ └── utils/ # 工具函数（瑞士军刀）\n│ ├── config.ts # 配置管理\n│ ├── messages.ts # 消息处理\n│ ├── sessionStorage.ts # 会话存储\n│ ├── ide.ts # IDE 集成\n│ └── ... # 更多工具函数\n├── shims/ # 本地 shim 包（适配器）\n├── vendor/ # 恢复或兼容相关代码（备用零件）\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n└── README.md # 你正在看的文件\n```\n\n## 📊 当前状态\n\n- **包名**：`@adva-code/cli`\n- **默认命令名**：`adva`\n- **当前版本**：`999.0.0-ADVA`（版本号不重要，重要的是态度）\n- **主入口**：`src/bootstrap-entry.ts`\n- **运行方式**：源码直跑为主（就像喝手磨咖啡）\n\n## 🛠️ 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境\n\n## 🚀 快速开始\n\n```bash\n# 1. 克隆仓库\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\n\n# 2. 安装依赖\nbun install\n\n# 3. 验证安装\nbun run version\n\n# 4. 启动应用\nbun run dev\n```\nWindows使用`install.bat`可以快速配置环境。\n就这么简单，三步走完，你就能拥有一个会写代码的 AI 助手！\n\n## 🎮 常用命令\n\n```bash\n# 启动 CLI/TUI（主菜）\nbun run dev\n\n# 同上（别名，方便懒人）\nbun run start\n\n# 查看版本（确认身份）\nbun run version\n\n# 恢复检查（体检）\nbun run dev:restore-check\n```\n\n## 🌍 全局安装\n\n想让 `adva` 命令随叫随到？\n\n```bash\nbun install\nbun link\nadva\n```\n\n更新代码后记得重新 `bun link`，不然你用的还是旧版本（就像穿了昨天的衣服）。\n\n## 📁 配置与数据目录\n\nADVA Code 有自己的小天地：\n\n**全局配置**：\n- `~/.adva`（大本营）\n- `~/.adva/.claude.json`（全局配置文件，包含 API 设置）\n- `~/.adva/settings.json`（用户设置文件）\n- `~/.adva/agents`（代理们住的地方）\n- `~/.adva/agent-memory`（代理们的记忆）\n\n**项目配置**：\n- `.claude/settings.json`（项目设置）\n- `.claude/settings.local.json`（本地设置，不提交）\n- `.adva/skills`（技能目录）\n- `.adva/agents`（项目代理）\n\n这样设计的目的很直接：**井水不犯河水**。这个分支和原版 Claude Code 的配置、认证、缓存完全隔离，就像两个独立的房间。\n\n**重要提示**：\n- API 配置（`customApiEndpoint`）应该在 `~/.adva/.claude.json` 中设置\n- 用户级别的其他设置在 `~/.adva/settings.json` 中\n- 项目级别的设置在 `.claude/settings.json` 中\n\n## 🔑 API 配置（重要！）\n\n### ⚡ OpenAI API 支持\n\n这是 ADVA Code 与原版 Claude Code 的一个**重要区别**：\n\n- **原版 Claude Code**：只支持 Anthropic API\n- **ADVA Code**：支持 OpenAI 格式 API key，让你有更多选择！\n\n目标行为是：\n\n- 内部程序仍按 Anthropic Messages 模式组织请求\n- 当选择 OpenAI API 格式时，由中间层把 Messages 请求改写成 Chat Completions 请求\n- 远端返回 Chat Completions 流后，再由中间层回转成内部可消费的 Messages 风格流事件\n\n这意味着它不是简单改一个 Base URL，而是协议级别的输入输出流转接。\n\n当前状态：\n\n- API 格式选择界面与配置持久化已加入\n- OpenAI 兼容转接模块正在迭代中\n- 目前仍属于开发中功能，可能出现流式事件不完整、消息映射异常、部分工具调用兼容不足等情况\n- 如果你只是想稳定使用，建议优先走 Anthropic 兼容接口模式；如果你在测试 OpenAI 格式，请把它视为实验功能。\n\n### 配置方式\n\n**配置文件**\n\n编辑 `~/.adva/.claude.json`：\n\n```json\n{\n \"customApiEndpoint\": {\n \"provider\": \"openai\",\n \"baseURL\": \"https://api.openai.com/v1\",\n \"apiKey\": \"sk-xxxxxxxxxxxxxxxxxxxxxxxx\",\n \"model\": \"gpt-4\"\n }\n}\n```\n\n**交互式配置**\n\n启动 ADVA Code 后使用 `/config` 命令进行交互式配置。\n\n### 支持的 API 提供商\n\n- ✅ **OpenAI**（官方）\n- ✅ **Azure OpenAI**\n- ✅ **其他 OpenAI 兼容 API**（如 DeepSeek、智谱等）\n- ✅ **Anthropic**\n\n### 为什么这很重要？\n\n1. **成本控制**：OpenAI API 通常比 Anthropic 更便宜\n2. **模型选择**：可以使用 GPT-4、GPT-3.5 等多种模型\n3. **灵活性**：不局限于单一提供商，可以随时切换\n4. **本地部署**：支持本地部署的 OpenAI 兼容服务\n\n### 注意事项\n\n- 使用 OpenAI API 时，请确保你的 API key 有足够的额度\n- 不同提供商的模型能力可能有所差异\n- 建议在测试环境先验证配置是否正确\n\n## 🐾 Buddy 宠物系统\n\nBuddy 是你的 AI 伴侣，已经做了深度定制：\n\n- **状态面板**：`/buddy status` 查看详细状态\n- **语言切换**：`/buddy language en|zh` 中英双语随意切换\n- **外观定制**：`/buddy species robot` 换个物种\n- **属性加点**：`/buddy stat DEBUGGING 100` 提升技能\n- **闪光特效**：`/buddy shiny on` 开启闪光模式\n\n**常用命令示例**：\n\n```text\n/buddy status # 查看状态\n/buddy help # 查看帮助\n/buddy language zh # 切换中文\n/buddy species robot # 变成机器人\n/buddy shiny on # 开启闪光\n/buddy stat DEBUGGING 100 # 调试技能拉满\n```\n\n## 💻 开发说明\n\n这个仓库目前没有完整的测试矩阵（别指望有 CI/CD 流水线）。更现实的验证方式：\n\n1. 先跑 `bun run version`，确认程序还能起（基本体检）\n2. 再跑 `bun run dev`，手动验证你改到的路径（功能测试）\n3. 对具体模块做窄范围检查（精准打击）\n\n## 🎯 适合什么用途\n\n- **学习**：研究恢复后的 Claude Code 类 CLI/TUI 结构\n- **开发**：把它当作二次开发底座，打造你自己的 AI 助手\n- **魔改**：继续添加新功能，让它变得更强大\n\n## ⚠️ 注意事项\n\n- 这不是官方仓库（是魔改版）\n- 不应假设它和官方版本逐行、逐功能一致（有自己的想法）\n- **重要**：支持 OpenAI 格式 API key，这是与原版的主要区别之一\n- 使用前请确认许可证（遵守规则）\n\n## 📜 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 🔗 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n\n---\n\n**Made with ❤️ by ADVA Code Team**\n\n*让编程变得更有趣* 🎉\n"}, "2f9c65047d1d88d4df6255fefedb0fbf341fefb9": {"t": 1785771936.9937642, "n": 6814, "h": "b4b5ba1db0495c9b", "c": "# ADVA Code 🚀\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\n> 一个会写代码的 AI 助手，现在有了自己的个性 🤖✨\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。它不是官方仓库，也不是简单的镜像，而是一个充满个性的\"魔改版\"——就像给你的 AI 助手换了一套新衣服，还教了它几招新技能。\n\n## 🎯 你能得到什么\n\n- **独立空间**：`~/.adva` 配置目录，和原版 Claude Code 井水不犯河水\n- **开发利器**：Bun + TypeScript + Ink 的现代化 CLI/TUI 开发环境\n- **萌宠伴侣**：内置完整的 Buddy 宠物系统，增加中英双语支持、外观定制、属性加点\n- **无限可能**：可继续扩展的命令、工具、桥接和 shim 结构\n- **🔑 API 自由**：支持 OpenAI 格式 API key，不再局限于 Anthropic（重要！）\n\n## 🏗️ 项目结构\n\n```\nADVA-Code/\n├── src/ # 主源码目录（大脑所在）\n│ ├── bootstrap-entry.ts # 启动入口（大门）\n│ ├── main.tsx # 主程序入口（客厅）\n│ ├── dev-entry.ts # 开发模式入口（后门）\n│ ├── commands/ # 斜杠命令实现（工具箱）\n│ │ ├── install-slack-app/ # Slack 应用安装\n│ │ ├── install-github-app/ # GitHub 应用安装\n│ │ └── ... # 更多命令\n│ ├── components/ # Ink/React 终端组件（家具）\n│ │ ├── App.tsx # 顶层应用组件\n│ │ ├── REPL.tsx # 交互式命令行界面\n│ │ ├── design-system/ # 设计系统组件\n│ │ ├── tasks/ # 任务相关组件\n│ │ └── ... # 更多组件\n│ ├── services/ # 运行期服务（管家）\n│ │ ├── mcp/ # MCP 客户端服务\n│ │ ├── tools/ # 工具执行服务\n│ │ ├── analytics/ # 分析服务\n│ │ ├── plugins/ # 插件服务\n│ │ └── ... # 更多服务\n│ ├── tools/ # 工具层实现（工具库）\n│ │ ├── BashTool/ # Bash 命令工具\n│ │ ├── FileEditTool/ # 文件编辑工具\n│ │ ├── FileReadTool/ # 文件读取工具\n│ │ ├── AgentTool/ # 代理工具\n│ │ └── ... # 更多工具\n│ ├── cli/ # CLI 相关功能（控制台）\n│ │ ├── handlers/ # CLI 处理器\n│ │ ├── transports/ # 传输层\n│ │ ├── print.ts # 打印功能\n│ │ └── ... # 更多 CLI 功能\n│ ├── transports/ # 传输层（通信管道）\n│ │ ├── Transport.ts # 传输接口\n│ │ ├── WebSocketTransport.ts # WebSocket 传输\n│ │ ├── SSETransport.ts # SSE 传输\n│ │ └── ... # 更多传输方式\n│ ├── state/ # 状态管理（记忆）\n│ │ ├── AppState.ts # 应用状态\n│ │ └── ... # 更多状态管理\n│ ├── screens/ # 界面（房间）\n│ │ ├── REPL.tsx # REPL 界面\n│ │ ├── Doctor.tsx # 诊断界面\n│ │ └── ... # 更多界面\n│ └── utils/ # 工具函数（瑞士军刀）\n│ ├── config.ts # 配置管理\n│ ├── messages.ts # 消息处理\n│ ├── sessionStorage.ts # 会话存储\n│ ├── ide.ts # IDE 集成\n│ └── ... # 更多工具函数\n├── shims/ # 本地 shim 包（适配器）\n├── vendor/ # 恢复或兼容相关代码（备用零件）\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n└── README.md # 你正在看的文件\n```\n\n## 📊 当前状态\n\n- **包名**：`@adva-code/cli`\n- **默认命令名**：`adva`\n- **当前版本**：`999.0.0-ADVA`（版本号不重要，重要的是态度）\n- **主入口**：`src/bootstrap-entry.ts`\n- **运行方式**：源码直跑为主（就像喝手磨咖啡）\n\n## 🛠️ 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境\n\n## 🚀 快速开始\n\n```bash\n# 1. 克隆仓库\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\n\n# 2. 安装依赖\nbun install\n\n# 3. 验证安装\nbun run version\n\n# 4. 启动应用\nbun run dev\n```\nWindows使用`install.bat`可以快速配置环境。\n就这么简单，三步走完，你就能拥有一个会写代码的 AI 助手！\n\n## 🎮 常用命令\n\n```bash\n# 启动 CLI/TUI（主菜）\nbun run dev\n\n# 同上（别名，方便懒人）\nbun run start\n\n# 查看版本（确认身份）\nbun run version\n\n# 恢复检查（体检）\nbun run dev:restore-check\n```\n\n## 🌍 全局安装\n\n想让 `adva` 命令随叫随到？\n\n```bash\nbun install\nbun link\nadva\n```\n\n更新代码后记得重新 `bun link`，不然你用的还是旧版本（就像穿了昨天的衣服）。\n\n## 📁 配置与数据目录\n\nADVA Code 有自己的小天地：\n\n**全局配置**：\n- `~/.adva`（大本营）\n- `~/.adva/.claude.json`（全局配置文件，包含 API 设置）\n- `~/.adva/settings.json`（用户设置文件）\n- `~/.adva/agents`（代理们住的地方）\n- `~/.adva/agent-memory`（代理们的记忆）\n\n**项目配置**：\n- `.claude/settings.json`（项目设置）\n- `.claude/settings.local.json`（本地设置，不提交）\n- `.adva/skills`（技能目录）\n- `.adva/agents`（项目代理）\n\n这样设计的目的很直接：**井水不犯河水**。这个分支和原版 Claude Code 的配置、认证、缓存完全隔离，就像两个独立的房间。\n\n**重要提示**：\n- API 配置（`customApiEndpoint`）应该在 `~/.adva/.claude.json` 中设置\n- 用户级别的其他设置在 `~/.adva/settings.json` 中\n- 项目级别的设置在 `.claude/settings.json` 中\n\n## 🔑 API 配置（重要！）\n\n### ⚡ OpenAI API 支持\n\n这是 ADVA Code 与原版 Claude Code 的一个**重要区别**：\n\n- **原版 Claude Code**：只支持 Anthropic API\n- **ADVA Code**：支持 OpenAI 格式 API key，让你有更多选择！\n\n目标行为是：\n\n- 内部程序仍按 Anthropic Messages 模式组织请求\n- 当选择 OpenAI API 格式时，由中间层把 Messages 请求改写成 Chat Completions 请求\n- 远端返回 Chat Completions 流后，再由中间层回转成内部可消费的 Messages 风格流事件\n\n这意味着它不是简单改一个 Base URL，而是协议级别的输入输出流转接。\n\n当前状态：\n\n- API 格式选择界面与配置持久化已加入\n- OpenAI 兼容转接模块正在迭代中\n- 目前仍属于开发中功能，可能出现流式事件不完整、消息映射异常、部分工具调用兼容不足等情况\n- 如果你只是想稳定使用，建议优先走 Anthropic 兼容接口模式；如果你在测试 OpenAI 格式，请把它视为实验功能。\n\n### 配置方式\n\n**配置文件**\n\n编辑 `~/.adva/.claude.json`：\n\n```json\n{\n \"customApiEndpoint\": {\n \"provider\": \"openai\",\n \"baseURL\": \"https://api.openai.com/v1\",\n \"apiKey\": \"sk-xxxxxxxxxxxxxxxxxxxxxxxx\",\n \"model\": \"gpt-4\"\n }\n}\n```\n\n**交互式配置**\n\n启动 ADVA Code 后使用 `/config` 命令进行交互式配置。\n\n### 支持的 API 提供商\n\n- ✅ **OpenAI**（官方）\n- ✅ **Azure OpenAI**\n- ✅ **其他 OpenAI 兼容 API**（如 DeepSeek、智谱等）\n- ✅ **Anthropic**\n\n### 为什么这很重要？\n\n1. **成本控制**：OpenAI API 通常比 Anthropic 更便宜\n2. **模型选择**：可以使用 GPT-4、GPT-3.5 等多种模型\n3. **灵活性**：不局限于单一提供商，可以随时切换\n4. **本地部署**：支持本地部署的 OpenAI 兼容服务\n\n### 注意事项\n\n- 使用 OpenAI API 时，请确保你的 API key 有足够的额度\n- 不同提供商的模型能力可能有所差异\n- 建议在测试环境先验证配置是否正确\n\n## 🐾 Buddy 宠物系统\n\nBuddy 是你的 AI 伴侣，已经做了深度定制：\n\n- **状态面板**：`/buddy status` 查看详细状态\n- **语言切换**：`/buddy language en|zh` 中英双语随意切换\n- **外观定制**：`/buddy species robot` 换个物种\n- **属性加点**：`/buddy stat DEBUGGING 100` 提升技能\n- **闪光特效**：`/buddy shiny on` 开启闪光模式\n\n**常用命令示例**：\n\n```text\n/buddy status # 查看状态\n/buddy help # 查看帮助\n/buddy language zh # 切换中文\n/buddy species robot # 变成机器人\n/buddy shiny on # 开启闪光\n/buddy stat DEBUGGING 100 # 调试技能拉满\n```\n\n## 💻 开发说明\n\n这个仓库目前没有完整的测试矩阵（别指望有 CI/CD 流水线）。更现实的验证方式：\n\n1. 先跑 `bun run version`，确认程序还能起（基本体检）\n2. 再跑 `bun run dev`，手动验证你改到的路径（功能测试）\n3. 对具体模块做窄范围检查（精准打击）\n\n## 🎯 适合什么用途\n\n- **学习**：研究恢复后的 Claude Code 类 CLI/TUI 结构\n- **开发**：把它当作二次开发底座，打造你自己的 AI 助手\n- **魔改**：继续添加新功能，让它变得更强大\n\n## ⚠️ 注意事项\n\n- 这不是官方仓库（是魔改版）\n- 不应假设它和官方版本逐行、逐功能一致（有自己的想法）\n- **重要**：支持 OpenAI 格式 API key，这是与原版的主要区别之一\n- 使用前请确认许可证（遵守规则）\n\n## 📜 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 🔗 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n\n---\n\n**Made with ❤️ by ADVA Code Team**\n\n*让编程变得更有趣* 🎉\n"}, "8933b925d52722e44af3dcb7489b8fccd0dc5b27": {"t": 1785771938.1649773, "n": 6623, "h": "6a49e672b88c796d", "c": "# ADVA Code 🚀\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\n> 一个会写代码的 AI 助手，现在有了自己的个性 🤖✨\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。它不是官方仓库，也不是简单的镜像，而是一个充满个性的\"魔改版\"——就像给你的 AI 助手换了一套新衣服，还教了它几招新技能。\n\n## 🎯 你能得到什么\n\n- **独立空间**：`~/.adva` 配置目录，和原版 Claude Code 井水不犯河水\n- **开发利器**：Bun + TypeScript + Ink 的现代化 CLI/TUI 开发环境\n- **萌宠伴侣**：内置完整的 Buddy 宠物系统，增加中英双语支持、外观定制、属性加点\n- **无限可能**：可继续扩展的命令、工具、桥接和 shim 结构\n- **🔑 API 自由**：支持 OpenAI 格式 API key，不再局限于 Anthropic（重要！）\n\n## 🏗️ 项目结构\n\n```\nADVA-Code/\n├── src/ # 主源码目录（大脑所在）\n│ ├── bootstrap-entry.ts # 启动入口（大门）\n│ ├── main.tsx # 主程序入口（客厅）\n│ ├── dev-entry.ts # 开发模式入口（后门）\n│ ├── commands/ # 斜杠命令实现（工具箱）\n│ │ ├── install-slack-app/ # Slack 应用安装\n│ │ ├── install-github-app/ # GitHub 应用安装\n│ │ └── ... # 更多命令\n│ ├── components/ # Ink/React 终端组件（家具）\n│ │ ├── App.tsx # 顶层应用组件\n│ │ ├── REPL.tsx # 交互式命令行界面\n│ │ ├── design-system/ # 设计系统组件\n│ │ ├── tasks/ # 任务相关组件\n│ │ └── ... # 更多组件\n│ ├── services/ # 运行期服务（管家）\n│ │ ├── mcp/ # MCP 客户端服务\n│ │ ├── tools/ # 工具执行服务\n│ │ ├── analytics/ # 分析服务\n│ │ ├── plugins/ # 插件服务\n│ │ └── ... # 更多服务\n│ ├── tools/ # 工具层实现（工具库）\n│ │ ├── BashTool/ # Bash 命令工具\n│ │ ├── FileEditTool/ # 文件编辑工具\n│ │ ├── FileReadTool/ # 文件读取工具\n│ │ ├── AgentTool/ # 代理工具\n│ │ └── ... # 更多工具\n│ ├── cli/ # CLI 相关功能（控制台）\n│ │ ├── handlers/ # CLI 处理器\n│ │ ├── transports/ # 传输层\n│ │ ├── print.ts # 打印功能\n│ │ └── ... # 更多 CLI 功能\n│ ├── transports/ # 传输层（通信管道）\n│ │ ├── Transport.ts # 传输接口\n│ │ ├── WebSocketTransport.ts # WebSocket 传输\n│ │ ├── SSETransport.ts # SSE 传输\n│ │ └── ... # 更多传输方式\n│ ├── state/ # 状态管理（记忆）\n│ │ ├── AppState.ts # 应用状态\n│ │ └── ... # 更多状态管理\n│ ├── screens/ # 界面（房间）\n│ │ ├── REPL.tsx # REPL 界面\n│ │ ├── Doctor.tsx # 诊断界面\n│ │ └── ... # 更多界面\n│ └── utils/ # 工具函数（瑞士军刀）\n│ ├── config.ts # 配置管理\n│ ├── messages.ts # 消息处理\n│ ├── sessionStorage.ts # 会话存储\n│ ├── ide.ts # IDE 集成\n│ └── ... # 更多工具函数\n├── shims/ # 本地 shim 包（适配器）\n├── vendor/ # 恢复或兼容相关代码（备用零件）\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n└── README.md # 你正在看的文件\n```\n\n## 📊 当前状态\n\n- **包名**：`@adva-code/cli`\n- **默认命令名**：`adva`\n- **当前版本**：`999.0.0-ADVA`（版本号不重要，重要的是态度）\n- **主入口**：`src/bootstrap-entry.ts`\n- **运行方式**：源码直跑为主（就像喝手磨咖啡）\n\n## 🛠️ 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境\n\n## 🚀 快速开始\n\n```bash\n# 1. 克隆仓库\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\n\n# 2. 安装依赖\nbun install\n\n# 3. 验证安装\nbun run version\n\n# 4. 启动应用\nbun run dev\n```\nWindows使用`install.bat`可以快速配置环境。\n就这么简单，三步走完，你就能拥有一个会写代码的 AI 助手！\n\n## 🎮 常用命令\n\n```bash\n# 启动 CLI/TUI（主菜）\nbun run dev\n\n# 同上（别名，方便懒人）\nbun run start\n\n# 查看版本（确认身份）\nbun run version\n\n# 恢复检查（体检）\nbun run dev:restore-check\n```\n\n## 🌍 全局安装\n\n想让 `adva` 命令随叫随到？\n\n```bash\nbun install\nbun link\nadva\n```\n\n更新代码后记得重新 `bun link`，不然你用的还是旧版本（就像穿了昨天的衣服）。\n\n## 📁 配置与数据目录\n\nADVA Code 有自己的小天地：\n\n**全局配置**：\n- `~/.adva`（大本营）\n- `~/.adva/settings.json`（设置文件）\n- `~/.adva/agents`（代理们住的地方）\n- `~/.adva/agent-memory`（代理们的记忆）\n\n**项目配置**：\n- `.adva/settings.json`（项目设置）\n- `.adva/settings.local.json`（本地设置，不提交）\n- `.adva/skills`（技能目录）\n- `.adva/agents`（项目代理）\n\n这样设计的目的很直接：**井水不犯河水**。这个分支和原版 Claude Code 的配置、认证、缓存完全隔离，就像两个独立的房间。\n\n## 🔑 API 配置（重要！）\n\n### ⚡ OpenAI API 支持\n\n这是 ADVA Code 与原版 Claude Code 的一个**重要区别**：\n\n- **原版 Claude Code**：只支持 Anthropic API\n- **ADVA Code**：支持 OpenAI 格式 API key，让你有更多选择！\n\n目标行为是：\n\n- 内部程序仍按 Anthropic Messages 模式组织请求\n- 当选择 OpenAI API 格式时，由中间层把 Messages 请求改写成 Chat Completions 请求\n- 远端返回 Chat Completions 流后，再由中间层回转成内部可消费的 Messages 风格流事件\n\n这意味着它不是简单改一个 Base URL，而是协议级别的输入输出流转接。\n\n当前状态：\n\n- API 格式选择界面与配置持久化已加入\n- OpenAI 兼容转接模块正在迭代中\n- 目前仍属于开发中功能，可能出现流式事件不完整、消息映射异常、部分工具调用兼容不足等情况\n- 如果你只是想稳定使用，建议优先走 Anthropic 兼容接口模式；如果你在测试 OpenAI 格式，请把它视为实验功能。\n\n### 配置方式\n\n**配置文件**\n\n编辑 `~/.adva/settings.json`：\n\n```json\n{\n \"customApiEndpoint\": {\n \"provider\": \"openai\",\n \"baseURL\": \"https://api.openai.com/v1\",\n \"apiKey\": \"sk-xxxxxxxxxxxxxxxxxxxxxxxx\",\n \"model\": \"gpt-4\"\n }\n}\n```\n\n**方式三：交互式配置**\n\n启动 ADVA Code 后使用 `/config` 命令进行交互式配置。\n\n### 支持的 API 提供商\n\n- ✅ **OpenAI**（官方）\n- ✅ **Azure OpenAI**\n- ✅ **其他 OpenAI 兼容 API**（如 DeepSeek、智谱等）\n- ✅ **Anthropic**\n\n### 为什么这很重要？\n\n1. **成本控制**：OpenAI API 通常比 Anthropic 更便宜\n2. **模型选择**：可以使用 GPT-4、GPT-3.5 等多种模型\n3. **灵活性**：不局限于单一提供商，可以随时切换\n4. **本地部署**：支持本地部署的 OpenAI 兼容服务\n\n### 注意事项\n\n- 使用 OpenAI API 时，请确保你的 API key 有足够的额度\n- 不同提供商的模型能力可能有所差异\n- 建议在测试环境先验证配置是否正确\n\n## 🐾 Buddy 宠物系统\n\nBuddy 是你的 AI 伴侣，已经做了深度定制：\n\n- **状态面板**：`/buddy status` 查看详细状态\n- **语言切换**：`/buddy language en|zh` 中英双语随意切换\n- **外观定制**：`/buddy species robot` 换个物种\n- **属性加点**：`/buddy stat DEBUGGING 100` 提升技能\n- **闪光特效**：`/buddy shiny on` 开启闪光模式\n\n**常用命令示例**：\n\n```text\n/buddy status # 查看状态\n/buddy help # 查看帮助\n/buddy language zh # 切换中文\n/buddy species robot # 变成机器人\n/buddy shiny on # 开启闪光\n/buddy stat DEBUGGING 100 # 调试技能拉满\n```\n\n## 💻 开发说明\n\n这个仓库目前没有完整的测试矩阵（别指望有 CI/CD 流水线）。更现实的验证方式：\n\n1. 先跑 `bun run version`，确认程序还能起（基本体检）\n2. 再跑 `bun run dev`，手动验证你改到的路径（功能测试）\n3. 对具体模块做窄范围检查（精准打击）\n\n## 🎯 适合什么用途\n\n- **学习**：研究恢复后的 Claude Code 类 CLI/TUI 结构\n- **开发**：把它当作二次开发底座，打造你自己的 AI 助手\n- **魔改**：继续添加新功能，让它变得更强大\n\n## ⚠️ 注意事项\n\n- 这不是官方仓库（是魔改版）\n- 不应假设它和官方版本逐行、逐功能一致（有自己的想法）\n- **重要**：支持 OpenAI 格式 API key，这是与原版的主要区别之一\n- 使用前请确认许可证（遵守规则）\n\n## 📜 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 🔗 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n\n---\n\n**Made with ❤️ by ADVA Code Team**\n\n*让编程变得更有趣* 🎉\n"}, "60bdee8702d194e1d2f665cd322f360eba09a8b9": {"t": 1785771939.5027385, "n": 6656, "h": "b1cb537d59f59ec8", "c": "# ADVA Code 🚀\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\n> 一个会写代码的 AI 助手，现在有了自己的个性 🤖✨\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。它不是官方仓库，也不是简单的镜像，而是一个充满个性的\"魔改版\"——就像给你的 AI 助手换了一套新衣服，还教了它几招新技能。\n\n## 🎯 你能得到什么\n\n- **独立空间**：`~/.adva` 配置目录，和原版 Claude Code 井水不犯河水\n- **开发利器**：Bun + TypeScript + Ink 的现代化 CLI/TUI 开发环境\n- **萌宠伴侣**：内置完整的 Buddy 宠物系统，增加中英双语支持、外观定制、属性加点\n- **无限可能**：可继续扩展的命令、工具、桥接和 shim 结构\n- **🔑 API 自由**：支持 OpenAI 格式 API key，不再局限于 Anthropic（重要！）\n\n## 🏗️ 项目结构\n\n```\nADVA-Code/\n├── src/ # 主源码目录（大脑所在）\n│ ├── bootstrap-entry.ts # 启动入口（大门）\n│ ├── main.tsx # 主程序入口（客厅）\n│ ├── dev-entry.ts # 开发模式入口（后门）\n│ ├── commands/ # 斜杠命令实现（工具箱）\n│ │ ├── install-slack-app/ # Slack 应用安装\n│ │ ├── install-github-app/ # GitHub 应用安装\n│ │ └── ... # 更多命令\n│ ├── components/ # Ink/React 终端组件（家具）\n│ │ ├── App.tsx # 顶层应用组件\n│ │ ├── REPL.tsx # 交互式命令行界面\n│ │ ├── design-system/ # 设计系统组件\n│ │ ├── tasks/ # 任务相关组件\n│ │ └── ... # 更多组件\n│ ├── services/ # 运行期服务（管家）\n│ │ ├── mcp/ # MCP 客户端服务\n│ │ ├── tools/ # 工具执行服务\n│ │ ├── analytics/ # 分析服务\n│ │ ├── plugins/ # 插件服务\n│ │ └── ... # 更多服务\n│ ├── tools/ # 工具层实现（工具库）\n│ │ ├── BashTool/ # Bash 命令工具\n│ │ ├── FileEditTool/ # 文件编辑工具\n│ │ ├── FileReadTool/ # 文件读取工具\n│ │ ├── AgentTool/ # 代理工具\n│ │ └── ... # 更多工具\n│ ├── cli/ # CLI 相关功能（控制台）\n│ │ ├── handlers/ # CLI 处理器\n│ │ ├── transports/ # 传输层\n│ │ ├── print.ts # 打印功能\n│ │ └── ... # 更多 CLI 功能\n│ ├── transports/ # 传输层（通信管道）\n│ │ ├── Transport.ts # 传输接口\n│ │ ├── WebSocketTransport.ts # WebSocket 传输\n│ │ ├── SSETransport.ts # SSE 传输\n│ │ └── ... # 更多传输方式\n│ ├── state/ # 状态管理（记忆）\n│ │ ├── AppState.ts # 应用状态\n│ │ └── ... # 更多状态管理\n│ ├── screens/ # 界面（房间）\n│ │ ├── REPL.tsx # REPL 界面\n│ │ ├── Doctor.tsx # 诊断界面\n│ │ └── ... # 更多界面\n│ └── utils/ # 工具函数（瑞士军刀）\n│ ├── config.ts # 配置管理\n│ ├── messages.ts # 消息处理\n│ ├── sessionStorage.ts # 会话存储\n│ ├── ide.ts # IDE 集成\n│ └── ... # 更多工具函数\n├── shims/ # 本地 shim 包（适配器）\n├── vendor/ # 恢复或兼容相关代码（备用零件）\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n└── README.md # 你正在看的文件\n```\n\n## 📊 当前状态\n\n- **包名**：`@adva-code/cli`\n- **默认命令名**：`adva`\n- **当前版本**：`999.0.0-ADVA`（版本号不重要，重要的是态度）\n- **主入口**：`src/bootstrap-entry.ts`\n- **运行方式**：源码直跑为主（就像喝手磨咖啡）\n\n## 🛠️ 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境\n\n## 🚀 快速开始\n\n```bash\n# 1. 克隆仓库\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\n\n# 2. 安装依赖\nbun install\n\n# 3. 验证安装\nbun run version\n\n# 4. 启动应用\nbun run dev\n```\nWindows使用`install.bat`可以快速配置环境。\n就这么简单，三步走完，你就能拥有一个会写代码的 AI 助手！\n\n## 🎮 常用命令\n\n```bash\n# 启动 CLI/TUI（主菜）\nbun run dev\n\n# 同上（别名，方便懒人）\nbun run start\n\n# 查看版本（确认身份）\nbun run version\n\n# 恢复检查（体检）\nbun run dev:restore-check\n```\n\n## 🌍 全局安装\n\n想让 `adva` 命令随叫随到？\n\n```bash\nbun install\nbun link\nadva\n```\n\n更新代码后记得重新 `bun link`，不然你用的还是旧版本（就像穿了昨天的衣服）。\n\n## 📁 配置与数据目录\n\nADVA Code 有自己的小天地：\n\n**全局配置**：\n- `~/.adva`（大本营）\n- `~/.adva/settings.json`（设置文件）\n- `~/.adva/agents`（代理们住的地方）\n- `~/.adva/agent-memory`（代理们的记忆）\n\n**项目配置**：\n- `.adva/settings.json`（项目设置）\n- `.adva/settings.local.json`（本地设置，不提交）\n- `.adva/skills`（技能目录）\n- `.adva/agents`（项目代理）\n\n这样设计的目的很直接：**井水不犯河水**。这个分支和原版 Claude Code 的配置、认证、缓存完全隔离，就像两个独立的房间。\n\n## 🔑 API 配置（重要！）\n\n### ⚡ OpenAI API 支持\n\n这是 ADVA Code 与原版 Claude Code 的一个**重要区别**：\n\n- **原版 Claude Code**：只支持 Anthropic API\n- **ADVA Code**：支持 OpenAI 格式 API key，让你有更多选择！\n\n目标行为是：\n\n- 内部程序仍按 Anthropic Messages 模式组织请求\n- 当选择 OpenAI API 格式时，由中间层把 Messages 请求改写成 Chat Completions 请求\n- 远端返回 Chat Completions 流后，再由中间层回转成内部可消费的 Messages 风格流事件\n\n这意味着它不是简单改一个 Base URL，而是协议级别的输入输出流转接。\n\n当前状态：\n\n- API 格式选择界面与配置持久化已加入\n- OpenAI 兼容转接模块正在迭代中\n- 目前仍属于开发中功能，可能出现流式事件不完整、消息映射异常、部分工具调用兼容不足等情况\n- 如果你只是想稳定使用，建议优先走 Anthropic 兼容接口模式；如果你在测试 OpenAI 格式，请把它视为实验功能。\n\n### 配置方式\n\n**配置文件**\n\n编辑 `~/.adva/settings.json`：\n\n```json\n{\n \"customApiEndpoint\": {\n \"provider\": \"openai\",\n \"baseURL\": \"https://api.openai.com/v1\",\n \"apiKey\": \"sk-xxxxxxxxxxxxxxxxxxxxxxxx\",\n \"model\": \"gpt-4\"\n }\n}\n```\n\n**方式三：交互式配置**\n\n启动 ADVA Code 后使用 `/config` 命令进行交互式配置。\n\n### 支持的 API 提供商\n\n- ✅ **OpenAI**（官方）\n- ✅ **Azure OpenAI**\n- ✅ **其他 OpenAI 兼容 API**（如 DeepSeek、智谱等）\n- ✅ **Anthropic**（仍然支持，通过 `provider: \"anthropic\"`）\n\n### 为什么这很重要？\n\n1. **成本控制**：OpenAI API 通常比 Anthropic 更便宜\n2. **模型选择**：可以使用 GPT-4、GPT-3.5 等多种模型\n3. **灵活性**：不局限于单一提供商，可以随时切换\n4. **本地部署**：支持本地部署的 OpenAI 兼容服务\n\n### 注意事项\n\n- 使用 OpenAI API 时，请确保你的 API key 有足够的额度\n- 不同提供商的模型能力可能有所差异\n- 建议在测试环境先验证配置是否正确\n\n## 🐾 Buddy 宠物系统\n\nBuddy 是你的 AI 伴侣，已经做了深度定制：\n\n- **状态面板**：`/buddy status` 查看详细状态\n- **语言切换**：`/buddy language en|zh` 中英双语随意切换\n- **外观定制**：`/buddy species robot` 换个物种\n- **属性加点**：`/buddy stat DEBUGGING 100` 提升技能\n- **闪光特效**：`/buddy shiny on` 开启闪光模式\n\n**常用命令示例**：\n\n```text\n/buddy status # 查看状态\n/buddy help # 查看帮助\n/buddy language zh # 切换中文\n/buddy species robot # 变成机器人\n/buddy shiny on # 开启闪光\n/buddy stat DEBUGGING 100 # 调试技能拉满\n```\n\n## 💻 开发说明\n\n这个仓库目前没有完整的测试矩阵（别指望有 CI/CD 流水线）。更现实的验证方式：\n\n1. 先跑 `bun run version`，确认程序还能起（基本体检）\n2. 再跑 `bun run dev`，手动验证你改到的路径（功能测试）\n3. 对具体模块做窄范围检查（精准打击）\n\n## 🎯 适合什么用途\n\n- **学习**：研究恢复后的 Claude Code 类 CLI/TUI 结构\n- **开发**：把它当作二次开发底座，打造你自己的 AI 助手\n- **魔改**：继续添加新功能，让它变得更强大\n\n## ⚠️ 注意事项\n\n- 这不是官方仓库（是魔改版）\n- 不应假设它和官方版本逐行、逐功能一致（有自己的想法）\n- **重要**：支持 OpenAI 格式 API key，这是与原版的主要区别之一\n- 使用前请确认许可证（遵守规则）\n\n## 📜 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 🔗 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n\n---\n\n**Made with ❤️ by ADVA Code Team**\n\n*让编程变得更有趣* 🎉\n"}, "1ea374b39612e49914970b58309858b4bdbcadac": {"t": 1785771941.4668717, "n": 2531, "h": "78d45c7cb628d5ad", "c": "# ADVA Code\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。适合本地开发、继续魔改和长期自维护。\n\n这个仓库不是官方上游，也不是原始镜像。当前代码状态是“恢复工程 + 持续定制”的结合体，所以文档、行为和官方版本不完全一致。\n\n## 你能得到什么\n\n- 独立配置目录 `~/.adva`，避免和原版本地状态混用\n- Bun + TypeScript + Ink 的 CLI/TUI 开发环境\n- 内置定制的 Buddy 宠物系统，支持外观、属性、语言切换和状态面板\n- 可继续扩展的命令、工具、桥接和 shim 结构\n\n## 当前状态\n\n- 包名：`@adva-code/cli`\n- 默认命令名：`adva`\n- 当前版本：`999.0.0-ADVA`\n- 主入口：`src/bootstrap-entry.ts`\n- 运行方式：源码直跑为主\n\n## 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境均可\n\n## 快速开始\n\n```bash\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\nbun install\nbun run version\nbun run dev\n```\n\n\n## 常用命令\n\n```bash\nbun run dev\n```\n\n启动当前源码树的 CLI/TUI。\n\n```bash\nbun run start\n```\n\n与 `dev` 指向同一入口。\n\n```bash\nbun run version\n```\n\n输出当前版本并做最窄启动校验。\n\n```bash\nbun run dev:restore-check\n```\n\n运行恢复相关的开发入口，适合排查恢复期逻辑或兼容层行为。\n\n## 全局安装\n\n如果你希望把当前源码注册成全局命令：\n\n```bash\nbun install\nbun link\nadva\n```\n\n如果之后更新了仓库，建议重新执行一次 `bun link`，确保全局命令仍指向最新源码。\n\n## 配置与数据目录\n\nADVA Code 默认使用独立目录：\n\n- `~/.adva`\n- `~/.adva/settings.json`\n- `~/.adva/agents`\n- `~/.adva/agent-memory`\n\n项目内也会使用：\n\n- `.adva/settings.json`\n- `.adva/settings.local.json`\n- `.adva/skills`\n- `.adva/agents`\n\n这样做的目的很直接：把这个分支和原版 Claude Code 的本地配置、认证状态、缓存与扩展内容隔离开来。\n\n如果你使用自定义 API key，当前分支也已经切换为使用 `ADVA_API_KEY` 相关路径和界面。\n\n## Buddy 宠物系统\n\n当前仓库已经对 Buddy 做了额外定制，至少包括：\n\n- `/buddy` 和 `/buddy status` 的详细状态面板\n- 中英双语切换：`/buddy language en|zh`\n- 外观和属性修改命令\n- 更完整的帮助页和实用子命令\n- 闪光标识、彩色面板、属性条与预览立绘\n\n常见命令示例：\n\n```text\n/buddy status\n/buddy help\n/buddy language zh\n/buddy species robot\n/buddy shiny on\n/buddy stat DEBUGGING 100\n```\n\n## 项目结构\n\n- `src/`：主源码，包含 CLI、TUI、命令、服务、桥接、状态和组件\n- `src/commands/`：斜杠命令实现\n- `src/components/`：Ink/React 终端组件\n- `src/services/`：运行期服务与业务逻辑\n- `src/tools/`：工具层实现\n- `shims/`：本地 shim 包和兼容封装\n- `vendor/`：恢复或兼容相关附带代码\n\n## 开发说明\n\n这个仓库目前没有一套完整、统一、对外公开的测试矩阵。更现实的验证方式是局部验证：\n\n- 先跑 `bun run version`，确认程序还能起\n- 再跑 `bun run dev`，手动验证你改到的路径\n- 对具体模块做窄范围检查，不假设根目录一定存在完整 CI\n\n\n\n## 适合什么用途\n\n- 学习恢复后的 Claude Code 类 CLI/TUI 结构\n- 把它当作二次开发底座\n\n## 注意事项\n\n- 这不是官方仓库\n- 不应假设它和官方版本逐行、逐功能一致\n\n## 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n"}, "d0dd191001c85f984f2d82ddd05f049be9370f34": {"t": 1785771943.6829526, "n": 2603, "h": "d3927ae5002bc1dd", "c": "# ADVA Code\n\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n[](README.md)\n\nADVA Code 是一个基于恢复源码树继续维护和定制的 Claude Code 分支。适合本地开发、继续魔改和长期自维护。\n\n这个仓库不是官方上游，也不是原始镜像。当前代码状态是“恢复工程 + 持续定制”的结合体，所以文档、行为和官方版本不完全一致。\n\n## 你能得到什么\n\n- 独立配置目录 `~/.adva`，避免和原版本地状态混用\n- Bun + TypeScript + Ink 的 CLI/TUI 开发环境\n- 内置定制的 Buddy 宠物系统，支持外观、属性、语言切换和状态面板\n- 可继续扩展的命令、工具、桥接和 shim 结构\n\n## 当前状态\n\n- 包名：`@adva-code/cli`\n- 默认命令名：`adva`\n- 当前版本：`999.0.0-ADVA`\n- 主入口：`src/bootstrap-entry.ts`\n- 运行方式：源码直跑为主\n\n## 环境要求\n\n- Bun >= 1.3.5\n- Node.js >= 24\n- Windows、macOS、Linux 终端环境均可，当前仓库在 Windows 上也可直接通过批处理脚本启动\n\n## 快速开始\n\n```bash\ngit clone https://github.com/BlcaCola/ADVA-Code.git\ncd ADVA-Code\nbun install\nbun run version\nbun run dev\n```\n\nWindows 下如果你想直接双击启动，可以使用根目录里的 `start.bat`。\n\n## 常用命令\n\n```bash\nbun run dev\n```\n\n启动当前源码树的 CLI/TUI。\n\n```bash\nbun run start\n```\n\n与 `dev` 指向同一入口。\n\n```bash\nbun run version\n```\n\n输出当前版本并做最窄启动校验。\n\n```bash\nbun run dev:restore-check\n```\n\n运行恢复相关的开发入口，适合排查恢复期逻辑或兼容层行为。\n\n## 全局安装\n\n如果你希望把当前源码注册成全局命令：\n\n```bash\nbun install\nbun link\nadva\n```\n\n如果之后更新了仓库，建议重新执行一次 `bun link`，确保全局命令仍指向最新源码。\n\n## 配置与数据目录\n\nADVA Code 默认使用独立目录：\n\n- `~/.adva`\n- `~/.adva/settings.json`\n- `~/.adva/agents`\n- `~/.adva/agent-memory`\n\n项目内也会使用：\n\n- `.adva/settings.json`\n- `.adva/settings.local.json`\n- `.adva/skills`\n- `.adva/agents`\n\n这样做的目的很直接：把这个分支和原版 Claude Code 的本地配置、认证状态、缓存与扩展内容隔离开来。\n\n如果你使用自定义 API key，当前分支也已经切换为使用 `ADVA_API_KEY` 相关路径和界面。\n\n## Buddy 宠物系统\n\n当前仓库已经对 Buddy 做了额外定制，至少包括：\n\n- `/buddy` 和 `/buddy status` 的详细状态面板\n- 中英双语切换：`/buddy language en|zh`\n- 外观和属性修改命令\n- 更完整的帮助页和实用子命令\n- 闪光标识、彩色面板、属性条与预览立绘\n\n常见命令示例：\n\n```text\n/buddy status\n/buddy help\n/buddy language zh\n/buddy species robot\n/buddy shiny on\n/buddy stat DEBUGGING 100\n```\n\n## 项目结构\n\n- `src/`：主源码，包含 CLI、TUI、命令、服务、桥接、状态和组件\n- `src/commands/`：斜杠命令实现\n- `src/components/`：Ink/React 终端组件\n- `src/services/`：运行期服务与业务逻辑\n- `src/tools/`：工具层实现\n- `shims/`：本地 shim 包和兼容封装\n- `vendor/`：恢复或兼容相关附带代码\n\n## 开发说明\n\n这个仓库目前没有一套完整、统一、对外公开的测试矩阵。更现实的验证方式是局部验证：\n\n- 先跑 `bun run version`，确认程序还能起\n- 再跑 `bun run dev`，手动验证你改到的路径\n- 对具体模块做窄范围检查，不假设根目录一定存在完整 CI\n\n\n\n## 适合什么用途\n\n- 学习恢复后的 Claude Code 类 CLI/TUI 结构\n- 把它当作二次开发底座\n\n## 注意事项\n\n- 这不是官方仓库\n- 不应假设它和官方版本逐行、逐功能一致\n\n## 许可证\n\n项目根目录包含 `LICENSE` 文件。使用和分发前，请先自行确认当前分支与上游相关内容的适用范围。\n\n## 仓库地址\n\n<https://github.com/BlcaCola/ADVA-Code>\n"}}}} |