飞牛 fnOS 原生快捷入口管理器：一键创建桌面原生图标！
一个列表管理两类快捷入口，部署状态与运行状态一眼可见。
- 内置端口：填映射端口、协议、路径，生成独立子应用
<主应用名>-<唯一标识>，打开时访问协议://当前地址:端口/路径。 - 外部链接：填目标地址，生成子应用，启动时 302 跳转。
打开方式有两档：桌面内嵌（作为应用窗口打开）和新标签中（在浏览器新标签页打开）。
| 字段 | 约束 |
|---|---|
| 唯一标识 | 2–12 位，以小写字母开头，只含小写字母、数字和连字符；决定子应用名，创建后不可修改 |
| 捷径名字 | 最多 12 个字符，显示在桌面图标下方 |
保存后点「部署」才会生效；之后改配置，状态圆点变黄（待更新），再点一次「更新」即可。
要求 fnOS 1.2.0 及以上、管理员账号（应用仅对管理员可见）。
从 Releases 下载 .fpk → fnOS「应用中心 → 手动安装」→ 桌面出现「快捷图标」，点开即可添加配置。
- 删除条目、卸载应用都不会删除任何配置或已生成的子应用。移除条目时会尽力卸载子应用；如果在应用中心手动卸载过子应用，列表会显示「待更新」之类的不一致状态，重新部署即可。
- 升级或重装应用后，配置还在吗？ 配置保存在数据目录，升级不动它。
- 日志在哪里？ 数据与日志都在
/usr/local/apps/@appdata/shortcuts/：log/下按天保存（保留 7 天），shortcuts.json是配置，build/是子应用构建缓存。
仓库使用 Go 标准库（无第三方依赖）+ 原生 JS 前端，前端页面在 shortcuts/app/ui/www/。
| 目录 | 内容 |
|---|---|
cmd/ |
Go 主入口，server / agent / cleanup 三种运行模式 |
internal/ |
领域模型、仓储、Provider、日志、部署编排、HTTP API、Unix Socket 特权代理 |
shortcuts/ |
.fpk 应用包结构：manifest、生命周期脚本、配置、向导、UI、子应用模板 |
icons/ |
图标源文件与 make-icons.js 生成器 |
tools/ |
版本同步与递增、打包、校验脚本，以及随仓库分发的 fnpack |
docs/ |
开发说明与设计文档 |
本地直接 go build 出的单架构二进制只适合调试。正式打包走 package-shortcuts.ps1（见下节），它会同时编译 amd64 / arm64、写 arch-aware launcher、manifest platform=all 合并成单一 fpk。
手动编译单个架构：
mkdir -p shortcuts/app/bin
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o shortcuts/app/bin/fnrt-x86 ./cmd
GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o shortcuts/app/bin/fnrt-arm ./cmdlauncher 脚本按 uname -m 在 x86 / arm / loongarch / risc-v 之间选对应的二进制执行。
go test ./...
go vet ./....\tools\validate-ui.ps1
.\tools\check-encoding.ps1validate-ui.ps1 会对 index.html 内联脚本与 app.js、shortcuts-i18n.js 跑 node --check，并检查两类常见损坏：模板字符串插值丢失美元符号（PowerShell 双引号转义把 ${expr} 变成 {expr}，JS 会原样打印大括号而不求值），以及 querySelector 里的反引号。check-encoding.ps1 保证所有文本文件是 UTF-8 无 BOM。
tools/ 里带了一份 fnpack（Windows 与 Linux 各一），脚本按「显式 -FnpackPath → tools\ 内同名文件 → PATH」的顺序查找：
.\tools\package-shortcuts.ps1
.\tools\check-package.ps1 -PackagePath dist/shortcuts-<version>.fpk产物为 dist/shortcuts-<version>.fpk，已合并 amd64 + arm64（manifest platform=all）。打包前会删除 dist/ 里不匹配当前版本的其他包（含手工放的旧版本）。
打包不会升级版本号。
package-shortcuts.ps1只按shortcuts/manifest里现有的version=出包；bump-version.ps1才递增并同步 UI/README，先 bump 再打包，否则会重复产出同一个旧版本。
当前测试包版本：1.1.0。
push 到 main 且改动包含 shortcuts/manifest 会触发 GitHub Actions（.github/workflows/build.yml，ubuntu-latest），也可手动 workflow_dispatch。流程为：同步版本并校验 → 全平台打包（amd64+arm64 合并为单一 fpk）→ check-package 校验 → 发布。
Release 固定挂在单个 latest tag 上：每次构建清空该 Release 旧资产、上传新 .fpk、把 latest tag 强制挪到当前提交，并删除其余历史 Release、游离 tag 与旧运行记录。Release 描述取 manifest 的 desc。
shortcuts/manifest 是版本唯一来源。改完代码跑一次 bump-version.ps1：自动把最低位递增（如 1.0.266 → 1.0.267），并同步 UI 徽标、i18n 常量与 README 版本行。需要跳到指定版本时用 -Version（如 1.1.0）：
.\tools\bump-version.ps1
.\tools\bump-version.ps1 -Version 1.1.0node icons/make-icons.js生成后自动拷贝到 shortcuts/（包图标 ICON.PNG、ICON_256.PNG）、shortcuts/app/icons/（子应用默认图标）与 shortcuts/app/ui/images/（桌面图标）。
- Entry 的公共字段与类型专属 Config 分离，新增类型不必改主表结构。
- 每种类型实现一个
EntryProvider，负责校验、子应用目录内容与展示信息。 - HTTP handler 只做请求转换，业务逻辑在 service 层；部署、启停、卸载由
DeployService统一编排。 - 需要 root 的系统命令（
appcenter-cli等）只经AgentServer白名单执行，server 进程按TRIM_USERNAME降权运行。 - 关键动作统一写日志：启动、配置保存、子应用构建、appcenter 命令、部署与启停结果。
每种入口类型一份开发说明，含实现链路与注意事项：
MIT。
本项目是第三方应用，与飞牛官方无关。请自行评估使用风险。