tavern-harness 0.1.25 → 0.1.26

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 > 本文件由 `scripts/changelog.mjs` 从 `changelog/v*.md` 生成，请勿手动编辑。
 > 版本对比链接见文末；源文件位于仓库 `changelog/` 目录。
 
+## [0.1.26] - 2026-10-27
+
+### 中文
+
+#### 改进
+
+- 角色卡与世界书的知识库编辑器现在支持 JSON 语法高亮，键名、字符串、数字等用不同颜色区分，长内容更容易扫读
+- 知识库 JSON 格式有误时，提示会指出具体出错的第几行，方便直接定位修改
+
+#### 修复
+
+- 修复手机上编辑角色时，切换「角色 / 知识库」标签会收起键盘、底部按钮随之闪烁跳动的问题
+- 修复技能卡片里过长的工具名在手机上撑出屏幕、把操作按钮挤到看不见的问题
+
+### English
+
+#### Changed
+
+- The character-card and world-book knowledge editors now highlight JSON syntax, coloring keys, strings, and numbers so long entries are easier to scan
+- When knowledge-base JSON is invalid, the error now names the exact line, so the problem can be found and fixed directly
+
+#### Fixed
+
+- Fixed an issue on mobile where switching between the Character and Knowledge tabs while editing a character dismissed the keyboard and made the bottom buttons flicker
+- Fixed overly long tool names in skill cards overflowing the screen on mobile and pushing the action buttons out of view
+
 ## [0.1.25] - 2026-10-27
 
 ### 中文
@@ -716,6 +742,7 @@
 - Vite + React + Zustand + Dexie stack with browser-side local persistence
 
 <!-- 链接定义 -->
+[0.1.26]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.25...v0.1.26
 [0.1.25]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.24...v0.1.25
 [0.1.24]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.23...v0.1.24
 [0.1.23]: https://github.com/Rannichan/Tavern-Harness/compare/v0.1.22...v0.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tavern-harness",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Tavern Harness — 酒馆模式下的本地 AI Agent 助手（MyAgent-Android 的 Web 复刻）",
   "private": false,
   "type": "module",

package/src/components/CharacterBookEditor.tsx

@@ -1,7 +1,17 @@
 import { memo, useEffect, useRef } from 'react';
 import { Compartment, EditorState } from '@codemirror/state';
 import { EditorView, lineNumbers } from '@codemirror/view';
+import { HighlightStyle, syntaxHighlighting } from '@codemirror/language';
 import { json } from '@codemirror/lang-json';
+import { tags } from '@lezer/highlight';
+
+const characterBookJsonHighlight = syntaxHighlighting(HighlightStyle.define([
+  { tag: tags.propertyName, color: 'var(--primary-dim)', fontWeight: '600' },
+  { tag: tags.string, color: 'var(--success)' },
+  { tag: [tags.number, tags.bool, tags.null], color: 'var(--think)' },
+  { tag: tags.keyword, color: 'var(--primary)' },
+  { tag: tags.punctuation, color: 'var(--text-dim)' },
+]));
 
 const CharacterBookEditor = memo(function CharacterBookEditor({
   value,
@@ -37,6 +47,7 @@ const CharacterBookEditor = memo(function CharacterBookEditor({
         extensions: [
           lineNumbers(),
           json(),
+          characterBookJsonHighlight,
           wrappingRef.current.of(lineWrapping ? EditorView.lineWrapping : []),
           readOnlyRef.current.of(readOnly ? [EditorState.readOnly.of(true), EditorView.editable.of(false)] : []),
           EditorView.updateListener.of((update) => {

package/src/components/CharactersView.tsx

@@ -35,6 +35,19 @@ const CharacterBookEditor = lazy(() => import('./CharacterBookEditor'));
 
 type WorkshopTab = 'characters' | 'worldbooks' | 'skills';
 
+function invalidJsonLine(value: string): number | null {
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  try {
+    JSON.parse(trimmed);
+    return null;
+  } catch (error) {
+    const position = /position (\d+)/i.exec(String(error))?.[1];
+    if (!position) return 1;
+    return trimmed.slice(0, Number(position)).split('\n').length;
+  }
+}
+
 // 内置角色「酒馆老板」默认启用所有技能
 const ALL_DEFAULT_SKILLS = [...ALL_BUILTIN_TOOL_NAMES];
 
@@ -274,13 +287,10 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
       addToast(t('toast.nameRequired'), 'error');
       return;
     }
-    if (characterBook.trim()) {
-      try {
-        JSON.parse(characterBook);
-      } catch {
-        addToast(t('toast.characterBookInvalidJson'), 'error');
-        return;
-      }
+    const characterBookInvalidLine = invalidJsonLine(characterBook);
+    if (characterBookInvalidLine != null) {
+      addToast(t('toast.characterBookInvalidJson', { line: characterBookInvalidLine }), 'error');
+      return;
     }
     // 清理空白/重复项：第一项作为主开场白，其余作为备用
     const cleaned = greetings.map((g) => g.trim()).filter((g, i, arr) => g && arr.indexOf(g) === i);
@@ -318,9 +328,10 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
       <div className="modal-head">
             <span className="typo-dialog-title">{isNew ? t('workshop.newCharTitle') : t('workshop.editCharTitle')}</span>
             <div className="raw-tabs">
-              <button className={`raw-tab ${editorTab === 'character' ? 'active' : ''}`} onClick={() => setEditorTab('character')}>{t('workshop.characterTab')}</button>
+              <button className={`raw-tab ${editorTab === 'character' ? 'active' : ''}`} onPointerDown={(event) => event.preventDefault()} onClick={() => setEditorTab('character')}>{t('workshop.characterTab')}</button>
               <button
                 className={`raw-tab ${editorTab === 'knowledge' ? 'active' : ''}`}
+                onPointerDown={(event) => event.preventDefault()}
                 onClick={() => setEditorTab('knowledge')}
               >
                 {t('workshop.knowledgeTab')}
@@ -337,8 +348,8 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
               <button className="icon-btn" onClick={onClose}><Icon name="x" /></button>
             </div>
           </div>
-          <div className={`modal-body character-editor-body ${editorTab === 'knowledge' ? 'knowledge-tab' : ''}`}>
-            {editorTab === 'character' && <>
+          <div className="modal-body character-editor-body">
+            <div className={`character-editor-tab-panel ${editorTab === 'character' ? 'active' : ''}`}>
             <div style={{ display: 'flex', gap: 14, alignItems: 'center' }}>
               <Avatar name={name || t('chat.speakerChar')} colorOrdinal={npc.avatarColorOrdinal} imageUrl={avatarDataUrl} size="sm" />
               <div style={{ display: 'flex', gap: 8 }}>
@@ -427,8 +438,8 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
                 </div>
               )}
             </div>
-            </>}
-            {editorTab === 'knowledge' && (
+            </div>
+            <div className={`character-editor-tab-panel knowledge-tab ${editorTab === 'knowledge' ? 'active' : ''}`}>
               <div className="field prompt-field character-book-field">
                 <label>{t('workshop.characterBookLabel')}</label>
                 <Suspense fallback={<div className="character-book-editor-loading" />}>
@@ -439,7 +450,7 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
                   />
                 </Suspense>
               </div>
-            )}
+            </div>
           </div>
           <div className="modal-foot">
             {npc.isBuiltIn && (
@@ -448,7 +459,7 @@ function CharacterEditorModal({ npc, isNew, onClose, onSaved }: { npc: NpcCharac
               </button>
             )}
             <button className="btn" onClick={onClose}>{t('common.cancel')}</button>
-            <button className="btn btn-primary" onClick={save}>{t('common.save')}</button>
+            <button className="btn btn-primary" type="button" onPointerDown={(event) => event.preventDefault()} onClick={save}>{t('common.save')}</button>
           </div>
     </Modal>
   );
@@ -501,13 +512,10 @@ function WorldBookList({ books, onChanged }: {
       addToast(t('toast.wbNameContentRequired'), 'error');
       return;
     }
-    if (knowledge) {
-      try {
-        JSON.parse(knowledge);
-      } catch {
-        addToast(t('toast.knowledgeInvalidJson'), 'error');
-        return;
-      }
+    const knowledgeInvalidLine = invalidJsonLine(knowledge);
+    if (knowledgeInvalidLine != null) {
+      addToast(t('toast.knowledgeInvalidJson', { line: knowledgeInvalidLine }), 'error');
+      return;
     }
     const data = {
       name: name.trim(),
@@ -791,7 +799,7 @@ function WorldBookForm({
           </button>
         )}
         <button className="btn" onClick={onClose}>{t('common.cancel')}</button>
-        <button className="btn btn-primary" onClick={() => onSave(name, content, characterBook)}>{t('common.save')}</button>
+        <button className="btn btn-primary" type="button" onPointerDown={(event) => event.preventDefault()} onClick={() => onSave(name, content, characterBook)}>{t('common.save')}</button>
       </div>
     </>
   );

package/src/core/i18n.ts

@@ -471,13 +471,13 @@ const MESSAGES: Record<LangKey, Record<string, string>> = {
     'toast.importFailed': '导入失败: {msg}',
     'toast.charDeleted': '已删除角色「{name}」',
     'toast.nameRequired': '名称不能为空',
-    'toast.characterBookInvalidJson': 'Character Book 必须是有效的 JSON',
+    'toast.characterBookInvalidJson': '角色卡知识库 JSON 格式无效（第 {line} 行），请修改后再保存',
     'toast.charCreated': '已创建角色「{name}」',
     'toast.charUpdated': '已更新角色「{name}」',
     'toast.wbDraftImported': '已解析角色卡内的世界书「{name}」，请确认后保存',
     'toast.wbNameRequired': '世界书名不能为空',
     'toast.wbNameContentRequired': '世界书名不能为空，且内容与知识库至少填写一项',
-    'toast.knowledgeInvalidJson': '知识库必须是有效的 JSON',
+    'toast.knowledgeInvalidJson': '世界书知识库 JSON 格式无效（第 {line} 行），请修改后再保存',
     'toast.wbImported': '已导入世界书「{name}」（{total} 条知识，{enabled} 条启用），请确认后保存',
     'toast.wbImportFailed': '世界书 JSON 导入失败: {msg}',
     'toast.wbUpdated': '已更新世界书',
@@ -989,13 +989,13 @@ const MESSAGES: Record<LangKey, Record<string, string>> = {
     'toast.importFailed': '匯入失敗: {msg}',
     'toast.charDeleted': '已刪除角色「{name}」',
     'toast.nameRequired': '名稱不能為空',
-    'toast.characterBookInvalidJson': 'Character Book 必須是有效的 JSON',
+    'toast.characterBookInvalidJson': 'Character Book JSON 格式無效（第 {line} 行），請修改後再儲存',
     'toast.charCreated': '已建立角色「{name}」',
     'toast.charUpdated': '已更新角色「{name}」',
     'toast.wbDraftImported': '已解析角色卡內的世界書「{name}」，請確認後儲存',
     'toast.wbNameRequired': '世界書名不能為空',
     'toast.wbNameContentRequired': '世界書名不能為空，且內容與知識庫至少填寫一項',
-    'toast.knowledgeInvalidJson': '知識庫必須是有效的 JSON',
+    'toast.knowledgeInvalidJson': '世界書知識庫 JSON 格式無效（第 {line} 行），請修改後再儲存',
     'toast.wbImported': '已匯入世界書「{name}」（{total} 條知識，{enabled} 條啟用），請確認後儲存',
     'toast.wbImportFailed': '世界書 JSON 匯入失敗: {msg}',
     'toast.wbUpdated': '已更新世界書',
@@ -1505,13 +1505,13 @@ const MESSAGES: Record<LangKey, Record<string, string>> = {
     'toast.importFailed': 'Import failed: {msg}',
     'toast.charDeleted': 'Deleted character "{name}"',
     'toast.nameRequired': 'Name cannot be empty',
-    'toast.characterBookInvalidJson': 'Character Book must be valid JSON',
+    'toast.characterBookInvalidJson': 'Character Book JSON is invalid (line {line}). Correct it before saving.',
     'toast.charCreated': 'Created character "{name}"',
     'toast.charUpdated': 'Updated character "{name}"',
     'toast.wbDraftImported': 'Parsed the Lorebook "{name}" from the character card — review and save',
     'toast.wbNameRequired': 'Lorebook name cannot be empty',
     'toast.wbNameContentRequired': 'Lorebook name is required, and content or knowledge base must be filled in',
-    'toast.knowledgeInvalidJson': 'Knowledge base must be valid JSON',
+    'toast.knowledgeInvalidJson': 'Lorebook knowledge-base JSON is invalid (line {line}). Correct it before saving.',
     'toast.wbImported': 'Imported world book "{name}" ({total} entries, {enabled} enabled) — review and save',
     'toast.wbImportFailed': 'World book JSON import failed: {msg}',
     'toast.wbUpdated': 'Lorebook updated',

package/src/generated/changelog.json

@@ -1,7 +1,47 @@
 {
-  "latest": "0.1.25",
+  "latest": "0.1.26",
   "repo": "https://github.com/Rannichan/Tavern-Harness",
   "entries": [
+    {
+      "version": "0.1.26",
+      "date": "2026-10-27",
+      "breaking": false,
+      "compare": "v0.1.25...v0.1.26",
+      "groups": {
+        "zh-CN": [
+          {
+            "kind": "changed",
+            "items": [
+              "角色卡与世界书的知识库编辑器现在支持 JSON 语法高亮，键名、字符串、数字等用不同颜色区分，长内容更容易扫读",
+              "知识库 JSON 格式有误时，提示会指出具体出错的第几行，方便直接定位修改"
+            ]
+          },
+          {
+            "kind": "fixed",
+            "items": [
+              "修复手机上编辑角色时，切换「角色 / 知识库」标签会收起键盘、底部按钮随之闪烁跳动的问题",
+              "修复技能卡片里过长的工具名在手机上撑出屏幕、把操作按钮挤到看不见的问题"
+            ]
+          }
+        ],
+        "en": [
+          {
+            "kind": "changed",
+            "items": [
+              "The character-card and world-book knowledge editors now highlight JSON syntax, coloring keys, strings, and numbers so long entries are easier to scan",
+              "When knowledge-base JSON is invalid, the error now names the exact line, so the problem can be found and fixed directly"
+            ]
+          },
+          {
+            "kind": "fixed",
+            "items": [
+              "Fixed an issue on mobile where switching between the Character and Knowledge tabs while editing a character dismissed the keyboard and made the bottom buttons flicker",
+              "Fixed overly long tool names in skill cards overflowing the screen on mobile and pushing the action buttons out of view"
+            ]
+          }
+        ]
+      }
+    },
     {
       "version": "0.1.25",
       "date": "2026-10-27",

package/src/theme/global.css

@@ -24,6 +24,7 @@
   --font-size-2xs: 9.5px;
   --font-size-xs: 10.5px;
   --font-size-sm: 11px;
+  --font-size-caption: 11.5px;
   --font-size-md: 12px;
   --font-size-body-sm: 12.5px;
   --font-size-body: 14px;

package/src/theme/views.css

@@ -105,7 +105,23 @@
   flex: 1;
   min-height: 0;
 }
-.modal-editor .modal-body.knowledge-tab {
+.character-editor-body {
+  overflow: hidden;
+}
+.character-editor-tab-panel {
+  display: none;
+  min-height: 0;
+}
+.character-editor-tab-panel.active {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  flex-direction: column;
+  gap: 12px;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}
+.character-editor-tab-panel.knowledge-tab {
   overflow: hidden;
 }
 .modal-editor .grow-textarea {
@@ -161,6 +177,11 @@
 }
 .character-book-editor .cm-content {
   padding: 9px 12px;
+  caret-color: var(--text-primary);
+}
+/* CodeMirror 的默认光标颜色为黑色，不会随应用主题变量切换。 */
+.character-book-editor .cm-cursor {
+  border-left-color: var(--text-primary) !important;
 }
 .character-book-editor .cm-gutters {
   border-right: 1px solid var(--border-soft);
@@ -514,11 +535,14 @@
   flex-shrink: 0;
 }
 .list-item .l-sub {
-  font-size: var(--font-size-body-sm);
+  font-size: var(--font-size-caption);
   color: var(--text-muted);
   font-family: var(--font-family-mono);
 }
 .list-item.sortable-skill .l-sub {
+  min-width: 0;
+  overflow-wrap: anywhere;
+  word-break: break-word;
   color: var(--text-secondary);
 }
 
@@ -1388,10 +1412,41 @@
     gap: 4px;
   }
 
+  .list-item.sortable-skill {
+    min-width: 0;
+  }
+
   .skill-item-actions .btn {
     padding: 5px 7px;
   }
 
+  /* 保持隐藏知识库编辑器在布局树中：若用 display:none 隐藏一个仍有
+     焦点的 CodeMirror，移动浏览器会收起键盘并重算动态视口，造成底部按钮闪烁。 */
+  .character-editor-body {
+    position: relative;
+  }
+
+  .character-editor-tab-panel {
+    position: absolute;
+    inset: 16px 14px;
+    display: flex;
+    flex-direction: column;
+    opacity: 0;
+    pointer-events: none;
+    overflow: hidden;
+  }
+
+  .character-editor-tab-panel.active {
+    position: absolute;
+    display: flex;
+    opacity: 1;
+    pointer-events: auto;
+  }
+
+  .character-editor-tab-panel:not(.active) {
+    overflow-y: auto;
+  }
+
   .character-editor-modal .modal-head {
     grid-template-columns: minmax(0, 1fr) auto;
   }