程序员晓枫

作品介绍 本项目是政府采购电子商城平台的核心协议管理模块，主要用于管理供应商与平台之间的各类采购协议。系统支持多种协议类型，包括代理商协议、经销商协议、厂商协议和电商协议等，覆盖了政府采购全流程的协议管理需求。 核心功能 1. 协议全生命周期管理：支持协议的创建、编辑、审核、生效、失效等完整流程，包含协议范本管理、协议模板配置等功能。 2. 多级审核机制：实现了灵活的协议审核流程，支持免审项配置、公示自动审核、协议修改审核等多种审核模式，并记录完整的审核日志。 3. 权限体系管理：建立了完善的供应商权限体系，包括品牌权限、品目权限、代理商权限、经销商权限、厂商权限等多维度权限控制，确保供应商只能在授权范围内参与采购活动。 4. 资质管理：支持供应商品牌授权书、品目资质等资质文件的上传和管理，包含资质有效期控制和资质分级管理。 5. 配送范围管理：支持供应商协议配送区域的配置，实现按区划维度的服务范围管理。 6. 数据统计与查询：提供丰富的查询接口，支持按品目、品牌、区划、协议类型等多维度查询供应商协议信息，满足业务统计和公示需求。

1. 立项背景和目标 在物联网、工业监控等场景中，各类传感器设备需要一个轻量可靠的汇聚端来接收和存储数据。传统方案要么依赖重量级中间件，要么缺乏可视化管理能力。NexusRecv 旨在提供一个开箱即用的桌面级设备数据接收服务端：基于 FastAPI 高性能异步 API 接收局域网内多设备并发上报，通过 ttkbootstrap 现代化 GUI 实时监控，SQLite 轻量持久化无需额外数据库，支持多实例并行运行和跨平台构建（Windows exe / Linux deb）。 2. 核心功能模块 整体采用四层分层架构：表示层（GUI / 系统托盘）→ 业务逻辑层（配置管理 / 数据处理 / 安全认证 / 任务调度）→ 接口层（RESTful API）→ 数据层（SQLite / 配置文件 / 日志）。 WebhookServer（models/webhook_server.py）是核心服务器类，封装 FastAPI 应用、路由注册、认证逻辑和定时任务，采用单例元类保证实例唯一性。WebhookDataManager（models/server_data_manager.py）负责 SQLite 数据管理，使用 WAL 模式和 ULID 唯一 ID，提供消息的存储、查询和自动清理。ServerProperties（models/server_properties.py）解析 INI 配置文件，校验 api_key、IP 白名单、端口、设备列表等关键参数。GUI 主窗口（gui/main_window.py）协调数据表格、状态监控、服务器控制和系统托盘等组件，提供实时数据展示和交互操作。 安全认证采用三层机制：API Key 认证、Bearer Token 临时令牌、X-Client-Key 设备标识，配合 IP 白名单控制访问。API 提供三个核心接口：GET /webhook/token 获取令牌、POST /webhook/save 设备上报数据、GET /webhook/unread 查询未读消息。 支持三种运行模式：GUI 模式（webhook_server_gui.py）、命令行模式（webhook_server_command.py）、配置选择模式（config_selection_gui.py，推荐新用户使用）。 3. 业务流程 启动流程：用户通过配置选择界面新建或选取已有配置 → 加载 INI 配置文件并完成参数校验 → 初始化 WebhookServer 实例（创建 FastAPI 应用、注册路由、建立 SQLite 数据表、启动 APScheduler 定时任务）→ 启动 GUI 主窗口进入服务状态。 设备上报流程：设备通过 HTTP POST 请求 /webhook/save，在请求头中携带 X

一、立项背景与目标 日常办公中，用户常需处理压缩PDF、图片合并、格式转换、批量重命名等文件任务。现有工具存在痛点：专业软件体积庞大，在线工具有隐私风险，命令行工具门槛过高，轻量工具又缺乏批量处理能力。 file flow 是一款本地优先的桌面文件处理工具，面向不想写脚本、不想碰终端的用户。核心目标：隐私安全（所有处理本地完成，不上传原始文件）、轻量高效（Tauri 2 架构，小体积低占用）、先预览后执行（降低误操作风险）、跨平台覆盖（Windows/macOS/Linux）。 二、软件功能与核心模块 首发版本聚焦四大模块： 1. PDF 工具：提供 PDF 压缩和图片转 PDF 功能。压缩通过 PDFium 库实现，支持选择压缩级别；图片转 PDF 支持批量导入并按顺序合并为单个文件，适用于扫描件整理、证件归档等场景。 2. 图片批处理：基于 libvips 库，支持格式转换（PNG/JPG/WebP 互转）、缩放（按比例或指定尺寸）和压缩（控制质量参数）。批量导入后统一设置参数一键执行。 3. 文件批量重命名：支持按规则批量重命名，提供实时预览。执行前可查看新旧文件名对照，系统内置冲突检测，文件名冲突时自动阻断并提示。 4. 设置与任务管理：配置输出规则（目录、命名策略），查看历史任务摘要，任务完成后自动记录便于回溯。 三、业务流程与功能路径 技术架构采用前后端分离：前端 React 19 + TypeScript + Vite 负责界面交互，后端 Rust + Tauri 2 负责文件处理核心逻辑。前后端通过 Tauri invoke 机制通信，命令统一经由 src/lib/tauri.ts 桥接层调用。本地数据用 SQLite 持久化。 典型操作流程： 1. 启动应用：首页展示功能入口和最近任务。 2. 选择模块：进入对应工作区（PDF/图片/重命名）。 3. 导入文件：通过对话框或系统拖拽导入文件。 4. 配置参数：设置处理参数（压缩级别、输出格式、重命名规则等）。 5. 预览结果：重命名展示新旧名称对照，其他模块显示配置摘要。 6. 执行处理：确认后点击执行，过程显示进度。 7. 查看结果：完成后展示摘要，可打开输出目录。 状态管理采用单页路由，各模块为独立页面。会话状态保存在内存中，模块切换时恢复之前的文件列表和配置。处理过程中锁定文件列表和配置项防止误操作。SQLite 存储用户设置和任务历史，位于应用本地数据目录。

一、立项背景与目标 浏览器书签长期使用后往往杂乱无章，原生管理器缺乏批量整理和云端备份能力。本项目构建一个 Chrome 扩展，让用户在独立工作区中以可视化图谱方式导入、整理书签，支持写回浏览器或同步至 WebDAV 云端，并提供版本管理和撤销保护，确保操作安全可逆。 当前已落地工程基线、启动导入链路、草稿图谱编辑、本地备份恢复、WebDAV 同步等核心能力，浏览器覆盖写回仍在收尾中。 二、核心功能模块 草稿图谱（bookmark-graph）：核心模块。以思维导图式布局展示书签树，支持节点创建（同级/子级）、重命名、编辑URL、删除、拖拽移动、键盘重排/提升，内置搜索、重复书签聚焦和 Ctrl+Z 撤销。节点分为 folder 和 bookmark 两类，来源标记为 browser 或 draft。 浏览器同步（browser-sync）：启动引导模块。按"本地草稿优先 → 浏览器书签导入 → 首次持久化"策略完成工作区初始化。 WebDAV 同步（webdav）：云端备份与恢复。支持草稿/书签快照上传，版本化存储（最多5版），支持从历史版本选择恢复并自动清理旧版本。 本地持久化（local-persistence）：基于 chrome.storage.local 持久化草稿会话、WebDAV 配置和本地备份产物，覆盖操作前自动创建备份用于撤销保护。 浏览器书签适配器（browser-bookmarks）：封装 Chrome 书签 API，提供读取、导入、导出和覆盖写回能力，写入失败时自动回退。 工作区入口（workspace-entry）：处理扩展图标点击，实现打开或聚焦工作区页面。 三、业务流程 启动：点击扩展图标 → 打开工作区 → 检测本地草稿：有则恢复，无则读取浏览器书签导入并持久化。 编辑：在图谱工作区浏览书签树 → 通过菜单/快捷键编辑节点（创建、重命名、删除、拖拽） → 搜索查找或重复聚焦 → Ctrl+Z 撤销。 同步写回：触发"同步到浏览器" → 确认覆盖 → 自动备份浏览器书签 → 导出草稿为书签树写回浏览器 → 失败自动回退。 WebDAV 流程：配置服务端并测试连通 → 上传快照到云端（版本化存储） → 恢复时选择目标版本 → 确认前自动备份 → 执行恢复。 撤销保护：每次覆盖操作前自动备份当前状态，用户可通过"撤销覆盖"恢复到操作前的草稿或浏览器书签。