重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
package-script-writer by umbraco/umbraco-cms-backoffice-skills
npx skills add https://github.com/umbraco/umbraco-cms-backoffice-skills --skill package-script-writer使用 psw CLI 工具生成并运行 Umbraco CMS 安装脚本。
检查 PSW CLI 是否已安装:
psw --version
如果命令未找到,.NET 工具路径可能不在 PATH 中。请尝试:
* **Linux/Mac:** `export PATH="$PATH:$HOME/.dotnet/tools" && psw --version`
* **Windows:** `%USERPROFILE%\.dotnet\tools\psw --version`
2. 如果未安装,请安装它:
dotnet tool install --global PackageScriptWriter.Cli
3. 然后运行 psw 命令(见下文)
这是要使用的命令:
export PATH="$PATH:$HOME/.dotnet/tools"
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password SecurePass1234 --auto-run
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
使用 run_in_background: true 运行此命令,因为 Umbraco 是一个长期运行的 Web 服务器。
关键标志:
-d - 必需 - 生成完整的安装脚本(没有这个标志,只会生成 dotnet run 命令,这会导致失败)-u - 使用无人值守安装默认值--auto-run - 立即执行生成的脚本-o 与 --auto-run 结合使用(会截断脚本)默认凭据: admin@test.com / SecurePass1234
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password "SecurePass1234" -p "uSync,Umbraco.Forms" --auto-run
使用特定版本:
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password "SecurePass1234" -p "uSync|17.0.0,Umbraco.Forms|17.0.1" --auto-run
不要在密码或用户名中使用需要转义的字符
| 标志 | 描述 |
|---|---|
-d, --default | 必需 - 生成完整的安装脚本 |
-n, --project-name | 项目名称 |
-s, --solution | 解决方案名称 |
-u, --unattended-defaults | 使用无人值守安装默认值 |
--database-type | SQLite, LocalDb, SQLServer, SQLAzure, SQLCE |
--admin-email | 无人值守安装的管理员邮箱 |
--admin-password | 无人值守安装的管理员密码 |
--auto-run | 执行生成的脚本 |
-p, --packages | 逗号分隔的包列表(例如:"uSync,Umbraco.Forms") |
-t, --template-package | Umbraco 模板包(可指定版本) |
-da, --delivery-api | 启用内容交付 API |
在后台运行命令后,轮询检查是否就绪:
# 检查输出中的端口号(例如:"Now listening on: https://localhost:44356")
# 然后轮询直到就绪:
for i in {1..30}; do
if nc -z localhost 44356 2>/dev/null; then
echo "Umbraco is ready!"
break
fi
sleep 2
done
psw versions # 显示 Umbraco 版本及其支持状态
psw history list # 显示最近的脚本
psw history rerun 1 # 重新运行脚本 #1
psw --clear-cache # 清除缓存的 API 响应
每周安装次数
67
代码仓库
GitHub 星标数
14
首次出现
2026年2月4日
安全审计
安装于
github-copilot50
opencode21
codex21
cursor21
amp19
kimi-cli19
Generate and run Umbraco CMS installation scripts using the psw CLI tool.
Check if PSW CLI is installed:
psw --version
If command not found, the .NET tools path may not be in PATH. Try:
* **Linux/Mac:** `export PATH="$PATH:$HOME/.dotnet/tools" && psw --version`
* **Windows:** `%USERPROFILE%\.dotnet\tools\psw --version`
2. If not installed, install it:
dotnet tool install --global PackageScriptWriter.Cli
3. Then run the psw command (see below)
This is the command to use:
export PATH="$PATH:$HOME/.dotnet/tools"
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password SecurePass1234 --auto-run
Run this with run_in_background: true since Umbraco is a long-running web server.
Critical flags:
-d - REQUIRED - generates the full installation script (without this, only dotnet run is generated which fails)-u - use unattended install defaults--auto-run - execute the script immediately-o with --auto-run (truncates the script)Default credentials: admin@test.com / SecurePass1234
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password "SecurePass1234" -p "uSync,Umbraco.Forms" --auto-run
With specific versions:
psw -d -n ProjectName -s ProjectName -u --database-type SQLite --admin-email admin@test.com --admin-password "SecurePass1234" -p "uSync|17.0.0,Umbraco.Forms|17.0.1" --auto-run
Do not use characters that are escapable in passwords or usernames
| Flag | Description |
|---|---|
-d, --default | REQUIRED - generates full installation script |
-n, --project-name | Project name |
-s, --solution | Solution name |
-u, --unattended-defaults | Use unattended install defaults |
--database-type | SQLite, LocalDb, SQLServer, SQLAzure, SQLCE |
--admin-email |
After running the command in background, poll for readiness:
# Check the output for the port number (e.g., "Now listening on: https://localhost:44356")
# Then poll until ready:
for i in {1..30}; do
if nc -z localhost 44356 2>/dev/null; then
echo "Umbraco is ready!"
break
fi
sleep 2
done
psw versions # Show Umbraco versions with support status
psw history list # Show recent scripts
psw history rerun 1 # Re-run script #1
psw --clear-cache # Clear cached API responses
Weekly Installs
67
Repository
GitHub Stars
14
First Seen
Feb 4, 2026
Security Audits
Gen Agent Trust HubWarnSocketPassSnykFail
Installed on
github-copilot50
opencode21
codex21
cursor21
amp19
kimi-cli19
Lark Drive API 使用指南:飞书云文档、Wiki、表格 Token 处理与文件管理
40,700 周安装
| Admin email for unattended install |
--admin-password | Admin password for unattended install |
--auto-run | Execute the generated script |
-p, --packages | Comma-separated packages (e.g., "uSync,Umbraco.Forms") |
-t, --template-package | Umbraco template with optional version |
-da, --delivery-api | Enable Content Delivery API |