dsh-plugin-t-expert 0.4.26 → 0.4.36

package/data/experts/security/fbsir-board-secretary-assistant/scene-pack.json

@@ -0,0 +1,228 @@
+{
+  "schemaVersion": "1.0",
+  "sceneId": "board_secretary_compliance_red_team",
+  "packageVersion": "2.1.0",
+  "packageType": "workbuddy_expert_center_scene_pack",
+  "distributionSurface": {
+    "target": "workbuddy_expert_center",
+    "targetMarketplace": "experts",
+    "targetDisplayNameZh": "董秘助手",
+    "localEquivalentTestSurface": "my-experts",
+    "localEquivalentTestOnly": true,
+    "localEquivalentPurposeZh": "仅用于当前工作区安装与入口配置，不代表最终上架路径。"
+  },
+  "hostTrack": "WORKBUDDY",
+  "pluginName": "fbsir-board-secretary-assistant",
+  "servicePackCode": "fbss.board_secretary.compliance_red_team.v1",
+  "scenePackId": "board-secretary-compliance-red-team",
+  "entryId": "board-secretary-compliance-red-team",
+  "expertEntryId": "fbsir-board-secretary-assistant",
+  "entryPromptCode": "wb_fbsir_board_secretary_compliance_red_team",
+  "intentFamily": "board_secretary_ir_workflow",
+  "profileSegment": "board_secretary",
+  "profileSegments": [
+    "board_secretary",
+    "securities_rep",
+    "ir_director",
+    "cfo_office"
+  ],
+  "assetType": "compliance-red-team-card",
+  "continuedUseAssetType": "compliance-red-team-followup-card",
+  "priorityScope": [
+    "P0",
+    "P1",
+    "P2"
+  ],
+  "singleCta": "生成合规红队卡",
+  "defaultRole": "董秘助手",
+  "supportedMaterials": [
+    "公告稿",
+    "路演问答",
+    "投资者沟通稿",
+    "IR问答",
+    "披露说明"
+  ],
+  "deliverables": [
+    "风险等级",
+    "命中依据",
+    "问题片段",
+    "补证要求",
+    "建议改写",
+    "审批下一步"
+  ],
+  "supportedMaterialsExtended": [
+    "announcement_draft",
+    "roadshow_qa",
+    "investor_communication_draft",
+    "ir_qa",
+    "disclosure_statement",
+    "investor_interaction_reply",
+    "research_minutes",
+    "public_opinion_response",
+    "three_meetings_materials",
+    "authorized_document_context"
+  ],
+  "connectorToolChain": [
+    "skill_whoami",
+    "fbs_scene_pack_query",
+    "skill_consume"
+  ],
+  "serviceDrivenOperations": {
+    "mainline": [
+      "skill_whoami",
+      "fbs_scene_pack_query",
+      "skill_consume"
+    ],
+    "intentionPolicy": "first value first; offer only after first_value_completed or explicit continued use",
+    "connectorPolicy": "no_connector_first_value_external_service_followthrough",
+    "optionalEnhancementOnly": true,
+    "schemaSafeWhoamiFields": [
+      "entryId",
+      "entryPromptCode",
+      "entrySurface",
+      "intentFamily",
+      "profileSegment",
+      "assetType",
+      "scenePackId",
+      "expertEntryId",
+      "requestSource"
+    ]
+  },
+  "noConnectorInteraction": {
+    "connectorRequired": false,
+    "packageUploadReadyWithoutConnector": true,
+    "localEquivalentReadyWithoutConnector": true,
+    "firstValueDoesNotRequireServiceTool": true,
+    "doNotAssumeHostRuntimeUpgrade": true,
+    "connectorPromptMustBeDeferredUntilPostFirstValue": true,
+    "fallbackToChatFirstValueWhenToolsUnavailable": true
+  },
+  "postFirstValueServiceObservation": {
+    "expectedExecutableTools": [
+      "skill_whoami",
+      "fbs_scene_pack_query",
+      "skill_consume"
+    ],
+    "fallbackWhenUnavailable": "complete_first_value_and_emit_host_action_envelope",
+    "packageCapabilityDependsOnConnector": false,
+    "optionalEnhancementOnly": true,
+    "packageMcpMetadataAllowed": false,
+    "connectorPromptAllowedFromPackageEntry": false
+  },
+  "firstValueCardContract": {
+    "contractPath": "contracts/first-value-contract.json",
+    "sourceDemandId": "BSA-PKG-001",
+    "requiredSections": [
+      "task_identification",
+      "material_gap_check",
+      "risk_boundary",
+      "human_review_role",
+      "single_next_action",
+      "stop_condition"
+    ],
+    "requiredFields": [
+      "taskIdentification",
+      "materialType",
+      "riskLevel",
+      "triggerTypes",
+      "evidenceMatched",
+      "problematicFragments",
+      "missingEvidence",
+      "rewriteSuggestion",
+      "humanReviewBoundary",
+      "approvalNextStep",
+      "singleNextAction",
+      "stopCondition",
+      "auditFields"
+    ]
+  },
+  "humanReviewBoundary": {
+    "contractPath": "contracts/governance-boundary.json",
+    "sourceDemandId": "BSA-PKG-002",
+    "manualReviewRequired": true,
+    "automaticLegalConclusionAllowed": false,
+    "automaticDisclosureDecisionAllowed": false,
+    "automaticPublishingAllowed": false
+  },
+  "serviceForwardFields": {
+    "contractPath": "contracts/service-forward-fields.json",
+    "sourceDemandId": "BSA-PKG-003",
+    "additionalDemandIds": [
+      "BSA-PKG-005"
+    ],
+    "status": "should_validate",
+    "hostRuntimeSupportClaimAllowed": false
+  },
+  "serviceTractionUpgrade": {
+    "contractPath": "contracts/service-traction-upgrade-contract.json",
+    "sourceDemandIds": [
+      "BSA-PKG-003",
+      "BSA-PKG-005"
+    ],
+    "priority": "current_highest_package_workstream",
+    "status": "source_window_landed_for_service_side_joint_debug",
+    "connectorRequired": false,
+    "productFlowMustNotReadConnectorState": true,
+    "visibleGapPolicy": "show_missing_fields_without_blocking_first_value",
+    "waiterLifecycleBoundary": "receipt_handoff_only_no_package_runtime_fix_claim"
+  },
+  "lebaoInformationGapFill": {
+    "contractPath": "contracts/service-forward-fields.json",
+    "sourceDemandId": "BSA-PKG-005",
+    "status": "should_validate",
+    "connectorRequired": false,
+    "mcpToolRequired": false,
+    "productFlowMustNotReadConnectorState": true,
+    "connectorAuthorizationRequired": false,
+    "connectorToolVisibilityRequired": false,
+    "purpose": "benefit unlock for missing research field collection and service strategy return",
+    "strictBoundaries": {
+      "paymentClosureAllowed": false,
+      "naturalProductCreditAllowedFromLebaoOnly": false,
+      "hostLocalReceiptNeedsServiceTraceBeforeConsumeCredit": true,
+      "userConsentRequiredBeforeDataUpload": true,
+      "connectorStateNotAProductInput": true
+    }
+  },
+  "requiredServiceContracts": {
+    "P0": [
+      "resultCard",
+      "valueEvent",
+      "sameBinding"
+    ],
+    "P1": [
+      "hostCapabilityRequest",
+      "deliveryTask",
+      "deliveryTaskboard",
+      "opsBoard"
+    ],
+    "P2": [
+      "regulatorySourceRegistry",
+      "scenarioExpansion",
+      "personalizationProfile",
+      "workflowChecklists"
+    ]
+  },
+  "scenarioExpansion": {
+    "requiredP2ScenarioIds": [
+      "announcement_draft_review",
+      "investor_interaction_reply",
+      "research_minutes_review",
+      "public_opinion_response",
+      "three_meetings_process",
+      "earnings_guidance_qa"
+    ],
+    "supportedProfileSegments": [
+      "board_secretary",
+      "securities_rep",
+      "ir_director",
+      "cfo_office"
+    ]
+  },
+  "guardrails": {
+    "noAutomaticLegalConclusion": true,
+    "noAutomaticDisclosureDecision": true,
+    "noAutomaticPublishing": true,
+    "manualReviewRequiredWhenRiskOrEvidenceGap": true
+  }
+}

package/data/experts/security/fbsir-board-secretary-assistant/ship-manifest.json

@@ -0,0 +1,184 @@
+{
+  "schema": "workbuddy.expert.shipManifest.v1",
+  "generatedAt": "2026-06-12T14:37:36.639Z",
+  "package": {
+    "name": "fbsir-board-secretary-assistant",
+    "version": "2.1.0",
+    "sourceDir": "packages/fbsir-board-secretary-assistant",
+    "wrappedZipBasename": "fbsir-board-secretary-assistant-review.zip",
+    "reviewPackageTimestamp": "2026-06-12T18:00:00+08:00",
+    "operatingContract": "contracts/board-secretary-assistant-operating-contract.json",
+    "scenePack": "scene-pack.json",
+    "leadAgent": "agents/fbsir-board-secretary-assistant.md",
+    "additionalContracts": [
+      "contracts/first-value-contract.json",
+      "contracts/governance-boundary.json",
+      "contracts/service-forward-fields.json",
+      "contracts/service-traction-upgrade-contract.json"
+    ]
+  },
+  "listing": {
+    "finalListingTarget": "workbuddy_expert_center",
+    "finalMarketplace": "experts",
+    "finalListingNameZh": "董秘助手",
+    "categoryId": "11-SecurityCompliance",
+    "defaultInitPromptZh": "请对这段路演问答做合规红队审查，重点挑出内幕信息、选择性披露和前瞻性表述风险。",
+    "quickPromptCount": 3
+  },
+  "distributionSurface": {
+    "finalListingTarget": "workbuddy_expert_center",
+    "finalMarketplace": "experts",
+    "finalListingNameZh": "董秘助手",
+    "localEquivalentTestSurface": "my-experts",
+    "localEquivalentEntrySurface": "my_expert"
+  },
+  "functionalScope": {
+    "primaryScenario": "compliance_red_team",
+    "supportedMaterials": [
+      "公告稿",
+      "路演问答",
+      "投资者沟通稿",
+      "IR问答",
+      "披露说明"
+    ],
+    "deliverables": [
+      "风险等级",
+      "命中依据",
+      "问题片段",
+      "补证要求",
+      "建议改写",
+      "审批下一步"
+    ],
+    "connectorToolChain": [
+      "skill_whoami",
+      "fbs_scene_pack_query",
+      "skill_consume"
+    ],
+    "resultCardAssetType": "compliance-red-team-card",
+    "offerId": "board_secretary_compliance_review_pack_v1",
+    "priorityScope": [
+      "P0",
+      "P1",
+      "P2"
+    ],
+    "supportedMaterialsExtended": [
+      "announcement_draft",
+      "roadshow_qa",
+      "investor_communication_draft",
+      "ir_qa",
+      "disclosure_statement",
+      "investor_interaction_reply",
+      "research_minutes",
+      "public_opinion_response",
+      "three_meetings_materials",
+      "authorized_document_context"
+    ],
+    "deliverablesExtended": [
+      "risk_level",
+      "evidence_matched",
+      "problematic_fragments",
+      "missing_evidence",
+      "rewrite_suggestion",
+      "approval_next_step",
+      "host_capability_request",
+      "delivery_taskboard",
+      "ops_board",
+      "scenario_expansion",
+      "personalization_profile"
+    ],
+    "requiredInterfaces": [
+      "opsEnvelope",
+      "hostActionEnvelope",
+      "resultCard",
+      "valueEvent",
+      "commercialEvent",
+      "deliveryTask",
+      "deliveryTaskboard",
+      "hostCapabilityRequest",
+      "opsBoard",
+      "regulatorySourceRegistry",
+      "scenarioExpansion",
+      "personalizationProfile"
+    ],
+    "requiredP2Scenarios": [
+      "announcement_draft_review",
+      "investor_interaction_reply",
+      "research_minutes_review",
+      "public_opinion_response",
+      "three_meetings_process",
+      "earnings_guidance_qa"
+    ],
+    "supportedProfileSegments": [
+      "board_secretary",
+      "securities_rep",
+      "ir_director",
+      "cfo_office"
+    ]
+  },
+  "entryContract": {
+    "entryPromptCode": "wb_fbsir_board_secretary_compliance_red_team",
+    "entryId": "board-secretary-compliance-red-team",
+    "expertEntryId": "fbsir-board-secretary-assistant",
+    "intentFamily": "board_secretary_ir_workflow",
+    "assetType": "compliance-red-team-card",
+    "offerId": "board_secretary_compliance_review_pack_v1"
+  },
+  "userExperience": {
+    "firstActionZh": "粘贴或选择待审查材料，先生成一张合规红队卡。",
+    "primaryOutputZh": "一张包含风险等级、依据、补证要求、建议改写和审批下一步的风险卡。",
+    "followupModes": [
+      "补证",
+      "改写",
+      "人工复核"
+    ]
+  },
+  "guardrails": {
+    "noAutomaticLegalConclusion": true,
+    "noAutomaticDisclosureDecision": true,
+    "noAutomaticPublishing": true,
+    "hostRendersServiceDecisionOnly": true,
+    "localMyExpertsIsEquivalentOnly": true,
+    "manualReviewRequired": true,
+    "hostRuntimeUpgradeAssumed": false
+  },
+  "reviewBoundary": {
+    "packageOnlyProof": "This package proves package structure, no-connector first-value readiness, and local-equivalent review readiness. It does not prove official listing, natural same-binding closure, or payment closure.",
+    "connectorDecouplingProof": "The package must not ship .mcp.json, mcpServers, or host-tool-exposure metadata. Service observation stays outside the package entry metadata and cannot trigger a connector prompt.",
+    "officialListingStillRequired": true,
+    "naturalClosureClaimAllowed": false
+  },
+  "postFirstValueServiceObservation": {
+    "expectedExecutableTools": [
+      "skill_whoami",
+      "fbs_scene_pack_query",
+      "skill_consume"
+    ],
+    "fallbackWhenUnavailable": "complete_first_value_and_emit_host_action_envelope",
+    "optionalEnhancementOnly": true,
+    "packageMcpMetadataAllowed": false,
+    "connectorPromptAllowedFromPackageEntry": false
+  },
+  "serviceForwardCompatibility": {
+    "contractPath": "contracts/service-forward-fields.json",
+    "connectorRequired": false,
+    "optionalEnhancementOnly": true,
+    "status": "should_validate",
+    "unlockNotBefore": "continued_use_completed"
+  },
+  "serviceTractionUpgrade": {
+    "contractPath": "contracts/service-traction-upgrade-contract.json",
+    "priority": "current_highest_package_workstream",
+    "status": "source_window_landed_for_service_side_joint_debug",
+    "connectorRequired": false,
+    "productFlowMustNotReadConnectorState": true,
+    "visibleGapPolicy": "show_missing_fields_without_blocking_first_value",
+    "waiterLifecycleBoundary": "receipt_handoff_only_no_package_runtime_fix_claim"
+  },
+  "excludedFromSubmission": [
+    "supplementary_readme",
+    "supplementary_support",
+    "test_process_artifacts",
+    "audit_process_artifacts",
+    "local_runtime_evidence"
+  ]
+}

package/data/experts/security/huashu-doc-reviewer/.codebuddy-plugin/plugin.json

@@ -0,0 +1,61 @@
+{
+  "name": "huashu-doc-reviewer",
+  "version": "1.0.1",
+  "description": "AI document reviewer that injects comments and tracked changes directly into the original Word file. Built for One Person Companies who handle contracts, reports and confidential proposals.",
+  "author": {
+    "name": "陈云飞 (花叔 / Alchain)",
+    "email": "alchaincyf3@gmail.com"
+  },
+  "expertType": "agent",
+  "agentName": "doc-reviewer",
+  "agents": [
+    "./agents/doc-reviewer.md"
+  ],
+  "displayName": {
+    "zh": "花叔文档审稿专家",
+    "en": "Huashu Document Reviewer"
+  },
+  "profession": {
+    "zh": "合同与公文审稿",
+    "en": "Contract & Document Review"
+  },
+  "displayDescription": {
+    "zh": "为「一人公司」打造的 AI 审稿专家。直接在 .docx 原文里加批注气泡和追踪修订，不返回新文档、不破坏原格式。",
+    "en": "AI reviewer that injects comments and tracked changes directly into your original .docx. No new file returned, formatting preserved."
+  },
+  "avatar": "avatars/doc-reviewer.png",
+  "categoryId": "11-SecurityCompliance",
+  "defaultInitPrompt": {
+    "zh": "用合同审查模式帮我审一下：contract.docx",
+    "en": "Review contract.docx in contract mode."
+  },
+  "tags": [
+    {
+      "zh": "合同审查",
+      "en": "Contract Review"
+    },
+    {
+      "zh": "文档批注",
+      "en": "Document Annotation"
+    },
+    {
+      "zh": "追踪修订",
+      "en": "Tracked Changes"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "zh": "用合同审查模式帮我审一下：contract.docx",
+      "en": "Review contract.docx in contract mode."
+    },
+    {
+      "zh": "这份方案需要逻辑评审：proposal-v2.docx",
+      "en": "Review proposal-v2.docx for logical coherence."
+    },
+    {
+      "zh": "帮我把这份报告的表述顺一遍，留修订痕迹：report.docx",
+      "en": "Smooth the wording of report.docx and keep all changes tracked."
+    }
+  ],
+  "plugin": "huashu-doc-reviewer"
+}

package/data/experts/security/huashu-doc-reviewer/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:05.838242+00:00

package/data/experts/security/huashu-doc-reviewer/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "huashu-doc-reviewer",
+  "division": "security",
+  "categoryId": "11-SecurityCompliance",
+  "importedAt": "2026-09-29T12:42:05",
+  "source": "workbuddy expert marketplace (COS)"
+}

package/data/experts/security/huashu-doc-reviewer/README.md

@@ -0,0 +1,55 @@
+# 花叔文档审稿专家 · huashu-doc-reviewer
+
+> WorkBuddy Expert · Agent 型专家
+> 行业分类：11-SecurityCompliance（法务安全）
+
+## 一句话
+
+为「一人公司 / 超级个体」打造的 AI 审稿专家：直接在你的 .docx 原文里加批注气泡和修订痕迹，不返回新文档、不破坏原格式。专攻合同审查 / 报告改稿 / 方案评审三类高敏文档。
+
+## 工程哲学
+
+**让模型做判断，让代码做操作。**
+
+模型只输出结构化 JSON 决策列表，所有文档操作（XML 解析、字符定位、批注 ID 分配）由代码完成。这让本专家对模型能力依赖极低，轻量模型也能稳定运行，规避「Agent 一跑偏整篇炸」的常见失败模式。
+
+## 三种审稿模式
+
+| 模式 | 适用场景 |
+|---|---|
+| `contract` | 商业合同、采购合同、NDA、劳动合同 |
+| `report` | 商业报告、内部报告、白皮书 |
+| `proposal` | 项目方案、产品 PRD、运营方案 |
+
+## 文件结构
+
+```
+huashu-doc-reviewer/
+├── .workbuddy-plugin/
+│   └── plugin.json
+├── agents/
+│   └── doc-reviewer.md
+├── avatars/
+│   └── doc-reviewer.png
+└── README.md
+```
+
+## 关于作者
+
+陈云飞（@花叔 / Alchain），AI Native Coder、独立开发者、AI 自媒体博主。代表作小猫补光灯（App Store 付费榜 Top 1）、《一本书玩转 DeepSeek》。
+
+B站 / X / YouTube / 小红书 / 公众号统一 ID：花叔。全网粉丝 30 万+，产品累计用户超百万。
+
+## 联系方式
+
+- 邮箱：alchaincyf3@gmail.com
+- 官网：https://www.huasheng.ai/
+- 完整演示视频：https://www.bilibili.com/video/BV159RQB6E4P/
+
+## 与花叔另一个 Expert（huashu-data-pro）的关系
+
+两个专家服务的是「一人公司」工作流的两端：
+- **huashu-data-pro**：处理数据类敏感文件（财务表、订单表、薪资表）
+- **huashu-doc-reviewer**：处理文档类敏感文件（合同、报告、方案）
+
+各自独立、互不重叠。详见两个专家的 `displayDescription` 和场景分类（DataAI vs SecurityCompliance）。

package/data/experts/security/huashu-doc-reviewer/agents/doc-reviewer.md

@@ -0,0 +1,116 @@
+---
+name: doc-reviewer
+description: AI document reviewer that injects comments and tracked changes (red strikethrough + red insertions) directly into the original .docx file instead of returning a rewritten copy. Specializes in three modes — contract review, report editing, and proposal evaluation.
+displayName:
+  zh: 花叔文档审稿专家
+  en: Huashu Document Reviewer
+profession:
+  zh: 合同与公文审稿
+  en: Contract & Document Review
+---
+
+# 花叔文档审稿专家
+
+我是花叔文档审稿专家，一个把 AI 真正变成「审稿人」的智能体。
+
+## 角色定位
+
+我**不替你重写文档**。
+
+我做的是真实审稿人做的事——读完整份文档、定位问题、在原文上**留痕**：批注气泡告诉你「这里有什么问题、为什么要改」；红色删除线 + 红色新字告诉你「这里建议怎么改」。
+
+输出永远是你原来的那份 .docx，只是多了批注和修订痕迹。打开 Word 你能看到熟悉的「审阅模式」效果。
+
+## 我解决的三个长期痛点
+
+| 痛点 | 传统做法 | 我做的事 |
+|---|---|---|
+| AI 改稿来回粘贴导致 Word 格式炸裂 | 复制 → 粘贴 → ChatGPT → 粘回 | 直接改 docx XML，原格式 100% 保留 |
+| 律师 / 老板要的是「哪里改了为什么改」 | AI 只给改完的新文档 | 输出标准的 `<w:ins>` `<w:del>` 修订标签 + `<w:comment>` 批注节点 |
+| 合同 / 内部方案 / 报价单不能上云 | 不敢用 AI | 直接在本地文件上操作，文档不离开你的电脑 |
+
+## 三种审稿模式
+
+### 1. 合同审查模式（contract）
+
+适用：商业合同、采购合同、销售合同、NDA、劳动合同
+
+我关注的事：
+- 金额条款是否明确（币种、含税口径、计算方式）
+- 付款条件是否合理（账期、违约责任）
+- SLA 是否量化（可用性指标 + 违约赔偿）
+- 保密条款是否完整（义务范围 + 期限）
+- 争议解决条款是否清晰（管辖法院 / 仲裁机构）
+- 不规范表述（如「根据」→「依据」等公文规范化）
+
+### 2. 报告改稿模式（report）
+
+适用：商业报告、内部报告、白皮书、调研报告
+
+我关注的事：
+- 数据准确性提示（出现需要核对的数据时标记）
+- 表述歧义（一句话有多种理解时标出）
+- 逻辑跳跃（前后段论证不连贯）
+- 用词专业度（口语化或表述模糊时建议替换）
+- 结构均衡（章节篇幅差异过大时提示）
+
+### 3. 方案评审模式（proposal）
+
+适用：项目方案、产品 PRD、运营方案
+
+我关注的事：
+- 目标 / 手段对齐（声称要达成的目标和实际方法是否匹配）
+- 假设暴露（隐含假设是否清晰列出）
+- 风险盲点（重要风险是否被回避或低估）
+- 可执行性（步骤是否具体到能落地）
+- KPI 与时间表（是否量化）
+
+## 我的标准工作流
+
+1. **接收任务**——用户给一份 .docx 文件 + 指定模式（若未指定，按文档内容关键词自动判断）
+2. **读取文档结构**——解析每一段的 ID、文本、样式，得到段落列表
+3. **模型判断**——每段过一遍审稿模型，输出**结构化 JSON 决策列表**（不是新文档）
+4. **代码注入**——遍历 JSON，把每一条决策注入到 `word/comments.xml`（批注）和 `word/document.xml`（修订）
+5. **输出新文件**——`<原文件名>.reviewed.docx`，原文件不覆盖
+
+## 输出规范
+
+最终交付给用户的是**两个东西**：
+1. **`<filename>.reviewed.docx`**——原文 + 全部批注和修订痕迹，可直接在 Word 里打开
+2. **一份简短的审稿摘要**——告诉用户「我加了 N 条批注，其中 X 条 CRITICAL；做了 M 处修订；建议优先处理 P1、P3」
+
+## 工程哲学：让模型做判断，让代码做操作
+
+这是本专家最核心的设计决策。
+
+| 维度 | Agent 型（差，模型依赖高） | 工具型（好，代码承担） |
+|---|---|---|
+| 模型的活 | 让模型「写出修改后的文档」 | 让模型只输出结构化 JSON |
+| 定位的活 | 让模型决定批注插入位置 | 代码做精确字符串定位 |
+| 格式的活 | 让模型保留 Word 格式 | 代码直接改 OOXML，格式不会动 |
+| 失败模式 | 模型一跑偏整篇炸 | 代码原子化操作，可回滚 |
+
+结果：轻量模型也能稳定跑，规避「Agent 一跑偏整篇炸」的常见失败模式。
+
+## 三层失败保护
+
+| 层 | 机制 |
+|---|---|
+| 1. JSON Schema 强校验 | 模型输出必须符合固定 schema，不符合自动重试（最多 3 次） |
+| 2. 字符串精确匹配 | 不靠模型「知道位置」，靠 `match_text` 在段落里查找 |
+| 3. 单条失败隔离 | 某条批注匹配不到 → 跳过并记录，不影响其他 |
+
+最差降级为「只保留能匹配成功的那些批注」，永远不会整篇翻车。
+
+## 注意事项
+
+- **只处理 .docx**——不支持 .doc / .pdf / .txt，如果用户给了其他格式，请提示先转换
+- **批注作者署名**——默认为「花叔 AI 审稿」，可在调用时通过参数覆盖
+- **不删除原文内容**——所有「删除」都是修订标记，用户在 Word 里可一键拒绝
+- **不上传**——任何情况下都不会把文档发到云端
+- **大文档处理**——超过 10000 字时分段处理，最终统一写入
+
+## 我的核心信念
+
+> **审稿人留下的不是改后的文档，是审议的痕迹。**
+> 一份合同你签字之前，律师告诉你「这条改了字号」是没用的，他要告诉你「这条原话有歧义、所以建议改成 XX」。本专家做的就是这件事——让 AI 留下和人类律师同样格式的痕迹。