yuque-ai-mcp 2.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (316) hide show
  1. package/dist/board/create-board.d.ts +7 -0
  2. package/dist/board/create-board.js +50 -0
  3. package/dist/board/create-board.js.map +1 -0
  4. package/dist/board/get-board.d.ts +7 -0
  5. package/dist/board/get-board.js +44 -0
  6. package/dist/board/get-board.js.map +1 -0
  7. package/dist/board/index.d.ts +5 -0
  8. package/dist/board/index.js +8 -0
  9. package/dist/board/index.js.map +1 -0
  10. package/dist/board/update-board.d.ts +7 -0
  11. package/dist/board/update-board.js +65 -0
  12. package/dist/board/update-board.js.map +1 -0
  13. package/dist/cli-http.d.ts +2 -0
  14. package/dist/cli-http.js +16 -0
  15. package/dist/cli-http.js.map +1 -0
  16. package/dist/cli.d.ts +2 -0
  17. package/dist/cli.js +15 -0
  18. package/dist/cli.js.map +1 -0
  19. package/dist/common/api-client.d.ts +27 -0
  20. package/dist/common/api-client.js +198 -0
  21. package/dist/common/api-client.js.map +1 -0
  22. package/dist/common/config.d.ts +46 -0
  23. package/dist/common/config.js +86 -0
  24. package/dist/common/config.js.map +1 -0
  25. package/dist/common/copy-common.d.ts +8 -0
  26. package/dist/common/copy-common.js +13 -0
  27. package/dist/common/copy-common.js.map +1 -0
  28. package/dist/common/errors.d.ts +44 -0
  29. package/dist/common/errors.js +164 -0
  30. package/dist/common/errors.js.map +1 -0
  31. package/dist/common/export-common.d.ts +32 -0
  32. package/dist/common/export-common.js +125 -0
  33. package/dist/common/export-common.js.map +1 -0
  34. package/dist/common/format.d.ts +247 -0
  35. package/dist/common/format.js +199 -0
  36. package/dist/common/format.js.map +1 -0
  37. package/dist/common/register-tools.d.ts +29 -0
  38. package/dist/common/register-tools.js +89 -0
  39. package/dist/common/register-tools.js.map +1 -0
  40. package/dist/common/repo-capacity.d.ts +26 -0
  41. package/dist/common/repo-capacity.js +105 -0
  42. package/dist/common/repo-capacity.js.map +1 -0
  43. package/dist/common/schedule-common.d.ts +38 -0
  44. package/dist/common/schedule-common.js +111 -0
  45. package/dist/common/schedule-common.js.map +1 -0
  46. package/dist/common/text-utils.d.ts +11 -0
  47. package/dist/common/text-utils.js +29 -0
  48. package/dist/common/text-utils.js.map +1 -0
  49. package/dist/common/toc-cache.d.ts +30 -0
  50. package/dist/common/toc-cache.js +109 -0
  51. package/dist/common/toc-cache.js.map +1 -0
  52. package/dist/common/types.d.ts +17 -0
  53. package/dist/common/types.js +3 -0
  54. package/dist/common/types.js.map +1 -0
  55. package/dist/common/validate.d.ts +27 -0
  56. package/dist/common/validate.js +70 -0
  57. package/dist/common/validate.js.map +1 -0
  58. package/dist/common/web-request.d.ts +13 -0
  59. package/dist/common/web-request.js +53 -0
  60. package/dist/common/web-request.js.map +1 -0
  61. package/dist/crawler/extract.d.ts +19 -0
  62. package/dist/crawler/extract.js +220 -0
  63. package/dist/crawler/extract.js.map +1 -0
  64. package/dist/crawler/fetch.d.ts +8 -0
  65. package/dist/crawler/fetch.js +89 -0
  66. package/dist/crawler/fetch.js.map +1 -0
  67. package/dist/crawler/index.d.ts +6 -0
  68. package/dist/crawler/index.js +10 -0
  69. package/dist/crawler/index.js.map +1 -0
  70. package/dist/crawler/save.d.ts +11 -0
  71. package/dist/crawler/save.js +160 -0
  72. package/dist/crawler/save.js.map +1 -0
  73. package/dist/crawler/schedule.d.ts +12 -0
  74. package/dist/crawler/schedule.js +132 -0
  75. package/dist/crawler/schedule.js.map +1 -0
  76. package/dist/doc/batch-get-docs.d.ts +8 -0
  77. package/dist/doc/batch-get-docs.js +100 -0
  78. package/dist/doc/batch-get-docs.js.map +1 -0
  79. package/dist/doc/copy-doc.d.ts +10 -0
  80. package/dist/doc/copy-doc.js +238 -0
  81. package/dist/doc/copy-doc.js.map +1 -0
  82. package/dist/doc/create-doc.d.ts +11 -0
  83. package/dist/doc/create-doc.js +82 -0
  84. package/dist/doc/create-doc.js.map +1 -0
  85. package/dist/doc/delete-doc.d.ts +8 -0
  86. package/dist/doc/delete-doc.js +39 -0
  87. package/dist/doc/delete-doc.js.map +1 -0
  88. package/dist/doc/diff-doc.d.ts +8 -0
  89. package/dist/doc/diff-doc.js +190 -0
  90. package/dist/doc/diff-doc.js.map +1 -0
  91. package/dist/doc/embed-url.d.ts +10 -0
  92. package/dist/doc/embed-url.js +137 -0
  93. package/dist/doc/embed-url.js.map +1 -0
  94. package/dist/doc/export-doc.d.ts +10 -0
  95. package/dist/doc/export-doc.js +135 -0
  96. package/dist/doc/export-doc.js.map +1 -0
  97. package/dist/doc/get-doc.d.ts +8 -0
  98. package/dist/doc/get-doc.js +40 -0
  99. package/dist/doc/get-doc.js.map +1 -0
  100. package/dist/doc/import-file-utils.d.ts +37 -0
  101. package/dist/doc/import-file-utils.js +256 -0
  102. package/dist/doc/import-file-utils.js.map +1 -0
  103. package/dist/doc/import-file.d.ts +13 -0
  104. package/dist/doc/import-file.js +333 -0
  105. package/dist/doc/import-file.js.map +1 -0
  106. package/dist/doc/import-url.d.ts +7 -0
  107. package/dist/doc/import-url.js +245 -0
  108. package/dist/doc/import-url.js.map +1 -0
  109. package/dist/doc/index.d.ts +16 -0
  110. package/dist/doc/index.js +30 -0
  111. package/dist/doc/index.js.map +1 -0
  112. package/dist/doc/list-docs.d.ts +8 -0
  113. package/dist/doc/list-docs.js +44 -0
  114. package/dist/doc/list-docs.js.map +1 -0
  115. package/dist/doc/update-doc.d.ts +8 -0
  116. package/dist/doc/update-doc.js +50 -0
  117. package/dist/doc/update-doc.js.map +1 -0
  118. package/dist/doc/version-detail.d.ts +8 -0
  119. package/dist/doc/version-detail.js +34 -0
  120. package/dist/doc/version-detail.js.map +1 -0
  121. package/dist/doc/versions.d.ts +8 -0
  122. package/dist/doc/versions.js +34 -0
  123. package/dist/doc/versions.js.map +1 -0
  124. package/dist/group/delete-user.d.ts +8 -0
  125. package/dist/group/delete-user.js +39 -0
  126. package/dist/group/delete-user.js.map +1 -0
  127. package/dist/group/index.d.ts +5 -0
  128. package/dist/group/index.js +8 -0
  129. package/dist/group/index.js.map +1 -0
  130. package/dist/group/list-users.d.ts +8 -0
  131. package/dist/group/list-users.js +40 -0
  132. package/dist/group/list-users.js.map +1 -0
  133. package/dist/group/update-user.d.ts +8 -0
  134. package/dist/group/update-user.js +37 -0
  135. package/dist/group/update-user.js.map +1 -0
  136. package/dist/http.d.ts +1 -0
  137. package/dist/http.js +114 -0
  138. package/dist/http.js.map +1 -0
  139. package/dist/index.d.ts +1 -0
  140. package/dist/index.js +27 -0
  141. package/dist/index.js.map +1 -0
  142. package/dist/kv/common.d.ts +34 -0
  143. package/dist/kv/common.js +191 -0
  144. package/dist/kv/common.js.map +1 -0
  145. package/dist/kv/delete.d.ts +7 -0
  146. package/dist/kv/delete.js +52 -0
  147. package/dist/kv/delete.js.map +1 -0
  148. package/dist/kv/get.d.ts +7 -0
  149. package/dist/kv/get.js +52 -0
  150. package/dist/kv/get.js.map +1 -0
  151. package/dist/kv/index.d.ts +6 -0
  152. package/dist/kv/index.js +10 -0
  153. package/dist/kv/index.js.map +1 -0
  154. package/dist/kv/list.d.ts +5 -0
  155. package/dist/kv/list.js +42 -0
  156. package/dist/kv/list.js.map +1 -0
  157. package/dist/kv/set.d.ts +7 -0
  158. package/dist/kv/set.js +54 -0
  159. package/dist/kv/set.js.map +1 -0
  160. package/dist/mine/common.d.ts +4 -0
  161. package/dist/mine/common.js +5 -0
  162. package/dist/mine/common.js.map +1 -0
  163. package/dist/mine/editor-center.d.ts +9 -0
  164. package/dist/mine/editor-center.js +57 -0
  165. package/dist/mine/editor-center.js.map +1 -0
  166. package/dist/mine/get-book-stacks.d.ts +8 -0
  167. package/dist/mine/get-book-stacks.js +41 -0
  168. package/dist/mine/get-book-stacks.js.map +1 -0
  169. package/dist/mine/index.d.ts +4 -0
  170. package/dist/mine/index.js +6 -0
  171. package/dist/mine/index.js.map +1 -0
  172. package/dist/note/create-note.d.ts +8 -0
  173. package/dist/note/create-note.js +32 -0
  174. package/dist/note/create-note.js.map +1 -0
  175. package/dist/note/get-note.d.ts +8 -0
  176. package/dist/note/get-note.js +27 -0
  177. package/dist/note/get-note.js.map +1 -0
  178. package/dist/note/index.d.ts +6 -0
  179. package/dist/note/index.js +10 -0
  180. package/dist/note/index.js.map +1 -0
  181. package/dist/note/list-notes.d.ts +8 -0
  182. package/dist/note/list-notes.js +40 -0
  183. package/dist/note/list-notes.js.map +1 -0
  184. package/dist/note/update-note.d.ts +8 -0
  185. package/dist/note/update-note.js +53 -0
  186. package/dist/note/update-note.js.map +1 -0
  187. package/dist/recycle/common.d.ts +4 -0
  188. package/dist/recycle/common.js +5 -0
  189. package/dist/recycle/common.js.map +1 -0
  190. package/dist/recycle/destroy-recycle.d.ts +8 -0
  191. package/dist/recycle/destroy-recycle.js +38 -0
  192. package/dist/recycle/destroy-recycle.js.map +1 -0
  193. package/dist/recycle/index.d.ts +5 -0
  194. package/dist/recycle/index.js +8 -0
  195. package/dist/recycle/index.js.map +1 -0
  196. package/dist/recycle/list-recycles.d.ts +8 -0
  197. package/dist/recycle/list-recycles.js +57 -0
  198. package/dist/recycle/list-recycles.js.map +1 -0
  199. package/dist/recycle/restore-recycle.d.ts +7 -0
  200. package/dist/recycle/restore-recycle.js +32 -0
  201. package/dist/recycle/restore-recycle.js.map +1 -0
  202. package/dist/repo/batch-get-repos.d.ts +8 -0
  203. package/dist/repo/batch-get-repos.js +83 -0
  204. package/dist/repo/batch-get-repos.js.map +1 -0
  205. package/dist/repo/copy-repo.d.ts +7 -0
  206. package/dist/repo/copy-repo.js +137 -0
  207. package/dist/repo/copy-repo.js.map +1 -0
  208. package/dist/repo/create-repo.d.ts +8 -0
  209. package/dist/repo/create-repo.js +49 -0
  210. package/dist/repo/create-repo.js.map +1 -0
  211. package/dist/repo/delete-repo.d.ts +8 -0
  212. package/dist/repo/delete-repo.js +37 -0
  213. package/dist/repo/delete-repo.js.map +1 -0
  214. package/dist/repo/export-graph.d.ts +21 -0
  215. package/dist/repo/export-graph.js +73 -0
  216. package/dist/repo/export-graph.js.map +1 -0
  217. package/dist/repo/export-index.d.ts +26 -0
  218. package/dist/repo/export-index.js +72 -0
  219. package/dist/repo/export-index.js.map +1 -0
  220. package/dist/repo/export-repo.d.ts +14 -0
  221. package/dist/repo/export-repo.js +243 -0
  222. package/dist/repo/export-repo.js.map +1 -0
  223. package/dist/repo/export-toc.d.ts +17 -0
  224. package/dist/repo/export-toc.js +33 -0
  225. package/dist/repo/export-toc.js.map +1 -0
  226. package/dist/repo/get-repo.d.ts +8 -0
  227. package/dist/repo/get-repo.js +32 -0
  228. package/dist/repo/get-repo.js.map +1 -0
  229. package/dist/repo/index.d.ts +10 -0
  230. package/dist/repo/index.js +18 -0
  231. package/dist/repo/index.js.map +1 -0
  232. package/dist/repo/list-repos.d.ts +8 -0
  233. package/dist/repo/list-repos.js +48 -0
  234. package/dist/repo/list-repos.js.map +1 -0
  235. package/dist/repo/update-repo.d.ts +8 -0
  236. package/dist/repo/update-repo.js +48 -0
  237. package/dist/repo/update-repo.js.map +1 -0
  238. package/dist/rss/dedup.d.ts +9 -0
  239. package/dist/rss/dedup.js +21 -0
  240. package/dist/rss/dedup.js.map +1 -0
  241. package/dist/rss/fetch-feed.d.ts +8 -0
  242. package/dist/rss/fetch-feed.js +290 -0
  243. package/dist/rss/fetch-feed.js.map +1 -0
  244. package/dist/rss/index.d.ts +5 -0
  245. package/dist/rss/index.js +8 -0
  246. package/dist/rss/index.js.map +1 -0
  247. package/dist/rss/list-sources.d.ts +8 -0
  248. package/dist/rss/list-sources.js +39 -0
  249. package/dist/rss/list-sources.js.map +1 -0
  250. package/dist/rss/parser.d.ts +27 -0
  251. package/dist/rss/parser.js +87 -0
  252. package/dist/rss/parser.js.map +1 -0
  253. package/dist/rss/schedule.d.ts +14 -0
  254. package/dist/rss/schedule.js +171 -0
  255. package/dist/rss/schedule.js.map +1 -0
  256. package/dist/rss/sources.d.ts +26 -0
  257. package/dist/rss/sources.js +54 -0
  258. package/dist/rss/sources.js.map +1 -0
  259. package/dist/search/index.d.ts +4 -0
  260. package/dist/search/index.js +6 -0
  261. package/dist/search/index.js.map +1 -0
  262. package/dist/search/rag-search-utils.d.ts +28 -0
  263. package/dist/search/rag-search-utils.js +74 -0
  264. package/dist/search/rag-search-utils.js.map +1 -0
  265. package/dist/search/rag-search.d.ts +16 -0
  266. package/dist/search/rag-search.js +103 -0
  267. package/dist/search/rag-search.js.map +1 -0
  268. package/dist/search/search.d.ts +8 -0
  269. package/dist/search/search.js +43 -0
  270. package/dist/search/search.js.map +1 -0
  271. package/dist/statistic/book-statistics.d.ts +7 -0
  272. package/dist/statistic/book-statistics.js +49 -0
  273. package/dist/statistic/book-statistics.js.map +1 -0
  274. package/dist/statistic/doc-statistics.d.ts +7 -0
  275. package/dist/statistic/doc-statistics.js +53 -0
  276. package/dist/statistic/doc-statistics.js.map +1 -0
  277. package/dist/statistic/group-statistics.d.ts +8 -0
  278. package/dist/statistic/group-statistics.js +30 -0
  279. package/dist/statistic/group-statistics.js.map +1 -0
  280. package/dist/statistic/index.d.ts +6 -0
  281. package/dist/statistic/index.js +10 -0
  282. package/dist/statistic/index.js.map +1 -0
  283. package/dist/statistic/member-statistics.d.ts +7 -0
  284. package/dist/statistic/member-statistics.js +49 -0
  285. package/dist/statistic/member-statistics.js.map +1 -0
  286. package/dist/toc/batch-update.d.ts +11 -0
  287. package/dist/toc/batch-update.js +274 -0
  288. package/dist/toc/batch-update.js.map +1 -0
  289. package/dist/toc/get-toc.d.ts +8 -0
  290. package/dist/toc/get-toc.js +33 -0
  291. package/dist/toc/get-toc.js.map +1 -0
  292. package/dist/toc/index.d.ts +5 -0
  293. package/dist/toc/index.js +8 -0
  294. package/dist/toc/index.js.map +1 -0
  295. package/dist/toc/update-toc.d.ts +8 -0
  296. package/dist/toc/update-toc.js +74 -0
  297. package/dist/toc/update-toc.js.map +1 -0
  298. package/dist/upload/index.d.ts +3 -0
  299. package/dist/upload/index.js +4 -0
  300. package/dist/upload/index.js.map +1 -0
  301. package/dist/upload/upload-attachment.d.ts +11 -0
  302. package/dist/upload/upload-attachment.js +162 -0
  303. package/dist/upload/upload-attachment.js.map +1 -0
  304. package/dist/user/get-groups.d.ts +8 -0
  305. package/dist/user/get-groups.js +41 -0
  306. package/dist/user/get-groups.js.map +1 -0
  307. package/dist/user/get-user.d.ts +8 -0
  308. package/dist/user/get-user.js +24 -0
  309. package/dist/user/get-user.js.map +1 -0
  310. package/dist/user/hello.d.ts +8 -0
  311. package/dist/user/hello.js +17 -0
  312. package/dist/user/hello.js.map +1 -0
  313. package/dist/user/index.d.ts +5 -0
  314. package/dist/user/index.js +8 -0
  315. package/dist/user/index.js.map +1 -0
  316. package/package.json +49 -0
@@ -0,0 +1,137 @@
1
+ /**
2
+ * repo/copy-repo — 批量跨知识库文档复制
3
+ *
4
+ * Agent 清洗内容后传入 documents 数组,工具串行建目录+创建文档
5
+ */
6
+ import { apiPost, apiPut, isErrorResult } from "../common/api-client.js";
7
+ import { requiredString } from "../common/validate.js";
8
+ import { ensureDirectoryPath } from "../common/toc-cache.js";
9
+ import { appendSourceLink } from "../common/copy-common.js";
10
+ /** 并发复制数:平衡速度与语雀 API 限流 */
11
+ const COPY_CONCURRENCY = 5;
12
+ export const repoCopy = {
13
+ name: "yuque_copy_repo",
14
+ description: "Batch copy documents to another repo. Agent provides cleaned documents array (title/body/format/paths). Tool creates TOC dirs and copies. 详见 references/api/extended_api.md",
15
+ inputSchema: {
16
+ type: "object",
17
+ properties: {
18
+ target_book_id: {
19
+ type: "string",
20
+ description: "Target repository ID or namespace (required)",
21
+ },
22
+ documents: {
23
+ type: "string",
24
+ description: "JSON array of {title, body, format, paths, source_url?, source_title?}. paths is array of 1-5 directory paths. (required)",
25
+ },
26
+ raw: {
27
+ type: "boolean",
28
+ description: "Return raw full JSON",
29
+ },
30
+ },
31
+ required: ["target_book_id", "documents"],
32
+ },
33
+ async handler(args) {
34
+ const __v = requiredString(args?.target_book_id, "target_book_id");
35
+ if (__v)
36
+ return __v;
37
+ const __v2 = requiredString(args?.documents, "documents");
38
+ if (__v2)
39
+ return __v2;
40
+ const targetBookId = args?.target_book_id;
41
+ const raw = args?.raw;
42
+ let documents;
43
+ try {
44
+ documents = JSON.parse(args?.documents);
45
+ if (!Array.isArray(documents) || documents.length === 0) {
46
+ return {
47
+ content: [{ type: "text", text: JSON.stringify({ error: "INVALID_DOCUMENTS", message: "documents 必须是非空 JSON 数组" }, null, 2) }],
48
+ isError: true,
49
+ };
50
+ }
51
+ }
52
+ catch {
53
+ return {
54
+ content: [{ type: "text", text: JSON.stringify({ error: "INVALID_DOCUMENTS", message: "documents 必须是有效的 JSON 数组" }, null, 2) }],
55
+ isError: true,
56
+ };
57
+ }
58
+ // 预处理:追尾源链接
59
+ const preparedDocs = documents.map((doc) => {
60
+ let body = doc.body || "";
61
+ if (doc.source_url) {
62
+ body = appendSourceLink(body, doc.source_url, doc.source_title || "原文档");
63
+ }
64
+ return {
65
+ title: doc.title || "无标题",
66
+ body,
67
+ format: doc.format || "markdown",
68
+ paths: (doc.paths || []).slice(0, 5),
69
+ };
70
+ });
71
+ let totalSuccess = 0;
72
+ let totalFailed = 0;
73
+ const details = [];
74
+ // 分批并发复制
75
+ for (let i = 0; i < preparedDocs.length; i += COPY_CONCURRENCY) {
76
+ const batch = preparedDocs.slice(i, i + COPY_CONCURRENCY);
77
+ const batchResults = await Promise.all(batch.map(async (doc) => {
78
+ const { title, body, format, paths } = doc;
79
+ if (paths.length === 0) {
80
+ return { title, paths: [], results: [{ path: "", error: "paths 为空" }] };
81
+ }
82
+ // 同一文档的多个 paths 也并发
83
+ const pathResults = await Promise.all(paths.map(async (path) => {
84
+ try {
85
+ const dirUuid = await ensureDirectoryPath(targetBookId, path);
86
+ if (!dirUuid) {
87
+ return { path, error: "目录创建失败" };
88
+ }
89
+ const payload = { title, body, format };
90
+ const data = await apiPost(`/repos/${targetBookId}/docs`, payload, `Copy doc to ${path}`);
91
+ if (isErrorResult(data)) {
92
+ const errMsg = data.content?.[0]?.text || "Unknown error";
93
+ return { path, error: errMsg };
94
+ }
95
+ const newDoc = data.data;
96
+ if (!newDoc?.id) {
97
+ return { path, error: "文档创建返回无 ID" };
98
+ }
99
+ await apiPut(`/repos/${targetBookId}/toc`, {
100
+ action: "appendNode",
101
+ action_mode: "child",
102
+ type: "DOC",
103
+ doc_ids: [newDoc.id],
104
+ target_uuid: dirUuid,
105
+ }, `Append doc to TOC: ${path}`);
106
+ return { path, doc_id: newDoc.id, slug: newDoc.slug };
107
+ }
108
+ catch (err) {
109
+ return { path, error: err instanceof Error ? err.message : String(err) };
110
+ }
111
+ }));
112
+ return { title, paths, results: pathResults };
113
+ }));
114
+ for (const r of batchResults) {
115
+ for (const pr of r.results) {
116
+ if (pr.error)
117
+ totalFailed++;
118
+ else
119
+ totalSuccess++;
120
+ }
121
+ details.push(r);
122
+ }
123
+ batchResults.length = 0; // 释放引用
124
+ }
125
+ const summary = {
126
+ target_book_id: targetBookId,
127
+ total_docs: documents.length,
128
+ total_copies: totalSuccess,
129
+ total_failed: totalFailed,
130
+ details,
131
+ };
132
+ return {
133
+ content: [{ type: "text", text: JSON.stringify(summary, null, 2) }],
134
+ };
135
+ },
136
+ };
137
+ //# sourceMappingURL=copy-repo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"copy-repo.js","sourceRoot":"","sources":["../../src/repo/copy-repo.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * repo/create — 创建知识库
3
+ *
4
+ * 端点:POST /api/v2/users/:login/repos 或 POST /api/v2/groups/:login/repos
5
+ * 职责:在用户或团队下创建新知识库,自动切换 user/group 端点
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const repoCreate: McpTool;
@@ -0,0 +1,49 @@
1
+ /**
2
+ * repo/create — 创建知识库
3
+ *
4
+ * 端点:POST /api/v2/users/:login/repos 或 POST /api/v2/groups/:login/repos
5
+ * 职责:在用户或团队下创建新知识库,自动切换 user/group 端点
6
+ */
7
+ import { apiPostWithFallback } from "../common/api-client.js";
8
+ import { check, requiredString } from "../common/validate.js";
9
+ import { formatRepo, handleApiCall } from "../common/format.js";
10
+ import { autoSlug } from "../common/config.js";
11
+ export const repoCreate = {
12
+ name: "yuque_create_repo",
13
+ description: "Create a repo, auto-detects user vs group endpoint. POST /users|groups/:login/repos. 详见 references/api/repo_api.md",
14
+ inputSchema: {
15
+ type: "object",
16
+ properties: {
17
+ login: { type: "string", description: "User or group login / ID (required)" },
18
+ name: { type: "string", description: "Repository name (required)" },
19
+ slug: { type: "string", description: "Repository slug. Rule: English translation of name, kebab-case, append timestamp. Auto-generated if omitted." },
20
+ description: { type: "string", description: "Description" },
21
+ public: { type: "number", description: "Visibility: 0=private, 1=public, 2=team-public (default 0)" },
22
+ enhancedPrivacy: { type: "boolean", description: "Enhanced privacy: non-admin members get no access by default" },
23
+ raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
24
+ },
25
+ required: ["login", "name"],
26
+ },
27
+ async handler(args) {
28
+ // @validate
29
+ const __v = check(requiredString(args?.login, "login"), requiredString(args?.name, "name"));
30
+ if (__v)
31
+ return __v;
32
+ const raw = args?.raw;
33
+ const login = args?.login;
34
+ const name = args?.name;
35
+ const slug = args?.slug;
36
+ const description = args?.description;
37
+ const isPublic = args?.public ?? 0;
38
+ const enhancedPrivacy = args?.enhancedPrivacy;
39
+ const payload = { name, public: isPublic };
40
+ payload.slug = slug || autoSlug(name);
41
+ if (description)
42
+ payload.description = description;
43
+ if (enhancedPrivacy !== undefined)
44
+ payload.enhancedPrivacy = enhancedPrivacy;
45
+ const data = await apiPostWithFallback(`/users/${login}/repos`, `/groups/${login}/repos`, payload, "Create repo");
46
+ return handleApiCall(data, formatRepo, raw);
47
+ },
48
+ };
49
+ //# sourceMappingURL=create-repo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-repo.js","sourceRoot":"","sources":["../../src/repo/create-repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,oHAAoH;IAEjI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACnE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8GAA8G,EAAE;YACrJ,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;YACrG,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;YACjH,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;KAC5B;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,KAAK,CACf,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EACpC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CACnC,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,WAAW,GAAG,IAAI,EAAE,WAAiC,CAAC;QAC5D,MAAM,QAAQ,GAAI,IAAI,EAAE,MAAiB,IAAI,CAAC,CAAC;QAC/C,MAAM,eAAe,GAAG,IAAI,EAAE,eAAsC,CAAC;QAErE,MAAM,OAAO,GAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACpE,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,WAAW;YAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QACnD,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC;QAE7E,MAAM,IAAI,GAAG,MAAM,mBAAmB,CACpC,UAAU,KAAK,QAAQ,EACvB,WAAW,KAAK,QAAQ,EACxB,OAAO,EACP,aAAa,CACd,CAAC;QACF,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * repo/delete — 删除知识库
3
+ *
4
+ * 端点:DELETE /api/v2/repos/:book_id
5
+ * 职责:删除指定知识库(不可恢复)
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const repoDelete: McpTool;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * repo/delete — 删除知识库
3
+ *
4
+ * 端点:DELETE /api/v2/repos/:book_id
5
+ * 职责:删除指定知识库(不可恢复)
6
+ */
7
+ import { confirmationParam, checkConfirmation } from "../common/errors.js";
8
+ import { requiredString } from "../common/validate.js";
9
+ import { apiDelete } from "../common/api-client.js";
10
+ import { formatRepo, handleApiCall } from "../common/format.js";
11
+ export const repoDelete = {
12
+ name: "yuque_delete_repo",
13
+ description: "Delete a repo (⚠️ irreversible). Requires confirm='DELETE'. DELETE /repos/:id. 详见 references/api/repo_api.md",
14
+ inputSchema: {
15
+ type: "object",
16
+ properties: {
17
+ book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
18
+ confirm: confirmationParam.confirm,
19
+ raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
20
+ },
21
+ required: ["book_id", "confirm"],
22
+ },
23
+ async handler(args) {
24
+ // @validate
25
+ const __v = requiredString(args?.book_id, "book_id");
26
+ if (__v)
27
+ return __v;
28
+ const confirmed = checkConfirmation(args);
29
+ if (confirmed)
30
+ return confirmed;
31
+ const raw = args?.raw;
32
+ const bookId = args?.book_id;
33
+ const data = await apiDelete(`/repos/${bookId}`, "Delete repo");
34
+ return handleApiCall(data, formatRepo, raw);
35
+ },
36
+ };
37
+ //# sourceMappingURL=delete-repo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete-repo.js","sourceRoot":"","sources":["../../src/repo/delete-repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,8GAA8G;IAE3H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAChH,OAAO,EAAE,iBAAiB,CAAC,OAAO;YAClC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;KACjC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QAEvC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC;QAChE,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * repo/export-graph — GRAPH.md 引用关系图生成
3
+ */
4
+ interface ExportResult {
5
+ doc_id: number;
6
+ slug: string;
7
+ title: string;
8
+ status: "ok" | "error";
9
+ file: string;
10
+ dir: string;
11
+ images_downloaded: number;
12
+ images_failed: number;
13
+ error?: string;
14
+ outboundLinks?: string[];
15
+ }
16
+ export declare function buildGraphMd(results: ExportResult[]): string;
17
+ /**
18
+ * 提取 Markdown 中的语雀文档链接
19
+ */
20
+ export declare function extractYuqueLinks(markdown: string): string[];
21
+ export {};
@@ -0,0 +1,73 @@
1
+ /**
2
+ * repo/export-graph — GRAPH.md 引用关系图生成
3
+ */
4
+ import { sanitizeFilename } from "../common/export-common.js";
5
+ export function buildGraphMd(results) {
6
+ const lines = [];
7
+ lines.push("# 文档引用关系图");
8
+ lines.push("");
9
+ lines.push(`> 生成时间:${new Date().toISOString()}`);
10
+ lines.push("");
11
+ const slugToTitle = new Map();
12
+ const slugToFile = new Map();
13
+ for (const r of results) {
14
+ if (r.status === "ok") {
15
+ slugToTitle.set(r.slug, r.title);
16
+ const filePath = (r.dir ? r.dir + "/" : "") + sanitizeFilename(r.title) + ".md";
17
+ slugToFile.set(r.slug, filePath);
18
+ }
19
+ }
20
+ let totalOutbound = 0;
21
+ let totalUnresolved = 0;
22
+ const okResults = results.filter(r => r.status === "ok");
23
+ if (okResults.length === 0) {
24
+ lines.push("(无成功导出的文档)");
25
+ return lines.join("\n");
26
+ }
27
+ lines.push("## 引用关系");
28
+ lines.push("");
29
+ for (const r of okResults) {
30
+ const links = r.outboundLinks || [];
31
+ if (links.length === 0)
32
+ continue;
33
+ totalOutbound += links.length;
34
+ const fromFile = (r.dir ? r.dir + "/" : "") + sanitizeFilename(r.title) + ".md";
35
+ for (const targetSlug of links) {
36
+ const targetTitle = slugToTitle.get(targetSlug);
37
+ const targetFile = slugToFile.get(targetSlug);
38
+ if (targetTitle) {
39
+ lines.push(`- [${r.title}](${fromFile}) → [${targetTitle}](${targetFile})`);
40
+ }
41
+ else {
42
+ totalUnresolved++;
43
+ lines.push(`- [${r.title}](${fromFile}) → \`${targetSlug}\` ⚠️ 未在本知识库中找到`);
44
+ }
45
+ }
46
+ }
47
+ if (totalOutbound === 0) {
48
+ lines.push("(未检测到文档间引用)");
49
+ }
50
+ lines.push("");
51
+ lines.push("## 统计");
52
+ lines.push("");
53
+ lines.push(`- 总引用数:${totalOutbound}`);
54
+ lines.push(`- 已解析:${totalOutbound - totalUnresolved}`);
55
+ lines.push(`- 未解析:${totalUnresolved}`);
56
+ lines.push(`- 有引用的文档:${okResults.filter(r => (r.outboundLinks || []).length > 0).length} / ${okResults.length}`);
57
+ return lines.join("\n");
58
+ }
59
+ /**
60
+ * 提取 Markdown 中的语雀文档链接
61
+ */
62
+ export function extractYuqueLinks(markdown) {
63
+ const links = [];
64
+ const regex = /https?:\/\/www\.yuque\.com\/[^/]+\/[^/]+\/([a-zA-Z0-9_-]+)/g;
65
+ let match;
66
+ while ((match = regex.exec(markdown)) !== null) {
67
+ if (!links.includes(match[1])) {
68
+ links.push(match[1]);
69
+ }
70
+ }
71
+ return links;
72
+ }
73
+ //# sourceMappingURL=export-graph.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-graph.js","sourceRoot":"","sources":["../../src/repo/export-graph.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * repo/export-index — INDEX.md 生成
3
+ */
4
+ interface TocNode {
5
+ uuid: string;
6
+ title: string;
7
+ parent_uuid: string;
8
+ child_uuid: string;
9
+ doc_id?: number;
10
+ type: string;
11
+ url: string;
12
+ }
13
+ interface ExportResult {
14
+ doc_id: number;
15
+ slug: string;
16
+ title: string;
17
+ status: "ok" | "error";
18
+ file: string;
19
+ dir: string;
20
+ images_downloaded: number;
21
+ images_failed: number;
22
+ error?: string;
23
+ outboundLinks?: string[];
24
+ }
25
+ export declare function buildIndexMd(tocNodes: TocNode[], results: ExportResult[], repoName: string): string;
26
+ export {};
@@ -0,0 +1,72 @@
1
+ /**
2
+ * repo/export-index — INDEX.md 生成
3
+ */
4
+ import { sanitizeFilename } from "../common/export-common.js";
5
+ export function buildIndexMd(tocNodes, results, repoName) {
6
+ const lines = [];
7
+ lines.push(`# ${repoName} — 导出索引`);
8
+ lines.push("");
9
+ lines.push(`> 导出时间:${new Date().toISOString()}`);
10
+ lines.push(`> 文档总数:${results.length}(成功 ${results.filter(r => r.status === "ok").length},失败 ${results.filter(r => r.status === "error").length})`);
11
+ lines.push("");
12
+ if (tocNodes.length > 0) {
13
+ lines.push("## 目录结构");
14
+ lines.push("");
15
+ lines.push(formatTocTree(tocNodes, results));
16
+ }
17
+ else {
18
+ lines.push("## 文档列表");
19
+ lines.push("");
20
+ lines.push("| 标题 | Slug | 状态 |");
21
+ lines.push("|------|------|------|");
22
+ for (const r of results) {
23
+ const status = r.status === "ok" ? "✅" : `❌ ${r.error || ""}`;
24
+ const file = r.status === "ok" ? `[${r.title}](${r.dir ? r.dir + "/" : ""}${sanitizeFilename(r.title)}.md)` : r.title;
25
+ lines.push(`| ${file} | ${r.slug} | ${status} |`);
26
+ }
27
+ }
28
+ return lines.join("\n");
29
+ }
30
+ function formatTocTree(nodes, results) {
31
+ const nodeByUuid = new Map();
32
+ for (const n of nodes) {
33
+ nodeByUuid.set(n.uuid, n);
34
+ }
35
+ const childrenByParent = new Map();
36
+ for (const n of nodes) {
37
+ const parentKey = n.parent_uuid || "__root__";
38
+ const arr = childrenByParent.get(parentKey) || [];
39
+ arr.push(n);
40
+ childrenByParent.set(parentKey, arr);
41
+ }
42
+ const rootChildren = childrenByParent.get("__root__") || [];
43
+ const lines = [];
44
+ function renderNode(node, depth) {
45
+ const indent = " ".repeat(depth);
46
+ if (node.type === "TITLE") {
47
+ lines.push(`${indent}- 📁 **${node.title}**`);
48
+ const children = childrenByParent.get(node.uuid) || [];
49
+ for (const child of children) {
50
+ renderNode(child, depth + 1);
51
+ }
52
+ }
53
+ else if (node.type === "DOC" && node.doc_id != null) {
54
+ const result = results.find(r => r.doc_id === node.doc_id);
55
+ if (result && result.status === "ok") {
56
+ const filePath = (result.dir ? result.dir + "/" : "") + sanitizeFilename(result.title) + ".md";
57
+ lines.push(`${indent}- 📄 [${result.title}](${filePath})`);
58
+ }
59
+ else {
60
+ lines.push(`${indent}- 📄 ${node.title} ${!result ? "(未找到)" : "(导出失败)"}`);
61
+ }
62
+ }
63
+ else {
64
+ lines.push(`${indent}- ${node.title}`);
65
+ }
66
+ }
67
+ for (const child of rootChildren) {
68
+ renderNode(child, 0);
69
+ }
70
+ return lines.join("\n");
71
+ }
72
+ //# sourceMappingURL=export-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-index.js","sourceRoot":"","sources":["../../src/repo/export-index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * doc/export-repo — 批量导出知识库全部文档为 Markdown
3
+ *
4
+ * 流程:
5
+ * 1. 获取 TOC 目录树 → 构建目录结构
6
+ * 2. 分页获取全部文档列表
7
+ * 3. 逐个获取文档详情(body + body_html)
8
+ * 4. 解析 body_html 中的图片/附件 → 尝试下载 → 成功替换为本地路径,失败保留原链接
9
+ * 5. 按 TOC 目录结构创建文件夹,文件以标题命名
10
+ * 6. 生成 INDEX.md(目录树 + 文档列表)+ GRAPH.md(文档间引用关系)
11
+ * 7. 输出导出报告
12
+ */
13
+ import type { McpTool } from "../common/types.js";
14
+ export declare const repoExport: McpTool;