# SSH 发布

连接参数放在本机配置中，不写进本文、文章包或公开源码。每台设备使用自己的 SSH key，由服务器管理员登记公钥。

初次部署会创建 `kb-publisher` 账号。它只接受文章上传和固定的发布命令，不能改动公开主页、规则或认证配置。SSH 使用 22 端口时的示例（按实际本机 key 配置）：

```text
python scripts/upload_article.py ARTICLE_DIR --host YOUR_HOST --user kb-publisher --key YOUR_LOCAL_KEY
python scripts/upload_article.py ARTICLE_DIR --host YOUR_HOST --user kb-publisher --key YOUR_LOCAL_KEY --update
```

上传工具使用 SFTP 将文章包放入服务器的独立暂存目录，再执行：

```text
publish STAGING_ID create
publish STAGING_ID update
rollback ARTICLE_ID
```

`create` 拒绝已存在 ID；`update` 拒绝不存在 ID。发布脚本校验所有文件和浏览器检查报告，在锁内构建完整的新知识库版本，最后原子切换 `current` 链接。出错时旧站点继续可读。

回滚只针对指定文章，其他文章保留当前版本。每次操作都会返回文章地址和版本信息。上传工具不会代替用户授权，不会生成 SSH key 或自动扩大服务器权限。