Xuecheng Batch Exporter

Xuecheng Batch Exporter

Batch export KM/XueCheng/Citadel documents to local Markdown while preserving source traceability. Use the bundled XueChengCopyPlugin submodule as the browser/API conversion reference, and use the script for repeatable parent-directory or ID-list exports.

First Choice

Use export_batch.mjs for batch work:

node scripts/export_batch.mjs --parent 2754620560 --out /tmp/xuecheng-export --mis wangjinghong02
node scripts/export_batch.mjs --parent 2754620560 --out /tmp/xuecheng-export --mis wangjinghong02 --recursive
node scripts/export_batch.mjs --ids "2754890255,https://km.sankuai.com/collabpage/2755021188" --out /tmp/xuecheng-export --mis wangjinghong02

The script writes one Markdown file per document plus manifest.json. Each file includes the original KM source link near the top and strips the getSimpleMarkdown read-only warning block.

Use --dry-run before large exports:

node scripts/export_batch.mjs --parent 2754620560 --out /tmp/xuecheng-export --mis wangjinghong02 --dry-run

For parent exports, --dry-run always walks descendants deeply and prints count, directCount, maxDepth, a pre-order docs list, and a nested tree. Use this to spot nested articles before choosing whether the real export should include --recursive.

Source Discovery

• Extract IDs directly from https://km.sankuai.com/collabpage/<id> or https://km.sankuai.com/page/<id>.
• For a parent directory, inspect with --dry-run first. If maxDepth is greater than 0 and the destination should preserve the full hierarchy, run the real export with --recursive.
• For explicit document sets, use --ids or --ids-file.
• If enterprise auth needs a MIS and the user has not provided one, ask. Do not guess.

Plugin Submodule

assets/XueChengCopyPlugin is a git submodule pointing to https://github.com/ceilf6/XueChengCopyPlugin.git.

Read xuecheng-copy-plugin.md when:

• a single open KM page should be exported through the browser;
• oa-skills citadel getSimpleMarkdown loses a block type that the plugin handles;
• you need to update conversion behavior by reusing copyPlugin.js block handling.

The plugin flow is page-local: it parses the document ID, calls the KM recent-document API, converts the ProseMirror-like block tree to Markdown, and copies Markdown to the clipboard.

Export Workflow

1. Resolve the source IDs or parent ID.
2. Run --dry-run for parent exports and confirm count, directCount, maxDepth, and tree match expectations.
3. Run the export script to a fresh output directory. Add --recursive when nested child pages should be included.
4. Scan exported Markdown for KM-hosted images or attachments:

   rg -n '!\\[|km\\.sankuai\\.com/api/file|附件|cdn' /tmp/xuecheng-export
   

5. If the destination cannot access KM CDN links, use oa-skills citadel fetchImage or fetchAttachment for those assets and replace the links.
6. Verify manifest.json count and spot-check at least one exported file.

Notion Handoff

For Notion migration, use manifest.json as the source of truth. Create/import pages from manifest.documents in pre-order, and use each document's parentId or the nested manifest.tree to preserve the original hierarchy. Preserve duplicate KM titles unless the destination requires unique names; rely on the source link and file name to disambiguate duplicates.

Verification

Run these from the skill directory or repository root after editing scripts:

node --test xuecheng-batch-exporter/scripts/export_batch.test.mjs
python3 /Users/ceilf6/.codex/skills/.system/skill-creator/scripts/quick_validate.py xuecheng-batch-exporter

For a live smoke test, use a tiny export:

node xuecheng-batch-exporter/scripts/export_batch.mjs --ids "2754890255" --out /tmp/xuecheng-export-smoke --mis wangjinghong02

Common Mistakes

• Do not export a parent directory without checking child count first.
• Do not ignore maxDepth in dry-run output; a value above 0 means a flat export would omit nested articles unless the real export uses --recursive.
• Do not leave the Citadel read-only warning block in destination Markdown.
• Do not drop source KM links; they are the audit trail.
• Do not assume KM CDN images will render in Notion or external docs.
• Do not edit the submodule contents inside this skill unless the intended change belongs in ceilf6/XueChengCopyPlugin.