年糕崽崽项目管理（PMS）
年糕崽崽 PMS（NL PMS）是一款 本地优先 的 Windows 桌面项目工作台：一键统计代码规模与语言分布、洞察 Git 协作热度，聚合待办、工单与排期日历，内置 AI 解读项目并规划每天工作。数据默认保存在本机 SQLite；登录后可加密同步到云端，多台设备衔接。
技术栈：Wails v3 · Go · Vue 3。界面支持中 / 英与浅色 / 深色主题。
功能清单
概览
- 工作台：收藏项目、今日待办、速记与未读消息入口
- 今日任务：聚合逾期、今天到期、进行中、未来 7 天的待办与工单
- 排期日历：待办截止日与工单排期一览，支持跳转日期
- 消息中心：系统 / 协作通知
项目与代码分析
- 我的项目：本地目录或 Git 克隆添加项目，分组管理，语言分布与代码行统计
- 项目详情：代码规模、目录结构、大文件、Git 热力图 / 趋势 / 贡献者、健康洞察、文件预览
- 排除规则：按 glob 排除不参与统计的文件（设置里可配全局规则，项目也可单独配置）
- AI 分析：基于项目上下文的对话、解读与任务建议（支持讯飞星火 / DeepSeek 等）
事务
- 待办事项：看板 / 列表，状态、优先级、截止日期
- 需求工单：绑定项目与排期，类型含功能 / 缺陷 / 任务 / 改进，生命周期时间线，可用 AI 生成工单
- 笔记：Markdown 速记与笔记列表
团队协作（登录后）
- 团队概览：创建 / 加入团队、成员与角色
- 团队任务：分配与跟踪团队待办
- 团队日报：成员日报提交与 AI 摘要
- 加密云同步：本地数据加密后同步到云端；个人主页可管理资料、素材库与同步状态
系统工具
- 启动台：管理本机应用启停与分类，扫描监听端口的服务，可配置启动 / 停止命令与图标
- 端口监控：本机 CPU / 内存 / 网络总览、监听端口列表，可将服务存为启动台应用
- 打包任务：在项目或应用目录执行自定义构建命令，控制台输出保存在本地（不同步云端）
- 运行日志：桌面端后台任务与运行记录
设置与运营
- 界面设置：主题、语言、毛玻璃、加载动画、托盘样式、最小化到托盘、开机自启、自动更新
- AI / 文件存储 / 种类图标 / 数据管理：模型密钥、云端文件存储（管理员）、启动台默认种类图标、SQLite 路径与备份
- 运营后台（管理员）：用户与团队、发版与更新包、用量概览；敏感操作需二次验证
环境要求
- Go 1.25+
- Node.js 20+
- Wails CLI v3（
wails3） - Git（可选；仅 Git 分析需要）
- NSIS（打 Windows 安装包时需要，见下文）
本机数据库默认位于系统用户配置目录下的 CodeCount/code-count.db，可在设置 → 数据管理中修改路径。
开发
热更开发（推荐）：
wails3 task dev
等价于 wails3 dev -config ./build/config.yml -port 9245。
也可先装前端依赖再手动启动：
cd frontend
npm install
cd ..
wails3 task dev
请在桌面程序中打开，不要用普通浏览器预览：浏览器无法访问本地目录、SQLite 或 Git。
测试
go test ./...
构建与打包（Windows）
出包必须用官方任务，禁止裸 go build 交付给用户。裸编译没有图标，双击还会闪控制台黑框。
打安装包（推荐交付方式）
需要已安装 NSIS。若提示 makensis not found，先把 NSIS 加入 PATH：
$env:Path = "C:\Program Files (x86)\NSIS;" + $env:Path
wails3 task package
该任务会依次：
- 打包云端 API（
api:package，有改动才重编） - 构建前端并嵌入，生成带图标 / 版本信息、无控制台窗口的
bin/code-count.exe - 用 NSIS 生成安装程序
安装包路径：
bin\年糕崽崽项目管理（PMS）-amd64-installer.exe
安装程序为简体中文界面，会写入开始菜单和桌面快捷方式，并附带 WebView2 引导。默认按机器安装（需管理员权限）。
只编桌面程序（不打安装包）
wails3 task windows:build
产物：bin/code-count.exe。只改前端时该任务会自动 npm build 并嵌入，无需单独跑 Vite。
只打包云端 API
同级仓库 ../nl-pms-api 有改动才会重编；强制重编加 FORCE=1：
wails3 task api:package
wails3 task api:package FORCE=1
产物目录：bin/nl-pms-api/（含 nl-pms-api 二进制、init.sql、migrations/*.sql、config.example.yaml）。部署到 Linux 服务器时拷该目录即可。
硬性要求：
- 目标固定为 linux/amd64（线上 Linux 服务器）
- 产物是
bin/nl-pms-api/nl-pms-api（无.exe后缀） - 禁止把 Windows 本机编出的
nl-pms-api.exe当作后端交付
编完会校验文件头为 ELF（7F 45 4C 46）。抽查：
Format-Hex bin\nl-pms-api\nl-pms-api -Count 4
# 前 4 字节应为 7F 45 4C 46
更换 Logo
- 替换
build/appicon.png（正方形 PNG） wails3 task common:generate:icons（按 checksum 缓存，未改动会显示 up to date）- 重新
wails3 task windows:build（或再打安装包） - 可用
powershell -ExecutionPolicy Bypass -File tools\extract-icon.ps1从 exe 抽出图标核对 - 资源管理器仍显示旧图标时，改名或重启 explorer 即可（Windows 图标缓存）
项目配置
应用名称、版本、公司名等在 build/config.yml。修改 info 后执行 wails3 task common:update:build-assets 会同步构建资源（会覆盖已改过的资源文件，请先确认）。