scriptnow-cli 0.3.94__tar.gz → 0.3.95__tar.gz

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scriptnow-cli
-Version: 0.3.94
+Version: 0.3.95
 Summary: ScriptNow 创作 CLI —— 从灵感到成书交付的一站式命令行（CLI-Anything 模式）
 Author: ScriptNow
 License: MIT

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/README.md

@@ -46,8 +46,8 @@
 要求 Python 3.10+。macOS/Linux 系统 Python（Homebrew、python.org）受 PEP 668 保护时，
 请先在虚拟环境中安装：
 
-> **PyPI 分发**：正在准备首次发布；以 [项目页](https://pypi.org/project/scriptnow-cli/) 的实际版本为准。
-> 页面尚不可用时请使用下面的生产源安装方式，不按包名猜测安装。
+> **PyPI 分发已上线**：可用版本见 [项目页](https://pypi.org/project/scriptnow-cli/)。
+> 可用 `pipx install scriptnow-cli`，或在虚拟环境中执行 `python -m pip install scriptnow-cli`。
 > 安装/升级优先走**生产分发源**（sn.igeewa.com，wheel 直装、不依赖 git）；GitHub
 > codeload / git+https 仅作兜底。`scriptnow self-upgrade` / `config on` 后台自动升级
 > 同样优先生产源。
@@ -122,15 +122,16 @@ GitHub（quchenchen/scriptnow-cli）仅作镜像与最后兜底，不构成国
 | 环节 | 优先来源 | 兜底顺序 |
 |---|---|---|
 | 版本探测 | 生产源 `version.txt` | — |
-| wheel / zip 分发 | 生产源 wheel（另有 `-latest-` 固定别名，页面与一键脚本按 latest 装，用户无需知道版本号） | codeload tar.gz → git+https |
+| wheel / zip 分发 | 生产源带真实版本号的 wheel（先读取 `version.txt`；不用 `latest` 作为 wheel 版本号） | codeload tar.gz → git+https |
 | `self-upgrade` | 生产源 wheel | codeload tar.gz → git+https |
 | Windows 一键脚本 | 生产源（install-agent.ps1 / install.ps1 内嵌生产源 URL） | — |
 | Windows 缺 Python 时的引导 | 国内镜像：清华 TUNA → 华为云 → 中科大 | python.org |
-| 页面安装说明（/cli） | latest 别名 URL（生产源） | — |
+| 页面安装说明（/cli） | 版本号 wheel（生产源），并列提供 PyPI 包名安装 | GitHub 源码仅兜底 |
+| PyPI 分发 | `pipx install scriptnow-cli` / 虚拟环境内 `python -m pip install scriptnow-cli` | 平台版本号 wheel |
 
 发布侧（`scripts/sync-cli-release.sh`）每轮自动上传 wheel / zip / `version.txt` /
 `install.ps1` / `install-agent.ps1` 到生产下载目录，并把 `latest` 别名同步为最新版；
-GitHub 镜像仓库与 release tag 仅作生产源之外的备用下载。
+GitHub 镜像仓库与 release tag 仅作生产源之外的备用下载。`latest` 别名只作兼容入口，不作为 pip 安装命令；新版 pip 会拒绝不符合版本规范的文件名。生产同步脚本随后自动调用 PyPI 受信发布 helper；等待审核返回 3 并给出续跑命令，不跳过或自动批准。两处可用版本以各自发布记录为准，公开 wheel 和源码包均就绪才报告完整发布成功。
 
 ## 登录
 
@@ -389,10 +390,10 @@ evaluation v9（深度评估）、work-completion（完结）、invitations（
 
 ## AI Agent 安装（SKILL 体系）
 
-Agent（Claude Code / npx skills 兼容）可通过 SKILL.md 发现能力：
+CLI 可执行程序与 Agent Skill 分别安装；安装 PyPI 包不会自动为每个 Agent 客户端注册 Skill。支持 npx skills 的 Agent 可通过 SKILL.md 发现能力，Skill 名称是 `scriptnow`（不是发行包名 `scriptnow-cli`）：
 
 ```bash
-npx skills add quchenchen/scriptnow-cli --skill scriptnow-cli -g -y
+npx skills add quchenchen/scriptnow-cli --skill scriptnow -g -y
 ```
 
 SKILL.md 位于 [`cli_anything/scriptnow/skills/SKILL.md`](cli_anything/scriptnow/skills/SKILL.md)。

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/cli_anything/scriptnow/README.md

@@ -29,7 +29,7 @@
 
 ## 安装
 
-PyPI 首次发布正在准备，可用版本以 https://pypi.org/project/scriptnow-cli/ 为准；发布完成前使用下列生产源。
+PyPI 分发已上线：https://pypi.org/project/scriptnow-cli/ 。可用 `pipx install scriptnow-cli`，或在虚拟环境中执行 `python -m pip install scriptnow-cli`；默认升级来源仍为下列生产源。
 
 要求 Python 3.10+。macOS/Linux 系统 Python（Homebrew、python.org）受 PEP 668 保护时，
 请先在虚拟环境中安装：
@@ -220,10 +220,10 @@ evaluation v9（深度评估）、work-completion（完结）、invitations（
 
 ## AI Agent 安装（SKILL 体系）
 
-Agent（Claude Code / npx skills 兼容）可通过 SKILL.md 发现能力：
+PyPI 安装提供 CLI 与内置 Skill 文件，但不会自动注册到每个 Agent 客户端。支持 npx skills 的 Agent 可另行安装名为 `scriptnow` 的 Skill：
 
 ```bash
-npx skills add quchenchen/scriptnow-cli --skill scriptnow-cli -g -y
+npx skills add quchenchen/scriptnow-cli --skill scriptnow -g -y
 ```
 
 SKILL.md 位于 [`cli_anything/scriptnow/skills/SKILL.md`](cli_anything/scriptnow/skills/SKILL.md)。
@@ -343,3 +343,8 @@ scriptnow review status <packet-id> --json
 ## 统一创作 Skill 方案
 
 CLI、Creator 与创作运行共用服务端 creative-skill-plan。逐章/逐场前使用 ready-check --unit-id <单元ID> 查看已采纳叙事阶段、本单元功能、个人与内置方法及执行准备；缺少阶段不按集数比例推定。阶段 narrative_stage 与功能 unit_function 随集纲/章纲候选提交，采纳后生效。节奏建议不构成一票否决；已选中、已读取、已应用分别留证。
+
+
+## CLI release synchronization
+
+Maintainers run monorepo `scripts/sync-cli-release.sh` to synchronize GitHub, the production distribution and PyPI. PyPI environment review remains required; exit 3 means pending, with an exact resume command. See [publishing instructions](https://github.com/quchenchen/scriptnow-cli/blob/main/PUBLISHING.md).

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/cli_anything/scriptnow/__init__.py

@@ -1,3 +1,3 @@
 """scriptnow-cli — agent-native CLI for the ScriptNow creative platform."""
 
-__version__ = "0.3.94"
+__version__ = "0.3.95"

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/cli_anything/scriptnow/skills/SKILL.md

@@ -8,10 +8,16 @@ description: Operate ScriptNow as a governed creative-production client. Use for
 This is a runtime entrypoint, not a product manual. Do not expand it into a
 workflow from memory and do not treat local files as ScriptNow projects.
 
-> **CLI 安装 / 升级（生产源优先）**：PyPI 可用版本以项目页为准；首次发布完成前使用平台源。安装/升级优先从平台分发域名
-> `https://sn.igeewa.com/downloads/scriptnow-cli/` 直装 wheel（不依赖 git），GitHub
-> codeload / git+https 仅兜底。已安装用户用 `scriptnow self-upgrade`（自动按
-> 「生产源 → codeload → git+https」尝试），或 `scriptnow config on` 开启后台自动升级。
+> **CLI 安装 / 升级**：发行包名为 `scriptnow-cli`，命令名与 Skill 名为 `scriptnow`。
+> 可用 `pipx install scriptnow-cli` 或虚拟环境内的 `python -m pip install scriptnow-cli` 从
+> [PyPI](https://pypi.org/project/scriptnow-cli/) 安装；平台分发源继续可用，先读取
+> `https://sn.igeewa.com/downloads/scriptnow-cli/version.txt`，再安装对应版本的 wheel。
+> 不使用 `scriptnow_cli-latest-...whl`，新版 pip 会拒绝该版本名。
+> `scriptnow self-upgrade` 的实际顺序仍是「生产源 → codeload → git+https」，不会自动改为 PyPI；
+> PyPI 与平台版本可能不同，分别核对来源。自动升级默认关闭，用户明确选择后才用 `config on`。
+> 安装 CLI 不等于已登录或已创建作品；先 doctor，再按本文 bootstrap 读取实时契约。
+> Agent 客户端如需注册 Skill，另用 `npx skills add quchenchen/scriptnow-cli --skill scriptnow -g -y`
+> （仅适用于支持该工具且已有 Node.js 的客户端）；否则直接执行 `agent-guide --json` 读取契约。
 
 > **分阶段创作（novel）**：`storymap phases` 预览叙事结构（three_act/hero_journey/
 > kishotenketsu/linear/custom）推导的阶段计划；`storymap append-phase` 提交下一个

{scriptnow_cli-0.3.94 → scriptnow_cli-0.3.95}/scriptnow_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scriptnow-cli
-Version: 0.3.94
+Version: 0.3.95
 Summary: ScriptNow 创作 CLI —— 从灵感到成书交付的一站式命令行（CLI-Anything 模式）
 Author: ScriptNow
 License: MIT