docs(release): keep package guidance independent of publication stage

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
XiaoSeS 2026-10-29 16:22:42 +08:00
parent 2019b77afb
commit 36adc3b662
4 changed files with 10 additions and 10 deletions

View file

@ -2,7 +2,7 @@
All notable CLI behavior changes are documented in this file.
## 0.3.0 (release candidate)
## 0.3.0
### Changed

View file

@ -621,7 +621,7 @@ subject to the server's package validation.
### Installation inventory compatibility
The `0.3.0` release candidate uses installation inventory schema version 3. Each installation directory owns its
Version `0.3.0` uses installation inventory schema version 3. Each installation directory owns its
version, fingerprint, timestamp and ownership, so a user installation and a project installation
of the same skill can remain on different versions. `list --json` reports the actual version for
each target. `upgrade --check --json` and upgrade results contain one row per selected installation

View file

@ -12,7 +12,7 @@ Version `0.4.0` uses the independent `dsh-v0.4.0` tag. It adds versioned example
`0.5.0` adds read-only skill availability diagnosis in installed cards and conversations, with separate integrity, discovery and invocation-policy results. It retains the compatibility and inventory format of `0.4.0`.
`0.6.0` is the current release candidate. It includes managed enable/disable, unified read-only update checks, and compact horizontal installed cards with a More menu. The first mutation uses inventory v3. CLI `0.3.0` is the companion candidate for shared inventory; the planned release order is CLI first, then DSH. Candidate versions do not imply public availability or completed final-package/platform acceptance.
`0.6.0` includes managed enable/disable, unified read-only update checks, and compact horizontal installed cards with a More menu. The first mutation uses inventory v3. CLI `0.3.0` is the companion version for shared inventory; the release order is CLI first, then DSH. Check npm for public availability; final-package and platform acceptance are recorded separately.
## Use an installed skill
@ -87,7 +87,7 @@ Replace `skillhub-test` with the intended Web Profile; initial creation is docum
## Upgrade from an older version
The `0.6.0` candidate uses inventory v3 with per-location activation state. Its compatible core is bundled; it does not invoke CLI commands, and plugin-only users need no CLI. If the same user shares inventory with CLI, stop old scheduled/background writers and finish pending recovery first. Confirm `npm view @astron-team/skillhub@0.3.0 version`, install `npm install -g @astron-team/skillhub@0.3.0`, verify `skillhub version`, and then upgrade the plugin. Before publication, use local candidate tarballs; do not substitute old incompatible packages when the new public version is unavailable.
Version `0.6.0` uses inventory v3 with per-location activation state. Its compatible core is bundled; it does not invoke CLI commands, and plugin-only users need no CLI. If the same user shares inventory with CLI, stop old scheduled/background writers and finish pending recovery first. Confirm `npm view @astron-team/skillhub@0.3.0 version`, install `npm install -g @astron-team/skillhub@0.3.0`, verify `skillhub version`, and then upgrade the plugin. Before publication, use local candidate tarballs; do not substitute old incompatible packages when the new public version is unavailable.
Reading v1/v2 inventory does not migrate it. Before the first successful v3 write, preserve the original inventory bytes and a digest-addressed backup. CLI `0.2.0` does not support v3; its rejection of v3 is neither a usable rollback nor a cross-process mixed-writer guard. Stop all writers and reconcile `SKILL.md` / `SKILL.md.disabled`, package contents, installation metadata and operation journals before considering a downgrade. Restoring inventory alone is insufficient.
@ -223,7 +223,7 @@ Choose “管理安装 → 检查可用性” on a conversational installed-skil
The result distinguishes local integrity, current-session discovery, and user/model invocation policies. Shadowing, local modifications and unknown Host state are separate outcomes. A name-only lookup reports Host observations without proving installation ownership or integrity. Diagnosis never modifies, removes or enables/disables a skill, edits a draft, or sends a message. A historical result is not a guarantee about a later invocation.
## Managed skill enable/disable (0.6.0 candidate)
## Managed skill enable/disable (0.6.0)
Open “管理安装” and choose enable or disable on the explicit location row. User and project copies are independent: disabling the user copy does not disable a project copy. UI and conversation mutations require real human confirmation. `astron_skillhub_disable` / `astron_skillhub_enable` accept fresh installation references, never arbitrary paths.
@ -231,7 +231,7 @@ Disabling changes only the entry from `SKILL.md` to `SKILL.md.disabled`, keeping
This does not revoke loaded conversation content or stop tasks. Another same-named installation can remain available. Unverified Host cache observations remain unknown; the older RC may need a new session to observe a fallback copy. Removing this plugin does not enable its disabled installations.
The increment writes inventory v3 with per-location `installationState`. Reading v1/v2 is non-mutating; migration preserves the original bytes and a digest-addressed backup. The plugin bundles its compatible core and does not invoke an external CLI. Stop old writers and use the matching compatible CLI build before sharing inventory: published CLI `0.2.0` and `0.1.12` are incompatible. The companion candidate is CLI `0.3.0`; publish and verify it before DSH `0.6.0`. Old-package rejection of v3 does not mean rollback is supported. An old inventory backup alone is not a downgrade procedure. Native Windows/macOS entry conversion still requires acceptance before release.
The increment writes inventory v3 with per-location `installationState`. Reading v1/v2 is non-mutating; migration preserves the original bytes and a digest-addressed backup. The plugin bundles its compatible core and does not invoke an external CLI. Stop old writers and use the matching compatible CLI build before sharing inventory: published CLI `0.2.0` and `0.1.12` are incompatible. The companion version is CLI `0.3.0`; publish and verify it before DSH `0.6.0`. Old-package rejection of v3 does not mean rollback is supported. An old inventory backup alone is not a downgrade procedure. Native Windows/macOS entry conversion still requires acceptance before release.
The detail-header website link uses only the detail API’s optional `webUrl`. Missing, null, blank or unsafe values hide the action without breaking skill details or installation. There is no plugin website setting, route construction or Registry fallback; legacy `websiteUrl` settings are ignored. The open-source server uses its trusted `SKILLHUB_PUBLIC_BASE_URL` to supply an absolute link, or null when no valid website base is configured. SaaS must provide this additive API field separately.

View file

@ -12,7 +12,7 @@ SkillHub 的 DSH 原生插件。在 DSH 侧栏打开 **技能中心**,匿名
`0.5.0` 新增技能卡片及对话中的只读可用性诊断,分别报告文件完整性、宿主发现和调用策略,保留 `0.4.0` 的兼容范围及库存格式。
`0.6.0` 为当前发布候选,包含受管理技能启停、统一只读检查更新,以及横向已安装卡片和更多菜单。首次写操作使用库存 v3;同机共享库存的 CLI 配套候选为 `0.3.0`,计划先发布 CLI 再发布插件。候选版本不表示已公开发布,最终包和跨平台验收结果单独记录。
`0.6.0` 包含受管理技能启停、统一只读检查更新,以及横向已安装卡片和更多菜单。首次写操作使用库存 v3;同机共享库存的配套 CLI 为 `0.3.0`,发布顺序为先 CLI 后插件。公开可用状态以 npm 为准,最终包和跨平台验收结果单独记录。
## 使用已安装技能
@ -87,7 +87,7 @@ dsh --profile skillhub-test --host 127.0.0.1 --port 0 --no-open
## 从旧版本升级
`0.6.0` 候选使用库存 v3,记录每个安装位置的启停状态。插件内置兼容核心,不调用 CLI 命令,只有插件的用户无需安装 CLI。如果同一用户还使用 CLI 管理相同库存,先停止所有旧 CLI 的定时/后台写入并完成待恢复操作,确认 `npm view @astron-team/skillhub@0.3.0 version` 可用,再执行 `npm install -g @astron-team/skillhub@0.3.0` 并核对 `skillhub version`,最后升级插件。发布前请使用本地候选 tarball,公开版本不可用时不要替换成旧包混写。
`0.6.0` 使用库存 v3,记录每个安装位置的启停状态。插件内置兼容核心,不调用 CLI 命令,只有插件的用户无需安装 CLI。如果同一用户还使用 CLI 管理相同库存,先停止所有旧 CLI 的定时/后台写入并完成待恢复操作,确认 `npm view @astron-team/skillhub@0.3.0 version` 可用,再执行 `npm install -g @astron-team/skillhub@0.3.0` 并核对 `skillhub version`,最后升级插件。发布前请使用本地候选 tarball,公开版本不可用时不要替换成旧包混写。
读取库存 v1/v2 不迁移;首次成功写入 v3 前保留旧库存原始字节和摘要寻址备份。旧 CLI `0.2.0` 不支持 v3;旧包拒绝读取 v3 不等于可用回滚,也不是跨进程混写保护。不能只恢复旧库存或降级包,必须停止写入并同时核对 `SKILL.md` / `SKILL.md.disabled`、技能内容、安装元数据和操作日志。
@ -228,7 +228,7 @@ dsh plugin --profile skillhub-test remove @astron-team/skillhub-dsh
诊断分别核验本地文件、当前会话加载结果,以及用户/模型调用策略。同名技能生效、本地修改和宿主无法核验会给出不同结论。按技能名查询只说明当前宿主观察到的事实,不证明安装来源或内容完整性。检查不会修改、卸载、启停技能或发送消息;历史结果不保证下一次调用仍然可用。
## 受管理技能启停(0.6.0 候选)
## 受管理技能启停(0.6.0)
在“管理安装”中,对明确位置选择“停用”或“启用”。用户级和项目级副本独立管理;停用用户副本不会关闭项目副本。页面与对话均需真实用户确认,取消不写文件。对话工具 `astron_skillhub_disable` / `astron_skillhub_enable` 使用新查询中的位置引用,不能提交自由路径。
@ -236,7 +236,7 @@ dsh plugin --profile skillhub-test remove @astron-team/skillhub-dsh
这不撤回会话已加载的正文,也不终止任务;同名的其他安装可能继续可用。宿主缓存未确认时明确显示未知,不把文件操作成功当作发现已刷新。旧 RC 的同名接替可能需新会话才能观察到。卸载插件不会自动启用这些技能。
本增量首次写入使用库存 v3(每位置 `installationState`),读取 v1/v2 不改写,迁移保留原始库存字节及摘要备份。插件内置兼容核心,仍不调用外部 CLI;同机使用 CLI 管理相同库存时,须先停止旧写入进程并使用配套兼容构建。现有公开 CLI `0.2.0`/`0.1.12` 不支持此协议,不可混写;配套候选为 CLI `0.3.0`,计划先发布并验证 CLI,再发布 DSH `0.6.0`。旧包拒绝 v3 不表示支持回滚。不能只恢复旧库存文件来降级,须核对入口、安装元数据及操作日志。原生 Windows/macOS 文件转换的实机验收仍是发布前门禁。
本增量首次写入使用库存 v3(每位置 `installationState`),读取 v1/v2 不改写,迁移保留原始库存字节及摘要备份。插件内置兼容核心,仍不调用外部 CLI;同机使用 CLI 管理相同库存时,须先停止旧写入进程并使用配套兼容构建。现有公开 CLI `0.2.0`/`0.1.12` 不支持此协议,不可混写;配套版本为 CLI `0.3.0`,先发布并验证 CLI,再发布 DSH `0.6.0`。旧包拒绝 v3 不表示支持回滚。不能只恢复旧库存文件来降级,须核对入口、安装元数据及操作日志。原生 Windows/macOS 文件转换的实机验收仍是发布前门禁。
详情标题旁“在官网查看”仅使用详情API返回的可选`webUrl`。字段缺失、null、空白或不安全时隐藏按钮,详情与安装照常使用。插件不再提供网站地址配置、不拼路由、不从Registry回退;旧`websiteUrl`配置忽略。开源服务端复用可信`SKILLHUB_PUBLIC_BASE_URL`生成完整地址,未配置合法网站基址则返回null。SaaS需单独同步此可选字段。