Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { describe, expect, it } from 'vitest';
import {
buildProjectDeepLink,
buildSessionDeepLink,
buildSessionMessageDeepLink,
parseProjectDeepLinkHref,
parseSessionDeepLinkHref,
PROJECT_DEEP_LINK_RE_SOURCE,
SESSION_DEEP_LINK_RE_SOURCE,
} from '../lib/deepLink';
describe('buildProjectDeepLink(严格编码,review P2)', () => {
it('escapes !\'()* so generated links never contain bare matcher delimiters', () => {
const workingDir = "/Users/alice/Projects/my(app)'s dir!*";
const href = buildProjectDeepLink(workingDir);
// 生成一律主 scheme;切片按主 scheme 前缀长度(双 scheme 后长度不同)。
expect(href.startsWith('cindy://project/')).toBe(true);
expect(/[!'()]/.test(href.slice('cindy://project/'.length))).toBe(false);
// 解析端零改动:decodeURIComponent 原生可解严格编码,roundtrip 不变形。
expect(parseProjectDeepLinkHref(href)).toEqual({ workingDir });
// 文本匹配白名单能吃下整条生成的链接(不在括号处截断)。
const match = href.match(new RegExp(PROJECT_DEEP_LINK_RE_SOURCE));
expect(match?.[0]).toBe(href);
});
});
describe('parseSessionDeepLinkHref', () => {
it('parses a bare session href', () => {
expect(parseSessionDeepLinkHref('xdt-maker://session/abc-123')).toEqual({
sessionId: 'abc-123',
messageClientId: null,
deviceId: null,
});
});
it('roundtrips builder output including message anchor', () => {
expect(parseSessionDeepLinkHref(buildSessionDeepLink('id with space'))).toEqual({
sessionId: 'id with space',
messageClientId: null,
deviceId: null,
});
expect(parseSessionDeepLinkHref(buildSessionMessageDeepLink('abc', 'client/9'))).toEqual({
sessionId: 'abc',
messageClientId: 'client/9',
deviceId: null,
});
});
it('ignores empty or malformed message anchor but keeps session id', () => {
expect(parseSessionDeepLinkHref('xdt-maker://session/abc?message=')).toEqual({
sessionId: 'abc',
messageClientId: null,
deviceId: null,
});
expect(parseSessionDeepLinkHref('xdt-maker://session/abc?message=%ZZ')).toEqual({
sessionId: 'abc',
messageClientId: null,
deviceId: null,
});
expect(parseSessionDeepLinkHref('xdt-maker://session/abc?foo=1&message=m1')).toEqual({
sessionId: 'abc',
messageClientId: 'm1',
deviceId: null,
});
});
it('strips fragments and trailing slashes', () => {
expect(parseSessionDeepLinkHref('xdt-maker://session/abc/#frag')).toEqual({
sessionId: 'abc',
messageClientId: null,
deviceId: null,
});
});
it('rejects non-session hrefs and empty ids', () => {
expect(parseSessionDeepLinkHref('xdt-maker://project/dir')).toBeNull();
expect(parseSessionDeepLinkHref('xdt-maker://session/')).toBeNull();
expect(parseSessionDeepLinkHref('https://example.com')).toBeNull();
expect(parseSessionDeepLinkHref('xdt-maker://session/%ZZ')).toBeNull();
});
});
// 远程会话深链冻结归属设备(`?device=`):生成/解析对称,旧格式回退 null。
describe('session deep link device parameter', () => {
it('freezes deviceId into the link and roundtrips through the parser', () => {
const href = buildSessionDeepLink('abc-123', { deviceId: 'dev-mac~1' });
expect(href).toBe('cindy://session/abc-123?device=dev-mac~1');
expect(parseSessionDeepLinkHref(href)).toEqual({
sessionId: 'abc-123',
messageClientId: null,
deviceId: 'dev-mac~1',
});
});
it('combines message anchor and device parameter', () => {
const href = buildSessionMessageDeepLink('abc', 'client/9', { deviceId: 'dev-1' });
expect(href).toBe('cindy://session/abc?message=client%2F9&device=dev-1');
expect(parseSessionDeepLinkHref(href)).toEqual({
sessionId: 'abc',
messageClientId: 'client/9',
deviceId: 'dev-1',
});
});
it('omits the parameter for local sessions (null/undefined deviceId)', () => {
expect(buildSessionDeepLink('abc', { deviceId: null })).toBe('cindy://session/abc');
expect(buildSessionMessageDeepLink('abc', 'm1', {})).toBe('cindy://session/abc?message=m1');
});
it('ignores empty or malformed device values but keeps the rest of the link', () => {
expect(parseSessionDeepLinkHref('cindy://session/abc?device=')).toEqual({
sessionId: 'abc',
messageClientId: null,
deviceId: null,
});
expect(parseSessionDeepLinkHref('cindy://session/abc?device=%ZZ&message=m1')).toEqual({
sessionId: 'abc',
messageClientId: 'm1',
deviceId: null,
});
});
it('is fully matched by the free-text session link pattern', () => {
const href = buildSessionMessageDeepLink('abc', 'm1', { deviceId: 'dev-1' });
const match = `看这条 ${href}。`.match(new RegExp(SESSION_DEEP_LINK_RE_SOURCE));
expect(match?.[0].replace(/[.,;:!?]+$/, '')).toBe(href);
});
});
// 双 scheme 收敛:生成一律 cindy://,解析 cindy + 历史 xdt-maker 都认
// (上面的 xdt-maker:// 用例即历史 scheme 回归)。
describe('dual scheme (cindy primary + legacy xdt-maker)', () => {
it('builders emit the primary cindy:// scheme', () => {
expect(buildSessionDeepLink('abc-123')).toBe('cindy://session/abc-123');
expect(buildSessionMessageDeepLink('abc-123', 'm1')).toBe(
'cindy://session/abc-123?message=m1',
);
expect(buildProjectDeepLink('/tmp/x')).toBe('cindy://project/%2Ftmp%2Fx');
});
it('parsers accept primary-scheme cindy:// hrefs', () => {
expect(parseSessionDeepLinkHref('cindy://session/abc-123?message=m1')).toEqual({
sessionId: 'abc-123',
messageClientId: 'm1',
deviceId: null,
});
expect(parseProjectDeepLinkHref('cindy://project/%2Ftmp%2Fx')).toEqual({
workingDir: '/tmp/x',
});
expect(parseSessionDeepLinkHref('cindy://session/')).toBeNull();
});
});