ntk

分类: 工具与效率 | 上传者: kobolingfeng | 下载: 0 | 版本: v1.0（最新）

基于信息密度路由的多智能体框架，MCP 协议接入，自适应任务复杂度

更新日志: Source: GitHub https://github.com/kobolingfeng/ntk

目录结构

当前层级: tree/main/

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 378 B
  - 📄 feature_request.md 285 B
- 📁 workflows/
  - 📄 ci.yml 828 B
  - 📄 release.yml 1.5 KB
- 📄 pull_request_template.md 664 B
📁 assets/
- 📄 ldxp-sponsor.png 3.7 KB
- 📄 wechat-sponsor.png 176.5 KB
📁 benchmarks/
- 📁 results/
  - 📄 .gitkeep 0 B
  - 📄 ntk-baseline-cheap-2026-04-01.json 32.9 KB
  - 📄 ntk-baseline-ntk-2026-04-01.json 32.8 KB
  - 📄 ntk-baseline-strong-2026-04-01.json 33.0 KB
📁 bin/
- 📄 ntk.js 503 B
📁 examples/
- 📄 basic-usage.ts 1.1 KB
- 📄 custom-agents.ts 2.8 KB
- 📄 http-server.ts 781 B
- 📄 README.md 870 B
- 📄 shared.ts 1.4 KB
📁 src/
- 📁 agents/
  - 📄 executor.test.ts 3.4 KB
  - 📄 executor.ts 661 B
  - 📄 planner.test.ts 6.1 KB
  - 📄 planner.ts 3.7 KB
  - 📄 scout.test.ts 1.8 KB
  - 📄 scout.ts 722 B
  - 📄 summarizer.test.ts 1.5 KB
  - 📄 summarizer.ts 503 B
  - 📄 verifier.test.ts 1.8 KB
  - 📄 verifier.ts 710 B
- 📁 api/
  - 📄 server.ts 16.0 KB
- 📁 cli/
  - 📁 benchmarks/
    
    📄 ablation.ts 2.2 KB
    
    📄 baseline.ts 4.0 KB
    
    📄 benchmark-runner.ts 20.5 KB
    
    📄 compare.ts 19.2 KB
    
    📄 index.ts 477 B
    
    📄 optimize.ts 8.0 KB
    
    📄 real-world-suite.ts 14.4 KB
    
    📄 test-suite.ts 4.6 KB
  - 📄 diff-context.test.ts 5.2 KB
  - 📄 diff-context.ts 3.8 KB
  - 📄 gain.ts 5.6 KB
  - 📄 output.ts 7.2 KB
- 📁 core/
  - 📄 base-agent.ts 3.2 KB
  - 📄 cache.test.ts 5.1 KB
  - 📄 cache.ts 3.8 KB
  - 📄 compressor.test.ts 9.3 KB
  - 📄 compressor.ts 6.5 KB
  - 📄 config.test.ts 5.1 KB
  - 📄 config.ts 2.6 KB
  - 📄 depth-predictor.test.ts 2.5 KB
  - 📄 depth-predictor.ts 6.4 KB
  - 📄 errors.test.ts 1.6 KB
  - 📄 errors.ts 2.0 KB
  - 📄 integration.test.ts 4.4 KB
  - 📄 llm.test.ts 3.1 KB
  - 📄 llm.ts 43.0 KB
  - 📄 pre-filter.test.ts 7.0 KB
  - 📄 pre-filter.ts 19.3 KB
  - 📄 prompts.ts 12.7 KB
  - 📄 protocol.ts 6.5 KB
  - 📄 router.test.ts 12.1 KB
  - 📄 router.ts 7.5 KB
- 📁 mcp/
  - 📄 server.ts 8.3 KB
- 📁 pipeline/
  - 📄 classifier.test.ts 7.7 KB
  - 📄 classifier.ts 6.4 KB
  - 📄 depth-direct.ts 5.2 KB
  - 📄 depth-full.ts 18.2 KB
  - 📄 depth-light.ts 4.5 KB
  - 📄 depth-standard.ts 5.5 KB
  - 📄 helpers.ts 9.5 KB
  - 📄 pipeline.test.ts 35.1 KB
  - 📄 pipeline.ts 24.6 KB
  - 📄 types.ts 2.0 KB
- 📁 tools/
  - 📄 definitions.test.ts 2.3 KB
  - 📄 definitions.ts 3.6 KB
  - 📄 executor.ts 20.1 KB
  - 📄 index.ts 527 B
  - 📄 loop.ts 7.7 KB
- 📄 cli.ts 25.8 KB
- 📄 index.ts 2.8 KB
- 📄 test-runner.ts 4.8 KB
📄 .env.example 1.3 KB
📄 .gitignore 392 B
📄 biome.json 1011 B
📄 CHANGELOG.md 4.4 KB
📄 CODE_OF_CONDUCT.md 732 B
📄 CONTRIBUTING.md 1.3 KB
📄 LICENSE 32.9 KB
📄 package-lock.json 119.8 KB
📄 package.json 2.2 KB
📄 README.md 19.5 KB
📄 README_EN.md 19.2 KB
📄 SECURITY.md 1.5 KB
📄 SKILL.md 2.4 KB
📄 tsconfig.json 478 B
📄 typedoc.json 427 B
📄 vitest.config.ts 725 B

SKILL.md

---
name: ntk
description: 基于信息密度路由的多智能体框架，MCP 协议接入，自适应任务复杂度
---

# NTK Multi-Agent Skill

NTK (NeedToKnow) 是一个基于信息密度路由的多智能体框架。它可以作为 MCP server 集成到任何支持 MCP 协议的 AI 客户端（VS Code Copilot、Claude Desktop、OpenClaw 等）。

## 快速接入

### MCP 配置（VS Code / Claude Desktop / OpenClaw）

**方式一：npm 全局安装后**

```json
{
  "mcpServers": {
    "ntk": {
      "command": "ntk",
      "args": ["mcp"]
    }
  }
}
```

**方式二：从源码运行**

```json
{
  "mcpServers": {
    "ntk": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "cwd": "/path/to/ntk"
    }
  }
}
```

### 前置条件
1. 项目目录下有 `.env` 文件配置 API endpoints
2. 已安装依赖: `npm install`

## 可用工具

### ntk_run
通过自适应管线执行任务。自动根据复杂度路由到最优深度。

参数:
- `task` (string, 必须): 要执行的任务
- `forceDepth` (string, 可选): 强制指定深度 — `direct` | `light` | `standard` | `full`
- `skipScout` (boolean, 可选): 跳过调研阶段

适用: 所有类型任务（代码生成、翻译、分析、架构设计等）

### ntk_run_fast
最小开销执行。强制 direct 深度，全部使用低成本模型。

参数:
- `task` (string, 必须): 要执行的任务

适用: 简单代码生成、翻译、bug修复、单函数实现

### ntk_compress
信息密度压缩。提取关键信息，压缩长文本。

参数:
- `text` (string, 必须): 要压缩的文本
- `level` (string, 可选): `minimal` | `standard` | `aggressive`

适用: 在处理前压缩长文档、API 响应、日志等

## 深度路由说明

| 深度 | 触发条件 | 流程 | 适用场景 |
|------|---------|------|---------|
| direct | 简单编码/翻译/计算 | executor 直接执行 | 写函数、翻译、修bug |
| light | 中等复杂度 | executor 执行 | 一般问答 |
| standard | 需要调研的任务 | planner→scout→executor→verifier | API设计、技术对比 |
| full | 高度复杂任务 | planner(强模型)→scout→executor→verifier | 架构设计、系统设计 |

## 性能参考

- 简单任务 (direct): ~400 tokens, ~4s
- 中等任务 (standard): ~1500 tokens, ~15s
- 复杂任务 (full): ~3000 tokens, ~20s
- 全部使用低成本模型，仅 full 深度使用强模型做规划

登录后下载/点赞/收藏 ❤ 27 | ★ 0

ntk

目录结构

SKILL.md

举报内容

提示