Skip to content

Add plugin project-cost v1.0.0 - #725

Merged
lzx8589561 merged 1 commit into
ZToolsCenter:mainfrom
Samson1990-09:plugin/project-cost
Nov 4, 2026
Merged

lzx8589561 merged 1 commit into
ZToolsCenter:mainfrom
Samson1990-09:plugin/project-cost

Conversation

@Samson1990-09

@Samson1990-09 Samson1990-09 commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

插件信息

  • 名称: 项目费用管理
  • 插件ID: project-cost
  • 版本: 1.0.0
  • 描述: 多项目费用台账:明细自动汇总金额链、付款跟踪与逾期提醒、品类预算预警、支付对象欠款排行,支持 Excel/CSV/JSON 导出。
  • 作者: Samson
  • 类型: 新增
  • 开源: 是(完整源码随包提交,CI 现场构建)

本次变更

首次上架 ZTools 插件市场。以下为完整功能清单。
多项目台账

  • 每个项目独立预算 / 品类 / 支付对象 / 支出 / 付款,可重命名、切换、删除,可存为模板复用
  • 可为项目填建筑面积,填了才显示单方造价(元/㎡),未填则整项隐藏,绝不显示「¥0/㎡」误导
    明细驱动金额链(唯一真源)
  • 明细金额合计 → 项目总计 → 应付(总计 − 优惠)→ 已付(Σ 付款)→ 待付
  • 有明细时总计自动汇总并锁定只读;数量 × 单价齐全时金额自动算并锁定
  • 预估与应付分离:派生「确定应付 = 应付 − 预估合计」,预算占用率与超支/临界预警按确定应付算,真源「应付 / 待付」保持不变
    付款跟踪
  • 逐笔流水(支持负数退款),每笔有稳定编号 P0001、备注与凭证号,超付软确认
  • 作废留痕:作废 ≠ 删除,记录灰显留在流水里、保留编号与凭证号,只是不再计入已付,可随时恢复;真正抹掉才用「彻底删除」。作废款不进环比、趋势、体检与对账单
  • 批量登记:勾选多条 → 输入总额按待付比例或均分自动拆行,最后一行吸收分角差(Σ 恒等于总额),面板内逐笔预览后一次落库,整批一次撤销
  • 付款日期必填;历史无日期记录允许保留空值并高亮提示,不会被悄悄补成今天
    到期日与逾期提醒
  • 到期日推算可配:按项目设 1–365 天(默认 30),只影响未填到期日的费用项
  • 逾期分级:拆成「逾期 1–30 天」与「超 30 天」两档,付款页顶部有「超 30 天 · 优先催收」置顶卡,按逾期天数降序
  • 临期提醒(≤7 天);预警可当天忽略、跨天自动恢复,左轨角标仍保留计数
    预算预警
  • 品类预算进度、超支与临界(默认 80%)提示,顶栏横幅按类型收敛,不撑爆窄窗口
  • 抽屉内实时预算剩余:选完品类、填好金额即提示「该品类预算剩余 X,本笔后剩 Y / 将超支 Z」
    分析
  • 账龄分桶:按到期日把待付分成 0–30 / 31–60 / 61–90 / 90 天以上四桶(四桶之和恒等于待付合计),点桶可展开下钻,可按收款方筛选
  • 材料(明细品名)支出排行 Top10,按品名合并排(忽略空格与大小写),Top 合计 + 其他 = 明细合计,可对账
  • 月度环比:本月 vs 上月应付 / 已付 / 新增费用项的增减与百分比,并给出变化最大的品类
  • 收款方账目占比、欠款排行、付款月度趋势、费用类型构成
    收款方
  • 对账单:按收款方生成对账单(费用项金额 / 已付 / 待付 + 付款流水 + 三行小计),支持 A4 打印与导出 CSV
  • 改名 / 合并:改名与合并前先显示将影响多少条费用项、多少笔付款与合计金额,确认后才执行,预览与实改同一套口径
    录入效率
  • 明细连续录入:「保存并继续」保存后清空品名/数量/单价/金额、保留单位与预估标记、焦点回到品名框
  • 批量粘贴:粘贴 TSV/CSV → 解析预览 → 一次落库多条,金额自动算,坏行剔除不入库
  • 品名历史单价联想:按历史明细提示「单位 / 最近单价」,采纳后自动填充
  • 费用项复制(含明细 / 跨项目),明细一并复制、编号按目标项目顺延,付款不复制(避免虚增已付)
  • 列表多选(Shift 连选)+ 批量操作(改品类 / 改收款方 / 改到期日 / 删除 / 批量付款)
    导入导出
  • Excel(支出 / 明细 / 付款三表,数值列按数字写入)、CSV、全量 CSV、JSON 备份(可再导入还原)
  • 按当前筛选导出:支出表 / 明细表 / 付款表共用同一作用域,三表行数必然一致
  • 三表 CSV 回读导入:按表头对齐列,冲突策略(追加 / 按编号覆盖 / 跳过已存在),落库前自动存快照可回滚
  • 同名文件自动追加时分与序号,同日多次导出不会互相覆盖
    数据安全
  • 自动快照与一键回滚:每天首次启动自动存快照,保留 7 份日快照 + 3 份操作前快照(上限 1.5MB),快照存独立键、写失败也不影响账目
  • 自动备份(默认开)
  • 存储占用与配额预警:已用容量 / 约 5MB 进度条,≥80% 变红提示先导出备份,≥100% 明示写入会被拒绝
  • 数据体检与一键修复:9 类数据问题可检测、6 类可一键修复,所有修复动作都不改变应付/已付/待付
  • 撤销 / 重做:逐条撤销,支持撤销 → 重做 → 再撤销,快捷键 ⌘Z / ⇧⌘Z,栈 20 步并落盘持久化,按钮实时显示「可撤销 N 步 / 可重做 N 步」
    视图与交互
  • 三档显示密度:紧凑(单行 ~36px,首屏 10 条)/ 舒适 / 大字(所有文字 ≥12px,付款页、抽屉、图表同步放大)
  • 搜索命中逐条导航、六档排序(日期 / 编号 / 金额 / 待付 / 到期日 / 收款方)、状态与品类与日期筛选
  • 左侧 62px 图标轨道常驻,右侧 392px 抽屉就地编辑,⌘K 搜索 / J K 移动 / Enter 打开 / 1–6 分区 / Esc 关闭
  • 三个入口直达:主入口 / 记一笔 / 付款跟踪
    数据搬家
  • 网页版导出 JSON → 插件内「导入 JSON」;可从旧版键名自动迁移,无需手动导入
  • 首次进入预置一份真实装修台账作为示例(可随时清空),可核对:应付 246,055.97、已付 188,529.11、待付 57,526.86、预算 234,688.00、结余 −11,367.97
    技术说明
  • Vue 3 + Vite,零第三方运行时依赖(Excel / ZIP / OOXML 均为自实现),数据仅存本机 localStorage
  • 插件窗口固定 800px 窄窗口设计,跟随 ZTools 深/浅色主题

目录说明

本 PR 按 first-plugin.html 的开源提交流程,提交完整可构建源码(市场 CI 会执行 npm install + npm run build 后打包 dist/):

plugins/project-cost/
├── plugin.json          # 插件配置
├── package.json         # 依赖与构建脚本
├── vite.config.js       # 构建配置(会把 plugin.json / preload.js / logo / README 复制进 dist)
├── index.html           # 入口页面
├── preload.js           # CommonJS,未压缩混淆
├── logo.png
├── src/                 # 全部源码(Vue 3,零第三方运行时依赖)
├── README.md
└── CHANGELOG.md

已排除与运行/构建无关的内部设计文档,不放 docs/ 与本地测试脚本;也不提交 package-lock.json(本机生成的 lockfile 只锁当前平台的原生可选依赖,会导致 linux 构建找不到 rollup 原生二进制)。

自检清单

  • plugin.json 的 name / title / version / description / author 字段均已检查
  • 提交完整可构建源码(非闭源产物),npm install && npm run build 已在干净目录验证通过
  • 已移除调试日志、未使用文件、敏感信息
  • 本次 PR 的 diff 仅涉及 plugins/project-cost/ 目录
  • 已在本地 ZTools 客户端实际加载并测试过此插件,主要功能正常
  • 同意以仓库声明的开源协议发布此插件

@Samson1990-09

Copy link
Copy Markdown
Contributor Author

1-概览2-费用项3-付款4-预算5-分析6-设置7-项目8-支出抽屉-明细9-支出抽屉-付款10-大字档-支出列表11-大字档-支出抽屉12-大字档-概览(功能界面截图,800×618 实际窗口尺寸)

@Samson1990-09

Copy link
Copy Markdown
Contributor Author

感谢 @lzx8589561 之前的反馈(#716):开源仓库不支持闭源提交。

本 PR 为重开版本,已补齐完整可构建源码(42 个文件),不再只提交构建产物:

  • src/ 全部源码(Vue 3 + Vite,零第三方运行时依赖,Excel/ZIP/OOXML 均自实现)
  • package.json / vite.config.js / index.html / preload.js / logo.png / plugin.json
  • README.md / CHANGELOG.md

市场 CI 已通过并现场构建:npm install → vite build → 使用 dist 作为打包源,产出 project-cost-1.0.0.zip(成功 1 / 失败 0)。

未提交 package-lock.json:本机生成的 lockfile 只锁 macOS 的 rollup 原生二进制,会让 linux runner 报 Cannot find module @rollup/rollup-linux-x64-gnu(npm/cli#4828),因此刻意不带 lockfile 让 npm 按平台解析。

已排除与运行无关的内部设计文档与本地测试脚本。PR 已就绪,麻烦评审。

@lzx8589561
lzx8589561 merged commit e3e186e into ZToolsCenter:main Nov 4, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants