@luffysolution/omnischolar-pi 0.1.9 → 0.1.11

package/README.md

@@ -44,6 +44,13 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
+Update or uninstall the Python command:
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+```
+
 ## Connect an agent
 
 ### Codex app and Codex CLI plugin
@@ -57,13 +64,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.9 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 +86,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 +112,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
@@ -136,7 +157,7 @@ Create a labelled illustration of this mechanism. Treat it as a draft, not exper
 
 On the first MCP start or installer run, if no discoverable config exists, OmniScholar creates a complete user-level `omnischolar.config.json` template with all service sections and credential fields. You can also create it explicitly with `omnischolar config init`. API keys may be entered directly as `apiKey`; `apiKeyEnv` is an optional alternative when you prefer environment variables.
 
-Customize the Obsidian output location and new-paper naming with `output.rootDirectory`, `output.literatureDirectory`, `output.filenameTemplate`, and `output.filenameSeparator`; see [literature and output configuration](docs/RESEARCH.en.md).
+Customize the Obsidian output location, paper folders, Markdown files, and parsed image assets with `output.rootDirectory`, `output.literatureDirectory`, `output.folderNameTemplate`, `output.filenameTemplate`, `output.filenameSeparator`, and `output.assetFilenameTemplate`; see [literature and output configuration](docs/RESEARCH.en.md).
 
 A small local configuration can start with Zotero and the output directory:
 

package/README.zh-CN.md

@@ -42,6 +42,13 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
+更新或卸载 Python 命令：
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+```
+
 ## 连接 Agent
 
 ### Codex App 与 Codex CLI 插件安装
@@ -55,13 +62,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.9 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
-采用插件安装方式时无需另外执行 `pip install`。第一次启动 MCP 需要联网，以便 `uvx` 下载并缓存包。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
+采用插件安装方式时无需另外执行 `pip install`。`@latest` 会让 `uvx` 解析最新包，不把插件锁死在某个版本号。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
 
 ### Claude Code 插件安装
 
@@ -77,9 +84,10 @@ uvx --from luffysolution-omnischolar==0.1.9 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 +110,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
@@ -134,7 +155,7 @@ omnischolar mcp
 
 首次启动 MCP 或执行安装命令时，如果没有可发现的配置，程序会在用户配置目录自动创建包含所有服务区块和认证字段的完整 `omnischolar.config.json` 模板。也可以用 `omnischolar config init` 主动创建。API key 可以直接填写在配置文件的 `apiKey` 中；如果希望使用环境变量，也可以填写 `apiKeyEnv`。
 
-文献导入到 Obsidian 的位置和新文件命名可通过 `output.rootDirectory`、`output.literatureDirectory`、`output.filenameTemplate` 和 `output.filenameSeparator` 自定义，详见[文献与输出配置](docs/RESEARCH.md)。
+文献导入到 Obsidian 的位置、文件夹、Markdown 文件和图片附件命名可通过 `output.rootDirectory`、`output.literatureDirectory`、`output.folderNameTemplate`、`output.filenameTemplate`、`output.filenameSeparator` 和 `output.assetFilenameTemplate` 自定义，详见[文献与输出配置](docs/RESEARCH.md)。
 
 最小的本地配置可以只写 Zotero 和输出目录：
 

package/docs/CONFIGURATION.en.md

@@ -46,14 +46,15 @@ The new-paper subfolder and file name can be customized as well:
   "output": {
     "rootDirectory": "F:/Personal Knowledge Base",
     "literatureDirectory": "Literature/Parsed",
+    "folderNameTemplate": "{author}{separator}{year}",
     "filenameTemplate": "{year}{separator}{author}{separator}{title}",
     "filenameSeparator": "+",
-    "assetFilenameTemplate": "figure-{index}-{original}{extension}"
+    "assetFilenameTemplate": "figure{separator}{index}{separator}{original}{extension}"
   }
 }
 ```
 
-The paper filename template supports `{author}`, `{year}`, `{title}`, and `{separator}`; the separator currently accepts `-` or `+`. Attachment filenames support `{index}`, `{original}`, and `{extension}`. These settings affect new publications only; existing sync records keep the path stored in the manifest.
+Paper and folder templates support `{author}`, `{year}`, `{title}`, and `{separator}`; `folderNameTemplate` controls each paper directory name. The shared separator accepts `-`, `+`, and `_` and is available to paper, folder, and attachment templates. Attachment filenames support `{index}`, `{original}`, `{extension}`, and `{separator}`. These settings affect new publications only; existing sync records keep the path stored in the manifest. Here, attachment means a parsed image asset, not the original Zotero PDF attachment.
 
 ## API keys
 

package/docs/CONFIGURATION.md

@@ -46,14 +46,15 @@ OmniScholar 使用 `schemaVersion: 1` 的 JSON 配置。可直接复制根目录
   "output": {
     "rootDirectory": "F:/个人知识库",
     "literatureDirectory": "文献/已解析",
+    "folderNameTemplate": "{author}{separator}{year}",
     "filenameTemplate": "{year}{separator}{author}{separator}{title}",
     "filenameSeparator": "+",
-    "assetFilenameTemplate": "figure-{index}-{original}{extension}"
+    "assetFilenameTemplate": "figure{separator}{index}{separator}{original}{extension}"
   }
 }
 ```
 
-文献文件名模板支持 `{author}`、`{year}`、`{title}`、`{separator}`；连接符目前支持 `-` 和 `+`。附件图片模板支持 `{index}`、`{original}`、`{extension}`。这些设置只影响新建文献，已有同步记录沿用 manifest 中的路径。
+文献和文件夹模板支持 `{author}`、`{year}`、`{title}`、`{separator}`；`folderNameTemplate` 控制每篇文献目录名。连接符目前支持 `-`、`+` 和 `_`，并由文献、文件夹、附件模板共用。附件图片模板支持 `{index}`、`{original}`、`{extension}`、`{separator}`。这些设置只影响新建文献，已有同步记录沿用 manifest 中的路径。这里的附件图片是解析生成的图片，不是 Zotero 原始 PDF 附件。
 
 ## API key
 

package/docs/INSTALLATION.en.md

@@ -12,6 +12,13 @@ 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
+```
+
 For development from a source checkout, replace the package name with `.`.
 
 Check the command:
@@ -21,7 +28,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 +51,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.9 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 +94,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.9 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 +106,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 +136,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 +183,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 +207,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,13 @@ pipx install luffysolution-omnischolar
 python -m pip install luffysolution-omnischolar
 ```
 
+更新或卸载 Python 命令：
+
+```sh
+uv tool upgrade luffysolution-omnischolar
+uv tool uninstall luffysolution-omnischolar
+```
+
 如需从源码开发安装，请将包名替换为 `.`。
 
 验证命令是否可用：
@@ -21,7 +28,7 @@ omnischolar --version
 omnischolar doctor --json
 ```
 
-如果采用下面的 Codex 插件安装方式，则无需预先安装上述 Python 命令；插件会通过 `uvx` 运行固定版本的 PyPI 包。
+如果采用下面的 Codex 插件安装方式，则无需预先安装上述 Python 命令；插件会通过 `uvx` 运行 PyPI 最新包。
 
 ## 安装到 Codex App 或 Codex CLI
 
@@ -44,13 +51,20 @@ codex plugin add omnischolar@omnischolar
 安装后的插件包含 `plugin.json`、`skills/` 和 `mcp.json`。其 MCP 配置执行：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.9 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 +94,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.9 omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```
 
 第一次启动 MCP 需要能够访问 Python 包索引。Skills 使用 `omnischolar` 命名空间，例如 `/omnischolar:scholar-search` 和 `/omnischolar:zotero-research`。
@@ -92,6 +106,7 @@ uvx --from luffysolution-omnischolar==0.1.9 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 +136,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 +183,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 +207,5 @@ npx skills update -p -y
 OmniScholar 的 MCP 入口只有本地 stdio：
 
 ```sh
-omnischolar mcp
+uvx --from luffysolution-omnischolar@latest omnischolar mcp
 ```

package/docs/RESEARCH.en.md

@@ -81,14 +81,15 @@ The output location and new-file naming can be customized in the global configur
   "output": {
     "rootDirectory": "F:/Personal Knowledge Base",
     "literatureDirectory": "Literature/Parsed",
+    "folderNameTemplate": "{author}{separator}{year}",
     "filenameTemplate": "{year}{separator}{author}{separator}{title}",
     "filenameSeparator": "+",
-    "assetFilenameTemplate": "figure-{index}-{original}{extension}"
+    "assetFilenameTemplate": "figure{separator}{index}{separator}{original}{extension}"
   }
 }
 ```
 
-Supported paper filename variables are `{author}`, `{year}`, `{title}`, and `{separator}`; `filenameSeparator` currently accepts `-` or `+`. Attachment images support `assetFilenameTemplate` with `{index}`, `{original}`, and `{extension}`. New papers are written under `rootDirectory/literatureDirectory`, with images under each paper directory's `assets/` folder. Existing manifest records keep their original paths so changing the configuration does not break incremental synchronization.
+Supported paper filename variables are `{author}`, `{year}`, `{title}`, and `{separator}`; `folderNameTemplate` independently controls each paper directory name. `filenameSeparator` accepts `-`, `+`, and `_`, and is shared by paper, folder, and attachment templates. Attachment images support `assetFilenameTemplate` with `{index}`, `{original}`, `{extension}`, and `{separator}`. New papers are written under `rootDirectory/literatureDirectory`, with images under each paper directory's `assets/` folder. Existing manifest records keep their original paths so changing the configuration does not break incremental synchronization. Here, attachment images means parsed image assets, not the original Zotero PDF attachment.
 
 `omnischolar_sync` shows a plan before writing under `output.rootDirectory`. The directory can be a regular folder or part of an Obsidian vault.
 

package/docs/RESEARCH.md

@@ -81,14 +81,15 @@ OmniScholar 不会自动把 Zotero 附件上传到 MinerU。应先确认具体
   "output": {
     "rootDirectory": "F:/个人知识库",
     "literatureDirectory": "文献/已解析",
+    "folderNameTemplate": "{author}{separator}{year}",
     "filenameTemplate": "{year}{separator}{author}{separator}{title}",
     "filenameSeparator": "+",
-    "assetFilenameTemplate": "figure-{index}-{original}{extension}"
+    "assetFilenameTemplate": "figure{separator}{index}{separator}{original}{extension}"
   }
 }
 ```
 
-支持的文献文件名变量为 `{author}`、`{year}`、`{title}` 和 `{separator}`；`filenameSeparator` 当前支持 `-` 或 `+`。附件图片支持 `assetFilenameTemplate`，变量为 `{index}`、`{original}` 和 `{extension}`。新文献会写入 `rootDirectory/literatureDirectory`，图片放在每篇文献目录下的 `assets/`。已有 manifest 记录会沿用原路径，避免改配置后破坏增量同步。
+支持的文献文件名变量为 `{author}`、`{year}`、`{title}` 和 `{separator}`；`folderNameTemplate` 单独控制每篇文献目录名。`filenameSeparator` 当前支持 `-`、`+` 和 `_`，会同时提供给文献、文件夹和附件模板。附件图片支持 `assetFilenameTemplate`，变量为 `{index}`、`{original}`、`{extension}` 和 `{separator}`。新文献会写入 `rootDirectory/literatureDirectory`，图片放在每篇文献目录下的 `assets/`。已有 manifest 记录会沿用原路径，避免改配置后破坏增量同步。这里的附件图片是解析结果中的图片，不是 Zotero 原始 PDF 附件。
 
 `omnischolar_sync` 会先给出计划，再写入 `output.rootDirectory`。该目录可以是普通文件夹，也可以位于 Obsidian Vault 中。
 

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/omnischolar.config.example.json

@@ -233,6 +233,7 @@
   "output": {
     "rootDirectory": "omnischolar-output",
     "literatureDirectory": "Literatures",
+    "folderNameTemplate": "{author}{separator}{year}{separator}{title}",
     "filenameTemplate": "{author}{separator}{year}{separator}{title}",
     "filenameSeparator": "-",
     "assetFilenameTemplate": "image-{index}{extension}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luffysolution/omnischolar-pi",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "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.9" };
+const CLIENT_INFO = { name: "omnischolar-pi", version: "0.1.11" };
 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.9", "omnischolar", "mcp"],
+                args: ["--from", "luffysolution-omnischolar@latest", "omnischolar", "mcp"],
                 stderr: "pipe",
             });
             client = new Client(CLIENT_INFO);