| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394 |
- <!doctype html>
- <html lang="en">
- <head>
- <title>Code coverage report for services/llm/book-tools.ts</title>
- <meta charset="utf-8" />
- <link rel="stylesheet" href="../../prettify.css" />
- <link rel="stylesheet" href="../../base.css" />
- <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
- <meta name="viewport" content="width=device-width, initial-scale=1" />
- <style type='text/css'>
- .coverage-summary .sorter {
- background-image: url(../../sort-arrow-sprite.png);
- }
- </style>
- </head>
-
- <body>
- <div class='wrapper'>
- <div class='pad1'>
- <h1><a href="../../index.html">All files</a> / <a href="index.html">services/llm</a> book-tools.ts</h1>
- <div class='clearfix'>
-
- <div class='fl pad1y space-right2'>
- <span class="strong">0% </span>
- <span class="quiet">Statements</span>
- <span class='fraction'>0/78</span>
- </div>
-
-
- <div class='fl pad1y space-right2'>
- <span class="strong">0% </span>
- <span class="quiet">Branches</span>
- <span class='fraction'>0/1</span>
- </div>
-
-
- <div class='fl pad1y space-right2'>
- <span class="strong">0% </span>
- <span class="quiet">Functions</span>
- <span class='fraction'>0/1</span>
- </div>
-
-
- <div class='fl pad1y space-right2'>
- <span class="strong">0% </span>
- <span class="quiet">Lines</span>
- <span class='fraction'>0/78</span>
- </div>
-
-
- </div>
- <p class="quiet">
- Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
- </p>
- <template id="filterTemplate">
- <div class="quiet">
- Filter:
- <input type="search" id="fileSearch">
- </div>
- </template>
- </div>
- <div class='status-line low'></div>
- <pre><table class="coverage">
- <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
- <a name='L2'></a><a href='#L2'>2</a>
- <a name='L3'></a><a href='#L3'>3</a>
- <a name='L4'></a><a href='#L4'>4</a>
- <a name='L5'></a><a href='#L5'>5</a>
- <a name='L6'></a><a href='#L6'>6</a>
- <a name='L7'></a><a href='#L7'>7</a>
- <a name='L8'></a><a href='#L8'>8</a>
- <a name='L9'></a><a href='#L9'>9</a>
- <a name='L10'></a><a href='#L10'>10</a>
- <a name='L11'></a><a href='#L11'>11</a>
- <a name='L12'></a><a href='#L12'>12</a>
- <a name='L13'></a><a href='#L13'>13</a>
- <a name='L14'></a><a href='#L14'>14</a>
- <a name='L15'></a><a href='#L15'>15</a>
- <a name='L16'></a><a href='#L16'>16</a>
- <a name='L17'></a><a href='#L17'>17</a>
- <a name='L18'></a><a href='#L18'>18</a>
- <a name='L19'></a><a href='#L19'>19</a>
- <a name='L20'></a><a href='#L20'>20</a>
- <a name='L21'></a><a href='#L21'>21</a>
- <a name='L22'></a><a href='#L22'>22</a>
- <a name='L23'></a><a href='#L23'>23</a>
- <a name='L24'></a><a href='#L24'>24</a>
- <a name='L25'></a><a href='#L25'>25</a>
- <a name='L26'></a><a href='#L26'>26</a>
- <a name='L27'></a><a href='#L27'>27</a>
- <a name='L28'></a><a href='#L28'>28</a>
- <a name='L29'></a><a href='#L29'>29</a>
- <a name='L30'></a><a href='#L30'>30</a>
- <a name='L31'></a><a href='#L31'>31</a>
- <a name='L32'></a><a href='#L32'>32</a>
- <a name='L33'></a><a href='#L33'>33</a>
- <a name='L34'></a><a href='#L34'>34</a>
- <a name='L35'></a><a href='#L35'>35</a>
- <a name='L36'></a><a href='#L36'>36</a>
- <a name='L37'></a><a href='#L37'>37</a>
- <a name='L38'></a><a href='#L38'>38</a>
- <a name='L39'></a><a href='#L39'>39</a>
- <a name='L40'></a><a href='#L40'>40</a>
- <a name='L41'></a><a href='#L41'>41</a>
- <a name='L42'></a><a href='#L42'>42</a>
- <a name='L43'></a><a href='#L43'>43</a>
- <a name='L44'></a><a href='#L44'>44</a>
- <a name='L45'></a><a href='#L45'>45</a>
- <a name='L46'></a><a href='#L46'>46</a>
- <a name='L47'></a><a href='#L47'>47</a>
- <a name='L48'></a><a href='#L48'>48</a>
- <a name='L49'></a><a href='#L49'>49</a>
- <a name='L50'></a><a href='#L50'>50</a>
- <a name='L51'></a><a href='#L51'>51</a>
- <a name='L52'></a><a href='#L52'>52</a>
- <a name='L53'></a><a href='#L53'>53</a>
- <a name='L54'></a><a href='#L54'>54</a>
- <a name='L55'></a><a href='#L55'>55</a>
- <a name='L56'></a><a href='#L56'>56</a>
- <a name='L57'></a><a href='#L57'>57</a>
- <a name='L58'></a><a href='#L58'>58</a>
- <a name='L59'></a><a href='#L59'>59</a>
- <a name='L60'></a><a href='#L60'>60</a>
- <a name='L61'></a><a href='#L61'>61</a>
- <a name='L62'></a><a href='#L62'>62</a>
- <a name='L63'></a><a href='#L63'>63</a>
- <a name='L64'></a><a href='#L64'>64</a>
- <a name='L65'></a><a href='#L65'>65</a>
- <a name='L66'></a><a href='#L66'>66</a>
- <a name='L67'></a><a href='#L67'>67</a>
- <a name='L68'></a><a href='#L68'>68</a>
- <a name='L69'></a><a href='#L69'>69</a>
- <a name='L70'></a><a href='#L70'>70</a>
- <a name='L71'></a><a href='#L71'>71</a>
- <a name='L72'></a><a href='#L72'>72</a>
- <a name='L73'></a><a href='#L73'>73</a>
- <a name='L74'></a><a href='#L74'>74</a>
- <a name='L75'></a><a href='#L75'>75</a>
- <a name='L76'></a><a href='#L76'>76</a>
- <a name='L77'></a><a href='#L77'>77</a>
- <a name='L78'></a><a href='#L78'>78</a>
- <a name='L79'></a><a href='#L79'>79</a>
- <a name='L80'></a><a href='#L80'>80</a>
- <a name='L81'></a><a href='#L81'>81</a>
- <a name='L82'></a><a href='#L82'>82</a>
- <a name='L83'></a><a href='#L83'>83</a>
- <a name='L84'></a><a href='#L84'>84</a>
- <a name='L85'></a><a href='#L85'>85</a>
- <a name='L86'></a><a href='#L86'>86</a>
- <a name='L87'></a><a href='#L87'>87</a>
- <a name='L88'></a><a href='#L88'>88</a>
- <a name='L89'></a><a href='#L89'>89</a>
- <a name='L90'></a><a href='#L90'>90</a>
- <a name='L91'></a><a href='#L91'>91</a>
- <a name='L92'></a><a href='#L92'>92</a>
- <a name='L93'></a><a href='#L93'>93</a>
- <a name='L94'></a><a href='#L94'>94</a>
- <a name='L95'></a><a href='#L95'>95</a>
- <a name='L96'></a><a href='#L96'>96</a>
- <a name='L97'></a><a href='#L97'>97</a>
- <a name='L98'></a><a href='#L98'>98</a>
- <a name='L99'></a><a href='#L99'>99</a>
- <a name='L100'></a><a href='#L100'>100</a>
- <a name='L101'></a><a href='#L101'>101</a>
- <a name='L102'></a><a href='#L102'>102</a>
- <a name='L103'></a><a href='#L103'>103</a>
- <a name='L104'></a><a href='#L104'>104</a></td><td class="line-coverage quiet"><span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-neutral"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-no"> </span>
- <span class="cline-any cline-neutral"> </span></td><td class="text"><pre class="prettyprint lang-js"><span class="cstat-no" title="statement not covered" >/**<span class="fstat-no" title="function not covered" ><span class="branch-0 cbranch-no" title="branch not covered" ></span></span></span>
- * 书籍生成工具集 - Tool Calling 模式
- *
- * 借鉴 OpenMAIC pblTools 做法:
- * - 用 Zod 定义输入 Schema,确保类型安全
- * - execute 函数执行实际逻辑
- * - LLM 可在生成过程中主动调用,获取上下文
- */
-
- import { z } from 'zod';
- import { ToolDefinition } from './index';
-
- // ============ 工具定义 ============
-
- /**
- * 创建书籍生成工具集
- * 使用工厂模式,绑定到具体书籍 ID 和 bookStore
- */
- <span class="cstat-no" title="statement not covered" >export function createBookTools(bookId: string, bookStore: any): ToolDefinition[] {</span>
- <span class="cstat-no" title="statement not covered" > return [</span>
- // 工具1:获取已生成章节的摘要,避免内容重复
- <span class="cstat-no" title="statement not covered" > {</span>
- <span class="cstat-no" title="statement not covered" > name: 'get_existing_chapters',</span>
- <span class="cstat-no" title="statement not covered" > description:</span>
- <span class="cstat-no" title="statement not covered" > '获取书籍中已经生成的章节内容摘要(前500字),用于了解已有内容,避免重复,保持风格一致。返回章节列表,每项包含章节号、标题、内容摘要。',</span>
- <span class="cstat-no" title="statement not covered" > inputSchema: z.object({</span>
- <span class="cstat-no" title="statement not covered" > chapter_numbers: z</span>
- <span class="cstat-no" title="statement not covered" > .array(z.number())</span>
- <span class="cstat-no" title="statement not covered" > .optional()</span>
- <span class="cstat-no" title="statement not covered" > .describe('要查询的章节号列表,不传则返回所有已完成章节'),</span>
- <span class="cstat-no" title="statement not covered" > }),</span>
- <span class="cstat-no" title="statement not covered" > execute: async ({ chapter_numbers }: { chapter_numbers?: number[] }) => {</span>
- <span class="cstat-no" title="statement not covered" > const book = await bookStore.getById(bookId);</span>
- <span class="cstat-no" title="statement not covered" > if (!book) return { error: '书籍不存在', chapters: [] };</span>
-
- <span class="cstat-no" title="statement not covered" > const chapters = (book.chapters || []).filter((c: any) => {</span>
- <span class="cstat-no" title="statement not covered" > const hasContent = c.content && c.content.length > 0;</span>
- <span class="cstat-no" title="statement not covered" > const inRange = !chapter_numbers || chapter_numbers.includes(c.number);</span>
- <span class="cstat-no" title="statement not covered" > return hasContent && inRange;</span>
- <span class="cstat-no" title="statement not covered" > });</span>
-
- <span class="cstat-no" title="statement not covered" > return {</span>
- <span class="cstat-no" title="statement not covered" > count: chapters.length,</span>
- <span class="cstat-no" title="statement not covered" > chapters: chapters.map((c: any) => ({</span>
- <span class="cstat-no" title="statement not covered" > number: c.number,</span>
- <span class="cstat-no" title="statement not covered" > title: c.title,</span>
- <span class="cstat-no" title="statement not covered" > summary: c.content ? c.content.slice(0, 500) + (c.content.length > 500 ? '...' : '') : '',</span>
- <span class="cstat-no" title="statement not covered" > wordCount: c.wordCount || 0,</span>
- <span class="cstat-no" title="statement not covered" > })),</span>
- <span class="cstat-no" title="statement not covered" > };</span>
- <span class="cstat-no" title="statement not covered" > },</span>
- <span class="cstat-no" title="statement not covered" > },</span>
-
- // 工具2:获取书籍大纲,了解整体结构
- <span class="cstat-no" title="statement not covered" > {</span>
- <span class="cstat-no" title="statement not covered" > name: 'get_book_outline',</span>
- <span class="cstat-no" title="statement not covered" > description:</span>
- <span class="cstat-no" title="statement not covered" > '获取书籍完整大纲,包括主题、结构逻辑和所有章节规划。用于了解当前章节在全书中的位置和与其他章节的关系。',</span>
- <span class="cstat-no" title="statement not covered" > inputSchema: z.object({}),</span>
- <span class="cstat-no" title="statement not covered" > execute: async () => {</span>
- <span class="cstat-no" title="statement not covered" > const book = await bookStore.getById(bookId);</span>
- <span class="cstat-no" title="statement not covered" > if (!book?.outline) return { error: '大纲不存在' };</span>
-
- <span class="cstat-no" title="statement not covered" > return {</span>
- <span class="cstat-no" title="statement not covered" > mainTheme: book.outline.mainTheme,</span>
- <span class="cstat-no" title="statement not covered" > structureLogic: book.outline.structureLogic,</span>
- <span class="cstat-no" title="statement not covered" > totalChapters: book.outline.chapters.length,</span>
- <span class="cstat-no" title="statement not covered" > chapters: book.outline.chapters.map((c: any) => ({</span>
- <span class="cstat-no" title="statement not covered" > number: c.number,</span>
- <span class="cstat-no" title="statement not covered" > title: c.title,</span>
- <span class="cstat-no" title="statement not covered" > summary: c.summary,</span>
- <span class="cstat-no" title="statement not covered" > keyPoints: c.keyPoints,</span>
- <span class="cstat-no" title="statement not covered" > estimatedWords: c.estimatedWords,</span>
- <span class="cstat-no" title="statement not covered" > })),</span>
- <span class="cstat-no" title="statement not covered" > };</span>
- <span class="cstat-no" title="statement not covered" > },</span>
- <span class="cstat-no" title="statement not covered" > },</span>
-
- // 工具3:标记章节需要调整(LLM 发现问题时主动报告)
- <span class="cstat-no" title="statement not covered" > {</span>
- <span class="cstat-no" title="statement not covered" > name: 'report_chapter_issue',</span>
- <span class="cstat-no" title="statement not covered" > description:</span>
- <span class="cstat-no" title="statement not covered" > '当发现当前章节内容与已有章节重复、结构不合理或内容缺失时,用此工具记录问题说明。返回确认消息后继续生成改进版本。',</span>
- <span class="cstat-no" title="statement not covered" > inputSchema: z.object({</span>
- <span class="cstat-no" title="statement not covered" > chapter_number: z.number().describe('问题章节号'),</span>
- <span class="cstat-no" title="statement not covered" > issue_type: z</span>
- <span class="cstat-no" title="statement not covered" > .enum(['content_overlap', 'structure_issue', 'missing_content', 'style_inconsistency'])</span>
- <span class="cstat-no" title="statement not covered" > .describe('问题类型'),</span>
- <span class="cstat-no" title="statement not covered" > description: z.string().describe('问题描述'),</span>
- <span class="cstat-no" title="statement not covered" > suggestion: z.string().describe('改进建议'),</span>
- <span class="cstat-no" title="statement not covered" > }),</span>
- <span class="cstat-no" title="statement not covered" > execute: async ({ chapter_number, issue_type, description, suggestion }: any) => {</span>
- <span class="cstat-no" title="statement not covered" > console.log(</span>
- <span class="cstat-no" title="statement not covered" > `[BookTools] 章节 ${chapter_number} 发现问题: [${issue_type}] ${description},建议: ${suggestion}`</span>
- <span class="cstat-no" title="statement not covered" > );</span>
- <span class="cstat-no" title="statement not covered" > return {</span>
- <span class="cstat-no" title="statement not covered" > acknowledged: true,</span>
- <span class="cstat-no" title="statement not covered" > message: `已记录问题,请根据建议"${suggestion}"重新生成第${chapter_number}章内容。`,</span>
- <span class="cstat-no" title="statement not covered" > };</span>
- <span class="cstat-no" title="statement not covered" > },</span>
- <span class="cstat-no" title="statement not covered" > },</span>
- <span class="cstat-no" title="statement not covered" > ];</span>
- <span class="cstat-no" title="statement not covered" >}</span>
- </pre></td></tr></table></pre>
- <div class='push'></div><!-- for sticky footer -->
- </div><!-- /wrapper -->
- <div class='footer quiet pad2 space-top1 center small'>
- Code coverage generated by
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
- at 2026-05-19T14:27:48.313Z
- </div>
- <script src="../../prettify.js"></script>
- <script>
- window.onload = function () {
- prettyPrint();
- };
- </script>
- <script src="../../sorter.js"></script>
- <script src="../../block-navigation.js"></script>
- </body>
- </html>
-
|