@youcloud/mantis-mcp 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # 更新记录
 
+## [1.0.5] - 2026-10-19
+
+- 用户引用兼容无前导零的十进制编号字符串，统一为数字后指派、筛选与恢复；补充明确的格式错误提示，继续拒绝含糊类型和不安全整数。
+- 缺陷上下文补齐备注附件索引、所属备注与去重，避免顶层附件为空时遗漏分析材料。
+
 ## [1.0.4] - 2026-10-19
 
 - 修复 Windows 下操作账本目录同步失败导致所有写工具及操作核查不可用的问题；保留文件同步与替换失败的阻断行为，并清理失败的临时文件。

package/README.md

@@ -1,6 +1,6 @@
 # Mantis MCP
 
-内部研发团队使用的 MantisBT MCP 服务，通过 stdio 为 Coding Agent 提供缺陷查询、修复登记、附件上传和可恢复的工作流操作。
+内部研发团队使用的 MantisBT MCP 服务，通过 stdio 为 Coding Agent 提供缺陷创建、查询、分配、修复、关闭等全生命周期管理和可恢复操作。
 
 项目与问题反馈：[内部 GitLab](https://git.umlife.net/ai-tools/mantis-mcp/-/work_items)。npm 包：[@youcloud/mantis-mcp](https://www.npmjs.com/package/@youcloud/mantis-mcp)。
 

package/dist/services/issues.js

@@ -24,11 +24,18 @@ export class Issues {
     }
 }
 export function visibleCollection(issue, key, emptyArraysOmitted) {
-    if (Array.isArray(issue[key]))
-        return issue[key];
-    if (!(key in issue) && emptyArraysOmitted && ['attachments', 'notes', 'relationships'].includes(key))
-        return [];
-    return undefined;
+    const items = Array.isArray(issue[key]) ? issue[key]
+        : !(key in issue) && emptyArraysOmitted && ['attachments', 'notes', 'relationships'].includes(key) ? [] : undefined;
+    if (key !== 'attachments' || !items)
+        return items;
+    // REST 将备注附件放在 notes[].attachments；只合并当前响应已可见的附件，不修改原始事实快照。
+    const attachments = new Map(items.map(item => [item.id, item]));
+    for (const note of Array.isArray(issue.notes) ? issue.notes : []) {
+        for (const attachment of Array.isArray(note.attachments) ? note.attachments : []) {
+            attachments.set(attachment.id, { ...attachments.get(attachment.id), ...attachment, note_id: note.id });
+        }
+    }
+    return [...attachments.values()];
 }
 export function facts(issue, baseUrl) {
     const keys = ['id', 'summary', 'project', 'category', 'priority', 'severity', 'status', 'resolution', 'version', 'fixed_in_version', 'target_version', 'updated_at'];

package/dist/workflow/context.js

@@ -168,9 +168,11 @@ export class Context {
                 let item;
                 if (section === 'notes')
                     item = { id: raw.id, reporter: minimalUser(raw.reporter), text: raw.text, view_state: raw.view_state,
+                        ...(Array.isArray(raw.attachments) && raw.attachments.length ? { attachment_ids: raw.attachments.map((a) => a.id) } : {}),
                         updated_at: raw.updated_at, view_url: `${session.baseUrl}/view.php?id=${issue.id}#bugnote${raw.id}` };
                 else if (section === 'attachments')
                     item = { id: raw.id, filename: raw.file_name ?? raw.filename, size: raw.size, content_type: raw.content_type,
+                        ...(raw.note_id !== undefined ? { note_id: raw.note_id } : {}),
                         download_url: `${session.baseUrl}/file_download.php?file_id=${raw.id}&type=bug`, view_url: output.issue.view_url };
                 else if (section === 'monitors')
                     item = minimalUser(raw);

package/dist/workflow/contracts.js

@@ -5,7 +5,13 @@ import { ConnectionConfigError } from '../connection-config.js';
 const systemErrorCodes = new Set([...getSystemErrorMap().values()].map(([name]) => name));
 export const id = z.number().int().positive().describe('正整数编号');
 export const text = z.string().refine(v => v.trim().length > 0, '不可为空白').describe('非空正文');
-const ref = z.union([z.literal('me'), id]).describe('当前用户 me 或明确的用户编号');
+const refError = '用户引用须为 "me"、正整数用户编号或其十进制字符串（无前导零，最大 9007199254740991）；用户名请先用 get_project_context 查询编号';
+// 仅兼容明确的十进制编号，避免数字强转把布尔值、数组或指数写法当成用户。
+const userId = z.number().int({ error: refError }).positive({ error: refError });
+const userIdString = z.string().regex(/^[1-9][0-9]*$/, refError)
+    .refine(value => Number.isSafeInteger(Number(value)), refError).transform(Number);
+const ref = z.union([z.literal('me'), userId, userIdString], { error: refError })
+    .describe('当前用户 "me"、正整数用户编号或无前导零的十进制编号字符串；不接受用户名');
 const iso = z.iso.datetime({ offset: true }).describe('含时区的 ISO8601 时间');
 const evidence = z.array(z.strictObject({ kind: z.enum(['url', 'text']), value: text }));
 const environment = { environment: text.optional(), version_id: id.optional() };

package/docs/cookbook.md

@@ -58,6 +58,8 @@
 
 ## 写入公共参数与生命周期
 
+用户引用 `assignee`（指派、受理、查询）和 `reporter`（查询）接受 `"me"`、正整数编号或无前导零的十进制编号字符串，例如 `5` 与 `"5"` 等价。编号不得超过 `9007199254740991`；不接受空白、布尔值、数组、指数写法或用户名。按姓名或登录名操作时，先用 `get_project_context` 的 `members` 区块和 `member_query` 确认用户编号，再传入引用。
+
 | 参数 | 规则 |
 |---|---|
 | `operation_id` | 每个新动作独立 UUID；真实写入必填，同次核查和恢复保持不变 |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@youcloud/mantis-mcp",
-  "version": "1.0.4",
-  "description": "面向研发工作流的 MantisBT MCP 服务，支持缺陷查询、修复登记、附件和可恢复操作",
+  "version": "1.0.5",
+  "description": "面向研发工作流的 MantisBT MCP 服务，支持缺陷创建、查询、分配、修复、关闭等全生命周期管理和可恢复操作",
   "license": "MIT",
   "homepage": "https://git.umlife.net/ai-tools/mantis-mcp",
   "bugs": {