@nodeskai/genehub 2026.3.2-9 → 2026.3.3-3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NoDeskAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# @nodeskai/genehub - GeneHub CLI
+
+AI 员工基因管理命令行工具，用于搜索、安装、发布基因到 GeneHub Registry。
+
+## 安装
+
+```bash
+npm install -g @nodeskai/genehub
+```
+
+## 配置
+
+### 配置文件
+
+```bash
+genehub config set registry https://genehub.nodeskai.com
+genehub config set token <your-token>
+genehub config get
+```
+
+配置文件存储在 `~/.genehub/config.json`。
+
+### 环境变量
+
+环境变量优先级高于配置文件：
+
+| 环境变量 | 说明 | 对应配置项 |
+|---|---|---|
+| `GENEHUB_REGISTRY_URL` | Registry 地址 | `registry` |
+| `GENEHUB_REGISTRY` | Registry 地址（别名） | `registry` |
+| `GENEHUB_TOKEN` | 认证 Token | `token` |
+
+本地开发示例：
+
+```bash
+GENEHUB_REGISTRY_URL=http://localhost:3000 GENEHUB_TOKEN=dev genehub publish ./my-gene
+```
+
+## 认证
+
+使用 GitHub OAuth 登录，自动创建 API Key：
+
+```bash
+genehub auth login      # 打开浏览器完成 GitHub 登录，自动保存 token
+genehub auth status     # 查看当前登录状态
+genehub auth logout     # 退出登录（清除本地 token）
+```
+
+## 命令
+
+| 命令 | 说明 |
+|---|---|
+| `genehub auth login` | GitHub OAuth 登录 |
+| `genehub auth status` | 查看登录状态 |
+| `genehub auth logout` | 退出登录 |
+| `genehub search [keyword]` | 搜索基因库 |
+| `genehub install <slug>` | 安装基因到当前 Agent 环境 |
+| `genehub uninstall <slug>` | 卸载基因 |
+| `genehub publish <path>` | 发布基因到 Registry |
+| `genehub list` | 列出已安装的基因 |
+| `genehub learn <slug>` | 触发基因深度学习（L2） |
+| `genehub init` | 初始化基因项目 |
+| `genehub config` | 管理配置 |
+
+## 目录结构
+
+```
+packages/cli/
+├── src/
+│   ├── index.ts          # 入口，注册所有命令
+│   ├── config.ts         # 配置管理（文件 + 环境变量）
+│   ├── output.ts         # 格式化输出工具
+│   └── commands/
+│       ├── auth.ts       # GitHub OAuth 登录
+│       ├── config.ts     # config set / get
+│       ├── init.ts       # 初始化基因项目
+│       ├── install.ts    # 安装基因
+│       ├── learn.ts      # 深度学习
+│       ├── list.ts       # 列出已安装基因
+│       ├── publish.ts    # 发布基因
+│       ├── search.ts     # 搜索基因
+│       └── uninstall.ts  # 卸载基因
+├── dist/                 # 构建产物
+├── package.json
+└── tsup.config.ts
+```
+
+## 开发
+
+```bash
+cd packages/cli
+pnpm install
+pnpm build          # 构建
+pnpm dev            # 开发模式
+pnpm test           # 测试
+```