{"_id":"@edwardlee5423/magi-hotaitool","name":"@edwardlee5423/magi-hotaitool","dist-tags":{"beta":"0.1.0-beta.0","latest":"0.1.0-beta.0"},"versions":{"0.1.0-beta.0":{"name":"@edwardlee5423/magi-hotaitool","version":"0.1.0-beta.0","description":"HotAITool distribution wrapper for Magi Next (separate from the main magi package).","type":"module","license":"MIT","bin":{"magi-hotaitool":"dist/cli.js"},"scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","type":"tsc --noEmit"},"dependencies":{"@edwardlee5423/magi":"0.1.13"},"devDependencies":{"@types/node":"^22.13.10","typescript":"^5.8.2","vitest":"3.2.6"},"engines":{"node":">=20"},"gitHead":"191008e9a0ac23f0cd9fad71428de06f594e2e78","_id":"@edwardlee5423/magi-hotaitool@0.1.0-beta.0","_nodeVersion":"25.3.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-7kK+ekfW2MWxZ8eDZ4ejTlR//cmlzii8+d4gqfLOx0IxFK4zOFULwhWHl1ibgg7VkTIWKnNRhpFGFNSkKTg6vg==","shasum":"16a29b728e3132078914d563f67bf7719da8fc39","tarball":"https://registry.npmjs.org/@edwardlee5423/magi-hotaitool/-/magi-hotaitool-0.1.0-beta.0.tgz","fileCount":10,"unpackedSize":25806,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICIjo2w+P5F5XnImC6KbVexU81BQr9O0qFuqR96EyEkYAiBhvyGcWqvp24VDfNRHgTWmFogq6HCMzd9VguSGC/ZF+g=="}]},"_npmUser":{"name":"edwardlee5423","email":"edwardlee5423@gmail.com"},"directories":{},"maintainers":[{"name":"edwardlee5423","email":"edwardlee5423@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/magi-hotaitool_0.1.0-beta.0_1783732440910_0.0310279433563172"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T01:14:00.790Z","0.1.0-beta.0":"2026-07-11T01:14:01.083Z","modified":"2026-07-11T01:14:01.276Z"},"maintainers":[{"name":"edwardlee5423","email":"edwardlee5423@gmail.com"}],"description":"HotAITool distribution wrapper for Magi Next (separate from the main magi package).","license":"MIT","readme":"# Magi（HotAITool 版）\n\n## 简介\n\nMagi 是一款运行在终端中的 AI 编程助手，支持阅读与修改代码、执行命令、检索项目上下文等能力，适用于日常开发与代码排查场景。\n\n本文档介绍 **HotAITool 版**：在 Magi 基础上，预置了 HotAITool 网关地址与模型路由，使用者只需配置 API Key 即可开始工作。该版本与公开发行的 Magi 相互独立——启动命令、配置文件路径均不相同，在同一台机器上并存使用时不会相互覆盖。\n\n| 项目 | 公开发行版 | HotAITool 版 |\n|------|-----------|--------------|\n| 启动命令 | `magi` | `magi-hotaitool` |\n| 配置目录 | `~/.magi-next` | `~/.magi-hotaitool` |\n\n---\n\n## 环境要求\n\n- Node.js 20 及以上\n- 可访问 HotAITool 网关的网络环境\n- 有效的 HotAITool API Key\n\n---\n\n## 安装步骤\n\n从仓库获取代码并切换至 `hotai` 分支：\n\n```sh\ngit clone https://github.com/EDLee01/magi.git\ncd magi\ngit checkout hotai\n```\n\n安装主程序与 HotAITool 版入口：\n\n```sh\nnpm install && npm run build && npm link\n\ncd editions/hotaitool\nnpm install && npm run build && npm link\n```\n\n安装完成后，可在终端中执行 `magi-hotaitool` 命令。\n\n---\n\n## 配置说明\n\n### 推荐方式：输入 Key 后自动配置\n\n```sh\nmagi-hotaitool setup\n```\n\n命令会提示输入 HotAITool API Key，并将密钥写入 `~/.magi-hotaitool/provider.env`。随后会自动请求 HotAITool 模型列表，按可用模型生成 `config.yaml`。\n\n也可以直接通过参数传入：\n\n```sh\nmagi-hotaitool setup --key 您的密钥\n```\n\n### 手动方式\n\n```sh\nmagi-hotaitool setup --no-prompt\n```\n\n上述命令将在 `~/.magi-hotaitool/` 目录下创建配置目录。首次运行会生成 `provider.env` 模板。\n\n编辑 `~/.magi-hotaitool/provider.env`，填入以下内容：\n\n```bash\nHOTAITOOL_API_KEY=您的密钥\nANTHROPIC_BASE_URL=https://www.hotaitool.net\nOPENAI_BASE_URL=https://www.hotaitool.net/v1\n```\n\n说明：\n\n- Claude 与 GPT 通常可使用同一密钥，优先使用 `HOTAITOOL_API_KEY`。\n- 网关地址须严格按上表填写（详见下文「网关地址说明」）。\n\n生成运行配置：\n\n```sh\nmagi-hotaitool setup\n```\n\n可通过以下命令检查配置是否生效：\n\n```sh\nmagi-hotaitool doctor\n```\n\n---\n\n## 网关地址说明\n\nHotAITool 对 Claude 与 GPT 采用不同的 API 路径，配置时请注意区分：\n\n| 模型类型 | 环境变量 | 网关地址 |\n|---------|---------|---------|\n| Claude | `ANTHROPIC_BASE_URL` | `https://www.hotaitool.net`（不含 `/v1`） |\n| GPT | `OPENAI_BASE_URL` | `https://www.hotaitool.net/v1`（含 `/v1`） |\n\n地址填写错误时，可能出现 HTTP 404，或返回网页内容而非模型响应。\n\n---\n\n## 使用方法\n\n**单次提问：**\n\n```sh\nmagi-hotaitool -p \"请简要说明本项目的目录结构\"\n```\n\n**交互模式（推荐日常使用）：**\n\n```sh\nmagi-hotaitool\n```\n\n进入交互界面后，以自然语言描述任务即可。常用操作：\n\n- 输入 `/help` 查看命令列表\n- 输入 `/model fast`、`/model main`、`/model deep` 切换模型档位\n- 输入 `/exit` 退出\n\n---\n\n## 模型选择\n\n`setup` 会优先从 HotAITool 网关获取实际可用模型，并自动映射 fast / main / deep 三个档位。模型发现失败时，会回退到内置默认模型（Claude 密钥可用时优先走 Claude 线路）：\n\n| 档位 | Claude 可用 | 仅 GPT 密钥 |\n|------|------------|------------|\n| fast | claude-haiku-4-5 | gpt-5-mini |\n| main | claude-sonnet-4-6 | gpt-5.5 |\n| deep | claude-opus-4-7 | gpt-5.5-codex-max |\n\n---\n\n## 配置文件位置\n\n```\n~/.magi-hotaitool/\n├── provider.env    # API Key 与网关地址\n└── config.yaml     # 模型与路由配置（由 setup 自动生成）\n```\n\n如需更改配置目录，可设置环境变量 `MAGI_HOTAITOOL_CONFIG_DIR`。\n\n---\n\n## 常见问题\n\n**与公开发行版 Magi 有何区别？**  \n功能一致。HotAITool 版预置了网关与模型配置，并使用独立的配置目录。\n\n**代码更新后是否需要重新安装？**  \n需要在仓库根目录及 `editions/hotaitool` 目录下分别执行 `npm run build`。\n\n**遇到配置或连接问题如何处理？**  \n请先运行 `magi-hotaitool doctor`，将输出信息提供给维护人员以便排查。\n","readmeFilename":"README.md","_rev":"1-73724da810279b38b2d0e41d95129162"}