摘要

本文围绕标题所述主题，结合本仓库当前源码行进行说明。仅供技术理解与内部培训，不构成定密、法务或密码测评结论。文中代码块均摘自本地仓库对应路径与行号。

正文

0. 结论先行

结论先行：保密检查由内置助手触发大模型按模板输出审查意见，程序再从摘要中抽取命中片段并尝试挂批注。长文档依赖分块与结构化 JSON 提示。下文每节先说明要点，紧接着给出仓库中的对应源码片段。

本篇标题：保密检查在本项目中的总体链路：从按钮到任务清单

1. 助手标识与默认写回方式

保密检查对应内置助手 id 为 analysis.security-check。下列片段展示其在注册表中的默认动作与输入来源等字段，便于与界面行为对照。

// src/utils/assistantRegistry.js 第653-667行
  {
   
    id: 'analysis.security-check',
    label: '保密检查',
    shortLabel: '保密检查',
    group: 'analysis',
    modelType: 'chat',
    defaultModelCategory: 'chat',
    supportsRibbon: true,
    defaultDisplayLocations: ['ribbon-main'],
    allowedActions: ['comment', 'link-comment', 'insert', 'append', 'none'],
    defaultAction: 'link-comment',
    defaultOutputFormat: 'markdown',
    defaultInputSource: INPUT_SOURCE_DOCUMENT,
    description: '基于关键词和上下文检查文档中的涉密、涉军、单位名称、密级标识和敏感业务信息风险。',

2. 研判原则写入提示词模板

研判原则与风险级别枚举写在 userPromptTemplate 的长模板中，模型据此输出 Markdown 小节。下列片段为模板中研判原则与风险级别相关行。

// src/utils/assistantRegistry.js 第704-713行
研判原则：
1. 关键词命中不等于泄密，必须结合上下文判断，不要机械命中即报高风险
2. 对常见公开词、泛化称谓、新闻公开语境、教材示例语境，要谨慎降噪，避免误报
3. 仅依据原文内容作出审慎判断，不要臆测背景、来源、真实单位或法律结论
4. 对每项风险必须说明：命中片段、风险类别、风险级别、判断依据、建议处理方式
5. 风险级别统一使用：
   - 高风险：直接出现密级标识、具体部队/单位身份、具体部署计划、未公开内部编号、明确敏感联系人信息等
   - 中风险：出现敏感关键词且上下文指向内部事项，但是否涉密仍需人工确认
   - 低风险或待人工复核：存在可疑词或敏感线索，但公开性、敏感性、上下文不足，暂不能直接判定
6. 如果文本未发现明显保密风险，明确写“未发现明显保密风险”

3. Ribbon 按钮如何启动该助手

功能区按钮在 ribbon 的 OnAction 分支中调用 executeAssistantFromRibbon，并传入 taskTitle。

// src/components/ribbon.js 第3364-3370行
    // 脱密分组
    case 'btnDocumentDeclassifyCheck':
      executeAssistantFromRibbon('analysis.security-check', {
    taskTitle: '保密检查' }).catch((e) => {
   
        console.error('保密检查失败:', e)
        alert('保密检查失败: ' + (e?.message || e))
      })
      break

4. 任务运行器中的专项提示

对保密检查助手，任务运行器追加一条最佳实践说明，强调关键词命中须结合上下文分级。

// src/utils/assistantTaskRunner.js 第310-312行
  if (assistantId === 'analysis.security-check') {
   
    return '保密检查时，关键词命中必须结合上下文分级判断；避免武断下结论，并明确哪些内容需要人工复核。'
  }

5. 结构化批次系统提示骨架

长文档走结构化 JSON 批次时，buildStructuredBatchInstruction 拼接 schemaVersion、模式说明与 ChunkText 约束。

// src/utils/assistantStructuredPipeline.js 第90-104行
export function buildStructuredBatchInstruction(assistantId, options = {
   }) {
   
  const mode = getStructuredAssistantMode(assistantId)
  return [
    `你必须只输出一个合法 JSON 对象，schemaVersion 固定为 "${
     STRUCTURED_PIPELINE_SCHEMA_VERSION}"。`,
    '不要输出 Markdown，不要输出 JSON 之外的解释。',
    getModeSpecificInstruction(mode, options),
    getStructuredJsonAnchorExtraRules(assistantId, options.documentAction),
    '你将收到一个带 ChunkMeta / LineMap / ChunkText 的结构化原文块，所有定位都必须以 ChunkText 为唯一依据。',
    String(options.documentAction || '').trim() === 'replace'
      ? '当文档动作是 replace 时，只有在 originalText 可以从 ChunkText 中精确截取时才输出 replace；否则改为 comment。'
      : '',
    '统一 JSON 结构如下：',
    '{"schemaVersion":"","mode":"","summary":"","content":"","operations":[{"type":"replace|comment|insert-after|prepend|append|none","target":"absolute-range|chunk-relative-range|text-anchor|paragraph-range","start":0,"end":0,"originalText":"","replacementText":"","commentText":"","reason":"","suggestion":"","confidence":"high|medium|low","paragraphIndex":0,"prefix":"","suffix":"","sentence":""}]}',
    '若没有可执行操作，operations 返回 []；若没有正文结果，content 返回空字符串。'
  ].filter(Boolean).join('\n')

6. 从 Markdown 摘要抽取命中片段

程序不直接信任自由格式，而用 extractHitFragmentsFromSecurityCheckMarkdown 做多模式正则抽取，供后续批注锚点。

// src/utils/structuredCommentPolicy.js 第22-52行
export function extractHitFragmentsFromSecurityCheckMarkdown(markdown) {
   
  const text = String(markdown || '')
  const out = []
  const seen = new Set()
  const add = (raw) => {
   
    let t = String(raw || '').trim()
    t = t.replace(/^[`「'"“]+|[`」'"”]+$/g, '').replace(/\*\*/g, '').trim()
    if (t.length < 2 || seen.has(t)) return
    if (/^(无|暂无|未发现|没有|不适用)\s*$/u.test(t)) return
    seen.add(t)
    out.push(t)
  }
  let m
  // 模型常见变体：- **命中片段：** `原文`（加粗标签 + 中英文冒号 + 反引号）
  const reBacktickPatterns = [
    /\*\*命中片段[：:]\*\*\s*`([^`\n]+)`/g,
    /[-*]\s*\*\*命中片段[：:]\*\*\s*`([^`\n]+)`/g,
    /[-*]\s*\*{
   1,2}\s*命中片段\s*\*{
   1,2}\s*[：:]\s*`([^`\n]+)`/g,
    /命中片段\s*\*{0,2}\s*[：:]\s*\*{0,2}\s*`([^`\n]+)`/g
  ]
  for (const reBacktick of reBacktickPatterns) {
   
    while ((m = reBacktick.exec(text)) !== null) add(m[1])
  }
  const reLinePatterns = [
    /[-*]\s*\*\*命中片段[：:]\*\*\s*(?!`)([^\n]+)/g,
    /[-*]\s*命中片段[：:]\s*(?!`)([^\n]+)/g
  ]
  for (const reLine of reLinePatterns) {
   
    while ((m = reLine.exec(text)) !== null) add(m[1])
  }
  return out

7. 保密检查在结构化 JSON 下的额外锚点规则

getStructuredJsonAnchorExtraRules 为保密检查追加「命中片段须逐字来自 ChunkText」等说明，与批注类文档动作组合使用。

// src/utils/structuredCommentPolicy.js 第119-127行
export function getStructuredJsonAnchorExtraRules(assistantId, documentAction = '') {
   
  const id = String(assistantId || '').trim()
  const act = String(documentAction || '').trim()
  const parts = []
  if (id === ANALYSIS_SECURITY_CHECK_ID) {
   
    parts.push([
      '保密检查：须将完整审查结论写入 JSON 的 summary 字段；summary 内仍使用模板要求的 Markdown 小节（## 高风险项 等）。',
      '每条风险项必须包含「命中片段」且反引号内为 ChunkText 中的连续原文（逐字照抄）；推荐格式：- **命中片段：** `原文片段`（加粗与否均可，反引号内必须与正文一致）；operations 可留空 []。'
    ].join('\n'))

8. 与定密流程的边界

README 已说明检查结论仅为辅助参考。实现上判断来自大模型与提示词，不包含法定密级鉴定接口。组织对外处置仍须走正式流程。