tavern-harness 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -0,0 +1,345 @@
+# Changelog
+
+> 本文件由 `scripts/changelog.mjs` 从 `changelog/v*.md` 生成，请勿手动编辑。
+> 版本对比链接见文末；源文件位于仓库 `changelog/` 目录。
+
+## [0.1.13] - 2026-10-21
+
+### 中文
+
+#### 新增
+
+- 设置 → 关于新增「版本记录」：内置 v0.1.1 以来的完整更新历史，有新版本时侧栏与设置入口会显示未读圆点；运行 `tavern-harness --version` 可直接查看当前版本号
+- 世界书新增「角色卡知识库」：可为角色卡维护独立知识条目并合并进每回合召回，同时支持导入 SillyTavern 世界书 JSON
+- 支持 DeepSeek 思考模式：可设置 `reasoning_effort`，并在多轮对话中回放 `reasoning_content`
+- 局域网访问：服务默认监听局域网，新增 `--host` 绑定与侧栏二维码，手机扫码即可继续对话
+- 移动端交互增强：长按菜单、触摸拖拽排序、键盘弹出时保持布局稳定，初始化失败可重试
+
+#### 改进
+
+- 酒馆数据改为保存在主机本地（默认 `~/.tavern-harness`），访问同一实例的浏览器共享数据；首次启动会自动迁移浏览器中的旧数据，界面语言与主题仍按浏览器分别保存
+- 用户气泡、思考面板与工具卡改用不同底色和左侧色条区分，消息操作栏与内联编辑器更紧凑
+
+#### 修复
+
+- 角色工坊调整技能顺序后会先保存顺序再刷新列表
+- 修复移动端长弹窗内容超出屏幕后无法滚动
+
+#### 内部
+
+- 新增宿主端持久化服务与共享数据层，拆分持久化请求体限制并复用同源校验
+- 版本记录改由 `changelog/v*.md` 生成 JSON 与 `CHANGELOG.md`，并加入文件、tag、版本号一致性测试
+
+### English
+
+#### Added
+
+- Version history in Settings → About, covering every release since v0.1.1; an unseen dot marks new notes in the sidebar and settings, and `tavern-harness --version` prints the current version
+- Character Book knowledge tab in the world book editor: keep per-character knowledge entries, merge them into each turn's recall, and import SillyTavern world info JSON
+- DeepSeek thinking support: set `reasoning_effort` and replay `reasoning_content` across turns
+- LAN access: the server listens on the LAN by default, with `--host` binding and a sidebar QR code for continuing on a phone
+- Mobile interaction upgrades: long-press menus, touch drag sorting, a stable layout while the keyboard opens, and retryable initialization failures
+
+#### Changed
+
+- Tavern data is now stored on the host (default `~/.tavern-harness`) and shared by browsers using the same instance; existing browser data is migrated automatically on first launch, while language and theme remain per browser
+- User bubbles, thinking panels and tool cards now use distinct surfaces and left rails; message actions and the inline editor are more compact
+
+#### Fixed
+
+- Skill order is saved before the character workshop refreshes its list
+- Long modals can scroll again on mobile
+
+#### Internal
+
+- Added the host persistence service and shared data layer, split persistence body limits, and reused same-origin validation
+- Release notes are generated from `changelog/v*.md` into JSON and `CHANGELOG.md`, with tests for file/tag/version consistency
+
+## [0.1.12] - 2026-10-16
+
+### 中文
+
+#### 修复
+
+- 为外部 HTTPS 模型服务补充代理转发，修复浏览器 CORS 导致的连接失败
+
+#### 内部
+
+- README 增加中英文切换链接
+
+### English
+
+#### Fixed
+
+- Added proxy forwarding for external HTTPS model providers, fixing connection failures caused by browser CORS
+
+#### Internal
+
+- Added language links between the English and Chinese READMEs
+
+## [0.1.11] - 2026-10-15
+
+### 中文
+
+#### 新增
+
+- 角色书（Character Book）：支持编辑、导入与按关键词召回
+- 导入深度提示词并作为附加指令生效
+- 人物设定占位符在对话中正确替换为用户人设
+- 编辑器支持 Markdown 预览，聊天消息支持强调样式
+- 仪表盘新增 GitHub 入口
+
+#### 改进
+
+- 工作坊编辑器改用 Portal 渲染，避免弹窗被父容器裁剪
+- 改进原始响应日志查看器
+- 保留导入角色的完整开场白，并归一化角色卡提示词
+
+#### 修复
+
+- 修复仪表盘操作按钮边框不一致
+
+### English
+
+#### Added
+
+- Character Book: edit, import, and keyword-based recall
+- Import depth prompts and apply them as additional instructions
+- Persona placeholders are now replaced with the user's persona in conversations
+- Markdown previews in editors, plus emphasis rendering in chat messages
+- GitHub link on the dashboard
+
+#### Changed
+
+- Workshop editors now render in a portal so modals are no longer clipped by their parent
+- Improved the raw response log viewer
+- Preserved full imported greetings and normalized imported character-card prompts
+
+#### Fixed
+
+- Fixed inconsistent borders on dashboard action buttons
+
+## [0.1.10] - 2026-10-12
+
+### 中文
+
+#### 新增
+
+- YOLO 模式：可在设置中选择自动批准工具修改与 Shell 执行，减少逐次确认
+- 沙箱工作区持久化到包目录之外，升级或重装 npm 包不再丢失技能文件
+
+#### 修复
+
+- 校验并保留流式返回的工具调用参数，修复参数被截断或解析失败
+- 修复设置卡片、文档标题与仪表盘按钮的样式问题
+
+#### 内部
+
+- 新增贡献指南（CONTRIBUTING），补充测试与提交流程
+
+### English
+
+#### Added
+
+- YOLO mode: optionally auto-approve tool edits and shell execution from Settings
+- Sandbox workspace now persists outside the package directory, so skill files survive upgrades and reinstalls
+
+#### Fixed
+
+- Validate and preserve streamed tool-call arguments, fixing truncated or unparsable arguments
+- Fixed styling issues in settings cards, documentation headings, and dashboard buttons
+
+#### Internal
+
+- Added CONTRIBUTING with testing and pull-request guidelines
+
+## [0.1.9] - 2026-10-09
+
+### 中文
+
+#### 改进
+
+- 统一应用各处背景，减少页面切换时的色差
+- 更新浏览器标签页标题，显示当前所在页面
+
+### English
+
+#### Changed
+
+- Unified application backgrounds to remove color jumps between views
+- Updated browser tab titles to reflect the current page
+
+## [0.1.8] - 2026-10-09
+
+### 中文
+
+#### 修复
+
+- 修复编辑器预览与提示词区域的尺寸异常
+- 本地化「新话题」标记，切换语言后不再显示原始键值
+
+#### 新增
+
+- 补充 MIT 许可证
+
+#### 内部
+
+- 更新文档与演示视频链接，README 增加玩法展示入口
+
+### English
+
+#### Fixed
+
+- Fixed incorrect sizing in the editor preview and prompt area
+- Localized the "new topic" marker so it no longer shows a raw key after switching languages
+
+#### Added
+
+- Added the MIT license
+
+#### Internal
+
+- Refreshed documentation and demo links, and added gameplay showcases to the README
+
+## [0.1.7] - 2026-10-07
+
+### 中文
+
+#### 修复
+
+- 修复导入游戏后参与者座位顺序错乱的问题
+
+### English
+
+#### Fixed
+
+- Fixed participant seat order being scrambled after importing a game
+
+## [0.1.6] - 2026-10-07
+
+### 中文
+
+#### 改进
+
+- 对齐「仅提及」群聊模式下的系统提示词，减少角色误发言
+
+#### 内部
+
+- 文档更新：首页导航、Wiki 启动指南、README 安装说明，并补充开放生态介绍
+
+### English
+
+#### Changed
+
+- Aligned system prompts in mention-only group chats to reduce characters speaking out of turn
+
+#### Internal
+
+- Documentation refresh: homepage navigation, Wiki quick start, README setup, and an open-ecosystem section
+
+## [0.1.5] - 2026-10-07
+
+### 中文
+
+#### 修复
+
+- 修复沙箱服务在 npm 安装场景下无法从包根目录解析的问题
+
+### English
+
+#### Fixed
+
+- Fixed the sandbox server failing to resolve from the package root when installed from npm
+
+## [0.1.4] - 2026-10-07
+
+### 中文
+
+#### 修复
+
+- 补齐 React 子路径依赖的预打包，修复 `npx` 启动时解析失败
+
+### English
+
+#### Fixed
+
+- Prebundled React subpath dependencies to fix resolution failures when starting via `npx`
+
+## [0.1.3] - 2026-10-07
+
+### 中文
+
+#### 修复
+
+- 修复 React DOM 具名导入在预打包后不可用导致的页面白屏
+
+### English
+
+#### Fixed
+
+- Fixed a blank page caused by named React DOM imports breaking after prebundling
+
+## [0.1.2] - 2026-10-07
+
+### 中文
+
+#### 修复
+
+- 修复通过 npm 全局安装或 `npx` 启动时，运行时依赖未预打包导致的启动失败
+
+### English
+
+#### Fixed
+
+- Fixed startup failures after installing from npm or running via `npx` caused by unbundled runtime dependencies
+
+## [0.1.1] - 2026-10-07
+
+### 中文
+
+#### 新增
+
+- 首个公开版本：`npx tavern-harness` 一键启动，自动打开浏览器并支持局域网访问
+- 流式对话与工具调用，支持实时思考过程预览
+- 角色工坊：角色卡、世界书（Lorebook）、SillyTavern v2/v3 角色卡与 PNG 导入
+- 多人群聊与回合队列，支持角色互相 @ 与发言顺序编排
+- 内置技能与沙箱执行：文件读写、Shell 白名单命令、代码执行
+- 成就系统、统计面板、主题切换与简体中文 / 繁體中文 / English 三语界面
+- 游戏完整导出与导入、定时消息
+- 本地优先：所有数据保存在本机，不经过第三方服务
+
+#### 内部
+
+- Vite + React + Zustand + Dexie 技术栈，浏览器端本地持久化
+
+### English
+
+#### Added
+
+- First public release: one-command startup with `npx tavern-harness`, auto-opens the browser, and serves the LAN
+- Streaming chat with tool calls and live thinking preview
+- Character workshop: character cards, lorebooks, SillyTavern v2/v3 cards, and PNG import
+- Group chats with a turn queue, character @-mentions, and reorderable speaking order
+- Built-in skills and sandboxed execution: file reads/writes, allowlisted shell commands, code execution
+- Achievements, stats, themes, and Simplified Chinese / Traditional Chinese / English UI
+- Full gameplay export and import, plus scheduled messages
+- Local-first: all data stays on your machine and never passes through a third-party service
+
+#### Internal
+
+- Vite + React + Zustand + Dexie stack with browser-side local persistence
+
+<!-- 链接定义 -->
+[0.1.13]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.12...v0.1.13
+[0.1.12]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.11...v0.1.12
+[0.1.11]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.10...v0.1.11
+[0.1.10]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.9...v0.1.10
+[0.1.9]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.7...v0.1.8
+[0.1.7]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/Rannichan/Tavern-Harness/releases/tag/v0.1.1

package/README.md

@@ -10,6 +10,10 @@
   <a href="https://www.npmjs.com/package/tavern-harness"><img alt="npm" src="https://img.shields.io/npm/v/tavern-harness?style=flat-square" /></a>
 </p>
 
+<p align="center">
+  <strong>English</strong> | <a href="README.zh.md">简体中文</a>
+</p>
+
 # Tavern Harness · An AI-Native Role-Playing Sandbox
 
 <a id="demo"></a>
@@ -28,11 +32,12 @@ No repository clone or global installation is required:
 npx tavern-harness
 ```
 
-The first run downloads the package, starts the local service, and opens your browser automatically. Optional arguments:
+The first run downloads the package, starts a service accessible on your LAN, and opens your browser automatically. Optional arguments:
 
 ```bash
 npx tavern-harness --no-open
 npx tavern-harness --port 5273
+npx tavern-harness --host 127.0.0.1  # Restrict access to this computer
 npx tavern-harness --workspace /absolute/path/to/workspace
 ```
 
@@ -74,16 +79,15 @@ 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
+### Import a Gameplay 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:
+Download the gameplay 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
+### Data Storage
 
-- **All data is stored in browser IndexedDB**: conversations, character cards, lorebooks, skills, statistics, and API keys are not uploaded to any server.
-- Data is tied to the browser, port, and site origin. Switching browsers, opening a private window, or using a different port will not show existing data. This is expected browser security behavior; use the same browser and port each time.
+Tavern data is stored locally on the host and shared by browsers that open the same Tavern Harness instance. Language and theme remain browser-specific.
 
 <a id="features"></a>
 ## 3 · Features
@@ -130,6 +134,14 @@ Tavern Harness has no external harness dependency, and its UI is designed for a
 
 > The tavern is open 24 hours a day, and the Keeper is always here to help.
 
+## 5 · Changelog
+
+Every npm release is recorded in [`changelog/`](changelog/): one file per version, matched one-to-one with a git tag.
+
+- Read the full history: [CHANGELOG.md](https://github.com/Rannichan/Tavern-Harness/blob/main/CHANGELOG.md)
+- In the app: **Settings → About → View version history**
+- Maintainers: follow the release steps in [CONTRIBUTING](CONTRIBUTING.md#releases-and-changelog).
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

package/README.zh.md

@@ -10,6 +10,10 @@
   <a href="https://www.npmjs.com/package/tavern-harness"><img alt="npm" src="https://img.shields.io/npm/v/tavern-harness?style=flat-square" /></a>
 </p>
 
+<p align="center">
+  <a href="README.md">English</a> | <strong>简体中文</strong>
+</p>
+
 # Tavern Harness · AI 原生的角色扮演沙盒
 
 <a id="demo"></a>
@@ -28,11 +32,12 @@
 npx tavern-harness
 ```
 
-首次运行会下载包、启动本地服务，并自动打开浏览器。可选参数：
+首次运行会下载包、启动可从局域网访问的服务，并自动打开浏览器。可选参数：
 
 ```bash
 npx tavern-harness --no-open
 npx tavern-harness --port 5273
+npx tavern-harness --host 127.0.0.1  # 仅允许本机访问
 npx tavern-harness --workspace /absolute/path/to/workspace
 ```
 
@@ -81,10 +86,9 @@ npm run dev      # 开发服务器默认端口 5173，被占用时自动顺延
 
 [小咕嘎-gameplay.json](./docs/assets/gameplay/小咕嘎-gameplay.json)
 
-### 数据隐私须知
+### 数据存储
 
-- **全部数据存在浏览器 IndexedDB 里**：会话、角色卡、世界书、技能、统计、API Key，均**不上传任何服务器**。
-- 数据与浏览器、端口、站点绑定：换浏览器 / 开隐身窗 / 换端口看不到旧数据——这是浏览器安全机制，属正常现象。请确保每次在同一个端口启动、并在同一个浏览器打开。
+酒馆数据保存在主机本地；访问同一 Tavern Harness 实例的浏览器可共享这些数据。界面语言和主题仍随各自浏览器保存。
 
 <a id="features"></a>
 ## 3 · 产品特色
@@ -131,6 +135,14 @@ Tavern Harness 针对提高缓存命中率进行了优化，显著降低了 Toke
 
 > 酒馆24小时营业，老板随时为您服务！
 
+## 5 · 版本记录
+
+每一次 npm 发布都会记录在 [`changelog/`](changelog/) 目录中：一个版本一个文件，并与 git tag 一一对应。
+
+- 查看完整记录：[CHANGELOG.md](https://github.com/Rannichan/Tavern-Harness/blob/main/CHANGELOG.md)
+- 应用内查看：**设置 → 关于 → 查看版本记录**
+- 维护者：发布步骤见 [CONTRIBUTING](CONTRIBUTING.md#releases-and-changelog)。
+
 ## 开源协议
 
 本项目采用 [MIT License](LICENSE) 开源协议。

package/bin/cli.js

@@ -1,23 +1,34 @@
 #!/usr/bin/env node
 // bin/cli.js — npx tavern-harness 一键启动，默认自动打开浏览器
 // 用法：
-//   tavern-harness             启动并按实际端口自动打开浏览器（默认）
+//   tavern-harness             启动并按实际端口自动打开浏览器，默认允许局域网访问
 //   tavern-harness --no-open   只启动，不打开浏览器
 //   tavern-harness --port 5273 指定端口（5173 被占用时 vite 会自动顺延，
 //                              会打开顺延后的实际端口）
+//   tavern-harness --host 127.0.0.1 仅监听本机
 //   tavern-harness --workspace /path  指定生成技能文件工作区
+//   tavern-harness --version   输出当前 npm 包版本
+//
+// Requires Node.js 22.5+ because server-side data is stored with node:sqlite.
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
+import { readFileSync } from 'node:fs';
 import { createServer } from 'vite';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = join(__dirname, '..');              // 包根目录
 const configFile = join(root, 'vite.config.ts'); // 复用现有配置（cors 代理 / sandbox 懒启动都在里面）
+const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
 
 // ---- 解析命令行参数 ----
 const args = process.argv.slice(2);
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
 let open = true; // 默认自动打开浏览器
 let port;
+let host = '0.0.0.0';
 let workspace;
 for (let i = 0; i < args.length; i++) {
   const a = args[i];
@@ -25,11 +36,14 @@ for (let i = 0; i < args.length; i++) {
   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 === '--host') host = args[++i];
+  else if (a.startsWith('--host=')) host = a.slice('--host='.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 (host) serverOptions.host = host;
 if (workspace) process.env.TAVERN_HARNESS_WORKSPACE = workspace;
 
 try {
@@ -41,7 +55,7 @@ try {
   });
   await server.listen();
   server.printUrls();
-  console.log('\nTavern Harness 已启动，浏览器应已自动打开（未打开可手动访问上面 Local 地址）。按 Ctrl+C 停止。');
+  console.log(`\nTavern Harness v${pkg.version} 已启动，浏览器应已自动打开（未打开可手动访问上面 Local 地址）。按 Ctrl+C 停止。`);
 
   process.on('SIGINT', async () => {
     await server.close();

package/index.html

@@ -3,7 +3,9 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/png" href="/favicon.png" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <!-- Edge Android 只有在显式声明 interactive-widget=resizes-content 时才随软键盘
+         收缩布局视口；否则 position: fixed 的 app-shell 不收缩，输入框会被键盘盖住。 -->
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, interactive-widget=resizes-content" />
     <meta name="theme-color" content="#17120A" />
     <script>
       (() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tavern-harness",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Tavern Harness — 酒馆模式下的本地 AI Agent 助手（MyAgent-Android 的 Web 复刻）",
   "private": false,
   "type": "module",
@@ -14,22 +14,34 @@
     "index.html",
     "vite.config.ts",
     "sandbox-server.mjs",
+    "persistence-server.mjs",
     "tsconfig.json",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.6.0"
   },
   "scripts": {
     "start": "vite",
     "dev": "vite",
-    "test": "node --test *.test.mjs",
+    "test": "node --experimental-strip-types --test *.test.mjs",
     "test:character-book": "node --test character-book.test.mjs",
+    "test:silly-tavern-world-info": "node --test silly-tavern-world-info.test.mjs",
+    "test:openai-request": "node --test openai-request.test.mjs",
     "test:command-service": "node sandbox-server.test.mjs",
+    "test:persistence-service": "node persistence-server.test.mjs",
     "test:yolo-mode": "node yolo-mode.test.mjs",
     "test:tool-arguments": "node tool-arguments.test.mjs",
+    "test:long-press": "node --experimental-strip-types --test long-press.test.mjs",
     "build": "tsc --noEmit && vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "test:preview-persistence": "node preview-persistence.test.mjs",
+    "changelog:new": "node scripts/changelog.mjs new",
+    "changelog:build": "node scripts/changelog.mjs build",
+    "changelog:check": "node scripts/changelog.mjs check",
+    "changelog:check:release": "node scripts/changelog.mjs check --release",
+    "prepublishOnly": "npm run build && npm run changelog:check:release"
   },
   "dependencies": {
     "@codemirror/lang-json": "^6.0.2",
@@ -45,6 +57,7 @@
     "marked": "^12.0.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "qrcode.react": "^4.2.0",
     "vite": "^5.4.21",
     "zustand": "^4.5.5"
   },