fix(teacher): 改善只读工具分页与读取预算

This commit is contained in:
2026-09-27 10:15:17 +08:00
parent 17c7e5c495
commit 56cefe84e7
8 changed files with 297 additions and 56 deletions

View File

@@ -31,6 +31,90 @@ async function fixture() {
}
describe('teacher read scope', () => {
it('discovers nested sources in one bounded tree and can drill into deeper directories', async () => {
const f = await fixture();
await mkdir(path.join(f.project, 'app/src/main/java/sample'), { recursive: true });
await writeFile(path.join(f.project, 'app/src/main/AndroidManifest.xml'), '<manifest/>');
await writeFile(path.join(f.project, 'app/src/main/java/sample/MainActivity.kt'), 'class MainActivity');
const rawTree = await f.read('list_project_files', { path: '.' });
expect(rawTree).toContain('app/src/main/AndroidManifest.xml');
const tree = JSON.parse(rawTree);
expect(tree.text).toContain('app/src/main/AndroidManifest.xml');
expect(tree.text).toContain('app/src/main/java/');
expect(tree.text).not.toContain('MainActivity.kt');
const subtree = JSON.parse(await f.read('list_project_files', { path: 'app/src/main/java' }));
expect(subtree.text).toContain('sample/MainActivity.kt');
});
it('can page beyond 2000 directory entries instead of silently losing later files', async () => {
const f = await fixture();
await mkdir(path.join(f.project, 'assets'));
for (let i = 0; i < 2001; i++) await writeFile(path.join(f.project, 'assets', `item-${String(i).padStart(4, '0')}.txt`), '');
const result = JSON.parse(await f.read('list_project_files', { path: 'assets', start_line: 1995, line_count: 10 }));
expect(result.text).toContain('assets/item-2000.txt');
expect(result.next).toBeNull();
});
it('keeps Android source discoverable beside a large Gradle cache', async () => {
const f = await fixture();
await mkdir(path.join(f.project, '.gradle'));
await mkdir(path.join(f.project, 'app/src'), { recursive: true });
await writeFile(path.join(f.project, 'app/src/Main.kt'), 'class Main');
for (let i = 0; i < 2000; i++) await writeFile(path.join(f.project, '.gradle', `cache-${i}.bin`), '');
const result = JSON.parse(await f.read('list_project_files', { path: '.' }));
expect(result.text).toContain('app/');
expect(result.text).toContain('app/src/Main.kt');
expect(result.text).not.toContain('.gradle');
});
it('pages large UTF-8 originals without losing the middle or stopping at the preview limit', async () => {
const f = await fixture();
const original = '开始\n' + '中文🙂\\"'.repeat(24000) + '\n末行';
await writeFile(path.join(f.project, 'large.ts'), original);
let cursor: { start_line: number; start_column: number } | null = { start_line: 1, start_column: 1 };
let restored = '';
let pages = 0;
while (cursor && pages++ < 150) {
const result = await f.tools.executeResult('read_project_file', JSON.stringify({ path: 'large.ts', ...cursor }), f.controller.signal);
expect(result.status).toBe('success');
expect(result.content).not.toContain('中间内容已省略');
expect(Buffer.byteLength(result.content)).toBeLessThanOrEqual(8192);
const page = JSON.parse(result.content);
expect(page.text.length).toBeGreaterThan(0);
restored += page.text;
cursor = page.next;
expect(result.truncated).toBe(cursor !== null);
}
expect(cursor).toBeNull();
expect(pages).toBeGreaterThan(1);
expect(restored).toBe(original);
});
it('stops consuming a multi-megabyte single line after the first bounded page', async () => {
const f = await fixture();
await writeFile(path.join(f.project, 'minified.js'), '源码🙂'.repeat(600000));
const decode = TextDecoder.prototype.decode;
let decodedBytes = 0;
const spy = vi.spyOn(TextDecoder.prototype, 'decode').mockImplementation(function (input, options) {
decodedBytes += input?.byteLength ?? 0;
return decode.call(this, input, options);
});
try {
const result = await f.tools.executeResult('read_project_file', '{"path":"minified.js"}', f.controller.signal);
expect(result.status).toBe('success');
expect(result.truncated).toBe(true);
expect(Buffer.byteLength(result.content)).toBeLessThanOrEqual(8192);
expect(decodedBytes).toBeLessThanOrEqual(128 * 1024);
} finally {
spy.mockRestore();
}
});
it('keeps line positions when Windows newlines cross filesystem chunks', async () => {
const f = await fixture();
await writeFile(path.join(f.project, 'windows.ts'), 'x'.repeat(65535) + '\r\n中文🙂\r\n最后');
const page = JSON.parse(await f.read('read_project_file', { path: 'windows.ts', start_line: 2, line_count: 1 }));
expect(page.text).toBe('中文🙂\n');
expect(page.next).toEqual({ start_line: 3, start_column: 1 });
const last = JSON.parse(await f.read('read_project_file', { path: 'windows.ts', ...page.next }));
expect(last.text).toBe('最后');
expect(last.next).toBeNull();
});
it('browses nested source and reads numbered file lines without modifying files', async () => {
const f = await fixture();
const list = await f.read('list_project_files', { path: '.' });
@@ -38,8 +122,8 @@ describe('teacher read scope', () => {
expect(list).not.toContain('.makelore');
expect(await f.read('list_project_files', { path: 'src' })).toContain('src/game.ts');
expect(await f.read('read_project_file', { path: '.makelore/project.json' })).toContain('current-project');
expect(await f.read('read_project_file', { path: 'src/game.ts', start_line: 2, line_count: 1 }))
.toBe('src/game.ts\nLines 2-2 of 2:\n2: const score = 7;');
expect(JSON.parse(await f.read('read_project_file', { path: 'src/game.ts', start_line: 2, line_count: 1 })))
.toEqual({ source: 'src/game.ts', start_line: 2, start_column: 1, text: 'const score = 7;', next: null });
expect(await f.read('write', { path: 'src/game.ts', content: 'overwrite' })).toContain('Read failed');
expect(await readFile(path.join(f.project, 'src/game.ts'), 'utf8')).toBe('const gravity = 0.6;\nconst score = 7;');
});
@@ -57,8 +141,8 @@ describe('teacher read scope', () => {
it('reads only the captured conversation and supports original-message line ranges', async () => {
const f = await fixture();
expect(await f.read('read_conversation', {})).toContain('active assistant');
expect(await f.read('read_conversation', { message_id: 'active', start_line: 2, line_count: 1 }))
.toBe('active assistant\nLines 2-2 of 3:\n2: 第二行');
expect(JSON.parse(await f.read('read_conversation', { message_id: 'active', start_line: 2, line_count: 1 })))
.toEqual({ source: 'active assistant', start_line: 2, start_column: 1, text: '第二行\n', next: { start_line: 3, start_column: 1 } });
expect(await f.read('read_conversation', { message_id: 'foreign' })).toContain('Read failed');
});
it('can recover the original middle of a previous teacher answer for a follow-up', async () => {
@@ -71,15 +155,17 @@ describe('teacher read scope', () => {
});
const result = await tools.execute('read_conversation',
JSON.stringify({ message_id: 'teacher:prior:assistant', start_line: 2, line_count: 1 }), f.controller.signal);
expect(result).toContain('2: 中间的原文');
expect(JSON.parse(result).text).toBe('中间的原文\n');
});
it('bounds read output and preserves explicit truncation markers', async () => {
it('honors small caller budgets and rejects invalid page ranges without leaking paths', async () => {
const f = await fixture();
await writeFile(path.join(f.project, 'large.ts'), '项目分析内容'.repeat(30000));
const result = await f.read('read_project_file', { path: 'large.ts' });
expect(Buffer.byteLength(result)).toBeLessThanOrEqual(2400);
expect(result).toContain('中间内容已省略');
expect(result).toContain('256 KiB');
const result = await f.tools.executeResult('read_project_file', JSON.stringify({ path: 'src/game.ts' }), f.controller.signal, 128);
expect(Buffer.byteLength(result.content)).toBeLessThanOrEqual(128);
for (const args of [{ start_line: 9 }, { start_column: 900 }, { line_count: 401 }, { start_line: 0 }]) {
const failure = await f.tools.executeResult('read_project_file', JSON.stringify({ path: 'src/game.ts', ...args }), f.controller.signal);
expect(failure.status).toBe('error');
expect(failure.content).not.toContain(f.project);
}
});
it('does not read after cancellation or an account change', async () => {
const f = await fixture();