https://github.com/fatsnk/forksilly.doc

Documents repo of ForkSilly. ForkSilly：兼容sillytavern（酒馆）角色卡、世界书、正则、预设、聊天记录的安卓移动端应用；同时也可作为stable diffusion客户端使用。
https://github.com/fatsnk/forksilly.doc

a1111 ai airp android api-client chat embedding llm mcp-client mobile op-sqlite openai prompt roleplay sillytavern sqlite-vec stable-diffusion text-adventure vector

Last synced: 20 days ago
JSON representation

Documents repo of ForkSilly. ForkSilly：兼容sillytavern（酒馆）角色卡、世界书、正则、预设、聊天记录的安卓移动端应用；同时也可作为stable diffusion客户端使用。

• Host: GitHub
• URL: https://github.com/fatsnk/forksilly.doc
• Owner: fatsnk
• License: agpl-3.0
• Created: 2025-06-04T08:52:48.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2026-03-03T16:33:12.000Z (24 days ago)
• Last Synced: 2026-03-03T20:28:34.648Z (24 days ago)
• Topics: a1111, ai, airp, android, api-client, chat, embedding, llm, mcp-client, mobile, op-sqlite, openai, prompt, roleplay, sillytavern, sqlite-vec, stable-diffusion, text-adventure, vector
• Language: Kotlin
• Homepage: https://fatsnk.github.io/fatsnk/
• Size: 61.1 MB
• Stars: 76
• Watchers: 4
• Forks: 12
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Homepage](./images/giveup.jpg)](https://fatsnk.github.io/fatsnk/)




* [1.27版](https://github.com/fatsnk/forksilly.doc/releases)的readme看这里：

[![简体中文](https://img.shields.io/badge/文档-简体中文-blue.svg)](./README.zh-CN.md)


通过[API模板引擎](https://github.com/fatsnk/APItemplateV2)兼容了大部分api格式，并添加mcp。如果需要连接Gemini、Claude等原生格式，请点击[![API模板](https://img.shields.io/badge/文档-模板引擎-blue.svg)](https://github.com/fatsnk/APItemplateV2?tab=readme-ov-file)按钮前往模板仓库下载示例模板导入api设置。

---

  最近更新

version test1.27

*[有问题可前往discussion交流](https://github.com/fatsnk/forksilly.doc/discussions)*

* 2026.03.04

  * test1.27.14：添加了数据备份功能，从存储管理右下角菜单进入；建议配合配置档功能使用。聊天中添加查看大图功能（如果有图片）。点击聊天气泡下方菜单中的🖼️按钮，或长按🎨按钮（触发文生图时使用），可放大图片。

* 2026.03.03

  * test1.27.9：添加配置档管理。请从右上角`🔧更多选项`菜单关闭按钮旁的文件按钮进入

* 2026.02.17

  * test1.27.3：新增工具和MCP功能，详情查看[工具使用说明](tools.md)；新增[API模板引擎](https://github.com/fatsnk/APItemplateV2?tab=readme-ov-file)，通过导入json模板可以兼容大部分API格式；新增发送图片功能。

* changelog: [其它更新](changelog.md)

   

# forksilly.doc

此仓库主要存放ForkSilly的文档，

顺带发布ForkSilly的apk安装包和源码（repo不含完整源码，完整源码请在[📦releases](https://github.com/fatsnk/forksilly.doc/releases/)获取），遇到问题请先阅读[常见问题解答](https://github.com/fatsnk/forksilly.doc/discussions/4#discussion-9176039)。*消息文字太多超出了消息气泡、消息内容重叠、代码块内容不完整？请在主题设置中调整聊天气泡最大高度和代码块高度设置。详见https://github.com/fatsnk/forksilly.doc/discussions/1#discussioncomment-14816259*

[🎬 新手快速上手指南](moenew.md#-%E6%96%B0%E6%89%8B%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B%E6%8C%87%E5%8D%97)：新手入门，介绍一些免费的API。


**示例角色卡**：制作了示例角色卡，供萌新参考。请查看 *https://github.com/fatsnk/LifeReloaded*

单轮生图助手：一张工具卡，用于生图模型。[【点击前往下载】](https://github.com/fatsnk/LifeReloaded/tree/ccv2/cards/imageAssistant)

（20251222）提醒：pollinations.ai接口已经更新。如果你使用pollinations进行文生图，请将app更新到[1.26.86](https://github.com/fatsnk/forksilly.doc/releases/)以上版本，文生图url修改为`https://gen.pollinations.ai/image`，并前往新的[管理页面](https://enter.pollinations.ai/)`https://enter.pollinations.ai/`创建新的api key。

* pollinations现在有seedream、nanobanana、zimage-turbo 6B 等新模型，每天重置免费额度，请注意检查页面上的“Pricing”信息。

---

## 概要

ForkSilly: *一个react native/expo项目，主要用于Android。适用于对sillytavern有一定使用经验的用户* ~~*小孩子不懂事，写着玩的🤕* *中文名*：*“傻叉”*（~~ 由于手机端sillytavern用起来较难受，所以让AI写了这个项目。





#### 其它预览： [应用UI预览](./images/readme.md)

## ForkSilly介绍

* 该项目为自用分享，可能无法受理功能申请，使用上有问题请先参考本项目中的文档。

  * *因为99.9%的代码由AI生成，你提需求我也做不出来😭（*

* 适合纯文字卡、插图卡（使用图床或[本地上传](#使用技巧)），以及Stable Diffusion文生图。不兼容前端/变量卡

+ 兼容sillytavern V2角色卡、世界书、正则、预设、聊天记录，可以随时导入导出。（[兼容性指引](#兼容性指引)）

+ 可任意更换的聊天字体

+ 可更换的聊天背景图片

+ 聊天中快速开关预设条目、切换模型

+ 可使用任意格式的API，通过[API模板引擎](https://github.com/fatsnk/APItemplateV2?tab=readme-ov-file)兼容。

+ 内置工具函数，且可以添加远程MCP服务。

+ 内置存储管理功能，用户可以导出应用内的所有内容（请谨慎操作）、管理缓存

+ 可在聊天中使用文生图：

  + 接入免费文生图服务pollinations.ai

  + 支持Stable Diffusion文生图功能(sd需开启监听：添加启动参数` --api --listen --cors-allow-origins '*'`)，请点击🔧图标进入更多选项-文生图，并添加API、预设并设置默认和参数，然后在触发标签中开启聊天文生图功能。预设中的main在请求时会被替换成捕获的提示词，其它条目则会根据你选择的位置拼接。[文生图简单教程](text2img.md)

    * 在llm的预设中添加一个文生图条目，让AI输出你自定义的标签包裹的文生图提示词即可，例如`prompt tags`（可在预设中添加相应条目，或使用世界书）。如果需要重新生成，可点击🎨手动生成。

    * 可在存储管理的gallery目录中找到聊天中生成的图片

+ （可选）接入硅基流动和Gemini的嵌入模型。（支持记忆生成、自动保存到本地向量数据库：[记忆和知识库教程](Embedding.md)）。

- 不支持tts(文字转语音)

- 不支持连接nai

## License

ForkSilly包含第三方依赖，查看它们的许可详情：[LICENSE-THIRD-PARTY](./LICENSE-THIRD-PARTY) 

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).  

See the [LICENSE](./LICENSE) file for details.

## 注意事项

使用上有疑问请先阅读相关文档和以下FAQ：

### FAQ：https://github.com/fatsnk/forksilly.doc/discussions/4#discussion-9176039

## 下载

选择文件名不含src的压缩包，解压后安装APK文件。适用所有cpu架构（因此安装包体积略大，单架构实际只有30mb）



  

    

  



*体验版：[![download](https://img.shields.io/badge/beta-v1.27-ff9e7d?style=plastic&logo=github)](https://github.com/fatsnk/forksilly.doc/releases)*

## 打包

源码以zip格式上传于release。

项目结构：[项目结构文档](ProjectStructure.md)

如果你想自己打包APK，可下载源码到本地，使用以下命令调试和打包（需先配置Android开发环境和Java开发环境）：

```

（安装依赖）npm install

（在模拟器调试）npx expo run:android

cd android（切换到Android目录，修改gradle.properties文件底部的MYAPP_RELEASE_STORE_FILE等参数值为你自己的release证书和密钥）

gradlew assembleRelease（打包成apk）

```

如果你有Mac，也可以打包成ipa。

## 兼容性指引

* 角色卡、预设：forksilly ⇌ sillytavern 可直接在相应的界面导出，并直接在sillytavern中使用，反之亦然；所有内容均与st中的对应。（角色备注会被忽略；“提示词覆盖”设置中的主要提示词`main`如果不为空，会替换掉预设中main条目的内容，jailbreak/post-history instructions的内容则始终使用预设中的内容，角色卡中的对应内容将被忽略）

* 全局世界书、全局正则：forksilly ⇌ sillytavern 同上，所有参数含义均与st相似。部分sillytavern的高级参数可能不适用，但不影响互相导入。

* 角色世界书：随角色卡一起导入，导出角色时也会包含在角色卡中。可单独导出角色世界书，并可直接导入到sillytavern。不能直接在forksilly应用中将额外的世界书文件导入到角色信息中，只能编辑、添加条目。如需将单独的世界书附加到角色卡，请使用[OcO萌/AI角色卡编辑器：CharacterEditor](https://ce.ooc.moe/zh-CN)，或直接在sillytavern中操作。

* 角色正则：支持编辑、新增，不支持直接将正则脚本文件导入到角色卡；请使用复制粘贴的方式，或使用第三方开源角色卡编辑器。

* 聊天记录：如果要导出记录给st使用，请前往存储管理-chats目录-角色名目录，长按选择需要导出的记录，点击左下方的“转换”按钮，会生成一个包含‘_converted’字样的新聊天记录，该记录导出后可直接导入到st。st的记录也需在存储管理中转换后才可在forksilly中使用，否则消息顺序是反的。在线转换工具：[聊天记录转换器](https://fatsnk.github.io/legendary-pancake/jsonl-converter.html)

- 关于角色备注、作者注释、世界书位置中的作者注释前/后：这些功能均被世界书的功能完全覆盖，因此本应用不再支持这些设置参数。

## 使用技巧

* 测试url: `https://oai-liard.vercel.app/v1` ，用于测试连通性、模型获取、确认上下文，也可以用于伪造assistant回复；

  * 使用方法:添加一个新的api配置，填写该url，apikey任意填写，关闭流式传输，即可使用（可能需要科学上网）。

* 消息气泡可以独立设置透明度而不影响消息文字：直接在用户气泡色和AI气泡色输入框中填写包含alpha通道值的16进制值即可，例如#3A3A3ABB，末尾的BB即表示不透明度，值越大透明度越低，FF为完全不透明；也可以设置成00全透明，模拟出类似文档的主题效果。

* 默认渲染器支持部分HTML内联样式和大部分markdown语法，例如：

```

文字颜色：

①这是红色字。

这是黑的文字

按钮（仅用于复制按钮文本）：

蓝色按钮

被禁用的按钮

插入web图片：

![](https://files.catbox.moe/y6uo86.jpg)



使用在存储管理中上传的本地图片：



...

```

* 在🔧中的存储管理中可管理你的文件，并可在`Gallery/角色名`目录下导入表情包和角色图片，以支持让AI以HTML格式插入聊天中，使用相对路径，例如``

* 支持roll和random占位符，例如

  - {{roll:10000}}

  - {{roll:1d100}}

* 支持常见占位符，包括{{user}}、{{char}}、{{lastcharmessage}}、{{lastusermessage}}、{{lastmessage}}，因此大多数预设无需修改可直接使用。 其它占位符：

  *   `{{user}}` (用户角色名), `{{char}}` (AI角色名) 及其别名 ``, ``。

  *   `{{random::A::B...}}` (或 `{{random:A,B...}}`) 用于从列表中随机选取一项，若无参数则返回0-1随机数。

  *   `{{roll::EXPRESSION}}` (或 `{{roll:EXPRESSION}}`) 用于掷骰计算，支持如 `1d6`、`2d10+3` 等表达式。

  *   `{{lastmessage}}`: 当前聊天中的最后一条消息的文本。

  *   `{{lastusermessage}}`: 聊天记录中最后一条用户消息的文本。

  *   `{{lastcharmessage}}`: 聊天记录中最后一条助手（AI角色）消息的文本。

* 想使用不受信任的https连接或frp内网穿透？请参考：[服务器自签证书教程](服务器自签证书教程.md)、[文生图简单教程](text2img.md)

角色管理界面点击排序后默认按修改时间排序，编辑角色后，可下拉刷新以便让其显示到最前方；将角色添加到收藏，可以让ta优先显示

* 隐藏楼层：支持使用斜杠命令`/hide 楼层`，例如`/hide 0-10`，则0到10楼就不会发送给AI

* 性能选项：如果楼层很高，可在主题设置-符号与标签界面的`最大处理消息数量`输入框中填写一个较小的值，限制仅处理最新的几条消息，避免正则/符号/标签处理所有消息，可提升载入速度。

### 推荐工具

角色卡创建和编辑：[妮卡角色工作室Pro](https://mocards.netlify.app/)、[OcO萌/AI角色卡编辑器：CharacterEditor](https://ce.ooc.moe/zh-CN)

文生图webui推荐（[stable-diffusion-webui-forge](https://github.com/lllyasviel/stable-diffusion-webui-forge)）：ControlNet的开发者lllyasviel制作的优化版webui，对性能较差的显卡有很大提升

  * 秋葉aaaki的整合包（[B站链接](https://www.bilibili.com/video/BV1rc6nYNEYo)）：支持SD3.5、FLUX，解压即用，无须安装git、Python、cuda等任何内容，只需将模型放入Stable Diffusion目录，在启动器高级设置中启用远程连接，即可使用！非常适合不想进行复杂设置、折腾ComfyUI工作流的玩家

如果你想使用Zimage，请使用这个版本:[NEO](https://github.com/Haoming02/sd-webui-forge-classic/tree/neo?tab=readme-ov-file#new-features)。该版本没有一键安装包，需自行安装。

文生图模型推荐：[WAI-NSFW-illustrious-SDXL](https://civitai.com/models/827184?modelVersionId=1761560)

[octopus](https://github.com/bestruirui/octopus)：One Hub All LLMs.

## 声明

以下声明同时适用于仓库文档、forksilly源码、forksilly APP本体。

*forksilly项目基于[AGPL-3.0](./LICENSE)授权，目前不提供闭源许可；任何基于此项目的修改、衍生作品或包含该项目代码的软件，必须同样以 AGPL-3.0 协议开源。*

*如果您希望在其它项目中使用本代码：必须遵守 AGPL-3.0 协议，公开您的完整源代码；不可将本项目代码整合到闭源软件中。*

### 免责声明

```

forksilly项目是一个开源的通用大语言模型（LLM）前端工具，仅提供技术框架和接口集成功能。

1. 内容责任

项目不提供任何 AI 模型服务或 API 密钥

用户通过forksilly生成的所有内容（包括文本、图片等）均由用户自行负责

用户接入的第三方 API 服务及其生成内容，责任由用户与相应服务提供商承担

项目开发者和维护者对用户使用forksilly生成的任何内容不承担法律责任

2. 使用规范

使用此项目时，您需要：

 遵守您所在地区的法律法规

 遵守您所使用的第三方 API 服务条款

 对生成内容的合法性、合规性负责

 不得将项目用于任何非法用途

 不得生成违反法律法规或侵犯他人权益的内容

3. 风险提示

AI 生成内容可能存在错误、偏见或不当信息

用户应自行审查和验证生成内容的准确性与合法性

因使用本工具产生的任何纠纷、损失或法律后果，由用户自行承担

使用此项目，即表示您已阅读、理解并同意本免责声明。

```