yuque-cookie-plugin 0.1.0 → 0.1.1

package/README.md

@@ -6,19 +6,19 @@
 
 这不是一个 OpenAPI wrapper，而是一个本地 CLI 操作面：AI 可以用它读取、整理、下载、快照、对比、格式化并安全写入语雀文档，尽量接近语雀编辑器原生 Lake 结构。
 
-## 当前 MVP 能力
-
-- Cookie 登录和登录态检测：`login`、`auth-status`
-- 读取语雀信息：`inspect`
-- 文档快照和结构对比：`snapshot`、`diff-lake`
-- Lake 和 Markdown 辅助转换：`lake-to-markdown`、`editor-serialize`
-- 安全写入：`apply-lake`、`update-lake`
-- 创建知识库和文档：`create-book`、`create-doc`
+## 当前能力
+
+- Cookie 登录和登录态检测：`auth login`、`auth status`
+- 读取语雀信息：`book inspect`、`doc inspect`
+- 文档快照和结构对比：`doc snapshot`、`lake diff`
+- Lake 和 Markdown 辅助转换：`lake to-markdown`、`lake serialize`
+- 安全写入：`doc apply-lake`、`doc update-lake`
+- 创建知识库和文档：`book create`、`doc create`
 - 标题原生编号：`--number-headings`
-- 整库/单篇下载：`download-book`、`download-doc`
+- 整库/单篇下载：`book download`、`doc download`
 - 下载资源清单、warning、retry 报告
 - 本地 VitePress 预览：`serve-book`
-- 上传并插入图片、PDF 附件：`upload-attach`、`insert-image`、`insert-attachment`
+- 上传并插入图片、PDF 附件：`doc upload`、`doc insert-image`、`doc insert-attachment`
 
 ## 安装
 
@@ -28,15 +28,16 @@
 npm install -g yuque-cookie-plugin
 ```
 
-如果 npm 版本还没有发布，也可以临时从 GitHub 安装：
+当前 npm 最新版本：
 
 ```bash
-npm install -g https://codeload.github.com/c-sunc6/yuque-cookie-plugin/tar.gz/refs/heads/main
+npm view yuque-cookie-plugin version
 ```
 
 安装后可直接运行：
 
 ```bash
+yuque-local --version
 yuque-local --help
 yuque-local auth login
 yuque-local doctor --json
@@ -51,14 +52,12 @@ cd yuque-cookie-plugin
 npm install
 ```
 
-本项目建议作为“项目内本地 CLI”使用：
+开发者也可以在源码目录中作为“项目内本地 CLI”使用：
 
 ```bash
 npm run yuque-local -- --help
 ```
 
-MVP 阶段不建议使用 `npm install -g`、`npm link` 或修改全局 npm 配置，避免影响电脑上的其他开发环境。
-
 ## 登录
 
 ```bash
@@ -217,12 +216,11 @@ npm test
 npm run yuque-local -- --help
 ```
 
-发布前本地打包验证：
+发布检查：
 
 ```bash
-npm pack
-npm install -g ./yuque-cookie-plugin-0.1.0.tgz
-yuque-local --help
+npm run release:check
+npm run release:smoke
 ```
 
 真实语雀验收不会进入默认 `npm test`。需要手动运行：

package/dist/cli.js

@@ -20,6 +20,7 @@ function help() {
     console.log(`yuque-local
 
 Usage:
+  yuque-local --version
   yuque-local auth login [--manual]
   yuque-local auth status [doc-or-book-url] [--json]
   yuque-local doctor [--json]
@@ -88,6 +89,7 @@ Options:
   --force                Recreate VitePress config
   --config-only          Generate serve-book VitePress config and exit
   -h, --help             Show help
+  -v, --version          Show version
 `);
 }
 function parseArgs(argv) {
@@ -162,6 +164,14 @@ function normalizeInvocation(argv) {
 function toCamel(value) {
     return value.replace(/-([a-z])/g, (_match, char) => char.toUpperCase());
 }
+async function readPackageInfo() {
+    const packageJsonPath = path.join(PACKAGE_ROOT, 'package.json');
+    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    return {
+        name: packageJson.name || 'yuque-cookie-plugin',
+        version: packageJson.version || '0.0.0'
+    };
+}
 async function createClient(flags) {
     let credentials;
     try {
@@ -226,14 +236,13 @@ function printError(error) {
     console.error(`yuque-local error: ${message}`);
 }
 async function commandDoctor(flags) {
-    const packageJsonPath = path.join(PACKAGE_ROOT, 'package.json');
-    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    const packageInfo = await readPackageInfo();
     const status = getCredentialStatus(flags);
     const skillSource = path.join(PACKAGE_ROOT, 'skills', 'yuque-cookie-plugin');
     const data = {
         package: {
-            name: packageJson.name || 'yuque-cookie-plugin',
-            version: packageJson.version || '0.0.0',
+            name: packageInfo.name,
+            version: packageInfo.version,
             root: PACKAGE_ROOT
         },
         runtime: {
@@ -311,6 +320,14 @@ async function main() {
         help();
         return;
     }
+    if (command === 'version' || command === '--version' || command === '-v') {
+        const packageInfo = await readPackageInfo();
+        if (flags.json)
+            printJsonResult(jsonResult('success', 'version loaded', packageInfo));
+        else
+            console.log(`${packageInfo.name}@${packageInfo.version}`);
+        return;
+    }
     if (command === 'diff-lake') {
         const [beforePath, afterPath] = positional;
         if (!beforePath || !afterPath)

package/docs/npm-release.md

@@ -27,6 +27,16 @@ npm run release:check
 
 这个命令会执行类型检查、测试、构建、敏感信息扫描、npm 包名检查、`npm pack` 和临时 prefix 安装验证。
 
+## 发布后检查
+
+发布完成后运行：
+
+```bash
+npm run release:smoke
+```
+
+这个命令会从 npm registry 安装 `yuque-cookie-plugin@latest` 到临时 prefix，并验证 `yuque-local --help` 与 `yuque-local doctor --json`。
+
 确认 tarball 至少包含：
 
 - `bin/yuque-local.mjs`

package/docs/usage-zh.md

@@ -19,7 +19,15 @@
 
 ## 2. 安装和准备
 
-进入项目目录：
+普通用户推荐从 npm 安装：
+
+```bash
+npm install -g yuque-cookie-plugin
+yuque-local --version
+yuque-local --help
+```
+
+开发者进入项目目录：
 
 ```bash
 cd /home/mi/文档/yuque-cookie-plugin
@@ -34,6 +42,7 @@ npm install
 检查工具是否可运行：
 
 ```bash
+npm run yuque-local -- --version
 npm run yuque-local -- --help
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuque-cookie-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Cookie-based Yuque CLI for AI agents, without MCP or OpenAPI token limits.",
   "homepage": "https://github.com/c-sunc6/yuque-cookie-plugin#readme",
@@ -48,6 +48,7 @@
     "yuque-local": "tsx ./src/cli.ts",
     "real:acceptance": "tsx ./scripts/real-acceptance.ts",
     "release:check": "tsx ./scripts/prepublish-check.ts",
+    "release:smoke": "tsx ./scripts/registry-smoke.ts",
     "typecheck": "tsc --noEmit",
     "test": "npm run typecheck && vitest run && npm run yuque-local -- --help",
     "test:unit": "vitest run",