@luffysolution/omnischolar-pi 0.1.10 → 0.1.12

package/README.md

@@ -44,6 +44,17 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
+Update or uninstall the Python command:
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+pipx upgrade luffysolution-omnischolar
+pipx uninstall luffysolution-omnischolar
+python -m pip install --upgrade luffysolution-omnischolar
+python -m pip uninstall luffysolution-omnischolar
+```
+
 ## Connect an agent
 
 ### Codex app and Codex CLI plugin
@@ -57,13 +68,13 @@ codex plugin add omnischolar@omnischolar
 
 In the ChatGPT desktop app, restart the app, open **Plugins**, select the **OmniScholar** marketplace, and install or enable **OmniScholar**. In Codex CLI, run `/plugins` to browse the same marketplace.
 
-The plugin bundles all eight Skills and starts its local MCP server with the pinned PyPI release:
+The plugin bundles all eight Skills and starts its local MCP server from the latest PyPI release:
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
-No separate `pip install` is required for this plugin path. The first MCP start needs network access so `uvx` can download and cache the package. Provider credentials and optional service settings remain in your OmniScholar configuration; plugin installation does not collect them.
+No separate `pip install` is required for this plugin path. `@latest` asks `uvx` to resolve the latest package instead of pinning this plugin to a release number. Provider credentials and optional service settings remain in your OmniScholar configuration; plugin installation does not collect them.
 
 ### Claude Code plugin
 
@@ -79,9 +90,10 @@ For scripts or a regular terminal, use the non-interactive shell commands:
 ```sh
 claude plugin marketplace add luffysolution-svg/omnischolar
 claude plugin install omnischolar@omnischolar --scope user
+claude plugin update omnischolar@omnischolar --scope user
 ```
 
-Run `/reload-plugins` if the install summary asks for it, then start a new session. The plugin automatically starts the same pinned `uvx` MCP server and exposes namespaced Skills such as `/omnischolar:scholar-search`. No separate Python installation is required.
+Run `/reload-plugins` if the install summary asks for it, then start a new session. The plugin automatically starts the latest `uvx` MCP server and exposes namespaced Skills such as `/omnischolar:scholar-search`. No separate Python installation is required.
 
 ### Host configuration installer
 
@@ -104,20 +116,33 @@ For Pi, the full installer runs `pi install npm:@luffysolution/omnischolar-pi` a
 
 ```sh
 pi install npm:@luffysolution/omnischolar-pi
+pi update npm:@luffysolution/omnischolar-pi
+pi remove npm:@luffysolution/omnischolar-pi
 ```
 
 WorkBuddy/CodeBuddy uses `~/.codebuddy/.mcp.json` for user scope and `.mcp.json` for project scope. It does not publish a portable Skills path, so its installer configures MCP and reports Skills as `manual_required`.
 
-The MCP command is:
+The direct latest MCP command is:
 
 ```sh
-omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 Normally the agent starts this process from its MCP configuration. The installer checks `initialize`, `tools/list`, and `omnischolar_status` after writing a supported configuration.
 
 Full host and update instructions are in [Installation](docs/INSTALLATION.en.md).
 
+### Standalone Skills CLI
+
+Plugins already bundle their declared Skills. Use the official Skills CLI separately when you want to install the repository's Skills directly into an agent:
+
+```sh
+# User scope; replace codex with claude-code, pi, cursor, or another supported agent
+npx skills add luffysolution-svg/omnischolar --skill '*' --agent codex --global --yes
+npx skills update --global --yes
+npx skills remove --skill '*' --agent codex --global --yes
+```
+
 ## Try it
 
 ```text

package/README.zh-CN.md

@@ -42,6 +42,17 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
+更新或卸载 Python 命令：
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+pipx upgrade luffysolution-omnischolar
+pipx uninstall luffysolution-omnischolar
+python -m pip install --upgrade luffysolution-omnischolar
+python -m pip uninstall luffysolution-omnischolar
+```
+
 ## 连接 Agent
 
 ### Codex App 与 Codex CLI 插件安装
@@ -55,13 +66,13 @@ codex plugin add omnischolar@omnischolar
 
 在 ChatGPT 桌面应用中重启应用，打开 **Plugins**，选择 **OmniScholar** Marketplace，然后安装或启用 **OmniScholar**。在 Codex CLI 中可运行 `/plugins` 浏览同一 Marketplace。
 
-插件会同时安装 8 个 Skills，并使用固定的 PyPI 版本启动本地 MCP：
+插件会同时安装 8 个 Skills，并从 PyPI 最新版本启动本地 MCP：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
-采用插件安装方式时无需另外执行 `pip install`。第一次启动 MCP 需要联网，以便 `uvx` 下载并缓存包。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
+采用插件安装方式时无需另外执行 `pip install`。`@latest` 会让 `uvx` 解析最新包，不把插件锁死在某个版本号。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
 
 ### Claude Code 插件安装
 
@@ -77,9 +88,10 @@ uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
 ```sh
 claude plugin marketplace add luffysolution-svg/omnischolar
 claude plugin install omnischolar@omnischolar --scope user
+claude plugin update omnischolar@omnischolar --scope user
 ```
 
-如果安装结果提示需要重新加载，请运行 `/reload-plugins`，然后新建会话。插件会自动启动同一个固定版本的 `uvx` MCP，并提供 `/omnischolar:scholar-search` 等带命名空间的 Skills，无需另行安装 Python 包。
+如果安装结果提示需要重新加载，请运行 `/reload-plugins`，然后新建会话。插件会自动启动最新的 `uvx` MCP，并提供 `/omnischolar:scholar-search` 等带命名空间的 Skills，无需另行安装 Python 包。
 
 ### Agent 配置安装器
 
@@ -102,20 +114,33 @@ omnischolar uninstall cursor --scope project
 
 ```sh
 pi install npm:@luffysolution/omnischolar-pi
+pi update npm:@luffysolution/omnischolar-pi
+pi remove npm:@luffysolution/omnischolar-pi
 ```
 
 WorkBuddy/CodeBuddy 的用户级配置位于 `~/.codebuddy/.mcp.json`，项目级配置位于 `.mcp.json`。其官方文档没有给出可移植的 Skills 目录，因此安装器会配置 MCP，并将 Skills 状态报告为 `manual_required`。
 
-本地 MCP 命令为：
+直接运行最新 MCP 的命令为：
 
 ```sh
-omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 通常无需手动运行，Agent 会根据 MCP 配置启动该进程。安装器写入受支持的配置后，会检查 `initialize`、`tools/list` 和 `omnischolar_status`。
 
 各 Agent 的路径、更新和卸载方法见[安装说明](docs/INSTALLATION.md)。
 
+### 独立安装 Skills
+
+插件已经包含其声明的 Skills。如果需要把仓库 Skills 独立安装到 Agent，可使用官方 Skills CLI：
+
+```sh
+# 用户级安装；将 codex 换成 claude-code、pi、cursor 或其他受支持 Agent
+npx skills add luffysolution-svg/omnischolar --skill '*' --agent codex --global --yes
+npx skills update --global --yes
+npx skills remove --skill '*' --agent codex --global --yes
+```
+
 ## 使用示例
 
 ```text

package/docs/INSTALLATION.en.md

@@ -12,6 +12,22 @@ pipx install luffysolution-omnischolar
 python -m pip install luffysolution-omnischolar
 ```
 
+Update or uninstall the Python command:
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+```
+
+If you originally installed with `pipx` or `pip`, use the matching update and uninstall commands:
+
+```sh
+pipx upgrade luffysolution-omnischolar
+pipx uninstall luffysolution-omnischolar
+python -m pip install --upgrade luffysolution-omnischolar
+python -m pip uninstall luffysolution-omnischolar
+```
+
 For development from a source checkout, replace the package name with `.`.
 
 Check the command:
@@ -21,7 +37,7 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
-The Python command installation above is optional when you use the Codex plugin path below. The plugin runs the pinned PyPI package through `uvx` instead.
+The Python command installation above is optional when you use the Codex plugin path below. The plugin runs the latest PyPI package through `uvx` instead.
 
 ## Install in the Codex app or Codex CLI
 
@@ -44,13 +60,20 @@ 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==0.1.10 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
-`uvx` creates an isolated environment and caches the exact release, so this route does not require a separate `pip install`. The first start requires package-index access. To fetch updates to the Git marketplace, run:
+`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
+```
+
+To update the Codex Git marketplace and plugin, run:
 
 ```sh
 codex plugin marketplace upgrade omnischolar
+codex plugin add omnischolar@omnischolar
 ```
 
 To uninstall the plugin or remove its marketplace source:
@@ -80,10 +103,10 @@ claude plugin install omnischolar@omnischolar --scope user
 
 Choose `--scope project` to share the enabled plugin through repository settings, or `--scope local` to enable it only for yourself in the current repository. If Claude reports `Run /reload-plugins to activate`, run that command before using the plugin.
 
-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 is pinned to:
+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==0.1.10 omnischolar mcp
+uvx --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`.
@@ -92,6 +115,7 @@ Update or remove the installation with:
 
 ```sh
 claude plugin marketplace update omnischolar
+claude plugin update omnischolar@omnischolar --scope user
 claude plugin uninstall omnischolar@omnischolar --scope user
 claude plugin marketplace remove omnischolar
 ```
@@ -121,7 +145,13 @@ omnischolar install cursor --scope project
 | Pi | npm Extension | npm Extension | supported |
 | WorkBuddy/CodeBuddy | `~/.codebuddy/.mcp.json` | `.mcp.json` | no documented portable path |
 
-For Pi, `omnischolar install pi` installs `npm:@luffysolution/omnischolar-pi` with Pi's package manager and copies the Skills to the selected scope. The Extension starts the matching PyPI MCP through `uvx`, so only `uv` must be on `PATH`; a separate global Python CLI installation is not required.
+For Pi, `omnischolar install pi` installs the latest `npm:@luffysolution/omnischolar-pi` with Pi's package manager and copies the Skills to the selected scope. The Extension starts the latest PyPI MCP through `uvx`, so only `uv` must be on `PATH`; a separate global Python CLI installation is not required. To manage the Pi Extension directly:
+
+```sh
+pi install npm:@luffysolution/omnischolar-pi
+pi update npm:@luffysolution/omnischolar-pi
+pi remove npm:@luffysolution/omnischolar-pi
+```
 
 WorkBuddy/CodeBuddy supports local stdio MCP servers. Its official documentation does not define a portable Skills directory, so only the MCP component is installed automatically.
 
@@ -162,11 +192,18 @@ omnischolar npx-skills cursor
 For example:
 
 ```sh
-npx skills add luffysolution-svg/omnischolar --skill '*' -a cursor -y
+# User scope: replace codex with claude-code, pi, cursor, or another supported agent
+npx skills add luffysolution-svg/omnischolar --skill '*' -a codex -g -y
+npx skills update -g -y
+npx skills remove --skill '*' -a codex -g -y
+
+# Project scope: omit -g; use project scope for update and removal too
+npx skills add luffysolution-svg/omnischolar --skill '*' -a codex -y
 npx skills update -p -y
+npx skills remove --skill '*' -a codex -y
 ```
 
-These commands install Skills only; they do not install the `omnischolar` Python command.
+These commands install Skills only; they do not install the `omnischolar` Python command. The Codex/Claude plugin or Pi full installer already handles its corresponding Skills, so do not install the same Skills twice.
 
 ## If MCP does not connect
 
@@ -179,5 +216,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
-omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```

package/docs/INSTALLATION.md

@@ -12,6 +12,22 @@ pipx install luffysolution-omnischolar
 python -m pip install luffysolution-omnischolar
 ```
 
+更新或卸载 Python 命令：
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+```
+
+若最初使用 `pipx` 或 `pip`，对应的更新和卸载命令是：
+
+```sh
+pipx upgrade luffysolution-omnischolar
+pipx uninstall luffysolution-omnischolar
+python -m pip install --upgrade luffysolution-omnischolar
+python -m pip uninstall luffysolution-omnischolar
+```
+
 如需从源码开发安装，请将包名替换为 `.`。
 
 验证命令是否可用：
@@ -21,7 +37,7 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
-如果采用下面的 Codex 插件安装方式，则无需预先安装上述 Python 命令；插件会通过 `uvx` 运行固定版本的 PyPI 包。
+如果采用下面的 Codex 插件安装方式，则无需预先安装上述 Python 命令；插件会通过 `uvx` 运行 PyPI 最新包。
 
 ## 安装到 Codex App 或 Codex CLI
 
@@ -44,13 +60,20 @@ codex plugin add omnischolar@omnischolar
 安装后的插件包含 `plugin.json`、`skills/` 和 `mcp.json`。其 MCP 配置执行：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
-`uvx` 会创建隔离环境并缓存该精确版本，因此无需另行运行 `pip install`。第一次启动需要能够访问 Python 包索引。若要更新 Git Marketplace：
+`uvx` 会创建隔离环境并运行 `@latest` 指定的最新包，无需另行运行 `pip install`。若需强制刷新包缓存，可运行：
+
+```sh
+uvx --refresh-package luffysolution-omnischolar --from luffysolution-omnischolar@latest omnischolar mcp
+```
+
+若要更新 Codex Git Marketplace 和插件：
 
 ```sh
 codex plugin marketplace upgrade omnischolar
+codex plugin add omnischolar@omnischolar
 ```
 
 卸载插件或移除 Marketplace 来源：
@@ -80,10 +103,10 @@ claude plugin install omnischolar@omnischolar --scope user
 
 使用 `--scope project` 可通过仓库设置与协作者共享启用状态；使用 `--scope local` 则只在当前仓库为自己启用。如果 Claude 提示 `Run /reload-plugins to activate`，请先运行该命令。
 
-Claude Code 会把仓库根插件复制到版本化缓存，发现 `skills/` 下的 8 个 Skills，并在插件启用时自动启动 `.mcp.json`。MCP 命令固定为：
+Claude Code 会把仓库根插件复制到版本化缓存，发现 `skills/` 下的 8 个 Skills，并在插件启用时自动启动 `.mcp.json`。MCP 命令使用 PyPI 最新包：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 第一次启动 MCP 需要能够访问 Python 包索引。Skills 使用 `omnischolar` 命名空间，例如 `/omnischolar:scholar-search` 和 `/omnischolar:zotero-research`。
@@ -92,6 +115,7 @@ uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
 
 ```sh
 claude plugin marketplace update omnischolar
+claude plugin update omnischolar@omnischolar --scope user
 claude plugin uninstall omnischolar@omnischolar --scope user
 claude plugin marketplace remove omnischolar
 ```
@@ -121,7 +145,13 @@ omnischolar install cursor --scope project
 | Pi | npm Extension | npm Extension | 支持 |
 | WorkBuddy/CodeBuddy | `~/.codebuddy/.mcp.json` | `.mcp.json` | 无官方可移植目录 |
 
-对 Pi，`omnischolar install pi` 会通过 Pi 包管理器安装 `npm:@luffysolution/omnischolar-pi`，并把 Skills 复制到所选作用域。Extension 会通过 `uvx` 启动与当前版本匹配的 PyPI MCP，因此只需保证 `uv` 位于 `PATH`，无需另行安装全局 Python 命令。
+对 Pi，`omnischolar install pi` 会通过 Pi 包管理器安装最新的 `npm:@luffysolution/omnischolar-pi`，并把 Skills 复制到所选作用域。Extension 会通过 `uvx` 启动 PyPI 最新 MCP，因此只需保证 `uv` 位于 `PATH`，无需另行安装全局 Python 命令。直接管理 Pi Extension 时使用：
+
+```sh
+pi install npm:@luffysolution/omnischolar-pi
+pi update npm:@luffysolution/omnischolar-pi
+pi remove npm:@luffysolution/omnischolar-pi
+```
 
 WorkBuddy/CodeBuddy 支持本地 stdio MCP。其官方文档没有定义可移植的 Skills 目录，因此安装器只自动配置 MCP。
 
@@ -162,11 +192,18 @@ omnischolar npx-skills cursor
 例如：
 
 ```sh
-npx skills add luffysolution-svg/omnischolar --skill '*' -a cursor -y
+# 用户级安装：将 codex 替换为 claude-code、pi、cursor 或其他受支持 Agent
+npx skills add luffysolution-svg/omnischolar --skill '*' -a codex -g -y
+npx skills update -g -y
+npx skills remove --skill '*' -a codex -g -y
+
+# 项目级安装：省略 -g；更新和卸载也使用项目作用域
+npx skills add luffysolution-svg/omnischolar --skill '*' -a codex -y
 npx skills update -p -y
+npx skills remove --skill '*' -a codex -y
 ```
 
-这组命令只安装 Skills，不会安装 `omnischolar` Python 命令。
+这组命令只安装 Skills，不会安装 `omnischolar` Python 命令。通过 Codex/Claude plugin 或 Pi Extension 安装时，插件/安装器已经处理了对应 Skills，不需要重复执行。
 
 ## MCP 连接失败
 
@@ -179,5 +216,5 @@ npx skills update -p -y
 OmniScholar 的 MCP 入口只有本地 stdio：
 
 ```sh
-omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```

package/host-configs/README.md

@@ -8,4 +8,4 @@
 - Pi: see `pi.md`; the npm Extension bridges the local MCP server
 - WorkBuddy/CodeBuddy: merge `workbuddy.json` into `~/.codebuddy/.mcp.json` or project `.mcp.json`
 
-All supported MCP entries start the local command `omnischolar mcp`. These files contain no provider credentials.
+All supported MCP entries start the latest PyPI package with `uvx --from luffysolution-omnischolar@latest omnischolar mcp`. These files contain no provider credentials.

package/host-configs/hermes.yaml

@@ -1,6 +1,6 @@
 mcp_servers:
   omnischolar:
-    command: "omnischolar"
-    args: ["mcp"]
+    command: "uvx"
+    args: ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"]
     # Optional: restrict exposure with tools.include or tools.exclude.
     # Inherit OMNISCHOLAR_* and provider environment variables from Hermes.

package/host-configs/opencode.jsonc

@@ -3,7 +3,7 @@
   "mcp": {
     "omnischolar": {
       "type": "local",
-      "command": ["omnischolar", "mcp"],
+      "command": ["uvx", "--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"],
       "enabled": true,
       "timeout": 10000
     }

package/host-configs/pi.md

@@ -6,6 +6,7 @@ OmniScholar uses the npm-published `@luffysolution/omnischolar-pi` Extension to
 omnischolar install pi
 # or install only the Extension with Pi's package manager
 pi install npm:@luffysolution/omnischolar-pi
+pi update npm:@luffysolution/omnischolar-pi
 ```
 
 The Extension starts the matching PyPI MCP through `uvx`, discovers the server's tools, forwards calls and cancellation signals, and closes the MCP client when the Pi session ends. A separate global `omnischolar` command is not required; `uv` must be on `PATH`.

package/host-configs/workbuddy.json

@@ -2,8 +2,8 @@
   "mcpServers": {
     "omnischolar": {
       "type": "stdio",
-      "command": "omnischolar",
-      "args": ["mcp"],
+      "command": "uvx",
+      "args": ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"],
       "description": "OmniScholar research tools"
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luffysolution/omnischolar-pi",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "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.10" };
+const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.12" };
 export function resultText(result) {
     return result.content
         .map((item) => {
@@ -39,7 +39,7 @@ export default function omnischolarExtension(pi) {
         connection = (async () => {
             transport = new StdioClientTransport({
                 command: "uvx",
-                args: ["--from", "luffysolution-omnischolar==0.1.10", "omnischolar", "mcp"],
+                args: ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"],
                 stderr: "pipe",
             });
             client = new Client(CLIENT_INFO);