@luffysolution/omnischolar-pi 0.1.9 → 0.1.10

package/README.md

@@ -60,7 +60,7 @@ In the ChatGPT desktop app, restart the app, open **Plugins**, select the **Omni
 The plugin bundles all eight Skills and starts its local MCP server with the pinned PyPI release:
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.9 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.10 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.
@@ -136,7 +136,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

@@ -58,7 +58,7 @@ codex plugin add omnischolar@omnischolar
 插件会同时安装 8 个 Skills，并使用固定的 PyPI 版本启动本地 MCP：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.9 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
 ```
 
 采用插件安装方式时无需另外执行 `pip install`。第一次启动 MCP 需要联网，以便 `uvx` 下载并缓存包。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
@@ -134,7 +134,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

@@ -44,7 +44,7 @@ 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==0.1.10 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:
@@ -83,7 +83,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 is pinned to:
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.9 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
 ```
 
 The first MCP start needs package-index access. Skills are namespaced with `omnischolar`, for example `/omnischolar:scholar-search` and `/omnischolar:zotero-research`.

package/docs/INSTALLATION.md

@@ -44,7 +44,7 @@ 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==0.1.10 omnischolar mcp
 ```
 
 `uvx` 会创建隔离环境并缓存该精确版本，因此无需另行运行 `pip install`。第一次启动需要能够访问 Python 包索引。若要更新 Git Marketplace：
@@ -83,7 +83,7 @@ claude plugin install omnischolar@omnischolar --scope user
 Claude Code 会把仓库根插件复制到版本化缓存，发现 `skills/` 下的 8 个 Skills，并在插件启用时自动启动 `.mcp.json`。MCP 命令固定为：
 
 ```sh
-uvx --from luffysolution-omnischolar==0.1.9 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.10 omnischolar mcp
 ```
 
 第一次启动 MCP 需要能够访问 Python 包索引。Skills 使用 `omnischolar` 命名空间，例如 `/omnischolar:scholar-search` 和 `/omnischolar:zotero-research`。

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/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.10",
   "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.10" };
 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==0.1.10", "omnischolar", "mcp"],
                 stderr: "pipe",
             });
             client = new Client(CLIENT_INFO);