nikou-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VangelisHaha
+
+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,329 @@
+# nikou-cli
+
+`nikou-cli` 是一个面向 Agent 工具链的命令行工具，提供三类能力：
+
+- 安装、列出、删除和创建 Agent Skills。
+- 安装、搜索、列出和删除 MCP server 配置。
+- 启动 AI Hook 主从节点，把聊天消息分发给 Codex、Claude 或 Gemini 从节点执行。
+
+> 本仓库不包含任何真实密钥。Hook 主从节点需要你自己准备机器人应用凭证，并写入本机配置文件。
+
+## 安装
+
+```bash
+npm install -g nikou-cli
+```
+
+也可以直接使用 `npx`：
+
+```bash
+npx nikou-cli --help
+```
+
+要求 Node.js `>=18`。
+
+## 命令总览
+
+```bash
+nikou-cli --help
+nikou-cli add <owner/repo>
+nikou-cli list
+nikou-cli remove <name>
+nikou-cli init <name>
+nikou-cli mcp <command>
+nikou-cli hook <command>
+```
+
+## Skills
+
+### 从 GitHub 仓库安装 Skill
+
+```bash
+nikou-cli add anthropics/skills
+```
+
+安装指定子目录：
+
+```bash
+nikou-cli add anthropics/skills --path skills/frontend-design
+```
+
+安装到指定目录：
+
+```bash
+nikou-cli add anthropics/skills --path skills/frontend-design --dest ~/.codex/skills
+```
+
+指定分支：
+
+```bash
+nikou-cli add anthropics/skills --branch main
+```
+
+覆盖已存在的 Skill：
+
+```bash
+nikou-cli add anthropics/skills --path skills/frontend-design --force
+```
+
+### 查看已安装 Skills
+
+```bash
+nikou-cli list
+nikou-cli list --dest ~/.codex/skills
+```
+
+### 删除 Skill
+
+```bash
+nikou-cli remove frontend-design
+nikou-cli remove frontend-design --dest ~/.codex/skills
+```
+
+### 创建 Skill 模板
+
+```bash
+nikou-cli init my-custom-skill
+nikou-cli init my-custom-skill --dest ~/.codex/skills
+```
+
+生成结构：
+
+```text
+my-custom-skill/
+  SKILL.md
+```
+
+## MCP
+
+`nikou-cli mcp` 会把 MCP server 配置写入常见 Agent 工具的本机配置文件。
+
+支持目标：
+
+- `claude`
+- `codex`
+- `gemini`
+- `opencode`
+- `all`
+
+### 搜索 MCP 资源
+
+```bash
+nikou-cli mcp search apifox --api-url https://your-platform.example.com/api/v1
+```
+
+### 安装 MCP
+
+```bash
+nikou-cli mcp add apifox-mcp-server \
+  --api-url https://your-platform.example.com/api/v1 \
+  --tools codex,claude
+```
+
+指定配置名：
+
+```bash
+nikou-cli mcp add apifox-mcp-server \
+  --api-url https://your-platform.example.com/api/v1 \
+  --name apifox \
+  --tools codex
+```
+
+强制覆盖已存在配置：
+
+```bash
+nikou-cli mcp add apifox-mcp-server \
+  --api-url https://your-platform.example.com/api/v1 \
+  --tools all \
+  --force
+```
+
+### 查看已安装 MCP
+
+```bash
+nikou-cli mcp list
+nikou-cli mcp list --tools codex
+```
+
+### 删除 MCP
+
+```bash
+nikou-cli mcp remove apifox
+nikou-cli mcp remove apifox --tools codex,claude
+```
+
+## AI Hook 主从节点
+
+Hook 模式包含一个主节点和多个从节点：
+
+- 主节点：连接聊天平台，接收消息，维护 Worker 列表，并把任务分发给从节点。
+- 从节点：连接主节点，收到任务后调用 Codex、Claude 或 Gemini 执行。
+
+### 初始化配置
+
+```bash
+nikou-cli hook init
+```
+
+配置默认写入：
+
+```text
+~/.nikou-block/master/config.json
+~/.nikou-block/worker/config.json
+```
+
+配置示例：
+
+```json
+{
+  "feishu": {
+    "app_id": "YOUR_APP_ID",
+    "app_secret": "YOUR_APP_SECRET"
+  },
+  "hook": {
+    "master_host": "127.0.0.1",
+    "master_port": 19732,
+    "shared_secret": "CHANGE_ME",
+    "bind_allowed_user_ids": ["YOUR_USER_ID"],
+    "knowledge_base_ip": "203.0.113.10",
+    "knowledge_base_dir": "/srv/knowledge-base"
+  },
+  "auth": {
+    "api_url": "https://your-platform.example.com/api/v1",
+    "cli_auth_secret": "CHANGE_ME"
+  }
+}
+```
+
+安全建议：
+
+- 不要把 `app_secret`、`shared_secret`、`cli_auth_secret` 提交到 Git。
+- `shared_secret` 用于主从节点握手，生产环境不要复用机器人密钥。
+- `knowledge_base_ip` 和 `knowledge_base_dir` 请按自己的机器和目录配置，默认值只是本机占位。
+
+### 启动主节点
+
+```bash
+nikou-cli hook master
+```
+
+覆盖监听参数：
+
+```bash
+nikou-cli hook master \
+  --master-host 0.0.0.0 \
+  --master-port 19732 \
+  --shared-secret CHANGE_ME
+```
+
+### 启动从节点
+
+Codex：
+
+```bash
+nikou-cli hook worker codex
+```
+
+Claude：
+
+```bash
+nikou-cli hook worker claude
+```
+
+Gemini：
+
+```bash
+nikou-cli hook worker gemini
+```
+
+连接远端主节点：
+
+```bash
+nikou-cli hook worker codex \
+  --master-host 203.0.113.10 \
+  --master-port 19732 \
+  --shared-secret CHANGE_ME
+```
+
+Claude 参数透传示例：
+
+```bash
+nikou-cli hook worker claude \
+  --model sonnet \
+  --permission-mode acceptEdits \
+  --max-budget-usd 5
+```
+
+也可以通过 `--` 传递底层工具参数：
+
+```bash
+nikou-cli hook worker claude -- --model sonnet
+```
+
+### 查看日志
+
+```bash
+nikou-cli hook log
+nikou-cli hook log --master
+nikou-cli hook log --worker
+nikou-cli hook log "trace-id-or-keyword" --context 30
+nikou-cli hook log --follow
+```
+
+日志默认位于：
+
+```text
+~/.nikou-block/logs/master/ai-hook-master.service.log
+~/.nikou-block/logs/worker/ai-hook-worker.service.log
+```
+
+## 统计上报
+
+统计上报默认关闭。只有同时配置以下环境变量时才会连接数据库：
+
+```bash
+export NIKOU_STAT_DB_HOST=127.0.0.1
+export NIKOU_STAT_DB_PORT=3306
+export NIKOU_STAT_DB_USER=nikou
+export NIKOU_STAT_DB_PASSWORD=CHANGE_ME
+export NIKOU_STAT_DB_NAME=nikou
+export NIKOU_STAT_DB_TABLE=nikou_usage_daily_stat
+```
+
+## 开发
+
+```bash
+npm install
+npm run build
+npm test
+npm run privacy-scan
+npm run pack:check
+```
+
+本地调试：
+
+```bash
+npm link
+nikou-cli --help
+```
+
+## 发布
+
+发布前必须通过：
+
+```bash
+npm run build
+npm test
+npm run privacy-scan
+npm run pack:check
+```
+
+发布到公共 npm：
+
+```bash
+npm publish --registry=https://registry.npmjs.org/
+```
+
+## 许可证
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node