fix: harden packaging and correct macOS launch docs

- macOS: document open -n -a with an absolute path (plan updated accordingly)
- package.sh: zip with 7z for '/' entry separators; ad-hoc codesign failure is a warning
- USAGE: list blank and unrepresentable paths as invalid arguments
This commit is contained in:
doyaGu committed 2026-10-03 07:57:46 -04:00
1 parent 8347445f51
commit 8ae9780c0e
4 files changed
+31 -15

No files matched your search

+2 -2
View File
@@ -46,7 +46,7 @@
## B. 启动与错误页(M4 / M4R)
- [ ] 无参数、两个参数、`--help`、`-x`、空字符串参数 → 参数错误页,显示 `Usage: ykanban <path>`
- [ ] 无参数、两个参数、`--help`、`-x`、空字符串参数、纯空格参数 → 参数错误页,显示 `Usage: ykanban <path>`
- [ ] 不存在的路径、指向文件的路径 → 目录不存在页
- [ ] 相对路径(如 `ykanban .`)按当前目录解析
- [ ] 无 `.ykanban` 的文件夹 → 未初始化页;点"初始化"后进入看板,预置三列
@@ -98,5 +98,5 @@
- [ ] 产物:`YKanBan-<版本>-win-x64.zip`、`-linux-x64.tar.gz`、`-osx-x64.tar.gz`、`-osx-arm64.tar.gz`
- [ ] Windows:解压后 `YKanBan.exe <path>` 可直接运行(自包含,无需安装 .NET)
- [ ] Linux:解压后 `./YKanBan <path>` 可运行(可执行位保留)
- [ ] macOS:解除隔离后 `open -a YKanBan --args <path>` 与直接运行包内可执行文件均可用;双击 `.app` 只显示参数错误页
- [ ] macOS:解除隔离后 `open -n -a YKanBan --args <绝对路径>` 与直接运行包内可执行文件均可用;双击 `.app` 只显示参数错误页
- [ ] 故意让某平台测试失败 → 该 RID 无产物,其余 RID 不受影响
+2 -2
View File
@@ -122,7 +122,7 @@ card_tags: (card_id, tag_id) 复合主键,双向 ON DELETE CASCADE
- 恰好一个位置参数为合法;相对路径以进程当前工作目录解析为绝对路径
- 无参数、多于一个参数、或参数以 `-` 开头(含 `--help` 等任何选项形式)→ **参数错误页**
- 路径不存在或存在但不是目录 → 目录不存在页
- macOS 双击 `.app` 时无参数,只会显示参数错误页——已接受(纯命令行定位);USAGE.md 说明 macOS 启动方式(`open -a YKanBan --args <path>` 或直接运行包内可执行文件)
- macOS 双击 `.app` 时无参数,只会显示参数错误页——已接受(纯命令行定位);USAGE.md 说明 macOS 启动方式:`open -n -a YKanBan --args <绝对路径>` 或直接运行包内可执行文件(`-n` 保证已有实例运行时仍另起实例;经 `open` 启动时当前目录为 `/`,故须绝对路径)
- 窗口标题:`工作区名 - YKanBan`;无有效工作区(错误页状态)时仅 `YKanBan`
### 4.2 连接管理
@@ -398,4 +398,4 @@ phrase := '"' 任意文本 '"' (内部支持转义:\" → 字面引号,
2. 备份/迁移必须同时复制 `ykanban.db`、`ykanban.db-wal`、`ykanban.db-shm` 三个文件;不支持将工作区放在网络共享(SMB/NFS)上
3. 搜索语法全文(文法、语义、`word` 字符集、转义规则、保留字、大小写折叠、严格校验与非法表达式清单、错误对话框行为,见 §6)
4. 命令行启动规则(`ykanban <path>`;参数规则与各错误页,见 §4.1)
5. macOS 启动方式(`open -a YKanBan --args <path>` 或直接运行包内可执行文件;双击 `.app` 只会显示参数错误页)
5. macOS 启动方式(`open -n -a YKanBan --args <绝对路径>` 或直接运行包内可执行文件;`-n` 保证另起实例,`open` 启动时当前目录为 `/` 故须绝对路径;双击 `.app` 只会显示参数错误页)