# 墨矩 · 使用说明

雨棚 / 防护栏杆门店用的 Windows 桌面软件：材料台账、库存、设计出图、算料、报价，全流程在一台机器上完成。

## 一、安装

- 系统要求：Windows 10 / 11，64 位。不需要联网，不需要装数据库。
- 当前版本 **v0.2.2**。安装包 `墨矩-0.2.2-setup.exe`（115,433,186 字节）体积超出站点产物上限，不挂在网站上，由开发者本机交付（U 盘或网盘均可），交付时同目录附一个 `墨矩-0.2.2-setup.exe.sha256`。拿到后先算一次 SHA-256，与介绍页表格和本文件标注的 `a45134a9165cdc887926cd8c5d019f176a36675149e4bd50c6f09aac32c15744` 逐位一致再装。
  ```powershell
  (Get-FileHash -Algorithm SHA256 .\墨矩-0.2.2-setup.exe).Hash.ToLower()
  Get-Content .\墨矩-0.2.2-setup.exe.sha256
  ```
  软件里的操作手册不写死这串哈希——安装包装不下自己的哈希，改一个字它就变，写进包里的必然是上一轮的。
- **手上是 v0.2.0 / v0.2.1 的建议升到 v0.2.2**：0.2.0 出的图纸上，「立柱间距」「竖杆间距」两类标注被多乘了一次 1000（写成 1500000 而不是 1500），0.2.1 修掉；0.2.1 及之前的算料在参数刚好整除时会少一根（如跨度 1.2m、立柱间距 0.4m 少一根弧梁和 2 套化学锚栓），阳光板这类按张领料的材料若台账按 ㎡ 建档会把每张价当成每平方米价，这两处 0.2.2 修掉，直接影响报价金额。图纸标注的补救是在设计工作室把尺寸原样再点一次「出图存库」，会自动记成下一版，旧版图纸保留不删；算料不用管，重算即新值。
- 双击安装包，按提示选目录安装（默认即可），装完桌面与开始菜单都有图标。
- **从旧版「棚栏通」升级**：直接装新版即可，第一次启动会自动把 `%LOCALAPPDATA%\棚栏通\data\` 里的库与附件搬到新目录（只拷不删，旧目录原样留着，退回旧版还能打开）。
- **首次运行会被 Windows SmartScreen 拦一次**：这个安装包没有购买代码签名证书，所以 Windows 会提示「Windows 已保护你的电脑」。点「更多信息」→「仍要运行」即可。每次大版本更新后可能再拦一次，属正常。
- 卸载走「设置 → 应用」，卸载不会删门店数据（见第六节）。

## 二、九个工作页

左侧导航从上到下就是干活顺序：

| 页面 | 做什么 |
|---|---|
| 库存态势 | 打开软件先落在这页。按类别看库存水位与波动，列出低于安全库存与长期没出库的品种，并用一段话把这一屏的数字讲清楚。 |
| 材料档案 | 方管、圆管、阳光板、底座、胶、螺丝等全部材料的编号、类别、规格、单位、进货价、销售价、毛利率。支持关键字 / 类别 / 渠道筛选，支持 CSV 批量导入。 |
| 进货渠道 | 供应商台账。材料挂到渠道上，以后换供应商只改一处。 |
| 库存查询 | 每个材料的当前存量、进出流水。入库 / 出库 / 盘点三种操作，数量可填负数做红字冲销。 |
| 设计工作室 | 选配方（弧形棚 / 栏杆等）→ 改参数 → 右边实时出 A3 图纸与材料清单（BOM）。调好了点「保存方案」，再点「出图存库」入库。 |
| 图纸库 | 已出的图纸按方案归档，每出一个新版本自动递增版本号。可看 SVG / 导出 PDF / 挂门店上传的设计原稿。 |
| 报价清单 | 从图纸新建报价 → 核对单价 → 加加工费 / 安装费 / 运费 / 税率 / 利润系数 → 导出 Excel 与 PDF 报价单。 |
| 设置 / 关于 | 门店抬头（名称 / 出图人 / 联系电话）、界面语言、背景音乐开关与音量集中在一处；下面还有免责声明与版本更新公告。 |
| 使用手册 | 软件自带的一本图文手册，按门店一天的动线写（建档 → 接活 → 出图算料 → 报价 → 交货），左侧目录点哪章滚到哪，顶部可搜章节。写的全是界面上真实存在的按钮名，断网可翻，不需要再单独存一份 PDF。 |

顶栏还有一个全局搜索框：材料、渠道、工程、图纸、报价一次查全，点结果直接跳到对应那一条。

## 三、界面语言与背景音乐

- 设置页可切「简体中文 / English」。**只切软件文案**：材料名称与规格、配方参数、算料依据、首页判断叙述、导出文书与主进程的校验提示始终保持中文——翻了就等于改数据或改单据。
- 背景音乐内置一首约 2 分半的原创古风拨弦曲（五声音阶、五段结构），由软件在本机合成，不带音频文件、不联网取素材。默认关闭，音量可调，窗口切到后台自动暂停。

## 四、单价与四川信息价

- 报价行的单价默认取材料台账销售价，**可以直接在报价行上改成谈定价**，改的只是这一张报价单，不动台账。
- 「材料档案」右上角有「导入信息价」：每周从造价信息站点导出一份表（.csv 或 .xlsx，至少要有「材料编号」和「信息价」两列）存到本机，在这里选文件导入即可。软件按 ISO 周留导入记录，随时能回看是哪一周、多少条、对上了多少。
- 导入后，报价页每行旁边会显示当期信息价与偏离百分比，**偏离超一成的标红**并在顶部汇总提示。
- 三条要说清楚的：
  1. 信息价只是对照参考，**导入不会改写台账销售价**；
  2. 比对结果**不进 Excel / PDF 报价单**，客户看到的单据上没有信息价；
  3. 软件不会联网自动抓最新信息价，需要门店每周手工重导一次。

## 五、DXF 图纸标注识别

设计工作室里点「从图纸导入标注」，选一份门店本机的 `.dxf` 文件，软件读出图上的标注尺寸作为候选值，你逐个指认它对应哪个配方参数（比如「这是跨度」「这是出挑」），确认后回填进参数表单。

- 全程只读：不改图纸、不改库里的东西。
- 只支持 DXF。`.dwg` / `.skp` 请先在源软件里「另存为 DXF」再导入。
- 识别不到或图面没标全，就照常手工填参数，不影响出图。

## 六、数据在哪、怎么备份

所有数据都在一个文件里：

```
%LOCALAPPDATA%\moju\data\penglantong.db
```

- 换机 / 重装：把上面这个文件拷到新机器同一路径即可，附件（设计原稿）在同级的 `attachments\` 目录，一起拷走就是全量迁移。
- 软件内也有出口：右下角「导出数据」出 CSV / 全量 JSON，「立即备份」在 `data\backups\` 下留一份带时间戳的库文件。
- 只想清掉一个版块：各版块页右上角有「清空本版块数据」，材料 / 渠道 / 库存 / 工程 / 图纸 / 报价各清各的。点下去先落两份底——整库快照自动进 `data\backups\`（与「立即备份」同一个目录，可整库还原），本版块数据另存一份 JSON 到你选的位置；然后把版块名原样手输一遍才真删。对话框点取消就一条都不动；工程已被图纸或报价引用的，会挡住不让清，不留没主的图纸。
- 数据只落本机，软件不联网、不上传。

## 七、工程量与规范依据

报价单与清单里每一项材料都带「计算依据」，写的是本软件实际采用的口径（图示尺寸 × 数量 ×（1 + 损耗））。内置配方统一引 GB/T 50854-2024《房屋建筑与装饰工程工程量计算标准》（住建部公告 2024 年第 191 号，2025-09-01 实施）作为计量标准来源；具体条款号未经人工核实的一律显示「待门店确认」，不伪造规范编号。

报价单底部固定一条免责页脚：工程量按门店配方与本软件采用的计算规则统计，最终以现场实测尺寸与合同计量规则为准。

## 八、常见问题

- **装了但打不开 / 双击没反应**：首次启动要解压与初始化，慢的时候十几秒才出窗口，等一下再看。仍不出，看 `%LOCALAPPDATA%\moju\data\` 是否生成了 `.db` 文件；没有的话重装一次。
- **导入 CSV 提示列缺失**：表头要能认出编号列与价格列。信息价表认「材料编号 / 编号 / 材料编码 / 物料编码 / code」与「信息价 / 单价 / 价格 / 指导价 / 除税价 / 含税价 / price」；材料台账另认「名称 / 类别 / 规格 / 单位 / 进货价 / 销售单价」等列名。文件用 UTF-8 保存（带不带 BOM 都行）；GBK 编码的 CSV 读出来是乱码，请在 Excel 里另存为「CSV UTF-8」再导，或直接导成 .xlsx。
- **报价单上的金额和心里算的差几分**：单价、数量都按两位小数展示，合计用未舍入值算，最后再取整，属正常。
- **想清空重来**：只是某一个版块要重来，用第六节的「清空本版块数据」，它会先落两份底再删；整库推倒（比如把演示数据换成正式台账）再关掉软件删掉 `penglantong.db`，重开会自动建库并写入内置配方。两条路都先备份。