Skip to content

WINDGAND/Bailin

Repository files navigation

百灵 Bailin

桌面上的百变魂灵 —— 60 秒造一个视角型 AI 角色,像素桌宠常驻桌面,Ctrl + Shift + P 随手可问。

English · 汉语

百灵 Bailin

MIT License Windows Node >= 20.10 Electron 32

概览 · 快速开始 · 使用场景 · 产品体验 · 受启发而非模仿 · 隐私 · 免责声明 · 开发者


概览

百灵 Bailin 是一个完全本地运行的开源 Windows 桌面 AI 角色伴侣。它做两件事:

  1. 造一个 ta — 输入名字,60 秒(快速)或 5–8 分钟(深度),蒸馏心智框架 + 表达 DNA + 像素形象。
  2. 请 ta 上桌 — 桌宠常驻屏幕右下角;Ctrl + Shift + P 或点击桌宠唤起聊天;单击系统托盘图标打开设置 / 角色仓库。

Tip

不是「让 AI 表演成 XX」,而是「让 AI 用 XX 的视角看你的问题」。


核心功能

能力 说明
快速 / 深度造人 快速模式 ~60s;深度模式 6 Agent 调研 + 质量自检
像素桌宠 DSL 或 hatch-pet 图集;透明置顶、可拖拽、透明区鼠标穿透
视角型对话 心智模型 + 决策启发式 + 表达 DNA 组装 system prompt
本地记忆 用户画像自动学习,可编辑 / 清空
主动陪伴 可选智能截图 whisper + 独立气泡窗
零订阅 自带 OpenAI / Anthropic / 兼容 API Key;Windows DPAPI 加密

快捷键

操作 快捷键 / 入口
唤起 / 关闭聊天 Ctrl + Shift + P
打开设置 / 角色仓库 单击系统托盘图标
关闭聊天窗 Esc

快速开始

Note

推荐从 Releases 下载 Bailin-Setup-0.0.1.exe(Windows x64)。亦可按下方步骤源码构建。

环境要求

  • Windows 10 / 11
  • Node.js ≥ 20.10
  • pnpm 9(corepack enable

安装与运行

git clone https://github.com/WINDGAND/Bailin.git
cd Bailin
pnpm install          # 自动 build packages + rebuild better-sqlite3
pnpm dev              # Vite + tsc watch + Electron

首次启动会进入首启向导:免责声明 → 配置 API Key → 创建或导入角色 → 桌宠上桌。

开发调试可在项目根目录配置 .env.dev(参考 .env.dev.example)注入 LLM 凭据。


使用场景

写东西卡住了

你在改一份重要文档,思路乱了。按 Ctrl + Shift + P,把「核心想表达 X,但写出来很啰嗦,怎么砍?」扔给桌面上的思维顾问 —— ta 会从自己的视角给你结构建议,而不是泛泛的 AI 腔。

决策需要换角度

你在犹豫一个职业选择。问 ta:「这件事的反向思考是什么?」—— 三个反向问题往往比直接给答案更有用。

桌面需要一点陪伴

工作累了一天,和 ta 说几句不咸不淡的话。ta 不会说教、不会偏离人设,桌面也不会那么冷。


产品体验

从造人到上桌,四步闭环:

1. 创建角色

首启向导或设置 → 创建:选来源(公众人物 / 虚构 / 原创)与定位(思维顾问 / 情感陪伴),可选参考图,快速或深度创建。

创建角色 · 快速与深度两种模式

内置 starter 列表默认为空,可在 apps/desktop/src/shared/starters.ts 追加 CharacterBundle

2. 角色仓库

搜索、切换当前桌宠、查看心智模型摘要,或重画形象 / 换参考图。

角色仓库 · 列表与详情

3. 桌宠上桌

像素小人出现在桌面右下角 —— 可拖拽,透明区域不挡操作。

像素桌宠

4. 随手唤起聊天

聊天窗附着在桌宠旁,流式 Markdown 回复,不抢工作焦点。

聊天窗 · 桌宠与对话同框

更多设置截图

角色仓库内嵌聊天预览

用户画像 · 自动学习与记忆

桌宠与陪伴 · 大小与主动气泡

模型与 API Key 配置

外观与语言设置


受启发而非模仿

百灵不在 AI 里塞「XX 的常用台词」—— 那样越聊越像劣质 cosplay。

百灵蒸馏的是思维骨架

  • 心智模型 — ta 看世界用的几把尺子
  • 决策启发式 — 岔路口的习惯判断
  • 表达 DNA — 句子的节奏、标志性短语、回避的话题
  • 内在张力 — 矛盾与未解之处

LLM 拿到骨架后,用 ta 的角度看你的问题,而不是模仿 ta 演戏。

女娲 Skill「造人术」启发,产品化为可随手用的桌面伙伴。


隐私与本地优先

  • 零订阅 — 自带任意兼容 API Key
  • 完全本地 — 角色、对话、用户画像存于本机 SQLite,不上报遥测
  • Key 加密 — Windows DPAPI,渲染进程不接触明文 Key
  • 一键清空 — 设置里可清掉所有数据与 Key

数据目录:%APPDATA%/Bailin/(卸载时删除该文件夹即可完全退出)


致谢

项目 致谢内容 链接
女娲 · 造人术 Skill by 花叔 人格蒸馏方法论与深度调研编排 alchaincyf/nuwa-skill
hatch-pet · 桌宠像素孵化 SKILL canonical 立绘 + 9 行 strip + atlas 拼图范式 openai/skills · hatch-pet

像素美术参考开源 chibi sprite 风格惯例(非具体作品照搬)。若觉得百灵有意思,请给上游项目点 star


免责声明

Important

请在使用前完整阅读本节。继续使用本工具即视为你已阅读并同意以下条款。

1. 关于本工具的性质

百灵 Bailin 是一个完全本地运行的开源工具。它本身不提供任何角色内容,所有角色都由你(终端用户)自行输入、自行生成。本工具:

  • 仅承载技术能力(蒸馏、渲染、对话编排),不预设、不分发任何特定真人 / IP 角色素材
  • 仅在你自己的电脑、用你自己的 LLM API Key 调用模型;作者不接触你的对话内容
  • 所有生成结果均强制标注 「受其启发,非本人 / 非官方 / 非授权」 硬标识
  • 角色形象采用像素抽象化处理,不构成原型外貌的精确复刻

2. 关于真实人物

若角色受任何真实人物启发,请自行评估所在司法辖区的肖像权、名誉权、隐私权等规定。

  • ❌ 不得伪装成 ta 的真实观点 / 声明 / 立场
  • ❌ 不得用于诽谤、攻击、煽动、性化、骚扰
  • ❌ 不得未经授权用于商业、营销、宣传
  • ⚠️ 强烈建议:对在世人士仅作个人学习参考,不公开传播

3. 关于虚构 / IP 角色

  • ✅ 可以:仅供个人欣赏、学习、研究的私人使用
  • ❌ 不可以:公开分发含他人 IP 的 .bailin 角色包;在视频 / 直播 / 社交媒体商业化使用
  • ⚠️ 若 IP 持有方明确反对二创,请尊重并停止使用

4. 关于参考图

上传图片须为你拥有版权、公共领域、合理使用范围,或已获授权的内容。启用 Vision 时,图像按 LLM 服务商规则上传至其 API。

5. 关于内置示例

当前开源版默认不包含内置示例(STARTER_BUNDLES 为空)。若自行追加 starter,请遵守上述边界。

6. 作者责任范围

本工具以 MIT License 开源,按「现状」提供,不提供任何明示或默示担保。作者不对用户使用产生的法律后果承担责任。

7. 下架与争议处理

异议或下架请求请通过 GitHub Issue(标题前缀 [Takedown])提交,附身份证明、异议对象与诉求。收到合理凭证后 7 个工作日内响应。


开发者文档

安装、构建、协议与验证 — 点击展开

仓库结构

bailin/
├── apps/desktop/                 # Electron 应用(main / preload / renderer)
├── packages/
│   ├── character-protocol/       # CharacterCard / SpriteProgram schema
│   ├── prompts/                  # 蒸馏 / 调研 / 对话 / hatch-pet 提示词
│   ├── sprite-runtime/           # DSL 渲染器 + 状态机 + guard 沙箱
│   └── pet-atlas-tools/          # hatch-pet atlas 裁帧 / 拼图 / 校验
├── assets/                      # README 用截图
├── apps/desktop/src/shared/starters.ts  # 可选内置 starter(默认空)
└── scripts/
    └── verify/                   # 离线回归脚本(无需 Electron;多数需先 pnpm build)

常用命令

pnpm build            # packages + main + preload + renderer
pnpm typecheck        # 全仓类型检查
pnpm dev              # 开发模式

架构概要

层级 职责
Main 托盘 / 快捷键、LocalVault(SQLite)、LLMAdapter、BailinOrchestrator、CharacterRuntime、DPAPI
Pet / Chat / Settings / Bubble 四窗口 MPA;Pet 用 Canvas + Worker 跑 SpriteProgram
packages/ 协议、提示词、渲染运行时与图集工具 — 与 Electron 外壳分离

一个角色 = CharacterBundle = { card, sprite, runtime }(见 packages/character-protocol)。

部分 作用
CharacterCard 人格:心智模型、启发式、表达 DNA
SpriteProgram 形象:DSL JSON 或 hatch-pet atlas
RuntimeConfig 温度、上下文等运行参数

设计原则:协议优先(变更须升 schemaVersion);Sprite 在 Worker 沙箱执行;零云服务前提。

验证脚本

先构建主进程与 packages 产物,再运行(均不启动 Electron):

pnpm build

核心 smoke(改 atlas / sprite / adapter 后建议跑):

node scripts/verify/verify-hatch-pet.mjs          # atlas 裁帧 / 拼图 / schema
node scripts/verify/verify-sprite-builder.mjs     # sprite-builder + schema
node scripts/verify/verify-llm-multimodal.mjs     # 多模态请求体(mock fetch)
node scripts/verify/verify-starters.mjs             # starter / 程序化 sprite 质量门槛

更多离线回归:

node scripts/verify/verify-character-names.mjs
node scripts/verify/verify-character-quote.mjs
node scripts/verify/verify-merge-research.mjs
node scripts/verify/verify-profile-extraction.mjs
node scripts/verify/verify-web-search-strictness.mjs
node scripts/verify/verify-pet-window-bounds.mjs
node scripts/verify/verify-pet-clamp-stability.mjs
node scripts/verify/verify-chat-turn-delete.mjs
node scripts/verify/verify-segment-buffer.mjs
node scripts/verify/verify-create-pipeline-fallback.mjs   # 1–3 步离线;第 4 步生图需 .env.dev(可跳过)

verify-hatch-pet 会在 .smoke-out/ 写出样例 PNG(已 gitignore,可删)。

无障碍自动扫描(需 pnpm dev 已启动):

cd apps/desktop
pnpm add -D puppeteer axe-core   # 首次
node ./scripts/a11y-scan.mjs

数据目录

%APPDATA%/Bailin/
├── vault.db
└── research/<charId>/    # 深度蒸馏调研存档

路线图

阶段 主题 代表能力
v0.x(现在) MVP 闭环 快速造人、桌宠、本地记忆、Windows、自带 Key
v1.0 体验提升 深度造人完善、对话 UX、自动更新(opt-in)
v1.1 多角色 多只桌宠同时在桌
v1.2+ 养成 / 陪伴 关系记忆、主动气泡增强
v2.0+ 平台化 .bailin 角色包(仅原创 / 公域)
v3.0+ 跨端 macOS / Linux、移动端伴侣

参与贡献

仓库处于早期 v0.0.1,欢迎:

  • 像素 sprite 风格 / 调色板扩展
  • 新的 perspective skill(仅原创 / 公共领域人物
  • Bug fix(附复现步骤 + 系统环境)
  • 文档 / 翻译

请遵守 免责声明含他人 IP 角色素材的 PR 一律不予合并


Star History

Star History Chart

桌面上的百变魂灵 · MIT 开源 · 不收一分订阅

文档最后审阅:2026-06-22

About

60 秒造人,请上桌面 —— 开源本地 AI 桌宠,用 ta 的视角陪你看问题

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors