1、使用示例
Hawa 执行 github 统计任务，快速了解一下 Hawa Code 是如何自主识别补全Code Mode API 中缺失的 OutputSchema 。
任务
分析一下我的 github 账号下哪个项目 git 提交次数最多，这个项目每个提交人的提交次数分别是多少，不统计 fork 的项目
执行步骤解析
1、获取当前 github 账号信息
● Code(async () => { …
const me = await codemode.github.get_me();
return me;
})
⎿ {
"login": "jiweigang1",
"id": 3021648,
...
"updated_at": "2026-09-25T16:40:17Z"
}
}
2、查询当前账号下所有项目
Code(async () => { …
const repos = [];
let page = 1;
let total = 0;
while (page <= 3) {
const r = await codemode.github.search_repositories({ query: "user:jiweigang1 fork:false", sort: "updated", order: "desc", perPage: 100, page,
minimal_output: false });
if (!r || !r.items || r.items.length === 0) break;
total = r.total_count || 0;
repos.push(...r.items.filter(x => !x.fork).map(x => ({ name: x.full_name, default_branch: x.default_branch, pushed_at: x.updated_at })));
if (r.items.length < 100) break;
page++;
}
return { total, count: repos.length, repos };
})
⎿ {
"total": 46,
"count": 46,
...
}
]
}
3、获取 list_commits API 方法参数和描述
● Code(async () => { …
const docs = await codemode.describe("github.list_commits");
return docs;
})
⎿ {
"path": "github.list_commits",
"description": "Get list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if
specified using the perPage parameter (up to 100).\n\n...
"types": "declare const github: {\n /*\n Get list of commits of a branch in a GitHub repository. Returns at least 30 results per page by
default, but can return more if specified using the per...
"kind": "method"
}
4、在第一个仓库试一次 list_commits，确认返回结构。
● Code(async () => { …
const r = await codemode.github.list_commits({ owner: "jiweigang1", repo: "hcode-pages", perPage: 100, fields: ["sha"] });
return { type: Array.isArray(r), len: Array.isArray(r) ? r.length : null, sample: Array.isArray(r) ? r[0] : r };
})
⎿ {
"type": true,
"len": 100,
"sample": {
"sha": "ae4e3858d448ea22cb6d3a4edef099f42bddb529"
}
}
5、推断出出参结构并进行保存，同时统计出提交次数最多的项目
● Code(async () => { …
await codemode.saveOutputSchema("github.list_commits", {
type: "array",
items: {
type: "object",
properties: {
sha: { type: "string" },
html_url: { type: "string" },
commit: {
type: "object",
properties: {
message: { type: "string" },
author: {
type: "object",
properties: {
name: { type: "string" },
email: { type: "string" },
date: { type: "string" }
}
},
committer: {
type: "object",
properties: {
name: { type: "string" },
email: { type: "string" },
date: { type: "string" }
}
}
}
},
author: {
type: "object",
nullable: true,
properties: {
login: { type: "string" },
id: { type: "number" }
}
},
committer: {
type: "object",
nullable: true,
properties: {
login: { type: "string" },
id: { type: "number" }
}
}
}
}
}, "list_commits returns an array of commit objects; fields depend on the fields parameter");
const repos = ["hcode-pages","all-skills","hawa-code","Agent-Toolkit","hawa-hands","hawa-computer-use","hawa-cli-analysis","hawa-code2","Appwite","claude
-code","MetaDesktop","blog","The-Story-of-the-Stone","claude-cookbooks","ucode-ide","claude-code-sdk","claude-code-starter","vsclilogger","agenter","deep-l
earning-newbie","MAmzGO","AmzGo","fine-dev","AlipayAmzGO","ByteBuddy-learning","Vercel","ad-agent","Dagger2-learning","maven-jar-template","WechatAmzgo","s
uperdisplay","test-app","AWS","hexo-theme-navy-at","hexo-theme-navy","Apm-Tester","ChromeDriver","GradleTest","asm-learning","resource","eshop","JgWidgets"
,"StreetBox","google-collections","wf","jg-table"];
const branches = { "hcode-pages":"master","hawa-computer-use":"master","hexo-theme-navy":"master","test-app":"master","GradleTest":"master","asm-learning
":"master","resource":"master","eshop":"master","StreetBox":"master","google-collections":"master","wf":"master","jg-table":"master","JgWidgets":"gh-pages"
};
const counts = [];
for (const repo of repos) {
let page = 1, total = 0;
while (true) {
const r = await codemode.github.list_commits({ owner: "jiweigang1", repo, sha: branches[repo] || "main", perPage: 100, page, fields: ["sha"] });
const len = Array.isArray(r) ? r.length : 0;
total += len;
if (len < 100) break;
page++;
if (page > 50) break; // 安全上限，单仓库最多统计 5000 条
}
counts.push({ repo, total });
}
counts.sort((a, b) => b.total - a.total);
return counts;
})
⎿ [
{
"repo": "hcode-pages",
...
"total": 1
}
]
5、提交最多的是 hcode-pages（3185 次）。接下来统计该项目每个提交人的提交次数。
Code(async () => { …
const perAuthor = {};
const perLogin = {};
let page = 1;
while (true) {
const r = await codemode.github.list_commits({ owner: "jiweigang1", repo: "hcode-pages", sha: "master", perPage: 100, page, fields: ["commit",
"author"] });
if (!Array.isArray(r) || r.length === 0) break;
for (const c of r) {
const name = c.commit && c.commit.author ? c.commit.author.name : "unknown";
perAuthor[name] = (perAuthor[name] || 0) + 1;
const login = c.author && c.author.login ? c.author.login : name;
perLogin[login] = (perLogin[login] || 0) + 1;
}
if (r.length < 100) break;
page++;
if (page > 60) break;
}
const byName = Object.entries(perAuthor).sort((a, b) => b[1] - a[1]);
const byLogin = Object.entries(perLogin).sort((a, b) => b[1] - a[1]);
return { pages: page, total: byName.reduce((s, x) => s + x[1], 0), byName, byLogin };
})
⎿ {
"pages": 32,
"total": 3185,
...
]
]
}
统计结果
分析完成。以下是统计结果（已排除 fork 项目，共 46 个非 fork 仓库）。
提交次数最多的项目
https://github.com/jiweigang1/hcode-pages — 共 3185 次提交，远超第二名 hawa-code（1237 次）。这是一个 Hexo 博客（GitHub Pages）仓库，包含大量 Hexo
主题相关的历史提交，因此提交者数量非常多（按 Git 署名统计有上千人）。
该项目提交人 Top 15（按 commit 署名统计）
┌─────────────────────────┬──────────┐
│ 提交人 │ 提交次数 │
├─────────────────────────┼──────────┤
│ Tommy Chen (tommy351) │ 306 │
│ curbengh │ 193 │
│ jigang │ 122 │
│ lzjqsdd │ 116 │
│ Xuanwo │ 107 │
│ Abner Chou (NoahDragon) │ 78 │
│ dependabot[bot] │ 70 │
│ MDLeom │ 69 │
│ Sukka (SukkaW) │ 65 │
│ YoshinoriN │ 52 │
│ hexo-crowdin[bot] │ 46 │
│ 漩涡 │ 45 │
│ yoshinorin │ 44 │
│ D-Sketon │ 33 │
│ dependabot-preview[bot] │ 33 │
└─────────────────────────┴──────────┘
其余提交人均在 30 次以下，绝大多数只有 1~5 次提交（大量 Hexo 主题/插件的一次性上游提交）。
2、OutputSchema 自主学习
2.1、OutputSchema 缺失
Hawa Code 把 MCP 转换为 Code Mode provider API，然后通过 JavasSript 代码级联调用这些 API 执行任务。
MCP 工具都会提供 InutputSchema ，可以保证工具正确调用，但是很多 MCP 工具都没有提供 OutputSchema，这就导致模型无法判断出参结果，从而无法做到代码级联调用。
2.2、OutputSchema 解析
如果 MCP 工具没有提供 OutputSchema，比较简单的方式是通过工具的返回结果推断 OutputSchema，这个方式常规场景中都是可行的，其有两种方案：
● 执行调用时候程序通过返回结果生成 OutputJSONSchema ，优势是不需要模型参与。
● 通过模型自主的判断 OutputJSONSchema ，优势是可以提高准确性。
Hawa Code 采取的方案就是第二种，符合 Hawa Code 理念“模型会越来越聪明，应该让模型去主导更多的事情”。同时模型可以提高准确性，比如返回结果是一个枚举值，模型可以通过多次的返回结果去订正 OutputJSONSchema。
在以上的示例中 HawaCode 首先从第一个仓库试一次 list_commits，确认返回结构。然后进行了保存。模型可以选择多种方式和合适的时机去解析 OutputSchema 结构。
2.3、渐进式学习
在以上的示例中，Hawa Code 执行了多次调用，相比传统的工具调用调用大量减少了模型调用次数，示例中不存在分页多次调用问题， Hawa Code 在多次使用 Github API过程中会逐渐补全缺失的 OutputSchema，如果 OutputSchema 是全量的，Hawa Code 执行两次模型调用就可以完成此任务。
- 获取 API 描述和出参和入参结构
- 执行业务落地代码调用。
Code Mode 非常时候处理复杂的业务逻辑任务，而对于传统的工具调用就很难做到，比如执行上千次分页调用。
欢迎了解使用 Hawa Code https://www.hawacode.com/docs/
