@luffysolution/omnischolar-pi 0.1.6 → 0.1.8

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.6 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 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,6 +136,8 @@ 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).
+
 A small local configuration can start with Zotero and the output directory:
 
 ```json

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.6 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 omnischolar mcp
 ```
 
 采用插件安装方式时无需另外执行 `pip install`。第一次启动 MCP 需要联网，以便 `uvx` 下载并缓存包。各服务的凭据与可选配置仍保存在 OmniScholar 配置中，插件安装不会收集这些信息。
@@ -134,6 +134,8 @@ 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)。
+
 最小的本地配置可以只写 Zotero 和输出目录：
 
 ```json

package/docs/CONFIGURATION.en.md

@@ -39,6 +39,21 @@ 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 new-paper subfolder and file name can be customized as well:
+
+```json
+{
+  "output": {
+    "rootDirectory": "F:/Personal Knowledge Base",
+    "literatureDirectory": "Literature/Parsed",
+    "filenameTemplate": "{year}{separator}{author}{separator}{title}",
+    "filenameSeparator": "+"
+  }
+}
+```
+
+The filename template supports `{author}`, `{year}`, `{title}`, and `{separator}`; the separator currently accepts `-` or `+`. These settings affect new publications only; existing sync records keep the path stored in the manifest.
+
 ## API keys
 
 API keys may be entered directly in the provider's `apiKey` field:

package/docs/CONFIGURATION.md

@@ -39,6 +39,21 @@ OmniScholar 使用 `schemaVersion: 1` 的 JSON 配置。可直接复制根目录
 
 `workspaceRoots` 限定可读取的本地文件，`output.rootDirectory` 限定写入位置。若要直接写入 Obsidian，可把输出目录设为 Vault 中的一个文件夹。
 
+新文献的子文件夹和文件名可以继续细分：
+
+```json
+{
+  "output": {
+    "rootDirectory": "F:/个人知识库",
+    "literatureDirectory": "文献/已解析",
+    "filenameTemplate": "{year}{separator}{author}{separator}{title}",
+    "filenameSeparator": "+"
+  }
+}
+```
+
+文件名模板支持 `{author}`、`{year}`、`{title}`、`{separator}`；连接符目前支持 `-` 和 `+`。这些设置只影响新建文献，已有同步记录沿用 manifest 中的路径。
+
 ## API key
 
 API key 可以直接写入对应服务的 `apiKey`。例如：

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.5 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 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.5 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 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.5 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 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.5 omnischolar mcp
+uvx --from luffysolution-omnischolar==0.1.8 omnischolar mcp
 ```
 
 第一次启动 MCP 需要能够访问 Python 包索引。Skills 使用 `omnischolar` 命名空间，例如 `/omnischolar:scholar-search` 和 `/omnischolar:zotero-research`。

package/docs/RESEARCH.en.md

@@ -74,6 +74,21 @@ A correctly formatted reference does not prove the claim. Ai4Scholar's Google Sc
 
 ## Markdown and Obsidian output
 
+The output location and new-file naming can be customized in the global configuration:
+
+```json
+{
+  "output": {
+    "rootDirectory": "F:/Personal Knowledge Base",
+    "literatureDirectory": "Literature/Parsed",
+    "filenameTemplate": "{year}{separator}{author}{separator}{title}",
+    "filenameSeparator": "+"
+  }
+}
+```
+
+Supported filename variables are `{author}`, `{year}`, `{title}`, and `{separator}`; `filenameSeparator` currently accepts `-` or `+`. 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.
+
 `omnischolar_sync` shows a plan before writing under `output.rootDirectory`. The directory can be a regular folder or part of an Obsidian vault.
 
 Sync distinguishes new content, no change, metadata changes, parse changes, render changes, missing files, conflicts, exclusions, and interrupted recovery. Metadata repair, rerendering, and transaction recovery do not upload a PDF.

package/docs/RESEARCH.md

@@ -74,6 +74,21 @@ OmniScholar 不会自动把 Zotero 附件上传到 MinerU。应先确认具体
 
 ## 保存到 Markdown 或 Obsidian
 
+输出位置和新文件命名可以在全局配置中自定义：
+
+```json
+{
+  "output": {
+    "rootDirectory": "F:/个人知识库",
+    "literatureDirectory": "文献/已解析",
+    "filenameTemplate": "{year}{separator}{author}{separator}{title}",
+    "filenameSeparator": "+"
+  }
+}
+```
+
+支持的文件名变量为 `{author}`、`{year}`、`{title}` 和 `{separator}`；`filenameSeparator` 当前支持 `-` 或 `+`。新文献会写入 `rootDirectory/literatureDirectory`，图片放在每篇文献目录下的 `assets/`。已有 manifest 记录会沿用原路径，避免改配置后破坏增量同步。
+
 `omnischolar_sync` 会先给出计划，再写入 `output.rootDirectory`。该目录可以是普通文件夹，也可以位于 Obsidian Vault 中。
 
 同步会区分新建、无需更新、元数据变化、解析变化、渲染变化、文件缺失、冲突、排除和中断恢复。仅修复元数据、渲染或中断事务时不会上传 PDF。

package/omnischolar.config.example.json

@@ -232,6 +232,9 @@
   },
   "output": {
     "rootDirectory": "omnischolar-output",
+    "literatureDirectory": "Literatures",
+    "filenameTemplate": "{author}{separator}{year}{separator}{title}",
+    "filenameSeparator": "-",
     "conflictDirectory": ".conflicts",
     "safeWrites": true
   }

package/package.json

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