tavern-harness 0.1.9 → 0.1.11

package/README.md

@@ -33,6 +33,7 @@ The first run downloads the package, starts the local service, and opens your br
 ```bash
 npx tavern-harness --no-open
 npx tavern-harness --port 5273
+npx tavern-harness --workspace /absolute/path/to/workspace
 ```
 
 ### Option 2: Global Installation (Recommended for Regular Use)
@@ -73,6 +74,12 @@ After starting the app, open **Settings → Model Service Provider**:
 2. **Test the connection**: the app fetches the model list automatically. If the target service does not expose CORS headers, requests are forwarded through the built-in same-origin proxy for private-network or LAN addresses. On success, the Base URL is rewritten to its proxy form and saved.
 3. **Select a model**: click the model name at the top of the chat page, then return to the conversation and start chatting.
 
+### Import a Game and Start Playing
+
+Download the game file below. Click **Import** in the upper-left corner, then import the file you downloaded to create a complete game environment—including characters, lorebooks, skills, and more—and start playing right away:
+
+[th-demo-affinity-gameplay-en.json](./docs/assets/gameplay/th-demo-affinity-gameplay-en.json)
+
 ### Data Privacy
 
 - **All data is stored in browser IndexedDB**: conversations, character cards, lorebooks, skills, statistics, and API keys are not uploaded to any server.
@@ -105,11 +112,13 @@ Compatible with the **Tavern ecosystem**, including one-click PNG character-card
 
 You can also export and share an entire game: recipients can import it and play immediately without manually creating characters, skills, or conversation settings.
 
-### 🍃 Fully Local and Clean
+### 🍃 Fully Local / High Cache Hit Rates / Clean
 
 The app supports **OpenAI-format APIs**. Use a hosted API plan or run a model locally; your data remains on your device.
 
-The project has no external harness dependency, and its UI is designed for a clean, focused experience.
+Tavern Harness is optimized to improve cache hit rates, significantly reducing token costs.
+
+Tavern Harness has no external harness dependency, and its UI is designed for a clean, focused experience.
 
 <a id="feedback"></a>
 ## 4 · Community and Feedback

package/README.zh.md

@@ -33,6 +33,7 @@ npx tavern-harness
 ```bash
 npx tavern-harness --no-open
 npx tavern-harness --port 5273
+npx tavern-harness --workspace /absolute/path/to/workspace
 ```
 
 
@@ -74,6 +75,12 @@ npm run dev      # 开发服务器默认端口 5173，被占用时自动顺延
 2. **测试连接**：自动拉取模型列表。若目标服务未开 CORS 头，会自动经内置同源代理转发（仅限内网 / 局域网地址），成功后 Base URL 自动改写为代理形式保存
 3. **选模型**：聊天页顶部点击模型名即可，回到对话开聊！
 
+### 导入游戏并开始
+
+下载以下游戏文件，点击左上角的「导入」按钮，然后导入刚刚下载的文件，即可创建一整套游戏环境（包括角色、世界书、技能等），直接体验：
+
+[小咕嘎-gameplay.json](./docs/assets/gameplay/小咕嘎-gameplay.json)
+
 ### 数据隐私须知
 
 - **全部数据存在浏览器 IndexedDB 里**：会话、角色卡、世界书、技能、统计、API Key，均**不上传任何服务器**。
@@ -106,11 +113,13 @@ npm run dev      # 开发服务器默认端口 5173，被占用时自动顺延
 
 同时支持**游戏一键打包分享**：对方直接导入即可游玩，无需手动创建角色、技能、配置对话。
 
-### 🍃 完全本地 / 简洁干净
+### 🍃 完全本地 / 高缓存命中率 / 简洁干净
 
 目前支持 **OpenAI 格式的 API 接口**：你可以使用你的 token plan，也可以自己本地部署模型，一切数据都保存在本地。
 
-项目不依赖任何外部 harness，UI 也经过了精细打磨，提供简洁干净的体验。
+Tavern Harness 针对提高缓存命中率进行了优化，显著降低了 Token 成本。
+
+并且 Tavern Harness 不依赖任何外部 harness，UI 也经过了精细打磨，提供简洁干净的体验。
 
 <a id="feedback"></a>
 ## 4 · 交流反馈

package/bin/cli.js

@@ -5,6 +5,7 @@
 //   tavern-harness --no-open   只启动，不打开浏览器
 //   tavern-harness --port 5273 指定端口（5173 被占用时 vite 会自动顺延，
 //                              会打开顺延后的实际端口）
+//   tavern-harness --workspace /path  指定生成技能文件工作区
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { createServer } from 'vite';
@@ -17,15 +18,19 @@ const configFile = join(root, 'vite.config.ts'); // 复用现有配置（cors
 const args = process.argv.slice(2);
 let open = true; // 默认自动打开浏览器
 let port;
+let workspace;
 for (let i = 0; i < args.length; i++) {
   const a = args[i];
   if (a === '--no-open') open = false;
   else if (a === '--open') open = true;
   else if (a === '--port') port = Number(args[++i]);
   else if (a.startsWith('--port=')) port = Number(a.slice('--port='.length));
+  else if (a === '--workspace') workspace = args[++i];
+  else if (a.startsWith('--workspace=')) workspace = a.slice('--workspace='.length);
 }
 const serverOptions = { open };
 if (Number.isInteger(port) && port > 0 && port < 65536) serverOptions.port = port;
+if (workspace) process.env.TAVERN_HARNESS_WORKSPACE = workspace;
 
 try {
   // inlineConfig 与 vite.config.ts 合并（inline 优先），open 会覆盖配置文件里的 open:false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tavern-harness",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Tavern Harness — 酒馆模式下的本地 AI Agent 助手（MyAgent-Android 的 Web 复刻）",
   "private": false,
   "type": "module",
@@ -23,11 +23,18 @@
   "scripts": {
     "start": "vite",
     "dev": "vite",
+    "test": "node --test *.test.mjs",
+    "test:character-book": "node --test character-book.test.mjs",
     "test:command-service": "node sandbox-server.test.mjs",
+    "test:yolo-mode": "node yolo-mode.test.mjs",
+    "test:tool-arguments": "node tool-arguments.test.mjs",
     "build": "tsc --noEmit && vite build",
     "preview": "vite preview"
   },
   "dependencies": {
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/state": "^6.7.6",
+    "@codemirror/view": "^6.43.14",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -45,6 +52,7 @@
     "@types/katex": "^0.16.7",
     "@types/react": "^18.3.5",
     "@types/react-dom": "^18.3.0",
+    "fake-indexeddb": "^6.2.5",
     "typescript": "^5.5.4"
   }
 }

package/sandbox-server.mjs

@@ -22,10 +22,10 @@ import { createServer } from 'node:http';
 import { spawn, spawnSync } from 'node:child_process';
 import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
 import {
-  writeFileSync, existsSync, lstatSync, readlinkSync, readFile, writeFile, mkdirSync, mkdtempSync, readdir, statSync, symlinkSync, realpathSync, rmSync, unlink,
+  writeFileSync, existsSync, lstatSync, readlinkSync, readFile, writeFile, mkdirSync, mkdtempSync, readdir, statSync, symlinkSync, realpathSync, rmSync, unlink, cpSync,
 } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, dirname, resolve, sep, delimiter } from 'node:path';
+import { tmpdir, homedir } from 'node:os';
+import { join, dirname, resolve, sep, delimiter, isAbsolute } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -299,11 +299,40 @@ function consumeApprovedConfirmation(requestId, operation, sessionBase) {
 }
 
 // ---- 真实文件工作区（generate_skill 的 file_read / file_write 落盘区） ----
-// 项目根目录下 sandbox_workspace/，仅允许读写该目录内文件（虚拟磁盘）。
-// 会话隔离：每次请求必须携带会话工作目录（session 字段，如 "session-12"），
-// 所有读写/执行都锁定在该目录内，不允许回退到共享根工作区。
-const WORKSPACE_ROOT = resolve(__dirname, 'sandbox_workspace');
-const PUBLIC_WORKSPACE = join(WORKSPACE_ROOT, 'public');
+// 默认放在用户数据目录，避免 npm 更新或重装删除用户创建的文件。
+// 可通过 TAVERN_HARNESS_WORKSPACE 指向自定义绝对路径。
+function defaultWorkspaceRoot() {
+  if (process.platform === 'darwin') return join(homedir(), 'Library', 'Application Support', 'Tavern Harness', 'sandbox_workspace');
+  if (process.platform === 'win32') return join(process.env.APPDATA || join(homedir(), 'AppData', 'Roaming'), 'Tavern Harness', 'sandbox_workspace');
+  return join(process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share'), 'tavern-harness', 'sandbox_workspace');
+}
+
+function resolveWorkspaceRoot() {
+  const configured = process.env.TAVERN_HARNESS_WORKSPACE?.trim();
+  if (configured) {
+    if (!isAbsolute(configured)) throw new Error('TAVERN_HARNESS_WORKSPACE must be an absolute path');
+    return resolve(configured);
+  }
+  return defaultWorkspaceRoot();
+}
+
+const WORKSPACE_ROOT = resolveWorkspaceRoot();
+const LEGACY_WORKSPACE_ROOT = resolve(__dirname, 'sandbox_workspace');
+
+function migrateLegacyWorkspace() {
+  if (WORKSPACE_ROOT === LEGACY_WORKSPACE_ROOT || existsSync(WORKSPACE_ROOT) || !existsSync(LEGACY_WORKSPACE_ROOT)) return;
+  try {
+    mkdirSync(dirname(WORKSPACE_ROOT), { recursive: true });
+    cpSync(LEGACY_WORKSPACE_ROOT, WORKSPACE_ROOT, { recursive: true, dereference: false, errorOnExist: true });
+    console.log(`[command-service] migrated workspace to ${WORKSPACE_ROOT}`);
+  } catch (error) {
+    console.warn(`[command-service] could not migrate legacy workspace: ${error.message}`);
+  }
+}
+
+migrateLegacyWorkspace();
+const RESOLVED_WORKSPACE_ROOT = existsSync(WORKSPACE_ROOT) ? realpathSync(WORKSPACE_ROOT) : WORKSPACE_ROOT;
+const PUBLIC_WORKSPACE = join(RESOLVED_WORKSPACE_ROOT, 'public');
 const MAX_FILE_READ_CHARS = 100_000;   // 单文件读取上限（与前端虚拟工作区一致）
 const MAX_FILE_WRITE_BYTES = 400 * 1024; // 单文件写入上限 400KB
 const MAX_LIST_ENTRIES = 500;
@@ -320,7 +349,7 @@ function resolveSessionBase(session) {
   if (!raw || raw.startsWith('/') || raw === '.' || raw === '..' || !SESSION_DIR_RE.test(raw)) {
     throw new Error('A valid session workspace is required');
   }
-  return join(WORKSPACE_ROOT, raw);
+  return join(RESOLVED_WORKSPACE_ROOT, raw);
 }
 
 /** 创建会话目录，并为普通会话提供固定的只读公共目录入口。 */

package/src/components/CharacterBookEditor.tsx

@@ -0,0 +1,77 @@
+import { memo, useEffect, useRef } from 'react';
+import { Compartment, EditorState } from '@codemirror/state';
+import { EditorView, lineNumbers } from '@codemirror/view';
+import { json } from '@codemirror/lang-json';
+
+const CharacterBookEditor = memo(function CharacterBookEditor({
+  value,
+  onChange,
+  placeholder,
+  readOnly = false,
+  lineWrapping = true,
+  className,
+}: {
+  value: string;
+  onChange?: (value: string) => void;
+  placeholder: string;
+  readOnly?: boolean;
+  lineWrapping?: boolean;
+  className?: string;
+}) {
+  const containerRef = useRef<HTMLDivElement>(null);
+  const viewRef = useRef<EditorView | null>(null);
+  const onChangeRef = useRef(onChange);
+  const wrappingRef = useRef(new Compartment());
+  const readOnlyRef = useRef(new Compartment());
+
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+
+  useEffect(() => {
+    if (!containerRef.current) return;
+
+    const view = new EditorView({
+      state: EditorState.create({
+        doc: value,
+        extensions: [
+          lineNumbers(),
+          json(),
+          wrappingRef.current.of(lineWrapping ? EditorView.lineWrapping : []),
+          readOnlyRef.current.of(readOnly ? [EditorState.readOnly.of(true), EditorView.editable.of(false)] : []),
+          EditorView.updateListener.of((update) => {
+            if (update.docChanged) onChangeRef.current?.(update.state.doc.toString());
+          }),
+        ],
+      }),
+      parent: containerRef.current,
+    });
+    viewRef.current = view;
+
+    return () => view.destroy();
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  useEffect(() => {
+    const view = viewRef.current;
+    if (view) view.dispatch({ effects: wrappingRef.current.reconfigure(lineWrapping ? EditorView.lineWrapping : []) });
+  }, [lineWrapping]);
+
+  useEffect(() => {
+    const view = viewRef.current;
+    if (view) view.dispatch({
+      effects: readOnlyRef.current.reconfigure(readOnly ? [EditorState.readOnly.of(true), EditorView.editable.of(false)] : []),
+    });
+  }, [readOnly]);
+
+  useEffect(() => {
+    const view = viewRef.current;
+    if (view && value !== view.state.doc.toString()) {
+      view.dispatch({ changes: { from: 0, to: view.state.doc.length, insert: value } });
+    }
+  }, [value]);
+
+  return <div ref={containerRef} className={`character-book-editor ${className ?? ''}`.trim()} aria-label={placeholder} />;
+});
+
+export default CharacterBookEditor;