stail00016 commited on
Commit
4342d5f
·
verified ·
1 Parent(s): 56784f3

Upload 888 files

Browse files
This view is limited to 50 files because it contains too many changes.   See raw diff
Files changed (50) hide show
  1. .gitattributes +100 -0
  2. jiuguan2025cc/.dockerignore +15 -0
  3. jiuguan2025cc/.editorconfig +14 -0
  4. jiuguan2025cc/.eslintrc.cjs +102 -0
  5. jiuguan2025cc/.github/ISSUE_TEMPLATE/bug-report.yml +93 -0
  6. jiuguan2025cc/.github/ISSUE_TEMPLATE/feature-request.yml +92 -0
  7. jiuguan2025cc/.github/issues-auto-comments.yml +69 -0
  8. jiuguan2025cc/.github/issues-auto-labels.yml +20 -0
  9. jiuguan2025cc/.github/pr-auto-comments.yml +51 -0
  10. jiuguan2025cc/.github/pr-auto-labels-by-branch.yml +77 -0
  11. jiuguan2025cc/.github/pr-auto-labels-by-files.yml +46 -0
  12. jiuguan2025cc/.github/pull_request_template.md +5 -0
  13. jiuguan2025cc/.github/readme-de_de.md +383 -0
  14. jiuguan2025cc/.github/readme-ja_jp.md +330 -0
  15. jiuguan2025cc/.github/readme-ko_kr.md +394 -0
  16. jiuguan2025cc/.github/readme-ru_ru.md +450 -0
  17. jiuguan2025cc/.github/readme-zh_cn.md +322 -0
  18. jiuguan2025cc/.github/readme-zh_tw.md +381 -0
  19. jiuguan2025cc/.github/readme.md +432 -0
  20. jiuguan2025cc/.github/workflows/docker-publish.yml +94 -0
  21. jiuguan2025cc/.github/workflows/issues-auto-manager.yml +116 -0
  22. jiuguan2025cc/.github/workflows/issues-updates-on-merge.yml +45 -0
  23. jiuguan2025cc/.github/workflows/job-close-stale.yml +100 -0
  24. jiuguan2025cc/.github/workflows/npm-publish.yml +32 -0
  25. jiuguan2025cc/.github/workflows/on-close-handler.yml +28 -0
  26. jiuguan2025cc/.github/workflows/on-open-handler.yml +29 -0
  27. jiuguan2025cc/.github/workflows/pr-auto-manager.yml +212 -0
  28. jiuguan2025cc/.github/workflows/pr-check-merge-conflicts.yaml +28 -0
  29. jiuguan2025cc/.github/workflows/update-i18n.yaml +32 -0
  30. jiuguan2025cc/.gitignore +57 -0
  31. jiuguan2025cc/.nomedia +0 -0
  32. jiuguan2025cc/.npmignore +14 -0
  33. jiuguan2025cc/.replit +81 -0
  34. jiuguan2025cc/.vscode/extensions.json +12 -0
  35. jiuguan2025cc/CONTRIBUTING.md +41 -0
  36. jiuguan2025cc/Dockerfile +51 -0
  37. jiuguan2025cc/LICENSE +661 -0
  38. jiuguan2025cc/Remote-Link.cmd +18 -0
  39. jiuguan2025cc/SECURITY.md +25 -0
  40. jiuguan2025cc/Start.bat +7 -0
  41. jiuguan2025cc/Update-Instructions.txt +75 -0
  42. jiuguan2025cc/UpdateAndStart.bat +27 -0
  43. jiuguan2025cc/UpdateForkAndStart.bat +110 -0
  44. jiuguan2025cc/backups/!README.md +9 -0
  45. jiuguan2025cc/colab/GPU.ipynb +193 -0
  46. jiuguan2025cc/data/.gitkeep +0 -0
  47. jiuguan2025cc/default/!DO-NOT-EDIT-THESE-FILES.txt +13 -0
  48. jiuguan2025cc/default/config.yaml +235 -0
  49. jiuguan2025cc/default/content/Char_Avatar_Comfy_Workflow.json +137 -0
  50. jiuguan2025cc/default/content/Default_Comfy_Workflow.json +86 -0
.gitattributes CHANGED
@@ -33,3 +33,103 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ jiuguan2025cc/default/content/backgrounds/bedroom[[:space:]]clean.jpg filter=lfs diff=lfs merge=lfs -text
37
+ jiuguan2025cc/default/content/backgrounds/bedroom[[:space:]]cyberpunk.jpg filter=lfs diff=lfs merge=lfs -text
38
+ jiuguan2025cc/default/content/backgrounds/bedroom[[:space:]]red.jpg filter=lfs diff=lfs merge=lfs -text
39
+ jiuguan2025cc/default/content/backgrounds/bedroom[[:space:]]tatami.jpg filter=lfs diff=lfs merge=lfs -text
40
+ jiuguan2025cc/default/content/backgrounds/cityscape[[:space:]]medieval[[:space:]]market.jpg filter=lfs diff=lfs merge=lfs -text
41
+ jiuguan2025cc/default/content/backgrounds/cityscape[[:space:]]medieval[[:space:]]night.jpg filter=lfs diff=lfs merge=lfs -text
42
+ jiuguan2025cc/default/content/backgrounds/cityscape[[:space:]]postapoc.jpg filter=lfs diff=lfs merge=lfs -text
43
+ jiuguan2025cc/default/content/backgrounds/forest[[:space:]]treehouse[[:space:]]fireworks[[:space:]]air[[:space:]]baloons[[:space:]](by[[:space:]]kallmeflocc).jpg filter=lfs diff=lfs merge=lfs -text
44
+ jiuguan2025cc/default/content/backgrounds/japan[[:space:]]classroom[[:space:]]side.jpg filter=lfs diff=lfs merge=lfs -text
45
+ jiuguan2025cc/default/content/backgrounds/japan[[:space:]]classroom.jpg filter=lfs diff=lfs merge=lfs -text
46
+ jiuguan2025cc/default/content/backgrounds/japan[[:space:]]path[[:space:]]cherry[[:space:]]blossom.jpg filter=lfs diff=lfs merge=lfs -text
47
+ jiuguan2025cc/default/content/backgrounds/japan[[:space:]]university.jpg filter=lfs diff=lfs merge=lfs -text
48
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]autumn[[:space:]]great[[:space:]]tree.jpg filter=lfs diff=lfs merge=lfs -text
49
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]beach[[:space:]]day.png filter=lfs diff=lfs merge=lfs -text
50
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]beach[[:space:]]night.jpg filter=lfs diff=lfs merge=lfs -text
51
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]mountain[[:space:]]lake.jpg filter=lfs diff=lfs merge=lfs -text
52
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]postapoc.jpg filter=lfs diff=lfs merge=lfs -text
53
+ jiuguan2025cc/default/content/backgrounds/landscape[[:space:]]winter[[:space:]]lake[[:space:]]house.jpg filter=lfs diff=lfs merge=lfs -text
54
+ jiuguan2025cc/default/content/backgrounds/royal.jpg filter=lfs diff=lfs merge=lfs -text
55
+ jiuguan2025cc/default/content/backgrounds/tavern[[:space:]]day.jpg filter=lfs diff=lfs merge=lfs -text
56
+ jiuguan2025cc/default/content/default_Seraphina.png filter=lfs diff=lfs merge=lfs -text
57
+ jiuguan2025cc/default/content/Seraphina/admiration.png filter=lfs diff=lfs merge=lfs -text
58
+ jiuguan2025cc/default/content/Seraphina/amusement.png filter=lfs diff=lfs merge=lfs -text
59
+ jiuguan2025cc/default/content/Seraphina/anger.png filter=lfs diff=lfs merge=lfs -text
60
+ jiuguan2025cc/default/content/Seraphina/annoyance.png filter=lfs diff=lfs merge=lfs -text
61
+ jiuguan2025cc/default/content/Seraphina/approval.png filter=lfs diff=lfs merge=lfs -text
62
+ jiuguan2025cc/default/content/Seraphina/caring.png filter=lfs diff=lfs merge=lfs -text
63
+ jiuguan2025cc/default/content/Seraphina/confusion.png filter=lfs diff=lfs merge=lfs -text
64
+ jiuguan2025cc/default/content/Seraphina/curiosity.png filter=lfs diff=lfs merge=lfs -text
65
+ jiuguan2025cc/default/content/Seraphina/desire.png filter=lfs diff=lfs merge=lfs -text
66
+ jiuguan2025cc/default/content/Seraphina/disappointment.png filter=lfs diff=lfs merge=lfs -text
67
+ jiuguan2025cc/default/content/Seraphina/disapproval.png filter=lfs diff=lfs merge=lfs -text
68
+ jiuguan2025cc/default/content/Seraphina/disgust.png filter=lfs diff=lfs merge=lfs -text
69
+ jiuguan2025cc/default/content/Seraphina/embarrassment.png filter=lfs diff=lfs merge=lfs -text
70
+ jiuguan2025cc/default/content/Seraphina/excitement.png filter=lfs diff=lfs merge=lfs -text
71
+ jiuguan2025cc/default/content/Seraphina/fear.png filter=lfs diff=lfs merge=lfs -text
72
+ jiuguan2025cc/default/content/Seraphina/gratitude.png filter=lfs diff=lfs merge=lfs -text
73
+ jiuguan2025cc/default/content/Seraphina/grief.png filter=lfs diff=lfs merge=lfs -text
74
+ jiuguan2025cc/default/content/Seraphina/joy.png filter=lfs diff=lfs merge=lfs -text
75
+ jiuguan2025cc/default/content/Seraphina/love.png filter=lfs diff=lfs merge=lfs -text
76
+ jiuguan2025cc/default/content/Seraphina/nervousness.png filter=lfs diff=lfs merge=lfs -text
77
+ jiuguan2025cc/default/content/Seraphina/neutral.png filter=lfs diff=lfs merge=lfs -text
78
+ jiuguan2025cc/default/content/Seraphina/optimism.png filter=lfs diff=lfs merge=lfs -text
79
+ jiuguan2025cc/default/content/Seraphina/pride.png filter=lfs diff=lfs merge=lfs -text
80
+ jiuguan2025cc/default/content/Seraphina/realization.png filter=lfs diff=lfs merge=lfs -text
81
+ jiuguan2025cc/default/content/Seraphina/relief.png filter=lfs diff=lfs merge=lfs -text
82
+ jiuguan2025cc/default/content/Seraphina/remorse.png filter=lfs diff=lfs merge=lfs -text
83
+ jiuguan2025cc/default/content/Seraphina/sadness.png filter=lfs diff=lfs merge=lfs -text
84
+ jiuguan2025cc/default/content/Seraphina/surprise.png filter=lfs diff=lfs merge=lfs -text
85
+ jiuguan2025cc/public/st-launcher.ico filter=lfs diff=lfs merge=lfs -text
86
+ jiuguan2025cc/public/st.ico filter=lfs diff=lfs merge=lfs -text
87
+ jiuguan2025cc/public/webfonts/fa-brands-400.ttf filter=lfs diff=lfs merge=lfs -text
88
+ jiuguan2025cc/public/webfonts/fa-brands-400.woff2 filter=lfs diff=lfs merge=lfs -text
89
+ jiuguan2025cc/public/webfonts/fa-solid-900.ttf filter=lfs diff=lfs merge=lfs -text
90
+ jiuguan2025cc/public/webfonts/fa-solid-900.woff2 filter=lfs diff=lfs merge=lfs -text
91
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Black.woff filter=lfs diff=lfs merge=lfs -text
92
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Black.woff2 filter=lfs diff=lfs merge=lfs -text
93
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-BlackItalic.woff filter=lfs diff=lfs merge=lfs -text
94
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-BlackItalic.woff2 filter=lfs diff=lfs merge=lfs -text
95
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Bold.woff filter=lfs diff=lfs merge=lfs -text
96
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Bold.woff2 filter=lfs diff=lfs merge=lfs -text
97
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-BoldItalic.woff filter=lfs diff=lfs merge=lfs -text
98
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-BoldItalic.woff2 filter=lfs diff=lfs merge=lfs -text
99
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraBold.woff filter=lfs diff=lfs merge=lfs -text
100
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraBold.woff2 filter=lfs diff=lfs merge=lfs -text
101
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraBoldItalic.woff filter=lfs diff=lfs merge=lfs -text
102
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraBoldItalic.woff2 filter=lfs diff=lfs merge=lfs -text
103
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraLight.woff filter=lfs diff=lfs merge=lfs -text
104
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraLight.woff2 filter=lfs diff=lfs merge=lfs -text
105
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraLightItalic.woff filter=lfs diff=lfs merge=lfs -text
106
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ExtraLightItalic.woff2 filter=lfs diff=lfs merge=lfs -text
107
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Italic.woff filter=lfs diff=lfs merge=lfs -text
108
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Italic.woff2 filter=lfs diff=lfs merge=lfs -text
109
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Light.woff filter=lfs diff=lfs merge=lfs -text
110
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Light.woff2 filter=lfs diff=lfs merge=lfs -text
111
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-LightItalic.woff filter=lfs diff=lfs merge=lfs -text
112
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-LightItalic.woff2 filter=lfs diff=lfs merge=lfs -text
113
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Medium.woff filter=lfs diff=lfs merge=lfs -text
114
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Medium.woff2 filter=lfs diff=lfs merge=lfs -text
115
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-MediumItalic.woff filter=lfs diff=lfs merge=lfs -text
116
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-MediumItalic.woff2 filter=lfs diff=lfs merge=lfs -text
117
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Regular.woff filter=lfs diff=lfs merge=lfs -text
118
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Regular.woff2 filter=lfs diff=lfs merge=lfs -text
119
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-SemiBold.woff filter=lfs diff=lfs merge=lfs -text
120
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-SemiBold.woff2 filter=lfs diff=lfs merge=lfs -text
121
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-SemiBoldItalic.woff filter=lfs diff=lfs merge=lfs -text
122
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-SemiBoldItalic.woff2 filter=lfs diff=lfs merge=lfs -text
123
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Thin.woff filter=lfs diff=lfs merge=lfs -text
124
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-Thin.woff2 filter=lfs diff=lfs merge=lfs -text
125
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ThinItalic.woff filter=lfs diff=lfs merge=lfs -text
126
+ jiuguan2025cc/public/webfonts/NotoSans/NotoSans-ThinItalic.woff2 filter=lfs diff=lfs merge=lfs -text
127
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-100.woff2 filter=lfs diff=lfs merge=lfs -text
128
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-200.woff2 filter=lfs diff=lfs merge=lfs -text
129
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-300.woff2 filter=lfs diff=lfs merge=lfs -text
130
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-500.woff2 filter=lfs diff=lfs merge=lfs -text
131
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-600.woff2 filter=lfs diff=lfs merge=lfs -text
132
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-700.woff2 filter=lfs diff=lfs merge=lfs -text
133
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-800.woff2 filter=lfs diff=lfs merge=lfs -text
134
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-900.woff2 filter=lfs diff=lfs merge=lfs -text
135
+ jiuguan2025cc/public/webfonts/NotoSansMono/noto-sans-mono-v30-regular.woff2 filter=lfs diff=lfs merge=lfs -text
jiuguan2025cc/.dockerignore ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ .git
2
+ .github
3
+ .vscode
4
+ node_modules
5
+ npm-debug.log
6
+ readme*
7
+ Start.bat
8
+ /dist
9
+ /backups
10
+ cloudflared.exe
11
+ access.log
12
+ /data
13
+ /cache
14
+ .DS_Store
15
+ /public/scripts/extensions/third-party
jiuguan2025cc/.editorconfig ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ root = true
2
+
3
+ [*]
4
+ end_of_line = lf
5
+ insert_final_newline = true
6
+ trim_trailing_whitespace = true
7
+
8
+ [*.{js,conf,json,css,less,html}]
9
+ charset = utf-8
10
+ indent_style = space
11
+ indent_size = 4
12
+
13
+ [*.md]
14
+ trim_trailing_whitespace = false
jiuguan2025cc/.eslintrc.cjs ADDED
@@ -0,0 +1,102 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ module.exports = {
2
+ root: true,
3
+ extends: [
4
+ 'eslint:recommended',
5
+ ],
6
+ env: {
7
+ es6: true,
8
+ },
9
+ parserOptions: {
10
+ ecmaVersion: 'latest',
11
+ },
12
+ overrides: [
13
+ {
14
+ // Server-side files (plus this configuration file)
15
+ files: ['src/**/*.js', './*.js', 'plugins/**/*.js'],
16
+ env: {
17
+ node: true,
18
+ },
19
+ parserOptions: {
20
+ sourceType: 'module',
21
+ },
22
+ globals: {
23
+ globalThis: 'readonly',
24
+ Deno: 'readonly',
25
+ },
26
+ },
27
+ {
28
+ files: ['*.cjs'],
29
+ parserOptions: {
30
+ sourceType: 'commonjs',
31
+ },
32
+ env: {
33
+ node: true,
34
+ },
35
+ },
36
+ {
37
+ files: ['src/**/*.mjs'],
38
+ parserOptions: {
39
+ sourceType: 'module',
40
+ },
41
+ env: {
42
+ node: true,
43
+ },
44
+ },
45
+ {
46
+ // Browser-side files
47
+ files: ['public/**/*.js'],
48
+ env: {
49
+ browser: true,
50
+ jquery: true,
51
+ },
52
+ parserOptions: {
53
+ sourceType: 'module',
54
+ },
55
+ // These scripts are loaded in HTML; tell ESLint not to complain about them being undefined
56
+ globals: {
57
+ globalThis: 'readonly',
58
+ ePub: 'readonly',
59
+ pdfjsLib: 'readonly',
60
+ toastr: 'readonly',
61
+ SillyTavern: 'readonly',
62
+ },
63
+ },
64
+ ],
65
+ ignorePatterns: [
66
+ '**/node_modules/**',
67
+ '**/dist/**',
68
+ '**/.git/**',
69
+ 'public/lib/**',
70
+ 'backups/**',
71
+ 'data/**',
72
+ 'cache/**',
73
+ 'src/tokenizers/**',
74
+ 'docker/**',
75
+ 'plugins/**',
76
+ '**/*.min.js',
77
+ 'public/scripts/extensions/quick-reply/lib/**',
78
+ 'public/scripts/extensions/tts/lib/**',
79
+ ],
80
+ rules: {
81
+ 'no-unused-vars': ['error', { args: 'none' }],
82
+ 'no-control-regex': 'off',
83
+ 'no-constant-condition': ['error', { checkLoops: false }],
84
+ 'require-yield': 'off',
85
+ 'quotes': ['error', 'single'],
86
+ 'semi': ['error', 'always'],
87
+ 'indent': ['error', 4, { SwitchCase: 1, FunctionDeclaration: { parameters: 'first' } }],
88
+ 'comma-dangle': ['error', 'always-multiline'],
89
+ 'eol-last': ['error', 'always'],
90
+ 'no-trailing-spaces': 'error',
91
+ 'object-curly-spacing': ['error', 'always'],
92
+ 'space-infix-ops': 'error',
93
+ 'no-unused-expressions': ['error', { allowShortCircuit: true, allowTernary: true }],
94
+ 'no-cond-assign': 'error',
95
+ 'no-unneeded-ternary': 'error',
96
+ 'no-irregular-whitespace': ['error', { skipStrings: true, skipTemplates: true }],
97
+
98
+ // These rules should eventually be enabled.
99
+ 'no-async-promise-executor': 'off',
100
+ 'no-inner-declarations': 'off',
101
+ },
102
+ };
jiuguan2025cc/.github/ISSUE_TEMPLATE/bug-report.yml ADDED
@@ -0,0 +1,93 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Bug Report 🐛
2
+ type: Bug
3
+ description: Report something that's not working the intended way. Support requests for external programs (reverse proxies, 3rd party servers, other peoples' forks) will be refused! Please use English only.
4
+ title: '[BUG] <title>'
5
+ labels: ['🐛 Bug']
6
+ body:
7
+ - type: dropdown
8
+ id: environment
9
+ attributes:
10
+ label: Environment
11
+ description: Where are you running SillyTavern?
12
+ options:
13
+ - 🪟 Windows
14
+ - 🐧 Linux
15
+ - 📱 Termux
16
+ - 🐋 Docker
17
+ - 🍎 Mac
18
+ validations:
19
+ required: true
20
+
21
+ - type: input
22
+ id: system
23
+ attributes:
24
+ label: System
25
+ description: >-
26
+ For deployment issues, specify your [distro or OS](https://whatsmyos.com/) and/ or Docker version.
27
+ For client-side issues, include your [browser version](https://www.whatsmybrowser.org/)
28
+ placeholder: e.g. Firefox 101, Manjaro Linux 21.3.0, Docker 20.10.16
29
+ validations:
30
+ required: true
31
+
32
+ - type: input
33
+ id: version
34
+ attributes:
35
+ label: Version
36
+ description: What version of SillyTavern are you running?
37
+ placeholder: (check User Settings to see the version)
38
+ validations:
39
+ required: true
40
+
41
+ - type: textarea
42
+ id: desktop
43
+ attributes:
44
+ label: Desktop Information
45
+ description: Please provide details about your desktop environment.
46
+ placeholder: |
47
+ - Node.js version (if applicable): [run `node --version` in cmd]
48
+ - Generation API [e.g. KoboldAI, OpenAI]
49
+ - Branch [staging, release]
50
+ - Model [e.g. Pygmalion 6b, LLaMa 13b]
51
+ validations:
52
+ required: false
53
+
54
+ - type: textarea
55
+ id: repro
56
+ attributes:
57
+ label: Describe the problem
58
+ description: Please describe exactly what is not working, include the steps to reproduce, actual result and expected result
59
+ placeholder: When doing ABC then DEF, I expect to see XYZ, but I actually see ZYX
60
+ validations:
61
+ required: true
62
+
63
+ - type: textarea
64
+ id: logs
65
+ attributes:
66
+ label: Additional info
67
+ description: Logs? Screenshots? Yes, please.
68
+ placeholder: If the issue happens during build-time, include terminal logs. For run-time errors, include browser logs which you can view in the Dev Tools (F12), under the Console tab. Take care to blank out any personal info.
69
+ validations:
70
+ required: false
71
+
72
+ - type: checkboxes
73
+ id: user-check
74
+ attributes:
75
+ label: Please tick the boxes
76
+ description: Before submitting, please ensure that you have completed the following checklist
77
+ options:
78
+ - label: I have explained the issue clearly, and I included all relevant info
79
+ required: true
80
+ - label: I have checked that this [issue hasn't already been raised](https://github.com/SillyTavern/SillyTavern/issues?q=is%3Aissue)
81
+ required: true
82
+ - label: I have checked the [docs](https://docs.sillytavern.app/) ![important](https://img.shields.io/badge/Important!-F6094E)
83
+ required: true
84
+ - label: I confirm that my issue is not related to third-party content, unofficial extension or patch. If in doubt, check with a new [user account](https://docs.sillytavern.app/administration/multi-user/) and with extensions disabled
85
+ required: true
86
+
87
+ - type: markdown
88
+ attributes:
89
+ value: |-
90
+ ## Thanks 🙏
91
+ Thank you for raising this ticket - in doing so you are helping to make SillyTavern better for everyone.
92
+ validations:
93
+ required: false
jiuguan2025cc/.github/ISSUE_TEMPLATE/feature-request.yml ADDED
@@ -0,0 +1,92 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Feature Request ✨
2
+ type: Feature
3
+ description: Suggest an idea for future development of this project. Please use English only.
4
+ title: '[FEATURE_REQUEST] <title>'
5
+ labels: ['🦄 Feature Request']
6
+
7
+ body:
8
+
9
+ # Field 1 - Did the user searched for similar requests
10
+ - type: dropdown
11
+ id: similarRequest
12
+ attributes:
13
+ label: Have you searched for similar requests?
14
+ description:
15
+ options:
16
+ - 'No'
17
+ - 'Yes'
18
+ validations:
19
+ required: true
20
+
21
+ # Field 2 - Is it bug-related
22
+ - type: textarea
23
+ id: issue
24
+ attributes:
25
+ label: Is your feature request related to a problem? If so, please describe.
26
+ description:
27
+ placeholder: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
28
+ validations:
29
+ required: false
30
+
31
+ # Field 3 - Describe feature
32
+ - type: textarea
33
+ id: solution
34
+ attributes:
35
+ label: Describe the solution you'd like
36
+ placeholder: An outline of how you would like this to be implemented, include as much details as possible
37
+ validations:
38
+ required: true
39
+
40
+ # Field 4 - Describe alternatives
41
+ - type: textarea
42
+ id: alternatives
43
+ attributes:
44
+ label: Describe alternatives you've considered
45
+ placeholder: A clear and concise description of any alternative solutions or features you've considered.
46
+ validations:
47
+ required: false
48
+
49
+ # Field 5 - Additional context
50
+ - type: textarea
51
+ id: addcontext
52
+ attributes:
53
+ label: Additional context
54
+ placeholder: Add any other context or screenshots about the feature request here.
55
+ validations:
56
+ required: false
57
+
58
+ # Field 6 - Priority
59
+ - type: dropdown
60
+ id: priority
61
+ attributes:
62
+ label: Priority
63
+ description: How urgent is the development of this feature
64
+ options:
65
+ - Low (Nice-to-have)
66
+ - Medium (Would be very useful)
67
+ - High (The app does not function without it)
68
+ validations:
69
+ required: true
70
+
71
+ # Field 7 - Can the user user test in staging
72
+ - type: dropdown
73
+ id: canTestStaging
74
+ attributes:
75
+ label: Are you willing to test this on staging/unstable branch if this is implemented?
76
+ description: Otherwise you'll need to wait until the next stable release after the feature is developed.
77
+ options:
78
+ - 'No'
79
+ - 'Maybe'
80
+ - 'Yes'
81
+ validations:
82
+ required: false
83
+
84
+ # Final text
85
+ - type: markdown
86
+ attributes:
87
+ value: |-
88
+ ## Thanks 🙏
89
+ Thank you for your feature suggestion.
90
+ Please note that there is no guarantee that your idea will be implemented.
91
+ validations:
92
+ required: false
jiuguan2025cc/.github/issues-auto-comments.yml ADDED
@@ -0,0 +1,69 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ labels:
2
+ - name: ✖️ Invalid
3
+ labeled:
4
+ issue:
5
+ action: close
6
+ body: >
7
+ Hey @{{ issue.user.login }}, this issue has been marked as invalid.
8
+
9
+ Please double-check that you've followed the issue template, included all necessary details, and reviewed the docs & previous issues before submitting.
10
+ If provided, follow the instructions given by maintainers.
11
+
12
+ - name: 👩‍💻 Good First Issue
13
+ labeled:
14
+ issue:
15
+ body: >
16
+ 🏆 This issue has been marked as a good first issue for contributors to implement!
17
+ This is a great way to support the project. While also improving your skills, you'll also be credited as a contributor once your PR is merged.
18
+
19
+ If you're new to SillyTavern [here is the official documentation](https://docs.sillytavern.app/). The official contribution guide can be found [here](https://github.com/SillyTavern/SillyTavern/blob/release/CONTRIBUTING.md).
20
+ If you need any support, feel free to reach out via [Discord](https://discord.gg/sillytavern), or let us know in this issue or via [discussions](https://github.com/SillyTavern/SillyTavern/discussions).
21
+
22
+ - name: ❌ wontfix
23
+ labeled:
24
+ issue:
25
+ action: close
26
+ body: >
27
+ ❌ This issue has been marked as 'wontfix', which usually means it is out-of-scope, not feasible at this time or will not be implemented for various reasons.
28
+ If you have any questions about this, feel free to reach out.
29
+
30
+ - name: 🛑 Out of Scope
31
+ labeled:
32
+ issue:
33
+ action: close
34
+ body: >
35
+ 🛑 This issue has been marked as 'out of scope', as this can't or won't be implemented.
36
+ If you have any questions about this, feel free to reach out.
37
+
38
+ - name: ✅ Done (staging)
39
+ labeled:
40
+ issue:
41
+ body: >
42
+ ✅ It looks like all or part of this issue has now been implemented as part of the `staging` branch.
43
+ If you currently are on the `release` branch, you can switch to `staging` to test this right away.
44
+
45
+ Note that `staging` is considered less stable than the official releases. To switch, follow existing instructions,
46
+ or simply enter the following command: `git switch staging`
47
+
48
+ - name: ✅ Done
49
+ labeled:
50
+ issue:
51
+ body: >
52
+ ✅ It looks like all or part of this issue has now been implemented as part of the latest release.
53
+
54
+ - name: ‼️ High Priority
55
+ labeled:
56
+ issue:
57
+ body: >
58
+ 🚨 This issue has been marked high priority, meaning it's important to the maintainers or community.
59
+ While we can't promise immediate changes, it is on our radar and will be addressed whenever possible. Thanks for your patience!
60
+
61
+ - name: 💀 Spam
62
+ labeled:
63
+ issue:
64
+ action: close
65
+ locking: lock
66
+ lock_reason: spam
67
+ body: >
68
+ 💀 This issue has been flagged as spam and is now locked.
69
+ Please avoid posting spam - it disrupts the community and wastes everyone's time.
jiuguan2025cc/.github/issues-auto-labels.yml ADDED
@@ -0,0 +1,20 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ 🪟 Windows:
2
+ - '(🪟 Windows)'
3
+
4
+ 🍎 Mac:
5
+ - '(🍎 Mac)'
6
+
7
+ 🐋 Docker:
8
+ - '(🐋 Docker)'
9
+
10
+ 📱 Termux:
11
+ - '(📱 Termux)'
12
+
13
+ 🐧 Linux:
14
+ - '(🐧 Linux)'
15
+
16
+ 🦊 Firefox:
17
+ - '(firefox|mozilla)'
18
+
19
+ 📱 Mobile:
20
+ - '(iphone|ios|android|📱 Termux)'
jiuguan2025cc/.github/pr-auto-comments.yml ADDED
@@ -0,0 +1,51 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ labels:
2
+ - name: ✖️ Invalid
3
+ labeled:
4
+ pr:
5
+ action: close
6
+ body: >
7
+ Hey @{{ pull_request.user.login }}, thanks for your contribution!
8
+ Unfortunately, this PR has been marked as invalid.
9
+
10
+ Please check that you've followed the PR template, included all relevant details, and are targeting the correct branch (`staging` for regular contributions, `release` only for hotfixes).
11
+
12
+ If you need help, feel free to ask!
13
+
14
+ - name: ⛔ Don't Merge
15
+ labeled:
16
+ pr:
17
+ body: >
18
+ 🚨 This PR has been temporarily blocked from merging.
19
+
20
+ - name: 💥💣 Breaking Changes
21
+ labeled:
22
+ pr:
23
+ body: >
24
+ ⚠️ Heads up! This PR introduces breaking changes.
25
+
26
+ Make sure these changes are well-documented and that users will be properly informed when this is released.
27
+
28
+ - name: ⛔ Waiting For External/Upstream
29
+ labeled:
30
+ pr:
31
+ body: >
32
+ ⛔ This PR is awaiting external or upstream changes or approval.
33
+ It can only be merged once those changes have been implemented and approved.
34
+
35
+ Please inform us of any progress on the upstream changes or approval.
36
+
37
+ - name: 🔬 Needs Testing
38
+ labeled:
39
+ pr:
40
+ body: >
41
+ 🔬 This PR needs testing!
42
+ Any contributor can test and leave reviews, so feel free to help us out!
43
+
44
+ - name: 🟥 ⬤⬤⬤⬤⬤
45
+ labeled:
46
+ pr:
47
+ body: >
48
+ ⚠️ This PR is over 1000 lines, which is larger than recommended.
49
+
50
+ Please make sure that it only addresses a single issue - PRs this large are hard to test and may be rejected.
51
+
jiuguan2025cc/.github/pr-auto-labels-by-branch.yml ADDED
@@ -0,0 +1,77 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ####################################
2
+ # Label PRs against 'release' #
3
+ ####################################
4
+ ❗ Against Release Branch:
5
+ - base-branch: 'release'
6
+
7
+ ####################################
8
+ # Labels based on PR branch name #
9
+ ####################################
10
+ 🦋 Bug Fix:
11
+ - head-branch: ['^fix[/-]', '\bfixes\b']
12
+
13
+ 🚑 Hot Fix:
14
+ - head-branch: ['^hotfix[/-]']
15
+
16
+ ✨ New Feature:
17
+ - head-branch: ['^feat(ure)?[/-].*?\badd', '^add-']
18
+
19
+ ✨ Feature Changes:
20
+ - head-branch: ['^feat(ure)?[/-](?!.*\badd\b)', '\bchanges?\b']
21
+
22
+ 🤖 API / Model:
23
+ - head-branch: ['\bapi\b', '\bmodels?\b']
24
+
25
+ 🏭 Backend Changes:
26
+ - head-branch: ['\bbackend\b', '\bendpoints?\b']
27
+
28
+ 🐋 Docker:
29
+ - head-branch: ['\bdocker\b']
30
+
31
+ ➕ Extension:
32
+ - head-branch: ['\bextension\b', '\bext\b']
33
+
34
+ 🦊 Firefox:
35
+ - head-branch: ['\bfirefox\b']
36
+
37
+ 🖼️ Image Gen:
38
+ - head-branch: ['\bimage-gen\b']
39
+
40
+ 🌐 Language:
41
+ - head-branch: ['\btranslations?\b', '\blanguages?\b']
42
+
43
+ 🐧 Linux:
44
+ - head-branch: ['\blinux\b']
45
+
46
+ 🧩 Macros:
47
+ - head-branch: ['\bmacros?\b']
48
+
49
+ 📱 Mobile:
50
+ - head-branch: ['\bmobile\b', '\bios\b', '\bandroid\b']
51
+
52
+ 🚄 Performance:
53
+ - head-branch: ['\bperformance\b']
54
+
55
+ ⚙️ Preset:
56
+ - head-branch: ['\bpresets?\b']
57
+
58
+ 📜 Prompt:
59
+ - head-branch: ['\bprompt\b']
60
+
61
+ 🚚 Refactor:
62
+ - head-branch: ['\brefactor(s|ed)?\b']
63
+
64
+ 📜 STscript:
65
+ - head-branch: ['\bstscript\b', '\bslash-commands\b']
66
+
67
+ 🏷️ Tags / Folders:
68
+ - head-branch: ['\btags\b']
69
+
70
+ 🎙️ TTS / Voice:
71
+ - head-branch: ['\btts\b', '\bvoice\b']
72
+
73
+ 🌟 UX:
74
+ - head-branch: ['\bux\b']
75
+
76
+ 🗺️ World Info:
77
+ - head-branch: ['\bworld-info\b', '\bwi\b']
jiuguan2025cc/.github/pr-auto-labels-by-files.yml ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ####################################
2
+ # Labels based on changed files #
3
+ ####################################
4
+ 🏭 Backend Changes:
5
+ - changed-files:
6
+ - any-glob-to-any-file:
7
+ - "src/**"
8
+ - "default/config.yaml"
9
+ - "server.js"
10
+ - "plugins.js"
11
+ - "recover.js"
12
+ - "webpack.config.js"
13
+ - "Start.bat"
14
+ - "start.sh"
15
+ - "UpdateAndStart.bat"
16
+ - "UpdateForkAndStart.bat"
17
+
18
+ ⚙️ config.yaml:
19
+ - changed-files:
20
+ - any-glob-to-any-file:
21
+ - "default/config.yaml"
22
+
23
+ 🛠️ Build Changes:
24
+ - changed-files:
25
+ - any-glob-to-any-file:
26
+ - ".github/workflows/**"
27
+ - "docker/**"
28
+ - ".dockerignore"
29
+ - "Dockerfile"
30
+ - "webpack.config.js"
31
+
32
+ 🌐 Language:
33
+ - changed-files:
34
+ - any-glob-to-any-file:
35
+ - "public/locales/**"
36
+
37
+ 📥 Dependencies:
38
+ - changed-files:
39
+ - any-glob-to-any-file:
40
+ - "public/lib/**" # Every frontend lib counts as a dependency as well
41
+ - "package.json"
42
+ - "package-lock.json"
43
+ - "tests/package.json"
44
+ - "tests/package-lock.json"
45
+ - "src/electron/package.json"
46
+ - "src/electron/package-lock.json"
jiuguan2025cc/.github/pull_request_template.md ADDED
@@ -0,0 +1,5 @@
 
 
 
 
 
 
1
+ <!-- Put X in the box below to confirm -->
2
+
3
+ ## Checklist:
4
+
5
+ - [ ] I have read the [Contributing guidelines](https://github.com/SillyTavern/SillyTavern/blob/release/CONTRIBUTING.md).
jiuguan2025cc/.github/readme-de_de.md ADDED
@@ -0,0 +1,383 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > Die hier veröffentlichten Informationen sind möglicherweise veraltet oder unvollständig. Für aktuelle Informationen nutzen Sie bitte die englische Version.
3
+ > Letztes Update dieser README: 28.9.2024
4
+
5
+ <a name="readme-top"></a>
6
+
7
+ ![][cover]
8
+
9
+ <div align="center">
10
+
11
+ [English](readme.md) | German | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
12
+
13
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
14
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
15
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
16
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
17
+
18
+ </div>
19
+
20
+ ---
21
+
22
+ SillyTavern bietet eine einheitliche Benutzeroberfläche für viele LLM-APIs (KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral und mehr), ein mobilfreundliches Layout, einen Visual-Novel-Modus, die Integration von Automatic1111 & ComfyUI API zur Bilderzeugung, TTS, WorldInfo (Lorebooks), anpassbare UI, automatische Übersetzung, mehr Eingabeaufforderungsoptionen, als du jemals wolltest oder brauchst, und unendliches Wachstumspotenzial durch Drittanbietererweiterungen.
23
+
24
+ Wir haben eine [Dokumentationswebsite](https://docs.sillytavern.app/), um die meisten deiner Fragen zu beantworten und dir den Einstieg zu erleichtern.
25
+
26
+ ## Was ist SillyTavern?
27
+
28
+ SillyTavern (oder ST abgekürtz) ist eine lokal installierte Benutzeroberfläche, die es dir ermöglicht, mit Textgenerations-LLMs, Bildgenerierungsmaschinen und TTS-Sprachmodellen zu interagieren.
29
+
30
+ Angefangen im Februar 2023 als Fork von TavernAI 1.2.8 hat SillyTavern nun über 100 Mitwirkende und 2 Jahre unabhängiger Entwicklung hinter sich und dient weiterhin als führende Software für versierte KI-Hobbyisten.
31
+
32
+ ## Unsere Vision
33
+
34
+ 1. Wir möchten die Nutzer mit so viel Nutzen und Kontrolle über ihre LLM-Prompts wie möglich ausstatten. Die steile Lernkurve ist Teil des Spaßes!
35
+ 2. Wir bieten weder Online- oder gehosteten Dienste an, noch verfolgen wir programmgesteuert Benutzerdaten.
36
+ 3. SillyTavern ist ein Herzensprojekt, das von einer engagierten Community von LLM-Enthusiasten unterstützt wird, und wird immer kostenlos und Open Source sein.
37
+
38
+ ## Branches
39
+
40
+ SillyTavern wird mit einem Branchsystem entwickelt, um ein reibungsloses Erlebnis für alle Nutzer zu gewährleisten.
41
+
42
+ * `release` -🌟 **Empfohlen für die meisten Nutzer.** Dies ist der stabilste und empfohlene Branch, der nur aktualisiert wird, wenn wichtige Versionen veröffentlicht werden. Er ist für die Mehrheit der Nutzer geeignet. Typischerweise einmal im Monat aktualisiert.
43
+ * `staging` - ⚠️ **Nicht für den gelegentlichen Gebrauch empfohlen.** Dieser Branch enthält die neuesten Funktionen, kann jedoch jederzeit instabil sein. Nur für Power-User und Enthusiasten. Mehrmals täglich aktualisiert.
44
+
45
+ Wenn du nicht vertraut mit der Verwendung der git CLI bist oder nicht verstehst, was ein Branch ist, mach dir keine Sorgen! Der Release-Branch ist immer die bevorzugte Option für dich.
46
+
47
+ ## Was brauche ich zusätzlich zu SillyTavern?
48
+
49
+ Da SillyTavern nur eine Benutzeroberfläche ist, benötigst du Zugriff auf ein LLM-Backend, um Inferenz bereitzustellen. Du kannst AI Horde für sofortiges Chatten ohne weitere Einrichtung verwenden. Darüber hinaus unterstützen wir viele andere lokale und cloudbasierte LLM-Backends: OpenAI-kompatible API, KoboldAI, Tabby und viele mehr. Du kannst mehr über unsere unterstützten APIs in [der FAQ](https://docs.sillytavern.app/usage/api-connections/) lesen.
50
+
51
+ ### Brauche ich einen leistungsstarken PC, um SillyTavern auszuführen?
52
+
53
+ Die Hardwareanforderungen sind minimal: Es läuft auf allem, was NodeJS 18 oder höher ausführen kann. Wenn du LLM-Inferenz auf deinem lokalen Rechner durchführen möchtest, empfehlen wir eine NVIDIA-Grafikkarte der 3000er-Serie mit mindestens 6 GB VRAM. Überprüfe die Dokumentation deines Backends für weitere Einzelheiten.
54
+
55
+ ### Vorgeschlagene Backends (keine Partnerschaft oder Werbebeziehung)
56
+
57
+ * [AI Horde](https://aihorde.net/) - verwende Modelle, die von Freiwilligen gehostet werden. Erfordert keine weitere Einrichtung
58
+ * [KoboldCpp](https://github.com/LostRuins/koboldcpp) - ein Favorit der Community, um GGUF-Modelle lokal auszuführen
59
+ * [tabbyAPI](https://github.com/theroyallab/tabbyAPI) - eine beliebte, portable, speicherplatzoptimierte und lokal gehostete exl2 Inferenz-API
60
+ * [OpenRouter](https://openrouter.ai) - eine einzige API für viele Cloud-Anbieter (OpenAI, Claude, Meta Llama usw.) sowie beliebte Community-Modelle.
61
+
62
+ ## Fragen oder Vorschläge?
63
+
64
+ ### Discord-Server
65
+
66
+ | [![][discord-shield-badge]][discord-link] | [Tritt unserer Discord-Community bei!](https://discord.gg/sillytavern) Erhalte Unterstützung, teile deine Lieblingscharaktere und Prompts. |
67
+ | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
68
+
69
+ Oder nimm direkt Kontakt mit den Entwicklern auf:
70
+
71
+ * Discord: cohee, rossascends, wolfsblvt
72
+ * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/)
73
+ * [Erstelle ein GitHub-Issue](https://github.com/SillyTavern/SillyTavern/issues)
74
+
75
+ ### Ich mag dieses Projekt! Wie kann ich beitragen?
76
+
77
+ 1. Sende Pull-Requests. Lerne, wie du beitragen kannst: [CONTRIBUTING.md](../CONTRIBUTING.md)
78
+ 2. Sende Feature Requests und Issues unter Verwendung der bereitgestellten Vorlagen.
79
+ 3. Lies diese gesamte README-Datei und überprüfe zuerst die Dokumentationswebsite, um doppelte Issues zu vermeiden.
80
+
81
+ ## Screenshots
82
+
83
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
84
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
85
+
86
+ ## Charakterkarten
87
+
88
+ SillyTavern basiert auf dem Konzept der "Charakterkarten". Eine Charakterkarte ist eine Sammlung von Prompts, die das Verhalten des LLM festlegen und erforderlich sind, um persistente Gespräche in SillyTavern zu führen. Sie funktionieren ähnlich wie ChatGPT's GPTs oder Poe's Bots. Der Inhalt einer Charakterkarte kann alles sein: ein abstraktes Szenario, ein Assistent, der für eine bestimmte Aufgabe maßgeschneidert ist, eine berühmte Persönlichkeit oder ein fiktiver Charakter.
89
+
90
+ Das Namensfeld ist der einzige erforderliche Eingabewert für die Charakterkarte. Um ein neutrales Gespräch mit dem LLM zu beginnen, erstelle eine neue Karte, die einfach "Assistent" genannt wird, und lasse die restlichen Felder leer. Für einen thematischeren Chat kannst du dem LLM verschiedene Hintergrundinformationen, Verhaltensweisen und Schreibmuster sowie ein Szenario geben, um das Gespräch zu beginnen.
91
+
92
+ Um ein schnelles Gespräch zu führen, ohne eine Charakterkarte auszuwählen, oder um einfach die LLM-Verbindung zu testen, gib einfach dein Prompt in die Eingabezeile auf dem Willkommensbildschirm ein, nachdem du SillyTavern geöffnet hast. Bitte beachte, dass solche Chats vorübergehend sind und nicht gespeichert werden.
93
+
94
+ Um eine allgemeine Vorstellung davon zu bekommen, wie man Charakterkarten definiert, sieh dir die mitgelieferte Charakterkarte (Seraphina) an oder lade ausgewählte von der Community erstellte Karten im Menü "Erweiterungen & Assets herunterladen" herunter.
95
+
96
+ ## Wichtigste Features
97
+
98
+ * Erweiterte Text-Generierungs-Einstellungen mit vielen von der Community erstellten mitgelieferten Einstellungen (Presets)
99
+ * Unterstützung für World Info: Erstelle reichhaltige Lore oder reduziere die Tokens in deiner Charakterkarte
100
+ * Gruppenchats: Multi-Bot-Räume für Charaktere, die mit dir und/oder untereinander sprechen
101
+ * Reichhaltige UI-Anpassungsoptionen: Themes zur Farbenwahl, Hintergrundbilder, benutzerdefiniertes CSS und mehr
102
+ * Benutzer-Personas: Lass die KI ein wenig über dich wissen, um die Immersion zu erhöhen
103
+ * Eingebaute RAG-Unterstützung: Füge Dokumente zu deinen Chats hinzu, auf die die KI verweisen kann
104
+ * Umfangreiches "Chat-Befehle"-System und eigene [Scripting-Engine](https://docs.sillytavern.app/usage/st-script/)
105
+
106
+ ## Erweiterungen
107
+
108
+ SillyTavern unterstützt Erweiterungen.
109
+
110
+ * Emotionale Ausdrucksformen von Charakteren (Sprites)
111
+ * Automatische Zusammenfassung des Chatverlaufs
112
+ * Automatische UI- und Chat-Übersetzung
113
+ * Bildgenerierung mit Stable Diffusion/FLUX/DALL-E
114
+ * Text-to-Speech für KI-Antwortnachrichten (über ElevenLabs, Silero oder die TTS-Funktion des Betriebssystems)
115
+ * Websuchfunktionen zum Hinzufügen zusätzlicher realer Kontexte zu deinen Eingabeaufforderungen
116
+ * Viele weitere sind im Menü "Erweiterungen & Assets herunterladen" verfügbar.
117
+
118
+ Tutorials zur Nutzung findest du in der [Dokumentation](https://docs.sillytavern.app/).
119
+
120
+ # ⌛ Installation
121
+
122
+ > \[!WARNING]
123
+ >
124
+ > * INSTALLIERE NICHT IN EINEM VON WINDOWS KONTROLLIERTEN ORDNER (Programme, System32 usw.).
125
+ > * FÜHRE START.BAT NICHT MIT ADMIN-BERECHTIGUNGEN AUS.
126
+ > * DIE INSTALLATION AUF WINDOWS 7 IST UNMÖGLICH, DA ES NODEJS 18.16 NICHT AUSFÜHREN KANN.
127
+
128
+ ## 🪟 Windows
129
+
130
+ ### Installation über Git
131
+
132
+ 1. Installiere [NodeJS](https://nodejs.org/en) (die neueste LTS-Version wird empfohlen).
133
+ 2. Installiere [Git für Windows](https://gitforwindows.org/).
134
+ 3. Öffne den Windows-Explorer (`Win+E`).
135
+ 4. Gehe zu oder erstelle einen Ordner, der nicht von Windows kontrolliert oder überwacht wird. (z.B.: C:\MySpecialFolder\)
136
+ 5. Öffne ein Eingabeaufforderungsfenster in diesem Ordner, indem du in die 'Adressleiste' oben klickst, `cmd` eingibst und Enter drückst.
137
+ 6. Sobald das schwarze Fenster (Eingabeaufforderung) erscheint, gib EINE der folgenden Optionen ein und drücke Enter:
138
+
139
+ * für den Release-Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
140
+ * für den Staging-Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
141
+
142
+ 7. Sobald alles geklont ist, doppelklicke auf `Start.bat`, damit NodeJS seine Anforderungen installiert.
143
+ 8. Der Server wird dann gestartet, und SillyTavern wird in deinem Browser geöffnet.
144
+
145
+ ### Installation über GitHub Desktop
146
+
147
+ (Dies ermöglicht die Nutzung von git **nur** in GitHub Desktop. Wenn du `git` auch in der Eingabeaufforderung verwenden möchtest, musst du auch [Git für Windows](https://gitforwindows.org/) installieren.)
148
+
149
+ 1. Installiere [NodeJS](https://nodejs.org/en) (die neueste LTS-Version wird empfohlen).
150
+ 2. Installiere [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32).
151
+ 3. Klicke nach der Installation von GitHub Desktop auf `Ein Repository aus dem Internet klonen....` (Hinweis: Du **musst kein** GitHub-Konto für diesen Schritt erstellen).
152
+ 4. Klicke im Menü auf den Tab URL, gib diese URL ein `https://github.com/SillyTavern/SillyTavern` und klicke auf Klonen. Du kannst den lokalen Pfad ändern, um festzulegen, wohin SillyTavern heruntergeladen werden soll.
153
+ 5. Um SillyTavern zu öffnen, durchsuche mit dem Windows-Explorer den Ordner, in den du das Repository geklont hast. Standardmäßig wird das Repository hier hin geklont: `C:\Users\[Dein Windows-Benutzername]\Documents\GitHub\SillyTavern`.
154
+ 6. Doppelklicke auf die Datei `start.bat`. (Hinweis: Der Teil `.bat` des Dateinamens könnte von deinem Betriebssystem verborgen sein. In diesem Fall sieht es aus wie eine Datei namens "`Start`". Dies ist die Datei, auf die du doppelklickst, um SillyTavern auszuführen.)
155
+ 7. Nach dem Doppelklicken sollte ein großes schwarzes Konsolenfenster erscheinen, und SillyTavern beginnt, das zu installieren, was es zum Betrieb benötigt.
156
+ 8. Nach dem Installationsprozess sollte das Konsolenfenster so aussehen, und ein SillyTavern-Tab sollte in deinem Browser geöffnet sein.
157
+ 9. Verbinde dich mit einer der [unterstützten APIs](https://docs.sillytavern.app/usage/api-connections/) und beginne zu chatten!
158
+
159
+ ## 🐧 Linux & 🍎 MacOS
160
+
161
+ Für MacOS/Linux werden all diese Schritte in einem Terminal durchgeführt.
162
+
163
+ 1. Installiere git und nodeJS (die Methode zur Durchführung hängt von deinem Betriebssystem ab).
164
+ 2. Klone das Repository.
165
+
166
+ * für den Release-Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
167
+ * für den Staging-Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
168
+
169
+ 3. `cd SillyTavern`, um in den Installationsordner zu navigieren.
170
+ 4. Führe das Skript `start.sh` mit einem dieser Befehle aus:
171
+
172
+ * `./start.sh`
173
+ * `bash start.sh`
174
+
175
+ ## ⚡ Installation über SillyTavern Launcher
176
+
177
+ Der SillyTavern Launcher ist ein Installationsassistent, der dir bei der Einrichtung mit vielen Optionen helfen wird, einschließlich der Installation eines Backends für lokale Inferenz.
178
+
179
+ ### Für Windows-Nutzer
180
+
181
+ 1. Drücke auf deiner Tastatur **`WINDOWS + R`**, um das Ausführen-Dialogfeld zu öffnen. Führe dann den folgenden Befehl aus, um git zu installieren:
182
+
183
+ ```shell
184
+ cmd /c winget install -e --id Git.Git
185
+ ```
186
+
187
+ 2. Drücke auf deiner Tastatur **`WINDOWS + E`**, um den Datei-Explorer zu öffnen, und navigiere dann zu dem Ordner, in dem du den Launcher installieren möchtest. Gib im gewünschten Ordner in die Adressleiste `cmd` ein und drücke Enter. Führe dann den folgenden Befehl aus:
188
+
189
+ ```shell
190
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
191
+ ```
192
+
193
+ ### Für Linux-Nutzer
194
+
195
+ 1. Öffne dein bevorzugtes Terminal und installiere git.
196
+ 2. Klone den SillyTavern-Launcher mit:
197
+
198
+ ```shell
199
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
200
+ ```
201
+
202
+ 3. Starte die installer.sh mit:
203
+
204
+ ```shell
205
+ chmod +x install.sh && ./install.sh
206
+ ```
207
+
208
+ 4. Nach der Installation starte die launcher.sh mit:
209
+
210
+ ```shell
211
+ chmod +x launcher.sh && ./launcher.sh
212
+ ```
213
+
214
+ ### Für Mac-Nutzer
215
+
216
+ 1. Öffne ein Terminal und installiere brew mit:
217
+
218
+ ```shell
219
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
220
+ ```
221
+
222
+ 2. Installiere git mit:
223
+
224
+ ```shell
225
+ brew install git
226
+ ```
227
+
228
+ 3. Klone den SillyTavern-Launcher mit:
229
+
230
+ ```shell
231
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
232
+ ```
233
+
234
+ 4. Starte die installer.sh mit:
235
+
236
+ ```shell
237
+ chmod +x install.sh && ./install.sh
238
+ ```
239
+
240
+ 5. Nach der Installation starte die launcher.sh mit:
241
+
242
+ ```shell
243
+ chmod +x launcher.sh && ./launcher.sh
244
+ ```
245
+
246
+ ## 🐋 Installation über Docker
247
+
248
+ Diese Anweisungen setzen voraus, dass du Docker installiert hast, auf deine Befehlszeile für die Installation von Containern zugreifen kannst und mit deren allgemeiner Funktionsweise vertraut bist.
249
+
250
+ ### Image selbst bauen
251
+
252
+ Wir haben einen umfassenden Leitfaden zur Nutzung von SillyTavern in Docker [hier](http://docs.sillytavern.app/installation/docker/) der die Installationen auf Windows, macOS und Linux abdeckt! Lies ihn, wenn du das Image selbst bauen möchtest.
253
+
254
+ ### Verwendung der GitHub Container Registry (am einfachsten)
255
+
256
+ Du benötigst zwei zwingende Verzeichniszuordnungen und eine Portzuordnung, um SillyTavern funktionsfähig zu machen. Ersetze in dem Befehl deine Auswahl an den folgenden Stellen:
257
+
258
+ #### Container-Variablen
259
+
260
+ ##### Volumen-Zuordnungen
261
+
262
+ * [config] - Das Verzeichnis, in dem die SillyTavern-Konfigurationsdateien auf deinem Host-Computer gespeichert werden
263
+ * [data] - Das Verzeichnis, in dem die Benutzerdaten von SillyTavern (einschließlich Charaktere) auf deinem Host-Computer gespeichert werden
264
+ * [plugins] - (optional) Das Verzeichnis, in dem die SillyTavern-Server-Plugins auf deinem Host-Computer gespeichert werden
265
+
266
+ ##### Port-Zuordnungen
267
+
268
+ * [PublicPort] - Der Port, über den der Datenverkehr ausgegeben werden soll. Dies ist zwingend erforderlich, da du auf die Instanz von außerhalb des virtuellen Maschinencontainers zugreifst. EXPOSIERE DIES NICHT IM INTERNET, OHNE EINEN GETRENNTEN SERVICE FÜR DIE SICHERHEIT ZU IMPLEMENTIEREN.
269
+
270
+ ##### Zusätzliche Einstellungen
271
+
272
+ * [DockerNet] - Das Docker-Netzwerk, mit dem der Container erstellt werden soll. Wenn du nicht weißt, was das ist, sieh dir die [offizielle Docker-Dokumentation](https://docs.docker.com/reference/cli/docker/network/) an.
273
+ * [version] - Auf der rechten Seite dieser GitHub-Seite siehst du "Packages". Wähle das Paket "sillytavern" und du siehst die Imageversionen. Das Image-Tag "latest" hält dich auf dem Laufenden mit dem aktuellen Release. Du kannst auch "staging" und "release" Tags nutzen, die auf die nightly images der jeweiligen Branche verweisen, aber das könnte unangemessen sein, wenn du Erweiterungen verwendest, die möglicherweise kaputt sind und Zeit benötigen, um aktualisiert zu werden.
274
+
275
+ #### Installationsbefehl
276
+
277
+ 1. Öffne deine Befehlszeile.
278
+ 2. Führe den folgenden Befehl aus:
279
+
280
+ `docker create --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
281
+
282
+ > Beachte, dass 8000 ein Standard-Listening-Port ist. Vergiss nicht, einen geeigneten Port zu verwenden, wenn du ihn in der Konfiguration änderst.
283
+
284
+ ## 📱 Installation über Termux auf Android OS
285
+
286
+ > \[!HINWEIS]
287
+ > **SillyTavern kann nativ auf Android-Geräten über Termux ausgeführt werden, aber wir bieten keine offizielle Unterstützung für diesen Anwendungsfall.**
288
+ >
289
+ > **Bitte beziehe dich auf diesen Leitfaden von ArroganceComplex#2659:**
290
+ >
291
+ > * <https://rentry.org/STAI-Termux>
292
+
293
+ **Nicht unterstützte Plattform: android arm LEtime-web.** 32-Bit-Android benötigt eine externe Abhängigkeit, die nicht mit npm installiert werden kann. Verwende den folgenden Befehl, um sie zu installieren: `pkg install esbuild`. Führe dann die üblichen Installationsschritte aus.
294
+
295
+ ## API-Schlüsselverwaltung
296
+
297
+ SillyTavern speichert deine API-Schlüssel in einer Datei `secrets.json` im Benutzerdatenverzeichnis (`/data/default-user/secrets.json` ist der Standardpfad).
298
+
299
+ Standardmäßig sind API-Schlüssel nach dem Speichern und Aktualisieren der Seite nicht mehr über die Benutzeroberfläche sichtbar.
300
+
301
+ Um die Ansicht deiner Schlüssel zu aktivieren:
302
+
303
+ 1. Setze den Wert von `allowKeysExposure` auf `true` in der Datei `config.yaml`.
304
+ 2. Starte den SillyTavern-Server neu.
305
+ 3. Klicke auf den Link 'Verborgene API-Schlüssel anzeigen' in der unteren rechten Ecke des API-Verbindungsfeldes.
306
+
307
+ ## Befehlszeilenargumente
308
+
309
+ Sie können Befehlszeilenargumente an den Start des SillyTavern-Servers übergeben, um einige Einstellungen in `config.yaml` zu überschreiben.
310
+
311
+ ### Beispiele
312
+
313
+ ```shell
314
+ node server.js --port 8000 --listen false
315
+ # oder
316
+ npm run start -- --port 8000 --listen false
317
+ # oder (nur Windows)
318
+ Start.bat --port 8000 --listen false
319
+ ```
320
+
321
+ ### Unterstützte Argumente
322
+
323
+ | Option | Beschreibung | Typ |
324
+ |-------------------------|----------------------------------------------------------------------------------------------------|----------|
325
+ | `--version` | Versionsnummer anzeigen | boolean |
326
+ | `--enableIPv6` | Aktiviert IPv6. | boolean |
327
+ | `--enableIPv4` | Aktiviert IPv4. | boolean |
328
+ | `--port` | Legt den Port fest, unter dem SillyTavern ausgeführt wird. Wenn nicht angegeben, wird auf YAML-Konfiguration „Port“ zurückgegriffen. | number |
329
+ | „--dnsPreferIPv6“ | Bevorzugt IPv6 für DNS. Wenn nicht angegeben, wird auf YAML-Konfiguration „preferIPv6“ zurückgegriffen. | boolean |
330
+ | „--autorun“ | Startet SillyTavern automatisch im Browser. Wenn nicht angegeben, wird auf YAML-Konfiguration „autorun“ zurückgegriffen.| boolean |
331
+ | „--autorunHostname“ | Der Autorun-Hostname, am besten auf „auto“ belassen. | string |
332
+ | „--autorunPortOverride“ | Überschreibt den Port für Autorun. | string |
333
+ | „--listen“ | SillyTavern lauscht auf allen Netzwerkschnittstellen. Wenn nicht angegeben, wird auf YAML-Konfiguration „listen“ zurückgegriffen.| boolean |
334
+ | „--corsProxy“ | Aktiviert CORS-Proxy. Wenn nicht angegeben, wird auf YAML-Konfiguration „enableCorsProxy“ zurückgegriffen. | boolean |
335
+ | `--disableCsrf` | Deaktiviert CSRF-Schutz | boolean |
336
+ | `--ssl` | Aktiviert SSL | boolean |
337
+ | `--certPath` | Pfad zu Ihrer Zertifikatsdatei. | string |
338
+ | `--keyPath` | Pfad zu Ihrer privaten Schlüsseldatei. | string |
339
+ | `--whitelist` | Aktiviert den Whitelist-Modus | boolean |
340
+ | `--dataRoot` | Stammverzeichnis für Datenspeicherung | string |
341
+ | `--avoidLocalhost` | Vermeidet die Verwendung von „localhost“ für Autorun im Auto-Modus. | boolean |
342
+ | `--basicAuthMode` | Aktiviert die grundlegende Authentifizierung | boolean |
343
+ | `--requestProxyEnabled` | Aktiviert die Verwendung eines Proxys für ausgehende Anfragen | boolean |
344
+ | `--requestProxyUrl` | Proxy-URL anfordern (HTTP- oder SOCKS-Protokolle) | string |
345
+ | `--requestProxyBypass` | Proxy-Bypass-Liste anfordern (durch Leerzeichen getrennte Liste von Hosts) | Array |
346
+
347
+ ## Remoteverbindungen
348
+
349
+ Dies ist in den meisten Fällen für Personen gedacht, die SillyTavern auf ihren Mobiltelefonen verwenden möchten, während ihr PC den ST-Server im selben WLAN-Netzwerk betreibt. Es kann jedoch auch verwendet werden, um Remoteverbindungen von überall her zu ermöglichen.
350
+
351
+ Lies die ausführliche Anleitung zum Einrichten von Remoteverbindungen in den [Docs](https://docs.sillytavern.app/usage/remoteconnections/).
352
+
353
+ Möglicherweise möchtest du SillyTavern-Benutzerprofile auch mit (optionalem) Kennwortschutz konfigurieren: [Benutzer](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users).
354
+
355
+ ## Leistungsprobleme?
356
+
357
+ 1. Deaktiviere den Unschärfeeffekt und aktiviere "Verringerte Bewegung" im Bedienfeld "Benutzereinstellungen" (UI-Design schaltet Kategorie um).
358
+ 2. Wenn du Response Streaming verwendest, stelle die Streaming-FPS auf einen niedrigeren Wert ein (10-15 FPS werden empfohlen).
359
+ 3. Stelle sicher, dass der Browser die GPU-Beschleunigung zum Rendern verwenden kann.
360
+
361
+ ## Lizenz und Danksagungen
362
+
363
+ **Dieses Programm wird in der Hoffnung verbreitet, dass es nützlich ist,
364
+ aber OHNE JEGLICHE GARANTIE; nicht einmal die stillschweigende Garantie der
365
+ MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Siehe die
366
+ GNU Affero General Public License für weitere Details.**
367
+
368
+ * [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8 von Humi: MIT-Lizenz
369
+ * Teile von CncAnons TavernAITurbo-Mod werden mit Genehmigung verwendet
370
+ * Visual Novel-Modus inspiriert von der Arbeit von PepperTaco (<https://github.com/peppertaco/Tavern/>)
371
+ * Noto Sans-Schriftart von Google (OFL-Lizenz)
372
+ * Symboldesign von Font Awesome <https://fontawesome.com> (Symbole: CC BY 4.0, Schriftarten: SIL OFL 1.1, Code: MIT-Lizenz)
373
+ * Standardinhalt von @OtisAlejandro (Seraphina-Charakter und Lorebook) und @kallmeflocc (10.000 Discord-Benutzer-Feierhintergrund)
374
+ * Docker-Anleitung von [@mrguymiah](https://github.com/mrguymiah) und [@Bronya-Rand](https://github.com/Bronya-Rand)
375
+
376
+ ## Top Contributors
377
+
378
+ [![Contributors](https://contrib.rocks/image?repo=SillyTavern/SillyTavern)](https://github.com/SillyTavern/SillyTavern/graphs/contributors)
379
+
380
+ <!-- LINK GROUP -->
381
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
382
+ [discord-link]: https://discord.gg/sillytavern
383
+ [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge
jiuguan2025cc/.github/readme-ja_jp.md ADDED
@@ -0,0 +1,330 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > ここに掲載されている情報は、古かったり不完全であったりする可能性があります。最新の情報は英語版をご利用ください。
3
+
4
+ ![][cover]
5
+
6
+ <div align="center">
7
+
8
+ [English](readme.md) | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | 日本語 | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
9
+
10
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
11
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
12
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
13
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
14
+
15
+ </div>
16
+
17
+ ---
18
+
19
+ モバイルデバイスにも適したレイアウト・マルチAPI(KoboldAI/CPP、Horde、NovelAI、Ooba、OpenAI、OpenRouter、Claude、Scale)、VN ライクな Waifu モード、Stable Diffusion、TTS、WorldInfo(伝承本)、カスタマイズ可能なUI、自動翻訳、大量のプロンプトオプション+サードパーティの拡張機能をインストールする機能
20
+
21
+ [TavernAI](https://github.com/TavernAI/TavernAI) v.1.2.8 のフォークに基づいています。
22
+
23
+ ## 重要事項
24
+
25
+ 1. 私たちは[ドキュメントウェブサイト](https://docs.sillytavern.app/) を作成し、ほとんどの質問にお答えしています。
26
+
27
+ 2. アップデートしたら使っていた拡張機能を見失いましたか?リリースバージョン 1.10.6 以降、これまで内蔵されていた拡張機能のほとんどがダウンロード可能なアドオンに変更されました。ダウンロードは、拡張機能パネル(トップバーのスタックドブロックアイコン)にある内蔵の "Download Extensions and Assets" メニューから行えます。
28
+
29
+ ### Cohee、RossAscends、SillyTavern コミュニティがお届けします
30
+
31
+ ### SillyTavern または TavernAI とは何ですか?
32
+
33
+ SillyTavern は、あなたのコンピュータ(および Android スマホ)にインストールできるユーザーインターフェイスで、テキスト生成 AI と対話したり、あなたやコミュニティが作成したキャラクターとチャットやロールプレイをすることができます。
34
+
35
+ SillyTavern は TavernAI 1.2.8 のフォークで、より活発な開発が行われており、多くの主要な機能が追加されています。現時点では、これらは完全に独立したプログラムと考えることができます。
36
+
37
+ ### ブランチ
38
+
39
+ SillyTavern は、すべてのユーザーにスムーズな体験を保証するために、2 つのブランチシステムを使用して開発されています。
40
+
41
+ * release -🌟 **ほとんどのユーザーにお勧め。** これは最も安定した推奨ブランチで、メジャーリリースがプッシュされた時のみ更新されます。大半のユーザーに適しています。
42
+ * staging - ⚠️ **カジュアルな使用にはお勧めしない。** このブランチには最新の機能がありますが、いつ壊れるかわからないので注意してください。パワーユーザーとマニア向けです。
43
+
44
+ git CLI の使い方に慣れていなかったり、ブランチが何なのかわからなかったりしても、心配はいりません!releaseブランチが良い選択肢となります。
45
+
46
+ ### Tavern 以外に何が必要ですか?
47
+
48
+ Tavern は単なるユーザーインターフェイスなので、それだけでは何もできません。ロールプレイキャラクターとして機能する AI システムのバックエンドにアクセスする必要があります。様々なバックエンドがサポートされています。リストはこちらです: OpenAPI API (GPT)、KoboldAI (ローカルまたは Google Colab 上で動作)、その他。詳しくは [FAQ](https://docs.sillytavern.app/usage/faq/) をご覧ください。
49
+
50
+ ### Tavern を実行するには、ハイスペックなPCが必要ですか?
51
+
52
+ Tavern は単なるフロントエンドのUIであり、必要なハードウェアはごくわずかです。パワフルである必要があるのは、AI システムのバックエンドです。
53
+
54
+ ## モバイルサポート
55
+
56
+ > **注**
57
+
58
+ > **このフォークは Termux を使って Android スマホで実行できます。ArroganceComplex#2659 のガイドを参照してください:**
59
+
60
+ <https://rentry.org/STAI-Termux>
61
+
62
+ ## ご質問やご提案
63
+
64
+ ### コミュニティ Discord サーバーを開設しました
65
+
66
+ サポートを受けたり、作成したキャラを共有したり、コミュニティの作ったキャラと遊びたいですか?:
67
+
68
+ ### [参加](https://discord.gg/RZdyAEUPvj)
69
+
70
+ ***
71
+
72
+ 開発者と直接連絡:
73
+
74
+ * Discord: cohee または rossascends
75
+ * Reddit: /u/RossAscends または /u/sillylossy
76
+ * [GitHub issue を投稿](https://github.com/SillyTavern/SillyTavern/issues)
77
+
78
+ ## このバージョンには以下のコードが含まれます
79
+
80
+ * 大幅に修正された TavernAI 1.2.8 (コードの 50% 以上が書き換えまたは最適化されています)
81
+ * スワイプ
82
+ * グループチャット: キャラクター同士が会話できるマルチボットルーム
83
+ * チャットチェックポイント / ブランチ
84
+ * 高度なKoboldAI / TextGen生成設定と、コミュニティが作成した多くのプリセット
85
+ * ワールド情報サポート: 豊富な伝承を作成したり、キャラクターカードにトークンを保存したりできます
86
+ * [OpenRouter](https://openrouter.ai) 各種 API(Claude、GPT-4/3.5 など)の接続
87
+ * [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) API 接続
88
+ * [AI Horde](https://aihorde.net/) 接続
89
+ * プロンプト生成フォーマットの調整
90
+
91
+ ## 拡張機能
92
+
93
+ SillyTavern は拡張できるようになっており。
94
+
95
+ * キャラクターの感情表現(スプライト)
96
+ * チャット履歴の自動サマリー
97
+ * チャットに画像を送り、AI が内容を解釈する
98
+ * Stable Diffusion 画像生成 (5 つのチャット関連プリセットと 'free mode')
99
+ * AI 応答メッセージの音声合成(ElevenLabs、Silero、または OS のシステム TTS 経由)
100
+
101
+ 含まれている拡張機能の完全なリストとその使い方のチュートリアルは [Docs](https://docs.sillytavern.app/) にあります。
102
+
103
+ ## RossAscends による UI/CSS/クオリティオブライフの調整
104
+
105
+ * iOS 用に最適化されたモバイル UI で、ホーム画面へのショートカット保存とフルスクリーンモードでの起動をサポート。
106
+ * ホットキー
107
+ * Up = チャットの最後のメッセージを編集する
108
+ * Ctrl+Up = チャットで最後のユーザーメッセージを編集する
109
+ * Left = 左スワイプ
110
+ * Right = 右スワイプ (注: チャットバーに何か入力されている場合、スワイプホットキーが無効になります)
111
+ * Ctrl+Left = ローカルに保存された変数を見る(ブラウザのコンソールウィンドウにて)
112
+ * Enter (チャットバー選択時) = AI にメッセージを送る
113
+ * Ctrl+Enter = 最後の AIのレスポンスを再生成する
114
+
115
+ * ユーザー名の変更と文字の削除でページが更新されなくなりました。
116
+
117
+ * ページロード時に API に自動的に接続するかどうかを切り替えます。
118
+ * ページの読み込み時に、最近見た文字を自動的に読み込むかどうかを切り替えます。
119
+ * より良いトークンカウンター - 保存されていないキャラクターに対して機能し、永続的なトークンと一時的なトークンの両方を表示する。
120
+
121
+ * より良い過去のチャット
122
+ * 新しいチャットのファイル名は、"(文字) - (作成日)" という読みやすい形式で保存されます
123
+ * チャットのプレビューが 40 文字から 300 文字に増加。
124
+ * 文字リストの並べ替えに複数のオプション(名前順、作成日順、チャットサイズ順)があります。
125
+
126
+ * デフォルトでは、左右の設定パネルはクリックすると閉じます。
127
+ * ナビパネルのロックをクリックすると、パネルが開いたままになり、この設定はセッションをまたいで記憶されます。
128
+ * ナビパネルの開閉状態もセッションをまたいで保存されます。
129
+
130
+ * カスタマイズ可能なチャット UI:
131
+ * 新しいメッセージが届いたときにサウンドを再生する
132
+ * 丸型、長方形のアバタースタイルの切り替え
133
+ * デスクトップのチャットウィンドウを広くする
134
+ * オプションの半透明ガラス風パネル
135
+ * 'メインテキスト'、'引用テキスト'、'斜体テキスト'のページカラーをカスタマイズ可能。
136
+ * カスタマイズ可能な UI 背景色とぼかし量
137
+
138
+ ## インストール
139
+
140
+ *注: このソフトウェアはローカルにインストールすることを目的としており、colab や他のクラウドノートブックサービス上では十分にテストされていません。*
141
+
142
+ > **警告**
143
+
144
+ > WINDOWS が管理しているフォルダ(Program Files、System32 など)にはインストールしないでください
145
+
146
+ > START.BAT を管理者権限で実行しないでください
147
+
148
+ ### Windows
149
+
150
+ Git 経由でのインストール(更新を容易にするため推奨)
151
+
152
+ 写真付きのわかりやすいガイドはこちらです:
153
+ <https://docs.sillytavern.app/installation/windows/>
154
+
155
+ 1. [NodeJS](https://nodejs.org/en) をインストール(最新の LTS 版を推奨)
156
+ 2. [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32) をインストールする
157
+ 3. Windows エクスプローラーを開く (`Win+E`)
158
+ 4. Windows によって制御または監視されていないフォルダを参照または作成する。(例: C:\MySpecialFolder\)
159
+ 5. 上部のアドレスバーをクリックし、`cmd` と入力して Enter キーを押し、そのフォルダーの中にコマンドプロンプトを開きます。
160
+ 6. 黒いボックス(コマンドプロンプト)がポップアップしたら、そこに以下のいずれかを入力し、Enter を押します:
161
+
162
+ * Release ブランチの場合: `git clone https://github.com/SillyTavern/SillyTavern -b release`
163
+ * Staging ブランチの場合: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
164
+
165
+ 7. すべてをクローンしたら、`Start.bat` をダブルクリックして、NodeJS に要件をインストールさせる。
166
+ 8. サーバーが起動し、SillyTavern がブラウザにポップアップ表示されます。
167
+
168
+ ZIP ダウンロードによるインストール(推奨しない)
169
+
170
+ 1. [NodeJS](https://nodejs.org/en) をインストールする(最新の LTS 版を推奨)
171
+ 2. GitHub のリポジトリから zip をダウンロードする。(`ソースコード(zip)` は [Releases](https://github.com/SillyTavern/SillyTavern/releases/latest) から入手)
172
+ 3. お好きなフォルダに解凍してください
173
+ 4. `Start.bat` をダブルクリックまたはコマンドラインで実行する。
174
+ 5. サーバーが準備できれば、ブラウザのタブを開きます。
175
+
176
+ ### Linux
177
+
178
+ 1. `node -v` を実行して、Node.js v18 以上(最新の [LTS バージョン](https://nodejs.org/en/download/) を推奨)がインストールされていることを確認してください。
179
+ または、[Node Version Manager](https://github.com/nvm-sh/nvm#installing-and-updating) スクリプトを使用して、迅速かつ簡単に Node のインストールを管理します。
180
+ 2. `start.sh` スクリプトを実行する。
181
+ 3. お楽しみください。
182
+
183
+ ## API キー管理
184
+
185
+ SillyTavern は API キーをサーバーディレクトリの `secrets.json` ファイルに保存します。
186
+
187
+ デフォルトでは、入力後にページをリロードしても、フロントエンドには表示されません。
188
+
189
+ API ブロックのボタンをクリックして、キーを閲覧できるようにする:
190
+
191
+ 1. ファイル `config.yaml` で `allowKeysExposure` の値を `true` に設定する。
192
+ 2. SillyTavern サーバを再起動します。
193
+
194
+ ## リモート接続
195
+
196
+ SillyTavern をスマホで使用しながら、同じ Wifi ネットワーク上で ST サーバーを PC で実行したい場合に使用します。
197
+
198
+ しかし、これはどこからでもリモート接続を許可するために使用することができます。
199
+
200
+ **重要: SillyTavern はシングルユーザーのプログラムなので、ログインすれば誰でもすべてのキャラクターとチャットを見ることができ、UI 内で設定を変更することができます。**
201
+
202
+ ### 1. ホワイトリスト IP の管理
203
+
204
+ * SillyTavern のベースインストールフォルダ内に `whitelist.txt` という新しいテキストファイルを作成します。
205
+ * テキストエディタでこのファイルを開き、接続を許可したい IP のリストを追加します。
206
+
207
+ *個々の IP とワイルドカード IP 範囲の両方が受け入れられる。例:*
208
+
209
+ ```txt
210
+ 192.168.0.1
211
+ 192.168.0.20
212
+ ```
213
+
214
+ または
215
+
216
+ ```txt
217
+ 192.168.0.*
218
+ ```
219
+
220
+ (上記のワイルドカード IP 範囲は、ローカルネットワーク上のどのデバイスでも)
221
+
222
+ CIDR マスクも受け付ける(例:10.0.0.0/24)。
223
+
224
+ * `whitelist.txt` ファイルを保存する。
225
+ * TAI サーバーを再起動する。
226
+
227
+ これでファイルに指定された IP を持つデバイスが接続できるようになります。
228
+
229
+ *注: `config.yaml` にも `whitelist` 配列があり、同じように使うことができるが、`whitelist.txt` が存在する場合、この配列は無視される。*
230
+
231
+ ### 2. ST ホストマシンの IP の取得
232
+
233
+ ホワイトリストの設定後、ST ホストデバイスの IP が必要になります。
234
+
235
+ ST ホストデバイスが同じ無線 LAN ネットワーク上にある場合、ST ホストの内部無線 LAN IP を使用します:
236
+
237
+ * Windows の場合: ウィンドウズボタン > 検索バーに `cmd.exe` と入力 > コンソールに `ipconfig` と入力して Enter > `IPv4` のリストを探す。
238
+
239
+ 同じネットワーク上にいない状態で、ホストしているSTに接続したい場合は、STホスト機器のパブリックIPが必要です。
240
+
241
+ * ST ホストデバイスを使用中に、[このページ](https://whatismyipaddress.com/)にアクセスし、`IPv4` を探してください。これはリモートデバイスからの接続に使用するものです。
242
+
243
+ ### 3. リモートデバイスを ST ���ストマシンに接続します。
244
+
245
+ 最終的に使用する IP が何であれ、その IP アドレスとポート番号をリモートデバイスのウェブブラウザに入力します。
246
+
247
+ 同じ無線 LAN ネットワーク上の ST ホストの典型的なアドレスは以下のようになります:
248
+
249
+ `http://192.168.0.5:8000`
250
+
251
+ http:// を使用し、https:// は使用しないでください
252
+
253
+ ### ST をすべての IP に開放する
254
+
255
+ これはお勧めしませんが、`config.yaml` を開き、`whitelistMode` を `false` に変更してください。
256
+
257
+ SillyTavern のベースインストールフォルダにある `whitelist.txt` が存在する場合は削除(または名前の変更)する必要があります。
258
+
259
+ これは通常安全ではないので、これを行う際にはユーザー名とパスワードを設定する必要があります。
260
+
261
+ ユーザー名とパスワードは `config.yaml` で設定します。
262
+
263
+ ST サーバを再起動すると、ユーザ名とパスワードさえ知っていれば、IP に関係なくどのデバイスでも ST サーバに接続できるようになる。
264
+
265
+ ### まだ接続できませんか?
266
+
267
+ * `config.yaml` で見つかったポートに対して、インバウンド/アウトバウンドのファイアウォールルールを作成します。これをルーターのポートフォワーディングと間違えないでください。そうしないと、誰かがあなたのチャットログを見つける可能性があり、それはマジで止めましょう。
268
+ * 設定 > ネットワークとインターネット > イーサネットで、プライベートネットワークのプロファイルタイプを有効にします。そうしないと、前述のファイアウォールルールを使っても接続できません。
269
+
270
+ ## パフォーマンスに問題がありますか?
271
+
272
+ ユーザー設定パネルでブラー効果なし(高速 UI)モードを有効にしてみてください。
273
+
274
+ ## このプロジェクトが気に入りました!どうすれば貢献できますか?
275
+
276
+ ### やるべきこと
277
+
278
+ 1. プルリクエストを送る
279
+ 2. 確立されたテンプレートを使って機能提案と課題レポートを送る
280
+ 3. 何か質問する前に、readme ファイルや組み込みのドキュメントを読んでください
281
+
282
+ ### やるべきではないこと
283
+
284
+ 1. 金銭の寄付を申し出る
285
+ 2. 何の脈絡もなくバグ報告を送る
286
+ 3. すでに何度も回答されている質問をする
287
+
288
+ ## 古い背景画像はどこにありますか?
289
+
290
+ 100% オリジナルコンテンツのみのポリシーに移行しているため、古い背景画像はこのリポジトリから削除されました。
291
+
292
+ アーカイブはこちら:
293
+
294
+ <https://files.catbox.moe/1xevnc.zip>
295
+
296
+ ## スクリーンショット
297
+
298
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
299
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
300
+
301
+ ## ライセンスとクレジット
302
+
303
+ **このプログラムは有用であることを願って配布されていますが、いかなる保証もありません;
304
+ また、商品性または特定目的への適合性についての黙示の保証もありません。
305
+ 詳細は GNU Affero General Public License をご覧ください。**
306
+
307
+ * Humi によるTAI Base: 不明ライセンス
308
+ * Cohee の修正と派生コード: AGPL v3
309
+ * RossAscends の追加: AGPL v3
310
+ * CncAnon の TavernAITurbo 改造の一部: 不明ライセンス
311
+ * kingbri のさまざまなコミットと提案 (<https://github.com/bdashore3>)
312
+ * city_unit の拡張機能と様々な QoL 機能 (<https://github.com/city-unit>)
313
+ * StefanDanielSchwarz のさまざまなコミットとバグ報告 (<https://github.com/StefanDanielSchwarz>)
314
+ * PepperTaco の作品にインスパイアされた Waifu モード (<https:/fugithub.com/peppertaco/Tavern/>)
315
+ * ピグマリオン大学の皆さん、素晴らしいテスターとしてクールな機能を提案してくれてありがとう!
316
+ * TextGen のプリセットをコンパイルしてくれた obabooga に感謝
317
+ * KAI Lite の KoboldAI プリセット: <https://lite.koboldai.net/>
318
+ * Google による Noto Sans フォント(OFLライセンス)
319
+ * Font Awesome によるアイコンテーマ <https://fontawesome.com> (アイコン: CC BY 4.0、フォント: SIL OFL 1.1、コード: MIT License)
320
+ * ZeldaFan0225 による AI Horde クライアントライブラリ: <https://github.com/ZeldaFan0225/ai_horde>
321
+ * AlpinDale による Linux 起動スクリプト
322
+ * FAQ を提供してくれた paniphons に感謝
323
+ * 10K ディスコード・ユーザー記念背景 by @kallmeflocc
324
+ * デフォルトコンテンツ(キャラクターと伝承書)の提供: @OtisAlejandro、@RossAscends、@kallmeflocc
325
+ * @doloroushyeonse による韓国語翻訳
326
+ * k_euler_a による Horde のサポート <https://github.com/Teashrock>
327
+ * [@XXpE3](https://github.com/XXpE3) による中国語翻訳、中国語 ISSUES の連絡先は @XXpE3
328
+
329
+ <!-- LINK GROUP -->
330
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
jiuguan2025cc/.github/readme-ko_kr.md ADDED
@@ -0,0 +1,394 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > 이곳에 게재된 정보는 오래되거나 불완전할 수 있습니다. 최신 정보는 영어 버전을 이용하십시오.
3
+
4
+ <a name="readme-top"></a>
5
+
6
+ ![][cover]
7
+
8
+ <div align="center">
9
+
10
+ [English](readme.md) | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | 한국어
11
+
12
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
13
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
14
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
15
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
16
+
17
+ </div>
18
+
19
+ ---
20
+
21
+ SillyTavern은 많은 LLM API(KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral 등)에 대한 단일 통합 인터페이스, 모바일 친화적 레이아웃, 비주얼 노벨 모드, Automatic1111 & ComfyUI API 이미지 생성 통합, TTS, 월드 인포 (로어북), 커스텀 가능한 UI, 자동 번역, 필요 이상의 프롬프트 옵션, 그리고 서드파티 확장을 통한 무궁무진한 성장 가능성을 제공합니다.
22
+
23
+ 또한, 자주 묻는 질문에 대한 답변과, 시작하는 데 도움을 주기 위한 [문서 웹사이트](https://docs.sillytavern.app/)가 있습니다.
24
+
25
+ ## SillyTavern이 무엇인가요?
26
+
27
+ SillyTavern(짧게는 ST)은 텍스트 생성 LLM, 이미지 생성 엔진, TTS 음성 모델 등과 상호작할 수 있는 로컬 설치형 UI 입니다.
28
+
29
+ 2023년 2월, TavernAI 1.2.8의 포크로 시작한 SillyTavern은 현재 100명이 넘는 기여자를 보유하고 있으며, 2년간의 독자적인 개발을 거쳐 숙련된 AI 애호가들을 위한 선도적인 소프트웨어로 자리매김하고 있습니다.
30
+
31
+
32
+ ## 우리의 비전
33
+
34
+ 1. 저희는 사용자가 LLM 프롬프트에 대한 최대한의 유용성과 제어 능력을 갖도록 하는 것을 목표로 합니다. 빠르게 배우는 것 역시 재미의 일부입니다!
35
+ 2. 저희는 어떠한 온라인 및 호스팅 서브시도 제공하지 않으며, 프로그래밍으로 사용자의 데이터를 추적하지 않습니다.
36
+ 3. SillyTavern은 헌신적인 LLM 커뮤니티가 여러분에게 제공하는 열정적인 프로젝트이며, 언제나 무료이며 오픈소스로 제공될 것입니다.
37
+
38
+ ## 브랜치
39
+
40
+ SillyTavern은 모든 사용자가 원활한 경험을 할 수 있도록 두 개의 브랜치를 활용하여 개발되고 있습니다.
41
+
42
+
43
+ * `release` -🌟 **대부분의 사용자에게 추천됨.** 가장 안정적이고 권장되는 브랜치이며, 주요 릴리스가 배포될 때만 업데이트됩니다. 대부분의 사용자에게 적합합니다. 일반적으로 한달에 한번 업데이트됩니다.
44
+ * `staging` - ⚠️ **일반적인 사용에 추천되지 않음.** 최신 기능을 가지고 있지만, 언제든지 문제가 발생할 수 있습니다. 고급 사용자 및 숙련자 전용입니다. 하루에 여러번 업데이트됩니다.
45
+
46
+ 만약 git CLI 사용에 익숙하지 않거나 브랜치가 무엇인지 모르겠다면 release 브랜치가 더 나은 선택입니다.
47
+
48
+ ## SillyTavern 외에 무엇이 필요한가요?
49
+
50
+ SillyTavern은 인터페이스 역할만 하기 때문에, 실제로 채팅하려면 LLM 백엔드에 대한 액세스 권한이 필요합니다. 즉시 사용 가능한 채팅을 위해 AI Horde를 사용할 수 있습니다. 그 외에도 OpenAI 호환 API, KoboldAI, Tabby 등 많은 로컬 및 클라우드 기반 LLM 백엔드를 지원합니다. 지원되는 API에 대한 자세한 내용은 [FAQ](https://docs.sillytavern.app/usage/api-connections/)에서 확인할 수 있습니다.
51
+
52
+ ### SillyTavern을 위해서 좋은 성능의 PC가 필요한가요?
53
+
54
+ 하드웨어 요구 사항은 거의 없습니다: NodeJS 18 이상을 실행할 수 있는 모든 환경에서 작동합니다. 다만 로컬 LLM 모델을 사용할 경우, 최소 6GB VRAM 이상의 3000번대 NVIDIA 그래픽 카드를 권장합니다. 자세한 내용은 백엔드 문서를 참고하세요.
55
+
56
+ ### 추천되는 백엔드 (제휴 없음)
57
+
58
+ * [AI Horde](https://aihorde.net/) - 자원 봉사자들이 호스팅하는 모델을 사용합니다. 추가 설정이 필요하지 않습니다.
59
+ * [KoboldCpp](https://github.com/LostRuins/koboldcpp) - 로컬에서 GGUF 모델을 실행하기 위한 커뮤니티에서 선호하는 옵션입니다.
60
+ * [tabbyAPI](https://github.com/theroyallab/tabbyAPI) - 인기 있는 경량 로컬 exl2 추론 API입니다.
61
+ * [OpenRouter](https://openrouter.ai) - OpenAI, Claude, Meta Llama 등 다양한 클라우드 제공업체와 인기 있는 커뮤니티 모델을 위한 단일 API입니다.
62
+
63
+ ## 질문이나 제안이 있으신가���?
64
+
65
+ ### 디스코드 서버
66
+
67
+ | [![][discord-shield-badge]][discord-link] | [저희의 디스코드에 참여하세요!](https://discord.gg/sillytavern) 지원을 받고, 좋아하는 캐릭터와 프롬프트를 공유하세요. |
68
+ | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
69
+
70
+ 혹은 저희의 개발자들과 직접 연락할 수 있습니다:
71
+
72
+ * 디스코드: cohee, rossascends, wolfsblvt
73
+ * 레딧: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/)
74
+ * [GitHub issue를 작성하세요](https://github.com/SillyTavern/SillyTavern/issues)
75
+
76
+ ### 이 프로젝트가 마음에 들어요! 어떻게 기여할 수 있을까요?
77
+
78
+ 1. PULL REQUEST를 생성하세요. 기여 방법에 대해서는 [CONTRIBUTING.md](../CONTRIBUTING.md)를 참고하세요.
79
+ 2. 제공된 탬플릿에 따라 기능 제안이나 이슈 리포트를 생성하세요.
80
+ 3. 중복된 이슈를 생성하지 않도록 이 README 파일 전체를 읽고 문서 웹사이트를 먼저 확인하세요.
81
+
82
+ ## 스크린샷
83
+
84
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
85
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
86
+
87
+
88
+ ## 캐릭터 카드
89
+
90
+ SillyTavern은 "캐릭터 카드"라는 개념을 중심으로 구축되었습니다. 캐릭터 카드는 LLM의 동작을 설정하는 프롬프트 모음이며, SillyTavern에서 지속적인 대화를 하려면 필수적입니다. 이는 ChatGPT의 GPT 또는 Poe의 봇과 유사하게 작동합니다. 캐릭터 카드의 내용은 추상적인 시나리오, 특정 작업에 맞춰진 도우미, 유명 인사 또는 가상 인물 등 무엇이든 될 수 있습니다.
91
+
92
+ 이름 필드는 유일한 필수 캐릭터 카드 입력 항목입니다. 언어 모델과 중립적인 대화를 시작하려면 "도우미"라고 간단히 이름 지은 새 카드를 만들고 나머지 상자는 비워 두세요. 더 주제가 있는 채팅을 원한다면 언어 모델에 다양한 배경 정보, 행동 및 작문 패턴, 그리고 채팅을 바로 시작할 시나리오를 제공할 수 있습니다.
93
+
94
+ 캐릭터 카드를 선택하지 않고 빠른 대화를 하거나 LLM 연결을 테스트하려면 SillyTavern을 연 후 시작 화면의 입력 창에 프롬프트 입력을 입력하기만 하면 됩니다. 이러한 채팅은 임시적이며 저장되지 않습니다.
95
+
96
+ 캐릭터 카드를 정의하는 방법에 대한 일반적인 아이디어를 얻으려면 기본 캐릭터(Seraphina)를 보거나 "확장 프로그램 및 에셋 다운로드" 메뉴에서 선택된 커뮤니티 제작 카드를 다운로드하세요.
97
+
98
+
99
+ ## 핵심 기능
100
+
101
+ * 고급 텍스트 생성 설정과 다양한 커뮤니티 제작 프리셋
102
+ * 월드 인포 지원: 풍부한 설정을 만들거나 캐릭터 카드에 토큰 저장
103
+ * 그룹 채팅: 캐릭터가 사용자 혹은 다른 캐릭터와 대화할 수 있는 방
104
+ * 다양한 UI 커스텀 옵션: 테마 색, 뱌경 이미지, 커스텀 CSS 등
105
+ * 유저 페르소나: AI에게 사용자에 대한 정보를 주어 더욱 몰입감을 높임
106
+ * 내장 RAG 지원: AI가 참조할 수 있도록 채팅에 문서를 추가
107
+ * 광범위한 채팅 명령어 시스템 및 자체 [스크립트](https://docs.sillytavern.app/usage/st-script/)
108
+
109
+ ## 확장
110
+
111
+ SillyTavern은 확장(익스텐션)을 지원합니다.
112
+
113
+ * 캐릭터 감정 표현 (스프라이트)
114
+ * 채팅 기록 자동 요약
115
+ * 자동 UI 및 채팅 번역
116
+ * Stable Diffusion/FLUX/DALL-E 이미지 생성
117
+ * AI 응답 메시지 텍스트 음성 변환 (ElevenLabs, Silero 또는 OS 시스템 TTS 사용)
118
+ * 프롬프트에 추가적인 현실 세계 맥락을 추가하기 위한 웹 검색 기능
119
+ * "확장 프로그램 및 에셋 다운로드" 메뉴에서 더 많은 기능을 다운로드할 수 있습니다.
120
+
121
+
122
+ 사용 방법에 대한 튜토리얼은 [Docs](https://docs.sillytavern.app/)에서 확인할 수 있습니다.
123
+
124
+ # ⌛ Installation
125
+
126
+ > \[!WARNING]
127
+ >
128
+ > * **윈도우 제어 폴더에는 설치하지 마십시오 (Program Files, System32 등).**
129
+ > * **권리자 권한으로 START.BAT을 실행하지 마십시오.**
130
+ > * **Windows 7에서는 NodeJS 18.16을 실행할 수 없으므로 설치가 불가능합니다.**
131
+
132
+ ## 🪟 Windows
133
+
134
+ ### Git을 통해 설치하기
135
+
136
+ 1. [NodeJS](https://nodejs.org/ko) 설치 (최신 LTS 버전 권장)
137
+ 2. [Git for Windows](https://gitforwindows.org/) 설치
138
+ 3. 파일 탐색기 열기 (`Win+E`)
139
+ 4. Windows에서 제어하거나 모니터하지 않는 폴더를 찾거나 만드세요. (ex: C:\MySpecialFolder\)
140
+ 5. 상단의 주소 표시줄을 클릭하고 `cmd`를 입력한 후 Enter 키를 눌러 해당 폴더 내에서 명령 프롬프트를 여세요.
141
+ 6. 검은색 창(명령 프롬프트)이 나타나면 다음 중 하나를 입력하고 Enter 키를 누르세요.
142
+
143
+ * Release 브랜치: `git clone https://github.com/SillyTavern/SillyTavern -b release`
144
+ * Staging 브랜치: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
145
+
146
+ 7. clone이 완료되면, `Start.bat`을 더블 클릭하여 NodeJS가 필요한 구성요소를 설치하도록 하세요.
147
+ 8. 그러면 서버가 시작하고, SillyTavern이 브라우저에 나타납니다.
148
+
149
+ ### GitHub Desktop을 통해 설치하기
150
+
151
+ (이 방법은 **오직** GitHub Desktop에서만 git 사용이 가능합니다. 명령 프롬프트에서 git을 사용하려면 [Git for Windows](https://gitforwindows.org/)를 설치해야 합니다.)
152
+
153
+
154
+
155
+ 1. [NodeJS](https://nodejs.org/ko) 설치 (최신 LTS 버전 권장)
156
+ 2. [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32) 설치
157
+ 3. GitHub Desktop을 설치했으면, `Clone a repository from the internet....`를 클릭하세요. (참고: 이 과정에서는 Github 계정이 **필요하지 않습니다**.)
158
+ 4. 메뉴에서 URL 탭을 클릭하고, 다음 URL을 입력한 후 복제를 클릭합니다: `https://github.com/SillyTavern/SillyTavern` 리포지토리가 다운로드될 위치를 변경하려면 로컬 경로를 변경할 수 있습니다.
159
+ 5. SillyTavern을 열려면 파일 탐색기를 사용하여 리포지토리를 복제한 폴더로 이동합니다. 기본적으로 리포지토리는 다음 위치에 복제됩니다: `C:\Users\[사용자 Windows 사용자 이름]\Documents\GitHub\SillyTavern`
160
+ 6. `start.bat` 파일을 더블 클릭 하세요. (참고: `.bat` 확장자 명은 OS 설정에 따라 보이지 않을 수 있습니다, 그럴 때는 파일 이름이 "`Start`" 처럼 보일 수 있습니다. 이 파일을 더블 클릭해 SillyTavern을 실행하세요.)
161
+ 7. 더블 클릭하면, 검고 큰 명령 프롬프트 창이 열리고 SillyTavern이 작동하는데 필요한 항목을 설치하기 시작합니다.
162
+ 8. 설치 과정이 끝나고 모든 것이 잘 작동한다면, 브라우저에 SillyTavern 탭이 열려 있어야 하고, 명령 프롬프트 창에 다음과 같이 표시되어야 합니다:
163
+ 9. Connect to any of the [supported APIs](https://docs.sillytavern.app/usage/api-connections/) and start chatting!
164
+
165
+ ## 🐧 Linux & 🍎 MacOS
166
+
167
+ MacOS / Linux 에서는 이 모든 작업이 터미널에서 수행됩니다.
168
+
169
+ 1. git과 nodeJS 설치 (이 작업은 OS에 따라 달라집니다.)
170
+ 2. 리포지토리 clone하기
171
+
172
+ * Release 브랜치: `git clone https://github.com/SillyTavern/SillyTavern -b release`
173
+ * Staging 브랜치: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
174
+
175
+ 3. `cd SillyTavern` 를 입력해 설치 폴더로 이동하기
176
+ 4. `start.sh` 스크립트를 아래의 명령어 중 하나로 실행하기:
177
+
178
+ * `./start.sh`
179
+ * `bash start.sh`
180
+
181
+ ## ⚡ SillyTavern Launcher를 통해 설치하기
182
+
183
+ SillyTavern 런처는 로컬 LLM 사용을 위한 백엔드 설치를 포함하여 다양한 설정을 도와주는 설치 마법사입니다.
184
+
185
+
186
+ ### Windows 사용자
187
+
188
+ 1. 키보드에서 **`WINDOWS + R`** 키를 눌러 실행 창을 여세요. 그리고 아래의 명령어를 입력해 git을 설치하세요.
189
+
190
+ ```shell
191
+ cmd /c winget install -e --id Git.Git
192
+ ```
193
+
194
+ 2. 키보드에서 **`WINDOWS + E`** 키를 눌러 파일 탐색기를 열고 런처를 설치할 폴더로 이동합니다. 원하는 폴더에 도착하면 주소 표시줄에 `cmd`를 입력하고 Enter 키를 누릅니다. 그 후 아래의 명령어를 입력합니다.
195
+
196
+
197
+ ```shell
198
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
199
+ ```
200
+
201
+ ### Linux 사용자
202
+
203
+ 1. 선호하는 터미널을 열고 git을 설치하세요.
204
+ 2. SillyTavern-Launcher를 clone 하세요:
205
+
206
+ ```shell
207
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
208
+ ```
209
+
210
+ 3. installer.sh를 실행하세요:
211
+
212
+ ```shell
213
+ chmod +x install.sh && ./install.sh
214
+ ```
215
+
216
+ 4. 설치가 끝나면 launcher.sh를 실행하세요:
217
+
218
+ ```shell
219
+ chmod +x launcher.sh && ./launcher.sh
220
+ ```
221
+
222
+ ### Mac 사용자
223
+
224
+ 1. 터미널을 열고 Brew를 설치하세요:
225
+
226
+ ```shell
227
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
228
+ ```
229
+
230
+ 2. git을 설치하세요:
231
+
232
+ ```shell
233
+ brew install git
234
+ ```
235
+
236
+ 3. SillyTavern-Launcher를 clone 하세요:
237
+
238
+ ```shell
239
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
240
+ ```
241
+
242
+ 4. installer.sh를 실행하세요:
243
+
244
+ ```shell
245
+ chmod +x install.sh && ./install.sh
246
+ ```
247
+
248
+ 5. 설치가 끝나면 launcher.sh를 실행하세요:
249
+
250
+ ```shell
251
+ chmod +x launcher.sh && ./launcher.sh
252
+ ```
253
+
254
+ ## 🐋 Docker를 통해 설치하기
255
+
256
+ 이 방법은 Docker가 설치되어 있고, Docker 설치를 위해 커맨드 라인에 접근할 수 있으며, Docker의 일반적인 작동 방식에 익숙하다고 가정합니다.
257
+
258
+ ### 이미지 직접 빌드하기
259
+
260
+ SillyTavern을 Docker에서 사용���는 방법에 대한 포괄적인 가이드는 [여기서](http://docs.sillytavern.app/installation/docker/) 확인할 수 있습니다. 이 가이드는 Windows, macOS 및 Linux에서의 설치를 다룹니다! 직접 이미지를 빌드하려면 이 가이드를 읽어보세요.
261
+
262
+ ### GitHub Container Registry 사용하기 (가장 쉬움)
263
+
264
+ SillyTavern이 작동하려면 두 개의 필수 디렉터리 매핑과 하나의 포트 매핑이 필요합니다. 명령에서 다음 위치의 선택 항목을 바꿔주세요.
265
+
266
+
267
+ #### Container Variables
268
+
269
+ ##### Volume Mappings
270
+
271
+ * [config] - SillyTavern 구성 파일이 호스트 컴퓨터에 저장될 디렉터리
272
+ * [data] - 캐릭터를 포함한 SillyTavern 사용자 데이터가 호스트 컴퓨터에 저장될 디렉터리
273
+ * [plugins] - (선택 사항) SillyTavern 서버 플러그인이 호스트 컴퓨터에 저장될 디렉터리
274
+
275
+ ##### Port Mappings
276
+
277
+ * [PublicPort] - 트래픽을 노출할 포트입니다. 가상 머신 컨테이너 외부에서 인스턴스에 접근하므로 필수 사항입니다. 보안을 위한 별도의 서비스를 구현하지 않고는 인터넷에 노출하지 마십시오.
278
+
279
+
280
+ ##### Additional Settings
281
+
282
+ * [DockerNet] - 컨테이너가 연결되어 생성되어야 하는 Docker 네트워크입니다. 해당 내용을 모르는 경우 [공식 Docker 문서](https://docs.docker.com/reference/cli/docker/network/)를 참조하세요.
283
+ * [version] - 이 GitHub 페이지의 오른쪽에서 "Packages"를 선택하면 "sillytavern" 패키지를 볼 수 있습니다. "latest" 이미지 태그는 현재 릴리스와 함께 최신 상태를 유지합니다. 각 브랜치의 야간 이미지를 가리키는 "staging" 및 "release" 태그를 사용할 수도 있지만, 업데이트에 시간이 걸릴 수 있고 중단될 수 있는 확장 프로그램을 사용하는 경우에는 적합하지 않을 수 있습니다.
284
+
285
+
286
+ #### 설치 명령어
287
+
288
+ 1. 커맨드 라인 열기
289
+ 2. 아래의 명령어 실행
290
+
291
+ `docker create --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
292
+
293
+ > 8000은 기본 리스닝 포트입니다. 구성에서 포트를 변경한 경우 적절한 포트를 사용하는 것을 잊지 마세요.
294
+ ## 📱 Termux를 통해 Android OS에 설치하기
295
+
296
+ > \[!NOTE]
297
+ > **SillyTavern은 Termux를 사용하여 Android 기기에서 기본적으로 실행할 수 있지만, 이러한 사용 사례에 대한 공식적인 지원은 제공하지 않습니다.**
298
+ >
299
+ > **ArroganceComplex#2659의 가이드를 참조하세요:**
300
+ >
301
+ > * <https://rentry.org/STAI-Termux>
302
+
303
+ **지원되지 않는 플랫폼: android arm LEtime-web.** 32비트 Android는 npm으로 설치할 수 없는 외부 종속성이 필요합니다. 다음 명령어를 사용하여 설치하세요: pkg install esbuild. 그런 다음 일반적인 설치 단계를 진행하세요.
304
+
305
+
306
+ ## API 키 관리
307
+
308
+ SillyTavern은 API 키를 사용자 데이터 디렉터리의 `secrets.json` 파일에 저장합니다 (`/data/default-user/secrets.json`이 기본 경로입니다).
309
+
310
+
311
+
312
+ 기본적으로 API 키는 저장하고 페이지를 새로 고침한 후에는 인터페이스에서 보이지 않습니다.
313
+
314
+ 키 보기 기능을 활성화하려면 다음 단계를 따르세요:
315
+
316
+ 1. `config.yaml` 파일에서 `allowKeysExposure` 값을 `true로` 설정합니다.
317
+ 2. SillyTavern 서버를 다시 시작합니다.
318
+ 3. API 연결 패널 오른쪽 하단에 있는 '숨겨진 API 키 보기' 링크를 클릭합니다.
319
+
320
+ ## 커맨드 라인 인수
321
+
322
+ `config.yaml`의 일부 설정을 덮어쓰기 위해 SillyTavern 서버 시작 시 커맨드 라인 인수를 전달할 수 있습니다.
323
+
324
+
325
+ ### 예시
326
+
327
+ ```shell
328
+ node server.js --port 8000 --listen false
329
+ # 혹은
330
+ npm run start -- --port 8000 --listen false
331
+ # 혹은 (Windows 전용)
332
+ Start.bat --port 8000 --listen false
333
+ ```
334
+
335
+ ### 지원되는 인수
336
+
337
+ | 옵션 | 설명 | 타입 |
338
+ |-------------------------|------------------------------------------------------------------------------------------------------|----------|
339
+ | `--version` | 버전 표시 | boolean |
340
+ | `--enableIPv6` | IPv6 활성화 | boolean |
341
+ | `--enableIPv4` | IPv4 활성화 | boolean |
342
+ | `--port` | SillyTavern이 실행될 포트를 설정합니다. 설정되지 않은 경우 yaml config 'port'를 불러옵니다. | number |
343
+ | `--dnsPreferIPv6` | DNS에 IPv6를 우선으로 할당합니다. 설정되지 않은 경우 yaml config�� 불러옵니다. | boolean |
344
+ | `--autorun` | 브라우저에서 SillyTavern을 자동으로 실행합니다. 설정되지 않은 경우 yaml config 'autorun'를 불러옵니다. | boolean |
345
+ | `--autorunHostname` | 자동 실행 호스트 이름, 'auto'가 최적의 설정일 것입니다. | string |
346
+ | `--autorunPortOverride` | 자동 실행 포트 덮어쓰기 | string |
347
+ | `--listen` | SillyTavern이 모든 네트워크 인터페이스에서 수신 대기합니다. 설정되지 않은 경우 yaml 구성 'listen'을 불러옵니다. | boolean |
348
+ | `--corsProxy` | CORS 프록시 활성화. 설정되지 않은 경우 yaml 구성 'enableCorsProxy'을 불러옵니다. | boolean |
349
+ | `--disableCsrf` | CSRF 보호 비활성화 | boolean |
350
+ | `--ssl` | SSL 활성화 | boolean |
351
+ | `--certPath` | 인증서 파일 경로 | string |
352
+ | `--keyPath` | 프라이빗 키 파일 경로 | string |
353
+ | `--whitelist` | 화이트리스트 모드 활성화 | boolean |
354
+ | `--dataRoot` | 데이터 스토리지의 루트 디렉토리 | string |
355
+ | `--avoidLocalhost` | 자동 모드에서 자동 실행 시 'localhost' 사용 방지 | boolean |
356
+ | `--basicAuthMode` | 기본 인증 활성화 | boolean |
357
+ | `--requestProxyEnabled` | 외부 리퀘스트 프록시 활성화 | boolean |
358
+ | `--requestProxyUrl` | 프록시 URL 리퀘스트 (HTTP 혹은 SOCKS 프로토콜) | string |
359
+ | `--requestProxyBypass` | 프록시 바이패스 리스트 리퀘스트 (공백으로 구분된 호스트 목록) | array |
360
+
361
+ ## 원격 연결
362
+
363
+ 대부분의 경우 이는 PC에서 ST 서버를 실행하는 동안 모바일 장치에서 SillyTavern을 사용하려는 사람들을 위한 것입니다. 그러나 원격 연결을 다른 곳에서도 허용하도록 사용할 수 있습니다.
364
+
365
+ 원격 연결 설정 방법에 대한 자세한 가이드는 [Docs](https://docs.sillytavern.app/usage/remoteconnections/)에서 확인할 수 있습니다.
366
+
367
+ 또한 암호 보호 기능이 포함된 SillyTavern 사용자 프로필을 구성할 수 있습니다 (선택 사항): [Users](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users).
368
+
369
+ ## 성능 이슈가 발생하나요?
370
+
371
+ 1. 사용자 설정 패널(UI 테마 전환 카테고리)에서 흐림 효과를 비활성화하고 동작 줄이기를 활성화합니다.
372
+ 2. 응답 스트리밍을 사용하는 경우 스트리밍 FPS를 더 낮은 값(10-15 FPS 권장)으로 설정합니다.
373
+ 3. 브라우저에서 렌더링에 GPU 가속을 사용하도록 설정되어 있는지 확인합니다.
374
+
375
+ ## 라이센스 및 크레딧
376
+
377
+ **이 프로그램은 유용할 것이라는 희망으로 배포되지만, 어떠한 보증도 제공하지 않습니다. 상품성 또는 특정 목적에의 적합성에 대한 묵시적인 보증조차도 제공하지 않습니다. 자세한 내용은 GNU Affero 일반 공중 사용 허가서를 참조하십시오.**
378
+
379
+ * Humi의 [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8: MIT 라이선스
380
+ * CncAnon의 TavernAITurbo 모드의 일부는 허가를 받아 사용됨
381
+ * PepperTaco의 작업(<https://github.com/peppertaco/Tavern/>)에 영감을 받은 비주얼 노벨 모드
382
+ * Noto Sans Font by Google (OFL 라이선스)
383
+ * Font Awesome의 아이콘 테마 <https://fontawesome.com> (아이콘: CC BY 4.0, 폰트: SIL OFL 1.1, 코드: MIT 라이선스)
384
+ * 기본 콘텐츠는 @OtisAlejandro (Seraphina 캐릭터 및 로어북)와 @kallmeflocc (10K 디스코드 사용자 축전 배경화면)가 제공함
385
+ * [@mrguymiah](https://github.com/mrguymiah)와 [@Bronya-Rand](https://github.com/Bronya-Rand)의 Docker 가이드
386
+
387
+ ## 상위 기여자
388
+
389
+ [![Contributors](https://contrib.rocks/image?repo=SillyTavern/SillyTavern)](https://github.com/SillyTavern/SillyTavern/graphs/contributors)
390
+
391
+ <!-- LINK GROUP -->
392
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
393
+ [discord-link]: https://discord.gg/sillytavern
394
+ [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge
jiuguan2025cc/.github/readme-ru_ru.md ADDED
@@ -0,0 +1,450 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > Приведенная здесь информация может быть устаревшей или неполной и предоставляется только для вашего удобства. Пожалуйста, используйте английскую версию для получения наиболее актуальной информации.
3
+
4
+ <a name="readme-top"></a>
5
+
6
+ ![][cover]
7
+
8
+ <div align="center">
9
+
10
+ [English](readme.md) | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | Русский | [한국어](readme-ko_kr.md)
11
+
12
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
13
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
14
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
15
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
16
+
17
+ </div>
18
+
19
+ ---
20
+
21
+ Мобайл-френдли интерфейс, поддержка множества API (KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale), ВН-образный режим Вайфу, Stable Diffusion, TTS, поддержка миров (лорбуков), кастомизируемый UI, автоперевод, тончайшая настройка промптов + возможность устанавливать расширения.
22
+
23
+ Основано на форке [TavernAI](https://github.com/TavernAI/TavernAI) версии 1.2.8
24
+
25
+ ## Важные новости!
26
+
27
+ 1. Чтобы помочь вам быстрее разобраться в SillyTavern, мы создали [сайт с документацией](https://docs.sillytavern.app/). Ответы на большинство вопросов можно найти там.
28
+
29
+ 2. Почему пропали расширения после апдейта? Начиная с версии 1.10.6, большинство встроенных расширений были конвертированы в формат загружаемых аддонов. Их можно установить обратно через меню "Download Extensions and Assets" на панели расширений (значок с тремя кубиками сверху).
30
+
31
+ 3. Не поддерживается следующая платформа: android arm LEtime-web. 32-битный Android требует внешнюю зависимость, которую нельзя установить посредством npm. Для её установки потребуется следующая команда: `pkg install esbuild`. После этого продолжайте установку по общей инструкции.
32
+
33
+ ### Разрабатывается Cohee, RossAscends и всем сообществом SillyTavern
34
+
35
+ ### Что такое SillyTavern и TavernAI?
36
+
37
+ SillyTavern — это интерфейс, который устанавливается на ПК (и на Android), который даёт возможность общаться с генеративным ИИ и чатиться/ролеплеить с вашими собственными персонажами или персонажами других пользователей.
38
+
39
+ SillyTavern — это форк версии TavernAI 1.2.8, который разрабатывается более активно и имеет множество новых функций. Сейчас уже можно сказать, что это две отдельные и абсолютно самостоятельные программы.
40
+
41
+ ## Скриншоты
42
+
43
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
44
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
45
+
46
+ ### Ветки
47
+
48
+ SillyTavern разрабатывается в двух ветках, чтобы всем категориям пользователей было удобно.
49
+
50
+ * release -🌟 **Рекомендовано для большинства пользователей.** Самая стабильная ветка, рекомендуем именно её. Обновляется только в момент крупных релизов. Подходит для большей части пользователей.
51
+ * staging - ⚠️ **Не рекомендуется для повседневного использования.** В этой ветке весь самый свежий и новый функционал, но будьте аккуратны, поскольку сломаться может в любом месте и в люб��е время. Только для продвинутых пользователей и энтузиастов.
52
+
53
+ Если вы не умеете обращаться с git через командную строку, или не знаете, что такое ветка, то не переживайте! Наилучшим вариантом всегда остаётся ветка release.
54
+
55
+ ### Что ещё нужно, кроме SillyTavern?
56
+
57
+ Сама по себе SillyTavern бесполезна, ведь это просто интерфейс. Вам потребуется доступ к бэкенду с ИИ, который и будет отыгрывать выбранного вами персонажа. Поддерживаются разные виды бэкендов: OpenAPI API (GPT), KoboldAI (локально или на Google Colab), и многое другое. Больше информации в [FAQ](https://docs.sillytavern.app/usage/faq/).
58
+
59
+ ### Требуется ли для SillyTavern мощный ПК?
60
+
61
+ SillyTavern — это просто интерфейс, поэтому запустить его можно на любой картошке. Мощным должен быть бэкенд с ИИ.
62
+
63
+ ## Есть вопросы или предложения?
64
+
65
+ ### У нас появился сервер в Discord
66
+
67
+ | [![][discord-shield-badge]][discord-link] | [Вступайте в наше Discord-сообщество!](https://discord.gg/sillytavern) Задавайте вопросы, делитесь любимыми персонажами и промптами. |
68
+ | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
69
+
70
+ Также можно написать разработчикам напрямую:
71
+
72
+ * Discord: cohee или rossascends
73
+ * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/) или [/u/sillylossy](https://www.reddit.com/user/sillylossy/)
74
+ * [Запостить issue на GitHub](https://github.com/SillyTavern/SillyTavern/issues)
75
+
76
+ ## Эта версия включает
77
+
78
+ * Глубоко переработанную TavernAI 1.2.8 (переписано и оптимизировано более 50% кода)
79
+ * Свайпы
80
+ * Групповые чаты: комнаты для нескольких ботов, где персонажи могут говорить друг с другом и с вами
81
+ * Чекпоинты и ветки для чатов
82
+ * Продвинутые настройки для KoboldAI / TextGen со множеством созданных сообществом пресетов
83
+ * Поддержка миров (функция "Информация о мире" / WorldInfo): создавайте свой богатый лор, или экономьте токены для карточек персонажей
84
+ * Соединение через [OpenRouter](https://openrouter.ai) для разных API (Claude, GPT-4/3.5 и других)
85
+ * Соединение с API [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui)
86
+ * Соединение с [AI Horde](https://aihorde.net/)
87
+ * Настройку форматирования промптов
88
+
89
+ ## Расширения
90
+
91
+ SillyTavern поддерживает расширения.
92
+
93
+ * Эмоции для персонажей (спрайты)
94
+ * Автоматический саммарайз (краткий пересказ) истории чата
95
+ * Возможность отправить в чат картинку, которую ИИ сможет рассмотреть и понять
96
+ * Генерация картинок в Stable Diffusion (5 пресетов для чата, плюс свободный режим)
97
+ * Text-to-speech для сообщений ИИ (с помощью ElevenLabs, Silero, или родной TTS вашей ОС)
98
+
99
+ Полный список расширений и инструкций к ним можно найти в [документации](https://docs.sillytavern.app/).
100
+
101
+ ## Улучшения от RossAscends для UI/CSS/общего удобства
102
+
103
+ * Мобильный интерфейс адаптирован для iOS, добавлена возможность сохранить ярлык на главный экран и открыть приложение в полноэкранном режиме.
104
+ * Горячие клавиши
105
+ * Up = Редактировать последнее сообщение в чате
106
+ * Ctrl+Up = Редактировать ВАШЕ последнее сообщение в чате
107
+ * Left = свайп влево
108
+ * Right = свайп вправо (ОБРАТИТЕ ВНИМАНИЕ: когда в окне ввода что-то напечатано, клавиши для свайпа не работают)
109
+ * Ctrl+Left = посмотреть локальные переменные (в консоли бр��узера)
110
+ * Enter (при нахождении внутри окна ввода) = отправить ваше сообщение ИИ
111
+ * Ctrl+Enter = Повторная генерация последнего ответа ИИ
112
+
113
+ * Страница больше не перезагружается при смене имени пользователя или удалении персонажа
114
+
115
+ * Отключаемая возможность автоматически соединяться с API при загрузке страницы.
116
+ * Отключаемая возможность автоматически загружать последнего открытого персонажа при загрузке страницы.
117
+ * Улучшенный счётчик токенов - работает с несохранёнными персонажами, отображает и перманентные, и временные токены
118
+
119
+ * Улучшенный менеджер чатов
120
+ * Файлы с новыми чатами получают читабельные названия вида "(персонаж) - (когда создано)"
121
+ * Увеличен размер превью чата с 40 символов до 300.
122
+ * Несколько вариантов сортировки списка персонажей (по имени, дате создания, размеру чата).
123
+
124
+ * Панели настроек слева и справа автоматически скрываются, если щёлкнуть за их пределы.
125
+ * При нажатии на значок замка навигационная панель будет закреплена на экране, и эта настройка сохранится между сессиями
126
+ * Сам статус панели (открыта или закрыта) также сохраняется между сессиями
127
+
128
+ * Кастомизируемый интерфейс чата:
129
+ * Настройте звук при получении нового ответа
130
+ * Переключайтесь между круглыми и прямоугольными аватарками
131
+ * Увеличенное вширь окно чата для стационарных ПК
132
+ * Возможность включать полупрозрачные панели, стилизованные под стекло
133
+ * Настраиваемые цвета для обычного текста, курсива, цитат
134
+ * Настраиваемый цвет фона и интенсивность размытия
135
+
136
+ # ⌛ Установка
137
+
138
+ > **Внимание!**
139
+ > * НЕ УСТАНАВЛИВАЙТЕ В ПАПКИ, КОТОРЫЕ КОНТРОЛИРУЕТ WINDOWS (Program Files, System32 и т.п.).
140
+ > * НЕ ЗАПУСКАЙТЕ START.BAT С ПРАВАМИ АДМИНИСТРАТОРА
141
+ > * УСТАНОВКА НА WINDOWS 7 НЕВОЗМОЖНА ИЗ-ЗА ОТСУТСТВИЯ NODEJS 18.16
142
+
143
+ ## 🪟 Windows
144
+
145
+ ## Установка через Git
146
+ 1. Установите [NodeJS](https://nodejs.org/en) (рекомендуется последняя LTS-версия)
147
+ 2. Установите [Git for Windows](https://gitforwindows.org/)
148
+ 3. Откройте Проводник (`Win+E`)
149
+ 4. Перейдите в папку, которую не контролирует Windows, или создайте её. (пример: C:\MySpecialFolder\)
150
+ 5. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter.
151
+ 6. Когда появится чёрное окошко (командная строка), введите ОДНУ из перечисленных ниже команд:
152
+
153
+ - для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release`
154
+ - для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
155
+
156
+ 7. Когда клонирование закончится, дважды щёлкните по `Start.bat`, чтобы установить зависимости для NodeJS.
157
+ 8. После этого сервер запустится, и SillyTavern откроется в вашем браузере.
158
+
159
+ ## Установка с помощью SillyTavern Launcher
160
+ 1. Установите [Git for Windows](https://gitforwindows.org/)
161
+ 2. Откройте Проводник (`Win+E`) и создайте или выберите папку, в которую будет установлен лаунчер
162
+ 3. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter.
163
+ 4. Когда появится чёрное окошко, введите следующую команду: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
164
+ 5. Дважды щёлкните по `installer.bat` и выберите, что именно хотите установить
165
+ 6. После завершения установки дважды щёлкните по `launcher.bat`
166
+
167
+ ## Установка с помощью GitHub Desktop
168
+ (Тут речь про git **только** в рамках GitHub Desktop, если хотите использовать `git` в командной строке, вам также понадобится [Git for Windows](https://gitforwindows.org/))
169
+ 1. Установите [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
170
+ 2. Установите [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
171
+ 3. После завершения установки GitHub Desktop, нажмите `Clone a repository from the internet....` (обратите внимание: для этого шага **НЕ требуется** аккаунт на GitHub)
172
+ 4. В меню перейдите на вкладку URL, введите адрес `https://github.com/SillyTavern/SillyTavern`, и нажмите Clone. В поле Local path можно изменить директорию, в которую будет загружена SillyTavern.
173
+ 6. Чтобы запустить SillyTavern, откройте Проводник и перейдите в выбранную на предыдущем шаге папку. По умолчанию репозиторий будет склонирован сюда: `C:\Users\[Имя пользователя]\Documents\GitHub\SillyTavern`
174
+ 7. Дважды щёлкните по файлу `start.bat`. (обратите внимание: окончание `.bat` может быть скрыто настройками вашей ОС. Таким образом, имя файла будет выглядеть как "`Start`". Дважды щёлкните по нему, чтобы запустить SillyTavern)
175
+ 8. После того, как вы дважды щёлкнули по файлу, должно открыться чёрное окошко, и SillyTavern начнёт устанавливать свои зависимости.
176
+ 9. Если установка прошла успешно, то в командной строке будет вот такое, а в браузере откроется вкладка с SillyTavern:
177
+ 10. Подключайтесь к любому из [поддерживаемых API](https://docs.sillytavern.app/usage/api-connections/) и начинайте переписку!
178
+
179
+ ## 🐧 Linux и 🍎 MacOS
180
+
181
+ В MacOS и Linux всё это делается через Терминал.
182
+
183
+ 1. Установите git и nodeJS (как именно - зависит от вашей ОС)
184
+ 2. Клонируйте репозиторий
185
+
186
+ - для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release`
187
+ - для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
188
+
189
+ 3. Перейдите в папку установки с помощью `cd SillyTavern`.
190
+ 4. Запустите скрипт `start.sh` с помощью одной из команд:
191
+
192
+ - `./start.sh`
193
+ - `bash start.sh`
194
+
195
+ ## Установка с помощью SillyTavern Launcher
196
+
197
+ ### Для пользователей Linux
198
+ 1. Откройте любимый терминал и установите git
199
+ 2. Загрузите Sillytavern Launcher с помощью команды: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
200
+ 3. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher`
201
+ 4. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh`, затем выберите, что конкретно хотите установить
202
+ 5. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh`
203
+
204
+ ### Для пользователей Mac
205
+ 1. Откройте терминал и установите brew: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
206
+ 2. Затем установите git: `brew install git`
207
+ 3. Загрузите Sillytavern Launcher: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
208
+ 4. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher`
209
+ 5. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh` and choose what you wanna install
210
+ 6. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh`
211
+
212
+ ## 🐋 Установка с помощью Docker
213
+
214
+ Предполагается, что вы уже установили Docker, имеете доступ к командной строке для установки контейнеров и знакомы с их базовым управлением.
215
+
216
+ ### Сборка образа самостоятельно
217
+
218
+ У нас есть подробное руководство по использованию SillyTavern в Docker [здесь](http://docs.sillytavern.app/installation/docker/), которое охватывает установку на Windows, macOS и Linux! Ознакомьтесь с ним, если хотите создать образ самостоятельно.
219
+
220
+ ### Использование реестра контейнеров GitHub (самый простой способ)
221
+
222
+ Для работы SillyTavern вам понадобятся две обязательные настройки каталогов и одна настройка порта. В команде замените указанные значения на свои:
223
+
224
+ #### Переменные контейнера
225
+
226
+ ##### Маппинг томов
227
+
228
+ * [config] - директория, где на вашем хосте будут храниться файлы конфигурации SillyTavern.
229
+ * [data] - директория, где на вашем хосте будут храниться пользовательские данные SillyTavern (включая персонажей).
230
+ * [plugins] - (необязательно) директория, где на вашем хосте будут храниться плагины сервера SillyTavern.
231
+
232
+ ##### Маппинг портов
233
+
234
+ * [PublicPort] - Порт, через который будет передаваться трафик. Это обязательно, так как вы будете обращаться к контейнеру извне его виртуальной машины. НЕ ОТКРЫВАЙТЕ этот порт в интернет без реализации дополнительного уровня безопасности.
235
+
236
+ ##### Дополнительные настройки
237
+
238
+ * [DockerNet] - Docker сеть, к которой контейнер должен быть подключен. Если вы не знаете, что это, обратитесь к [официальной документации Docker](https://docs.docker.com/reference/cli/docker/network/).
239
+ * [version] - на правой части этой страницы GitHub вы найдете раздел "Packages". Выберите пакет "sillytavern", чтобы увидеть версии образов. Тег "latest" позволит вам обновляться до текущего релиза. Также доступны теги "staging" и "release", которые соответствуют ночным сборкам соответствующих веток. Однако это может быть нецелесообразно, если вы используете расширения, которые могут ломаться и требуют времени для обновления.
240
+
241
+ #### Команда установки
242
+
243
+ 1. Откройте командную строку
244
+ 2. Выполните следующую команду
245
+
246
+ `docker create --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
247
+
248
+ > Заметьте, что 8000 является портом по умолчанию. Не забудьте использовать соответствующий порт, если вы измените его в конфиге.
249
+
250
+ ## 📱 Мобильные устройства - Установка при помощи termux
251
+
252
+ > **ОБРАТИТЕ ВНИМАНИЕ!**
253
+ >
254
+ > **На Android-телефонах SillyTavern можно запускать нативно посредством Termux. Обратитесь к гайду, написанному ArroganceComplex#2659:**
255
+ >
256
+ > * <https://rentry.org/STAI-Termux>
257
+
258
+
259
+ ## Управление ключами от API
260
+
261
+ SillyTavern сохраняет ключи от ваших API в файле `secrets.json` в папке на сервере.
262
+
263
+ По умолчанию, ключи не будут отображаться на фронте после их ввода и перезагрузки страницы.
264
+
265
+ Чтобы включить возможность отображения ключей путём нажатия кнопки в блоке API:
266
+
267
+ 1. Зайдите в файл `config.yaml` и установите `allowKeysExposure` в положение `true`.
268
+ 2. Перезапустите сервер SillyTavern.
269
+
270
+ ## Аргументы командной строки
271
+
272
+ Вы можете передавать аргументы командной строки при запуске сервера SillyTavern, чтобы переопределять настройки из `config.yaml`.
273
+
274
+ ### Примеры
275
+
276
+ ```shell
277
+ node server.js --port 8000 --listen false
278
+ # или
279
+ npm run start -- --port 8000 --listen false
280
+ # или (только на Windows)
281
+ Start.bat --port 8000 --listen false
282
+ ```
283
+
284
+ ### Поддерживаемые аргументы
285
+
286
+ | Аргумент | Описание | Тип |
287
+ |-------------------------|----------------------------------------------------------------------------------------------------------------|----------|
288
+ | `--version` | Показывает номер версии. | boolean |
289
+ | `--enableIPv6` | Включает IPv6. | boolean |
290
+ | `--enableIPv4` | Включает IPv4. | boolean |
291
+ | `--port` | Устанавливает порт, котрый будет использовать SillyTavern. Если не указан, то используется yaml-конфиг 'port'. | number |
292
+ | `--dnsPreferIPv6` | Отдает предпочтение IPv6 для dns. Если не указан, то используется yaml-конфиг 'preferIPv6'. | boolean |
293
+ | `--autorun` | Автоматический запуск SillyTavern в браузере. Если не указан, то используется yaml-конфиг 'autorun'. | boolean |
294
+ | `--autorunHostname` | Имя хоста автозапуска, лучше оставить на 'auto'. | string |
295
+ | `--autorunPortOverride` | Переопределяет порт для автозапуска. | string |
296
+ | `--listen` | SillyTavern будет прослушивать все сетевые интерфейсы. Если не указан, то используется yaml-конфиг 'listen'. | boolean |
297
+ | `--corsProxy` | Включает CORS-прокси. Если не указан, то используется yaml-конфиг 'enableCorsProxy'. | boolean |
298
+ | `--disableCsrf` | Отключает защиту от CSRF. | boolean |
299
+ | `--ssl` | Включает SSL. | boolean |
300
+ | `--certPath` | Путь к файлу c сертификатом. | string |
301
+ | `--keyPath` | Путь к файлу с закрытым ключом. | string |
302
+ | `--whitelist` | Включает режим белого списка. | boolean |
303
+ | `--dataRoot` | Корневой каталог для хранения данных. | string |
304
+ | `--avoidLocalhost` | Избегает использования 'localhost' для автозапуска в режиме 'auto'. | boolean |
305
+ | `--basicAuthMode` | Включает простую аутентификацию. | boolean |
306
+ | `--requestProxyEnabled` | Разрешает использование прокси для исходящих запросов. | boolean |
307
+ | `--requestProxyUrl` | URL-адрес прокси (протоколы HTTP или SOCKS). | string |
308
+ | `--requestProxyBypass` | Bypass список прокси (список хостов, разделенных пробелами). | array |
309
+
310
+ ## Удалённое подключение
311
+
312
+ В основном этим пользуются тогда, когда хотят использовать SillyTavern с телефона, запустив сервер SillyTavern на стационарном ПК в той же Wi-Fi-сети.
313
+
314
+ Однако это позволит подключаться откуда угодно, а не только вам.
315
+
316
+ **ВАЖНО: в SillyTavern не предусмотрена возможность использования программы несколькими людьми. Поэтому любой, кто подключится к вашему серверу, получит доступ ко всем вашим персонажам и ч��там, а также сможет менять настройки через UI.**
317
+
318
+ ### 1. Заведение "белого списка" IP-адресов
319
+
320
+ * Создайте в корневой папке SillyTavern файл с названием `whitelist.txt`.
321
+ * Откройте файл в текстовом редакторе и внесите список IP-адресов, с которых хотите разрешить подключение.
322
+
323
+ *Принимаются как обычные IP-адреса, так и целые диапазоны, размеченные с помощью астериска. Примеры:*
324
+
325
+ ```txt
326
+ 192.168.0.1
327
+ 192.168.0.20
328
+ ```
329
+
330
+ или
331
+
332
+ ```txt
333
+ 192.168.0.*
334
+ ```
335
+
336
+ (диапазон из примера сверху позволит подключаться всем устройствам в локальной сети)
337
+
338
+ Также принимаются маски CIDR (вида 10.0.0.0/24).
339
+
340
+ * Сохраните файл `whitelist.txt`.
341
+ * Перезапустите сервер ST.
342
+
343
+ После этого устройства из белого списка смогут подключаться к вашему серверу.
344
+
345
+ *Обратите внимание: в файле `config.yaml` также имеется массив `whitelist`, который работает по тому же принципу. Однако если существует файл `whitelist.txt`, то этот массив игнорируется.*
346
+
347
+ ### 2. Получение IP хост-машины с ST
348
+
349
+ После настройки белого списка адресов, следующим шагом будет получение IP-адреса хост-машины, на которой запущена SillyTavern.
350
+
351
+ Если хост-машина находится в той же Wi-Fi-сети, то можно воспользоваться её внутренним Wi-Fi-IP-адресом:
352
+
353
+ * На Windows: нажмите Пуск > введите `cmd.exe` в поиске > в консоли введите команду `ipconfig` и нажмите Enter > найдите пункт `IPv4-адрес`.
354
+
355
+ Если вы (или кто-то другой) хотите подключаться к хост-машине из другой сети, то вам понадобится ваш публичный IP-адрес.
356
+
357
+ * Откройте [эту страницу](https://whatismyipaddress.com/) с вашей хост-машины и найдите пункт `IPv4`. На этот адрес и будет подключаться удалённое устройство.
358
+
359
+ ### 3. Соединить удалённое устройство с хост-машиной ST
360
+
361
+ Какой бы IP-адрес вы ни выбрали, вам нужно будет вводить его в адресной строке браузера вашего удалённого устройства.
362
+
363
+ Обычный адрес хост-машины, находящейся в той же Wi-Fi-сети, выглядит примерно так:
364
+
365
+ `http://192.168.0.5:8000`
366
+
367
+ НЕ используйте https://
368
+ Только http://
369
+
370
+ ### Открытие доступа до ST для всех IP-адресов
371
+
372
+ Мы не рекомендуем так делать, но вы можете открыть файл `config.yaml` и изменить `whitelistMode` на `false`.
373
+
374
+ Обязательно нужно удалить (или переименовать) файл `whitelist.txt`, если такой файл есть в корневой директории SillyTavern.
375
+
376
+ Эта практика считается небезопасной, поэтому, если вы решите так сделать, мы попросим вас установить логин и пароль.
377
+
378
+ Оба этих параметра настраиваются в `config.yaml` (username и password).
379
+
380
+ Останется только перезапустить сервер ST, и после этого к вам сможет подключиться любой пользователь вне зависимости от IP-адреса его устройства. Главное, чтобы он знал логин и пароль.
381
+
382
+ ### Не получается соединиться?
383
+
384
+ * Создайте входящее/исходящее правило в вашем фаерволле для порта, указанного в `config.yaml`. НЕ ПУТАЙТЕ этот процесс с пробросом портов на роутере. Если по ошибке перепутаете, то на ваш сервер сможет забраться посторонний человек и украсть ваши логи, этого следует избегать.
385
+ * Переключите Сетевой профиль на значение "Частные". Для этого зайдите в Параметры > Сеть и Интернет > Ethernet. КРАЙНЕ важно для Windows 11, без этого не получится подключиться даже с правилом фаервола.
386
+
387
+ ## Проблемы с производительностью?
388
+
389
+ Попробуйте включить опцию "Отключить эффект размытия" в меню "Пользовательские настройки".
390
+
391
+ ## Нравится ваш проект! Как помочь?
392
+
393
+ ### ЧТО ДЕЛАТЬ
394
+
395
+ 1. Присылайте пулл реквесты
396
+ 2. Присылайте идеи и баг-репорты, оформленные по установленным шаблонам
397
+ 3. Прежде чем задавать вопросы, прочтите readme и документацию
398
+
399
+ ### ЧЕГО НЕ ДЕЛАТЬ
400
+
401
+ 1. Предлагать донаты
402
+ 2. Присылать баг-репорты безо всякого контекста
403
+ 3. Задавать вопросы, на которые уже отвечали
404
+
405
+ ## Где найти старые фоны?
406
+
407
+ Мы двигаемся в сторону 100% уникальности всего используемого контента, поэтому старые фоны были убраны из репозитория.
408
+
409
+ Они отправлены в архив, скачать их можно здесь:
410
+
411
+ <https://files.catbox.moe/1xevnc.zip>
412
+
413
+
414
+
415
+
416
+ ## Авторы и лицензии
417
+
418
+ **Мы надеемся, что эта программа принесёт людям пользу,
419
+ но мы не даём НИКАКИХ ГАРАНТИЙ; мы ни в коем случае не гарантируем того,
420
+ что программа СООТВЕТСТВУЕТ КАКИМ-ЛИБО КРИТЕРИЯМ или ПРИГОДНА ДЛЯ КАКОЙ-ЛИБО ЦЕЛИ.
421
+ Подробнее можно узнать в GNU Affero General Public License.**
422
+
423
+ * Базовая TAI от Humi: Лицензия неизвестна
424
+ * Модификации от Cohee и производная кодовая база: AGPL v3
425
+ * Дополнения RossAscends: AGPL v3
426
+ * Кусочки TavernAITurbo мода от CncAnon: Лицензия неизвестна
427
+ * Различные коммиты и предложения от kingbri (<https://github.com/bdashore3>)
428
+ * Расширения и внедрение разного рода удобств - city_unit (<https://github.com/city-unit>)
429
+ * Различные коммиты и баг-репорты от StefanDanielSchwarz (<https://github.com/StefanDanielSchwarz>)
430
+ * Режим Вайфу вдохновлён работой PepperTaco (<https://github.com/peppertaco/Tavern/>)
431
+ * Благодарность Pygmalion University за прекрасную работу по тестированию и за все предлагаемые крутые фичи!
432
+ * Благодарность oobabooga за компиляцию пресетов для TextGen
433
+ * Пресеты для KoboldAI из KAI Lite: <https://lite.koboldai.net/>
434
+ * Шрифт Noto Sans от Google (OFL license)
435
+ * Тема Font Awesome <https://fontawesome.com> (Иконки: CC BY 4.0, Шрифты: SIL OFL 1.1, Код: MIT License)
436
+ * Клиентская библиотека для AI Horde от ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde>
437
+ * Пусковой скрипт для Linux от AlpinDale
438
+ * Благодарность paniphons за оформление документа с FAQ
439
+ * Фон в честь 10 тысяч пользователей в Discord от @kallmeflocc
440
+ * Стандартный контент (персонажи и лорбуки) предоставлен пользователями @OtisAlejandro, @RossAscends и @kallmeflocc
441
+ * Корейский перевод от @doloroushyeonse
442
+ * Поддержка k_euler_a для Horde от <https://github.com/Teashrock>
443
+ * Китайский перевод от [@XXpE3](https://github.com/XXpE3), 中文 ISSUES 可以联系 @XXpE3
444
+
445
+ <!-- LINK GROUP -->
446
+ [back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square
447
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
448
+ [discord-link]: https://discord.gg/sillytavern
449
+ [discord-shield]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square
450
+ [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge
jiuguan2025cc/.github/readme-zh_cn.md ADDED
@@ -0,0 +1,322 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > 这里的信息可能已经过时或不完整,仅供您参考。请使用英文版本获取最新信息。
3
+
4
+ ![][cover]
5
+
6
+ <div align="center">
7
+
8
+ [English](readme.md) | [German](readme-de_de.md) | 中文 | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
9
+
10
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
11
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
12
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
13
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
14
+
15
+ </div>
16
+
17
+ ---
18
+
19
+ 移动设备界面友好,多种人工智能服务或模型支持(KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale),类似 Galgame 的 老 婆 模 式,Horde SD,文本系统语音生成,世界信息(Lorebooks),可定制的界面,自动翻译,和比你所需要的更多的 Prompt。附带扩展服务,支持文本绘画生成与语音生成和基于向量数据库 的聊天信息总结。
20
+
21
+ 基于 TavernAI 1.2.8 的分叉版本
22
+
23
+ ### 由 Cohee、RossAscends 和 SillyTavern 社区为您呈现
24
+
25
+ 注意:我们创建了一个 [帮助文档](https://docs.sillytavern.app/) 网站来回答各类问题与帮助您开始使用。
26
+
27
+ ### SillyTavern 或 TavernAI 是什么?
28
+
29
+ SillyTavern 是一个可以安装在电脑(和安卓手机)上的用户界面,让您可以与文本生成的人工智能互动,并与您或社区创建的角色聊天/玩角色扮演游戏。
30
+
31
+ SillyTavern 是 TavernAI 1.2.8 的一个分支,正在进行更积极地开发,并添加了许多重要功能。在这一点上,它可以被视为完全独立的程序。
32
+
33
+ ### 分支
34
+
35
+ SillyTavern 采用双分支进行开发,以确保所有用户都能获得流畅的使用体验。
36
+
37
+ * release -🌟 **推荐给大多数用户。** 这是最稳定、最推荐的分支,只有在重大版本推送时才会更新。适合大多数用户使用。
38
+ * staging - ⚠️ **不建议随意使用。** 该分支拥有最新功能,但要谨慎,因为它随时可能崩溃。仅适用于高级用户和爱好者。
39
+
40
+ 如果你不熟悉使用 Git 命令,或者不了解什么是分支,别担心!release 分支始终是您的首选。
41
+
42
+ ### 除了 SillyTavern,我还需要什么?
43
+
44
+ SillyTavern 本身并无用处,因为它只是一个用户聊天界面。你必须接入一个能充当角色扮演的人工智能系统。支持的人工智能系统有多种:OpenAPI API (GPT)、KoboldAI(可在本地或 Google Colab 上运行)等。您可以在 [常见问题](https://docs.sillytavern.app/usage/faq/) 中阅读更多相关信息。
45
+
46
+ ### 我需要一台性能强大的电脑来运行 SillyTavern 吗?
47
+
48
+ 由于 SillyTavern 只是一个用户聊天界面,它对硬件性能的要求很低,可以在任何电脑上运行。需要强大性能的是人工智能系统。
49
+
50
+ ### 移动设备支持
51
+
52
+ > 注意
53
+
54
+ > **此分叉可使用 Termux 在安卓手机上原生运行。请参考 ArroganceComplex#2659 编写的指南:**
55
+
56
+ <https://rentry.org/STAI-Termux>
57
+
58
+ ## 有问题或建议?
59
+
60
+ ### 我们现在有了 Discord 社区
61
+
62
+ 获取支持,或分享喜爱的角色和 Prompt:
63
+
64
+ ### [加入 Discord 社区](https://discord.gg/sillytavern)
65
+
66
+ ***
67
+
68
+ 直接与开发人员联系:
69
+
70
+ * Discord: cohee 或 rossascends
71
+ * Reddit:/u/RossAscends 或 /u/sillylossy
72
+ * [发布 GitHub 问题](https://github.com/SillyTavern/SillyTavern/issues)
73
+
74
+ ## 此版本包括
75
+
76
+ * 经过大量修改的 TavernAI 1.2.8(超过 50% 的代码经过重写或优化)
77
+ * 根据自定义规则自动重新生成消息
78
+ * 群聊:多机器人房间,供角色与你或彼此交谈
79
+ * 聊天书签/分支(复制当前状态下的对话)
80
+ * 先进的 KoboldAI / TextGen 生成设置,包含大量社区预设
81
+ * 支持世界信息(Lorebooks):创建丰富的传说
82
+ * 支持 Window AI 浏览器扩展(运行 Claude、GPT 4 等模型):<https://windowai.io/>
83
+ * [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) API 连接
84
+ * 连接 [AI Horde](https://aihorde.net/)
85
+ * Prompt 生成格式调整
86
+ * Webp 角色卡支持(PNG 仍是内部格式)
87
+
88
+ ## 扩展
89
+
90
+ SillyTavern 支持扩展服务。
91
+
92
+ * 角色情绪识别
93
+ * 聊天记录自动摘要
94
+ * 在聊天窗口发送图片,并由人工智能解释图片内容
95
+ * 文本图像生成(5 预设,以及 "自由模式")
96
+ * 聊天信息的文字转语音(通过 ElevenLabs、Silero 或操作系统的语音生成)
97
+
98
+ 扩展服务的完整功能介绍和使用教程,请参阅 [Docs](https://docs.sillytavern.app/)。
99
+
100
+ ## 界面/CSS/性能,由 RossAscends 调整并优化
101
+
102
+ * 针对 iOS 系统优化了界面,并支持将快捷方式保存到主屏幕,在全屏模式下打开。
103
+ * 热键
104
+ * 上 = 编辑聊天中的最后一条信息
105
+ * Ctrl+P = 编辑聊天中最后一条用户信息
106
+ * 左 = 向左滑动
107
+ * 右 = 向右滑动(注意:当聊天窗口输入内容时,轻扫快捷键将被禁用)
108
+ * Ctrl+左 = 查看本地存储的变量(在浏览器控制台窗口中)
109
+ * 回车(选择聊天栏)= 向人工智能发送信息
110
+ * Ctrl+Enter = 重新生成人工智能最后的回复
111
+
112
+ * 用户名更改和角色删除不再强制重新刷新页面。
113
+
114
+ * 增加在页面加载时自动连接 API 的选项。
115
+ * 增加选项,在页面加载时自动加载最近的聊天信息。
116
+ * 更好的 Tokens 计算器 - 适用于未保存的文字,并显示永久和临时 Tokens 数量
117
+
118
+ * 更好的聊天历史查询窗口
119
+ * 聊天的文件名以"(角色卡名称)+(创建时间)"的可读格式保存
120
+ * 聊天历史预览从 40 个字符增加到 300 个字符。
121
+ * 聊天历史排序有多种选择(按名称、创建日期、聊天记录大小)。
122
+
123
+ * 默认情况下,左侧和右侧弹出的设置面板会在点击其他区域时自动关闭。
124
+ * 点击导航面板上的 "锁按钮" 将保持弹出面板打开,并在不同聊天中记住此设置。
125
+ * 导航面板的打开或关闭状态也会跨聊天保存。
126
+
127
+ * 自定义聊天界面:
128
+ * 收到新消息时播放提示音
129
+ * 切换圆形或长方形头像样式
130
+ * 在台式电脑上拥有更宽的聊天窗口
131
+ * 可选的半透明玻璃效果聊天窗口
132
+ * 可定制 "主文本"、"引用文本 "和 "斜体文本 "的字体颜色。
133
+ * 可定制聊天界面的背景颜色和透明模糊程度
134
+
135
+ ## 安装
136
+
137
+ *注意:SillyTavern 用于本地安装,尚未在 Colab 或其他云服务上进行全面测试。
138
+
139
+ > **警告**
140
+
141
+ > 切勿安装到任何受 Windows 控制的系统文件夹(Program Files, System32, etc)中。
142
+
143
+ > 不要以管理员权限运行 start.bat
144
+
145
+ ### Windows
146
+
147
+ 通过 Git 安装(推荐使用,便于更新)
148
+
149
+ 附有精美图片示例的简易指南:
150
+ <https://docs.sillytavern.app/installation/windows/>
151
+
152
+ 1. 安装 [NodeJS](https://nodejs.org/en)(建议使用最新的 LTS 版本)
153
+ 2. 安装 [GitHub 客户端](https://central.github.com/deployments/desktop/desktop/latest/win32)
154
+ 3. 打开 Windows 资源管理器 (`Win+E`)
155
+ 4. 浏览或创建一个不受 Windows 控制或监控的文件夹。(例如:C:\MySpecialFolder\)
156
+ 5. 点击顶部的 "地址栏",在该文件夹内打开命令提示符,输入 `cmd`,然后按回车。
157
+ 6. 弹出黑框(CMD 命令提示符)后,键入以下其中一项并按 Enter:
158
+
159
+ * 稳定分支:`git clone https://github.com/SillyTavern/SillyTavern -b release`
160
+ * 开发分支: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
161
+
162
+ 7. 等待 Git 克隆完成后,双击文件夹中的 `Start.bat` 将启动 NodeJS 并开始自动安装需要的软件包。
163
+ 8. 然后 SillyTavern 服务就会自动启动,同时在浏览器新标签页中自动打开。
164
+
165
+ 通过压缩包下载安装(不推荐)
166
+
167
+ 1. 安装 [NodeJS](https://nodejs.org/en)(建议使用最新的 LTS 版本)
168
+ 2. 从该 GitHub 仓库下载压缩包。(从 [Releases](https://github.com/SillyTavern/SillyTavern/releases/latest) 获取 "Source code(zip)")。
169
+ 3. 将压缩包解压到您选择的文件夹中
170
+ 4. 双击或在命令行中运行 `Start.bat`。
171
+ 5. SillyTavern 服务自动为你准备好一切后,会在你的浏览器中打开一个新标签页。
172
+
173
+ ### Linux
174
+
175
+ 1.运行 `start.sh` 脚本。
176
+ 2.等待自动完成,然后开始享受
177
+
178
+ ## API 密钥管理
179
+
180
+ SillyTavern 会将 API 密钥保存在目录中的 `secrets.json` 文件内。
181
+
182
+ 默认情况下,输入密钥并重新加载页面后,密钥会自动隐藏以保证安全。
183
+
184
+ 如果要想通过点击 API 输入框旁边的按钮来查看密钥,请按照以下设置:
185
+
186
+ 1. 打开 `config.yaml` 文件,将里面的 `allowKeysExposure` 设置为 `true`。
187
+ 2. 然后重启 SillyTavern 服务。
188
+
189
+ ## 远程访问
190
+
191
+ 这通常是为那些想在手机上使用 SillyTavern 的人准备的,而他们的电脑和手机在同一个局域网中。
192
+
193
+ 不过,SillyTavern 也可以被设置为允许从任何地方进行远程访问。
194
+
195
+ **重要提示:SillyTavern 是单用户程序,因此任何人登录后都能看到所有的角色卡和聊天内容,并能更改任何设置。
196
+
197
+ ### 1.管理白名单 IP
198
+
199
+ * 在你的 SillyTavern 文件夹中新建一个文本文件,名为 `whitelist.txt`。
200
+ * 用文本编辑器打开该文件,添加你希望允许连接的 IP 地址列表。
201
+ * 接受单个 IP 地址和 IP 范围,示例:
202
+
203
+ ```
204
+ 192.168.0.1
205
+ 192.168.0.20
206
+ ```
207
+
208
+ 或者
209
+
210
+ ```
211
+ 192.168.0.*
212
+ ```
213
+
214
+ (上述 IP 范围将允许局域网中的任何设备连接)
215
+
216
+ 也接受子网掩码设置(如 10.0.0.0/24)。
217
+
218
+ * 保存`whitelist.txt`文件。
219
+ * 重启 SillyTavern 服务。
220
+
221
+ 然后,文件中设置的 IP 就可以访�� SillyTavern 了。
222
+
223
+ *注意:"config.yaml" 文件内也有一个 "whitelist" 设置,你可以用同样的方法设置它,但如果 "whitelist.txt" 文件存在,这个设置将被忽略。
224
+
225
+ ### 2.获取 SillyTavern 服务的 IP 地址
226
+
227
+ 白名单设置完成后,您需要 SillyTavern 服务的 IP 地址。
228
+
229
+ 如果 SillyTavern 服务设备在同一个局域网上,则使用安装 SillyTavern 服务的电脑的局域网 IP 地址:
230
+
231
+ * Windows:Windows 按钮 > 在搜索栏中输入 `cmd.exe` > 在打开的控制台中输入 `ipconfig`,回车 > 然后在输出中查找 `IPv4` 地址。
232
+
233
+ 如果您(或其他人)想在互联网中访问你自己的 SillyTavern 服务,则需要运行 SillyTavern 服务的设备的互联网 IP 地址。
234
+
235
+ * 使用运行 SillyTavern 的设备,访问 [this page](https://whatismyipaddress.com/) 并查找 `IPv4`。这是您从互联网访问时要用到的。
236
+
237
+ ### 3. 使用其他设备访问 SillyTavern 服务
238
+
239
+ 无论你最终使用的是什么 IP 地址,都要将该 IP 地址和端口号输入其他设备网络浏览器。
240
+
241
+ 同一局域网中的 SillyTavern 服务的典型默认地址如下:
242
+
243
+ `http://192.168.0.5:8000`
244
+
245
+ 使用 http:// 而不是 https://
246
+
247
+ ### 向所有 IP 开放您的 SillyTavern 服务
248
+
249
+ 我们不建议这样做,但您可以打开 `config.yaml` 并将里面的 `whitelistMode` 设置改为 `false`。
250
+
251
+ 你必须删除(或重命名)SillyTavern 文件夹中的 `whitelist.txt` 文件(如果有的话)。
252
+
253
+ 这通常是不安全的做法,所以我们要求在这样做时必须设置用户名和密码。
254
+
255
+ 用户名和密码在`config.yaml`文件中设置。
256
+
257
+ 重启 SillyTavern 服务后,只要知道用户名和密码,任何设备都可以访问。
258
+
259
+ ### 还是无法访问?
260
+
261
+ * 为 `config.yaml` 文件中的端口创建一条入站/出站防火墙规则。切勿将此误认为是路由器上的端口转发,否则,有人可能会发现你的聊天隐私,那就大错特错了。
262
+ * 在 "设置" > "网络和 Internet" > "以太网" 中启用 "专用网络" 配置。这对 Windows 11 非常重要,否则即使添加了上述防火墙规则也无法连接。
263
+
264
+ ### 性能问题?
265
+
266
+ 尝试在用户设置面板上关闭模糊效果(快速用户界面)模式。
267
+
268
+ ## 我喜欢你的项目!我该如何贡献自己的力量?
269
+
270
+ ### 应该
271
+
272
+ 1. 发送 Fork 请求
273
+ 2. 使用规定的模板发送功能建议和问题报告
274
+ 3. 在提出任何问题之前,请先阅读 Readme 文件和文档
275
+
276
+ #### 不应该
277
+
278
+ 1. 提供金钱捐赠
279
+ 2. 发送错误报告而不提供任何详细信息
280
+ 3. 提出已经回答过无数次的问题
281
+
282
+ ## 我在哪里可以找到以前的聊天背景图片?
283
+
284
+ 我们正在实行 100% 原创内容的政策,因此旧的背景图片已从该资源库中删除。
285
+
286
+ 不过你可以在这里找到它们的存档:
287
+
288
+ <https://files.catbox.moe/1xevnc.zip>
289
+
290
+ ## 屏幕截图
291
+
292
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
293
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
294
+
295
+ ## 许可证和贡献
296
+
297
+ **发布本程序是希望它能有所帮助,但不做任何保证;甚至没有明示的性能、稳定性和其他任何特定用途的可用性保证。更多详情,请参阅 GNU Affero 通用公共许可证。**
298
+
299
+ **This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.**
300
+
301
+ * TAI Base by Humi: Unknown license
302
+ * Cohee's modifications and derived code: AGPL v3
303
+ * RossAscends' additions: AGPL v3
304
+ * Portions of CncAnon's TavernAITurbo mod: Unknown license
305
+ * kingbri's various commits and suggestions (<https://github.com/bdashore3>)
306
+ * StefanDanielSchwarz's various commits and bug reports (<https://github.com/StefanDanielSchwarz>)
307
+ * Waifu mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>)
308
+ * Thanks Pygmalion University for being awesome testers and suggesting cool features!
309
+ * Thanks oobabooga for compiling presets for TextGen
310
+ * KoboldAI Presets from KAI Lite: <https://lite.koboldai.net/>
311
+ * Noto Sans font by Google (OFL license)
312
+ * Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
313
+ * AI Horde client library by ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde>
314
+ * Linux startup script by AlpinDale
315
+ * Thanks paniphons for providing a FAQ document
316
+ * 10K Discord Users Celebratory Background by @kallmeflocc
317
+ * Default content (characters and lore books) provided by @OtisAlejandro, @RossAscends and @kallmeflocc
318
+ * Korean translation by @doloroushyeonse
319
+ * 中文翻译由 [@XXpE3](https://github.com/XXpE3) 完成,中文 ISSUES 可以联系 @XXpE3
320
+
321
+ <!-- LINK GROUP -->
322
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
jiuguan2025cc/.github/readme-zh_tw.md ADDED
@@ -0,0 +1,381 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ > [!IMPORTANT]
2
+ > 此處資訊可能已經過時或不完整,僅供您參考。請使用英文版本以取得最新資訊。
3
+
4
+ <a name="readme-top"></a>
5
+
6
+ ![][cover]
7
+
8
+ <div align="center">
9
+
10
+ [English](readme.md) | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | 繁體中文 | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
11
+
12
+ [![GitHub 星標](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
13
+ [![GitHub 分支](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
14
+ [![GitHub 問題](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
15
+ [![GitHub 拉取請求](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
16
+
17
+ </div>
18
+
19
+ ---
20
+
21
+ SillyTavern 提供一個統一的前端介面,整合多種大型語言模型的 API(包括:KoboldAI/CPP、Horde、NovelAI、Ooba、Tabby、OpenAI、OpenRouter、Claude、Mistral 等)。同時具備對行動裝置友善的佈局、視覺小說模式(Visual Novel Mode)、Automatic1111 與 ComfyUI 的影像生成 API 整合、TTS(語音合成)、世界資訊(Lorebook)、可自訂 UI、自動翻譯功能,以及強大的提示詞(prompt)設定選項和無限的第三方擴充潛力。
22
+
23
+ 我們擁有一個 [官方文件網站](https://docs.sillytavern.app/) 可以幫助解答絕大多數的使用問題,並幫助您順利入門。
24
+
25
+ ## SillyTavern 是什麼?
26
+
27
+ SillyTavern(簡稱 ST)是一款本地安裝的使用者介面,讓您能與大型語言模型(LLM)、影像生成引擎以及語音合成模型互動的前端。
28
+
29
+ SillyTavern 起源於 2023 年 2 月,作為 TavernAI 1.2.8 的分支版本發展至今。目前已有超過 100 位貢獻者,並擁有超過兩年的獨立開發歷史。如今,它已成為 AI 愛好者中備受推崇的軟體之一。
30
+
31
+ ## 我們的願景
32
+
33
+ 1. 我們致力於賦予使用者對 LLM 提示詞的最大控制權與實用性,並認為學習過程中的挑戰是樂趣的一部分。
34
+ 2. 我們不提供任何線上或託管服務,也不會程式化追蹤任何使用者數據。
35
+ 3. SillyTavern 是由一群熱衷於 LLM 的開發者社群所打造的專案,並將永遠保持免費與開源。
36
+
37
+ ## 分支介紹
38
+
39
+ SillyTavern 採用雙分支開發模式,確保為所有使用者提供流暢的體驗。
40
+
41
+ * `release`(穩定版):🌟 **推薦給大部分的使用者使用。** 此分支最為穩定,僅在主要版本發布時更新。適合大多數人,通常每月更新一次。
42
+ * `staging`(開發版):⚠️ **不建議普通使用者使用。** 此分支包含最新功能,但可能隨時出現問題。適合進階使用者與愛好者,每日多次更新。
43
+
44
+ 如果您不熟悉 git CLI 或對分支概念不清楚,請放心,對您來說,`release`(穩定版)分支永遠是首選。
45
+
46
+ ## 使用 SillyTavern 需要什麼?
47
+
48
+ 由於 SillyTavern 僅是一個介面,您需要一個 LLM 後端來提供推理能力。您可以使用 AI Horde 以立即開始聊天。此外,我們支持許多其他本地和雲端 LLM 後端,例如 OpenAI 兼容 API、KoboldAI、Tabby 等。更多支持的 API 資訊,請參閱 [常見問題](https://docs.sillytavern.app/usage/api-connections/)。
49
+
50
+ ### 我需要高效能電腦才能運行 SillyTavern 嗎?
51
+
52
+ SillyTavern 的硬體需求相當低。任何能夠運行 NodeJS 18 或更高版本的設備都可以執行。若您打算在本地機器上進行 LLM 推理,我們建議使用擁有至少 6GB VRAM 的 3000 系列 NVIDIA 顯示卡。更多詳細資訊,請參考您使用的後端文檔。
53
+
54
+ ### 推薦後端(僅為推薦,非官方合作和隸屬關係)
55
+
56
+ * [AI Horde](https://aihorde.net/):使用志願者託管的模型,無需進一步設定
57
+ * [KoboldCpp](https://github.com/LostRuins/koboldcpp):社群推崇的選擇,可在本地運行 GGUF 模型
58
+ * [tabbyAPI](https://github.com/theroyallab/tabbyAPI):一個流行且輕量的本地託管 exl2 推理 API
59
+ * [OpenRouter](https://openrouter.ai):提供多個雲端 LLM 提供商(如 OpenAI、Claude、Meta Llama 等)及熱門社群模型的單一 API
60
+
61
+ ## 有任何問題或建議?
62
+
63
+ ### 歡迎加入我們的 Discord 伺服器
64
+
65
+ | [![][discord-shield-badge]][discord-link] | [加入我們的 Disocrd 伺服器](https://discord.gg/sillytavern) 以獲得技術支援、分享您喜愛的角色與提示詞。 |
66
+ | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
67
+
68
+ 或直接聯繫開發者:
69
+
70
+ * Discord: cohee, rossascends, wolfsblvt
71
+ * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/)
72
+ * [提交 GitHub 問題](https://github.com/SillyTavern/SillyTavern/issues)
73
+
74
+ ### 我喜歡這個專案,我該如何貢獻呢?
75
+
76
+ 1. **提交拉取要求(Pull Request)**:想了解如何貢獻,請參閱 [CONTRIBUTING.md](../CONTRIBUTING.md)。
77
+ 2. **提供功能建議與問題報告**:使用本專案所提供的模板提交建議或問題報告。
78
+ 3. **仔細閱讀此 README 文件及相關文檔**:請避免提出重複問題或建議。
79
+
80
+ ## 螢幕截圖
81
+
82
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
83
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
84
+
85
+ ## 角色卡
86
+
87
+ SillyTavern 的核心概念是「角色卡」(Character Cards)。角色卡是一組設定 LLM 行為的提示詞,用於 SillyTavern 中進行持續性對話。功能類似於 ChatGPT 的 GPT 或 Poe 的聊天機器人。角色卡的內容可以是任何形式:抽象場景、針對特定任務設計的助手、知名人物,或者虛構角色。
88
+
89
+ 角色卡中唯一必填的項目是名稱欄位。若想與語言模型開始一般對話,您只需創建一個名稱為「Assistant」的新卡片,其餘欄位皆可保持空白。若希望進行更具主題性的對話,則可以提供語言模型背景資訊、行為模式、寫作風格以及特定情境來啟動聊天。
90
+
91
+ 如果僅想進行快速對話而不選擇角色卡片,或想測試 LLM 的連線,則可在開啟 SillyTavern 後,於歡迎頁面的輸入欄位中直接輸入您的提示內容。請注意,這類對話是暫時的,不會被永久保存。
92
+
93
+ 若想了解如何設定角色卡,可參考預設角色(如 Seraphina)或從「下載擴充功能 & 資源」(Download Extensions & Assets)選單中下載社群製作的角色卡。
94
+
95
+ ## 核心功能
96
+
97
+ * 進階文本生成設定:內含許多社群製作的預設設定
98
+ * 支援世界資訊(World Info):創建豐富的背景故事,或節省角色卡中的 Token(符元)使用
99
+ * 群組聊天:多角色聊天室,可讓角色與您或彼此對話
100
+ * 豐富的 UI 自定義選項:主題顏色、背景圖片、自定義 CSS 等
101
+ * 使用者設定:讓 AI 更了解您並提升沉浸感
102
+ * 內建 RAG 支持:可將文檔加入對話,供 AI 參考
103
+ * 強大的聊天指令子系統:內含 [腳本引擎(Scripting Engine)](https://docs.sillytavern.app/usage/st-script/)
104
+
105
+ ## 擴充功能
106
+
107
+ SillyTavern 支持多種擴充功能。
108
+
109
+ * 角色情感表達:使用視覺圖片(立繪)呈現情緒表達
110
+ * 聊天記錄自動摘要
111
+ * 自動化介面與聊天翻譯
112
+ * 穩定擴散(Stable Diffusion)、FLUX 和 DALL-E 的影像生成整合
113
+ * 語音合成:AI 回應的訊息可使用 ElevenLabs、Silero 或系統 TTS 語音合成
114
+ * 網頁搜尋功能:為提示詞添加真實世界的上下文資訊
115
+ * 更多擴展:可從「下載擴充功能 & 資源」(Download Extensions & Assets)選單中下載
116
+
117
+ 想了解如何使用這些擴充功能,請參考:[官方說明文件](https://docs.sillytavern.app/)
118
+
119
+ # ⌛ 安裝指南
120
+
121
+ > \[!WARNING]
122
+ >
123
+ > * 請勿將程式安裝到 Windows 的系統控制資料夾(如 Program Files、System32 等)
124
+ > * 請勿以管理員權限執行 Start.bat
125
+ > * 無法在 Windows 7 系統上安裝,因為它無法執行 NodeJS 18.16
126
+
127
+ ## 🪟 Windows
128
+
129
+ ### 使用 Git 安裝
130
+
131
+ 1. 安裝 [NodeJS](https://nodejs.org/en)(建議使用最新的 LTS 版本)
132
+ 2. 安裝 [Git for Windows](https://gitforwindows.org/)
133
+ 3. 打開 Windows 檔案總管(`Win+E`)
134
+ 4. 創建/使用一個不受 Windows 系統控制或監控的資料夾(例如:C:\MySpecialFolder\)
135
+ 5. 在該資料夾內開啟命令提示字元(Command Prompt):點擊地址欄,輸入 `cmd` 並按下 Enter
136
+ 6. 當命令提示字元黑框彈出時,輸入以下其中一條指令後,按下 Enter:
137
+
138
+ * 安裝 Release(穩定版)分支:`git clone https://github.com/SillyTavern/SillyTavern -b release`
139
+ * 安裝 Staging(開發板)分支:`git clone https://github.com/SillyTavern/SillyTavern -b staging`
140
+
141
+ 7. 當程式碼下載完成後,雙擊 `Start.bat`,NodeJS 將自動安裝所需的依賴項
142
+ 8. 本地伺服器啟動後,SillyTavern 將自動在您的瀏覽器中打開
143
+
144
+ ### 使用 GitHub Desktop 安裝
145
+
146
+ (此方式僅允許通過 GitHub Desktop 使用 git。如果您也希望在命令列中使用 `git`,則需額外安裝 [Git for Windows](https://gitforwindows.org/))
147
+
148
+ 1. 安裝 [NodeJS](https://nodejs.org/en)(建議使用最新的 LTS 版本)
149
+ 2. 安裝 [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
150
+ 3. 安裝完成後,打開 GitHub Desktop,點擊 `Clone a repository from the internet....` (注意:此步驟 **無需創建 GitHub 帳號**。)
151
+ 4. 在彈出選單中,點擊「URL」選項,輸入此網址:`https://github.com/SillyTavern/SillyTavern`,然後點擊「Clone」。您可以更改「Local path」來選擇 SillyTavern 的下載位置
152
+ 6. 若想開啟 SillyTavern,需使用 Windows 檔案總管以進入您複製儲存庫的資料夾。預設位置為:`C:\Users\[您的 Windows 使用者名稱]\Documents\GitHub\SillyTavern`
153
+ 7. 雙擊 `start.bat` 文件。(請注意:若您的作業系統隱藏了 `.bat` 副檔名,該文件可能顯示為「`Start`」。這就是您需要雙擊運行的文件。)
154
+ 8. 雙擊後,將會彈出一個大型黑色的命令提示字元視窗,SillyTavern 會開始安裝其運行所需的文件與依賴
155
+ 9. 安裝完成後,若一切正常,命令提示字元視窗應顯示運行中的訊息,且您的瀏覽器會自動打開 SillyTavern 頁籤
156
+ 10. 連接到任何 SillyTavern [支援的 APIs](https://docs.sillytavern.app/usage/api-connections/) 並開始聊天吧!
157
+
158
+ ## 🐧 Linux & 🍎 MacOS
159
+
160
+ 對於 MacOS 和 Linux 系統,所有操作都將在終端機(Terminal)中完成。
161
+
162
+ 1. 安裝 git 和 NodeJS(具體方法因操作系統而異)
163
+ 2. 複製儲存庫(Clone the repo):
164
+
165
+ * 安裝 Release(穩定版)分支:`git clone https://github.com/SillyTavern/SillyTavern -b release`
166
+ * 安裝 Staging(開發板)分支:`git clone https://github.com/SillyTavern/SillyTavern -b staging`
167
+
168
+ 3. 使用命令 `cd SillyTavern` 以進入安裝資料夾
169
+ 4. 使用以下其中一條命令,以執行 `start.sh` 腳本:
170
+
171
+ * `./start.sh`
172
+ * `bash start.sh`
173
+
174
+ ## ⚡ 使用 SillyTavern Launcher 安裝
175
+
176
+ SillyTavern Launcher 是一個安裝嚮導,協助您設定多種選項,包括安裝本地推理(inference)的後端。
177
+
178
+ ### 對於 Windows 使用者
179
+
180
+ 1. 在鍵盤上按下 **`WINDOWS + R`** 打開「執行」對話框,然後輸入以下指令以安裝 git:
181
+
182
+ ```shell
183
+ cmd /c winget install -e --id Git.Git
184
+ ```
185
+
186
+ 2. 在鍵盤上按下 **`WINDOWS + E`** 打開檔案總管,導航至您想要安裝 Launcher 的資料夾。在目標資料夾的地址欄輸入 `cmd` 並按下 Enter。接著執行以下命令:
187
+
188
+ ```shell
189
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
190
+ ```
191
+
192
+ ### 對於 Linux 使用者
193
+
194
+ 1. 打開您喜歡的終端機(Terminal),安裝 git
195
+ 2. 使用以下指令以複製 Sillytavern-Launcher:
196
+
197
+ ```shell
198
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
199
+ ```
200
+
201
+ 3. 執行安裝腳本(installer.sh):
202
+
203
+ ```shell
204
+ chmod +x install.sh && ./install.sh
205
+ ```
206
+
207
+ 4. 安裝完成後,執行啟動腳本(launcher.sh):
208
+
209
+ ```shell
210
+ chmod +x launcher.sh && ./launcher.sh
211
+ ```
212
+
213
+ ### 對於 Mac 使用者
214
+
215
+ 1. 打開終端機(Terminal),並使用以下指令安裝 Homebrew:
216
+
217
+ ```shell
218
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
219
+ ```
220
+
221
+ 2. 使用 Homebrew 以安裝 git:
222
+
223
+ ```shell
224
+ brew install git
225
+ ```
226
+
227
+ 3. 使用以下指令以複製 Sillytavern-Launcher:
228
+
229
+ ```shell
230
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
231
+ ```
232
+
233
+ 4. 執行安裝腳本(installer.sh):
234
+
235
+ ```shell
236
+ chmod +x install.sh && ./install.sh
237
+ ```
238
+
239
+ 5. 安裝完成後,執行啟動腳本(launcher.sh):
240
+
241
+ ```shell
242
+ chmod +x launcher.sh && ./launcher.sh
243
+ ```
244
+
245
+ ## 🐋 使用 Docker 安裝
246
+
247
+ 以下指南已假設您安裝 Docker,能夠訪問命令列進行容器安裝,並熟悉 Docker 的基本使用。
248
+
249
+ ### 自行構建映像
250
+
251
+ 我們提供了一份完整的 [SillyTavern Docker 使用指南](http://docs.sillytavern.app/installation/docker/)。該指南涵蓋了 Windows、macOS 和 Linux 的安裝過程。若您希望自行構建映像,建議先閱讀該文檔。
252
+
253
+ ### 使用 GitHub 容器註冊表(最簡易的方式)
254
+
255
+ 您需要設定兩個必要的目錄映射(directory mappings)和一個端口映射(port mapping)來使 SillyTavern 正常運行。在執行指令時,請將以下佔位符替換為您的實際配置:
256
+
257
+ #### 容器變數
258
+
259
+ ##### 目錄映射(Volume Mappings)
260
+
261
+ * [config]:用於存放 SillyTavern 設定文件的本地資料夾
262
+ * [data]:用於存放 SillyTavern 使用者數據(包括角色)的本地資料夾
263
+ * [plugins](可選):用於存放 SillyTavern 擴充功能的本地資料夾
264
+
265
+ ##### 端口映射(Port Mappings)
266
+
267
+ * [PublicPort]:對外流量的訪問端口。這是必需的,因為您將從虛擬機容器外部訪問實例。除非實施了額外的安全服務,否則請勿將此端口暴露於網路
268
+
269
+ ##### 其他設定(Additional Settings)
270
+
271
+ * [DockerNet]:容器應連接的 Docker 網路。如果您不熟悉此概念,請參閱 [Docker 官方說明文件](https://docs.docker.com/reference/cli/docker/network/)
272
+ * [version]:在 GitHub 頁面的右側,您可以找到「Packages」。選擇「sillytavern」包,然後查看映像版本。「latest」標籤會使您保持與當前版本同步。您也可以選擇「staging」或「release」標籤,但這可能不適用於依賴擴充功能的使用者,因為擴充功能可能需要時間進行更新
273
+
274
+ #### 安裝命令
275
+
276
+ 1. 打��命令列(Command Line)
277
+ 2. 執行以下指令:
278
+
279
+ `docker create --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
280
+
281
+ > 請注意:默認的監聽端口為 8000。如果您在設定文件中更改了此端口,請務必使用適當的端口號
282
+
283
+ ## 📱 於 Android 系統中使用 Termux 安裝
284
+
285
+ > \[!NOTE]
286
+ > **雖然您可以在 Android 設備上使用 Termux 直接運行 SillyTavern,但這不在我們的官方支持範圍內。**
287
+ >
288
+ > **請參閱 ArroganceComplex#2659 所提供的指南:**
289
+ >
290
+ > * <https://rentry.org/STAI-Termux>
291
+
292
+ **不支援:Android ARM LEtime-web。** 32 位 Android 系統需要額外的依賴項,這無法通過 npm 安裝。請使用以下命令安裝:`pkg install esbuild`。完成後,請按照普通的安裝步驟進行操作
293
+
294
+ ## API 金鑰管理
295
+
296
+ SillyTavern 將您的 API 金鑰(Keys)保存在使用者數據目錄中的 `secrets.json` 文件內(默認路徑為`/data/default-user/secrets.json`)
297
+
298
+ 默認情況下,API 金鑰在您保存並重新載入頁面後,將不會自介面中顯示
299
+
300
+ 如需啟用查看金鑰功能:
301
+
302
+ 1. 在 `config.yaml` 文件中,將 `allowKeysExposure` 的「值」設為 `true`
303
+ 2. 重新啟動 SillyTavern 伺服器
304
+ 3. 點擊 API 連線頁面右下角的「查看隱藏的 API 金鑰(View hidden API keys)」超連結
305
+
306
+ ## 命令列參數(Command-line Arguments)
307
+
308
+ 您可以在啟動 SillyTavern 伺服器時傳遞命令列參數,以覆蓋 `config.yaml` 文件中的某些設定。
309
+
310
+ ### 範例
311
+
312
+ ```shell
313
+ node server.js --port 8000 --listen false
314
+ # or
315
+ npm run start -- --port 8000 --listen false
316
+ # or(僅適用於 Windows)
317
+ Start.bat --port 8000 --listen false
318
+ ```
319
+
320
+ ### Supported arguments
321
+
322
+ | Option | Description | Type |
323
+ |-------------------------|------------------------------------------------------------------------------------------------------|----------|
324
+ | `--version` | 顯示版本序號 | boolean |
325
+ | `--enableIPv6` | 啟用 IPv6 | boolean |
326
+ | `--enableIPv4` | 啟用 IPv4 | boolean |
327
+ | `--port` | 設定 SillyTavern 運行的端口。若未提供,則預設使用 `config.yaml` 中的 'port' | number
328
+ | `--dnsPreferIPv6` | 偏好使用 IPv6 解析 DNS。未提供則默認使用 `config.yaml` 中的 'preferIPv6' | boolean |
329
+ | `--autorun` | 自動在瀏覽器中啟動 SillyTavern。未提供則默認使用 `config.yaml` 中的 'autorun' | boolean |
330
+ | `--autorunHostname` | 自動啟動時的主機名稱,通常建議保持為 'auto' | string |
331
+ | `--autorunPortOverride` | 覆蓋自動啟動的端口設定 | string |
332
+ | `--listen` | SillyTavern 是否可監聽所有網路接口。若未提供,則默認使用 `config.yaml` 中的 'listen' | boolean |
333
+ | `--corsProxy` | 啟用 CORS 代理。若未提供,則默認使用 `config.yaml` 中的 'enableCorsProxy' | boolean |
334
+ | `--disableCsrf` | 停用 CSRF 保護 | boolean |
335
+ | `--ssl` | 啟用 SSL | boolean |
336
+ | `--certPath` | 設定您證書文件的路徑 | string |
337
+ | `--keyPath` | 設定您私人金鑰文件的路徑 | string |
338
+ | `--whitelist` | 啟用白名單模式 | boolean |
339
+ | `--dataRoot` | 設定數據儲存的根目錄 | string |
340
+ | `--avoidLocalhost` | 在自動模式下避免使用 'localhost' | boolean |
341
+ | `--basicAuthMode` | 啟用基本身份驗證模式 | boolean |
342
+ | `--requestProxyEnabled` | 啟用代理以處理外部請求 | boolean |
343
+ | `--requestProxyUrl` | 設定請求代理的 URL(支持 HTTP 或 SOCKS 協議) | string |
344
+ | `--requestProxyBypass` | 請求代理的例外主機清單(主機列表需以空格分隔) | array |
345
+
346
+ ## 遠端連線
347
+
348
+ 遠端連線功能最常用於希望在手機上使用 SillyTavern 的使用者。此時伺服器將由同一 Wi-Fi 網路上的 PC 運行。不過,您也可以設定來自其他網路的遠端連線。
349
+
350
+ 詳細設定指南請參閱 [官方說明文件](https://docs.sillytavern.app/usage/remoteconnections/)。
351
+
352
+ 您還可以選擇設定 SillyTavern 的使用者檔案,並開啟密碼保護(可選):[使用者設定指南](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users)。
353
+
354
+ ## 遇到任何效能問題?
355
+
356
+ 1. 在「使用者設定」選單(設定介面主題)中,禁用模糊效果(Blur Effect),並開啟「減少動畫效果」(Reduced Motion)
357
+ 2. 若使用響應串流傳輸,請將串流的 FPS 設定為較低的值(建議設定為 10-15 FPS)
358
+ 3. 確保瀏覽器已啟用 GPU 加速以進行渲染
359
+
360
+ ## 授權與致謝
361
+
362
+ **本程式(SillyTavern)的發布是基於其可能對使用者有所幫助的期許,但不提供任何形式的保證;包括但不限於對可銷售性(marketability)或特定用途適用性的隱含保證。如需更多詳情,請參閱 GNU Affero 通用公共許可證。**
363
+
364
+ This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
365
+
366
+ * [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8 由 Humi 提供:MIT 許可
367
+ * 經授權使用部分來自 CncAnon 的 TavernAITurbo 模組
368
+ * 視覺小說模式(Visual Novel Mode)的靈感,來源於 PepperTaco 的貢獻(<https://github.com/peppertaco/Tavern/>)
369
+ * Noto Sans 字體由 Google 提供(OFL 許可)
370
+ * 主題圖示由 Font Awesome <https://fontawesome.com> 提供(圖示:CC BY 4.0,字體:SIL OFL 1.1,程式碼:MIT 許可)
371
+ * 預設資源來源於 @OtisAlejandro(包含角色 Seraphina 與知識書)與 @kallmeflocc(SillyTavern 官方 Discord 伺服器成員突破 10K 的慶祝背景)
372
+ * Docker 安裝指南由 [@mrguymiah](https://github.com/mrguymiah) 和 [@Bronya-Rand](https://github.com/Bronya-Rand) 編寫
373
+
374
+ ## 主要貢獻者
375
+
376
+ [![Contributors](https://contrib.rocks/image?repo=SillyTavern/SillyTavern)](https://github.com/SillyTavern/SillyTavern/graphs/contributors)
377
+
378
+ <!-- LINK GROUP -->
379
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
380
+ [discord-link]: https://discord.gg/sillytavern
381
+ [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge
jiuguan2025cc/.github/readme.md ADDED
@@ -0,0 +1,432 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <a name="readme-top"></a>
2
+
3
+ ![][cover]
4
+
5
+ <div align="center">
6
+
7
+ English | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md)
8
+
9
+ [![GitHub Stars](https://img.shields.io/github/stars/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/stargazers)
10
+ [![GitHub Forks](https://img.shields.io/github/forks/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/network)
11
+ [![GitHub Issues](https://img.shields.io/github/issues/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/issues)
12
+ [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/SillyTavern/SillyTavern.svg)](https://github.com/SillyTavern/SillyTavern/pulls)
13
+
14
+ </div>
15
+
16
+ ---
17
+
18
+ SillyTavern provides a single unified interface for many LLM APIs (KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral and more), a mobile-friendly layout, Visual Novel Mode, Automatic1111 & ComfyUI API image generation integration, TTS, WorldInfo (lorebooks), customizable UI, auto-translate, more prompt options than you'd ever want or need, and endless growth potential via third-party extensions.
19
+
20
+ We have a [Documentation website](https://docs.sillytavern.app/) to answer most of your questions and help you get started.
21
+
22
+ ## What is SillyTavern?
23
+
24
+ SillyTavern (or ST for short) is a locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models.
25
+
26
+ Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 200 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists.
27
+
28
+ ## Our Vision
29
+
30
+ 1. We aim to empower users with as much utility and control over their LLM prompts as possible. The steep learning curve is part of the fun!
31
+ 2. We do not provide any online or hosted services, nor programmatically track any user data.
32
+ 3. SillyTavern is a passion project brought to you by a dedicated community of LLM enthusiasts, and will always be free and open sourced.
33
+
34
+ ## Branches
35
+
36
+ SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.
37
+
38
+ * `release` -🌟 **Recommended for most users.** This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.
39
+ * `staging` - ⚠️ **Not recommended for casual use.** This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily.
40
+
41
+ If you're not familiar with using the git CLI or don't understand what a branch is, don't worry! The release branch is always the preferable option for you.
42
+
43
+ ## What do I need other than SillyTavern?
44
+
45
+ Since SillyTavern is only an interface, you will need access to an LLM backend to provide inference. You can use AI Horde for instant out-of-the-box chatting. Aside from that, we support many other local and cloud-based LLM backends: OpenAI-compatible API, KoboldAI, Tabby, and many more. You can read more about our supported APIs in [the FAQ](https://docs.sillytavern.app/usage/api-connections/).
46
+
47
+ ### Do I need a powerful PC to run SillyTavern?
48
+
49
+ The hardware requirements are minimal: it will run on anything that can run NodeJS 18 or higher. If you intend to do LLM inference on your local machine, we recommend a 3000-series NVIDIA graphics card with at least 6GB of VRAM. Check your backend's documentation for more details.
50
+
51
+ ### Suggested Backends (not affiliated)
52
+
53
+ * [AI Horde](https://aihorde.net/) - use models hosted by volunteers. Requires no further setup
54
+ * [KoboldCpp](https://github.com/LostRuins/koboldcpp) - a community's favorite for running GGUF models locally
55
+ * [tabbyAPI](https://github.com/theroyallab/tabbyAPI) - a popular, lightweight, locally-hosted exl2 inference API
56
+ * [OpenRouter](https://openrouter.ai) - a single API for many cloud providers (OpenAI, Claude, Meta Llama, etc.) as well as popular community models.
57
+
58
+ ## Questions or suggestions?
59
+
60
+ ### Discord server
61
+
62
+ | [![][discord-shield-badge]][discord-link] | [Join our Discord community!](https://discord.gg/sillytavern) Get support, share favorite characters and prompts. |
63
+ | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
64
+
65
+ Or get in touch with the developers directly:
66
+
67
+ * Discord: cohee, rossascends, wolfsblvt
68
+ * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/)
69
+ * [Post a GitHub issue](https://github.com/SillyTavern/SillyTavern/issues)
70
+
71
+ ### I like your project! How do I contribute?
72
+
73
+ 1. Send pull requests. Learn how to contribute: [CONTRIBUTING.md](../CONTRIBUTING.md)
74
+ 2. Send feature suggestions and issue reports using the provided templates.
75
+ 3. Read this entire readme file and check the documentation website first, to avoid sending duplicate issues.
76
+
77
+ ## Screenshots
78
+
79
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f">
80
+ <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1">
81
+
82
+ ## Character Cards
83
+
84
+ SillyTavern is built around the concept of "character cards". A character card is a collection of prompts that set the behavior of the LLM and is required to have persistent conversations in SillyTavern. They function similarly to ChatGPT's GPTs or Poe's bots. The content of a character card can be anything: an abstract scenario, an assistant tailored for a specific task, a famous personality or a fictional character.
85
+
86
+ The name field is the only required character card input. To start a neutral conversation with the language model, create a new card simply called "Assistant" and leave the rest of the boxes blank. For a more themed chat, you can provide the language model with various background details, behavior and writing patterns, and a scenario to jump start the chat.
87
+
88
+ To have a quick conversation without selecting a character card or to just test the LLM connection, simply type your prompt input into the input bar on the Welcome Screen after opening SillyTavern. Please note that such chats are temporary and will not be saved.
89
+
90
+ To get a general idea on how to define character cards, see the default character (Seraphina) or download selected community-made cards from the "Download Extensions & Assets" menu.
91
+
92
+ ## Key Features
93
+
94
+ * Advanced text generation settings with many community-made presets
95
+ * World Info support: create rich lore or save tokens on your character card
96
+ * Group chats: multi-bot rooms for characters to talk to you and/or each other
97
+ * Rich UI customization options: theme colors, background images, custom CSS, and more
98
+ * User personas: let the AI know a bit about you for greater immersion
99
+ * Built-in RAG support: add documents to your chats for the AI to reference
100
+ * Extensive chat commands subsystem and own [scripting engine](https://docs.sillytavern.app/usage/st-script/)
101
+
102
+ ## Extensions
103
+
104
+ SillyTavern has extensibility support.
105
+
106
+ * Character emotional expressions (sprites)
107
+ * Auto-Summary of the chat history
108
+ * Automatic UI and chat translation
109
+ * Stable Diffusion/FLUX/DALL-E image generation
110
+ * Text-to-speech for AI response messages (via ElevenLabs, Silero, or the OS's System TTS)
111
+ * Web Search capabilities for adding additional real world context to your prompts
112
+ * Many more are available to download from the "Download Extensions & Assets" menu.
113
+
114
+ Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern.app/).
115
+
116
+ ## ⌛ Installation
117
+
118
+ ### 🪟 Windows
119
+
120
+ > \[!WARNING]
121
+ >
122
+ > * DO NOT INSTALL INTO ANY WINDOWS CONTROLLED FOLDER (Program Files, System32, etc).
123
+ > * DO NOT RUN START.BAT WITH ADMIN PERMISSIONS
124
+ > * INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16
125
+
126
+ #### Installing via Git (recommended)
127
+
128
+ 1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
129
+ 2. Install [Git for Windows](https://gitforwindows.org/)
130
+ 3. Open Windows Explorer (`Win+E`)
131
+ 4. Browse to or Create a folder that is not controlled or monitored by Windows. (ex: C:\MySpecialFolder\)
132
+ 5. Open a Command Prompt inside that folder by clicking in the 'Address Bar' at the top, typing `cmd`, and pressing Enter.
133
+ 6. Once the black box (Command Prompt) pops up, type ONE of the following into it and press Enter:
134
+
135
+ * for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
136
+ * for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
137
+
138
+ 7. Once everything is cloned, double-click `Start.bat` to make NodeJS install its requirements.
139
+ 8. The server will then start, and SillyTavern will pop up in your browser.
140
+
141
+ #### Installing via GitHub Desktop
142
+
143
+ (This allows git usage **only** in GitHub Desktop, if you want to use `git` on the command line too, you also need to install [Git for Windows](https://gitforwindows.org/))
144
+
145
+ 1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
146
+ 2. Install [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
147
+ 3. After installing GitHub Desktop, click on `Clone a repository from the internet....` (Note: You **do NOT need** to create a GitHub account for this step)
148
+ 4. On the menu, click the URL tab, enter this URL `https://github.com/SillyTavern/SillyTavern`, and click Clone. You can change the Local path to change where SillyTavern is going to be downloaded.
149
+ 6. To open SillyTavern, use Windows Explorer to browse into the folder where you cloned the repository. By default, the repository will be cloned here: `C:\Users\[Your Windows Username]\Documents\GitHub\SillyTavern`
150
+ 7. Double-click on the `start.bat` file. (Note: the `.bat` part of the file name might be hidden by your OS, in that case, it will look like a file called "`Start`". This is what you double-click to run SillyTavern)
151
+ 8. After double-clicking, a large black command console window should open and SillyTavern will begin to install what it needs to operate.
152
+ 9. After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:
153
+ 10. Connect to any of the [supported APIs](https://docs.sillytavern.app/usage/api-connections/) and start chatting!
154
+
155
+ ### 🐧 Linux & 🍎 MacOS
156
+
157
+ For MacOS / Linux all of these will be done in a Terminal.
158
+
159
+ 1. Install git and nodeJS (the method for doing this will vary depending on your OS)
160
+ 2. Clone the repo
161
+
162
+ * for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
163
+ * for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
164
+
165
+ 3. `cd SillyTavern` to navigate into the install folder.
166
+ 4. Run the `start.sh` script with one of these commands:
167
+
168
+ * `./start.sh`
169
+ * `bash start.sh`
170
+
171
+ ## 🐋 Installing via Docker
172
+
173
+ These instructions assume you have installed Docker, are able to access your command line for the installation of containers, and familiar with their general operation.
174
+
175
+ ### Using the GitHub Container Registry
176
+
177
+ #### Docker Compose (easiest)
178
+
179
+ Grab the `docker-compose.yml` file from the [GitHub Repository](https://github.com/SillyTavern/SillyTavern/blob/release/docker/docker-compose.yml) and run the following command in the directory where the file is located. This will pull the latest release image from the GitHub Container Registry and start the container, automatically creating the necessary volumes.
180
+
181
+ ```shell
182
+ docker-compose up
183
+ ```
184
+
185
+ Customize the `docker-compose.yml` file to your needs. The default port is 8000. If you want to adjust the server configuration using environment variables, read the documentation [here](https://docs.sillytavern.app/administration/config-yaml/#environment-variables).
186
+
187
+ #### Docker CLI (advanced)
188
+
189
+ You will need two mandatory directory mappings and a port mapping to allow SillyTavern to function. In the command, replace your selections in the following places:
190
+
191
+ #### Container Variables
192
+
193
+ ##### Volume Mappings
194
+
195
+ * `CONFIG_PATH` - The directory where SillyTavern configuration files will be stored on your host machine
196
+ * `DATA_PATH` - The directory where SillyTavern user data (including characters) will be stored on your host machine
197
+ * `PLUGINS_PATH` - (optional) The directory where SillyTavern server plugins will be stored on your host machine
198
+ * `EXTENSIONS_PATH` - (optional) The directory where global UI extensions will be stored on your host machine
199
+
200
+ ##### Port Mappings
201
+
202
+ * `PUBLIC_PORT` - The port to expose the traffic on. This is mandatory, as you will be accessing the instance from outside of its virtual machine container. DO NOT expose this to the internet without implementing a separate service for security.
203
+
204
+ ##### Additional Settings
205
+
206
+ * `SILLYTAVERN_VERSION` - On the right-hand side of this GitHub page, you'll see "Packages". Select the "sillytavern" package and you'll see the image versions. The image tag "latest" will keep you up-to-date with the current release. You can also utilize "staging" that points to the nightly image of the respective branch.
207
+
208
+ #### Running the container
209
+
210
+ 1. Open your Command Line
211
+ 2. Run the following command in a folder where you want to store the configuration and data files:
212
+
213
+ ```bash
214
+ SILLYTAVERN_VERSION="latest"
215
+ PUBLIC_PORT="8000"
216
+ CONFIG_PATH="./config"
217
+ DATA_PATH="./data"
218
+ PLUGINS_PATH="./plugins"
219
+ EXTENSIONS_PATH="./extensions"
220
+
221
+ docker run \
222
+ --name="sillytavern" \
223
+ -p "$PUBLIC_PORT:8000/tcp" \
224
+ -v "$CONFIG_PATH:/home/node/app/config:rw" \
225
+ -v "$DATA_PATH:/home/node/app/data:rw" \
226
+ -v "$EXTENSIONS_PATH:/home/node/app/public/scripts/extensions/third-party:rw" \
227
+ -v "$PLUGINS_PATH:/home/node/app/plugins:rw" \
228
+ ghcr.io/sillytavern/sillytavern:"$SILLYTAVERN_VERSION"
229
+ ```
230
+
231
+ > By default the container will run in the foreground. If you want to run it in the background, add the `-d` flag to the `docker run` command.
232
+
233
+ ### Building the image yourself
234
+
235
+ We have a comprehensive guide on using SillyTavern in Docker [here](http://docs.sillytavern.app/installation/docker/) which covers installations on Windows, macOS and Linux! Give it a read if you wish to build the image yourself.
236
+
237
+ ## ⚡ Installing via SillyTavern Launcher
238
+
239
+ SillyTavern Launcher is an installation wizard that will help you get setup with many options, including installing a backend for local inference.
240
+
241
+ ### For Windows users
242
+
243
+ 1. On your keyboard: press **`WINDOWS + R`** to open Run dialog box. Then, run the following command to install git:
244
+
245
+ ```shell
246
+ cmd /c winget install -e --id Git.Git
247
+ ```
248
+
249
+ 2. On your keyboard: press **`WINDOWS + E`** to open File Explorer, then navigate to the folder where you want to install the launcher. Once in the desired folder, type `cmd` into the address bar and press enter. Then, run the following command:
250
+
251
+ ```shell
252
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
253
+ ```
254
+
255
+ ### For Linux users
256
+
257
+ 1. Open your favorite terminal and install git
258
+ 2. Git clone the Sillytavern-Launcher with:
259
+
260
+ ```shell
261
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
262
+ ```
263
+
264
+ 3. Start the installer.sh with:
265
+
266
+ ```shell
267
+ chmod +x install.sh && ./install.sh
268
+ ```
269
+
270
+ 4. After installation start the launcher.sh with:
271
+
272
+ ```shell
273
+ chmod +x launcher.sh && ./launcher.sh
274
+ ```
275
+
276
+ ### For Mac users
277
+
278
+ 1. Open a terminal and install brew with:
279
+
280
+ ```shell
281
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
282
+ ```
283
+
284
+ 2. Install git with:
285
+
286
+ ```shell
287
+ brew install git
288
+ ```
289
+
290
+ 3. Git clone the Sillytavern-Launcher with:
291
+
292
+ ```shell
293
+ git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
294
+ ```
295
+
296
+ 4. Start the installer.sh with:
297
+
298
+ ```shell
299
+ chmod +x install.sh && ./install.sh
300
+ ```
301
+
302
+ 5. After installation start the launcher.sh with:
303
+
304
+ ```shell
305
+ chmod +x launcher.sh && ./launcher.sh
306
+ ```
307
+
308
+ ## 📱 Installing via Termux on Android OS
309
+
310
+ > \[!NOTE]
311
+ > **SillyTavern can be run natively on Android devices using Termux, but we do not provide official support for this use case.**
312
+ >
313
+ > **Please refer to this guide by ArroganceComplex#2659:**
314
+ >
315
+ > * <https://rentry.org/STAI-Termux>
316
+
317
+ **Unsupported platform: android arm LEtime-web.** 32-bit Android requires an external dependency that can't be installed with npm. Use the following command to install it: `pkg install esbuild`. Then run the usual installation steps.
318
+
319
+ ## API keys management
320
+
321
+ SillyTavern saves your API keys to a `secrets.json` file in the user data directory (`/data/default-user/secrets.json` is the default path).
322
+
323
+ By default, API keys will not be visible from the interface after you have saved them and refreshed the page.
324
+
325
+ In order to enable viewing your keys:
326
+
327
+ 1. Set the value of `allowKeysExposure` to `true` in `config.yaml` file.
328
+ 2. Restart the SillyTavern server.
329
+ 3. Click the 'View hidden API keys' link at the bottom right of the API Connection Panel.
330
+
331
+ ## Command-line arguments
332
+
333
+ You can pass command-line arguments to SillyTavern server startup to override some settings in `config.yaml`.
334
+
335
+ ### Examples
336
+
337
+ ```shell
338
+ node server.js --port 8000 --listen false
339
+ # or
340
+ npm run start -- --port 8000 --listen false
341
+ # or (Windows only)
342
+ Start.bat --port 8000 --listen false
343
+ ```
344
+
345
+ ### Supported arguments
346
+
347
+ > \[!TIP]
348
+ > None of the arguments are required. If you don't provide them, SillyTavern will use the settings in `config.yaml`.
349
+
350
+ | Option | Description | Type |
351
+ |-------------------------|----------------------------------------------------------------------|----------|
352
+ | `--version` | Show version number | boolean |
353
+ | `--dataRoot` | Root directory for data storage | string |
354
+ | `--port` | Sets the port under which SillyTavern will run | number |
355
+ | `--listen` | SillyTavern will listen on all network interfaces | boolean |
356
+ | `--whitelist` | Enables whitelist mode | boolean |
357
+ | `--basicAuthMode` | Enables basic authentication | boolean |
358
+ | `--enableIPv4` | Enables IPv4 protocol | boolean |
359
+ | `--enableIPv6` | Enables IPv6 protocol | boolean |
360
+ | `--listenAddressIPv4` | Specific IPv4 address to listen to | string |
361
+ | `--listenAddressIPv6` | Specific IPv6 address to listen to | string |
362
+ | `--dnsPreferIPv6` | Prefers IPv6 for DNS | boolean |
363
+ | `--ssl` | Enables SSL | boolean |
364
+ | `--certPath` | Path to your certificate file | string |
365
+ | `--keyPath` | Path to your private key file | string |
366
+ | `--autorun` | Automatically launch SillyTavern in the browser | boolean |
367
+ | `--autorunHostname` | Autorun hostname | string |
368
+ | `--autorunPortOverride` | Overrides the port for autorun | string |
369
+ | `--avoidLocalhost` | Avoids using 'localhost' for autorun in auto mode | boolean |
370
+ | `--corsProxy` | Enables CORS proxy | boolean |
371
+ | `--requestProxyEnabled` | Enables a use of proxy for outgoing requests | boolean |
372
+ | `--requestProxyUrl` | Request proxy URL (HTTP or SOCKS protocols) | string |
373
+ | `--requestProxyBypass` | Request proxy bypass list (space separated list of hosts) | array |
374
+ | `--disableCsrf` | Disables CSRF protection (NOT RECOMMENDED) | boolean |
375
+
376
+ ## Remote connections
377
+
378
+ Most often this is for people who want to use SillyTavern on their mobile phones while their PC runs the ST server on the same Wi-Fi network. However, it can be used to allow remote connections from anywhere as well.
379
+
380
+ Read the detailed guide on how to set up remote connections in the [Docs](https://docs.sillytavern.app/usage/remoteconnections/).
381
+
382
+ You may also want to configure SillyTavern user profiles with (optional) password protection: [Users](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users).
383
+
384
+ ## Performance issues?
385
+
386
+ ### General tips
387
+
388
+ 1. Disable the Blur Effect and enable Reduced Motion on the User Settings panel (UI Theme toggles category).
389
+ 2. If using response streaming, set the streaming FPS to a lower value (10-15 FPS is recommended).
390
+ 3. Make sure the browser is enabled to use GPU acceleration for rendering.
391
+
392
+ ### Input lag
393
+
394
+ Performance degradation, particularly input lag, is most commonly attributed to browser extensions. Known problematic extensions include:
395
+
396
+ * iCloud Password Manager
397
+ * DeepL Translation
398
+ * AI-based grammar correction tools
399
+ * Various ad-blocking extensions
400
+
401
+ If you experience performance issues and cannot identify the cause, or suspect an issue with SillyTavern itself, please:
402
+
403
+ 1. [Record a performance profile](https://developer.chrome.com/docs/devtools/performance/reference)
404
+ 2. Export the profile as a JSON file
405
+ 3. Submit it to the development team for analysis
406
+
407
+ We recommend first testing with all browser extensions and third-party SillyTavern extensions disabled to isolate the source of the performance degradation.
408
+
409
+ ## License and credits
410
+
411
+ **This program is distributed in the hope that it will be useful,
412
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
413
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
414
+ GNU Affero General Public License for more details.**
415
+
416
+ * [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8 by Humi: MIT License
417
+ * Portions of CncAnon's TavernAITurbo mod used with permission
418
+ * Visual Novel Mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>)
419
+ * Noto Sans font by Google (OFL license)
420
+ * Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
421
+ * Default content by @OtisAlejandro (Seraphina character and lorebook) and @kallmeflocc (10K Discord Users Celebratory Background)
422
+ * Docker guide by [@mrguymiah](https://github.com/mrguymiah) and [@Bronya-Rand](https://github.com/Bronya-Rand)
423
+ * kokoro-js library by [@hexgrad](https://github.com/hexgrad) (Apache-2.0 License)
424
+
425
+ ## Top Contributors
426
+
427
+ [![Contributors](https://contrib.rocks/image?repo=SillyTavern/SillyTavern)](https://github.com/SillyTavern/SillyTavern/graphs/contributors)
428
+
429
+ <!-- LINK GROUP -->
430
+ [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44
431
+ [discord-link]: https://discord.gg/sillytavern
432
+ [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge
jiuguan2025cc/.github/workflows/docker-publish.yml ADDED
@@ -0,0 +1,94 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # This workflow will publish a docker image for every full release to the GitHub package repository
2
+
3
+ name: Create Docker Image (Release and Staging)
4
+
5
+ on:
6
+ release:
7
+ # Allow pre-releases
8
+ types: [published]
9
+ schedule:
10
+ # Build the staging image everyday at 00:00 UTC
11
+ - cron: "0 0 * * *"
12
+ push:
13
+ # Temporary workaround
14
+ branches:
15
+ - release
16
+
17
+ env:
18
+ # This should allow creation of docker images even in forked repositories
19
+ REPO: ${{ github.repository }}
20
+ REGISTRY: ghcr.io
21
+
22
+ jobs:
23
+ build:
24
+ if: github.repository == 'SillyTavern/SillyTavern'
25
+ runs-on: ubuntu-latest
26
+
27
+ steps:
28
+ # Workaround for GitHub repo names containing uppercase characters
29
+ - name: Set lowercase repo name
30
+ run: |
31
+ echo "IMAGE_NAME=${REPO,,}" >> ${GITHUB_ENV}
32
+
33
+ # Using the following workaround because currently GitHub Actions
34
+ # does not support logical AND/OR operations on triggers
35
+ # It's currently not possible to have `branches` under the `schedule` trigger
36
+ - name: Checkout the release branch (on release)
37
+ if: ${{ github.event_name == 'release' || github.event_name == 'push' }}
38
+ uses: actions/[email protected]
39
+ with:
40
+ ref: "release"
41
+
42
+ - name: Checkout the staging branch
43
+ if: ${{ github.event_name == 'schedule' }}
44
+ uses: actions/[email protected]
45
+ with:
46
+ ref: "staging"
47
+
48
+ # Get current branch name
49
+ # This is also part of the workaround for Actions not allowing logical
50
+ # AND/OR operators on triggers
51
+ # Otherwise the action triggered by schedule always has ref_name = release
52
+ - name: Get the current branch name
53
+ run: |
54
+ echo "BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)" >> ${GITHUB_ENV}
55
+
56
+ # Setting up QEMU for multi-arch image build
57
+ - name: Set up QEMU
58
+ uses: docker/setup-qemu-action@v3
59
+
60
+ - name: Set up Docker Buildx
61
+ uses: docker/setup-buildx-action@v3
62
+
63
+ - name: Extract metadata (tags, labels) for the image
64
+ uses: docker/[email protected]
65
+ id: metadata
66
+ with:
67
+ images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
68
+ # Release version tag if the workflow is triggered by a release
69
+ # Branch name tag if the workflow is triggered by a push
70
+ # Latest tag if the branch is release and the workflow is triggered by a push
71
+ tags: |
72
+ ${{ github.event_name == 'release' && github.ref_name || env.BRANCH_NAME }}
73
+ ${{ github.event_name == 'push' && env.BRANCH_NAME == 'release' && 'latest' || '' }}
74
+
75
+ # Login into package repository as the person who created the release
76
+ - name: Log in to the Container registry
77
+ uses: docker/login-action@v3
78
+ with:
79
+ registry: ${{ env.REGISTRY }}
80
+ username: ${{ github.actor }}
81
+ password: ${{ secrets.GITHUB_TOKEN }}
82
+
83
+ # Build docker image using dockerfile for amd64 and arm64
84
+ # Tag it with branch name
85
+ # Assumes branch name is the version number
86
+ - name: Build and push
87
+ uses: docker/[email protected]
88
+ with:
89
+ context: .
90
+ platforms: linux/amd64,linux/arm64
91
+ file: Dockerfile
92
+ push: true
93
+ tags: ${{ steps.metadata.outputs.tags }}
94
+ labels: ${{ steps.metadata.outputs.labels }}
jiuguan2025cc/.github/workflows/issues-auto-manager.yml ADDED
@@ -0,0 +1,116 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 🛠️ Issues Manager
2
+
3
+ on:
4
+ issues:
5
+ types: [opened, edited, labeled, unlabeled]
6
+ # Re also listen to comments, to remove stale labels right away
7
+ issue_comment:
8
+ types: [created]
9
+
10
+ permissions:
11
+ contents: read
12
+ issues: write
13
+
14
+ jobs:
15
+ label-on-content:
16
+ name: 🏷️ Label Issues by Content
17
+ runs-on: ubuntu-latest
18
+
19
+ steps:
20
+ - name: Checkout Repository
21
+ # Checkout
22
+ # https://github.com/marketplace/actions/checkout
23
+ uses: actions/[email protected]
24
+
25
+ - name: Auto-Label Issues (Based on Issue Content)
26
+ # only auto label based on issue content once, on open (to prevent re-labeling removed labels)
27
+ if: github.event.action == 'opened'
28
+
29
+ # Issue Labeler
30
+ # https://github.com/marketplace/actions/regex-issue-labeler
31
+ uses: github/[email protected]
32
+ with:
33
+ configuration-path: .github/issues-auto-labels.yml
34
+ enable-versioned-regex: 0
35
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
36
+
37
+ label-on-labels:
38
+ name: 🏷️ Label Issues by Labels
39
+ runs-on: ubuntu-latest
40
+
41
+ steps:
42
+ - name: ✅ Add "👍 Approved" for relevant labels
43
+ if: contains(fromJSON('["👩‍💻 Good First Issue", "🙏 Help Wanted", "🪲 Confirmed", "⚠️ High Priority", "❕ Medium Priority", "💤 Low Priority"]'), github.event.label.name)
44
+ # 🤖 Issues Helper
45
+ # https://github.com/marketplace/actions/issues-helper
46
+ uses: actions-cool/[email protected]
47
+ with:
48
+ actions: 'add-labels'
49
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
50
+ labels: '👍 Approved'
51
+
52
+ - name: ❌ Remove progress labels when issue is marked done or stale
53
+ if: contains(fromJSON('["✅ Done", "✅ Done (staging)", "⚰️ Stale", "❌ wontfix"]'), github.event.label.name)
54
+ # 🤖 Issues Helper
55
+ # https://github.com/marketplace/actions/issues-helper
56
+ uses: actions-cool/[email protected]
57
+ with:
58
+ actions: 'remove-labels'
59
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
60
+ labels: '🧑‍💻 In Progress,🤔 Unsure,🤔 Under Consideration'
61
+
62
+ - name: ❌ Remove temporary labels when confirmed labels are added
63
+ if: contains(fromJSON('["❌ wontfix","👍 Approved","👩‍💻 Good First Issue"]'), github.event.label.name)
64
+ # 🤖 Issues Helper
65
+ # https://github.com/marketplace/actions/issues-helper
66
+ uses: actions-cool/[email protected]
67
+ with:
68
+ actions: 'remove-labels'
69
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
70
+ labels: '🤔 Unsure,🤔 Under Consideration'
71
+
72
+ - name: ❌ Remove no bug labels when "🪲 Confirmed" is added
73
+ if: github.event.label.name == '🪲 Confirmed'
74
+ # 🤖 Issues Helper
75
+ # https://github.com/marketplace/actions/issues-helper
76
+ uses: actions-cool/[email protected]
77
+ with:
78
+ actions: 'remove-labels'
79
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
80
+ labels: '✖️ Not Reproducible,✖️ Not A Bug'
81
+
82
+ remove-stale-label:
83
+ name: 🗑️ Remove Stale Label on Comment
84
+ runs-on: ubuntu-latest
85
+ # Only run this on new comments, to automatically remove the stale label
86
+ if: github.event_name == 'issue_comment' && github.actor != 'github-actions[bot]'
87
+
88
+ steps:
89
+ - name: Remove Stale Label
90
+ # 🤖 Issues Helper
91
+ # https://github.com/marketplace/actions/issues-helper
92
+ uses: actions-cool/[email protected]
93
+ with:
94
+ actions: 'remove-labels'
95
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
96
+ issue-number: ${{ github.event.issue.number }}
97
+ labels: '⚰️ Stale,🕸️ Inactive,🚏 Awaiting User Response,🛑 No Response'
98
+
99
+ write-auto-comments:
100
+ name: 💬 Post Issue Comments Based on Labels
101
+ needs: [label-on-content, label-on-labels]
102
+ runs-on: ubuntu-latest
103
+
104
+ steps:
105
+ - name: Checkout Repository
106
+ # Checkout
107
+ # https://github.com/marketplace/actions/checkout
108
+ uses: actions/[email protected]
109
+
110
+ - name: Post Issue Comments Based on Labels
111
+ # Label Commenter
112
+ # https://github.com/marketplace/actions/label-commenter
113
+ uses: peaceiris/[email protected]
114
+ with:
115
+ config_file: .github/issues-auto-comments.yml
116
+ github_token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
jiuguan2025cc/.github/workflows/issues-updates-on-merge.yml ADDED
@@ -0,0 +1,45 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 🔄 Update Issues on Push
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - staging
7
+ - release
8
+
9
+ permissions:
10
+ contents: read
11
+ issues: write
12
+
13
+ jobs:
14
+ # This runs commits to staging/release, reading the commit messages. Check `pr-auto-manager.yml`:`update-linked-issues` for PR-linked updates.
15
+ update-linked-issues:
16
+ name: 🔗 Mark Linked Issues Done on Push
17
+ runs-on: ubuntu-latest
18
+
19
+ steps:
20
+ - name: Checkout Repository
21
+ # Checkout
22
+ # https://github.com/marketplace/actions/checkout
23
+ uses: actions/[email protected]
24
+
25
+ - name: Extract Linked Issues from Commit Message
26
+ id: extract_issues
27
+ run: |
28
+ ISSUES=$(git log ${{ github.event.before }}..${{ github.event.after }} --pretty=%B | grep -oiE '(close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved) #([0-9]+)' | awk '{print $2}' | tr -d '#' | jq -R -s -c 'split("\n")[:-1]')
29
+ echo "issues=$ISSUES" >> $GITHUB_ENV
30
+
31
+ - name: Label Linked Issues
32
+ id: label_linked_issues
33
+ env:
34
+ GH_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
35
+ run: |
36
+ for ISSUE in $(echo $issues | jq -r '.[]'); do
37
+ if [ "${{ github.ref }}" == "refs/heads/staging" ]; then
38
+ LABEL="✅ Done (staging)"
39
+ gh issue edit $ISSUE -R ${{ github.repository }} --add-label "$LABEL"
40
+ elif [ "${{ github.ref }}" == "refs/heads/release" ]; then
41
+ LABEL="✅ Done"
42
+ gh issue edit $ISSUE -R ${{ github.repository }} --add-label "$LABEL"
43
+ fi
44
+ echo "Added label '$LABEL' to issue #$ISSUE"
45
+ done
jiuguan2025cc/.github/workflows/job-close-stale.yml ADDED
@@ -0,0 +1,100 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 🕒 Close Stale Issues/PRs Workflow
2
+
3
+ on:
4
+ # Run the workflow every day
5
+ workflow_dispatch:
6
+ schedule:
7
+ - cron: '0 0 * * *' # Runs every day at midnight UTC
8
+
9
+ permissions:
10
+ contents: read
11
+ issues: write
12
+ pull-requests: write
13
+
14
+ jobs:
15
+ mark-inactivity:
16
+ name: ⏳ Mark Issues/PRs without Activity
17
+ runs-on: ubuntu-latest
18
+
19
+ steps:
20
+ - name: Mark Issues/PRs without Activity
21
+ # Close Stale Issues and PRs
22
+ # https://github.com/marketplace/actions/close-stale-issues
23
+ uses: actions/[email protected]
24
+ with:
25
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
26
+ days-before-stale: 183
27
+ days-before-close: 7
28
+ operations-per-run: 30
29
+ remove-stale-when-updated: true
30
+ enable-statistics: true
31
+ stale-issue-message: >
32
+ ⏳ This issue has been inactive for 6 months. If it's still relevant, drop a comment below to keep it open.
33
+ Otherwise, it will be auto-closed in 7 days.
34
+ stale-pr-message: >
35
+ ⏳ This PR has been inactive for 6 months. If it's still relevant, update it or remove the stale label.
36
+ Otherwise, it will be auto-closed in 7 days.
37
+ close-issue-message: >
38
+ 🔒 This issue was auto-closed due to inactivity for over 6 months.
39
+ close-pr-message: >
40
+ 🔒 This PR was auto-closed due to inactivity for over 6 months.
41
+ stale-issue-label: '⚰️ Stale'
42
+ close-issue-label: '🕸️ Inactive'
43
+ stale-pr-label: '⚰️ Stale'
44
+ close-pr-label: '🕸️ Inactive'
45
+ exempt-issue-labels: '📌 Keep Open'
46
+ exempt-pr-labels: '📌 Keep Open'
47
+
48
+ await-user-response:
49
+ name: ⚠️ Mark Issues/PRs Awaiting User Response
50
+ runs-on: ubuntu-latest
51
+ needs: mark-inactivity
52
+
53
+ steps:
54
+ - name: Mark Issues/PRs Awaiting User Response
55
+ # Close Stale Issues and PRs
56
+ # https://github.com/marketplace/actions/close-stale-issues
57
+ uses: actions/[email protected]
58
+ with:
59
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
60
+ days-before-stale: 7
61
+ days-before-close: 7
62
+ operations-per-run: 30
63
+ remove-stale-when-updated: true
64
+ stale-issue-message: >
65
+ ⚠️ Hey! We need some more info to move forward with this issue.
66
+ Please provide the requested details in the next few days to keep this ticket open.
67
+ close-issue-message: >
68
+ 🔒 This issue was auto-closed due to no response from user.
69
+ only-labels: '🚏 Awaiting User Response'
70
+ labels-to-remove-when-unstale: '🚏 Awaiting User Response'
71
+ stale-issue-label: '🛑 No Response'
72
+ close-issue-label: '🕸️ Inactive'
73
+ exempt-issue-labels: '🚧 Alternative Exists'
74
+
75
+ alternative-exists:
76
+ name: 🔄 Mark Issues with Alternative Exists
77
+ runs-on: ubuntu-latest
78
+ needs: await-user-response
79
+
80
+ steps:
81
+ - name: Mark Issues with Alternative Exists
82
+ # Close Stale Issues and PRs
83
+ # https://github.com/marketplace/actions/close-stale-issues
84
+ uses: actions/[email protected]
85
+ with:
86
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
87
+ days-before-stale: 7
88
+ days-before-close: 7
89
+ operations-per-run: 30
90
+ remove-stale-when-updated: true
91
+ stale-issue-message: >
92
+ 🔄 An alternative solution has been provided for this issue.
93
+ Did this solve your problem? If so, we'll go ahead and close it.
94
+ If you still need help, drop a comment within the next 7 days to keep this open.
95
+ close-issue-message: >
96
+ ✅ Closing this issue due to no confirmation on the alternative solution.
97
+ only-labels: '🚧 Alternative Exists'
98
+ stale-issue-label: '🚏 Awaiting User Response'
99
+ close-issue-label: '🕸️ Inactive'
100
+ exempt-issue-labels: '📌 Keep Open'
jiuguan2025cc/.github/workflows/npm-publish.yml ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
2
+ # For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
3
+
4
+ name: Node.js Package
5
+
6
+ on:
7
+ release:
8
+ types: [created]
9
+
10
+ jobs:
11
+ build:
12
+ runs-on: ubuntu-latest
13
+ steps:
14
+ - uses: actions/checkout@v3
15
+ - uses: actions/setup-node@v3
16
+ with:
17
+ node-version: 16
18
+ - run: npm ci
19
+
20
+ publish-npm:
21
+ needs: build
22
+ runs-on: ubuntu-latest
23
+ steps:
24
+ - uses: actions/checkout@v3
25
+ - uses: actions/setup-node@v3
26
+ with:
27
+ node-version: 16
28
+ registry-url: https://registry.npmjs.org/
29
+ - run: npm ci
30
+ - run: npm publish
31
+ env:
32
+ NODE_AUTH_TOKEN: ${{secrets.npm_token}}
jiuguan2025cc/.github/workflows/on-close-handler.yml ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 🚪 Issues/PRs On Close Handler
2
+
3
+ on:
4
+ issues:
5
+ types: [closed]
6
+ pull_request_target:
7
+ types: [closed]
8
+
9
+ permissions:
10
+ contents: read
11
+ issues: write
12
+ pull-requests: write
13
+
14
+ jobs:
15
+ remove-labels:
16
+ name: 🗑️ Remove Pending Labels on Close
17
+ runs-on: ubuntu-latest
18
+
19
+ steps:
20
+ - name: Remove Pending Labels on Close
21
+ # 🤖 Issues Helper
22
+ # https://github.com/marketplace/actions/issues-helper
23
+ uses: actions-cool/[email protected]
24
+ with:
25
+ actions: remove-labels
26
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
27
+ issue-number: ${{ github.event.issue.number || github.event.pull_request.number }}
28
+ labels: '🚏 Awaiting User Response,🧑‍💻 In Progress,📌 Keep Open,🚫 Merge Conflicts,🔬 Needs Testing,🔨 Needs Work,⚰️ Stale,⛔ Waiting For External/Upstream'
jiuguan2025cc/.github/workflows/on-open-handler.yml ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 📨 Issues/PRs Open Handler
2
+
3
+ on:
4
+ issues:
5
+ types: [opened]
6
+ pull_request_target:
7
+ types: [opened]
8
+
9
+ permissions:
10
+ contents: read
11
+ issues: write
12
+ pull-requests: write
13
+
14
+ jobs:
15
+ label-maintainer:
16
+ name: 🏷️ Label if Author is a Repo Maintainer
17
+ runs-on: ubuntu-latest
18
+ if: contains(fromJson('["Cohee1207", "RossAscends", "Wolfsblvt"]'), github.actor)
19
+
20
+ steps:
21
+ - name: Label if Author is a Repo Maintainer
22
+ # 🤖 Issues Helper
23
+ # https://github.com/marketplace/actions/issues-helper
24
+ uses: actions-cool/[email protected]
25
+ with:
26
+ actions: 'add-labels'
27
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
28
+ issue-number: ${{ github.event.issue.number || github.event.pull_request.number }}
29
+ labels: '👷 Maintainer'
jiuguan2025cc/.github/workflows/pr-auto-manager.yml ADDED
@@ -0,0 +1,212 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: 🔀 Pull Request Manager
2
+
3
+ on:
4
+ pull_request_target:
5
+ types: [opened, synchronize, reopened, edited, labeled, unlabeled, closed]
6
+ pull_request_review_comment:
7
+ types: [created]
8
+
9
+ permissions:
10
+ contents: read
11
+ pull-requests: write
12
+
13
+ jobs:
14
+ label-by-size:
15
+ name: 🏷️ Label PR by Size
16
+ runs-on: ubuntu-latest
17
+
18
+ steps:
19
+ - name: Label PR Size
20
+ # Pull Request Size Labeler
21
+ # https://github.com/marketplace/actions/pull-request-size-labeler
22
+ uses: codelytv/[email protected]
23
+ with:
24
+ GITHUB_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
25
+ xs_label: '🟩 ⬤○○○○'
26
+ xs_max_size: '20'
27
+ s_label: '🟩 ⬤⬤○○○'
28
+ s_max_size: '100'
29
+ m_label: '🟨 ⬤⬤⬤○○'
30
+ m_max_size: '500'
31
+ l_label: '🟧 ⬤⬤⬤⬤○'
32
+ l_max_size: '1000'
33
+ xl_label: '🟥 ⬤⬤⬤⬤⬤'
34
+ fail_if_xl: 'false'
35
+ github_api_url: 'https://api.github.com'
36
+ files_to_ignore: |
37
+ "package-lock.json"
38
+ "public/lib/*"
39
+
40
+ label-by-branches:
41
+ name: 🏷️ Label PR by Branches
42
+ needs: [label-by-size]
43
+ runs-on: ubuntu-latest
44
+ # Run, even if the previous jobs were skipped/failed
45
+ # Only label once when PR is created or branches are changed, to allow manual label removal
46
+ if: |
47
+ always()
48
+ && github.event.action == 'opened' || (github.event.action == 'synchronize' && (github.event.changes.base || github.event.changes.head))
49
+
50
+ steps:
51
+ - name: Checkout Repository
52
+ # Checkout
53
+ # https://github.com/marketplace/actions/checkout
54
+ uses: actions/[email protected]
55
+
56
+ - name: Apply Labels Based on Branch Name and Target Branch
57
+ # Pull Request Labeler
58
+ # https://github.com/marketplace/actions/labeler
59
+ uses: actions/[email protected]
60
+ with:
61
+ configuration-path: .github/pr-auto-labels-by-branch.yml
62
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
63
+
64
+ label-by-files:
65
+ name: 🏷️ Label PR by Files
66
+ needs: [label-by-branches]
67
+ runs-on: ubuntu-latest
68
+ # Run, even if the previous jobs were skipped/failed
69
+ if: always()
70
+
71
+ steps:
72
+ - name: Checkout Repository
73
+ # Checkout
74
+ # https://github.com/marketplace/actions/checkout
75
+ uses: actions/[email protected]
76
+
77
+ - name: Apply Labels Based on Changed Files
78
+ # Pull Request Labeler
79
+ # https://github.com/marketplace/actions/labeler
80
+ uses: actions/[email protected]
81
+ with:
82
+ configuration-path: .github/pr-auto-labels-by-files.yml
83
+ repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
84
+
85
+ remove-stale-label:
86
+ name: 🗑️ Remove Stale Label on Comment
87
+ needs: [label-by-files]
88
+ runs-on: ubuntu-latest
89
+ # Only runs when this is not done by the github actions bot
90
+ if: |
91
+ always()
92
+ && github.event_name == 'pull_request_review_comment' && github.actor != 'github-actions[bot]'
93
+
94
+ steps:
95
+ - name: Remove Stale Label
96
+ # 🤖 Issues Helper
97
+ # https://github.com/marketplace/actions/issues-helper
98
+ uses: actions-cool/[email protected]
99
+ with:
100
+ actions: 'remove-labels'
101
+ token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
102
+ issue-number: ${{ github.event.pull_request.number }}
103
+ labels: '⚰️ Stale'
104
+
105
+ check-merge-blocking-labels:
106
+ name: 🚫 Check Merge Blocking Labels
107
+ needs: [label-by-size, label-by-branches, label-by-files, remove-stale-label]
108
+ runs-on: ubuntu-latest
109
+ # Run, even if the previous jobs were skipped/failed
110
+ if: always()
111
+
112
+ # Override permissions, as this needs to write a check
113
+ permissions:
114
+ checks: write
115
+ contents: read
116
+ pull-requests: read
117
+
118
+ steps:
119
+ - name: Check Merge Blocking
120
+ # GitHub Script
121
+ # https://github.com/marketplace/actions/github-script
122
+ id: label-check
123
+ uses: actions/[email protected]
124
+ with:
125
+ script: |
126
+ const prLabels = context.payload.pull_request.labels.map(label => label.name);
127
+ const blockingLabels = [
128
+ "⛔ Don't Merge",
129
+ "🔨 Needs Work",
130
+ "🔬 Needs Testing",
131
+ "⛔ Waiting For External/Upstream",
132
+ "❗ Against Release Branch",
133
+ "💥💣 Breaking Changes"
134
+ ];
135
+ const hasBlockingLabel = prLabels.some(label => blockingLabels.includes(label));
136
+
137
+ if (hasBlockingLabel) {
138
+ console.log("Blocking label detected. Setting warning status.");
139
+ await github.rest.checks.create({
140
+ owner: context.repo.owner,
141
+ repo: context.repo.repo,
142
+ name: "PR Label Warning",
143
+ head_sha: context.payload.pull_request.head.sha,
144
+ status: "completed",
145
+ conclusion: "neutral",
146
+ output: {
147
+ title: "Potential Merge Issue",
148
+ summary: "This PR has a merge-blocking label. Proceed with caution."
149
+ }
150
+ });
151
+ } else {
152
+ console.log("No merge-blocking labels found.");
153
+ }
154
+
155
+ write-auto-comments:
156
+ name: 💬 Post PR Comments Based on Labels
157
+ needs: [label-by-size, label-by-branches, label-by-files, remove-stale-label]
158
+ runs-on: ubuntu-latest
159
+ # Run, even if the previous jobs were skipped/failed
160
+ if: always()
161
+
162
+ steps:
163
+ - name: Checkout Repository
164
+ # Checkout
165
+ # https://github.com/marketplace/actions/checkout
166
+ uses: actions/[email protected]
167
+
168
+ - name: Post PR Comments Based on Labels
169
+ # Label Commenter for PRs
170
+ # https://github.com/marketplace/actions/label-commenter
171
+ uses: peaceiris/[email protected]
172
+ with:
173
+ config_file: .github/pr-auto-comments.yml
174
+ github_token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
175
+
176
+ # This runs on merged PRs to staging, reading the PR body and directly linked issues. Check `issues-updates-on-merge.yml`:`update-linked-issues` for commit-based updates.
177
+ update-linked-issues:
178
+ name: 🔗 Mark Linked Issues Done on Staging Merge
179
+ runs-on: ubuntu-latest
180
+ if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'staging'
181
+
182
+ steps:
183
+ - name: Extract Linked Issues From PR Description
184
+ id: extract_issues
185
+ run: |
186
+ ISSUES=$(jq -r '.pull_request.body' "$GITHUB_EVENT_PATH" | grep -oiE '(close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved) #([0-9]+)' | awk '{print $2}' | tr -d '#' | jq -R -s -c 'split("\n")[:-1]')
187
+ echo "issues=$ISSUES" >> $GITHUB_ENV
188
+
189
+ - name: Fetch Directly Linked Issues
190
+ id: fetch_linked_issues
191
+ run: |
192
+ PR_NUMBER=${{ github.event.pull_request.number }}
193
+ REPO=${{ github.repository }}
194
+ API_URL="https://api.github.com/repos/$REPO/pulls/$PR_NUMBER/issues"
195
+ ISSUES=$(curl -s -H "Authorization: token ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}" "$API_URL" | jq -r '.[].number' | jq -R -s -c 'split("\n")[:-1]')
196
+ echo "linked_issues=$ISSUES" >> $GITHUB_ENV
197
+
198
+ - name: Merge Issue Lists
199
+ id: merge_issues
200
+ run: |
201
+ ISSUES=$(jq -c -n --argjson a "$issues" --argjson b "$linked_issues" '$a + $b | unique')
202
+ echo "final_issues=$ISSUES" >> $GITHUB_ENV
203
+
204
+ - name: Label Linked Issues
205
+ id: label_linked_issues
206
+ env:
207
+ GH_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
208
+ run: |
209
+ for ISSUE in $(echo $final_issues | jq -r '.[]'); do
210
+ gh issue edit $ISSUE -R ${{ github.repository }} --add-label "✅ Done (staging)"
211
+ echo "Added label '✅ Done (staging)' to issue #$ISSUE"
212
+ done
jiuguan2025cc/.github/workflows/pr-check-merge-conflicts.yaml ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: ⚔️ Check Merge Conflicts
2
+
3
+ on:
4
+ # So that PRs touching the same files as the push are updated
5
+ push:
6
+ # So that the `dirtyLabel` is removed if conflicts are resolved
7
+ pull_request_target:
8
+ types: [synchronize]
9
+
10
+ permissions:
11
+ contents: read
12
+ pull-requests: write
13
+
14
+ jobs:
15
+ check-merge-conflicts:
16
+ name: ⚔️ Check Merge Conflicts
17
+ runs-on: ubuntu-latest
18
+
19
+ steps:
20
+ - name: Check Merge Conflicts
21
+ # Label Conflicting Pull Requests
22
+ # https://github.com/marketplace/actions/label-conflicting-pull-requests
23
+ uses: eps1lon/[email protected]
24
+ with:
25
+ dirtyLabel: '🚫 Merge Conflicts'
26
+ repoToken: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
27
+ commentOnDirty: >
28
+ ⚠️ This PR has conflicts that need to be resolved before it can be merged.
jiuguan2025cc/.github/workflows/update-i18n.yaml ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Update i18n data
2
+
3
+ on: workflow_dispatch
4
+
5
+ jobs:
6
+ build:
7
+ runs-on: ubuntu-latest
8
+ permissions: # Job-level permissions configuration starts here
9
+ contents: write # 'write' access to repository contents
10
+ steps:
11
+ - name: disable auto crlf
12
+ uses: steve02081504/disable-autocrlf@v1
13
+ - uses: actions/checkout@v4
14
+ with:
15
+ ref: ${{ github.head_ref }}
16
+ fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
17
+ - name: Create local changes
18
+ run: |
19
+ aria2c https://raw.githubusercontent.com/SillyTavern/SillyTavern-i18n/main/generate.py
20
+ aria2c https://raw.githubusercontent.com/SillyTavern/SillyTavern-i18n/main/requirements.txt
21
+ pip install -r ./requirements.txt
22
+ python ./generate.py "" --sort-keys
23
+ rm -f ./generate.py ./requirements.txt
24
+ - name: add all
25
+ run: git add -A
26
+ - name: push
27
+ uses: actions-go/push@master
28
+ with:
29
+ author-email: 41898282+github-actions[bot]@users.noreply.github.com
30
+ author-name: github-actions[bot]
31
+ commit-message: 'i18n changes'
32
+ remote: origin
jiuguan2025cc/.gitignore ADDED
@@ -0,0 +1,57 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ node_modules/
2
+ public/chats/
3
+ public/characters/
4
+ public/User Avatars/
5
+ public/backgrounds/
6
+ public/groups/
7
+ public/group chats/
8
+ public/worlds/
9
+ public/user/
10
+ public/css/bg_load.css
11
+ public/themes/
12
+ public/OpenAI Settings/
13
+ public/KoboldAI Settings/
14
+ public/NovelAI Settings/
15
+ public/TextGen Settings/
16
+ public/instruct/
17
+ public/context/
18
+ public/scripts/extensions/third-party/
19
+ public/stats.json
20
+ /uploads/
21
+ *.jsonl
22
+ /config.conf
23
+ /config.yaml
24
+ /config.conf.bak
25
+ /docker/config
26
+ /docker/user
27
+ /docker/extensions
28
+ /docker/data
29
+ .DS_Store
30
+ public/settings.json
31
+ /thumbnails
32
+ whitelist.txt
33
+ .vscode/**
34
+ !.vscode/extensions.json
35
+ .idea/
36
+ secrets.json
37
+ /dist
38
+ /backups/
39
+ public/movingUI/
40
+ public/QuickReplies/
41
+ content.log
42
+ cloudflared.exe
43
+ public/assets/
44
+ access.log
45
+ /vectors/
46
+ /cache/
47
+ public/css/user.css
48
+ public/error/
49
+ /plugins/
50
+ /data
51
+ /default/scaffold
52
+ public/scripts/extensions/third-party
53
+ /certs
54
+ .aider*
55
+ .env
56
+ /StartDev.bat
57
+
jiuguan2025cc/.nomedia ADDED
File without changes
jiuguan2025cc/.npmignore ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ node_modules/
2
+ /uploads/
3
+ .DS_Store
4
+ /thumbnails
5
+ secrets.json
6
+ /dist
7
+ /backups/
8
+ /data
9
+ /cache
10
+ access.log
11
+ .github
12
+ .vscode
13
+ .git
14
+ /public/scripts/extensions/third-party
jiuguan2025cc/.replit ADDED
@@ -0,0 +1,81 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+
2
+ hidden = [".config", "package-lock.json"]
3
+ run = "chmod 755 ./start.sh && ./start.sh"
4
+ entrypoint = "server.js"
5
+
6
+ [[hints]]
7
+ regex = "Error \\[ERR_REQUIRE_ESM\\]"
8
+ message = "We see that you are using require(...) inside your code. We currently do not support this syntax. Please use 'import' instead when using external modules. (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import)"
9
+
10
+ [nix]
11
+ channel = "stable-22_11"
12
+
13
+ [env]
14
+ XDG_CONFIG_HOME = "/home/runner/$REPL_SLUG/.config"
15
+ PATH = "/home/runner/$REPL_SLUG/.config/npm/node_global/bin:/home/runner/$REPL_SLUG/node_modules/.bin"
16
+ npm_config_prefix = "/home/runner/$REPL_SLUG/.config/npm/node_global"
17
+
18
+ [gitHubImport]
19
+ requiredFiles = [".replit", "replit.nix", ".config", "package.json", "package-lock.json"]
20
+
21
+ [packager]
22
+ language = "nodejs"
23
+
24
+ [packager.features]
25
+ packageSearch = true
26
+ guessImports = true
27
+ enabledForHosting = false
28
+
29
+ [unitTest]
30
+ language = "nodejs"
31
+
32
+ [debugger]
33
+ support = true
34
+
35
+ [debugger.interactive]
36
+ transport = "localhost:0"
37
+ startCommand = [ "dap-node" ]
38
+
39
+ [debugger.interactive.initializeMessage]
40
+ command = "initialize"
41
+ type = "request"
42
+
43
+ [debugger.interactive.initializeMessage.arguments]
44
+ clientID = "replit"
45
+ clientName = "replit.com"
46
+ columnsStartAt1 = true
47
+ linesStartAt1 = true
48
+ locale = "en-us"
49
+ pathFormat = "path"
50
+ supportsInvalidatedEvent = true
51
+ supportsProgressReporting = true
52
+ supportsRunInTerminalRequest = true
53
+ supportsVariablePaging = true
54
+ supportsVariableType = true
55
+
56
+ [debugger.interactive.launchMessage]
57
+ command = "launch"
58
+ type = "request"
59
+
60
+ [debugger.interactive.launchMessage.arguments]
61
+ args = []
62
+ console = "externalTerminal"
63
+ cwd = "."
64
+ environment = []
65
+ pauseForSourceMap = false
66
+ program = "./server.js"
67
+ request = "launch"
68
+ sourceMaps = true
69
+ stopOnEntry = false
70
+ type = "pwa-node"
71
+
72
+ [languages]
73
+
74
+ [languages.javascript]
75
+ pattern = "**/{*.js,*.jsx,*.ts,*.tsx,*.json}"
76
+
77
+ [languages.javascript.languageServer]
78
+ start = "typescript-language-server --stdio"
79
+
80
+ [deployment]
81
+ run = ["sh", "-c", "./start.sh"]
jiuguan2025cc/.vscode/extensions.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
3
+ // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
4
+ // List of extensions which should be recommended for users of this workspace.
5
+ "recommendations": [
6
+ "dbaeumer.vscode-eslint",
7
+ "EditorConfig.EditorConfig",
8
+ "mrcrowl.easy-less"
9
+ ],
10
+ // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
11
+ "unwantedRecommendations": []
12
+ }
jiuguan2025cc/CONTRIBUTING.md ADDED
@@ -0,0 +1,41 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # How to contribute to SillyTavern
2
+
3
+ ## Setting up the dev environment
4
+
5
+ 1. Required software: git and node.
6
+ 2. Recommended editor: Visual Studio Code.
7
+ 3. You can also use GitHub Codespaces which sets up everything for you.
8
+
9
+ ## Getting the code ready
10
+
11
+ 1. Register a GitHub account.
12
+ 2. Fork this repository under your account.
13
+ 3. Clone the fork onto your machine.
14
+ 4. Open the cloned repository in the code editor.
15
+ 5. Create a git branch (recommended).
16
+ 6. Make your changes and test them locally.
17
+ 7. Commit the changes and push the branch to the remote repo.
18
+ 8. Go to GitHub, and open a pull request, targeting the upstream branch.
19
+
20
+ ## Contribution guidelines
21
+
22
+ 1. Our standards are pretty low, but make sure the code is not too ugly:
23
+ - Run VS Code's autoformat when you're done.
24
+ - Check with ESLint by running `npm run lint`, then fix the errors.
25
+ - Use common sense and follow existing naming conventions.
26
+ 2. Create pull requests for the staging branch, 99% of contributions should go there. That way people could test your code before the next stable release.
27
+ 3. You can still send a pull request for release in the following scenarios:
28
+ - Updating README.
29
+ - Updating GitHub Actions.
30
+ - Hotfixing a critical bug.
31
+ 4. Project maintainers will test and can change your code before merging.
32
+ 5. Write at least somewhat meaningful PR descriptions. There's no "right" way to do it, but the following may help with outlining a general structure:
33
+ - What is the reason for a change?
34
+ - What did you do to achieve this?
35
+ - How would a reviewer test the change?
36
+ 6. Mind the license. Your contributions will be licensed under the GNU Affero General Public License. If you don't know what that implies, consult your lawyer.
37
+
38
+ ## Further reading
39
+
40
+ 1. [How to write UI extensions](https://docs.sillytavern.app/for-contributors/writing-extensions/)
41
+ 2. [How to write server plugins](https://docs.sillytavern.app/for-contributors/server-plugins)
jiuguan2025cc/Dockerfile ADDED
@@ -0,0 +1,51 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ FROM node:lts-alpine3.19
2
+
3
+ # Arguments
4
+ ARG APP_HOME=/home/node/app
5
+
6
+ # Install system dependencies
7
+ RUN apk add --no-cache gcompat tini git
8
+
9
+ # Create app directory
10
+ WORKDIR ${APP_HOME}
11
+
12
+ # Set NODE_ENV to production
13
+ ENV NODE_ENV=production
14
+
15
+ # Install app dependencies
16
+ COPY package*.json post-install.js ./
17
+ RUN \
18
+ echo "*** Install npm packages ***" && \
19
+ npm i --no-audit --no-fund --loglevel=error --no-progress --omit=dev && npm cache clean --force
20
+
21
+ # Bundle app source
22
+ COPY . ./
23
+
24
+ # Copy default chats, characters and user avatars to <folder>.default folder
25
+ RUN \
26
+ rm -f "config.yaml" || true && \
27
+ ln -s "./config/config.yaml" "config.yaml" || true && \
28
+ mkdir "config" || true
29
+
30
+ # Pre-compile public libraries
31
+ RUN \
32
+ echo "*** Run Webpack ***" && \
33
+ node "./docker/build-lib.js"
34
+
35
+ # Cleanup unnecessary files
36
+ RUN \
37
+ echo "*** Cleanup ***" && \
38
+ mv "./docker/docker-entrypoint.sh" "./" && \
39
+ rm -rf "./docker" && \
40
+ echo "*** Make docker-entrypoint.sh executable ***" && \
41
+ chmod +x "./docker-entrypoint.sh" && \
42
+ echo "*** Convert line endings to Unix format ***" && \
43
+ dos2unix "./docker-entrypoint.sh"
44
+
45
+ # Fix extension repos permissions
46
+ RUN git config --global --add safe.directory "*"
47
+
48
+ EXPOSE 8000
49
+
50
+ # Ensure proper handling of kernel signals
51
+ ENTRYPOINT ["tini", "--", "./docker-entrypoint.sh"]
jiuguan2025cc/LICENSE ADDED
@@ -0,0 +1,661 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ GNU AFFERO GENERAL PUBLIC LICENSE
2
+ Version 3, 19 November 2007
3
+
4
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
5
+ Everyone is permitted to copy and distribute verbatim copies
6
+ of this license document, but changing it is not allowed.
7
+
8
+ Preamble
9
+
10
+ The GNU Affero General Public License is a free, copyleft license for
11
+ software and other kinds of works, specifically designed to ensure
12
+ cooperation with the community in the case of network server software.
13
+
14
+ The licenses for most software and other practical works are designed
15
+ to take away your freedom to share and change the works. By contrast,
16
+ our General Public Licenses are intended to guarantee your freedom to
17
+ share and change all versions of a program--to make sure it remains free
18
+ software for all its users.
19
+
20
+ When we speak of free software, we are referring to freedom, not
21
+ price. Our General Public Licenses are designed to make sure that you
22
+ have the freedom to distribute copies of free software (and charge for
23
+ them if you wish), that you receive source code or can get it if you
24
+ want it, that you can change the software or use pieces of it in new
25
+ free programs, and that you know you can do these things.
26
+
27
+ Developers that use our General Public Licenses protect your rights
28
+ with two steps: (1) assert copyright on the software, and (2) offer
29
+ you this License which gives you legal permission to copy, distribute
30
+ and/or modify the software.
31
+
32
+ A secondary benefit of defending all users' freedom is that
33
+ improvements made in alternate versions of the program, if they
34
+ receive widespread use, become available for other developers to
35
+ incorporate. Many developers of free software are heartened and
36
+ encouraged by the resulting cooperation. However, in the case of
37
+ software used on network servers, this result may fail to come about.
38
+ The GNU General Public License permits making a modified version and
39
+ letting the public access it on a server without ever releasing its
40
+ source code to the public.
41
+
42
+ The GNU Affero General Public License is designed specifically to
43
+ ensure that, in such cases, the modified source code becomes available
44
+ to the community. It requires the operator of a network server to
45
+ provide the source code of the modified version running there to the
46
+ users of that server. Therefore, public use of a modified version, on
47
+ a publicly accessible server, gives the public access to the source
48
+ code of the modified version.
49
+
50
+ An older license, called the Affero General Public License and
51
+ published by Affero, was designed to accomplish similar goals. This is
52
+ a different license, not a version of the Affero GPL, but Affero has
53
+ released a new version of the Affero GPL which permits relicensing under
54
+ this license.
55
+
56
+ The precise terms and conditions for copying, distribution and
57
+ modification follow.
58
+
59
+ TERMS AND CONDITIONS
60
+
61
+ 0. Definitions.
62
+
63
+ "This License" refers to version 3 of the GNU Affero General Public License.
64
+
65
+ "Copyright" also means copyright-like laws that apply to other kinds of
66
+ works, such as semiconductor masks.
67
+
68
+ "The Program" refers to any copyrightable work licensed under this
69
+ License. Each licensee is addressed as "you". "Licensees" and
70
+ "recipients" may be individuals or organizations.
71
+
72
+ To "modify" a work means to copy from or adapt all or part of the work
73
+ in a fashion requiring copyright permission, other than the making of an
74
+ exact copy. The resulting work is called a "modified version" of the
75
+ earlier work or a work "based on" the earlier work.
76
+
77
+ A "covered work" means either the unmodified Program or a work based
78
+ on the Program.
79
+
80
+ To "propagate" a work means to do anything with it that, without
81
+ permission, would make you directly or secondarily liable for
82
+ infringement under applicable copyright law, except executing it on a
83
+ computer or modifying a private copy. Propagation includes copying,
84
+ distribution (with or without modification), making available to the
85
+ public, and in some countries other activities as well.
86
+
87
+ To "convey" a work means any kind of propagation that enables other
88
+ parties to make or receive copies. Mere interaction with a user through
89
+ a computer network, with no transfer of a copy, is not conveying.
90
+
91
+ An interactive user interface displays "Appropriate Legal Notices"
92
+ to the extent that it includes a convenient and prominently visible
93
+ feature that (1) displays an appropriate copyright notice, and (2)
94
+ tells the user that there is no warranty for the work (except to the
95
+ extent that warranties are provided), that licensees may convey the
96
+ work under this License, and how to view a copy of this License. If
97
+ the interface presents a list of user commands or options, such as a
98
+ menu, a prominent item in the list meets this criterion.
99
+
100
+ 1. Source Code.
101
+
102
+ The "source code" for a work means the preferred form of the work
103
+ for making modifications to it. "Object code" means any non-source
104
+ form of a work.
105
+
106
+ A "Standard Interface" means an interface that either is an official
107
+ standard defined by a recognized standards body, or, in the case of
108
+ interfaces specified for a particular programming language, one that
109
+ is widely used among developers working in that language.
110
+
111
+ The "System Libraries" of an executable work include anything, other
112
+ than the work as a whole, that (a) is included in the normal form of
113
+ packaging a Major Component, but which is not part of that Major
114
+ Component, and (b) serves only to enable use of the work with that
115
+ Major Component, or to implement a Standard Interface for which an
116
+ implementation is available to the public in source code form. A
117
+ "Major Component", in this context, means a major essential component
118
+ (kernel, window system, and so on) of the specific operating system
119
+ (if any) on which the executable work runs, or a compiler used to
120
+ produce the work, or an object code interpreter used to run it.
121
+
122
+ The "Corresponding Source" for a work in object code form means all
123
+ the source code needed to generate, install, and (for an executable
124
+ work) run the object code and to modify the work, including scripts to
125
+ control those activities. However, it does not include the work's
126
+ System Libraries, or general-purpose tools or generally available free
127
+ programs which are used unmodified in performing those activities but
128
+ which are not part of the work. For example, Corresponding Source
129
+ includes interface definition files associated with source files for
130
+ the work, and the source code for shared libraries and dynamically
131
+ linked subprograms that the work is specifically designed to require,
132
+ such as by intimate data communication or control flow between those
133
+ subprograms and other parts of the work.
134
+
135
+ The Corresponding Source need not include anything that users
136
+ can regenerate automatically from other parts of the Corresponding
137
+ Source.
138
+
139
+ The Corresponding Source for a work in source code form is that
140
+ same work.
141
+
142
+ 2. Basic Permissions.
143
+
144
+ All rights granted under this License are granted for the term of
145
+ copyright on the Program, and are irrevocable provided the stated
146
+ conditions are met. This License explicitly affirms your unlimited
147
+ permission to run the unmodified Program. The output from running a
148
+ covered work is covered by this License only if the output, given its
149
+ content, constitutes a covered work. This License acknowledges your
150
+ rights of fair use or other equivalent, as provided by copyright law.
151
+
152
+ You may make, run and propagate covered works that you do not
153
+ convey, without conditions so long as your license otherwise remains
154
+ in force. You may convey covered works to others for the sole purpose
155
+ of having them make modifications exclusively for you, or provide you
156
+ with facilities for running those works, provided that you comply with
157
+ the terms of this License in conveying all material for which you do
158
+ not control copyright. Those thus making or running the covered works
159
+ for you must do so exclusively on your behalf, under your direction
160
+ and control, on terms that prohibit them from making any copies of
161
+ your copyrighted material outside their relationship with you.
162
+
163
+ Conveying under any other circumstances is permitted solely under
164
+ the conditions stated below. Sublicensing is not allowed; section 10
165
+ makes it unnecessary.
166
+
167
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
168
+
169
+ No covered work shall be deemed part of an effective technological
170
+ measure under any applicable law fulfilling obligations under article
171
+ 11 of the WIPO copyright treaty adopted on 20 December 1996, or
172
+ similar laws prohibiting or restricting circumvention of such
173
+ measures.
174
+
175
+ When you convey a covered work, you waive any legal power to forbid
176
+ circumvention of technological measures to the extent such circumvention
177
+ is effected by exercising rights under this License with respect to
178
+ the covered work, and you disclaim any intention to limit operation or
179
+ modification of the work as a means of enforcing, against the work's
180
+ users, your or third parties' legal rights to forbid circumvention of
181
+ technological measures.
182
+
183
+ 4. Conveying Verbatim Copies.
184
+
185
+ You may convey verbatim copies of the Program's source code as you
186
+ receive it, in any medium, provided that you conspicuously and
187
+ appropriately publish on each copy an appropriate copyright notice;
188
+ keep intact all notices stating that this License and any
189
+ non-permissive terms added in accord with section 7 apply to the code;
190
+ keep intact all notices of the absence of any warranty; and give all
191
+ recipients a copy of this License along with the Program.
192
+
193
+ You may charge any price or no price for each copy that you convey,
194
+ and you may offer support or warranty protection for a fee.
195
+
196
+ 5. Conveying Modified Source Versions.
197
+
198
+ You may convey a work based on the Program, or the modifications to
199
+ produce it from the Program, in the form of source code under the
200
+ terms of section 4, provided that you also meet all of these conditions:
201
+
202
+ a) The work must carry prominent notices stating that you modified
203
+ it, and giving a relevant date.
204
+
205
+ b) The work must carry prominent notices stating that it is
206
+ released under this License and any conditions added under section
207
+ 7. This requirement modifies the requirement in section 4 to
208
+ "keep intact all notices".
209
+
210
+ c) You must license the entire work, as a whole, under this
211
+ License to anyone who comes into possession of a copy. This
212
+ License will therefore apply, along with any applicable section 7
213
+ additional terms, to the whole of the work, and all its parts,
214
+ regardless of how they are packaged. This License gives no
215
+ permission to license the work in any other way, but it does not
216
+ invalidate such permission if you have separately received it.
217
+
218
+ d) If the work has interactive user interfaces, each must display
219
+ Appropriate Legal Notices; however, if the Program has interactive
220
+ interfaces that do not display Appropriate Legal Notices, your
221
+ work need not make them do so.
222
+
223
+ A compilation of a covered work with other separate and independent
224
+ works, which are not by their nature extensions of the covered work,
225
+ and which are not combined with it such as to form a larger program,
226
+ in or on a volume of a storage or distribution medium, is called an
227
+ "aggregate" if the compilation and its resulting copyright are not
228
+ used to limit the access or legal rights of the compilation's users
229
+ beyond what the individual works permit. Inclusion of a covered work
230
+ in an aggregate does not cause this License to apply to the other
231
+ parts of the aggregate.
232
+
233
+ 6. Conveying Non-Source Forms.
234
+
235
+ You may convey a covered work in object code form under the terms
236
+ of sections 4 and 5, provided that you also convey the
237
+ machine-readable Corresponding Source under the terms of this License,
238
+ in one of these ways:
239
+
240
+ a) Convey the object code in, or embodied in, a physical product
241
+ (including a physical distribution medium), accompanied by the
242
+ Corresponding Source fixed on a durable physical medium
243
+ customarily used for software interchange.
244
+
245
+ b) Convey the object code in, or embodied in, a physical product
246
+ (including a physical distribution medium), accompanied by a
247
+ written offer, valid for at least three years and valid for as
248
+ long as you offer spare parts or customer support for that product
249
+ model, to give anyone who possesses the object code either (1) a
250
+ copy of the Corresponding Source for all the software in the
251
+ product that is covered by this License, on a durable physical
252
+ medium customarily used for software interchange, for a price no
253
+ more than your reasonable cost of physically performing this
254
+ conveying of source, or (2) access to copy the
255
+ Corresponding Source from a network server at no charge.
256
+
257
+ c) Convey individual copies of the object code with a copy of the
258
+ written offer to provide the Corresponding Source. This
259
+ alternative is allowed only occasionally and noncommercially, and
260
+ only if you received the object code with such an offer, in accord
261
+ with subsection 6b.
262
+
263
+ d) Convey the object code by offering access from a designated
264
+ place (gratis or for a charge), and offer equivalent access to the
265
+ Corresponding Source in the same way through the same place at no
266
+ further charge. You need not require recipients to copy the
267
+ Corresponding Source along with the object code. If the place to
268
+ copy the object code is a network server, the Corresponding Source
269
+ may be on a different server (operated by you or a third party)
270
+ that supports equivalent copying facilities, provided you maintain
271
+ clear directions next to the object code saying where to find the
272
+ Corresponding Source. Regardless of what server hosts the
273
+ Corresponding Source, you remain obligated to ensure that it is
274
+ available for as long as needed to satisfy these requirements.
275
+
276
+ e) Convey the object code using peer-to-peer transmission, provided
277
+ you inform other peers where the object code and Corresponding
278
+ Source of the work are being offered to the general public at no
279
+ charge under subsection 6d.
280
+
281
+ A separable portion of the object code, whose source code is excluded
282
+ from the Corresponding Source as a System Library, need not be
283
+ included in conveying the object code work.
284
+
285
+ A "User Product" is either (1) a "consumer product", which means any
286
+ tangible personal property which is normally used for personal, family,
287
+ or household purposes, or (2) anything designed or sold for incorporation
288
+ into a dwelling. In determining whether a product is a consumer product,
289
+ doubtful cases shall be resolved in favor of coverage. For a particular
290
+ product received by a particular user, "normally used" refers to a
291
+ typical or common use of that class of product, regardless of the status
292
+ of the particular user or of the way in which the particular user
293
+ actually uses, or expects or is expected to use, the product. A product
294
+ is a consumer product regardless of whether the product has substantial
295
+ commercial, industrial or non-consumer uses, unless such uses represent
296
+ the only significant mode of use of the product.
297
+
298
+ "Installation Information" for a User Product means any methods,
299
+ procedures, authorization keys, or other information required to install
300
+ and execute modified versions of a covered work in that User Product from
301
+ a modified version of its Corresponding Source. The information must
302
+ suffice to ensure that the continued functioning of the modified object
303
+ code is in no case prevented or interfered with solely because
304
+ modification has been made.
305
+
306
+ If you convey an object code work under this section in, or with, or
307
+ specifically for use in, a User Product, and the conveying occurs as
308
+ part of a transaction in which the right of possession and use of the
309
+ User Product is transferred to the recipient in perpetuity or for a
310
+ fixed term (regardless of how the transaction is characterized), the
311
+ Corresponding Source conveyed under this section must be accompanied
312
+ by the Installation Information. But this requirement does not apply
313
+ if neither you nor any third party retains the ability to install
314
+ modified object code on the User Product (for example, the work has
315
+ been installed in ROM).
316
+
317
+ The requirement to provide Installation Information does not include a
318
+ requirement to continue to provide support service, warranty, or updates
319
+ for a work that has been modified or installed by the recipient, or for
320
+ the User Product in which it has been modified or installed. Access to a
321
+ network may be denied when the modification itself materially and
322
+ adversely affects the operation of the network or violates the rules and
323
+ protocols for communication across the network.
324
+
325
+ Corresponding Source conveyed, and Installation Information provided,
326
+ in accord with this section must be in a format that is publicly
327
+ documented (and with an implementation available to the public in
328
+ source code form), and must require no special password or key for
329
+ unpacking, reading or copying.
330
+
331
+ 7. Additional Terms.
332
+
333
+ "Additional permissions" are terms that supplement the terms of this
334
+ License by making exceptions from one or more of its conditions.
335
+ Additional permissions that are applicable to the entire Program shall
336
+ be treated as though they were included in this License, to the extent
337
+ that they are valid under applicable law. If additional permissions
338
+ apply only to part of the Program, that part may be used separately
339
+ under those permissions, but the entire Program remains governed by
340
+ this License without regard to the additional permissions.
341
+
342
+ When you convey a copy of a covered work, you may at your option
343
+ remove any additional permissions from that copy, or from any part of
344
+ it. (Additional permissions may be written to require their own
345
+ removal in certain cases when you modify the work.) You may place
346
+ additional permissions on material, added by you to a covered work,
347
+ for which you have or can give appropriate copyright permission.
348
+
349
+ Notwithstanding any other provision of this License, for material you
350
+ add to a covered work, you may (if authorized by the copyright holders of
351
+ that material) supplement the terms of this License with terms:
352
+
353
+ a) Disclaiming warranty or limiting liability differently from the
354
+ terms of sections 15 and 16 of this License; or
355
+
356
+ b) Requiring preservation of specified reasonable legal notices or
357
+ author attributions in that material or in the Appropriate Legal
358
+ Notices displayed by works containing it; or
359
+
360
+ c) Prohibiting misrepresentation of the origin of that material, or
361
+ requiring that modified versions of such material be marked in
362
+ reasonable ways as different from the original version; or
363
+
364
+ d) Limiting the use for publicity purposes of names of licensors or
365
+ authors of the material; or
366
+
367
+ e) Declining to grant rights under trademark law for use of some
368
+ trade names, trademarks, or service marks; or
369
+
370
+ f) Requiring indemnification of licensors and authors of that
371
+ material by anyone who conveys the material (or modified versions of
372
+ it) with contractual assumptions of liability to the recipient, for
373
+ any liability that these contractual assumptions directly impose on
374
+ those licensors and authors.
375
+
376
+ All other non-permissive additional terms are considered "further
377
+ restrictions" within the meaning of section 10. If the Program as you
378
+ received it, or any part of it, contains a notice stating that it is
379
+ governed by this License along with a term that is a further
380
+ restriction, you may remove that term. If a license document contains
381
+ a further restriction but permits relicensing or conveying under this
382
+ License, you may add to a covered work material governed by the terms
383
+ of that license document, provided that the further restriction does
384
+ not survive such relicensing or conveying.
385
+
386
+ If you add terms to a covered work in accord with this section, you
387
+ must place, in the relevant source files, a statement of the
388
+ additional terms that apply to those files, or a notice indicating
389
+ where to find the applicable terms.
390
+
391
+ Additional terms, permissive or non-permissive, may be stated in the
392
+ form of a separately written license, or stated as exceptions;
393
+ the above requirements apply either way.
394
+
395
+ 8. Termination.
396
+
397
+ You may not propagate or modify a covered work except as expressly
398
+ provided under this License. Any attempt otherwise to propagate or
399
+ modify it is void, and will automatically terminate your rights under
400
+ this License (including any patent licenses granted under the third
401
+ paragraph of section 11).
402
+
403
+ However, if you cease all violation of this License, then your
404
+ license from a particular copyright holder is reinstated (a)
405
+ provisionally, unless and until the copyright holder explicitly and
406
+ finally terminates your license, and (b) permanently, if the copyright
407
+ holder fails to notify you of the violation by some reasonable means
408
+ prior to 60 days after the cessation.
409
+
410
+ Moreover, your license from a particular copyright holder is
411
+ reinstated permanently if the copyright holder notifies you of the
412
+ violation by some reasonable means, this is the first time you have
413
+ received notice of violation of this License (for any work) from that
414
+ copyright holder, and you cure the violation prior to 30 days after
415
+ your receipt of the notice.
416
+
417
+ Termination of your rights under this section does not terminate the
418
+ licenses of parties who have received copies or rights from you under
419
+ this License. If your rights have been terminated and not permanently
420
+ reinstated, you do not qualify to receive new licenses for the same
421
+ material under section 10.
422
+
423
+ 9. Acceptance Not Required for Having Copies.
424
+
425
+ You are not required to accept this License in order to receive or
426
+ run a copy of the Program. Ancillary propagation of a covered work
427
+ occurring solely as a consequence of using peer-to-peer transmission
428
+ to receive a copy likewise does not require acceptance. However,
429
+ nothing other than this License grants you permission to propagate or
430
+ modify any covered work. These actions infringe copyright if you do
431
+ not accept this License. Therefore, by modifying or propagating a
432
+ covered work, you indicate your acceptance of this License to do so.
433
+
434
+ 10. Automatic Licensing of Downstream Recipients.
435
+
436
+ Each time you convey a covered work, the recipient automatically
437
+ receives a license from the original licensors, to run, modify and
438
+ propagate that work, subject to this License. You are not responsible
439
+ for enforcing compliance by third parties with this License.
440
+
441
+ An "entity transaction" is a transaction transferring control of an
442
+ organization, or substantially all assets of one, or subdividing an
443
+ organization, or merging organizations. If propagation of a covered
444
+ work results from an entity transaction, each party to that
445
+ transaction who receives a copy of the work also receives whatever
446
+ licenses to the work the party's predecessor in interest had or could
447
+ give under the previous paragraph, plus a right to possession of the
448
+ Corresponding Source of the work from the predecessor in interest, if
449
+ the predecessor has it or can get it with reasonable efforts.
450
+
451
+ You may not impose any further restrictions on the exercise of the
452
+ rights granted or affirmed under this License. For example, you may
453
+ not impose a license fee, royalty, or other charge for exercise of
454
+ rights granted under this License, and you may not initiate litigation
455
+ (including a cross-claim or counterclaim in a lawsuit) alleging that
456
+ any patent claim is infringed by making, using, selling, offering for
457
+ sale, or importing the Program or any portion of it.
458
+
459
+ 11. Patents.
460
+
461
+ A "contributor" is a copyright holder who authorizes use under this
462
+ License of the Program or a work on which the Program is based. The
463
+ work thus licensed is called the contributor's "contributor version".
464
+
465
+ A contributor's "essential patent claims" are all patent claims
466
+ owned or controlled by the contributor, whether already acquired or
467
+ hereafter acquired, that would be infringed by some manner, permitted
468
+ by this License, of making, using, or selling its contributor version,
469
+ but do not include claims that would be infringed only as a
470
+ consequence of further modification of the contributor version. For
471
+ purposes of this definition, "control" includes the right to grant
472
+ patent sublicenses in a manner consistent with the requirements of
473
+ this License.
474
+
475
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
476
+ patent license under the contributor's essential patent claims, to
477
+ make, use, sell, offer for sale, import and otherwise run, modify and
478
+ propagate the contents of its contributor version.
479
+
480
+ In the following three paragraphs, a "patent license" is any express
481
+ agreement or commitment, however denominated, not to enforce a patent
482
+ (such as an express permission to practice a patent or covenant not to
483
+ sue for patent infringement). To "grant" such a patent license to a
484
+ party means to make such an agreement or commitment not to enforce a
485
+ patent against the party.
486
+
487
+ If you convey a covered work, knowingly relying on a patent license,
488
+ and the Corresponding Source of the work is not available for anyone
489
+ to copy, free of charge and under the terms of this License, through a
490
+ publicly available network server or other readily accessible means,
491
+ then you must either (1) cause the Corresponding Source to be so
492
+ available, or (2) arrange to deprive yourself of the benefit of the
493
+ patent license for this particular work, or (3) arrange, in a manner
494
+ consistent with the requirements of this License, to extend the patent
495
+ license to downstream recipients. "Knowingly relying" means you have
496
+ actual knowledge that, but for the patent license, your conveying the
497
+ covered work in a country, or your recipient's use of the covered work
498
+ in a country, would infringe one or more identifiable patents in that
499
+ country that you have reason to believe are valid.
500
+
501
+ If, pursuant to or in connection with a single transaction or
502
+ arrangement, you convey, or propagate by procuring conveyance of, a
503
+ covered work, and grant a patent license to some of the parties
504
+ receiving the covered work authorizing them to use, propagate, modify
505
+ or convey a specific copy of the covered work, then the patent license
506
+ you grant is automatically extended to all recipients of the covered
507
+ work and works based on it.
508
+
509
+ A patent license is "discriminatory" if it does not include within
510
+ the scope of its coverage, prohibits the exercise of, or is
511
+ conditioned on the non-exercise of one or more of the rights that are
512
+ specifically granted under this License. You may not convey a covered
513
+ work if you are a party to an arrangement with a third party that is
514
+ in the business of distributing software, under which you make payment
515
+ to the third party based on the extent of your activity of conveying
516
+ the work, and under which the third party grants, to any of the
517
+ parties who would receive the covered work from you, a discriminatory
518
+ patent license (a) in connection with copies of the covered work
519
+ conveyed by you (or copies made from those copies), or (b) primarily
520
+ for and in connection with specific products or compilations that
521
+ contain the covered work, unless you entered into that arrangement,
522
+ or that patent license was granted, prior to 28 March 2007.
523
+
524
+ Nothing in this License shall be construed as excluding or limiting
525
+ any implied license or other defenses to infringement that may
526
+ otherwise be available to you under applicable patent law.
527
+
528
+ 12. No Surrender of Others' Freedom.
529
+
530
+ If conditions are imposed on you (whether by court order, agreement or
531
+ otherwise) that contradict the conditions of this License, they do not
532
+ excuse you from the conditions of this License. If you cannot convey a
533
+ covered work so as to satisfy simultaneously your obligations under this
534
+ License and any other pertinent obligations, then as a consequence you may
535
+ not convey it at all. For example, if you agree to terms that obligate you
536
+ to collect a royalty for further conveying from those to whom you convey
537
+ the Program, the only way you could satisfy both those terms and this
538
+ License would be to refrain entirely from conveying the Program.
539
+
540
+ 13. Remote Network Interaction; Use with the GNU General Public License.
541
+
542
+ Notwithstanding any other provision of this License, if you modify the
543
+ Program, your modified version must prominently offer all users
544
+ interacting with it remotely through a computer network (if your version
545
+ supports such interaction) an opportunity to receive the Corresponding
546
+ Source of your version by providing access to the Corresponding Source
547
+ from a network server at no charge, through some standard or customary
548
+ means of facilitating copying of software. This Corresponding Source
549
+ shall include the Corresponding Source for any work covered by version 3
550
+ of the GNU General Public License that is incorporated pursuant to the
551
+ following paragraph.
552
+
553
+ Notwithstanding any other provision of this License, you have
554
+ permission to link or combine any covered work with a work licensed
555
+ under version 3 of the GNU General Public License into a single
556
+ combined work, and to convey the resulting work. The terms of this
557
+ License will continue to apply to the part which is the covered work,
558
+ but the work with which it is combined will remain governed by version
559
+ 3 of the GNU General Public License.
560
+
561
+ 14. Revised Versions of this License.
562
+
563
+ The Free Software Foundation may publish revised and/or new versions of
564
+ the GNU Affero General Public License from time to time. Such new versions
565
+ will be similar in spirit to the present version, but may differ in detail to
566
+ address new problems or concerns.
567
+
568
+ Each version is given a distinguishing version number. If the
569
+ Program specifies that a certain numbered version of the GNU Affero General
570
+ Public License "or any later version" applies to it, you have the
571
+ option of following the terms and conditions either of that numbered
572
+ version or of any later version published by the Free Software
573
+ Foundation. If the Program does not specify a version number of the
574
+ GNU Affero General Public License, you may choose any version ever published
575
+ by the Free Software Foundation.
576
+
577
+ If the Program specifies that a proxy can decide which future
578
+ versions of the GNU Affero General Public License can be used, that proxy's
579
+ public statement of acceptance of a version permanently authorizes you
580
+ to choose that version for the Program.
581
+
582
+ Later license versions may give you additional or different
583
+ permissions. However, no additional obligations are imposed on any
584
+ author or copyright holder as a result of your choosing to follow a
585
+ later version.
586
+
587
+ 15. Disclaimer of Warranty.
588
+
589
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
590
+ APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
591
+ HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
592
+ OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
593
+ THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
594
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
595
+ IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
596
+ ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
597
+
598
+ 16. Limitation of Liability.
599
+
600
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
601
+ WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
602
+ THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
603
+ GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
604
+ USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
605
+ DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
606
+ PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
607
+ EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
608
+ SUCH DAMAGES.
609
+
610
+ 17. Interpretation of Sections 15 and 16.
611
+
612
+ If the disclaimer of warranty and limitation of liability provided
613
+ above cannot be given local legal effect according to their terms,
614
+ reviewing courts shall apply local law that most closely approximates
615
+ an absolute waiver of all civil liability in connection with the
616
+ Program, unless a warranty or assumption of liability accompanies a
617
+ copy of the Program in return for a fee.
618
+
619
+ END OF TERMS AND CONDITIONS
620
+
621
+ How to Apply These Terms to Your New Programs
622
+
623
+ If you develop a new program, and you want it to be of the greatest
624
+ possible use to the public, the best way to achieve this is to make it
625
+ free software which everyone can redistribute and change under these terms.
626
+
627
+ To do so, attach the following notices to the program. It is safest
628
+ to attach them to the start of each source file to most effectively
629
+ state the exclusion of warranty; and each file should have at least
630
+ the "copyright" line and a pointer to where the full notice is found.
631
+
632
+ <one line to give the program's name and a brief idea of what it does.>
633
+ Copyright (C) <year> <name of author>
634
+
635
+ This program is free software: you can redistribute it and/or modify
636
+ it under the terms of the GNU Affero General Public License as published
637
+ by the Free Software Foundation, either version 3 of the License, or
638
+ (at your option) any later version.
639
+
640
+ This program is distributed in the hope that it will be useful,
641
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
642
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
643
+ GNU Affero General Public License for more details.
644
+
645
+ You should have received a copy of the GNU Affero General Public License
646
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
647
+
648
+ Also add information on how to contact you by electronic and paper mail.
649
+
650
+ If your software can interact with users remotely through a computer
651
+ network, you should also make sure that it provides a way for users to
652
+ get its source. For example, if your program is a web application, its
653
+ interface could display a "Source" link that leads users to an archive
654
+ of the code. There are many ways you could offer source, and different
655
+ solutions will be better for different programs; see section 13 for the
656
+ specific requirements.
657
+
658
+ You should also get your employer (if you work as a programmer) or school,
659
+ if any, to sign a "copyright disclaimer" for the program, if necessary.
660
+ For more information on this, and how to apply and follow the GNU AGPL, see
661
+ <https://www.gnu.org/licenses/>.
jiuguan2025cc/Remote-Link.cmd ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ echo ========================================================================================================================
3
+ echo WARNING: Cloudflare Tunnel!
4
+ echo ========================================================================================================================
5
+ echo This script downloads and runs the latest cloudflared.exe from Cloudflare to set up an HTTPS tunnel to your SillyTavern!
6
+ echo Using the randomly generated temporary tunnel URL, anyone can access your SillyTavern over the Internet while the tunnel
7
+ echo is active. Keep the URL safe and secure your SillyTavern installation by setting a username and password in config.yaml!
8
+ echo.
9
+ echo See https://docs.sillytavern.app/usage/remoteconnections/ for more details about how to secure your SillyTavern install.
10
+ echo.
11
+ echo By continuing you confirm that you're aware of the potential dangers of having a tunnel open and take all responsibility
12
+ echo to properly use and secure it!
13
+ echo.
14
+ echo To abort, press Ctrl+C or close this window now!
15
+ echo.
16
+ pause
17
+ if not exist cloudflared.exe curl -Lo cloudflared.exe https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-windows-amd64.exe
18
+ cloudflared.exe tunnel --url localhost:8000
jiuguan2025cc/SECURITY.md ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Security Policy
2
+
3
+ We take the security of this project seriously. If you discover any security vulnerabilities or have concerns regarding the security of this repository, please reach out to us immediately. We appreciate your efforts in responsibly disclosing the issue and will make every effort to address it promptly.
4
+
5
+ ## Reporting a Vulnerability
6
+
7
+ To report a security vulnerability, please follow these steps:
8
+
9
+ 1. Go to the **Security** tab of this repository on GitHub.
10
+ 2. Click on **"Report a vulnerability"**.
11
+ 3. Provide a clear description of the vulnerability and its potential impact. Be as detailed as possible.
12
+ 4. If applicable, include steps or a PoC (Proof of Concept) to reproduce the vulnerability.
13
+ 5. Submit the report.
14
+
15
+ Once we receive the private report notification, we will promptly investigate and assess the reported vulnerability.
16
+
17
+ Please do not disclose any potential vulnerabilities in public repositories, issue trackers, or forums until we have had a chance to review and address the issue.
18
+
19
+ ## Scope
20
+
21
+ This security policy applies to all the code and files within this repository and its dependencies actively maintained by us. If you encounter a security issue in a dependency that is not directly maintained by us, please follow responsible disclosure practices and report it to the respective project.
22
+
23
+ While we strive to ensure the security of this project, please note that there may be limitations on resources, response times, and mitigations.
24
+
25
+ Thank you for your help in making this project more secure.
jiuguan2025cc/Start.bat ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ pushd %~dp0
3
+ set NODE_ENV=production
4
+ call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
5
+ node server.js %*
6
+ pause
7
+ popd
jiuguan2025cc/Update-Instructions.txt ADDED
@@ -0,0 +1,75 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ How to Update SillyTavern
2
+
3
+ The most recent version can be found here: https://docs.sillytavern.app/usage/update/
4
+
5
+ This is not an installation guide. If you need installation instructions, look here:
6
+ https://docs.sillytavern.app/installation/windows/
7
+
8
+ This guide assumes you have already installed SillyTavern once, and know how to run it on your OS.
9
+
10
+ Linux/Termux:
11
+
12
+ You definitely installed via git, so just 'git pull' inside the SillyTavern directory.
13
+
14
+ Windows/MacOS:
15
+
16
+ Method 1 - GIT
17
+
18
+ We always recommend users install using 'git'. Here's why:
19
+
20
+ When you have installed via `git clone`, all you have to do to update is type `git pull` in a command line in the ST folder.
21
+ You can also try running the 'UpdateAndStart.bat' file, which will almost do the same thing. (Windows only)
22
+ Alternatively, if the command prompt gives you problems (and you have GitHub Desktop installed), you can use the 'Repository' menu and select 'Pull'.
23
+ The updates are applied automatically and safely.
24
+
25
+ If you are a developer and use a fork of ST or switch branches regularly, you can use the 'UpdateForkAndStart.bat', which works similarly to 'UpdateAndStart.bat',
26
+ but automatically pulls changes into your fork and handles switched branches gracefully by asking if you want to switch back.
27
+
28
+ Method 2 - ZIP
29
+
30
+ If you insist on installing via a zip, here is the tedious process for doing the update:
31
+
32
+ 1. Download the new release zip.
33
+ 2. Unzip it into a folder OUTSIDE of your current ST installation.
34
+ 3. Do the usual setup procedure for your OS to install the NodeJS requirements.
35
+
36
+ 4a. Updating 1.12.0 and above
37
+
38
+ Copy the user data directory from your data root into the data root of the new install.
39
+
40
+ By default: /data/default-user
41
+
42
+ 4a. Migrating from <1.12.0 to >=1.20.0
43
+ Copy the following files/folders as necessary(*) from your old ST installation:
44
+
45
+ - Assets
46
+ - Backgrounds
47
+ - Characters
48
+ - Chats
49
+ - Context
50
+ - Groups
51
+ - Group chats
52
+ - Instruct
53
+ - movingUI
54
+ - KoboldAI Settings
55
+ - NovelAI Settings
56
+ - OpenAI Settings (Chat Completion API)
57
+ - TextGen Settings (Text Completion API)
58
+ - QuickReplies
59
+ - Themes
60
+ - User Avatars
61
+ - Worlds
62
+ - User
63
+ - settings.json
64
+ - secrets.json <---- This one is in the base folder, not /public/
65
+
66
+ (*) 'As necessary' = "If you made any custom content related to those folders".
67
+ None of the folders are mandatory, so only copy what you need.
68
+
69
+ **NB: DO NOT COPY THE ENTIRE /PUBLIC/ FOLDER.**
70
+ Doing so could break the new install and prevent new features from being present.
71
+ Paste those items into the /data/default-user folder of the new install.
72
+
73
+ 5. Start SillyTavern once again with the method appropriate to your OS, and pray you got it right.
74
+
75
+ 6. If everything shows up, you can safely delete the old ST folder.
jiuguan2025cc/UpdateAndStart.bat ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ pushd %~dp0
3
+ git --version > nul 2>&1
4
+ if %errorlevel% neq 0 (
5
+ echo Git is not installed on this system.
6
+ echo Install it from https://git-scm.com/downloads
7
+ goto end
8
+ ) else (
9
+ if not exist .git (
10
+ echo Not running from a Git repository. Reinstall using an officially supported method to get updates.
11
+ echo See: https://docs.sillytavern.app/installation/windows/
12
+ goto end
13
+ )
14
+ call git pull --rebase --autostash
15
+ if %errorlevel% neq 0 (
16
+ REM incase there is still something wrong
17
+ echo There were errors while updating.
18
+ echo See the update FAQ at https://docs.sillytavern.app/usage/update/#common-update-problems
19
+ goto end
20
+ )
21
+ )
22
+ set NODE_ENV=production
23
+ call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
24
+ node server.js %*
25
+ :end
26
+ pause
27
+ popd
jiuguan2025cc/UpdateForkAndStart.bat ADDED
@@ -0,0 +1,110 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ @setlocal enabledelayedexpansion
3
+ pushd %~dp0
4
+
5
+ echo Checking Git installation
6
+ git --version > nul 2>&1
7
+ if %errorlevel% neq 0 (
8
+ echo Git is not installed on this system.
9
+ echo Install it from https://git-scm.com/downloads
10
+ goto end
11
+ )
12
+
13
+ if not exist .git (
14
+ echo Not running from a Git repository. Reinstall using an officially supported method to get updates.
15
+ echo See: https://docs.sillytavern.app/installation/windows/
16
+ goto end
17
+ )
18
+
19
+ REM Checking current branch
20
+ FOR /F "tokens=*" %%i IN ('git rev-parse --abbrev-ref HEAD') DO SET CURRENT_BRANCH=%%i
21
+ echo Current branch: %CURRENT_BRANCH%
22
+
23
+ REM Checking for automatic branch switching configuration
24
+ set AUTO_SWITCH=
25
+ FOR /F "tokens=*" %%j IN ('git config --local script.autoSwitch') DO SET AUTO_SWITCH=%%j
26
+
27
+ SET TARGET_BRANCH=%CURRENT_BRANCH%
28
+
29
+ if NOT "!AUTO_SWITCH!"=="" (
30
+ if "!AUTO_SWITCH!"=="s" (
31
+ goto autoswitch-staging
32
+ )
33
+ if "!AUTO_SWITCH!"=="r" (
34
+ goto autoswitch-release
35
+ )
36
+
37
+ if "!AUTO_SWITCH!"=="staging" (
38
+ :autoswitch-staging
39
+ echo Auto-switching to staging branch
40
+ git checkout staging
41
+ SET TARGET_BRANCH=staging
42
+ goto update
43
+ )
44
+ if "!AUTO_SWITCH!"=="release" (
45
+ :autoswitch-release
46
+ echo Auto-switching to release branch
47
+ git checkout release
48
+ SET TARGET_BRANCH=release
49
+ goto update
50
+ )
51
+
52
+ echo Auto-switching defined to stay on current branch
53
+ goto update
54
+ )
55
+
56
+ if "!CURRENT_BRANCH!"=="staging" (
57
+ echo Staying on the current branch
58
+ goto update
59
+ )
60
+ if "!CURRENT_BRANCH!"=="release" (
61
+ echo Staying on the current branch
62
+ goto update
63
+ )
64
+
65
+ echo You are not on 'staging' or 'release'. You are on '!CURRENT_BRANCH!'.
66
+ set /p "CHOICE=Do you want to switch to 'staging' (s), 'release' (r), or stay (any other key)? "
67
+ if /i "!CHOICE!"=="s" (
68
+ echo Switching to staging branch
69
+ git checkout staging
70
+ SET TARGET_BRANCH=staging
71
+ goto update
72
+ )
73
+ if /i "!CHOICE!"=="r" (
74
+ echo Switching to release branch
75
+ git checkout release
76
+ SET TARGET_BRANCH=release
77
+ goto update
78
+ )
79
+
80
+ echo Staying on the current branch
81
+
82
+ :update
83
+ REM Checking for 'upstream' remote
84
+ git remote | findstr "upstream" > nul
85
+ if %errorlevel% equ 0 (
86
+ echo Updating and rebasing against 'upstream'
87
+ git fetch upstream
88
+ git rebase upstream/%TARGET_BRANCH% --autostash
89
+ goto install
90
+ )
91
+
92
+ echo Updating and rebasing against 'origin'
93
+ git pull --rebase --autostash origin %TARGET_BRANCH%
94
+
95
+
96
+ :install
97
+ if %errorlevel% neq 0 (
98
+ echo There were errors while updating.
99
+ echo See the update FAQ at https://docs.sillytavern.app/usage/update/#common-update-problems
100
+ goto end
101
+ )
102
+
103
+ echo Installing npm packages and starting server
104
+ set NODE_ENV=production
105
+ call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
106
+ node server.js %*
107
+
108
+ :end
109
+ pause
110
+ popd
jiuguan2025cc/backups/!README.md ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ # Looking for setting snapshots or chat backups?
2
+
3
+ Individual user backups are now located in the data directory.
4
+
5
+ Example for the default user under default data root:
6
+
7
+ /data/default-user/backups
8
+
9
+ This folder remains for historical purposes only.
jiuguan2025cc/colab/GPU.ipynb ADDED
@@ -0,0 +1,193 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "cells": [
3
+ {
4
+ "attachments": {},
5
+ "cell_type": "markdown",
6
+ "metadata": {},
7
+ "source": [
8
+ "**Links**<br>\n",
9
+ "Extensions API GitHub: https://github.com/SillyTavern/SillyTavern-extras/<br>\n",
10
+ "SillyTavern community Discord (support and discussion): https://discord.gg/sillytavern"
11
+ ]
12
+ },
13
+ {
14
+ "cell_type": "code",
15
+ "execution_count": null,
16
+ "metadata": {},
17
+ "outputs": [],
18
+ "source": [
19
+ "#@title <-- Tap this if you run on Mobile { display-mode: \"form\" }\n",
20
+ "#Taken from KoboldAI colab\n",
21
+ "%%html\n",
22
+ "<b>Press play on the audio player to keep the tab alive. (Uses only 13MB of data)</b><br/>\n",
23
+ "<audio src=\"https://henk.tech/colabkobold/silence.m4a\" controls>"
24
+ ]
25
+ },
26
+ {
27
+ "cell_type": "code",
28
+ "execution_count": null,
29
+ "metadata": {
30
+ "cellView": "form",
31
+ "id": "lVftocpwCoYw"
32
+ },
33
+ "outputs": [],
34
+ "source": [
35
+ "#@markdown (RECOMMENDED) Generates an API key for you to use with the API\n",
36
+ "secure = False #@param {type:\"boolean\"}\n",
37
+ "#@markdown Allows to run SillyTavern Extras on CPU (use if you're out of daily GPU allowance)\n",
38
+ "use_cpu = False #@param {type:\"boolean\"}\n",
39
+ "#@markdown Allows to run Stable Diffusion pipeline on CPU (slow!)\n",
40
+ "use_sd_cpu = False #@param {type:\"boolean\"}\n",
41
+ "#@markdown ***\n",
42
+ "#@markdown Enables the WebSearch module\n",
43
+ "extras_enable_websearch = True #@param {type:\"boolean\"}\n",
44
+ "#@markdown ***\n",
45
+ "#@markdown Loads the image captioning module\n",
46
+ "extras_enable_caption = True #@param {type:\"boolean\"}\n",
47
+ "captioning_model = \"Salesforce/blip-image-captioning-large\" #@param [ \"Salesforce/blip-image-captioning-large\", \"Salesforce/blip-image-captioning-base\" ]\n",
48
+ "#@markdown * Salesforce/blip-image-captioning-large - good base model\n",
49
+ "#@markdown * Salesforce/blip-image-captioning-base - slightly faster but less accurate\n",
50
+ "#@markdown ***\n",
51
+ "#@markdown Loads the sentiment classification model\n",
52
+ "extras_enable_classify = True #@param {type:\"boolean\"}\n",
53
+ "classification_model = \"nateraw/bert-base-uncased-emotion\" #@param [\"nateraw/bert-base-uncased-emotion\", \"joeddav/distilbert-base-uncased-go-emotions-student\"]\n",
54
+ "#@markdown * nateraw/bert-base-uncased-emotion = 6 supported emotions<br>\n",
55
+ "#@markdown * joeddav/distilbert-base-uncased-go-emotions-student = 28 supported emotions\n",
56
+ "#@markdown ***\n",
57
+ "#@markdown Loads the story summarization module\n",
58
+ "extras_enable_summarize = True #@param {type:\"boolean\"}\n",
59
+ "summarization_model = \"slauw87/bart_summarisation\" #@param [ \"slauw87/bart_summarisation\", \"Qiliang/bart-large-cnn-samsum-ChatGPT_v3\", \"Qiliang/bart-large-cnn-samsum-ElectrifAi_v10\", \"distilbart-xsum-12-3\" ]\n",
60
+ "#@markdown * slauw87/bart_summarisation - general purpose summarization model\n",
61
+ "#@markdown * Qiliang/bart-large-cnn-samsum-ChatGPT_v3 - summarization model optimized for chats\n",
62
+ "#@markdown * Qiliang/bart-large-cnn-samsum-ElectrifAi_v10 - nice results so far, but still being evaluated\n",
63
+ "#@markdown * distilbart-xsum-12-3 - faster, but pretty basic alternative\n",
64
+ "#@markdown ***\n",
65
+ "#@markdown Enables Silero text-to-speech module\n",
66
+ "extras_enable_silero_tts = True #@param {type:\"boolean\"}\n",
67
+ "#@markdown Enables Microsoft Edge text-to-speech module\n",
68
+ "extras_enable_edge_tts = True #@param {type:\"boolean\"}\n",
69
+ "#@markdown Enables RVC module\n",
70
+ "extras_enable_rvc = False #@param {type:\"boolean\"}\n",
71
+ "#@markdown ***\n",
72
+ "#@markdown Enables Whisper speech recognition module\n",
73
+ "extras_enable_whisper_stt = True #@param {type:\"boolean\"}\n",
74
+ "whisper_model = \"base.en\" #@param [ \"tiny.en\", \"base.en\", \"small.en\", \"medium.en\", \"tiny\", \"base\", \"small\", \"medium\", \"large\" ]\n",
75
+ "#@markdown There are five model sizes, four with English-only versions, offering speed and accuracy tradeoffs.\n",
76
+ "#@markdown The .en models for English-only applications tend to perform better, especially for the tiny.en and base.en models.\n",
77
+ "#@markdown ***\n",
78
+ "#@markdown Enables SD picture generation\n",
79
+ "extras_enable_sd = True #@param {type:\"boolean\"}\n",
80
+ "sd_model = \"ckpt/anything-v4.5-vae-swapped\" #@param [ \"ckpt/anything-v4.5-vae-swapped\", \"hakurei/waifu-diffusion\", \"philz1337/clarity\", \"prompthero/openjourney\", \"ckpt/sd15\", \"stabilityai/stable-diffusion-2-1-base\" ]\n",
81
+ "#@markdown * ckpt/anything-v4.5-vae-swapped - anime style model\n",
82
+ "#@markdown * hakurei/waifu-diffusion - anime style model\n",
83
+ "#@markdown * philz1337/clarity - realistic style model\n",
84
+ "#@markdown * prompthero/openjourney - midjourney style model\n",
85
+ "#@markdown * ckpt/sd15 - base SD 1.5\n",
86
+ "#@markdown * stabilityai/stable-diffusion-2-1-base - base SD 2.1\n",
87
+ "#@markdown ***\n",
88
+ "#@markdown Enables ChromaDB module\n",
89
+ "extras_enable_chromadb = True #@param {type:\"boolean\"}\n",
90
+ "\n",
91
+ "import subprocess\n",
92
+ "import secrets\n",
93
+ "\n",
94
+ "# ---\n",
95
+ "# SillyTavern extras\n",
96
+ "extras_url = '(disabled)'\n",
97
+ "params = []\n",
98
+ "if use_cpu:\n",
99
+ " params.append('--cpu')\n",
100
+ "if use_sd_cpu:\n",
101
+ " params.append('--sd-cpu')\n",
102
+ "if secure:\n",
103
+ " params.append('--secure')\n",
104
+ "params.append('--share')\n",
105
+ "modules = []\n",
106
+ "\n",
107
+ "if extras_enable_caption:\n",
108
+ " modules.append('caption')\n",
109
+ "if extras_enable_summarize:\n",
110
+ " modules.append('summarize')\n",
111
+ "if extras_enable_classify:\n",
112
+ " modules.append('classify')\n",
113
+ "if extras_enable_sd:\n",
114
+ " modules.append('sd')\n",
115
+ "if extras_enable_silero_tts:\n",
116
+ " modules.append('silero-tts')\n",
117
+ "if extras_enable_edge_tts:\n",
118
+ " modules.append('edge-tts')\n",
119
+ "if extras_enable_chromadb:\n",
120
+ " modules.append('chromadb')\n",
121
+ "if extras_enable_whisper_stt:\n",
122
+ " modules.append('whisper-stt')\n",
123
+ " params.append(f'--stt-whisper-model-path={whisper_model}')\n",
124
+ "if extras_enable_rvc:\n",
125
+ " modules.append('rvc')\n",
126
+ " params.append('--max-content-length=2000')\n",
127
+ " params.append('--rvc-save-file')\n",
128
+ "\n",
129
+ "\n",
130
+ "if extras_enable_websearch:\n",
131
+ " print(\"Enabling WebSearch module\")\n",
132
+ " modules.append('websearch')\n",
133
+ " !apt update\n",
134
+ " !apt install -y chromium-chromedriver\n",
135
+ "\n",
136
+ "params.append(f'--classification-model={classification_model}')\n",
137
+ "params.append(f'--summarization-model={summarization_model}')\n",
138
+ "params.append(f'--captioning-model={captioning_model}')\n",
139
+ "params.append(f'--sd-model={sd_model}')\n",
140
+ "params.append(f'--enable-modules={\",\".join(modules)}')\n",
141
+ "\n",
142
+ "\n",
143
+ "%cd /\n",
144
+ "!git clone https://github.com/SillyTavern/SillyTavern-extras\n",
145
+ "%cd /SillyTavern-extras\n",
146
+ "!git clone https://github.com/Cohee1207/tts_samples\n",
147
+ "!npm install -g localtunnel\n",
148
+ "%pip install -r requirements.txt\n",
149
+ "!wget https://github.com/cloudflare/cloudflared/releases/download/2023.5.0/cloudflared-linux-amd64 -O /tmp/cloudflared-linux-amd64\n",
150
+ "!chmod +x /tmp/cloudflared-linux-amd64\n",
151
+ "\n",
152
+ "if extras_enable_rvc:\n",
153
+ " print(\"Installing RVC requirements\")\n",
154
+ " %pip install -r requirements-rvc.txt\n",
155
+ "\n",
156
+ "# Generate a random API key\n",
157
+ "api_key = secrets.token_hex(5)\n",
158
+ "\n",
159
+ "# Write the API key to api_key.txt\n",
160
+ "with open('./api_key.txt', 'w') as f:\n",
161
+ " f.write(api_key)\n",
162
+ "print(f\"API Key generated: {api_key}\")\n",
163
+ "\n",
164
+ "cmd = f\"python server.py {' '.join(params)}\"\n",
165
+ "print(cmd)\n",
166
+ "extras_process = subprocess.Popen(\n",
167
+ " cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, cwd='/SillyTavern-extras', shell=True)\n",
168
+ "print('processId:', extras_process.pid)\n",
169
+ "while True:\n",
170
+ " line = extras_process.stdout.readline().decode().strip()\n",
171
+ " if line != None and line != '':\n",
172
+ " print(line)\n"
173
+ ]
174
+ }
175
+ ],
176
+ "metadata": {
177
+ "accelerator": "GPU",
178
+ "colab": {
179
+ "private_outputs": true,
180
+ "provenance": []
181
+ },
182
+ "gpuClass": "standard",
183
+ "kernelspec": {
184
+ "display_name": "Python 3",
185
+ "name": "python3"
186
+ },
187
+ "language_info": {
188
+ "name": "python"
189
+ }
190
+ },
191
+ "nbformat": 4,
192
+ "nbformat_minor": 0
193
+ }
jiuguan2025cc/data/.gitkeep ADDED
File without changes
jiuguan2025cc/default/!DO-NOT-EDIT-THESE-FILES.txt ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ These are master copies of the default content files and are managed by SillyTavern.
2
+
3
+ Editing any of these files would not only have no effect, but will also cause merge conflicts during update pulls.
4
+
5
+ You should edit their respective copies instead, for example:
6
+
7
+ 1. /default/config.yaml => /config.yaml
8
+ 2. /default/public/css/user.css => /public/css/user.css
9
+ etc.
10
+
11
+ Any questions? You're always welcome at our official documentation website:
12
+
13
+ https://docs.sillytavern.app/
jiuguan2025cc/default/config.yaml ADDED
@@ -0,0 +1,235 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # -- DATA CONFIGURATION --
2
+ # Root directory for user data storage
3
+ dataRoot: ./data
4
+ # -- SERVER CONFIGURATION --
5
+ # Listen for incoming connections
6
+ listen: false
7
+ # Listen on a specific address, supports IPv4 and IPv6
8
+ listenAddress:
9
+ ipv4: 0.0.0.0
10
+ ipv6: '[::]'
11
+ # Enables IPv6 and/or IPv4 protocols. Need to have at least one enabled!
12
+ # - Use option "auto" to automatically detect support
13
+ # - Use true or false (no qoutes) to enable or disable each protocol
14
+ protocol:
15
+ ipv4: true
16
+ ipv6: false
17
+ # Prefers IPv6 for DNS. Enable this on ISPs that don't have issues with IPv6
18
+ dnsPreferIPv6: false
19
+ # The hostname that autorun opens.
20
+ # - Use "auto" to let the server decide
21
+ # - Use options like 'localhost', 'st.example.com'
22
+ autorunHostname: "auto"
23
+ # Server port
24
+ port: 8000
25
+ # Overrides the port for autorun in browser.
26
+ # - Use -1 to use the server port.
27
+ # - Specify a port to override the default.
28
+ autorunPortOverride: -1
29
+ # -- SSL options --
30
+ ssl:
31
+ enabled: false
32
+ certPath: "./certs/cert.pem"
33
+ keyPath: "./certs/privkey.pem"
34
+ # -- SECURITY CONFIGURATION --
35
+ # Toggle whitelist mode
36
+ whitelistMode: true
37
+ # Whitelist will also verify IP in X-Forwarded-For / X-Real-IP headers
38
+ enableForwardedWhitelist: true
39
+ # Whitelist of allowed IP addresses
40
+ whitelist:
41
+ - ::1
42
+ - 127.0.0.1
43
+ # Automatically whitelist Docker host and gateway IPs
44
+ whitelistDockerHosts: true
45
+ # Toggle basic authentication for endpoints
46
+ basicAuthMode: false
47
+ # Basic authentication credentials
48
+ basicAuthUser:
49
+ username: "user"
50
+ password: "password"
51
+ # Enables CORS proxy middleware
52
+ enableCorsProxy: false
53
+ # -- REQUEST PROXY CONFIGURATION --
54
+ requestProxy:
55
+ # If a proxy is enabled, all outgoing HTTP/HTTPS requests will be routed through it.
56
+ enabled: false
57
+ # Proxy URL. Possible protocols: http, https, socks, socks5, socks4, pac
58
+ url: "socks5://username:[email protected]:1080"
59
+ # Proxy bypass list. Requests to these hosts won't be routed through the proxy.
60
+ bypass:
61
+ - localhost
62
+ - 127.0.0.1
63
+ # Enable multi-user mode
64
+ enableUserAccounts: false
65
+ # Enable discreet login mode: hides user list on the login screen
66
+ enableDiscreetLogin: false
67
+ # Enable's authlia based auto login. Only enable this if you
68
+ # have setup and installed Authelia as a middle-ware on your
69
+ # reverse proxy
70
+ # https://www.authelia.com/
71
+ # This will use auto login to an account with the same username
72
+ # as that used for authlia. (Ensure the username in authlia
73
+ # is an exact match with that in sillytavern)
74
+ autheliaAuth: false
75
+ # If `basicAuthMode` and this are enabled then
76
+ # the username and passwords for basic auth are the same as those
77
+ # for the individual accounts
78
+ perUserBasicAuth: false
79
+
80
+ # User session timeout *in seconds* (defaults to 24 hours).
81
+ ## Set to a positive number to expire session after a certain time of inactivity
82
+ ## Set to 0 to expire session when the browser is closed
83
+ ## Set to a negative number to disable session expiration
84
+ sessionTimeout: -1
85
+ # Disable CSRF protection - NOT RECOMMENDED
86
+ disableCsrfProtection: false
87
+ # Disable startup security checks - NOT RECOMMENDED
88
+ securityOverride: false
89
+ # -- LOGGING CONFIGURATION --
90
+ logging:
91
+ # Enable access logging to access.log file
92
+ # Records new connections with timestamp, IP address and user agent
93
+ enableAccessLog: true
94
+ # Minimum log level to display in the terminal (DEBUG = 0, INFO = 1, WARN = 2, ERROR = 3)
95
+ minLogLevel: 0
96
+ # -- RATE LIMITING CONFIGURATION --
97
+ rateLimiting:
98
+ # Use X-Real-IP header instead of socket IP for rate limiting
99
+ # Only enable this if you are using a properly configured reverse proxy (like Nginx/traefik/Caddy)
100
+ preferRealIpHeader: false
101
+ # -- ADVANCED CONFIGURATION --
102
+ # Open the browser automatically
103
+ autorun: true
104
+ # Avoids using 'localhost' for autorun in auto mode.
105
+ # use if you don't have 'localhost' in your hosts file
106
+ avoidLocalhost: false
107
+
108
+ ## BACKUP CONFIGURATION
109
+ backups:
110
+ # Common settings for all backup types
111
+ common:
112
+ # Number of backups to keep for each chat and settings file
113
+ numberOfBackups: 50
114
+ chat:
115
+ # Enable automatic chat backups
116
+ enabled: true
117
+ # Maximum number of chat backups to keep per user (starting from the most recent). Set to -1 to keep all backups.
118
+ maxTotalBackups: -1
119
+ # Interval in milliseconds to throttle chat backups per user
120
+ throttleInterval: 10000
121
+
122
+ # THUMBNAILING CONFIGURATION
123
+ thumbnails:
124
+ # Enable thumbnail generation
125
+ enabled: true
126
+ # Image format of avatar thumbnails:
127
+ # * "jpg": best compression with adjustable quality, no transparency
128
+ # * "png": preserves transparency but increases filesize by about 100%
129
+ # Changing this only affects new thumbnails. To recreate the old ones, clear out /thumbnails folder in your user data.
130
+ format: "jpg"
131
+ # JPG thumbnail quality (0-100)
132
+ quality: 95
133
+ # Maximum thumbnail dimensions per type [width, height]
134
+ dimensions: { 'bg': [160, 90], 'avatar': [96, 144] }
135
+
136
+ # PERFORMANCE-RELATED CONFIGURATION
137
+ performance:
138
+ # Enables lazy loading of character cards. Improves performances with large card libraries.
139
+ # May have compatibility issues with some extensions.
140
+ lazyLoadCharacters: false
141
+ # The maximum amount of memory that parsed character cards can use. Set to 0 to disable memory caching.
142
+ memoryCacheCapacity: '100mb'
143
+
144
+ # Allow secret keys exposure via API
145
+ allowKeysExposure: false
146
+ # Skip new default content checks
147
+ skipContentCheck: false
148
+ # Allowed hosts for card downloads
149
+ whitelistImportDomains:
150
+ - localhost
151
+ - cdn.discordapp.com
152
+ - files.catbox.moe
153
+ - raw.githubusercontent.com
154
+ # API request overrides (for KoboldAI and Text Completion APIs)
155
+ ## Note: host includes the port number if it's not the default (80 or 443)
156
+ ## Format is an array of objects:
157
+ ## - hosts:
158
+ ## - example.com
159
+ ## headers:
160
+ ## Content-Type: application/json
161
+ ## - 127.0.0.1:5001
162
+ ## headers:
163
+ ## User-Agent: "Googlebot/2.1 (+http://www.google.com/bot.html)"
164
+ requestOverrides: []
165
+
166
+ # EXTENSIONS CONFIGURATION
167
+ extensions:
168
+ # Enable UI extensions
169
+ enabled: true
170
+ # Automatically update extensions when a release version changes
171
+ autoUpdate: true
172
+ models:
173
+ # Enables automatic model download from HuggingFace
174
+ autoDownload: true
175
+ # Additional models for extensions. Expects model IDs from HuggingFace model hub in ONNX format
176
+ classification: Cohee/distilbert-base-uncased-go-emotions-onnx
177
+ captioning: Xenova/vit-gpt2-image-captioning
178
+ embedding: Cohee/jina-embeddings-v2-base-en
179
+ speechToText: Xenova/whisper-small
180
+ textToSpeech: Xenova/speecht5_tts
181
+
182
+ # Additional model tokenizers can be downloaded on demand.
183
+ # Disabling will fallback to another locally available tokenizer.
184
+ enableDownloadableTokenizers: true
185
+ # -- OPENAI CONFIGURATION --
186
+ # A placeholder message to use in strict prompt post-processing mode when the prompt doesn't start with a user message
187
+ promptPlaceholder: "[Start a new chat]"
188
+ openai:
189
+ # Will send a random user ID to OpenAI completion API
190
+ randomizeUserId: false
191
+ # If not empty, will add this as a system message to the start of every caption completion prompt
192
+ # Example: "Perform the instructions to the best of your ability.\n" (for LLaVA)
193
+ # Not used in image inlining mode
194
+ captionSystemPrompt: ""
195
+ # -- DEEPL TRANSLATION CONFIGURATION --
196
+ deepl:
197
+ # Available options: default, more, less, prefer_more, prefer_less
198
+ formality: default
199
+ # -- MISTRAL API CONFIGURATION --
200
+ mistral:
201
+ # Enables prefilling of the reply with the last assistant message in the prompt
202
+ # CAUTION: The prefix is echoed into the completion. You may want to use regex to trim it out.
203
+ enablePrefix: false
204
+ # -- OLLAMA API CONFIGURATION --
205
+ ollama:
206
+ # Controls how long the model will stay loaded into memory following the request
207
+ # * -1: Keep the model loaded indefinitely
208
+ # * 0: Unload the model immediately after the request
209
+ # * N (any positive number): Keep the model loaded for N seconds after the request.
210
+ keepAlive: -1
211
+ # Controls the "num_batch" (batch size) parameter of the generation request
212
+ # * -1: Use the default value of the model
213
+ # * N (positive number): Use the specified value. Must be a power of 2, e.g. 128, 256, 512, etc.
214
+ batchSize: -1
215
+ # -- ANTHROPIC CLAUDE API CONFIGURATION --
216
+ claude:
217
+ # Enables caching of the system prompt (if supported).
218
+ # https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
219
+ # -- IMPORTANT! --
220
+ # Use only when the prompt before the chat history is static and doesn't change between requests
221
+ # (e.g {{random}} macro or lorebooks not as in-chat injections).
222
+ # Otherwise, you'll just waste money on cache misses.
223
+ enableSystemPromptCache: false
224
+ # Enables caching of the message history at depth (if supported).
225
+ # https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
226
+ # -- IMPORTANT! --
227
+ # Use with caution. Behavior may be unpredictable and no guarantees can or will be made.
228
+ # Set to an integer to specify the desired depth. 0 (which does NOT include the prefill)
229
+ # should be ideal for most use cases.
230
+ # Any value other than a non-negative integer will be ignored and caching at depth will not be enabled.
231
+ cachingAtDepth: -1
232
+ # -- SERVER PLUGIN CONFIGURATION --
233
+ enableServerPlugins: false
234
+ # Attempt to automatically update server plugins on startup
235
+ enableServerPluginsAutoUpdate: true
jiuguan2025cc/default/content/Char_Avatar_Comfy_Workflow.json ADDED
@@ -0,0 +1,137 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "3": {
3
+ "inputs": {
4
+ "seed": "%seed%",
5
+ "steps": "%steps%",
6
+ "cfg": "%scale%",
7
+ "sampler_name": "%sampler%",
8
+ "scheduler": "%scheduler%",
9
+ "denoise": "%denoise%",
10
+ "model": [
11
+ "4",
12
+ 0
13
+ ],
14
+ "positive": [
15
+ "6",
16
+ 0
17
+ ],
18
+ "negative": [
19
+ "7",
20
+ 0
21
+ ],
22
+ "latent_image": [
23
+ "12",
24
+ 0
25
+ ]
26
+ },
27
+ "class_type": "KSampler",
28
+ "_meta": {
29
+ "title": "KSampler"
30
+ }
31
+ },
32
+ "4": {
33
+ "inputs": {
34
+ "ckpt_name": "%model%"
35
+ },
36
+ "class_type": "CheckpointLoaderSimple",
37
+ "_meta": {
38
+ "title": "Load Checkpoint"
39
+ }
40
+ },
41
+ "6": {
42
+ "inputs": {
43
+ "text": "%prompt%",
44
+ "clip": [
45
+ "4",
46
+ 1
47
+ ]
48
+ },
49
+ "class_type": "CLIPTextEncode",
50
+ "_meta": {
51
+ "title": "CLIP Text Encode (Prompt)"
52
+ }
53
+ },
54
+ "7": {
55
+ "inputs": {
56
+ "text": "%negative_prompt%",
57
+ "clip": [
58
+ "4",
59
+ 1
60
+ ]
61
+ },
62
+ "class_type": "CLIPTextEncode",
63
+ "_meta": {
64
+ "title": "CLIP Text Encode (Negative Prompt)"
65
+ }
66
+ },
67
+ "8": {
68
+ "inputs": {
69
+ "samples": [
70
+ "3",
71
+ 0
72
+ ],
73
+ "vae": [
74
+ "4",
75
+ 2
76
+ ]
77
+ },
78
+ "class_type": "VAEDecode",
79
+ "_meta": {
80
+ "title": "VAE Decode"
81
+ }
82
+ },
83
+ "9": {
84
+ "inputs": {
85
+ "filename_prefix": "SillyTavern",
86
+ "images": [
87
+ "8",
88
+ 0
89
+ ]
90
+ },
91
+ "class_type": "SaveImage",
92
+ "_meta": {
93
+ "title": "Save Image"
94
+ }
95
+ },
96
+ "10": {
97
+ "inputs": {
98
+ "image": "%char_avatar%"
99
+ },
100
+ "class_type": "ETN_LoadImageBase64",
101
+ "_meta": {
102
+ "title": "Load Image (Base64) [https://github.com/Acly/comfyui-tooling-nodes]"
103
+ }
104
+ },
105
+ "12": {
106
+ "inputs": {
107
+ "pixels": [
108
+ "13",
109
+ 0
110
+ ],
111
+ "vae": [
112
+ "4",
113
+ 2
114
+ ]
115
+ },
116
+ "class_type": "VAEEncode",
117
+ "_meta": {
118
+ "title": "VAE Encode"
119
+ }
120
+ },
121
+ "13": {
122
+ "inputs": {
123
+ "upscale_method": "bicubic",
124
+ "width": "%width%",
125
+ "height": "%height%",
126
+ "crop": "center",
127
+ "image": [
128
+ "10",
129
+ 0
130
+ ]
131
+ },
132
+ "class_type": "ImageScale",
133
+ "_meta": {
134
+ "title": "Upscale Image"
135
+ }
136
+ }
137
+ }
jiuguan2025cc/default/content/Default_Comfy_Workflow.json ADDED
@@ -0,0 +1,86 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "3": {
3
+ "class_type": "KSampler",
4
+ "inputs": {
5
+ "cfg": "%scale%",
6
+ "denoise": 1,
7
+ "latent_image": [
8
+ "5",
9
+ 0
10
+ ],
11
+ "model": [
12
+ "4",
13
+ 0
14
+ ],
15
+ "negative": [
16
+ "7",
17
+ 0
18
+ ],
19
+ "positive": [
20
+ "6",
21
+ 0
22
+ ],
23
+ "sampler_name": "%sampler%",
24
+ "scheduler": "%scheduler%",
25
+ "seed": "%seed%",
26
+ "steps": "%steps%"
27
+ }
28
+ },
29
+ "4": {
30
+ "class_type": "CheckpointLoaderSimple",
31
+ "inputs": {
32
+ "ckpt_name": "%model%"
33
+ }
34
+ },
35
+ "5": {
36
+ "class_type": "EmptyLatentImage",
37
+ "inputs": {
38
+ "batch_size": 1,
39
+ "height": "%height%",
40
+ "width": "%width%"
41
+ }
42
+ },
43
+ "6": {
44
+ "class_type": "CLIPTextEncode",
45
+ "inputs": {
46
+ "clip": [
47
+ "4",
48
+ 1
49
+ ],
50
+ "text": "%prompt%"
51
+ }
52
+ },
53
+ "7": {
54
+ "class_type": "CLIPTextEncode",
55
+ "inputs": {
56
+ "clip": [
57
+ "4",
58
+ 1
59
+ ],
60
+ "text": "%negative_prompt%"
61
+ }
62
+ },
63
+ "8": {
64
+ "class_type": "VAEDecode",
65
+ "inputs": {
66
+ "samples": [
67
+ "3",
68
+ 0
69
+ ],
70
+ "vae": [
71
+ "4",
72
+ 2
73
+ ]
74
+ }
75
+ },
76
+ "9": {
77
+ "class_type": "SaveImage",
78
+ "inputs": {
79
+ "filename_prefix": "SillyTavern",
80
+ "images": [
81
+ "8",
82
+ 0
83
+ ]
84
+ }
85
+ }
86
+ }