@luffysolution/omnischolar-pi 0.1.15 → 0.1.17

package/README.en.md

@@ -48,8 +48,14 @@ Codex plugin:
 ```sh
 codex plugin marketplace add luffysolution-svg/omnischolar --ref main
 codex plugin add omnischolar@omnischolar
+```
+
+Update the installed Codex plugin:
+
+```sh
 codex plugin marketplace upgrade omnischolar
 codex plugin remove omnischolar@omnischolar
+codex plugin add omnischolar@omnischolar
 ```
 
 Claude Code plugin:
@@ -78,7 +84,7 @@ npx skills remove --skill '*' --agent codex --global --yes
 The plugin and host configurations start the latest PyPI MCP with:
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 </details>

package/README.md

@@ -59,13 +59,17 @@ uv tool install --reinstall luffysolution-omnischolar
 ```sh
 codex plugin marketplace add luffysolution-svg/omnischolar --ref main
 codex plugin add omnischolar@omnischolar
+
+# 更新已安装的 Codex 插件
 codex plugin marketplace upgrade omnischolar
+codex plugin remove omnischolar@omnischolar
+codex plugin add omnischolar@omnischolar
 ```
 
 ChatGPT 桌面应用中重启应用后打开 **Plugins**，选择 **OmniScholar** 并安装或启用；Codex CLI 可运行 `/plugins` 浏览插件。插件已经包含 Skills，并通过下面的命令启动 PyPI 最新 MCP：
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 ### Claude Code 插件
@@ -136,7 +140,7 @@ npx skills remove --skill '*' --agent codex --global --yes
     "omnischolar": {
       "type": "stdio",
       "command": "uvx",
-      "args": ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"]
+      "args": ["--refresh-package", "luffysolution-omnischolar", "--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"]
     }
   }
 }

package/docs/INSTALLATION.en.md

@@ -71,20 +71,17 @@ Restart the ChatGPT desktop app after adding the marketplace. Open **Plugins**,
 
 The installed plugin contains `plugin.json`, `skills/`, and `mcp.json`. Its MCP entry executes:
 
-```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
-```
-
-`uvx` creates an isolated environment and runs the latest package requested by `@latest`, so this route does not require a separate `pip install`. To force a package-cache refresh, run:
-
 ```sh
 uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
+`uvx` creates an isolated environment, refreshes the package cache on every start, and runs the latest PyPI package, so this route does not require a separate `pip install`.
+
 To update the Codex Git marketplace and plugin, run:
 
 ```sh
 codex plugin marketplace upgrade omnischolar
+codex plugin remove omnischolar@omnischolar
 codex plugin add omnischolar@omnischolar
 ```
 
@@ -118,7 +115,7 @@ Choose `--scope project` to share the enabled plugin through repository settings
 Claude Code copies the repository-root plugin into its versioned cache, discovers the eight folders under `skills/`, and starts `.mcp.json` automatically when the plugin is enabled. The MCP command uses the latest PyPI package:
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 The first MCP start needs package-index access. Skills are namespaced with `omnischolar`, for example `/omnischolar:scholar-search` and `/omnischolar:zotero-research`.
@@ -228,5 +225,5 @@ These commands install Skills only; they do not install the `omnischolar` Python
 The only MCP server entry in this release is local stdio:
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```

package/docs/INSTALLATION.md

@@ -71,20 +71,17 @@ codex plugin add omnischolar@omnischolar
 
 安装后的插件包含 `plugin.json`、`skills/` 和 `mcp.json`。其 MCP 配置执行：
 
-```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
-```
-
-`uvx` 会创建隔离环境并运行 `@latest` 指定的最新包，无需另行运行 `pip install`。若需强制刷新包缓存，可运行：
-
 ```sh
 uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
+`uvx` 会创建隔离环境，并在每次启动时刷新包缓存后运行 PyPI 最新包，无需另行运行 `pip install`。
+
 若要更新 Codex Git Marketplace 和插件：
 
 ```sh
 codex plugin marketplace upgrade omnischolar
+codex plugin remove omnischolar@omnischolar
 codex plugin add omnischolar@omnischolar
 ```
 
@@ -118,7 +115,7 @@ claude plugin install omnischolar@omnischolar --scope user
 Claude Code 会把仓库根插件复制到版本化缓存，发现 `skills/` 下的 8 个 Skills，并在插件启用时自动启动 `.mcp.json`。MCP 命令使用 PyPI 最新包：
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 第一次启动 MCP 需要能够访问 Python 包索引。Skills 使用 `omnischolar` 命名空间，例如 `/omnischolar:scholar-search` 和 `/omnischolar:zotero-research`。
@@ -236,5 +233,5 @@ npx skills remove --skill '*' -a codex -y
 OmniScholar 的 MCP 入口只有本地 stdio：
 
 ```sh
-uvx --from luffysolution-omnischolar@latest omnischolar mcp
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luffysolution/omnischolar-pi",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Pi MCP bridge for the OmniScholar research toolkit",
   "type": "module",
   "license": "MIT",

package/pi-extension/dist/index.js

@@ -1,7 +1,7 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { Type } from "typebox";
-const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.15" };
+const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.17" };
 export function resultText(result) {
     return result.content
         .map((item) => {
@@ -39,7 +39,14 @@ export default function omnischolarExtension(pi) {
         connection = (async () => {
             transport = new StdioClientTransport({
                 command: "uvx",
-                args: ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"],
+                args: [
+                    "--refresh-package",
+                    "luffysolution-omnischolar",
+                    "--from",
+                    "luffysolution-omnischolar@latest",
+                    "omnischolar",
+                    "mcp",
+                ],
                 stderr: "pipe",
             });
             client = new Client(CLIENT_INFO);