@pm_zhousl/xinyun-ai-init 1.0.0 → 1.0.2

package/README.md

@@ -2,26 +2,48 @@
 
 欣芸技术开发 Agent 流初始化包。
 
-## 使用方式
+## Codex 一句话入口
 
-在目标代码项目根目录执行：
+用 Codex 打开项目后，直接发送：
+
+```md
+请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。
+```
+
+## 手动使用
 
 ```bash
-npx @pm_zhousl/xinyun-ai-init
+npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 ```
 
-执行后会在当前目录生成：
+执行后会在当前目录生成 `xinyun-ai-init/`。
 
-```md
-xinyun-ai-init/
+## 注意
+
+该 CLI 只释放初始化包，不修改业务代码、不创建 `xinyun-ai/`。
+
+完整执行要求已经内置在 `xinyun-ai-init/README.md`、`rules/` 和 `templates/` 中。后续不需要复制长提示词，只需要让 AI 读取本地释放出来的 `xinyun-ai-init/README.md`。
+
+## 维护者发布
+
+发布新版时，在本包目录执行：
+
+```powershell
+npm run publish:token
 ```
 
-然后把下面这句话发给 Codex / Cursor / Claude Code：
+脚本会提示输入 npm token，临时写入 `.npmrc`，发布完成或失败后自动删除 `.npmrc`。
 
-```md
-请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。
+如果需要让 AI 代执行，可先在当前终端设置临时环境变量：
+
+```powershell
+$env:NPM_TOKEN="你的 npm token"
+npm run publish:token
+$env:NPM_TOKEN=$null
 ```
 
-## 注意
+发布前预演：
 
-该 CLI 只释放初始化包，不修改业务代码。
+```powershell
+npm run publish:token:dry
+```

package/bin/xinyun-ai-init.js

@@ -48,7 +48,9 @@ function main() {
 function printNextStep() {
   console.log("下一步：把下面这句话发给 Codex / Cursor / Claude Code：");
   console.log("");
-  console.log("请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。");
+  console.log("请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。");
+  console.log("");
+  console.log("完整执行要求已经在 xinyun-ai-init/README.md 内，不需要再粘贴长提示词。");
   console.log("");
 }
 

package/init/xinyun-ai-init/README.md

@@ -1,18 +1,36 @@
 # xinyun-ai-init 初始化包
 
-本目录是“欣芸技术开发 Agent 流”的初始化包。
+本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
-使用方式：
+## Codex 一句话入口
 
-1. 将 `xinyun-ai-init.zip` 放到目标代码项目根目录。
-2. 解压后得到 `xinyun-ai-init/`。
-3. 打开 Codex、Cursor、Claude Code 或其他 AI 编程工具，并确保当前工作目录是目标项目根目录。
-4. 输入：
+```md
+请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。
+```
+
+AI 读取本文件后，必须把本 README、`rules/`、`templates/` 作为执行依据；用户不需要再粘贴长规则。
+
+## 手动使用
 
 ```md
-请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。
+npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 ```
 
+执行上面的命令后，会生成 `xinyun-ai-init/`。随后让 AI 读取 `xinyun-ai-init/README.md` 即可。
+
+## AI 执行入口
+
+AI 读取本文件后，必须按以下方式执行：
+
+1. 如果当前项目没有 `xinyun-ai/`，进入极速初始化模式。
+2. 如果当前项目已有 `xinyun-ai/`，进入升级检查模式。
+3. 未获用户确认前，不得修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+4. 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+5. 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
+6. 非项目开发内容不要沉淀。
+7. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
+8. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -40,8 +58,8 @@
 - 读取 `xinyun-ai/manifest.json`、`xinyun-ai/README.md`、`xinyun-ai/rules/core-rules.md`、`xinyun-ai/index/project-index.json`。
 - 对比 `xinyun-ai-init/version.json`。
 - 进入升级检查模式。
-- 输出升级方案。
-- 等用户确认后，只升级 `xinyun-ai/` 内相关文件，不修改业务代码。
+- 输出升级方案，等待用户确认。
+- 用户确认后，只升级 `xinyun-ai/` 内相关文件，不修改业务代码。
 
 ## 首次最小落盘
 

package/init/xinyun-ai-init/prompt.md

@@ -1 +1 @@
-请读取当前项目根目录下的 `xinyun-ai-init/README.md`，按“欣芸技术开发 Agent 流”初始化或升级当前项目；未获确认前不要修改业务代码。
+请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。

package/init/xinyun-ai-init/templates/manifest.template.json

@@ -1,4 +1,4 @@
-{
+{
   "projectName": "",
   "xinyunAiVersion": "1.0.0",
   "scriptVersion": "2026.07.10",

package/init/xinyun-ai-init/templates/project-index.template.json

@@ -1,4 +1,4 @@
-{
+{
   "projectSummary": "",
   "understanding": {
     "overall": "quick",

package/init/xinyun-ai-init/version.json

@@ -1,7 +1,7 @@
-{
+{
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "scriptVersion": "2026.07.10",
   "schemaVersion": "1",
   "defaultMode": "fast-init",

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"
@@ -8,8 +8,13 @@
   "files": [
     "bin/",
     "init/",
+    "scripts/",
     "README.md"
   ],
+  "scripts": {
+    "publish:token": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1",
+    "publish:token:dry": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1 -DryRun"
+  },
   "keywords": [
     "xinyun-ai",
     "codex",

package/scripts/publish-with-token.ps1

@@ -0,0 +1,91 @@
+param(
+  [string]$Registry = "https://registry.npmjs.org/",
+  [switch]$DryRun
+)
+
+$ErrorActionPreference = "Stop"
+
+$ProjectRoot = Resolve-Path (Join-Path $PSScriptRoot "..")
+$NpmrcPath = Join-Path $ProjectRoot ".npmrc"
+$PackageJsonPath = Join-Path $ProjectRoot "package.json"
+
+function Assert-CommandExists {
+  param([string]$Name)
+
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    throw "Missing command: $Name. Please install or configure $Name first."
+  }
+}
+
+function ConvertTo-PlainText {
+  param([securestring]$SecureValue)
+
+  $ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureValue)
+  try {
+    return [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)
+  } finally {
+    if ($ptr -ne [IntPtr]::Zero) {
+      [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)
+    }
+  }
+}
+
+Push-Location $ProjectRoot
+
+try {
+  Assert-CommandExists "node"
+  Assert-CommandExists "npm"
+
+  $Package = Get-Content -Raw -Encoding UTF8 $PackageJsonPath | ConvertFrom-Json
+  Write-Host "[xinyun-ai-init] Publish target: $($Package.name)@$($Package.version)"
+  Write-Host "[xinyun-ai-init] Registry: $Registry"
+
+  if (Test-Path $NpmrcPath) {
+    Remove-Item -LiteralPath $NpmrcPath -Force
+  }
+
+  $Token = [Environment]::GetEnvironmentVariable("NPM_TOKEN")
+
+  if ([string]::IsNullOrWhiteSpace($Token)) {
+    $SecureToken = Read-Host "Paste npm token" -AsSecureString
+    $Token = ConvertTo-PlainText $SecureToken
+  } else {
+    Write-Host "[xinyun-ai-init] Using NPM_TOKEN from environment."
+  }
+
+  if ([string]::IsNullOrWhiteSpace($Token)) {
+    throw "NPM token is empty. Publish cancelled."
+  }
+
+  $Utf8NoBom = New-Object System.Text.UTF8Encoding($false)
+  [System.IO.File]::WriteAllLines(
+    $NpmrcPath,
+    @(
+      "@pm_zhousl:registry=$Registry",
+      "//registry.npmjs.org/:_authToken=$Token"
+    ),
+    $Utf8NoBom
+  )
+
+  Write-Host "[xinyun-ai-init] Validate JSON..."
+  node -e "JSON.parse(require('fs').readFileSync('package.json','utf8')); JSON.parse(require('fs').readFileSync('init/xinyun-ai-init/version.json','utf8')); console.log('json ok')"
+
+  if ($DryRun) {
+    Write-Host "[xinyun-ai-init] Run npm publish dry-run..."
+    npm publish --access public --registry=$Registry --dry-run
+  } else {
+    Write-Host "[xinyun-ai-init] Run npm publish..."
+    npm publish --access public --registry=$Registry
+
+    Write-Host "[xinyun-ai-init] Check published version..."
+    npm view $Package.name version --registry=$Registry
+  }
+} finally {
+  if (Test-Path $NpmrcPath) {
+    Remove-Item -LiteralPath $NpmrcPath -Force
+    Write-Host "[xinyun-ai-init] Removed temporary .npmrc"
+  }
+
+  $Token = $null
+  Pop-Location
+}