dsh-book-deconstruct 0.0.0-stage → 1.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# dsh-book-deconstruct
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness **Host 插件**（不是 Agent 预设）：装进 profile 后会出现在插件列表，**任意会话**都可用：
+
+- 斜杠命令：`/book 书名 | 作者`
+- 工具：`book_deconstruct`（智能体在对话里调用）
+
+## 安装
+
+从 npm（推荐）：
+
+```sh
+dsh plugin --profile desktop add dsh-book-deconstruct
+```
+
+从本地目录（开发）：
+
+```sh
+dsh plugin --profile desktop add /path/to/book-deconstruct
+```
+
+从 GitHub（需公开仓库）：
+
+```sh
+dsh plugin --profile desktop add github:OWNER/dsh-book-deconstruct
+```
+
+装完后**完全退出并重新打开** DeepSeek Harness。
+
+## 用法
+
+任意预设下的会话均可：
+
+```text
+/book 思考，快与慢 | 丹尼尔·卡尼曼
+```
+
+也支持：
+
+```text
+/book 《思考，快与慢》丹尼尔·卡尼曼
+```
+
+或直接说：「帮我解读《思考，快与慢》，作者丹尼尔·卡尼曼」。
+
+输出只有两部分：把整本书讲透 + 最后一段有深度的思想。不编造不确定的事实、引文、页码。
+
+## 配置（可选）
+
+在 profile 的 `cordis.patch.yml` 按行 id `book-deconstruct` 覆盖：
+
+```yaml
+- id: book-deconstruct
+  name: dsh-book-deconstruct
+  config:
+    provider: ''   # 与 model 成对；空则用默认模型
+    model: ''
+    temperature: 0.5
+    maxTokens: 8000
+```
+
+## Topics（上架市场）
+
+公开 GitHub 仓库后请添加 Topics：`dsh-plugin`、`deepseek-harness`。也可在 [DSH Marketplace](https://dshmarketplace.dev/submit) 提交仓库。

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# 「书籍拆解」Host 插件：任意会话可用 /book 与 book_deconstruct。
+# 不再注册 Agent 预设；请在插件列表启用本包即可。
+- insert:
+    - id: book-deconstruct
+      name: dsh-book-deconstruct

package/icon.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Book deconstruct preset">
+  <rect x="8" y="10" width="40" height="44" rx="8" fill="#eef4ff" stroke="#2f6fed" stroke-width="3"/>
+  <path d="M28 15 V49" stroke="#8fb6f7" stroke-width="2.5" stroke-linecap="round"/>
+  <path d="M15 21 H23" stroke="#2f6fed" stroke-width="3" stroke-linecap="round"/>
+  <path d="M15 28 H23" stroke="#8fb6f7" stroke-width="3" stroke-linecap="round"/>
+  <path d="M15 35 H21" stroke="#8fb6f7" stroke-width="3" stroke-linecap="round"/>
+  <path d="M33 21 H41" stroke="#2f6fed" stroke-width="3" stroke-linecap="round"/>
+  <path d="M33 28 H41" stroke="#8fb6f7" stroke-width="3" stroke-linecap="round"/>
+  <path d="M46 36 L47.8 41.2 L53 43 L47.8 44.8 L46 50 L44.2 44.8 L39 43 L44.2 41.2 Z" fill="#f2b622" stroke="#d19a12" stroke-width="1.5" stroke-linejoin="round"/>
+</svg>

package/index.js

@@ -0,0 +1,393 @@
+/**
+ * book-deconstruct — 输入书名 + 作者，直接输出成品级书籍解读。
+ *
+ * 输出只保留两部分：
+ *   1. 这本书讲的是什么事（主体：详细讲清整本书的内容）
+ *   2. 一段深度的思想（最后只写一段，不列条目）
+ *
+ * 两个入口共用同一套解读逻辑（工具 execute）：
+ *   - `/book …` 斜杠命令：解析后 followup/steer 用户消息，让模型调用 book_deconstruct
+ *   - `book_deconstruct` 工具（智能体在对话中调用）
+ */
+
+import { randomUUID } from 'node:crypto';
+
+export const inject = ['llm', 'commands', 'tools'];
+
+const DEFAULT_TEMPERATURE = 0.5;
+const DEFAULT_MAX_TOKENS = 8000;
+
+const USAGE = [
+  '用法：/book 书名 | 作者',
+  '示例：/book 思考，快与慢 | 丹尼尔·卡尼曼',
+  '也支持：/book 《思考，快与慢》丹尼尔·卡尼曼',
+  '或：/book 帮我解读《思考，快与慢》，作者丹尼尔·卡尼曼',
+  '也可直接说：帮我解读《思考，快与慢》，作者丹尼尔·卡尼曼',
+].join('\n');
+
+// ---------------------------------------------------------------------------
+// 配置
+// ---------------------------------------------------------------------------
+
+function clampNumber(value, min, max, fallback) {
+  const n = typeof value === 'number' ? value : Number(value);
+  if (!Number.isFinite(n)) return fallback;
+  return Math.min(max, Math.max(min, n));
+}
+
+function clampInt(value, min, max, fallback) {
+  return Math.round(clampNumber(value, min, max, fallback));
+}
+
+function normalizeConfig(raw) {
+  const source = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+  let provider = typeof source.provider === 'string' ? source.provider.trim() : '';
+  let model = typeof source.model === 'string' ? source.model.trim() : '';
+  if ((provider === '') !== (model === '')) {
+    provider = '';
+    model = '';
+  }
+  return {
+    provider,
+    model,
+    temperature: clampNumber(source.temperature, 0, 2, DEFAULT_TEMPERATURE),
+    maxTokens: clampInt(source.maxTokens, 256, 32000, DEFAULT_MAX_TOKENS),
+  };
+}
+
+// ---------------------------------------------------------------------------
+// 输入解析
+// ---------------------------------------------------------------------------
+
+/** 去掉首尾空白、首尾书名号/引号，并压平换行。 */
+function cleanField(value, maxLength) {
+  if (typeof value !== 'string') return '';
+  const flat = value.replace(/\s+/g, ' ').trim();
+  const stripped = flat
+    .replace(/^[《「『"'“”]+/u, '')
+    .replace(/[》」』"'“”]+$/u, '')
+    .trim();
+  return stripped.slice(0, maxLength);
+}
+
+/** 去掉作者字段前的分隔符与「作者/by」前缀。 */
+function cleanAuthorTail(value) {
+  let author = String(value ?? '').trim();
+  author = author.replace(/^[\s|｜/—\-–—,，、:;：]+/u, '').trim();
+  author = author.replace(/^(?:作者(?:是)?|by)\s*[：:：]?\s*/iu, '').trim();
+  return author;
+}
+
+/**
+ * 解析「书名 + 作者」。支持：
+ *   《书名》作者 / 书名 | 作者 / 书名｜作者 / 书名 / 作者
+ *   自然语言：帮我解读《活着》，作者余华
+ * @returns {{ title: string, author: string } | null}
+ */
+export function parseBookInput(raw) {
+  let text = String(raw === null || raw === undefined ? '' : raw)
+    .replace(/\r\n?/gu, '\n')
+    .trim();
+  if (text === '') return null;
+
+  text = text.replace(/^\/book\b/i, '').trim();
+  if (text === '') return null;
+
+  const angle = text.match(/《([^》\n]{1,200})》(.*)$/su);
+  if (angle !== null) {
+    const title = angle[1].trim();
+    const author = cleanAuthorTail(angle[2]);
+    if (title !== '' && author !== '') return { title, author };
+  }
+
+  const named = text.match(
+    /(?:请?帮?我?)?(?:解读|拆解|总结|分析|讲讲|讲一下)?\s*[《「"']?([^》」"'\n|｜，,]{1,200}?)[》」"']?\s*[，,、]?\s*(?:作者(?:是)?|by)\s*[：:：]?\s*(.+)$/iu,
+  );
+  if (named !== null) {
+    const title = cleanField(named[1], 200);
+    const author = cleanAuthorTail(named[2]);
+    if (title !== '' && author !== '') return { title, author };
+  }
+
+  const pipe = text
+    .split(/[|｜]/u)
+    .map((part) => part.trim())
+    .filter((part) => part !== '');
+  if (pipe.length >= 2) {
+    const title = cleanField(pipe[0], 200);
+    const author = cleanAuthorTail(pipe.slice(1).join(' '));
+    if (title !== '' && author !== '') return { title, author };
+  }
+
+  const slash = text
+    .split(/\s*\/\s*/u)
+    .map((part) => part.trim())
+    .filter((part) => part !== '');
+  if (slash.length >= 2) {
+    const title = cleanField(slash[0], 200);
+    const author = cleanAuthorTail(slash.slice(1).join(' '));
+    if (title !== '' && author !== '') return { title, author };
+  }
+
+  const lines = text
+    .split('\n')
+    .map((line) => line.trim())
+    .filter((line) => line !== '');
+  if (lines.length >= 2) {
+    const title = cleanField(lines[0], 200);
+    const author = cleanAuthorTail(lines.slice(1).join(' '));
+    if (title !== '' && author !== '') return { title, author };
+  }
+
+  return null;
+}
+
+function buildSteerPrompt(parsed, raw) {
+  if (parsed !== null) {
+    return `请用 book_deconstruct 工具解读《${parsed.title}》，作者${parsed.author}`;
+  }
+  return `请用 book_deconstruct 工具处理用户的书籍解读请求：${raw}`;
+}
+
+/** 不依赖 @deepseek-ai/dsh-llm（本地 file: 插件 realpath 解析不到宿主包）。 */
+function makeUserMessage(text) {
+  return Object.freeze({
+    id: randomUUID(),
+    role: 'user',
+    content: Object.freeze([{ type: 'text', text }]),
+    source: Object.freeze({ kind: 'user' }),
+  });
+}
+
+function enqueueUserTurn(agent, message) {
+  if (agent !== null && agent !== undefined && typeof agent.followup === 'function') {
+    agent.followup(message);
+    return true;
+  }
+  if (agent !== null && agent !== undefined && typeof agent.steer === 'function') {
+    agent.steer(message);
+    return true;
+  }
+  return false;
+}
+
+// ---------------------------------------------------------------------------
+// 提示词：只产出成品，不产出过程
+// ---------------------------------------------------------------------------
+
+const SYSTEM_PROMPT = [
+  '你是一位有洞察力的书籍解读者。你的任务不是展示分析过程，而是直接交付高质量的成品：把一本书讲透，并在最后给出一段有深度的思想。',
+  '',
+  '铁律：',
+  '1. 只输出成品内容。不要写你的分析步骤、框架说明、知识边界声明、置信度清单、自我审校或任何元评论。',
+  '2. 不编造。对不确定的事实、引文、页码、章节、销量、奖项、时间线，不要写；宁可少写，也不要虚构。',
+  '3. 区分「书中明确观点」与「你的推论/评价」。属于你的推论时，用「由此可以推出」「这意味着」等措辞，不要冒充作者原话。',
+  '4. 不写目录复述，不写百科词条。要写出这本书的骨架和真正的洞见。',
+  '5. 用中文 Markdown，深度优先，语言干净利落，不堆砌空洞形容词。',
+  '6. 如果对书名或作者没有可靠信息，直接说明「我无法可靠地解读这本书」，不要编造内容。',
+].join('\n');
+
+function buildAnalysisPrompt(title, author) {
+  return `书名：《${title}》
+作者：${author}
+
+请直接输出成品，只写下面两部分，不要写任何分析过程或元信息。
+
+## 这本书讲的是什么事
+用 1000–1800 字，把整本书的内容讲透（这是主体部分）：
+- 这本书的核心主题，以及它在回答什么问题；
+- 全书的结构与推进方式：大致分几部分/几条主线，每部分主要讲了什么；
+- 关键概念、核心论点、重要方法或案例（用自己的话转述，不编造引文）；
+- 作者的基本立场与最终结论。
+要求：按书的内容实际展开，让人读完这一段就基本掌握这本书讲了什么；不要只写一句概括，也不要写成目录清单。
+
+## 一段深度的思想
+用 250–400 字写**一整段**（不要分条、不要小标题），从整本书里提炼一个最深的洞见或结论：
+- 它是什么；
+- 为什么成立（结合书中的内容）；
+- 对读者意味着什么。
+只写这一段，不要再列多条结论。
+
+要求：直接给结果，不要写「我如何分析」「我的知识边界」「置信度」这类内容。`;
+}
+
+// ---------------------------------------------------------------------------
+// LLM 调用（仅工具路径使用；斜杠命令改走 agent 回合）
+// ---------------------------------------------------------------------------
+
+function resolveRoute(ctx, config) {
+  if (config.provider !== '' && config.model !== '') {
+    return { provider: config.provider, model: config.model };
+  }
+  const defaultModel = ctx.get('agentDefaultModel');
+  const selection =
+    defaultModel !== undefined && typeof defaultModel.currentSelection === 'function'
+      ? defaultModel.currentSelection()
+      : undefined;
+  if (selection !== undefined && selection.provider && selection.model) {
+    return { provider: selection.provider, model: selection.model };
+  }
+  throw new Error('没有可用的模型：请在插件配置里设置 provider 和 model，或在设置里选择默认模型。');
+}
+
+async function generate(ctx, config, options) {
+  const route = resolveRoute(ctx, config);
+  const stream = ctx.llm.stream({
+    provider: route.provider,
+    model: route.model,
+    system: options.system,
+    messages: [{ role: 'user', content: [{ type: 'text', text: options.user }] }],
+    temperature: options.temperature,
+    maxTokens: options.maxTokens,
+    signal: options.signal,
+  });
+
+  let text = '';
+  let sawDelta = false;
+  const blockTexts = [];
+  let finish;
+
+  for await (const chunk of stream) {
+    if (chunk.type === 'text-delta') {
+      sawDelta = true;
+      text += chunk.text;
+    } else if (chunk.type === 'block-end') {
+      if (chunk.block !== null && typeof chunk.block === 'object' && chunk.block.type === 'text') {
+        blockTexts.push(chunk.block.text);
+      }
+    } else if (chunk.type === 'finish') {
+      finish = chunk.reason;
+    }
+  }
+
+  if (!sawDelta && blockTexts.length > 0) text = blockTexts.join('');
+
+  if (finish !== undefined && finish.kind === 'error') {
+    const message =
+      finish.failure !== undefined && finish.failure !== null && finish.failure.message
+        ? finish.failure.message
+        : '未知错误';
+    throw new Error('模型调用失败：' + message);
+  }
+  if (finish !== undefined && finish.kind === 'aborted') {
+    throw new Error('模型调用被取消');
+  }
+  return { text: text.trim(), finish };
+}
+
+async function deconstruct(ctx, config, rawTitle, rawAuthor, options = {}) {
+  const title = cleanField(rawTitle, 200);
+  const author = cleanField(rawAuthor, 200);
+  if (title === '') throw new Error('书名不能为空');
+  if (author === '') throw new Error('作者不能为空');
+
+  const result = await generate(ctx, config, {
+    system: SYSTEM_PROMPT,
+    user: buildAnalysisPrompt(title, author),
+    temperature: config.temperature,
+    maxTokens: config.maxTokens,
+    signal: options.signal,
+  });
+  if (result.text === '') throw new Error('模型没有返回内容，请稍后重试。');
+
+  let output = result.text;
+  if (result.finish !== undefined && result.finish.kind === 'max-tokens') {
+    output += '\n\n> （输出达到长度上限，可能有截断）';
+  }
+  return output;
+}
+
+// ---------------------------------------------------------------------------
+// 插件入口
+// ---------------------------------------------------------------------------
+
+export function apply(ctx, rawConfig) {
+  const config = normalizeConfig(rawConfig);
+  const disposers = [];
+
+  disposers.push(
+    ctx.commands.register({
+      // 挂 input.hint：从 / 菜单选 book 时保留输入框，继续填「书名 | 作者」。
+      // 也可整行输入 /book 书名 | 作者 后直接发送。
+      name: 'book',
+      description: '深度解读一本书。用法：/book 书名 | 作者',
+      input: { hint: '书名 | 作者' },
+      handler: async (invocation) => {
+        const raw = String(invocation.rawInput ?? '').trim();
+        if (raw === '') return { kind: 'error', text: USAGE };
+
+        const parsed = parseBookInput(raw);
+        if (parsed === null && !/作者|by|《.|》/u.test(raw) && !/[|｜]/u.test(raw)) {
+          return { kind: 'error', text: USAGE };
+        }
+
+        const prompt = buildSteerPrompt(parsed, raw);
+        const agent = invocation.agent;
+        const ok = enqueueUserTurn(agent, makeUserMessage(prompt));
+        if (ok) {
+          if (parsed !== null) {
+            return {
+              kind: 'success',
+              text: `已提交解读：《${parsed.title}》 / ${parsed.author}（将调用 book_deconstruct）`,
+            };
+          }
+          return { kind: 'success', text: '已提交书籍解读请求（将调用 book_deconstruct）' };
+        }
+
+        // followup/steer 不可用时，直接跑工具逻辑，保证斜杠有反馈
+        if (parsed === null) {
+          return { kind: 'error', text: USAGE };
+        }
+        try {
+          const text = await deconstruct(ctx, config, parsed.title, parsed.author, {
+            signal: invocation.signal,
+          });
+          return { kind: 'success', text };
+        } catch (error) {
+          const message = error !== null && error !== undefined && error.message ? error.message : String(error);
+          return { kind: 'error', text: '解读失败：' + message };
+        }
+      },
+    }),
+  );
+
+  disposers.push(
+    ctx.tools.register({
+      name: 'book_deconstruct',
+      description:
+        '深度解读一本书：输入书名与作者，先详细讲清整本书的内容，最后给出一段有深度的思想。当用户要求「解读/总结/拆解某本书」时使用。',
+      parameters: {
+        type: 'object',
+        properties: {
+          title: { type: 'string', description: '书名，例如《思考，快与慢》或“思考，快与慢”' },
+          author: { type: 'string', description: '作者，例如“丹尼尔·卡尼曼”' },
+        },
+        required: ['title', 'author'],
+        additionalProperties: false,
+      },
+      output: {
+        schema: { type: 'string' },
+        render(_args, value) {
+          return [{ type: 'text', text: String(value) }];
+        },
+      },
+      async execute(args, exec) {
+        const payload = args !== null && typeof args === 'object' ? args : {};
+        const title = cleanField(payload.title, 200);
+        const author = cleanField(payload.author, 200);
+        if (title === '' || author === '') throw new Error('title 和 author 必填');
+        return deconstruct(ctx, config, title, author, { signal: exec.signal });
+      },
+    }),
+  );
+
+  return () => {
+    for (const dispose of disposers.reverse()) {
+      try {
+        dispose();
+      } catch {
+        /* ignore disposer errors */
+      }
+    }
+  };
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Book Deconstruct",
+    "description": "Host plugin: /book and book_deconstruct in any session. Give a title and author for a full walkthrough plus one deep insight."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "书籍拆解",
+    "description": "Host 插件：任意会话可用 /book 与 book_deconstruct。输入书名与作者，把整本书讲透，最后给出一段有深度的思想。"
+  }
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-book-deconstruct",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.3",
+  "description": "DSH Host plugin: /book slash command + book_deconstruct tool for full book walkthroughs.",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "book",
+    "reading"
+  ],
+  "license": "MIT",
+  "author": "Kang",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "locale/en.json",
+    "locale/zh.json",
+    "icon.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "dsh": ">=0.2.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zmz123612/dsh-book-deconstruct.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zmz123612/dsh-book-deconstruct/issues"
+  },
+  "homepage": "https://github.com/zmz123612/dsh-book-deconstruct#readme"
+}