Plaud Meeting Archive / Plaud会议归档助手

Archive selected Plaud audio, transcripts, or summaries in JishuDB; preserve provenance and verify imports before cited follow-up analysis. / 将选定的Plaud音频、转写或纪要归档到JishuDB，保留来源关联，验证导入后进行有引用的分析。

Archive selected Plaud audio, timestamped transcripts, and summaries in JishuDB with stable source associations. Keep each representation distinct and verify saved material before offering cited comparisons.

At a glance

Item	Details
Use when	Selected Plaud meetings or local exports need archival and optional follow-up comparison.
Delivers	Saved representations, verified processing status, provenance records, and requested cited analysis.
Requires	JishuDB write access and authorized Plaud/local material; compatible direct upload for audio.
Does not	Control recording hardware, access unsynced device-only material, or silently drop requested audio.

Use this skill when

• The user wants to archive selected Plaud meetings in a JishuDB knowledge base.
• The user selects a local Plaud audio, transcript, or summary export to import.
• A resumed import needs to preserve the association between meeting representations.
• The user wants to import meetings and then compare their requirements with project documents.

Do not use this skill when

Do not use this skill to start recordings, control hardware, access unsynced device-only recordings, or import other vendors' material. If all needed material is already archived and only retrieval is requested, use jishudb-search; use jishudb for destination connection setup.

Agent workflow

Read connection and transfer before connecting or uploading, and use the provenance record for the saved association. Use the host's actual namespaced tools and live input schemas; tool names below are the unprefixed vendor and JishuDB names.

Scope and approval

1. Resolve the recording selection, material mode, destination KB, and output directory from the request. For an unqualified recording import, propose original audio plus any available existing transcript; summaries are a separate representation. Reuse an explicit user choice.
2. Disclose the selected source-to-JishuDB transfer and obtain approval for its actual material and destination. Do not interpret installing this Skill as account access, installation approval, or knowledge-base write approval.
3. Use the host's language for questions, reports, and meeting analysis. Ask only for ambiguous selections or necessary authorization, not for a resume, document pack, or unrelated account information.
4. Do not control hardware, start recordings, access unsynced device-only material, add other vendors, publish content, or create external tasks. Recurring imports need separately authorized host automation.

Connect and select

1. Locate the JishuDB connector and call kb_get_capabilities. Require the deployed jishudb-mcp-v2 contract and the necessary write tools. If setup is missing, load the official companion jishudb setup Skill and its installation contract through the host. If the companion is unavailable, request that dependency; do not invent installer or client-configuration commands. Preserve its OS, administrator, endpoint, trust, and privilege gates. Declined or unavailable setup blocks this packaged workflow.
2. Call kb_list, resolve the actual selected KB ID, and check kb_get_config and live tool schemas for document limits. Use kb_create only if the user approves creating the named destination. Do not guess a KB ID from its display name or silently select an unrelated default.
3. For cloud acquisition, call Plaud get_current_user. If authorization is missing, guide the browser login through the existing connector. Never ask for or read its token files. Confirm the intended account before reading recordings.
4. Call list_files with the relevant name/date filters, inspect candidate metadata, and use get_file for the selected ID. Resolve relative dates in the user's timezone and retain start_at separately from created_at. Inspect pagination and search coverage; an incomplete list does not prove that a meeting does not exist. If the recording has not synced, explain the vendor sync step.
5. For an approved local export, skip Plaud calls. Record that acquisition route honestly. Associate it with a vendor recording only when the user identifies that recording; otherwise use a stable user-approved local source identifier instead of inventing a Plaud ID.

Resolve prior imports before writing

1. Use the identity helper with the confirmed non-secret account scope, recording ID, and KB ID. For a local-only export, use the distinct scope local-export and its approved stable source ID. Its externalAssetId associates representations; manifestNoteId locates the durable provenance record. Do not use an email, device serial, bearer, or temporary URL as an identity input.
2. Call note_get with manifestNoteId. On NOT_FOUND only, plan a new provenance Note. Propagate authorization or service errors instead of treating them as an absent record. Before updating an existing Note, verify its Skill marker, source association, and KB match.
3. Follow kb_list_documents pagination to reconcile existing associated documents, including an interrupted import not yet recorded in the Note. Call kb_get_document for candidate IDs. Match representation and content hash; use audio.originalSha256 for original audio, not the document's potentially transcript-based sha256.
4. Reuse unchanged material. Append changed source content as an explicitly labelled revision by default; never overwrite or delete an older document automatically. If a manifest references a missing/deleted resource, report it and obtain approval before recreating it.

Acquire and import selected material

1. Before downloading audio, require mcp.upload.audio.enabled, its direct mode, the requested extension, and acceptable size/duration. Inspect speech and compressed-decoder readiness separately. Missing readiness requires repair or explicit approval to retain an original while processing remains incomplete; never promise a ready transcript in that case.
2. For audio, obtain the selected recording's current presigned_url from get_file and download actual bytes with a bounded, authorized host transfer. Keep the URL transient. Renew it through get_file after expiry; do not store it as provenance or bypass access restrictions.
3. For existing text, call get_transcript and/or get_note only for the approved representations. Preserve supplied timestamps and speaker labels. Store a summary as a summary, not a substitute transcript. Do not invoke audio recognition merely to import existing text.
4. Preserve the original downloaded/exported files in the approved output directory without overwriting existing files. Hash exact bytes. Keep collection times and import status out of the immutable source-text payload so reruns do not manufacture a new content revision.
5. Run the identity helper again with the representation and actual content SHA-256. Keep its retry identity unchanged for the same bytes and target. Execute the transfer sequence in the reference: kb_prepare_upload, its returned raw PUT, then kb_get_job. Use the shared externalAssetId for the audio and each text representation.
6. When direct upload is unavailable, supported text can use kb_upload({kbId, filename, contentBase64, externalAssetId}). Inspect its live schema first. Audio cannot use this fallback or server-side path. If the host cannot transfer audio, report the missing capability rather than silently switching to transcript-only import.
7. After uncertain completion, query kb_list_jobs using the descriptor's clientItemId before retrying bytes. Reconcile associated documents before replacing an expired preparation. A new attempt after a proven failed, uncommitted transfer must be recorded explicitly; it is not permission to duplicate an already saved recording.

Persist provenance and complete

1. Poll kb_get_job at a reasonable interval, for at most two minutes in the current interaction. A still-running job is PARTIAL, not failed or complete. Retain its ID for continuation instead of resubmitting it.
2. Call kb_get_document for each saved representation. For audio, report original retention, playback/normalization, transcription, and indexing separately. Use kb_retry_job only after inspecting the failed/cancelled job and addressing its cause. An indexing-only retry should reuse the saved transcription.
3. Read saved text with kb_read_document_text and confirm the requested source content or recognizable passages. Use kb_search in the selected KB to establish retrieval before promising cited analysis.
4. Save or merge the provenance record with note_create or note_update, using the stable Note ID and the returned updatedAt for optimistic concurrency. For creation, capture one RFC 3339 createdAt and reuse the identical request on an uncertain retry.
5. Call note_link_to_kb with the saved Note's current updatedAt. Follow its job, then note_get and kb_read_document_text for the linked document. A source-only Note or a queued link is not completed KB archival. Subsequent updates to a linked Note refresh automatically; inspect that refresh instead of linking repeatedly.
6. Only if requested, compare the imported material with the user's selected existing KB evidence. Cite returned document/chunk IDs and actual source timestamps where present. Separate original summaries from new analysis, preserve disagreements, and identify missing evidence. Never invent speaker labels or meeting commitments.

Return one state with the saved IDs, material coverage, and any required recovery action:

• COMPLETE: all requested material and provenance are saved, required processing/indexing and readback succeeded, and requested analysis is cited.
• PARTIAL: some material is saved or files are preserved, but a requested representation, processing step, or provenance refresh remains incomplete.
• USER_ACTION_REQUIRED: login, installation, trust, or another explicit user-presence gate is waiting and no partial archival needs reporting.
• BLOCKED: a required source/backend/host capability is absent or declined before archival.
• FAILED: an available operation failed before anything was archived; report the actual failure without a success-shaped substitute.

Never print credentials, upload headers, signed URLs, or account/device identifiers in the completion report. This package does not claim a tested Plaud account, WorkBuddy integration, or mainland network configuration.

Discovery

Keywords

• English: Plaud import, local recording export, meeting transcript, provenance, duplicate reconciliation.
• Chinese: Plaud录音导入、会议归档、音频导入、带时间戳转写、来源关联.

Example requests

• “Archive selected Plaud meetings while preserving audio and transcript associations.”
• “Resume this interrupted recording import and check what is already saved.”
• “把我选中的Plaud录音和已有转写导入指定知识库。”
• “导入这份Plaud本地导出，再对比已归档的项目需求。”

Nearby but different

• Read material already archived in JishuDB → jishudb-search.
• Repair the destination connection → jishudb.