@jpssff/vanor 0.1.0

package/base/test/core.test.js

@@ -0,0 +1,154 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import os from "node:os";
+import { Session } from "../core/session.js";
+import { buildSystemPrompt } from "../core/prompt.js";
+import { createI18n } from "../i18n/index.js";
+import { NullLogger } from "../logger.js";
+
+test("estimatedTokens 约 4 字符/token", () => {
+  const s = new Session({ sessions: os.tmpdir() }, new NullLogger(), {});
+  s.messages.push({ role: "user", content: "a".repeat(40) });
+  assert.equal(s.estimatedTokens(), 10);
+});
+
+test("系统提示词在 CLI 渠道下提示终端格式", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "cli",
+    i18n: createI18n("zh-CN"),
+  });
+  assert.match(sys, /命令行|CLI/);
+  assert.match(sys, /通讯方式/);
+  assert.match(sys, /终端能力|TERM=/);
+  assert.match(sys, /运行环境/);
+  assert.match(sys, /Node\.js/);
+  assert.match(sys, /操作系统/);
+  assert.match(sys, /UTC[+-]\d{2}:\d{2}/);
+});
+
+test("系统提示词注入 Vanor 实例上下文", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/workspace",
+    channel: "cli",
+    i18n: createI18n("zh-CN"),
+    instance: {
+      model: "wanyou/deepseek/deepseek-v4-pro",
+      configPath: "/home/u/.vanor/config.json",
+      paths: {
+        root: "/home/u/.vanor",
+        sessions: "/home/u/.vanor/sessions",
+        memory: "/home/u/.vanor/memory",
+        skills: "/home/u/.vanor/skills",
+        logs: "/home/u/.vanor/logs",
+      },
+      sessionId: "sess_1",
+      sessionRestored: true,
+      approval: "ask",
+      skillDirs: ["/home/u/.vanor/skills", "/workspace/.skills"],
+      skillsCount: 2,
+    },
+  });
+  assert.match(sys, /Vanor 实例上下文/);
+  assert.match(sys, /当前模型：wanyou\/deepseek\/deepseek-v4-pro/);
+  assert.match(sys, /当前 provider：wanyou/);
+  assert.match(sys, /配置文件：\/home\/u\/\.vanor\/config\.json/);
+  assert.match(sys, /当前会话：sess_1（从历史恢复）/);
+  assert.match(sys, /工具审批模式：ask/);
+  assert.match(sys, /已加载技能数：2/);
+  assert.match(sys, /不要输出 API Key/);
+});
+
+test("系统提示词在 Intl 缺失时仍可构造时区信息", () => {
+  const desc = Object.getOwnPropertyDescriptor(globalThis, "Intl");
+  try {
+    Object.defineProperty(globalThis, "Intl", { value: undefined, configurable: true });
+    const sys = buildSystemPrompt({
+      memory: { snapshot: () => "" },
+      skills: [],
+      summary: "",
+      workspaceRoot: "/x",
+      channel: "cli",
+    i18n: createI18n("zh-CN"),
+    });
+    assert.match(sys, /当前时间/);
+    assert.match(sys, /UTC[+-]\d{2}:\d{2}/);
+  } finally {
+    if (desc) Object.defineProperty(globalThis, "Intl", desc);
+  }
+});
+
+test("CLI 渠道注入具体终端能力（宽度/类型）", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "cli",
+    i18n: createI18n("zh-CN"),
+    terminal: { cols: 120, rows: 30, term: "xterm-256color", color: true, trueColor: true },
+  });
+  assert.match(sys, /TERM=xterm-256color/);
+  assert.match(sys, /120 列/);
+  assert.match(sys, /真彩色/);
+});
+
+test("无颜色终端不显示真彩色标注", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "cli",
+    i18n: createI18n("zh-CN"),
+    terminal: { cols: 80, rows: 24, term: "dumb", color: false, trueColor: true },
+  });
+  assert.match(sys, /不支持颜色/);
+  assert.doesNotMatch(sys, /真彩色/);
+});
+
+test("非 CLI 渠道不注入终端能力", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "im",
+    i18n: createI18n("zh-CN"),
+  });
+  assert.doesNotMatch(sys, /TERM=/);
+});
+
+test("非 CLI 渠道使用通用格式说明", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "im",
+    i18n: createI18n("zh-CN"),
+  });
+  assert.match(sys, /通讯渠道/);
+});
+
+test("系统提示词支持英文语言", () => {
+  const sys = buildSystemPrompt({
+    memory: { snapshot: () => "" },
+    skills: [],
+    summary: "",
+    workspaceRoot: "/x",
+    channel: "cli",
+    i18n: createI18n("en"),
+    terminal: { cols: 100, rows: 30, term: "xterm", color: false, trueColor: false },
+  });
+  assert.match(sys, /Runtime environment/);
+  assert.match(sys, /Default response language: English/);
+  assert.match(sys, /Terminal capabilities/);
+  assert.doesNotMatch(sys, /运行环境/);
+});

package/base/test/i18n.test.js

@@ -0,0 +1,32 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { createI18n, detectLanguage, normalizeLanguage } from "../i18n/index.js";
+
+test("normalizeLanguage 归一化常见系统语言格式", () => {
+  assert.equal(normalizeLanguage("zh_CN.UTF-8"), "zh-CN");
+  assert.equal(normalizeLanguage("zh-Hans"), "zh-CN");
+  assert.equal(normalizeLanguage("en_US.UTF-8"), "en");
+  assert.equal(normalizeLanguage("fr_FR.UTF-8"), "en");
+});
+
+test("detectLanguage 根据环境变量检测语言", () => {
+  assert.equal(detectLanguage({ ui: { language: "auto" } }, { LANG: "zh_CN.UTF-8" }).language, "zh-CN");
+  assert.equal(detectLanguage({ ui: { language: "auto" } }, { LANG: "en_US.UTF-8" }).language, "en");
+});
+
+test("config.ui.language 优先于系统语言", () => {
+  const detected = detectLanguage({ ui: { language: "en" } }, { LANG: "zh_CN.UTF-8" });
+  assert.equal(detected.language, "en");
+  assert.equal(detected.source, "config");
+});
+
+test("无法确认语言时回退英文", () => {
+  const detected = detectLanguage({ ui: { language: "auto" } }, {}, null);
+  assert.equal(detected.language, "en");
+});
+
+test("缺失翻译 key 回退英文或 key 本身", () => {
+  const zh = createI18n("zh-CN");
+  assert.equal(zh.t("cli.banner"), "Vanor 万佑");
+  assert.equal(zh.t("missing.key"), "missing.key");
+});

package/base/test/loop.test.js

@@ -0,0 +1,97 @@
+// 集成冒烟：mock LLM 跑最小 loop，验证 LLM ↔ 工具 全链路。
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createSecurity } from "../security/index.js";
+import { defaultRegistry, createToolContext } from "../tools/index.js";
+import { Session } from "../core/session.js";
+import { runLoop } from "../core/loop.js";
+import { NullLogger } from "../logger.js";
+
+test("最小 loop：工具调用 → 结果 → 文本结束", async () => {
+  const ws = fs.mkdtempSync(path.join(os.tmpdir(), "vanor-loop-"));
+  fs.writeFileSync(path.join(ws, "hello.txt"), "HELLO");
+  const sessionsDir = path.join(ws, "sessions");
+
+  const security = createSecurity({ security: { approval: "auto", workspaceRoot: ws } });
+  const registry = defaultRegistry();
+  const toolCtx = createToolContext({ security, logger: new NullLogger(), confirm: async () => true });
+  const session = new Session({ sessions: sessionsDir }, new NullLogger(), { model: "mock/m" });
+  session.start();
+  session.addMessage({ id: "u1", role: "user", content: "读取 hello.txt", meta: {} });
+
+  // mock LLM：第一轮发起读取，第二轮基于结果输出文本
+  let calls = 0;
+  const llm = {
+    async *stream() {
+      calls++;
+      if (calls === 1) {
+        yield { type: "tool_call", call: { id: "c1", name: "read_file", arguments: { path: "hello.txt" } } };
+        yield { type: "done", finishReason: "tool_calls" };
+      } else {
+        yield { type: "text", delta: "文件内容是 HELLO" };
+        yield { type: "done", finishReason: "stop" };
+      }
+    },
+    async gather() {
+      return { text: "", toolCalls: [], usage: null, finishReason: "stop" };
+    },
+  };
+
+  const deps = {
+    llm,
+    registry,
+    toolCtx,
+    config: { agent: { maxIterations: 5 }, memory: {} },
+    model: "mock/m",
+    tools: registry.schemas(),
+    buildSystem: () => "system",
+    logger: new NullLogger(),
+  };
+
+  const result = await runLoop(session, deps, {});
+  assert.ok(result.assistant);
+  assert.equal(result.assistant.content, "文件内容是 HELLO");
+
+  // 会话中应包含一条 read_file 的 tool 结果，内容为文件内容
+  const toolMsg = session.messages.find((m) => m.role === "tool");
+  assert.ok(toolMsg);
+  assert.equal(toolMsg.content, "HELLO");
+  assert.equal(calls, 2);
+});
+
+test("达到最大迭代次数会停止", async () => {
+  const ws = fs.mkdtempSync(path.join(os.tmpdir(), "vanor-loop2-"));
+  const security = createSecurity({ security: { approval: "auto", workspaceRoot: ws } });
+  const registry = defaultRegistry();
+  const toolCtx = createToolContext({ security, logger: new NullLogger(), confirm: async () => true });
+  const session = new Session({ sessions: path.join(ws, "s") }, new NullLogger(), {});
+  session.start();
+  session.addMessage({ id: "u1", role: "user", content: "loop", meta: {} });
+
+  // 永远返回工具调用 → 触发上限
+  const llm = {
+    async *stream() {
+      yield { type: "tool_call", call: { id: "c", name: "list_dir", arguments: { path: "." } } };
+      yield { type: "done", finishReason: "tool_calls" };
+    },
+    async gather() {
+      return { text: "" };
+    },
+  };
+  const deps = {
+    llm,
+    registry,
+    toolCtx,
+    config: { agent: { maxIterations: 3 }, memory: {} },
+    model: "mock/m",
+    tools: registry.schemas(),
+    buildSystem: () => "system",
+    logger: new NullLogger(),
+  };
+  const result = await runLoop(session, deps, {});
+  assert.equal(result.maxIterations, true);
+});

package/base/test/memory.test.js

@@ -0,0 +1,47 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createMemory } from "../memory/index.js";
+import { NullLogger } from "../logger.js";
+
+function tempPaths() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "vanor-mem-"));
+  return { memory: path.join(root, "memory"), working: path.join(root, "memory", "working") };
+}
+
+const config = { memory: { memoryMaxChars: 2200, userMaxChars: 1375 } };
+
+test("add 后 snapshot 含条目", () => {
+  const mem = createMemory(tempPaths(), config, new NullLogger());
+  mem.apply({ action: "add", target: "memory", content: "用户使用 macOS" });
+  assert.match(mem.snapshot(), /macOS/);
+});
+
+test("replace 唯一匹配", () => {
+  const mem = createMemory(tempPaths(), config, new NullLogger());
+  mem.apply({ action: "add", target: "user", content: "偏好深色模式" });
+  const r = mem.apply({ action: "replace", target: "user", old_text: "深色", content: "偏好浅色模式" });
+  assert.ok(!r.isError);
+  assert.match(mem.snapshot(), /浅色/);
+});
+
+test("remove 删除条目", () => {
+  const mem = createMemory(tempPaths(), config, new NullLogger());
+  mem.apply({ action: "add", target: "memory", content: "临时事实" });
+  mem.apply({ action: "remove", target: "memory", old_text: "临时事实" });
+  assert.doesNotMatch(mem.snapshot(), /临时事实/);
+});
+
+test("search 关键词命中", () => {
+  const mem = createMemory(tempPaths(), config, new NullLogger());
+  mem.apply({ action: "add", target: "memory", content: "项目使用 Node.js 与 SQLite" });
+  const hits = mem.search("sqlite");
+  assert.equal(hits.length, 1);
+});
+
+test("空记忆 snapshot 为空串", () => {
+  const mem = createMemory(tempPaths(), config, new NullLogger());
+  assert.equal(mem.snapshot(), "");
+});

package/base/test/message.test.js

@@ -0,0 +1,38 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import {
+  userMessage,
+  assistantMessage,
+  toolMessage,
+  validateAlternation,
+} from "../transport/message.js";
+
+test("消息构造带 id 与时间戳", () => {
+  const m = userMessage("hi");
+  assert.equal(m.role, "user");
+  assert.equal(m.content, "hi");
+  assert.ok(m.id.startsWith("msg_"));
+  assert.ok(m.meta.timestamp);
+});
+
+test("assistant 带 toolCalls", () => {
+  const m = assistantMessage("", [{ id: "c1", name: "read_file", arguments: {} }]);
+  assert.equal(m.toolCalls.length, 1);
+});
+
+test("toolMessage 标记错误", () => {
+  const m = toolMessage({ toolCallId: "c1", name: "x", content: "boom", isError: true });
+  assert.equal(m.role, "tool");
+  assert.equal(m.toolCallId, "c1");
+  assert.equal(m.meta.isError, true);
+});
+
+test("validateAlternation 检测连续 user", () => {
+  const errs = validateAlternation([userMessage("a"), userMessage("b")]);
+  assert.ok(errs.length >= 1);
+});
+
+test("validateAlternation 合法序列通过", () => {
+  const errs = validateAlternation([userMessage("a"), assistantMessage("b")]);
+  assert.deepEqual(errs, []);
+});