@luffysolution/omnischolar-pi 0.1.14 → 0.1.16

package/README.en.md

@@ -78,7 +78,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

@@ -65,7 +65,7 @@ codex plugin marketplace upgrade 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 +136,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/CONFIGURATION.en.md

@@ -41,6 +41,10 @@ If none of the first four sources exists, the first MCP start or installer run c
 
 `workspaceRoots` limits local file reads. `output.rootDirectory` limits file writes. To use Obsidian, set the output directory to a folder inside the vault.
 
+The core services support Windows, Linux, and macOS. Zotero features require Zotero Desktop on the local machine; XRD calculation requires the optional `pymatgen` backend.
+
+`omnischolar_status` does not display the absolute config path. Use `omnischolar config path` when the path is needed.
+
 The new-paper subfolder and file name can be customized as well:
 
 ```json

package/docs/CONFIGURATION.md

@@ -41,6 +41,10 @@ OmniScholar 使用 `schemaVersion: 1` 的 JSON 配置。可直接复制根目录
 
 `workspaceRoots` 限定可读取的本地文件，`output.rootDirectory` 限定写入位置。若要直接写入 Obsidian，可把输出目录设为 Vault 中的一个文件夹。
 
+核心服务支持 Windows、Linux 和 macOS。Zotero 功能需要本机运行 Zotero Desktop；XRD 计算需要可选的 `pymatgen` 后端。
+
+`omnischolar_status` 不显示配置文件绝对路径；需要查看路径时使用 `omnischolar config path`。
+
 新文献的子文件夹和文件名可以继续细分：
 
 ```json

package/docs/INSTALLATION.en.md

@@ -71,16 +71,12 @@ 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
@@ -118,7 +114,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 +224,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,16 +71,12 @@ 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
@@ -118,7 +114,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 +232,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/omnischolar.config.example.json

@@ -38,7 +38,7 @@
       "semantic-scholar": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_SEMANTIC_SCHOLAR_API_KEY",
+        "apiKeyEnv": null,
         "maxPages": 10
       },
       "openalex": {
@@ -50,7 +50,7 @@
       "pubmed": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_NCBI_API_KEY",
+        "apiKeyEnv": null,
         "email": "researcher@example.edu",
         "tool": "omnischolar",
         "maxPages": 10
@@ -75,7 +75,7 @@
       "easyscholar": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_EASYSCHOLAR_API_KEY",
+        "apiKeyEnv": null,
         "maxPages": 5
       }
     }
@@ -84,7 +84,7 @@
     "enabled": true,
     "baseUrl": "https://ai4scholar.net",
     "apiKey": "",
-    "apiKeyEnv": "OMNISCHOLAR_AI4SCHOLAR_API_KEY",
+    "apiKeyEnv": null,
     "timeoutSeconds": 60,
     "maxResponseBytes": 16777216
   },
@@ -98,7 +98,7 @@
     "baseUrl": "https://mineru.net/api/v4",
     "lightweightBaseUrl": "https://mineru.net/api/v1/agent",
     "apiKey": "",
-    "apiKeyEnv": "OMNISCHOLAR_MINERU_API_KEY",
+    "apiKeyEnv": null,
     "model": "pipeline",
     "cacheDirectory": ".omnischolar/mineru",
     "pollIntervalSeconds": 2,
@@ -111,13 +111,13 @@
       "enabled": true,
       "baseUrl": "https://api.materialsproject.org",
       "apiKey": "",
-      "apiKeyEnv": "OMNISCHOLAR_MATERIALS_PROJECT_API_KEY",
+      "apiKeyEnv": null,
       "maxPages": 10
     },
     "casCommonChemistry": {
       "enabled": true,
       "apiKey": "",
-      "apiKeyEnv": "OMNISCHOLAR_CAS_API_KEY",
+      "apiKeyEnv": null,
       "baseUrl": null,
       "contractFile": null
     }
@@ -129,7 +129,7 @@
       "openai": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_OPENAI_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://api.openai.com/v1",
         "models": {
           "gpt-image-1": {
@@ -142,7 +142,7 @@
       "google": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_GEMINI_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
         "models": {},
         "options": {}
@@ -150,7 +150,7 @@
       "vertex": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_VERTEX_ACCESS_TOKEN",
+        "apiKeyEnv": null,
         "project": "your-project",
         "location": "us-central1",
         "models": {},
@@ -159,7 +159,7 @@
       "xai": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_XAI_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://api.x.ai/v1",
         "models": {},
         "options": {}
@@ -167,7 +167,7 @@
       "fal": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_FAL_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://fal.run",
         "models": {},
         "options": {}
@@ -175,7 +175,7 @@
       "dashscope": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_DASHSCOPE_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://your-workspace.cn-beijing.maas.aliyuncs.com/api/v1",
         "models": {},
         "options": {
@@ -185,7 +185,7 @@
       "qwen-cloud": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_QWEN_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://your-workspace.ap-southeast-1.maas.aliyuncs.com/api/v1",
         "models": {},
         "options": {
@@ -195,7 +195,7 @@
       "atlas": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_ATLAS_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://your-atlas-provider.example/v1",
         "models": {},
         "options": {}
@@ -203,7 +203,7 @@
       "custom": {
         "enabled": true,
         "apiKey": "",
-        "apiKeyEnv": "OMNISCHOLAR_CUSTOM_IMAGE_API_KEY",
+        "apiKeyEnv": null,
         "baseUrl": "https://images.example.edu/v1",
         "models": {
           "explicit-model-id": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luffysolution/omnischolar-pi",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "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.14" };
+const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.16" };
 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);