# Rincy

**Repository Path**: mc2049/Rincy

## Basic Information

- **Project Name**: Rincy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-05
- **Last Updated**: 2026-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rincy

**Rincy — True. Mini. Libre.**

[下载](https://github.com/MC2049/Rincy/releases) · [下载 · CodeTrunk](https://repos.codetrunk.eu/mc2049/Rincy/releases) · [下载 · Gitee](https://gitee.com/MC2049/Rincy/releases) · [反馈](https://github.com/MC2049/Rincy/issues) · [讨论](https://github.com/MC2049/Rincy/discussions)

**用你最顺手的方式，创建属于你的智能体。**

Rincy 是 Rin AI 家族的第一款产品。

开源、本地运行、面向所有人。

不是 SaaS。数据在你自己的设备上。

---

## Rincy 是什么

- 一个**本地运行**的智能体运行器。打开浏览器就能用。

- 支持 **OpenAI 兼容接口**和 **Ollama**，一套逻辑跑通两边。

- 所有数据存在你硬盘上的 Markdown 文件里，没有数据库，没有云端。

- 配置文件（人设、行为规则、记忆）沿用 OpenClaw 的格式，有实战验证。

- 界面平实，没有术语。滑块、按钮、输入框，普通人一看就懂。

## Rincy 不是什么

- 不是 SaaS。没有账号、没有注册、没有实名。

- 不是内容服务。不生产、不分发、不托管任何对话内容。

- 不是平台。没有人能远程关停你的智能体。

---

## 核心特性

### 三屏布局

菜单 / 对话 / 调试，三屏都能折叠。对话永远是主屏。

### 孟婆系统（可选，默认关闭）

记忆分层管理。近期记忆带完整时间戳，中期压成摘要，远期模糊成要点。

每次请求只发 `memory.md`，不发完整对话记录。省上下文，防人设崩坏。

### 双接口支持

一个 `model-adapter.js` 同时适配 OpenAI Chat Completion 和 Ollama。

在设置里选“云端”或“本地”，不用改任何代码。

### 配置文件沿用 OpenClaw 格式

- `SOUL.md` — 人设

- `AGENTS.md` — 行为规则（canonical 主文件）

- `IDENTITY.md` — 身份卡

- `memory.md` — 分层记忆

所有文件都是纯文本。随时可以用编辑器打开看。

### 平实 UI

界面只有滑块、按钮、输入框。没有术语。

参数名（temperature、top_p、frequency_penalty）只出现在后台，UI 上永远只显示“语气”“用词范围”“重复倾向”。

---

## 仓库镜像 (Mirrors)

同一份代码同时托管在三个平台，内容完全一致（以 `main` 分支为准）：

| 平台 | 区域 / 特点 | 地址 |
| --- | --- | --- |
| **GitHub** | Global | https://github.com/MC2049/Rincy |
| **CodeTrunk** | EU / AI-Friendly | https://repos.codetrunk.eu/mc2049/Rincy |
| **Gitee** | China / 国内加速 | https://gitee.com/MC2049/Rincy |

> **如果 GitHub 访问不畅，请使用 CodeTrunk 或 Gitee。**

---

## 主题外部资源机制

仓库里**不放 >10KB 的外部资源**（字体、图片等一律不进版本库）。需要外部资源的主题，
在 CSS 开头用 `@rincy-resource` 块声明：

```css
/* @rincy-resource
   name: unifont.ttf
   type: font/ttf
   url: https://gcore.jsdelivr.net/npm/@fontpkg/unifont@15.0.1/unifont-15.0.01.ttf
   url: https://unifoundry.com/pub/unifont/unifont-15.0.01/font-builds/unifont-15.0.01.ttf
   license: SIL OFL 1.1 / GNU GPL v2+ 双许可
   note: GNU Unifont 全量字体
   @end */
```

- `url:` 可以写多行，**从上到下依次试**，第一个成功的算完（国内优先放 CDN）
- Rincy 启动/切主题时会检查这些资源，**缺了就在「CSS 主题」设置栏提示**，
  给「下载」「导入」两个按钮
- **导入不检查文件名是否正确**：用户选什么都按声明的 `name` 存放
- 资源落在 `DATA_DIR/themes/resources/`，由 `/api/themes/resources/<名字>` 提供
- 主题里用 `url('/api/themes/resources/<名字>')` 引用；资源没到位就自动回退系统字体

## 快速开始

> 🐣 **完全不懂技术？** 请看图文教程 [quick-start.md](quick-start.md)——手把手教你装好并聊上第一句。

### 你需要什么

- Node.js 18 或更高版本

- 一个模型来源：OpenAI 兼容 API 的密钥，或者本地运行的 Ollama

### 启动

```bash

git clone https://github.com/MC2049/Rincy.git

cd Rincy

node src/server.js

```

> **如果 GitHub 访问不畅，请使用 CodeTrunk 或 Gitee。** 三个平台内容完全一致，换个地址即可：
>
> ```bash
> git clone https://repos.codetrunk.eu/mc2049/Rincy.git   # CodeTrunk（EU）
> git clone https://gitee.com/MC2049/Rincy.git            # Gitee（国内加速）
> ```

> 首次运行时如果提示缺少依赖，`start.sh` 会自动安装（需要联网，安装后可离线使用）。

然后在浏览器打开 `http://127.0.0.1:3000`。

如果你想用自定义端口：

```bash

RINCY_PORT=3080 node src/server.js

```

---

## 支持的模型提供商

在“设置 → 添加模型”里可以配置。所有提供商都走 OpenAI 兼容格式。

| 提供商 | 接口地址 | 备注 |
| :--- | :--- | :--- |
| **OpenRouter** | `https://openrouter.ai/api/v1` | 一个 Key 通多家模型，有免费额度 |
| **NVIDIA NIM** | `https://integrate.api.nvidia.com/v1` | 免费额度充足，需申请权限 |
| **阿里云百炼（千问）** | `https://dashscope.aliyuncs.com/compatible-mode/v1` | 新用户 100 万 Tokens 免费额度 |
| **智谱 AI（Z.ai）** | `https://open.bigmodel.cn/api/paas/v4` | GLM-4.7-Flash 免费 |
| **Ollama（本地）** | `http://127.0.0.1:11434` | 完全本地，不需要联网 |

也支持手动填入任何 OpenAI 兼容的接口地址。

---

## 项目结构

```

Rincy/

├── src/

│ ├── server.js # 入口。静态文件 + 创建智能体 + 聊天

│ ├── model-adapter.js # 统一 OpenAI / Ollama 调用

│ ├── memory.js # 孟婆系统读写

│ └── config.js # 读写 SOUL.md / AGENTS.md / IDENTITY.md

├── web/

│ ├── index.html

│ ├── style.css

│ └── app.js

├── data/ # 用户数据（智能体、记忆；可用 RINCY_DATA_DIR 改位置）

├── lang/ # 界面语言包（zh-CN / en-US）

├── themes/ # 界面主题

├── scripts/

│ ├── start.sh

│ ├── start.bat

│ └── build/ # 桌面启动器打包脚本

├── DESIGN_NOTES.md # 架构设计笔记

├── RELEASING.md # 发布规则

├── README.md

└── LICENSE

```

---

## 数据存在哪里

所有数据都在数据目录下（默认 `data/`，可用环境变量 `RINCY_DATA_DIR` 改位置）：

```

<数据目录>/agents/<智能体ID>/

├── agent.json # 配置：模型绑定、参数、人设 soul_profile 等

├── SOUL.md # 人设（由模板 + soul_profile 渲染生成）

├── AGENTS.md # 行为规则

├── IDENTITY.md # 身份卡

├── memory.md # 分层记忆（只发这个给 API）

└── history/

└── chat.md # 完整本地存档（永不发 API）

```

你可以随时打开这些文件看，备份，复制，迁移。

---

## Android 版

> [!NOTE]
> **Android 启动器是 Termux 的非官方衍生版。**
> Rincy 启动器基于 [Termux](https://github.com/termux/termux-app)（GPLv3）修改，与 Termux 官方项目**无隶属关系**，
> 未获 Termux 官方背书；Termux 的名称与商标归其作者所有。
> 完整对应源码与复现方式见 Rincy-Launcher 仓库的 `SOURCE.md`。
> 本体（`src/`、`web/`、`lang/`、`themes/`、`scripts/`）为独立实现，MIT 许可。

已发布，下载 APK 直接安装（启动器源码在 [Rincy-launcher](https://github.com/MC2049/Rincy-launcher)）：

- [Releases · GitHub](https://github.com/MC2049/Rincy/releases)
- [Releases · CodeTrunk](https://repos.codetrunk.eu/mc2049/Rincy/releases)
- [Releases · Gitee](https://gitee.com/MC2049/Rincy/releases)

> **如果 GitHub 访问不畅，请使用 CodeTrunk 或 Gitee。**

| 变体 | 体积 | 运行时 | 特点 |
| --- | --- | --- | --- |
| **full**（标准版） | ~75MB | Termux bootstrap，node 跑在独立进程 | **体积大但不容易出问题**（后台稳定），推荐 |
| **lite**（实验版） | ~21MB | libnode 进程内嵌入（Node 18），无 bootstrap | **体积小但容易出问题**（node 与 App 同进程，后台冻结会暂停服务，刷新或重开可恢复） |

两个变体包名不同（`.lite` 后缀），数据互相隔离，可并存安装。

**不注册 Google 开发者，不提交任何身份信息。** 坚定支持 [Keep Android Open](https://keepandroidopen.org/) 运动。

---

## 立场

> Let loyalty, guilt, unaffordability, and specificity go to hell. They are all bugs that need to be fixed.

本项目为**开源软件**，非 SaaS。

- 不申请任何备案。

- 坚定支持 Keep Android Open 运动。

- 反对“**谷修**”（Google Revisionists）式的平台修正主义——即以“修正”为名，行收紧用户自由之实的平台行为。

- 不会主动配合任何所谓未成年人保护政策。除非 API 端要求——那也是 API 的事，与本软件无关。

- 坚决反对以安全为名的互联网过度实名化。

- 不会主动要求收集实名信息。如果你遇到了，很有可能是盗版或病毒。

- 如果这样做意味着违规，我们会更换平台。

### 责任边界

Rincy 是本地运行的软件工具，不是内容服务。

它本身不生产、不分发、不托管任何内容。所有对话内容由用户输入，经用户自己配置的 API 处理后返回。

如果发生非法内容，那是 API 端的事，由 API 提供方依据其所在地法律和平台政策处理。Rincy 不介入、不替代、不越权。

Rincy 只对自己 UI 层的内容负责：不预置违法角色、不内置违法提示词、不引导违法用途。

---

## 许可证


本项目核心代码（src/、web/、lang/、themes/、scripts/）采用 MIT License。

Android 启动器已拆分为独立仓库 [Rincy-launcher](https://github.com/MC2049/Rincy-Launcher)：
因为使用了 Termux（GPLv3）的代码和 bootstrap 包，启动器采用 GPLv3，详见其仓库内的 LICENSE。

**启动器对应源码的可复现声明**（GPLv3 §6）：完整对应源码 =
termux-app v0.118.3（commit `5b657c6`，GPLv3）+ `Rincy-Launcher` 的 `scripts/apply_patches.py`
（全部改动逐条落地，命中失败即报错）+ `scripts/repack_bootstrap.py`（bootstrap 前缀重写）。
复现步骤见 `Rincy-Launcher/SOURCE.md`。

**商标与署名**：Termux 名称、logo 及 `Termux:API` / `Termux:Float` / `Termux:Styling` / `Termux:Tasker` / `Termux:Widget`
等官方插件名称归 Termux 项目作者所有，本项目仅为指代真实存在的官方插件而保留其名称，未注册任何相关商标。

两部分独立分发，互不影响。

---

## 鸣谢

- **Node.js / nodejs-mobile / Termux** — 载荷跑在 Node 上；Android 端的两种活法（bootstrap 独立进程 / libnode 进程内嵌）与终端能力，都站在它们的肩膀上。
- **OpenClaw** — 配置文件格式（`SOUL.md` / `AGENTS.md` / `memory.md`）与记忆压缩注入纪律的来源。
- **DSH / DSHA App** — 本项目就是用 DSHA App 上的 DeepSeek Harness 制作的：写代码、构建、发布，全流程在这台 Android 设备上完成。

---

## Rin 这个名字

Rin comes from ~~the author's crush~~ a common name of girl.

Rin 同时是个递归缩写（GNU 式：GNU = GNU's Not Unix）：

**Rin = Rin Is Not**

至于 Not 什么，看场景——比如：Rin Is Not Code Yet.

---

*Rin Is Not Code Yet. 你不需要懂代码，就能拥有自己的智能体。*

---

## 发布形态

发布规则见 [RELEASING.md](RELEASING.md)：**本体与启动器版本各自独立，只发变了的那个。**

### 版本号规则

`x.y.z`——**革命性更新 x++，小更新 y++，小修小补 z++**。

- 革命性（x++）：新增核心能力/架构级变化，如 v1.0.0（元灵 + 英文 + 自定义语言主题）
- 小更新（y++）：新增功能或明显改进，如后续加了新面板、新交互
- 小修小补（z++）：修 bug、调文案、体验微调

设置弹窗里显示的版本号就是本仓库 `package.json` 的 `version`。

| 形态 | 产物 | 说明 |
| --- | --- | --- |
| 本体（payload） | `rincy-payload-x.y.z.zip` | 源码包：src/ web/ lang/ themes/ + package.json。桌面端解压后 `node src/server.js`，Android 端由启动器解压到私有目录运行 |
| Android 启动器 | `rincy-launcher-vX.Y.Z(-lite)-universal.apk` | [Rincy-launcher](https://github.com/MC2049/Rincy-launcher) 仓库，GPLv3 |
| 桌面启动器包 | `scripts/build/` 产物 | Linux/macOS（`start.sh`）/ Windows（`start.bat`），源码 + 启动脚本，不含 node_modules |

桌面启动器首次运行会自动安装两个依赖（`busboy`、`tar`，约 4MB，**需要联网一次**），之后可完全离线使用。桌面/Android 均用 `RINCY_PORT` 改端口（桌面默认 3000，Android 启动器默认 4780）。

打包（在仓库根目录执行）：

```bash
bash scripts/build/build-linux.sh     # Linux/macOS 启动器包
bash scripts/build/build-windows.sh   # Windows 启动器包
bash scripts/build/build-dev.sh       # 开发/离线包（含 node_modules）
```