dsh-novel-writer 4.1.0 → 4.1.1

package/README.en.md

@@ -15,19 +15,19 @@ exposed as a **stdio MCP server** for Claude Desktop / Cursor.
 
 ## Install
 
-`sh
+```sh
 dsh plugin --profile web add dsh-novel-writer
 # or
 npm install dsh-novel-writer
-`
+```
 
 Requires **Node >= 22.3**. Restart the web app; a "写作助手功能" panel appears in the sidebar.
 
 ## MCP server
 
-`sh
-node /path/to/node_modules/dsh-novel-writer/mcp/server.mjs --root /path/to/your/novels
-`
+```sh
+npx -y -p dsh-novel-writer dsh-novel-writer-mcp --root /path/to/your/novels
+```
 
 See [mcp/README.md](./mcp/README.md) for the Claude Desktop / Cursor config.
 

package/README.md

@@ -32,15 +32,15 @@
 
 **方式一：npm（推荐）**
 
-`sh
+```sh
 dsh plugin --profile web add dsh-novel-writer
-`
+```
 
 **方式二：从 GitHub 安装**
 
-`sh
+```sh
 dsh plugin --profile web add github:siweina/dsh-novel-writer#main
-`
+```
 
 **方式三：MCP（不用 DSH 也能用）** —— 见 [MCP 服务器](#mcp-服务器非-dsh-用户也能用)
 
@@ -48,9 +48,9 @@ dsh plugin --profile web add github:siweina/dsh-novel-writer#main
 
 ## 60 秒上手
 
-`sh
+```sh
 mkdir -p novels/我的小说     # 把章节文件放进去（第01章.md、第02章.md …）
-`
+```
 
 然后在对话里说：**"用 novel_style_report 给我的小说做一次风格画像"**，你会拿到：
 
@@ -139,12 +139,18 @@ fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句
 包里自带一个 **stdio MCP 服务器**（`mcp/server.mjs`），把 16 个工具原样暴露给任何 MCP 客户端，
 例如 Claude Desktop、Cursor。**它是跑在你自己电脑上的本地进程，不需要服务器、不需要联网、不需要常驻。**
 
+```bash
+npx -y -p dsh-novel-writer dsh-novel-writer-mcp --root /你的小说库路径
+```
+
+客户端配置示例（`claude_desktop_config.json` / Cursor `mcp.json`）：
+
 ```json
 {
   "mcpServers": {
     "dsh-novel-writer": {
-      "command": "node",
-      "args": ["/绝对路径/mcp/server.mjs", "--root", "/你的小说库路径"]
+      "command": "npx",
+      "args": ["-y", "-p", "dsh-novel-writer", "dsh-novel-writer-mcp", "--root", "/你的小说库路径"]
     }
   }
 }

package/mcp/README.md

@@ -16,7 +16,10 @@ Claude Desktop、Cursor 等任何 MCP 客户端。
 ## 1. 快速开始
 
 ```bash
-# 直接以 stdio 服务器方式启动（书库根目录用 --root 指定）
+# 推荐：不用先安装，npx 直接拉起（-p 指定包名，bin 名为 dsh-novel-writer-mcp）
+npx -y -p dsh-novel-writer dsh-novel-writer-mcp --root /abs/path/to/novels-workspace
+
+# 或已装进项目后，直接用包内文件启动
 node /abs/path/to/dsh-novel-writer/mcp/server.mjs --root /abs/path/to/novels-workspace
 ```
 
@@ -42,23 +45,32 @@ printf '%s\n' \
 - macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
 - Linux：`~/.config/Claude/claude_desktop_config.json`
 
+```json
+{
+  "mcpServers": {
+    "dsh-novel-writer": {
+      "command": "npx",
+      "args": ["-y", "-p", "dsh-novel-writer", "dsh-novel-writer-mcp", "--root", "/绝对路径/novels-workspace"]
+    }
+  }
+}
+```
+
+也可以不用 npx，直接把 `command` 写成 `node`、`args` 指向包内文件（需先 `npm install dsh-novel-writer`）：
+
 ```json
 {
   "mcpServers": {
     "dsh-novel-writer": {
       "command": "node",
-      "args": [
-        "F:/doment/build/dsh-novel-writer-v4.0.0/mcp/server.mjs",
-        "--root",
-        "F:/doment/novels-workspace"
-      ]
+      "args": ["/绝对路径/node_modules/dsh-novel-writer/mcp/server.mjs", "--root", "/绝对路径/novels-workspace"]
     }
   }
 }
 ```
 
 `args` 里的路径必须是**绝对路径**；Windows 上可用正斜杠 `/`（无需转义），或用双反斜杠 `\\`。
-若 `node` 不在 PATH 中，把 `command` 写成 node 可执行文件的绝对路径（如 `"C:/Program Files/nodejs/node.exe"`）。
+若 `node` / `npx` 不在 PATH 中，把 `command` 写成可执行文件的绝对路径（如 `"C:/Program Files/nodejs/node.exe"`）。
 
 ### Cursor
 

package/package.json

@@ -1,7 +1,8 @@
 {
     "name": "dsh-novel-writer",
-    "version": "4.1.0",
-    "description": "小说写作助手插件（v4.1.0）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）；附 stdio MCP 服务器（Claude Desktop / Cursor 可用）。",
+    "version": "4.1.1",
+    "description": "小说写作助手插件（v4.1.1）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）；附 stdio MCP 服务器（Claude Desktop / Cursor 可用）。",
+    "mcpName": "io.github.siweina/dsh-novel-writer",
     "type": "module",
     "main": "lib/index.js",
     "exports": {
@@ -16,7 +17,8 @@
         "README.md",
         "README.en.md",
         "skills",
-        "mcp"
+        "mcp",
+        "server.json"
     ],
     "dsh": {
         "engines": {

package/server.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.siweina/dsh-novel-writer",
+  "title": "dsh-novel-writer — 网文写作体检",
+  "description": "Offline toolkit: 16 tools for Chinese web-novel style, plot-thread and continuity audits.",
+  "version": "4.1.1",
+  "repository": {
+    "url": "https://github.com/siweina/dsh-novel-writer",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/siweina/dsh-novel-writer#readme",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "dsh-novel-writer",
+      "version": "4.1.1",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}