xb-init 2.6.2__tar.gz → 2.9.0__tar.gz

{xb_init-2.6.2 → xb_init-2.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xb-init
-Version: 2.6.2
+Version: 2.9.0
 Summary: Project management tool for UV + FastAPI + Vue3 + Electron desktop applications
 Project-URL: Homepage, https://github.com/xuebli/xb
 Project-URL: Documentation, https://github.com/xuebli/xb#readme
@@ -42,7 +42,11 @@ Description-Content-Type: text/markdown
 - 自动生成 `AGENTS.md`（AI 编码助手协作约定）
 - 内置全局亮色/暗色主题切换
 - 可选内置终端（`--terminal`）
+- 可选日志中心（`--logs`，后端日志实时推送到界面，排障不用登机器）
+- 通用设置页（yaml 加一行"值 + 行尾 `# 显示名`"即自动出表单，注释回填不丢失；secrets.yaml 的 key 自动渲染为密码框）
 - 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
+- 可选 CSV 测试引擎（`--csv-test`，产测专用：CSV 定义测试项、人工确认、PASS 判定、HTML 报告归档与历史查看）
+- 特权操作免密提权标配（Linux polkit，管理员组无感、无密码落盘；helper 白名单执行器）
 - 可选自定义应用图标（`--icon`）
 - 内置开发、构建、版本管理命令
 - 自动版本检查与一键升级（`xb --upgrade`）
@@ -77,14 +81,20 @@ xb init demo
 # 带内置终端
 xb init demo --terminal
 
-# 启用应用内自动更新（Linux 提权走 polkit，管理员组无感更新，无密码落盘）
+# 带日志中心
+xb init demo --logs
+
+# 启用应用内自动更新（Ubuntu 更新安装走 polkit 免密提权，管理员组无感）
 xb init demo --update
 
+# 启用 CSV 测试引擎（产测：测试项 CSV + 人工确认 + HTML 报告）
+xb init demo --csv-test
+
 # 带自定义图标
 xb init demo --icon ~/icons/app.png
 
 cd demo
-# 启动开发环境
+# 启动开发环境（自动完成：依赖同步、Git hooks 安装、polkit 特权入口部署）
 xb dev
 
 # 查看状态
@@ -105,12 +115,14 @@ xb dev stop
 ❯ [ ] 应用显示名 : Demo
   [ ] 端口（后端/前端） : 8000 / 8001
   [ ] 内置终端  ✘  (Web 终端组件)
-  [ ] 应用内更新  ✘  (Linux 提权走 polkit，无密码落盘)
+  [ ] 应用内更新  ✘  (Ubuntu 更新安装走 polkit 免密提权)
+  [ ] 日志中心  ✘  (实时查看后端日志，排障刚需)
+  [ ] CSV 测试引擎  ✘  (产测专用：测试项 CSV + HTML 报告)
   [ ] 应用图标 : 使用默认
   [ ] 跳过依赖安装  ✘  (离线环境可跳过)
 ```
 
-- `--name/--port/--terminal/--update/--icon/--skip-install` 传了的参数
+- `--name/--port/--terminal/--update/--logs/--csv-test/--icon/--skip-install` 传了的参数
   直接预填进表单并勾上，回车即确认，老用法不受影响
 - 文本行（显示名/端口/图标）勾选时若仍是默认值则自动清空，直接输入即可
 - stdin 非终端时（脚本/CI 管道调用）自动跳过表单，沿用 CLI 参数
@@ -152,7 +164,7 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
+| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--logs] [--icon PATH] [--skip-install]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
@@ -175,7 +187,9 @@ xb init demo --icon ./my-icon.png
 
 > 详细原理与 AI 开发者注意事项见模板内
 > **[xb/templates/root/docs/自动更新说明.md](xb/templates/root/docs/自动更新说明.md)**
-> （生成的项目会自带 `docs/自动更新说明.md` 与配图）。
+> （生成的项目会自带 `docs/自动更新说明.md` 与配图）；
+> Ubuntu polkit 免密提权的授权机制与调试方法见
+> **[xb/templates/root/docs/polkit免密提权说明.md](xb/templates/root/docs/polkit免密提权说明.md)**。
 
 `xb init demo --update` 会让生成的项目内置自动更新能力，
 以飞书云盘的一个文件夹作为发布"货架"：
@@ -188,8 +202,11 @@ xb init demo --icon ./my-icon.png
 | `backend/services/updater.py` | 版本比较、信息拉取、下载校验、配置备份迁移、安装 |
 | `backend/services/feishu_client.py` | 飞书接口封装（文件夹列举、并发下载） |
 | `backend/managers/secret_obfuscator.py` | 敏感值混淆（`obf1:`，防围观级别） |
+| `backend/managers/privileged_manager.py` | polkit 特权客户端（pkexec 调 root 白名单执行器） |
 | `backend/app_version.py` | 后端版本号（version_manager 提交时自动同步） |
-| `frontend/src/components/UpdateChecker.vue` | 版本号徽章 + 更新弹窗 + 进度条 |
+| `frontend/src/components/version/UpdatePanel.vue` | 更新弹窗（版本信息 / 更新说明 / 迁移明细 / 进度条） |
+| `frontend/src/components/version/CommitHistoryPanel.vue` | 版本弹窗里的提交历史 |
+| `frontend/src/components/GitVersionBadge.vue` | 顶栏版本号徽章 = 更新入口 |
 | `frontend/src/composables/useUpdate.js` | 定时检查 / 下载进度轮询 |
 | `scripts/feishu_upload.py` | 发版端：安装包与版本信息上传飞书 |
 | `configs/config_changes.json` | 配置迁移清单（顶层 key 是版本号） |
@@ -208,6 +225,18 @@ postinst 预部署，管理员组无感、无密码落盘），Windows 等退出
 建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
 应用内更新，检查接口返回 `packaged: false`。
 
+## 深入文档
+
+生成的项目自带 `docs/` 说明文档，模板源文件在 `xb/templates/root/docs/`：
+
+| 文档 | 内容 |
+|------|------|
+| [自动更新说明.md](xb/templates/root/docs/自动更新说明.md) | 应用内自动更新：发版流程、配置迁移清单、AI 开发者纪律 |
+| [polkit免密提权说明.md](xb/templates/root/docs/polkit免密提权说明.md) | Linux polkit 免密提权：安全模型、三件套部署、新增特权操作、排障 |
+| [打包与运行路径说明.md](xb/templates/root/docs/打包与运行路径说明.md) | 构建产物、DEB/NSIS 安装布局、运行时数据目录、三种运行形态判定 |
+| [csv测试引擎说明.md](xb/templates/root/docs/csv测试引擎说明.md) | 产测 CSV 引擎：测试项格式、指令键注册、HTML 报告、纪律（`--csv-test` 项目） |
+| [版本管理说明.md](xb/templates/root/docs/版本管理说明.md) | 版本号 single source of truth、三模态 bump 弹窗、手动 bump、hook 纪律 |
+
 ## 生成的项目结构
 
 ```
@@ -235,6 +264,7 @@ demo/
 ├── version/                # 版本管理（pre-commit hook）
 ├── configs/                # 配置文件
 ├── datas/                  # 运行时数据（gitignore）
+├── docs/                   # 说明文档（打包路径/自动更新/polkit 提权）
 ├── dev.py                  # 开发脚本（Windows/Linux）
 ├── build.py                # 打包脚本（Windows/Linux）
 └── .venv                   # Python 虚拟环境

{xb_init-2.6.2 → xb_init-2.9.0}/README.md

@@ -13,7 +13,11 @@
 - 自动生成 `AGENTS.md`（AI 编码助手协作约定）
 - 内置全局亮色/暗色主题切换
 - 可选内置终端（`--terminal`）
+- 可选日志中心（`--logs`，后端日志实时推送到界面，排障不用登机器）
+- 通用设置页（yaml 加一行"值 + 行尾 `# 显示名`"即自动出表单，注释回填不丢失；secrets.yaml 的 key 自动渲染为密码框）
 - 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
+- 可选 CSV 测试引擎（`--csv-test`，产测专用：CSV 定义测试项、人工确认、PASS 判定、HTML 报告归档与历史查看）
+- 特权操作免密提权标配（Linux polkit，管理员组无感、无密码落盘；helper 白名单执行器）
 - 可选自定义应用图标（`--icon`）
 - 内置开发、构建、版本管理命令
 - 自动版本检查与一键升级（`xb --upgrade`）
@@ -48,14 +52,20 @@ xb init demo
 # 带内置终端
 xb init demo --terminal
 
-# 启用应用内自动更新（Linux 提权走 polkit，管理员组无感更新，无密码落盘）
+# 带日志中心
+xb init demo --logs
+
+# 启用应用内自动更新（Ubuntu 更新安装走 polkit 免密提权，管理员组无感）
 xb init demo --update
 
+# 启用 CSV 测试引擎（产测：测试项 CSV + 人工确认 + HTML 报告）
+xb init demo --csv-test
+
 # 带自定义图标
 xb init demo --icon ~/icons/app.png
 
 cd demo
-# 启动开发环境
+# 启动开发环境（自动完成：依赖同步、Git hooks 安装、polkit 特权入口部署）
 xb dev
 
 # 查看状态
@@ -76,12 +86,14 @@ xb dev stop
 ❯ [ ] 应用显示名 : Demo
   [ ] 端口（后端/前端） : 8000 / 8001
   [ ] 内置终端  ✘  (Web 终端组件)
-  [ ] 应用内更新  ✘  (Linux 提权走 polkit，无密码落盘)
+  [ ] 应用内更新  ✘  (Ubuntu 更新安装走 polkit 免密提权)
+  [ ] 日志中心  ✘  (实时查看后端日志，排障刚需)
+  [ ] CSV 测试引擎  ✘  (产测专用：测试项 CSV + HTML 报告)
   [ ] 应用图标 : 使用默认
   [ ] 跳过依赖安装  ✘  (离线环境可跳过)
 ```
 
-- `--name/--port/--terminal/--update/--icon/--skip-install` 传了的参数
+- `--name/--port/--terminal/--update/--logs/--csv-test/--icon/--skip-install` 传了的参数
   直接预填进表单并勾上，回车即确认，老用法不受影响
 - 文本行（显示名/端口/图标）勾选时若仍是默认值则自动清空，直接输入即可
 - stdin 非终端时（脚本/CI 管道调用）自动跳过表单，沿用 CLI 参数
@@ -123,7 +135,7 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
+| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--logs] [--icon PATH] [--skip-install]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
@@ -146,7 +158,9 @@ xb init demo --icon ./my-icon.png
 
 > 详细原理与 AI 开发者注意事项见模板内
 > **[xb/templates/root/docs/自动更新说明.md](xb/templates/root/docs/自动更新说明.md)**
-> （生成的项目会自带 `docs/自动更新说明.md` 与配图）。
+> （生成的项目会自带 `docs/自动更新说明.md` 与配图）；
+> Ubuntu polkit 免密提权的授权机制与调试方法见
+> **[xb/templates/root/docs/polkit免密提权说明.md](xb/templates/root/docs/polkit免密提权说明.md)**。
 
 `xb init demo --update` 会让生成的项目内置自动更新能力，
 以飞书云盘的一个文件夹作为发布"货架"：
@@ -159,8 +173,11 @@ xb init demo --icon ./my-icon.png
 | `backend/services/updater.py` | 版本比较、信息拉取、下载校验、配置备份迁移、安装 |
 | `backend/services/feishu_client.py` | 飞书接口封装（文件夹列举、并发下载） |
 | `backend/managers/secret_obfuscator.py` | 敏感值混淆（`obf1:`，防围观级别） |
+| `backend/managers/privileged_manager.py` | polkit 特权客户端（pkexec 调 root 白名单执行器） |
 | `backend/app_version.py` | 后端版本号（version_manager 提交时自动同步） |
-| `frontend/src/components/UpdateChecker.vue` | 版本号徽章 + 更新弹窗 + 进度条 |
+| `frontend/src/components/version/UpdatePanel.vue` | 更新弹窗（版本信息 / 更新说明 / 迁移明细 / 进度条） |
+| `frontend/src/components/version/CommitHistoryPanel.vue` | 版本弹窗里的提交历史 |
+| `frontend/src/components/GitVersionBadge.vue` | 顶栏版本号徽章 = 更新入口 |
 | `frontend/src/composables/useUpdate.js` | 定时检查 / 下载进度轮询 |
 | `scripts/feishu_upload.py` | 发版端：安装包与版本信息上传飞书 |
 | `configs/config_changes.json` | 配置迁移清单（顶层 key 是版本号） |
@@ -179,6 +196,18 @@ postinst 预部署，管理员组无感、无密码落盘），Windows 等退出
 建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
 应用内更新，检查接口返回 `packaged: false`。
 
+## 深入文档
+
+生成的项目自带 `docs/` 说明文档，模板源文件在 `xb/templates/root/docs/`：
+
+| 文档 | 内容 |
+|------|------|
+| [自动更新说明.md](xb/templates/root/docs/自动更新说明.md) | 应用内自动更新：发版流程、配置迁移清单、AI 开发者纪律 |
+| [polkit免密提权说明.md](xb/templates/root/docs/polkit免密提权说明.md) | Linux polkit 免密提权：安全模型、三件套部署、新增特权操作、排障 |
+| [打包与运行路径说明.md](xb/templates/root/docs/打包与运行路径说明.md) | 构建产物、DEB/NSIS 安装布局、运行时数据目录、三种运行形态判定 |
+| [csv测试引擎说明.md](xb/templates/root/docs/csv测试引擎说明.md) | 产测 CSV 引擎：测试项格式、指令键注册、HTML 报告、纪律（`--csv-test` 项目） |
+| [版本管理说明.md](xb/templates/root/docs/版本管理说明.md) | 版本号 single source of truth、三模态 bump 弹窗、手动 bump、hook 纪律 |
+
 ## 生成的项目结构
 
 ```
@@ -206,6 +235,7 @@ demo/
 ├── version/                # 版本管理（pre-commit hook）
 ├── configs/                # 配置文件
 ├── datas/                  # 运行时数据（gitignore）
+├── docs/                   # 说明文档（打包路径/自动更新/polkit 提权）
 ├── dev.py                  # 开发脚本（Windows/Linux）
 ├── build.py                # 打包脚本（Windows/Linux）
 └── .venv                   # Python 虚拟环境

{xb_init-2.6.2 → xb_init-2.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "xb-init"
-version = "2.6.2"
+version = "2.9.0"
 description = "Project management tool for UV + FastAPI + Vue3 + Electron desktop applications"
 readme = "README.md"
 requires-python = ">=3.12"

{xb_init-2.6.2 → xb_init-2.9.0}/tests/test_cli.py

@@ -52,11 +52,18 @@ def test_update_hint_suppressed_on_windows(monkeypatch, tmp_path):
     assert "polkit" not in output
 
 
+def test_logs_passed_through(monkeypatch, tmp_path):
+    captured, _ = _invoke_init(monkeypatch, tmp_path, ["--logs"])
+
+    assert captured["enable_logs"] is True
+
+
 def test_plain_init_has_no_update(monkeypatch, tmp_path):
     captured, _ = _invoke_init(monkeypatch, tmp_path, [])
 
     assert captured["enable_update"] is False
     assert captured["enable_terminal"] is False
+    assert captured["enable_logs"] is False
 
 
 def test_display_name_passed_through(monkeypatch, tmp_path):

{xb_init-2.6.2 → xb_init-2.9.0}/tests/test_config_form.py

@@ -58,10 +58,17 @@ def test_collect_unchecked_items_are_none():
     assert result["port"] is None
     assert result["terminal"] is False
     assert result["update"] is False
+    assert result["logs"] is False
     assert result["icon"] is None
     assert result["skip_install"] is False
 
 
+def test_collect_logs_toggled():
+    form = make_form({"logs": True})
+    result = form.collect()
+    assert result["logs"] is True
+
+
 def test_collect_valid_port():
     form = make_form()
     _cursor_key(form, "port")
@@ -99,6 +106,7 @@ def test_run_config_form_skipped_when_not_tty():
         "port": 9100,
         "terminal": True,
         "update": True,
+        "logs": True,
         "icon": None,
         "skip_install": False,
     })
@@ -106,4 +114,5 @@ def test_run_config_form_skipped_when_not_tty():
     assert result["port"] == 9100
     assert result["terminal"] is True
     assert result["update"] is True
+    assert result["logs"] is True
     assert result["display_name"] is None