BOKI — 开放式 AI 的开源财务软件

开放式 AI · 离线可跑 · AI 只写草稿，数据不出门

演示 · 功能 · 快速开始 · 下载安装包 · 官网 · 码云镜像

BOKI 是什么

一套装在自己电脑上的开源财务软件：录入凭证、出报表、管多家公司，AI 帮你记账，数据库整库加密，断网也能用。

• 给谁用：小微企业、个体工商户、代理记账公司，以及要求数据不出内网的团队
• 凭什么：库文件被拷走也打不开（SQLCipher 整库加密）；没有云端、没有埋点、没有遥测，数据外传 0 字节
• AI 怎么放：接口全开，落点收紧——模型随你换（本地 / 内网 / 云端）、一句话随便说、外部 AI 客户端可接；但所有写入只落草稿，人点了才生效
• 离线到什么程度：本地 OCR + 本地语音识别 + 本地大模型三件套，拔掉网线，识别、听写、记账、查账照样跑
• 怎么用：免环境安装包装完即用；内核免费开源，要什么功能装什么插件（14 个官方插件）

🎬 30 秒演示：AI 一句话记账

打字或说话都行。AI 解析成凭证草稿，你确认后才入账 —— 本演示由真实运行实例录制。

🔍 下载高清版 MP4（1440p，15 秒）

流程只有三步：

1. 说一句话 ——「记一笔 800 的水电费，银行付的」，支持语音（按住 Alt）或直接打字
2. 改确认卡片 —— AI 生成凭证草稿：科目、金额、往来单位全部可改，科目只能从科目表选，不会写错
3. 确认执行 —— 一律生成草稿凭证，在凭证列表复核、审核后才正式入账，AI 永远不直接动账

同一套能力还覆盖：发工资、添加员工、修改凭证、审核凭证、申请借款单、申请报销单，以及上传发票 PDF / 扫描件自动识别生成凭证（本地 OCR）。七类操作全部先预演、再人工确认，操作留审计记录。

🔓 开放式 AI：接口开放，落点收紧

大多数「AI 财务」把模型锁在厂商服务器上，也顺手把改账的权力交给了模型。我们反过来：接什么都行，改什么都不行。

收紧的是三道锁：

1. 草稿闸门 —— 动作落点只有 draft（草稿）/ list（待办清单）/ archive（档案），没有 direct。启动期校验：未声明落点或写成直通，注册直接失败；运行期 assertDraftOnly 扫结果，出现 approved / paid / posted 立即抛错，而不是静默接受。
2. 一次性令牌 —— 确认动作绑定「当前用户 + 载荷哈希」，15 分钟过期。换个账号拿同一个令牌提交，返回「该指令由其他用户发起」；跨公司、重放同样拦。
3. 只读 MCP —— 注册表只接受 readOnly: true 的工具。当前 8 个工具全部是查询；外部客户端就算硬写 voucher.create，也只会得到「工具不存在」。

# 外部 AI 客户端查一次科目余额（只读；鉴权与网页端同一套 JWT）
curl -s http://127.0.0.1:3000/api/mcp \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"account.balance","arguments":{"period":202611}}}'

• 工具清单：voucher.search · voucher.get · account.search · account.balance · books.trial_balance · books.ledger · hr.loan.search · hr.expense_claim.search
• 只实现 POST 一条 JSON-RPC 传输，不开 SSE、不提供 resources / prompts / sampling——暴露面越小，只读越守得住

一句话记住：模型负责听懂，网关负责拦住，人负责点头。

🧩 它能做什么

科目余额表 — 期初、本期借贷、期末余额，余额方向由复式记账规则自动判定

插件市场 — 官方插件一键安装，自动补齐依赖，有更新直接显示「更新」按钮

🚀 快速开始

方式一：下载安装包（推荐）

当前最新版本 v1.1.0，安装包文件名 BOKI-Setup-1.1.0.exe（约 410 MB）。自带运行时，离线可装；由 西安市未央区鹏云智码软件开发部（个体工商户） 签名发布。浏览器提示 SmartScreen 拦截时点「仍要运行」即可。

方式二：源码运行

# 终端 1 —— 后端（端口 3000）
cd backend
npm install
copy .env.example .env        # macOS/Linux 用 cp
npm run start:dev             # 首次启动自动建加密库 + 种子数据

# 终端 2 —— 前端（端口 5173）
cd frontend
npm install
npm run dev                   # 打开 http://localhost:5173

默认账号（首次登录后请改密码）

离线 AI 能力按需下载模型：npm run models:fetch（OCR 约 25MB）、npm run models:fetch-asr（语音识别约 160MB）；大模型可接 Ollama / llama.cpp 本地推理，也可接 DeepSeek、通义千问等云端 API。模型没就绪不影响其余功能使用。

🔐 离线 AI 与数据安全：四句话说清

1. AI 全链路可离线：本地 OCR（约 25MB）、本地语音识别（约 160MB）、本地大模型（Ollama / llama.cpp）三件套，模型权重留在你自己的机器上；拔掉网线，识别、听写、记账、查账照样跑。
2. 数据库整库加密，默认开启、零配置：密钥文件 vault.key 生成在程序目录，没有它库就打不开——备份 / 搬机器请务必连它一起带走。附件走 AES-256-GCM。
3. 默认零外传：无云端依赖、无第三方 SDK 回传、无埋点遥测，代码可审计。只有你自己在「AI 模型接入」里配了云端 API，才会产生一个由你决定的出口——这条我们不会含糊。
4. AI 越不过人的确认：写入只落草稿、令牌绑人绑载荷、只读 MCP 没有写工具、每一步落审计表。AI 可以很快，但不能替你做主。

安全架构细节（HKDF 密钥派生、附件加密、备份校验、已知边界）见官网与 SECURITY.md；AI 的边界设计与三道锁的代码位置见下文「开放式 AI」与 SECURITY.md。

🧱 14 个官方插件

在应用内「插件市场」安装；插件唯一来源是远程插件市场（配置 PLUGIN_MARKET_URL 与验签公钥），详见官网插件开发指南。零插件状态也能完成「登录 → 建账 → 记账」完整闭环。

📁 更多文档

• 社区规范：CONTRIBUTING · 行为准则 · 安全策略 · 隐私 · 条款 · 治理
• 内部技术口径（《AI 智能化方案》《插件发布与升级手册》）与运营方案仅本地维护，不随仓库分发；对外口径以本 README 与官网为准，避免多版本并存。

💬 联系与支持

BOKI 由西安市未央区鹏云智码软件开发部（个体工商户）开发维护

• 企业私有化部署 / 商业授权（豁免 AGPL 传染性）：邮件说明规模与部署环境，可开票
• 赞助：爱发电 / 微信 / 支付宝，企业赞助见 SPONSORS.md

📄 License

• 内核（backend / frontend / desktop）：AGPL-3.0 —— 自由使用、修改、分发；改成网络服务对外提供时须同样开源
• 官方插件：Apache-2.0，可自由复用
• 闭源商用请购买商业授权；品牌资产（logo / 商标）不在开源许可范围

_{BOKI — 你的数据，永远只属于你。}