文档

启动向导

启动向导在您首次打开应用时运行。它将引导您选择使用模式、选择启用 AI 功能、设置加密和同步,并查看后续步骤 — 让应用根据您的实际使用方式进行调校。

选择您的模式

设置步骤

1. 选择您的语言以及最符合您使用方式的模式 — 个人管家、库存专业版 或 完整版。
2. 在 AI 超能力 屏幕上,决定是否启用图像识别(拍摄照片,AI 自动填写物品详细信息)和销售描述(AI 为市场撰写吸引人的清单)。
3. 在 个性化设置 中调整外观,在 锁定保护? 中选择启用端到端加密,并在 您的数据存储于此 中启用多设备同步。
4. 查看 全部就绪! 摘要 — 包含添加 AI API 密钥、配置 Square 和启用同步的快速链接 — 然后点击 开始使用 进入主页仪表板。

注意:如果您选择启用加密,向导将运行一个简短的后续流程来创建加密密码并保存恢复短语 — 请将恢复短语保存在安全的地方,因为如果您忘记密码,这是恢复数据的唯一方法。向导中的每个选项都可以稍后在 设置 中更改。

主页仪表板

主页是您的中央控制台。它显示您所有的物品及其签入/签出状态，并通过底部标签栏快速访问所有主要功能。

底部标签导航

应用使用底部标签栏在各主要板块之间导航：

物品管理

物品是 Where The Bleep 的核心。每个物品可以包含照片、描述、分类、元数据（序列号、购买价格、估计价值、保险信息）以及位置分配。

创建物品

1. 在主页点击 + 按钮
2. 添加标题和描述 — 或点击 AI 相机按钮 拍照，让 AI 自动生成
3. 从选择器中选择一个类别
4. 通过浏览位置树来分配一个位置
5. 可选添加照片、序列号、购买价格、估值和保险信息
6. 如果需要跟踪数量，请开启库存管理
7. 点击保存

物品状态

物品操作

位置

位置按层级结构组织。容器位置（房间、建筑、柜子）可以包含其他容器或目标位置。目标位置是物品存放的具体位置 — 特定的架子、抽屉或箱子。

位置功能

• 面包屑路径——例如"家 > 办公室 > 书桌"
• 旭日图——交互式可视化展示您的整个位置树
• QR 标签 — 为任何目标位置生成可定制的 QR 码标签,提供两种 Avery 模板格式
• 物品数量——查看每个位置存放了多少物品
• 导出为 PDF — 将 QR 码标签页导出为 PDF,可在标准标签纸上打印
• 选择性重新打印 — 仅打印未打印的标签、重新打印单个标签或一次性打印所有标签
• 搜索 — 全文和语音搜索,可按名称或存储内容快速跳转到任何位置

管理位置

二维码与标签

每个目标位置都可以拥有一个二维码标签,扫描后即可立即打开该位置并执行物品的存入或取出操作。标签可完全自定义,并可打印为两种 Avery 模板 — Avery 5160(1 × 2-5/8 英寸)或更大的 2 × 4 英寸格式。标签使用 belongings://loc/{uuid} URI 方案,任何支持深层链接的二维码扫描器都可以打开它们。

二维码标签工作流程

1. 导航到目标位置
2. 点击二维码图标以生成标签
3. 打印单个标签，或使用批量 PDF 导出一次打印多个
4. 将标签贴在实际位置上（架子、箱子、抽屉）
5. 要登记物品，请使用应用内相机扫描二维码

二维码状态跟踪

打印选项

• 标签格式 — 选择 Avery 5160(1 × 2-5/8 英寸)或更大的 2 × 4 英寸模板,采用纵向或横向布局
• 自定义标签 — 独立的位置名称和 ID 代码尺寸滑块,以及显示或隐藏导航路径的开关
• 顶部边距偏移 — 调整打印起始位置,使部分使用过的标签纸正确对齐
• 包含条形码数字 — 在每个二维码下方打印原始 ID,以便在无法扫描时手动输入
• 仅打印待重印项 — 在批量运行中跳过已打印的标签,避免浪费纸张
• 另存为 PDF — 在发送到打印机之前在屏幕上预览整张标签

使用"已打印"开关来重新打印单个标签，无需再次批量打印所有标签。

搜索与语音

搜索由 SQLite FTS5 提供支持,可在物品名称、描述和标签中实现极速全文搜索。麦克风使用设备端语音转文字功能,可在应用的所有文本字段上使用 — 不仅限于搜索栏。

搜索功能

• 全文搜索 — 跨名称、描述和标签查找匹配项
• 前缀匹配 — 开始输入即可立即显示结果
• 语音搜索 — 点击麦克风图标，说出您的查询内容
• 按位置筛选 — 将结果缩小到特定房间或区域
• 按类别筛选 — 仅显示特定类别中的物品
• 按状态筛选 — 存储中、已借出、已上架出售等
• 每个字段均支持语音输入 — 麦克风可用于物品名称和描述、列表备注、要价、存入/取出人员姓名,以及应用中的任何其他文本输入
• 位置内搜索 — 在位置树上方使用语音或文字搜索,按名称跳转到房间、抽屉或容器

人员与借用

管理可以借用您物品的人员列表。每个人员可以包含电话号码、电子邮件、地址、关系(家人、同事等)和自由文本备注。应用提供两种独立操作:<strong>取出</strong>将物品从其位置移除,而<strong>借出</strong>则将其分配给特定人员,并可选填<strong>预期归还日期</strong>。已取出和已借出的物品会显示在主页仪表板的各自标签页中,让您始终掌握所有物品的位置。

取出与借出工作流程

1. 在物品详情页面，点击取出将物品从其位置移除，或点击借出将物品分配给某人
2. 选择借出时，从联系人中选择一个人员或创建新联系人
3. 物品状态变更为已取出或已借出，并显示相关人员的姓名
4. 归还时点击 归还 — 物品状态恢复为 在库中

管理人员

事件历史

每次签入、取出和借出都会记录时间戳。可在物品详情页面查看历史记录。

库存跟踪

可为任何物品启用库存计数——独立于签入/签出功能。跟踪消耗品、物资或任何您拥有多件的物品数量。

工作原理

1. 创建或编辑物品时，开启库存管理
2. 设置初始数量
3. 在物品详情页面，使用 + 和 - 按钮调整数量
4. 点击数字本身可手动设置具体数量
5. 所有更改都会记录时间戳并保存在库存历史中

库存报告

点击库存开关旁的报告图标以生成PDF 库存报告。报告包含物品缩略图、当前数量和完整的变更历史表。通过系统分享功能保存或分享 PDF。

条形码扫描

点击库存标签页上的绿色二维码图标，打开库存扫描——实时相机扫描器，包含两个用于调整库存的标签页：收货用于入库商品，手动用于设置确切数量。出库库存由POS中的销售扫描处理，详见Square POS章节。

低库存与缺货

为任何追踪商品设置再订货点。当现有库存数量等于或低于该点时，库存标签页会显示橙色低库存标记；当数量降至零时，会显示红色缺货标记。仪表板摘要图块和主屏幕提醒卡片都会显示该数量，让您无需查找即可发现短缺，低库存和缺货筛选标签可将列表筛选为仅显示受影响的商品。

盘点

从⋮菜单打开盘点，选择目标位置，然后逐一查看该位置的每件追踪商品，输入您在货架上看到的实际数量。屏幕会在您输入的数量旁显示预期数量，并用绿色或红色箭头标示差异。保存后，应用仅记录有变化的商品，并可为每次调整附上可选的原因和备注。

CSV导入

从⋮菜单中选择从CSV导入，并选择包含两列的文件——barcode_or_name和quantity。8到14位数字的数值会被视为条形码；其他内容会与商品名称进行模糊匹配。系统会自动检测第一行为标题。导入操作会被记录为CSV导入调整，以便您将任何更改追溯到该文件。

损坏与损失追踪

当盘点数量短缺时，请用原因标记差异——损坏、误数、过时、变质、失窃或其他。这些原因会汇入⋮菜单下的两份报告：差异报告（每次调整的原始清单）和损耗报告（按原因和日期范围分组的总计），两者均可导出为PDF，用于保险理赔或期末审核。

库存仪表板

库存标签页是所有库存相关事务的主页：包括追踪商品、总单位数和低库存的摘要卡片；全部、低库存和缺货的筛选标签；全文搜索和语音搜索；浮动二维码扫描按钮；打印机快捷方式；以及⋮菜单（可打开盘点、转移、CSV导入和四份内置报告——库存水平、库存变动、估值和损耗）。

Square POS

Where The Bleep 在销售标签页中内置了销售点（POS）系统——这是一个由条形码扫描器驱动的购物车，可移交至 Square 处理刷卡支付。您也可以使用内置的找零计算功能收取现金，或记录通过其他渠道支付的销售。每个收银会话开启时都会显示今日摘要（销售额、退款、净额）以及最近交易列表，您可以重新打印或退款这些交易。

支付方式

结账流程

1. 在销售标签页上，点击绿色的二维码扫描按钮以打开 POS 扫描器
2. 扫描条形码（或从搜索列表中选择）以将商品添加到购物车——数量默认为 1，可在添加到购物车对话框中编辑
3. 在购物车页面上点击支付以打开结账，在此选择支付方式并确认总额
4. 对于读卡器和手动输入卡片，应用会移交至 Square 处理；对于现金支付，输入所收金额，应用将计算找零
5. 销售完成后，将显示面向顾客的收据屏幕——顾客可选择输入电子邮箱，以接收其偏好语言的收据

离线 POS

当应用失去互联网连接时，POS 仍可继续处理非 Square 支付，并将需要服务器往返的内容加入队列。

• 现金和外部销售完全可在离线状态下进行——无需网络
• POS 销售产生的库存调整在本地记录，并在重新连接时立即同步至其他设备
• 电子邮件收据在本地排队，网络恢复后自动发送；面向顾客的感谢页面仍会立即显示

注意：读卡器和手动输入卡片支付在收费时需要有效的互联网连接——Square 必须授权该卡。如果结账过程中网络中断，请切换到现金或外部支付，以其他方式收款，并记录销售以保持库存和报表的准确性。

销售员与操作员

添加销售员（操作员），让 POS 可由多人共同操作，每笔交易都会归属到结账的人员。操作员使用其姓名和可选 PIN 码登录，仅获得您授予的权限，您可以随时使用加密密码切换回管理员身份。

添加销售员

1. 打开设置 > 销售 > 销售员，然后点击添加销售员（或销售员列表上的 + 按钮）
2. 输入姓名和可选的 6 位 PIN 码——没有 PIN 码时，该资料处于开放状态，任何人都可以使用，这对于单一可信场所是可接受的，但对繁忙店面来说并不理想
3. 切换您要授予的权限——库存访问权限、报表访问权限，以及可选的设置过期时间用于限时访问
4. 可选择默认销售来源位置，以便操作员的 POS 销售自动从正确的地点扣减库存

权限级别

限时访问

在添加或编辑销售员时启用设置过期时间并选择日期。该日期之后，其权限将自动撤销，操作员登录页面会显示明确的过期提示——适用于季节性员工、合同工或您只想授予临时访问权限的人员。

事件标记与审计追踪

每笔销售、退款、库存调整和盘点都会标记执行操作的操作员，包括以管理员身份登录时所执行的交易。这些标记会显示在交易列表、库存事件历史和导出的报表中——让您始终了解谁在何时做了什么。

注意：从操作员会话切换回管理员需要加密密码（如未启用加密则为设备解锁）。这可防止已登录的操作员更改设置、删除其他操作员或查看其不应看到的现金抽屉报表。

出售与市场平台上架

在 7 个支持的市场平台上架出售物品。AI 根据您的物品数据自动生成商品详情，应用还可生成 PDF 销售单，方便您在发布时参考。

支持的市场平台

上架流程

1. 前往出售标签页，点击新建商品列表
2. 从可搜索的物品选择器中选取一个物品
3. 选择一个市场
4. AI 自动填充商品列表字段：标题、价格、分类、成色和描述
5. 每个销售平台有其专属的附加字段（例如 eBay：品牌、UPC、运费；Poshmark：部门、尺码）
6. 在审核页面上查看并编辑所有内容
7. 生成PDF 销售单——包含物品照片、所有商品列表详情，以及链接到销售平台创建商品页面的二维码
8. 保存到下载目录，或通过 AirDrop、电子邮件或即时通讯分享

销售跟踪

物品按销售状态流转：已上架出售 → 已售出 – 未发货 → 已发货。销售仪表板展示活跃的上架商品（包括已售未发货的物品）、完整的销售历史记录，以及包含买家详情、定价、费用和净收入的汇总统计。可生成任意日期范围的 PDF 或 CSV 销售报告。

销售用 Square 集成

除了在 POS 上接受面对面的银行卡付款外，Square 链接还为 电子邮件收据 提供支持 — 当连接了有效的 Square 电子邮件收据订阅时，可以直接从 POS 感谢屏幕以买家偏好的语言发送面向客户的收据。在 设置 > 销售 > Square 付款 下授权 Square 一次后，银行卡付款和电子邮件收据将共享同一连接。

收据

每笔 POS 销售都以面向客户的 感谢 收据屏幕结束，显示订单项、总额、付款方式以及（现金支付时的）找零金额。客户可以选择输入电子邮件，以便以他们偏好的语言接收收据，您还可以从 最近交易 列表中重新打印或退款任何历史销售。

收据功能

• 多语言 — 收据在销售时自动翻译为客户选择的语言（支持 18 种语言）
• 两种发送渠道 — 买家可在您设备上阅读的面向客户屏幕，以及发送至其地址的可选电子邮件收据
• 按需重新打印 — 最近交易 中的每笔交易都可以打开完整的收据详情页面，您可以重新发送、保存为 PDF 或退款
• 现金找零跟踪 — 现金销售时，收据会记录支付金额和找零金额，使审计记录清晰明确

收据工作流程

1. 在 POS 中完成一笔销售 — 面向客户的收据屏幕会自动显示总额和语言选择器
2. 将设备交给客户；屏幕使用较大字体并提供语言选择器，使他们能舒适阅读并随时切换语言
3. 如果客户希望通过电子邮件接收副本，他们输入地址并点击 发送收据 — 电子邮件将以其选定的语言排队发送
4. 点击 完成 以返回 POS 扫描器，准备进行下一笔销售

自定义收据

收据品牌信息从 设置 > 销售 > 业务信息 中提取 — 您的企业名称、地址、电话、电子邮件、税号和邮编将显示在顶部。在 设置 > 销售 > 电子邮件选项 下配置电子邮件发件人：选择内置的 Where The Bleep 邮件服务（需订阅）或您自己的 自定义 SMTP 服务器，以便收据从您自己的域名发送。

注意：电子邮件收据需要发送时有互联网连接，但如果您离线，它们会在本地排队，并在网络恢复后立即发送。面向客户的感谢屏幕无论在线或离线都会立即显示。

加密与安全

Where The Bleep 采用零知识端到端加密。您的数据在上传到云端之前已在设备上加密。我们无法读取您的数据——只有您可以。

加密详情

密钥层级

您的密码通过 PBKDF2-HMAC-SHA256（600K 次迭代）派生出一个 主密钥（256 位）。从主密钥进一步派生出三个子密钥：

• DEK（数据加密密钥）——加密物品字段、名称、描述
• FEK（文件加密密钥）——以 64 KB 分块加密图片和文档
• SIK（搜索索引密钥）——生成盲索引以支持服务器端查询

解锁选项

暴力破解防护

密码输入失败后将触发指数级退避锁定：30 秒 → 5 分钟 → 15 分钟 → 1 小时。

双因素身份验证

将身份验证器应用与您的帐户配对，在密码之上增加一层保护。在 设置 > 安全 > 双因素身份验证 下进行设置 — 任何兼容 TOTP 的应用都可以使用（Google Authenticator、Authy、1Password、Microsoft Authenticator）。配对后，在新设备上登录需要您的密码和应用中刚生成的 6 位数代码。

网络安全

• 证书透明度监控 — 针对每个 API 端点的 TOFU TLS 证书跟踪
• 证书变更检测 — 当证书指纹发生意外变更时发出警报
• 在 Android 上阻止明文流量 — 不允许未加密的 HTTP 连接
• 证书监控屏幕 — 查看每个端点的证书颁发者、到期时间、指纹和变更历史（设置 > 安全 > 证书监控）

云同步

Where The Bleep 采用 离线优先 设计 — 无需网络即可完整使用。云同步为可选功能，仅限 Pro 订阅用户使用。

同步工作原理

• 所有数据均存储在本地 SQLite 中 — 应用无需联网即可使用
• webDocsSyncFeature2
• 数据在离开您的设备之前即已加密 — 服务器只能看到加密后的数据列
• 冲突检测 — 行级别的后写入优先策略，冲突记录在事件审计日志中
• 删除同步 — 在设备 A 上删除的项目会自动从设备 B 上移除
• 用户级隔离 — 行级安全策略确保您只能看到自己的数据
• 市场上架和销售记录包含在同步中，买家个人信息已加密

备份与恢复

将您的整个数据库和图片导出为加密备份存档。导出时设置备份密码，使用该密码可在任何设备上恢复。

备份内容

• 完整的 SQLite 数据库
• 所有物品图片
• AES-256-GCM 加密，使用用户设置的备份密码（PBKDF2 派生密钥）
• 用于验证存档完整性的 JSON 清单

恢复工作流程

1. 前往设置 > 备份与恢复
2. 点击导入备份
3. 使用文件选择器选择备份文件
4. 输入您创建备份时设置的备份密码
5. 您的数据和图片已恢复

数据导出与报告

以多种格式导出您的库存数据，用于保险理赔、个人记录或数据迁移。

导出格式

AI 智能描述

拍张照片，让 AI 自动生成物品的标题、描述和标签。同样的 AI 功能也用于生成市场上架信息。您需要使用自己的 API 密钥，支持 8 家服务商中的任意一家。

支持的 AI 服务商

设置

1. 前往设置 > AI 提供商
2. 选择您偏好的服务商
3. 输入您的 API 密钥
4. 可选择更改默认模型
5. 添加或编辑物品时，点击 AI 相机按钮 即可使用

注意：您的 API 密钥仅存储在本地设备上，绝不会发送到我们的服务器。AI 请求直接从您的设备发送到服务商。

设置

设置界面是您管理加密、同步、AI 配置、数据导出和账户的控制中心。

设置项

订阅

Where The Bleep 提供慷慨的免费套餐，包含所有核心功能。Pro 版解锁云同步、自动备份和优先支持。

套餐方案

订阅通过 App Store（iOS）或 Google Play（Android）管理。您可以随时在设备的订阅设置中取消。

What's Included with Pro

• 经营真正的业务 — Square POS 支持读卡器和手动刷卡支付、带 PIN 码和按操作员权限的销售员、18 种语言的电子邮件收据、eBay 商品发布,以及四份内置库存报告(库存水平、库存变动、库存估值、库存损耗)
• 带上您的团队 — 选择 5、10 或 20 设备方案,让您的销售员、厨房员工或共同所有人可以各自在自己的设备上使用自己的登录账户工作
• 无需 Wi-Fi 也能使用 — 即使网络中断,每个界面仍可正常使用,包括现金销售、库存调整和盘点;所有操作会排队等待,在重新连接时立即同步
• 加密云同步和自动备份 — 您的数据在设备上经过端到端加密,可在数秒内复制到所有已配对的设备,并持续备份到云端,即使所有设备都丢失也能恢复