76 lines
4.0 KiB
Markdown
76 lines
4.0 KiB
Markdown
# BJD CMS Content
|
||
|
||
BJD CMS Content 的公共、宿主无关发行仓库。发行包同时包含标准 Python
|
||
stdio MCP 服务与完整配套 Skill，适用于任何能够注册本地 stdio MCP 的宿主。
|
||
|
||
当前稳定版：`0.8.0`
|
||
|
||
- MCP server：`0.8.0`
|
||
- fallback client：`1.9.1`
|
||
- 工具数：`25`
|
||
- Python：`3.10+`
|
||
- 第三方运行依赖：无
|
||
|
||
请只从 [Releases](https://git.justconn.top/gitea-admin/bjd-cms-content/releases)
|
||
下载不可变发行资产，不要从浮动的 `main` 分支安装。
|
||
|
||
## 安装、更新共用一个 Prompt
|
||
|
||
下面这段 Prompt 无需填写版本或校验和，以后更新时仍然原样复用：
|
||
|
||
```text
|
||
请从 https://git.justconn.top/gitea-admin/bjd-cms-content 安装或更新 BJD CMS Content。
|
||
|
||
1. 解析最新的非草稿、非预发布稳定 Release，并在本次任务内固定其 tag 与资产 URL。只下载 SHA256SUMS 和一个适合当前操作系统的发行归档，按 SHA256SUMS 校验一次；不一致立即停止。不得从分支或仓库源码归档安装。
|
||
2. 把归档解压到临时目录，在 POSIX 上运行随包 install/install.sh，在 Windows 上运行 install/install.ps1。若已经注册过 BJD CMS，复用原来的绝对安装前缀；能取得当前宿主所用 Python 3 可执行文件时把它传给安装脚本，否则让脚本自动探测。安装脚本输出的单行 JSON 是唯一验收依据：它已完成版本检查、不可变安装或复用、失败不切换的 current 指针更新及 native MCP smoke；不要手工重复这些检查。
|
||
3. 按 JSON 返回值注册本地 stdio MCP：command 使用 python_executable，唯一参数使用 plugin_path/scripts/server.py，cwd 使用 plugin_path。只新增或更新 bjd-cms-content 这一项，不添加 Token，也不设置 BJD_CMS_SKILL_ROOT。若宿主支持本地 Skill，用其正常机制注册完整 skill_path 目录。
|
||
4. 若宿主提供正常、非破坏性的 MCP 连接测试，只运行一次并确认发现 25 个工具；不要逐项列出工具，也不要在安装任务中配置 CMS 连接或发起任何 CMS 请求。
|
||
5. 不要从当前宿主进程内部重载、停止或重启宿主。若新注册必须外部重载或重启，只报告这一个操作并让用户随后开启新会话；软件安装已经完成，不需要跨重启续跑原任务。
|
||
|
||
最后只报告：release_version 与 action、plugin_path、skill_path、归档校验结果、native_smoke 结果、宿主注册结果，以及是否需要外部重载并开启新会话。保留无关宿主配置和旧版本目录；本任务中不得索取、显示、搬移或修改 CMS 凭证。
|
||
```
|
||
|
||
## 手动安装
|
||
|
||
下载一个发行归档及 `SHA256SUMS`，校验并解压后运行：
|
||
|
||
POSIX：
|
||
|
||
```sh
|
||
sh install/install.sh
|
||
```
|
||
|
||
Windows PowerShell：
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy RemoteSigned -File install/install.ps1
|
||
```
|
||
|
||
同一命令同时处理首次安装、更新和已是最新版的校验。成功时只输出一行 JSON，
|
||
其中包含精确的 Python、plugin、skill 路径与已完成的 `native_smoke` 结果。
|
||
|
||
用这些返回值映射到宿主的标准本地 stdio MCP 配置：
|
||
|
||
```json
|
||
{
|
||
"command": "<python_executable>",
|
||
"args": ["<plugin_path>/scripts/server.py"],
|
||
"cwd": "<plugin_path>"
|
||
}
|
||
```
|
||
|
||
若宿主支持本地 Skill，注册完整的 `skill_path`。不要在 MCP 配置中放置
|
||
`AI_CONTENT_API_TOKEN`；标准发行布局会自动找到相邻 Skill，无需设置
|
||
`BJD_CMS_SKILL_ROOT`。
|
||
|
||
CMS 凭证配置与首次 CMS 连接属于后续独立任务，不是软件安装的一部分。安装时
|
||
不创建测试内容，也不调用 CMS 读写接口。
|
||
|
||
## 边界
|
||
|
||
- 公开下载权限不代表 CMS API 权限。
|
||
- 每位使用者的 CMS Token 独立签发、可过期、可撤销，并由服务端限制站点和操作。
|
||
- `0.8.0` 提供受保护的产品与系列永久删除工具；产品删除使用独立的 `product-delete` scope，且必须通过版本、引用、确认、审计与删除后验证。
|
||
- 发布、线上修改、回滚与缓存操作继续遵循 Skill 中的确认和验证规则。
|
||
- 软件回滚不会回滚 CMS 内容。
|