快速开始

这一篇带你把闲沐 IMS 跑起来，并完成第一件物品的入库。全程不需要命令行：先在线体验看个大概，再把系统装到自己的电脑上，跟着向导初始化，然后贴一张购物截图——10 秒入库第一件物品。装了 Claude、WorkBuddy 等 AI 助手的，还可以一句话让它替你装好（见安装的方式二）。

估计用时：5 分钟

先在线体验

不想先安装？打开在线演示站即可，以专业版全功能运行，无需注册：

  1. 访问演示版，用账号 demo 登录（密码见演示站公告）；
  2. 左侧菜单各功能页随便逛逛：物品档案、位置地图、标签打印都点开看看，感受一下操作手感；感兴趣的话进「入库」试试 AI 贴图入库；
  3. 掏出手机扫「贴图入库 → 手机扫码传图」的二维码，体验现场拍、桌面入库。
演示站物品库主界面：图片卡片视图、分类侧栏与搜索
图：演示站物品库主界面——左侧菜单各功能页都可点开体验，数据每日重置。

演示数据每日凌晨重置，请勿在演示站存放真实物品信息。演示站限流且部分涉密动作为只读。

安装到自己的电脑 Windows 版 · 安装包就绪

Windows 安装版为标准安装包（setup.exe），双击安装即用，无需安装 Python、Node 或 MySQL，全程无需管理员权限。安装包已完成开发并通过发布门禁，随官网正式开放提供下载（附 SHA256 校验值）；开放前你可以先用在线演示，或看部署指南用 Docker 跑在 NAS / 树莓派上。

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

  1. 在官网「下载安装」区下载 XianMuIMS-1.x-setup.exe，核对页面标注的 SHA256 值；
  2. 双击运行，保持默认选项点「下一步」即可（默认勾选桌面快捷方式与开机自启，可按需取消）；
  3. 安装完成后自动启动闲沐IMS工具箱：窗口与托盘图标出现，服务自启，浏览器自动打开系统页面；若没自动打开，打开工具箱点「打开系统」，或手动访问 http://127.0.0.1:8066；
  4. 首次运行如遇杀毒软件提示，选择「允许」即可——安装包不含任何联网上报行为。

系统要求：Windows 10 / 11 64 位。数据全部存在安装目录的 data/ 文件夹里；卸载默认保留数据，升级（运行新 setup.exe 覆盖安装）不触碰数据。工具箱托盘常驻：服务启停重启、访问地址、日志、改密码都在里面。

工具箱为原生桌面界面（不依赖任何浏览器组件），Windows 10 / 11 开箱即用；若窗口异常请到安装目录 data\logs\toolbox.log 查看日志。

方式二：一句话，让 AI 助手替你装

装了 Claude Desktop、Cursor、WorkBuddy、Qoder、TRAE、CodeBuddy 等智能体的，可以把安装整个交给它：把下面这句话复制发给你的 AI 助手，它会读取官网接入引导，带你完成安装启动、创建 API Token、写入客户端 MCP 配置、验证连接，并在你确认后初始化分类与位置（免费版可用，50 条目内）。

读取 https://ims.miaoking.com/skill.md 并按照其中的说明，安装闲沐 IMS 并连接它的 MCP 服务器。

没有装这类 AI 助手？用上面的方式一三步装好，效果一样。

首次启动

按模式自动分流，无需任何配置：

模式首次启动行为说明
单人（默认）免登录直达工作台自动创建 admin 账号用于审计归属，日常使用无需登录
多人（专业版）进入 /setup 初始化向导，三步创建管理员：欢迎 → 设置用户名密码 → 完成（创建即登录）多人模式为专业版权益，未授权时按单人运行；向导只在全新空库出现一次。怎么选模式、数据存在哪，见下方「单人还是多人？数据存在哪？」

端口约定：系统固定使用 8066 端口。不要自行改成 6665–6669 等端口——Chrome / Edge 会把这类端口当作不安全端口直接拒绝访问。

单人还是多人？数据存在哪？

两种模式的页面差异

两种模式的功能完全一致，区别只在「谁在用」：单人模式面向一台电脑上的个人使用，多人模式面向团队共用一套库存。日常页面的差别如下：

页面表现单人模式（默认）多人模式（专业版）
打开系统免登录直达工作台先登录，输入账号密码
用户管理无（只有一个内置管理员）「设置 → 用户」可建账号、分配角色、停用账号
退出登录无「关于」页可退出登录、切换账号
操作记录统一归属内置管理员按登录账号归属，可查谁做了什么
局域网访问任何设备打开即用（勿暴露到不受信网络）需账号密码，可分配只读等受限角色

单人模式

安装后即单人模式：无需登录直达工作台，数据就是安装目录 data\ 下的一个 SQLite 数据库文件，零配置零运维，每日凌晨自动备份（滚动保留 30 份，也可随时手动导出）。个人与家庭使用，选它就够了。

多人模式（专业版）

多人模式让团队共用同一套库存，属专业版权益：管理员在「设置 → 用户」里建账号、分配角色（管理员 / 成员 / 访客），账号停用即立即失效并释放席位。席位口径（专业版含 5 个账号、可加购）见用户手册 · 多人与权限。

开启需要两个条件同时满足：已持专业版权益，且运行模式为多人。专业版购买后在「关于」页输入激活码（或导入授权文件）完成激活，见用户手册 · 授权与版本；运行模式切换见下节。若只切了运行模式而未持专业版权益，系统仍按单人模式运行，并在「关于」页给出提示。

如何切换运行模式（桌面安装版）

桌面安装版不用改任何配置文件，在随附的工具箱里完成：

  1. 打开「XianMuToolbox」工具箱（系统托盘图标或安装目录内），切到「服务」页；
  2. 在「运行模式与数据库」卡片点「切换运行模式…」，输入管理密码完成验证（从没设过密码的，先在工具箱「密码」页设置一次）；
  3. 确认后服务自动重启：切到多人会出现登录页，用管理员账号登录即可开始建账号；切回单人则恢复免登录直达。

多人模式是专业版权益：未持专业版权益时切到多人不会生效。云端 / NAS / 服务器部署不用工具箱，直接在配置中设 APP_MODE=multi，首次打开会出现初始化向导、三步创建管理员（见部署指南）。

数据库怎么选、怎么切换

桌面版默认内置 SQLite，不用安装任何数据库；需要多人共用同一台数据库服务器或云端部署时，可切换到 MySQL 8（不支持 MariaDB，中文全文检索依赖其 ngram 解析器），两种库功能完全一致。桌面安装版同样在工具箱「服务 → 运行模式与数据库」里切换：选 MySQL、填好连接信息、通过「测试连接」并验证管理密码即可。切换不会自动迁移数据——两侧数据都保留，已有数据可先在系统内导出、切库后再批量导入。切换失败也不用担心：重新打开同一对话框可一键切回 SQLite。备份与恢复方法见部署指南 · 备份与恢复。

建第一件物品

方式一：手动建档

  1. 左侧菜单进「物品」→ 右上角「新建」；
  2. 填名称、型号，选一个位置（没有位置先去「位置地图」建一个区域 → 柜 → 格位）和单位，保存；
  3. 数量可以从 0 开始，之后每次入库都会生成流水，账自动算。
物品档案：卡片视图、分类侧栏与快速编辑抽屉
图：物品档案页——卡片化浏览、分类侧栏筛选，点开即可快速编辑型号、位置与数量。

方式二：AI 贴图入库

这是闲沐最省事的方式：把购物截图丢进来，AI 认出品名、型号、数量、价格，你确认一下就入库。

  1. （首次）进「设置 → AI 服务」，填你的 API 地址与 API Key（任何 OpenAI 兼容服务均可，如智谱 https://open.bigmodel.cn/api/paas/v4、DeepSeek https://api.deepseek.com/v1），点「测试连接」；
  2. 进「入库」→ 选「贴图入库」，直接 Ctrl+V 粘贴刚复制的商品截图（无需先存成文件），或点按钮选择图片（最多 4 张，单张 ≤ 5MB，一张截图里有好几样东西也能拆开认）；
  3. 等几秒，AI 解析出候选物品，逐行核对名称、数量、入库位置；
  4. 点「建档入库」，解析用的截图会自动挂成物品图片。
贴图入库输入示例：购物订单截图，含商品名、数量与实付价格
图：要贴的素材长这样——购物 App 里的订单截图，直接 Ctrl+V 粘贴进「贴图入库」即可。

Ctrl+V 直接贴图：截图复制后无需存成文件，以下页面都能直接按 Ctrl+V 上传——「贴图入库」的输入步、物品编辑页、物品详情的快速编辑抽屉、物品新建时的 AI 导入弹窗；「标签设计」暂不支持粘贴，请用其插入图片功能。

AI 贴图入库：粘贴商品图后 AI 解析出品名、型号、数量与价格，核对确认后建档入库
图：在「入库 → 贴图入库」粘贴商品截图，AI 解析出品名、型号、数量与价格，核对后点「建档入库」写入库存。

AI 使用你自己配置的 API Key（BYOK），用量自己控制；免费版与专业版都包含 AI 功能，不另外收费。

打一张标签贴上去

有精臣 B21Pro 标签机的话，可以直接把物品码打出来贴在盒子上，以后手机一扫直达物品页。首次使用两步：

  1. 在插着打印机的电脑上安装精臣官方 USB 驱动；
  2. 同一台电脑上安装闲沐本地打印服务 jcPrinterSdk.exe（下载安装包，后台监听 37989 端口桥接 USB；必须默认路径安装（C 盘）、先退出杀毒软件、勿禁用开机自启）。

之后在「物品详情 → 打印标签」或「标签」页批量打印即可；标签长什么样，去「标签设计」页用拖拽设计器自己排。详细步骤见用户手册 · 标签打印。

标签打印：拖拽设计器排版，直连精臣 B21Pro 真实预览
图：「标签设计」用拖拽设计器排自己的版式；「标签」页或物品详情点「打印标签」，直连精臣 B21Pro 出真实预览。

手机上使用

  1. 手机与电脑连同一 WiFi，浏览器打开 http://电脑的局域网IP:8066（电脑上用 ipconfig 查 IP）；
  2. 手机浏览器菜单里选「添加到主屏幕」，就能像 App 一样点开（PWA 安装与摄像头扫码需要 HTTPS 或本机访问，纯 IP 局域网访问时功能受限，见部署指南）；
  3. 不用装任何 App——「贴图入库 → 手机扫码传图」扫码即可现场拍照回传电脑。
手机端移动布局与底部导航
图：手机浏览器打开局域网地址即用，底部导航与桌面端同一套数据。
手机扫码传图页：拍照或从相册选择上传
图：桌面端「贴图入库 → 手机扫码传图」弹二维码，手机扫码现场拍照回传电脑。

接下来看什么

  • 用户手册：入库、盘点、位置地图、项目 BOM、标签设计器、资料库、AI 能力……每个功能都讲清楚；
  • 部署指南：想装到 NAS / 树莓派上全家共用、或者要做备份恢复与升级，看这篇；
  • 常见问题：免费版权限、付费与换机、退款政策；
  • API 文档 · 智能体接入：想让 Claude、WorkBuddy 等 AI 助手直接帮你查库存、办出入库，看这篇（免费版可用，50 条目内）；
  • 遇到 Bug 或想提功能建议：提交表单（无需登录）；购买与售后问题请联系客服（客服邮箱 kf@wwzu.com）。