@aswless_854771076/ai_short_studio_cli 0.1.156 → 0.1.158
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/commands/canvas/document/get.js +3 -3
- package/dist/commands/canvas/document/save.js +8 -2
- package/dist/commands/canvas/documents.js +1 -1
- package/dist/commands/canvas/workflow/status.js +1 -1
- package/dist/domain/canvas-schema-key.d.ts +2 -0
- package/dist/domain/canvas-schema-key.js +21 -0
- package/dist/domain/vvicat-api.js +1 -1
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +24 -24
- package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +11 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +25 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/SOURCE.md +9 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +408 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +17 -31
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +25 -25
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +5 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +4 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +6 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +9 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +9 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md +59 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.mjs +517 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.test.mjs +354 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.mjs +188 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.test.mjs +218 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.mjs +458 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.test.mjs +236 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs +69 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs +341 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.test.mjs +302 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +43 -133
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +5 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +7 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +7 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +4 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +40 -65
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +91 -131
- package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/h3-prompt-writing.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +186 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +64 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md +87 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +6 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +0 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +5 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +2 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +28 -70
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +0 -447
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +0 -93
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +0 -266
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +0 -253
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +0 -176
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +0 -411
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +0 -275
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +0 -286
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +0 -193
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +0 -94
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +0 -125
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +0 -252
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +0 -218
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +0 -123
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +0 -38
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +0 -85
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +0 -95
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +0 -68
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +0 -161
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +0 -76
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +0 -433
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +0 -224
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +0 -99
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +0 -87
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +0 -160
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +0 -71
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +0 -19
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +0 -88
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +0 -92
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +0 -82
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +0 -101
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +0 -77
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +0 -49
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +0 -228
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +0 -112
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +0 -330
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +0 -156
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +0 -66
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +0 -217
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +0 -150
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +0 -152
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +0 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +0 -14
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +0 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +0 -62
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +0 -138
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +0 -102
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +0 -111
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +0 -114
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +0 -211
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +0 -151
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +0 -236
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +0 -90
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +0 -75
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +0 -163
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +0 -189
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +0 -186
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +0 -249
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +0 -169
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +0 -74
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +0 -96
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +0 -215
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +0 -67
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +0 -47
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +0 -119
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +0 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +0 -12
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/seedance-community-skills.md +0 -23
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +0 -33
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +0 -53
- package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +0 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +0 -32
- /package/skills/using-vvicat-ai-short-studio-cli/references/{short-drama/assets/modules/humanizer → humanizer}/LICENSE +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-base-prompt-writing.md +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-reference-prompt-writing.md +0 -0
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
import test from 'node:test'
|
|
2
|
+
import assert from 'node:assert/strict'
|
|
3
|
+
import {
|
|
4
|
+
mergePlayletObservations,
|
|
5
|
+
normalizeRankingItem,
|
|
6
|
+
normalizeRankings,
|
|
7
|
+
parseList,
|
|
8
|
+
} from './normalize.mjs'
|
|
9
|
+
|
|
10
|
+
test('合并数组和字符串标签并保留来源', () => {
|
|
11
|
+
const result = normalizeRankings({
|
|
12
|
+
hot: [{ playletId: 1, playletName: '公司扣我年终奖,我不忍了', ranking: 1, consumeNum: 889000, newFlag: true, playletTags: ['男频', null, '现代', '都市日常'], relatedPartyCompany: ['快创'] }],
|
|
13
|
+
douyin: [{ playletId: 2, playletName: '今晚查寝,别开门', ranking: 1, playCountAddRaw: 900000, tags: '["女频","悬疑"]', isNew: 1 }],
|
|
14
|
+
}, { observedAt: '2026-09-16T15:30:00+08:00' })
|
|
15
|
+
|
|
16
|
+
assert.deepEqual(result[0].topics, ['都市日常'])
|
|
17
|
+
assert.equal(result[0].audience, '男频')
|
|
18
|
+
assert.equal(result[0].provenance.topicSource, 'source-tag')
|
|
19
|
+
assert.equal(result[1].growthValue, 900000)
|
|
20
|
+
assert.deepEqual(Object.keys(result[0]).sort(), [
|
|
21
|
+
'audience', 'companies', 'era', 'format', 'growthValue', 'heatValue', 'isNew', 'key', 'persistenceDays', 'playletId', 'provenance', 'ranking', 'rankingType', 'rawTopics', 'title', 'topics', 'observedAt',
|
|
22
|
+
].sort())
|
|
23
|
+
})
|
|
24
|
+
|
|
25
|
+
test('parseList 处理数组、JSON、普通分隔符和非法 JSON', () => {
|
|
26
|
+
assert.deepEqual(parseList([' 男频 ', null, '都市', '男频']), ['男频', '都市'])
|
|
27
|
+
assert.deepEqual(parseList('["女频", null, "悬疑", "女频"]'), ['女频', '悬疑'])
|
|
28
|
+
assert.deepEqual(parseList('公司, 快创;公司|星河/快创'), ['公司', '快创', '星河'])
|
|
29
|
+
assert.deepEqual(parseList(null), [])
|
|
30
|
+
assert.deepEqual(parseList('{非法 JSON'), ['{非法 JSON'])
|
|
31
|
+
})
|
|
32
|
+
|
|
33
|
+
test('损坏 JSON 数组清洗括号、引号和字符串 null,并保留可恢复标签', () => {
|
|
34
|
+
const tags = parseList('["男频",null,"都市日常"')
|
|
35
|
+
assert.deepEqual(tags, ['男频', '都市日常'])
|
|
36
|
+
|
|
37
|
+
const observation = normalizeRankingItem('hot', {
|
|
38
|
+
title: '一部普通短剧',
|
|
39
|
+
tags: '["男频",null,"都市日常"',
|
|
40
|
+
})
|
|
41
|
+
assert.equal(observation.audience, '男频')
|
|
42
|
+
assert.deepEqual(observation.topics, ['都市日常'])
|
|
43
|
+
assert.deepEqual(observation.provenance.evidence.rawTags, ['男频', '都市日常'])
|
|
44
|
+
})
|
|
45
|
+
|
|
46
|
+
test('状态和形式标签不作为题材,未知来源标签原样保留', () => {
|
|
47
|
+
const observation = normalizeRankingItem('hot', {
|
|
48
|
+
title: '没有明确题材的作品',
|
|
49
|
+
tags: ['真人', '短剧', '已完结', '这是一个超过十六个字符的未知题材标签'],
|
|
50
|
+
})
|
|
51
|
+
|
|
52
|
+
assert.deepEqual(observation.topics, ['这是一个超过十六个字符的未知题材标签'])
|
|
53
|
+
assert.equal(observation.provenance.topicSource, 'source-tag')
|
|
54
|
+
assert.equal(observation.format, null)
|
|
55
|
+
assert.deepEqual(observation.provenance.evidence.rawTags, ['真人', '短剧', '已完结', '这是一个超过十六个字符的未知题材标签'])
|
|
56
|
+
})
|
|
57
|
+
|
|
58
|
+
test('来源细分题材映射为受控题材', () => {
|
|
59
|
+
const observation = normalizeRankingItem('hot', {
|
|
60
|
+
title: '一部普通作品',
|
|
61
|
+
tags: ['都市职场', '婆媳伦理', '古装爱情'],
|
|
62
|
+
})
|
|
63
|
+
|
|
64
|
+
assert.deepEqual(observation.topics, ['都市日常', '家庭伦理', '古装宫廷'])
|
|
65
|
+
assert.deepEqual(observation.rawTopics, ['都市职场', '婆媳伦理', '古装爱情'])
|
|
66
|
+
assert.equal(observation.provenance.topicSource, 'source-tag')
|
|
67
|
+
})
|
|
68
|
+
|
|
69
|
+
test('来源题材按精确 taxonomy 映射,支持一对多并保留未知标签', () => {
|
|
70
|
+
const observation = normalizeRankingItem('hot', {
|
|
71
|
+
title: '一部普通作品',
|
|
72
|
+
tags: ['悬疑', '都市职场', '霸道总裁', '重生穿越', '励志逆袭', '神秘标签'],
|
|
73
|
+
})
|
|
74
|
+
|
|
75
|
+
assert.deepEqual(observation.topics, ['悬疑推理', '都市日常', '总裁', '重生', '穿越', '逆袭', '神秘标签'])
|
|
76
|
+
assert.deepEqual(observation.rawTopics, ['悬疑', '都市职场', '霸道总裁', '重生穿越', '励志逆袭', '神秘标签'])
|
|
77
|
+
assert.deepEqual(observation.provenance.topicMappings, [
|
|
78
|
+
{ rawTopic: '悬疑', canonicalTopic: '悬疑推理', source: 'source-tag' },
|
|
79
|
+
{ rawTopic: '都市职场', canonicalTopic: '都市日常', source: 'source-tag' },
|
|
80
|
+
{ rawTopic: '霸道总裁', canonicalTopic: '总裁', source: 'source-tag' },
|
|
81
|
+
{ rawTopic: '重生穿越', canonicalTopic: '重生', source: 'source-tag' },
|
|
82
|
+
{ rawTopic: '重生穿越', canonicalTopic: '穿越', source: 'source-tag' },
|
|
83
|
+
{ rawTopic: '励志逆袭', canonicalTopic: '逆袭', source: 'source-tag' },
|
|
84
|
+
{ rawTopic: '神秘标签', canonicalTopic: '神秘标签', source: 'source-tag' },
|
|
85
|
+
])
|
|
86
|
+
})
|
|
87
|
+
|
|
88
|
+
test('JSON 非数组不降级拆分,普通文本支持中文顿号,JSON 对象不进入证据', () => {
|
|
89
|
+
assert.deepEqual(parseList('{"token":"悬疑"}'), [])
|
|
90
|
+
assert.deepEqual(parseList('12'), [])
|
|
91
|
+
assert.deepEqual(parseList('true'), [])
|
|
92
|
+
assert.deepEqual(parseList('都市、悬疑'), ['都市', '悬疑'])
|
|
93
|
+
|
|
94
|
+
const observation = normalizeRankingItem('hot', { title: '普通作品', tags: '{"token":"悬疑"}' })
|
|
95
|
+
assert.deepEqual(observation.topics, ['未分类'])
|
|
96
|
+
assert.deepEqual(observation.provenance.evidence.rawTags, [])
|
|
97
|
+
})
|
|
98
|
+
|
|
99
|
+
test('ID 和标题候选逐个校验并过滤完全无身份的脏条目', () => {
|
|
100
|
+
const fallback = normalizeRankingItem('hot', {
|
|
101
|
+
playletId: {},
|
|
102
|
+
id: 'valid-id',
|
|
103
|
+
playletName: ' ',
|
|
104
|
+
title: '有效标题',
|
|
105
|
+
})
|
|
106
|
+
assert.equal(fallback.playletId, 'valid-id')
|
|
107
|
+
assert.equal(fallback.title, '有效标题')
|
|
108
|
+
|
|
109
|
+
const numericFallback = normalizeRankingItem('hot', {
|
|
110
|
+
playletId: Number.NaN,
|
|
111
|
+
id: Infinity,
|
|
112
|
+
title: '数字候选无效',
|
|
113
|
+
ranking: [],
|
|
114
|
+
rank: -1,
|
|
115
|
+
topNum: '2.5',
|
|
116
|
+
listDays: { toString: null },
|
|
117
|
+
topDays: '3.5',
|
|
118
|
+
persistenceDays: '4',
|
|
119
|
+
growthValue: { toString: null },
|
|
120
|
+
playCountAddRaw: '-20',
|
|
121
|
+
})
|
|
122
|
+
assert.equal(numericFallback.playletId, null)
|
|
123
|
+
assert.equal(numericFallback.ranking, null)
|
|
124
|
+
assert.equal(numericFallback.persistenceDays, 4)
|
|
125
|
+
assert.equal(numericFallback.growthValue, -20)
|
|
126
|
+
assert.equal(normalizeRankingItem('hot', { playletId: {}, playletName: ' ' }), null)
|
|
127
|
+
assert.equal(normalizeRankings({ hot: [{ playletId: {}, playletName: ' ' }, { id: 'ok', title: '保留' }] }).length, 1)
|
|
128
|
+
})
|
|
129
|
+
|
|
130
|
+
test('运营榜单文案和否定标签不会成为来源题材', () => {
|
|
131
|
+
const observation = normalizeRankingItem('hot', {
|
|
132
|
+
title: '普通作品',
|
|
133
|
+
tags: ['系统推荐', '都市榜第1', '家庭用户热播', '非爱情'],
|
|
134
|
+
})
|
|
135
|
+
assert.deepEqual(observation.topics, ['未分类'])
|
|
136
|
+
assert.equal(observation.provenance.topicSource, 'unclassified')
|
|
137
|
+
})
|
|
138
|
+
|
|
139
|
+
test('格式字段无效时使用动态漫标签并记录实际来源', () => {
|
|
140
|
+
const observation = normalizeRankingItem('hot', {
|
|
141
|
+
title: '动态作品',
|
|
142
|
+
format: { invalid: true },
|
|
143
|
+
tags: ['动态漫'],
|
|
144
|
+
})
|
|
145
|
+
assert.equal(observation.format, '动态漫')
|
|
146
|
+
assert.equal(observation.provenance.sourceFields.format, 'tags')
|
|
147
|
+
})
|
|
148
|
+
|
|
149
|
+
test('标题词根只推断受控题材,不从题材推断受众和时代', () => {
|
|
150
|
+
const observation = normalizeRankingItem('hot', {
|
|
151
|
+
name: '重生后我成了霸总的白月光',
|
|
152
|
+
tags: ['现代'],
|
|
153
|
+
}, { observedAt: '2026-09-16T15:30:00+08:00' })
|
|
154
|
+
|
|
155
|
+
assert.deepEqual(observation.topics, ['总裁', '重生'])
|
|
156
|
+
assert.equal(observation.audience, null)
|
|
157
|
+
assert.equal(observation.era, '现代')
|
|
158
|
+
assert.equal(observation.provenance.topicSource, 'title-keyword')
|
|
159
|
+
})
|
|
160
|
+
|
|
161
|
+
test('脏数据和缺失 ID 使用稳定标题键,动态漫字段不扩张合同', () => {
|
|
162
|
+
const first = normalizeRankingItem('motion-ai', {
|
|
163
|
+
title: 'AI 归来',
|
|
164
|
+
rank: '2',
|
|
165
|
+
hotValue: 'not-a-number',
|
|
166
|
+
playCount: '12,300',
|
|
167
|
+
listDays: '7',
|
|
168
|
+
company: ['快创', '快创', null],
|
|
169
|
+
tags: '["男频", null]',
|
|
170
|
+
cover: 'ignored-cover-a.jpg',
|
|
171
|
+
}, { observedAt: '2026-09-16T15:30:00+08:00' })
|
|
172
|
+
const second = normalizeRankingItem('motion-ai', {
|
|
173
|
+
title: ' AI 归来 ',
|
|
174
|
+
rank: 3,
|
|
175
|
+
coverUrl: 'ignored-cover-b.jpg',
|
|
176
|
+
}, { observedAt: '2026-09-16T15:30:00+08:00' })
|
|
177
|
+
|
|
178
|
+
assert.equal(first.key, second.key)
|
|
179
|
+
assert.equal(first.ranking, 2)
|
|
180
|
+
assert.equal(first.heatValue, 12300)
|
|
181
|
+
assert.equal(first.persistenceDays, 7)
|
|
182
|
+
assert.deepEqual(first.companies, { platform: [], contractor: [], copyrightHolder: [], producer: ['快创'] })
|
|
183
|
+
assert.deepEqual(first.provenance.rawRef, { snapshotId: null, rankingType: 'motion-ai', playletId: null })
|
|
184
|
+
assert.equal(first.format, '真人AI')
|
|
185
|
+
assert.equal(first.audience, '男频')
|
|
186
|
+
assert.equal('cover' in first, false)
|
|
187
|
+
assert.equal('coverUrl' in first, false)
|
|
188
|
+
assert.equal(normalizeRankingItem('motion', { title: '动态样本', tags: ['动态漫'] }).format, '动态漫')
|
|
189
|
+
})
|
|
190
|
+
|
|
191
|
+
test('跨榜单按作品键聚合并保留每个榜单观察和证据', () => {
|
|
192
|
+
const observations = normalizeRankings({
|
|
193
|
+
hot: [{ playletId: 'same', playletName: '同一部剧', ranking: 1, consumeNum: 100 }],
|
|
194
|
+
douyin: [{ playletId: 'same', name: '同一部剧', topNum: '4', playCountAddRaw: '200' }],
|
|
195
|
+
}, { observedAt: '2026-09-16T15:30:00+08:00' })
|
|
196
|
+
const merged = mergePlayletObservations(observations)
|
|
197
|
+
|
|
198
|
+
assert.equal(merged.length, 1)
|
|
199
|
+
assert.equal(merged[0].key, observations[0].key)
|
|
200
|
+
assert.equal(merged[0].observations.length, 2)
|
|
201
|
+
assert.deepEqual(merged[0].rankingTypes, ['hot', 'douyin'])
|
|
202
|
+
assert.deepEqual(merged[0].rankings.map(({ rankingType, ranking }) => ({ rankingType, ranking })), [
|
|
203
|
+
{ rankingType: 'hot', ranking: 1 },
|
|
204
|
+
{ rankingType: 'douyin', ranking: 4 },
|
|
205
|
+
])
|
|
206
|
+
assert.equal(merged[0].rankings[1].provenance.rankingType, 'douyin')
|
|
207
|
+
})
|
|
208
|
+
|
|
209
|
+
test('合并结果是与输入及其他结果隔离的深快照', () => {
|
|
210
|
+
const observations = normalizeRankings({ hot: [{ playletId: 'copy', title: '快照作品', tags: ['悬疑'], company: ['公司'] }] })
|
|
211
|
+
const merged = mergePlayletObservations(observations)
|
|
212
|
+
const other = mergePlayletObservations(observations)
|
|
213
|
+
|
|
214
|
+
merged[0].observations[0].topics.push('被修改')
|
|
215
|
+
merged[0].observations[0].provenance.evidence.rawTags.push('被修改')
|
|
216
|
+
merged[0].rankings[0].provenance.evidence.titleKeywords.push('被修改')
|
|
217
|
+
merged[0].companies.producer.push('被修改')
|
|
218
|
+
|
|
219
|
+
assert.deepEqual(observations[0].topics, ['悬疑推理'])
|
|
220
|
+
assert.deepEqual(observations[0].provenance.evidence.rawTags, ['悬疑'])
|
|
221
|
+
assert.deepEqual(other[0].observations[0].provenance.evidence.rawTags, ['悬疑'])
|
|
222
|
+
assert.deepEqual(other[0].companies, { platform: [], contractor: [], copyrightHolder: [], producer: ['公司'] })
|
|
223
|
+
})
|
|
224
|
+
|
|
225
|
+
test('公司归属按角色保留并记录原始证据引用', () => {
|
|
226
|
+
const item = normalizeRankingItem('hot', {
|
|
227
|
+
playletId: 7,
|
|
228
|
+
title: '角色样本',
|
|
229
|
+
platformList: [{ publisherName: '平台甲' }],
|
|
230
|
+
contractorCompany: ['承制乙'],
|
|
231
|
+
copyrightHolderList: [{ name: '版权丙' }],
|
|
232
|
+
producerList: [{ companyName: '制作丁' }],
|
|
233
|
+
}, { snapshotId: 'snapshot-1', observedAt: '2026-09-16T10:00:00+08:00' })
|
|
234
|
+
assert.deepEqual(item.companies, { platform: ['平台甲'], contractor: ['承制乙'], copyrightHolder: ['版权丙'], producer: ['制作丁'] })
|
|
235
|
+
assert.deepEqual(item.provenance.rawRef, { snapshotId: 'snapshot-1', rankingType: 'hot', playletId: 7 })
|
|
236
|
+
})
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
function isRecord(value) {
|
|
2
|
+
return value !== null && typeof value === 'object' && !Array.isArray(value)
|
|
3
|
+
}
|
|
4
|
+
|
|
5
|
+
function text(value, fallback = '—') {
|
|
6
|
+
if (value === null || value === undefined || value === '') return fallback
|
|
7
|
+
// 表格单元和列表项只能容纳行内文本,统一折叠换行符以免外部数据改变报告结构或注入新的块级 Markdown。
|
|
8
|
+
return String(value).replace(/[\r\n\u2028\u2029\t]+/gu, ' ').replace(/ {2,}/gu, ' ').trim()
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
function escapeMarkdown(value) {
|
|
12
|
+
return text(value).replace(/[\\`*_{}\[\]<>()[\]#+\-.!|]/gu, '\\$&')
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
function identifier(value) {
|
|
16
|
+
const source = text(value)
|
|
17
|
+
// 存储层限制过的标识可以用行内代码原样呈现,其他调用方传入的值仍按普通外部文本转义。
|
|
18
|
+
return /^[A-Za-z0-9+_-]{1,80}$/.test(source) ? `\`${source}\`` : escapeMarkdown(source)
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function percent(value) {
|
|
22
|
+
return typeof value === 'number' && Number.isFinite(value) ? `${(value * 100).toFixed(1)}%` : '—'
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function score(value) {
|
|
26
|
+
return typeof value === 'number' && Number.isFinite(value) ? value.toFixed(1) : '—'
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 将报告中的外部数据转成可安全展示的 Markdown;限制章节即使为空也保留,避免读者误把缺失字段理解为没有适用边界。
|
|
31
|
+
*/
|
|
32
|
+
export function renderMarketReportMarkdown(report) {
|
|
33
|
+
const source = isRecord(report) ? report : {}
|
|
34
|
+
const snapshotIds = Array.isArray(source.snapshot_ids) ? source.snapshot_ids : []
|
|
35
|
+
const metrics = Array.isArray(source.topic_metrics) ? source.topic_metrics : []
|
|
36
|
+
const limitations = Array.isArray(source.limitations) ? source.limitations : []
|
|
37
|
+
const coverage = isRecord(source.coverage) ? source.coverage : {}
|
|
38
|
+
const summary = isRecord(source.summary) ? source.summary : {}
|
|
39
|
+
const lines = [
|
|
40
|
+
'# 短剧市场报告',
|
|
41
|
+
'',
|
|
42
|
+
`- 报告 ID:${identifier(source.report_id)}`,
|
|
43
|
+
`- 生成时间:${escapeMarkdown(source.generated_at)}`,
|
|
44
|
+
`- 快照:${snapshotIds.length > 0 ? snapshotIds.map(identifier).join('、') : '—'}`,
|
|
45
|
+
'',
|
|
46
|
+
'## 覆盖范围',
|
|
47
|
+
'',
|
|
48
|
+
`- 样本数:${escapeMarkdown(coverage.sample_count)}`,
|
|
49
|
+
`- 成功榜单:${Array.isArray(coverage.successful_ranking_types) && coverage.successful_ranking_types.length > 0 ? coverage.successful_ranking_types.map(escapeMarkdown).join('、') : '—'}`,
|
|
50
|
+
`- 失败榜单:${Array.isArray(coverage.failed_ranking_types) && coverage.failed_ranking_types.length > 0 ? coverage.failed_ranking_types.map(escapeMarkdown).join('、') : '无'}`,
|
|
51
|
+
'',
|
|
52
|
+
'## 题材机会',
|
|
53
|
+
'',
|
|
54
|
+
'| 题材 | 机会分 | 供给 | 需求强度 | 增长强度 | 平台覆盖 | 置信度 |',
|
|
55
|
+
'| --- | ---: | ---: | ---: | ---: | ---: | --- |',
|
|
56
|
+
...metrics.map((metric) => `| ${escapeMarkdown(metric?.topic)} | ${score(metric?.opportunity_score)} | ${escapeMarkdown(metric?.supply_count)} | ${score(metric?.demand_strength)} | ${score(metric?.growth_strength)} | ${percent(metric?.platform_coverage)} | ${escapeMarkdown(metric?.confidence)} |`),
|
|
57
|
+
...(metrics.length === 0 ? ['| 暂无可分析题材 | — | — | — | — | — | — |'] : []),
|
|
58
|
+
'',
|
|
59
|
+
'## 方法说明',
|
|
60
|
+
'',
|
|
61
|
+
escapeMarkdown(summary.methodology),
|
|
62
|
+
'',
|
|
63
|
+
'## 限制与解读边界',
|
|
64
|
+
'',
|
|
65
|
+
...(limitations.length > 0 ? limitations.map((item) => `- ${escapeMarkdown(item)}`) : ['暂无额外限制说明。']),
|
|
66
|
+
'',
|
|
67
|
+
]
|
|
68
|
+
return lines.join('\n')
|
|
69
|
+
}
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs
ADDED
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
import { lstat, mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises'
|
|
2
|
+
import { realpathSync } from 'node:fs'
|
|
3
|
+
import { randomUUID } from 'node:crypto'
|
|
4
|
+
import { basename, dirname, resolve } from 'node:path'
|
|
5
|
+
import { isDeepStrictEqual } from 'node:util'
|
|
6
|
+
import { renderMarketReportMarkdown } from './report.mjs'
|
|
7
|
+
|
|
8
|
+
const ID_PATTERN = /^[A-Za-z0-9+_-]{1,80}$/
|
|
9
|
+
const REPORT_SCHEMA_VERSIONS = new Set(['market-report.v1', 'market-report.v2'])
|
|
10
|
+
const coordinators = new Map()
|
|
11
|
+
|
|
12
|
+
function isRecord(value) {
|
|
13
|
+
return value !== null && typeof value === 'object' && !Array.isArray(value)
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function assertId(value, field = 'ID') {
|
|
17
|
+
if (typeof value !== 'string' || !ID_PATTERN.test(value)) throw new Error(`${field} 无效`)
|
|
18
|
+
return value
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function jsonSnapshot(value, label) {
|
|
22
|
+
let serialized
|
|
23
|
+
try {
|
|
24
|
+
serialized = JSON.stringify(value)
|
|
25
|
+
} catch {
|
|
26
|
+
throw new Error(`${label} 必须是可序列化的 JSON 数据`)
|
|
27
|
+
}
|
|
28
|
+
if (serialized === undefined) throw new Error(`${label} 必须是可序列化的 JSON 数据`)
|
|
29
|
+
return JSON.parse(serialized)
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function isSnapshot(value, expectedId = null) {
|
|
33
|
+
if (!isRecord(value) || value.schema_version !== 1 || !isRecord(value.rankings)) return false
|
|
34
|
+
try {
|
|
35
|
+
assertId(value.snapshot_id, 'snapshot ID')
|
|
36
|
+
} catch {
|
|
37
|
+
return false
|
|
38
|
+
}
|
|
39
|
+
return expectedId === null || value.snapshot_id === expectedId
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function isReport(value, expectedId = null) {
|
|
43
|
+
if (!isRecord(value) || !REPORT_SCHEMA_VERSIONS.has(value.schema_version) || !Array.isArray(value.snapshot_ids) || value.snapshot_ids.length === 0) return false
|
|
44
|
+
try {
|
|
45
|
+
assertId(value.report_id, 'report ID')
|
|
46
|
+
for (const snapshotId of value.snapshot_ids) assertId(snapshotId, 'snapshot ID')
|
|
47
|
+
} catch {
|
|
48
|
+
return false
|
|
49
|
+
}
|
|
50
|
+
return expectedId === null || value.report_id === expectedId
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function normalizeSnapshot(snapshot) {
|
|
54
|
+
if (!isSnapshot(snapshot)) throw new Error('快照合同无效')
|
|
55
|
+
return snapshot
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function normalizeReport(report) {
|
|
59
|
+
if (!isReport(report)) throw new Error('报告合同无效')
|
|
60
|
+
return report
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function canonicalRoot(workspaceRoot) {
|
|
64
|
+
const resolved = resolve(workspaceRoot)
|
|
65
|
+
try {
|
|
66
|
+
return realpathSync(resolved)
|
|
67
|
+
} catch {
|
|
68
|
+
return resolved
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function coordinatorFor(root) {
|
|
73
|
+
if (!coordinators.has(root)) coordinators.set(root, { tail: Promise.resolve() })
|
|
74
|
+
return coordinators.get(root)
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function enqueue(coordinator, task) {
|
|
78
|
+
// 同一工作区按调用顺序串行完成整个写入事务,避免报告双文件或索引 read-modify-write 在 await 间交错。
|
|
79
|
+
const result = coordinator.tail.then(task, task)
|
|
80
|
+
coordinator.tail = result.catch(() => undefined)
|
|
81
|
+
return result
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function timestamp(value, field) {
|
|
85
|
+
const parsed = Date.parse(value?.[field])
|
|
86
|
+
return Number.isFinite(parsed) ? parsed : null
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function newest(values, idField, timeField) {
|
|
90
|
+
return [...values].sort((left, right) => {
|
|
91
|
+
const leftTime = timestamp(left, timeField)
|
|
92
|
+
const rightTime = timestamp(right, timeField)
|
|
93
|
+
if (leftTime !== null && rightTime !== null && leftTime !== rightTime) return rightTime - leftTime
|
|
94
|
+
if (leftTime !== null && rightTime === null) return -1
|
|
95
|
+
if (leftTime === null && rightTime !== null) return 1
|
|
96
|
+
return String(right[idField]).localeCompare(String(left[idField]), 'en')
|
|
97
|
+
})[0] ?? null
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
async function lstatOrNull(path) {
|
|
101
|
+
try {
|
|
102
|
+
return await lstat(path)
|
|
103
|
+
} catch (error) {
|
|
104
|
+
if (error?.code === 'ENOENT') return null
|
|
105
|
+
throw error
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
async function safePath(path, label) {
|
|
110
|
+
const status = await lstatOrNull(path)
|
|
111
|
+
if (status?.isSymbolicLink()) throw new Error(`${label} 禁止使用符号链接`)
|
|
112
|
+
return status
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
async function ensureDirectory(path, label, create) {
|
|
116
|
+
let status = await safePath(path, label)
|
|
117
|
+
if (!status) {
|
|
118
|
+
if (!create) return false
|
|
119
|
+
await mkdir(path, { recursive: true })
|
|
120
|
+
status = await safePath(path, label)
|
|
121
|
+
}
|
|
122
|
+
if (!status?.isDirectory()) throw new Error(`${label} 必须是目录`)
|
|
123
|
+
return true
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
async function readJsonFile(path, label) {
|
|
127
|
+
const status = await safePath(path, label)
|
|
128
|
+
if (!status) return null
|
|
129
|
+
if (!status.isFile()) throw new Error(`${label} 必须是文件`)
|
|
130
|
+
try {
|
|
131
|
+
return JSON.parse(await readFile(path, 'utf8'))
|
|
132
|
+
} catch (error) {
|
|
133
|
+
if (error instanceof SyntaxError) return null
|
|
134
|
+
throw error
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
async function readTextFile(path, label) {
|
|
139
|
+
const status = await safePath(path, label)
|
|
140
|
+
if (!status) return null
|
|
141
|
+
if (!status.isFile()) throw new Error(`${label} 必须是文件`)
|
|
142
|
+
return readFile(path, 'utf8')
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
async function writeAtomically(path, value, label, renameFile = rename) {
|
|
146
|
+
const target = await safePath(path, label)
|
|
147
|
+
if (target && !target.isFile()) throw new Error(`${label} 必须是文件`)
|
|
148
|
+
const temporary = resolve(dirname(path), `.${basename(path)}.tmp-${process.pid}-${randomUUID()}`)
|
|
149
|
+
try {
|
|
150
|
+
await writeFile(temporary, value, 'utf8')
|
|
151
|
+
await renameFile(temporary, path)
|
|
152
|
+
} finally {
|
|
153
|
+
// rename 失败时主动回收同目录临时文件,避免恢复扫描把残留写入误判为业务数据。
|
|
154
|
+
await rm(temporary, { force: true }).catch(() => undefined)
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function reportStorageError(code, message) {
|
|
159
|
+
const error = new Error(`${code}: ${message}`)
|
|
160
|
+
error.code = code
|
|
161
|
+
return error
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
export function createMarketStore(workspaceRoot, { renameFile = rename } = {}) {
|
|
165
|
+
const root = canonicalRoot(workspaceRoot)
|
|
166
|
+
const coordinator = coordinatorFor(root)
|
|
167
|
+
const marketRoot = resolve(root, '.short-drama-market')
|
|
168
|
+
const indexPath = resolve(marketRoot, 'index.json')
|
|
169
|
+
const snapshotPath = (snapshotId) => resolve(marketRoot, 'snapshots', `${assertId(snapshotId, 'snapshot ID')}.json`)
|
|
170
|
+
const reportPath = (reportId, extension = 'json') => resolve(marketRoot, 'reports', `${assertId(reportId, 'report ID')}.${extension}`)
|
|
171
|
+
|
|
172
|
+
async function ensureMarketRoot(create) {
|
|
173
|
+
return ensureDirectory(marketRoot, '市场存储目录', create)
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
async function ensureDataDirectory(name, create) {
|
|
177
|
+
if (!await ensureMarketRoot(create)) return false
|
|
178
|
+
return ensureDirectory(resolve(marketRoot, name), `${name} 目录`, create)
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
async function readIndex() {
|
|
182
|
+
if (!await ensureMarketRoot(false)) return null
|
|
183
|
+
const index = await readJsonFile(indexPath, '市场索引文件')
|
|
184
|
+
return isRecord(index) ? index : null
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
async function readSnapshot(snapshotId) {
|
|
188
|
+
assertId(snapshotId, 'snapshot ID')
|
|
189
|
+
if (!await ensureDataDirectory('snapshots', false)) return null
|
|
190
|
+
const snapshot = await readJsonFile(snapshotPath(snapshotId), '快照文件')
|
|
191
|
+
return isSnapshot(snapshot, snapshotId) ? snapshot : null
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
async function readReport(reportId) {
|
|
195
|
+
assertId(reportId, 'report ID')
|
|
196
|
+
if (!await ensureDataDirectory('reports', false)) return null
|
|
197
|
+
const report = await readJsonFile(reportPath(reportId), '报告文件')
|
|
198
|
+
return isReport(report, reportId) ? report : null
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
async function readReportMarkdown(reportId) {
|
|
202
|
+
assertId(reportId, 'report ID')
|
|
203
|
+
if (!await ensureDataDirectory('reports', false)) return null
|
|
204
|
+
return readTextFile(reportPath(reportId, 'md'), '报告 Markdown 文件')
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
async function collectSnapshots() {
|
|
208
|
+
const directory = resolve(marketRoot, 'snapshots')
|
|
209
|
+
if (!await ensureDataDirectory('snapshots', false)) return []
|
|
210
|
+
const entries = await readdir(directory, { withFileTypes: true })
|
|
211
|
+
const snapshots = []
|
|
212
|
+
for (const entry of entries) {
|
|
213
|
+
if (!entry.isFile() || !entry.name.endsWith('.json')) continue
|
|
214
|
+
const snapshotId = entry.name.slice(0, -'.json'.length)
|
|
215
|
+
if (!ID_PATTERN.test(snapshotId)) continue
|
|
216
|
+
try {
|
|
217
|
+
const snapshot = await readJsonFile(resolve(directory, entry.name), '快照文件')
|
|
218
|
+
if (isSnapshot(snapshot, snapshotId)) snapshots.push(snapshot)
|
|
219
|
+
} catch (error) {
|
|
220
|
+
// 扫描恢复只跳过单个异常候选;显式 readSnapshot 仍会将符号链接作为边界错误返回给调用方。
|
|
221
|
+
if (!/符号链接/u.test(error.message)) throw error
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
return snapshots
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
async function collectReports() {
|
|
228
|
+
const directory = resolve(marketRoot, 'reports')
|
|
229
|
+
if (!await ensureDataDirectory('reports', false)) return []
|
|
230
|
+
const entries = await readdir(directory, { withFileTypes: true })
|
|
231
|
+
const reports = []
|
|
232
|
+
for (const entry of entries) {
|
|
233
|
+
if (!entry.isFile() || !entry.name.endsWith('.json')) continue
|
|
234
|
+
const reportId = entry.name.slice(0, -'.json'.length)
|
|
235
|
+
if (!ID_PATTERN.test(reportId)) continue
|
|
236
|
+
try {
|
|
237
|
+
const report = await readJsonFile(resolve(directory, entry.name), '报告文件')
|
|
238
|
+
if (isReport(report, reportId)) reports.push(report)
|
|
239
|
+
} catch (error) {
|
|
240
|
+
if (!/符号链接/u.test(error.message)) throw error
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
return reports
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
async function rebuildIndex() {
|
|
247
|
+
const [snapshots, reports] = await Promise.all([collectSnapshots(), collectReports()])
|
|
248
|
+
const latestSnapshot = newest(snapshots, 'snapshot_id', 'retrieved_at')
|
|
249
|
+
const latestReport = newest(reports, 'report_id', 'generated_at')
|
|
250
|
+
const index = { schema_version: 1 }
|
|
251
|
+
if (latestSnapshot) index.latest_snapshot_id = latestSnapshot.snapshot_id
|
|
252
|
+
if (latestReport) index.latest_report_id = latestReport.report_id
|
|
253
|
+
return index
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
async function refreshIndex() {
|
|
257
|
+
const [stored, rebuilt] = await Promise.all([readIndex(), rebuildIndex()])
|
|
258
|
+
// 索引缺失或损坏时完全以磁盘有效历史恢复;有效索引的扩展字段则保留,但最新指针始终由完整历史重算。
|
|
259
|
+
const next = { ...(stored ?? {}), ...rebuilt, schema_version: 1 }
|
|
260
|
+
if (!rebuilt.latest_snapshot_id) delete next.latest_snapshot_id
|
|
261
|
+
if (!rebuilt.latest_report_id) delete next.latest_report_id
|
|
262
|
+
await ensureMarketRoot(true)
|
|
263
|
+
await writeAtomically(indexPath, `${JSON.stringify(next, null, 2)}\n`, '市场索引文件')
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
async function existingReportState(source) {
|
|
267
|
+
const jsonPath = reportPath(source.report_id)
|
|
268
|
+
const markdownPath = reportPath(source.report_id, 'md')
|
|
269
|
+
const [jsonStatus, markdownStatus] = await Promise.all([
|
|
270
|
+
safePath(jsonPath, '报告文件'),
|
|
271
|
+
safePath(markdownPath, '报告 Markdown 文件'),
|
|
272
|
+
])
|
|
273
|
+
if (jsonStatus && !jsonStatus.isFile()) throw reportStorageError('MARKET_REPORT_CORRUPT', `报告 ${source.report_id} 的 JSON 产物不是文件,请修复后重试`)
|
|
274
|
+
if (markdownStatus && !markdownStatus.isFile()) throw reportStorageError('MARKET_REPORT_CORRUPT', `报告 ${source.report_id} 的 Markdown 产物不是文件,请修复后重试`)
|
|
275
|
+
if (!jsonStatus && !markdownStatus) return 'absent'
|
|
276
|
+
if (!jsonStatus || !markdownStatus) throw reportStorageError('MARKET_REPORT_CORRUPT', `报告 ${source.report_id} 仅存在单边产物,请修复或移除不完整产物后重试`)
|
|
277
|
+
const [stored, markdown] = await Promise.all([
|
|
278
|
+
readJsonFile(jsonPath, '报告文件'),
|
|
279
|
+
readTextFile(markdownPath, '报告 Markdown 文件'),
|
|
280
|
+
])
|
|
281
|
+
if (!isReport(stored, source.report_id)) throw reportStorageError('MARKET_REPORT_CORRUPT', `报告 ${source.report_id} 的 JSON 合同无效,请修复后重试`)
|
|
282
|
+
if (!isDeepStrictEqual(stored, source)) throw reportStorageError('MARKET_REPORT_CONFLICT', `报告 ${source.report_id} 已绑定不同内容,不能覆盖`)
|
|
283
|
+
if (markdown !== renderMarketReportMarkdown(stored)) throw reportStorageError('MARKET_REPORT_CORRUPT', `报告 ${source.report_id} 的 JSON 与 Markdown 不一致,请修复后重试`)
|
|
284
|
+
return 'idempotent'
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
function saveSnapshot(snapshot) {
|
|
288
|
+
const source = normalizeSnapshot(jsonSnapshot(snapshot, '快照'))
|
|
289
|
+
return enqueue(coordinator, async () => {
|
|
290
|
+
// rankings 的键代表实际成功返回的榜单;完全失败时不留下会被误当成可分析样本的快照。
|
|
291
|
+
if (Object.keys(source.rankings).length === 0) return null
|
|
292
|
+
await ensureDataDirectory('snapshots', true)
|
|
293
|
+
const path = snapshotPath(source.snapshot_id)
|
|
294
|
+
const status = await safePath(path, '快照文件')
|
|
295
|
+
if (status) {
|
|
296
|
+
if (!status.isFile()) throw reportStorageError('MARKET_SNAPSHOT_CORRUPT', `快照 ${source.snapshot_id} 不是文件`)
|
|
297
|
+
const stored = await readJsonFile(path, '快照文件')
|
|
298
|
+
if (!isSnapshot(stored, source.snapshot_id)) throw reportStorageError('MARKET_SNAPSHOT_CORRUPT', `快照 ${source.snapshot_id} 合同无效`)
|
|
299
|
+
if (!isDeepStrictEqual(stored, source)) throw reportStorageError('MARKET_SNAPSHOT_CONFLICT', `快照 ${source.snapshot_id} 已绑定不同内容,不能覆盖`)
|
|
300
|
+
return source
|
|
301
|
+
}
|
|
302
|
+
await writeAtomically(path, `${JSON.stringify(source, null, 2)}\n`, '快照文件')
|
|
303
|
+
await refreshIndex()
|
|
304
|
+
return source
|
|
305
|
+
})
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
function saveReport(report) {
|
|
309
|
+
const source = normalizeReport(jsonSnapshot(report, '报告'))
|
|
310
|
+
return enqueue(coordinator, async () => {
|
|
311
|
+
await ensureDataDirectory('reports', true)
|
|
312
|
+
const state = await existingReportState(source)
|
|
313
|
+
if (state === 'idempotent') return source
|
|
314
|
+
const markdown = renderMarketReportMarkdown(source)
|
|
315
|
+
// 同一队列内先落 Markdown、再暴露 JSON,随后更新索引;同 report_id 的调用以调用顺序完成,最终产物同源。
|
|
316
|
+
await writeAtomically(reportPath(source.report_id, 'md'), markdown, '报告 Markdown 文件', renameFile)
|
|
317
|
+
await writeAtomically(reportPath(source.report_id), `${JSON.stringify(source, null, 2)}\n`, '报告文件', renameFile)
|
|
318
|
+
await refreshIndex()
|
|
319
|
+
return source
|
|
320
|
+
})
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
async function listHistory() {
|
|
324
|
+
return (await collectReports()).sort((left, right) => {
|
|
325
|
+
const selected = newest([left, right], 'report_id', 'generated_at')
|
|
326
|
+
return selected === left ? -1 : selected === right ? 1 : 0
|
|
327
|
+
})
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
async function readLatest() {
|
|
331
|
+
// 先检查索引路径边界;恢复结果只使用逐个验证后的磁盘候选,不信任损坏或陈旧索引的指针。
|
|
332
|
+
await readIndex()
|
|
333
|
+
const [snapshots, reports] = await Promise.all([collectSnapshots(), collectReports()])
|
|
334
|
+
return {
|
|
335
|
+
latestSnapshot: newest(snapshots, 'snapshot_id', 'retrieved_at'),
|
|
336
|
+
latestReport: newest(reports, 'report_id', 'generated_at'),
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
return { saveSnapshot, saveReport, readSnapshot, readReport, readReportMarkdown, readLatest, listHistory }
|
|
341
|
+
}
|