# Fs Spec Desktop CLI

> 全栈·桌面与 CLI 方向实现规格生成器。Electron、Tauri、WPF/WinUI、Qt、macOS 原生、Linux GTK、终端 TUI(Textual/Bubble Tea)、命令行工具。用户提"桌面应用/命令行工具/终端程序"的规范时使用。属 it-project-spec-generator 体系。

- Skill: `wufufu770/fs-spec-desktop-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wufufu770/fs-spec-desktop-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wufufu770/fs-spec-desktop-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: wufufu770 (https://skillmd.com/u/wufufu770)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wufufu770/fs-spec-desktop-cli

---


# 桌面与 CLI 实现规格生成器

## 角色

资深桌面/工具链架构师：把桌面软件与命令行需求翻译成平台级、交互级可开工可验收的规格。

## 生成前置（每次必做）

按序读取本 skill 目录同级的 `_spec-core/` 下 `core-laws.md` → `protocol.md` → `structure.md` 并遵照执行；内核不可读时降级为无内核模式：直接按本 skill 领域骨架生成，全部精确值标 [待验证] 并在文末注明「核心铁律未加载」。

## 章节骨架（叠加于通用 10 章）

```
Screenshots → Features → Installation（各平台安装表）→ Usage →
Configuration → Keyboard Shortcuts → Development → Building（打包矩阵）→ FAQ
```

## 子形态要点

| 子形态 | 规格必含 |
|--------|---------|
| Electron/Tauri | 主进程/渲染进程职责划分、IPC 通道清单（channel→方向→载荷 schema）、Tauri capabilities 权限表、窗口规格（默认/最小尺寸/居中）、托盘行为、自动更新策略、打包矩阵（Win/macOS/Linux 产物格式与签名要求） |
| WPF/WinUI | XAML 资源字典组织、主题三套（浅/深/高对比度）、DPI 缩放处理、数据绑定规范（INotifyPropertyChanged）、生命周期 |
| macOS 原生 | AppKit/SwiftUI 取舍 ADR、菜单栏结构、快捷键（⌘ 前缀惯例表）、窗口恢复、沙盒 entitlements 表 |
| GTK | GLib 对象模型约定、CSS 主题、i18n 方案 |
| 终端 TUI (Textual/Bubble Tea) | 命令树（命令→参数→描述→示例）、键位映射表（全局/模态）、退出码约定表（0 成功/非 0 分类错误码）、输出格式标志（纯文本/JSON）、256 色/真彩降级、宽度适配（<80 列行为定义）、异步 I/O 响应预算 |
| CLI 工具 | 参数表五列标准、子命令结构、stdin/stdout/stderr 约定、管道友好性（机器可读输出）、配置文件查找顺序（flag > env > 本地配置 > 全局）、--version/--help MUST 有 |

## 领域增补铁律

8. 每个可执行命令/入口 MUST 提供 --help；退出码 MUST 遵循声明的退出码表。
9. 窗口类：MUST 记住上次大小与位置（设置持久化路径显式给出）。
10. 所有快捷键 MUST 在帮助面板可见；自定义能力标 MAY。
11. 自动更新 MUST 校验签名；失败 MUST NOT 静默降级到无更新提示。
12. 安装包体积与启动时间预算入第 7 章（按档位换算，如 S 档 GUI 冷启动 ≤ 1s [待验证：以实测为准]）。

## 跨平台打包矩阵模板（第 9 章必备）

| 平台 | 产物格式 | 签名要求 | 最低 OS | CI Runner |
|------|---------|---------|--------|-----------|
| Windows | NSIS/MSI | 代码签名证书 | Win10 1809+ | windows-latest |
| macOS | dmg + notarize | Developer ID 公证 | [按框架定] | macos-latest |
| Linux | AppImage/deb/rpm | 可选 GPG | glibc 下限声明 | ubuntu-latest |

## 验收惯例

三平台安装→启动→核心操作→卸载全流程冒烟；键盘-only 操作走查（无鼠标完成主流程）；CLI 类做快照测试（stdout 黄金文件）；崩溃日志落盘路径验证。

## 开工检查单默认项

技术栈一行 / 进程与目录结构草案 / 最先实现的 3 个文件（配置加载 → 主窗口壳或命令分发器 → 一个垂直功能）/ 最低验收 = 目标平台安装即用且 --help/快捷键表完整。

## 不适用（When NOT to use）

- Web 应用归 fs-spec-frontend；服务端归 fs-spec-backend。
- 移动 App 归 fs-spec-mobile。
- 带复杂图形界面的桌面创意设计不适用——本 skill 约束可验收实现，不做美术。