mirror of
https://github.com/panatgithub/AnkiHeadingSync.git
synced 2026-07-22 17:10:28 +00:00
472011c32f
中文: 修复 QA Group 同步链路中的多处稳定性问题，包括可点击回链、丢失 noteId 时自动重建、避免在未指定目标 deck 时误调用 changeDeck，以及统一设置页 note type 下拉行为。 English: Fix multiple QA Group stability issues, including clickable backlinks, self-healing recreation when stored noteIds are missing, skipping changeDeck when no target deck is provided, and unifying note type dropdown behavior in settings.
783 lines
29 KiB
TypeScript
783 lines
29 KiB
TypeScript
import { PluginSettingTab, Setting } from "obsidian";
|
||
|
||
import { isValidHashtagMarker, isValidSemanticQaMarker, type FileDeckInsertLocation, type FolderDeckMode, type ScopeMode } from "@/application/config/PluginSettings";
|
||
import { createNoteFieldMappingKey, type NoteModelFieldMapping } from "@/application/config/NoteModelFieldMapping";
|
||
import type { FolderTreeNode } from "@/application/dto/FolderTreeNode";
|
||
import type { NoteModelDetails } from "@/application/dto/NoteModelDetails";
|
||
import { NoteFieldMappingService } from "@/application/services/NoteFieldMappingService";
|
||
import { buildQaGroupModelDefinition } from "@/application/services/QaGroupModelDefinition";
|
||
import type { CardType } from "@/domain/card/entities/RenderedFields";
|
||
import { SemanticQaListParser } from "@/domain/manual-sync/services/SemanticQaListParser";
|
||
import type AnkiHeadingSyncPlugin from "@/presentation/AnkiHeadingSyncPlugin";
|
||
|
||
import { buildFolderTreeSelection, toggleFolderTreeSelection, type FolderTreeSelectionNode } from "./FolderScopeTree";
|
||
|
||
const NOTE_TYPE_STATUS_IDLE = "Refresh note types from Anki to load the available note types.";
|
||
const FOLDER_TREE_STATUS_LOADING = "正在读取当前 vault 文件夹...";
|
||
|
||
interface MappingSectionConfig {
|
||
cardType: CardType;
|
||
title: string;
|
||
description: string;
|
||
}
|
||
|
||
type SimpleDropdown = {
|
||
addOption(value: string, label: string): unknown;
|
||
setValue(value: string): unknown;
|
||
onChange(callback: (value: string) => void): unknown;
|
||
};
|
||
|
||
export class AnkiHeadingSyncSettingTab extends PluginSettingTab {
|
||
private readonly noteFieldMappingService = new NoteFieldMappingService();
|
||
private readonly semanticQaListParser = new SemanticQaListParser();
|
||
private availableNoteModels: string[] = [];
|
||
private noteTypeStatus = NOTE_TYPE_STATUS_IDLE;
|
||
private readonly draftMappings: Record<string, NoteModelFieldMapping> = {};
|
||
private readonly loadedModelDetails: Record<string, NoteModelDetails> = {};
|
||
private readonly sectionStatuses: Partial<Record<CardType, string>> = {};
|
||
private folderTree: FolderTreeNode[] = [];
|
||
private folderTreeStatus = FOLDER_TREE_STATUS_LOADING;
|
||
private folderTreeLoadPromise: Promise<void> | null = null;
|
||
private hasLoadedFolderTree = false;
|
||
private readonly expandedFolderPaths = new Set<string>();
|
||
|
||
constructor(plugin: AnkiHeadingSyncPlugin) {
|
||
super(plugin.app, plugin);
|
||
this.plugin = plugin;
|
||
}
|
||
|
||
declare plugin: AnkiHeadingSyncPlugin;
|
||
|
||
hide(): void {
|
||
super.hide();
|
||
this.hasLoadedFolderTree = false;
|
||
this.expandedFolderPaths.clear();
|
||
}
|
||
|
||
display(): void {
|
||
const { containerEl } = this;
|
||
const settings = this.plugin.settings;
|
||
|
||
containerEl.empty();
|
||
containerEl.createEl("h2", { text: "Anki Heading Sync" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("AnkiConnect URL")
|
||
.setDesc("Default is http://127.0.0.1:8765")
|
||
.addText((text) => {
|
||
text.setPlaceholder("http://127.0.0.1:8765").setValue(settings.ankiConnectUrl).onChange((value) => {
|
||
void this.plugin.updateSettings({ ankiConnectUrl: value.trim() || settings.ankiConnectUrl });
|
||
});
|
||
});
|
||
|
||
this.renderDeckSection(containerEl, settings);
|
||
|
||
new Setting(containerEl)
|
||
.setName("QA heading level")
|
||
.setDesc("Default is H4")
|
||
.addDropdown((dropdown) => {
|
||
for (let level = 1; level <= 6; level += 1) {
|
||
dropdown.addOption(String(level), `H${level}`);
|
||
}
|
||
|
||
dropdown.setValue(String(settings.qaHeadingLevel)).onChange((value) => {
|
||
void this.plugin.updateSettings({ qaHeadingLevel: Number(value) });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName("Cloze heading level")
|
||
.setDesc("Default is H5")
|
||
.addDropdown((dropdown) => {
|
||
for (let level = 1; level <= 6; level += 1) {
|
||
dropdown.addOption(String(level), `H${level}`);
|
||
}
|
||
|
||
dropdown.setValue(String(settings.clozeHeadingLevel)).onChange((value) => {
|
||
void this.plugin.updateSettings({ clozeHeadingLevel: Number(value) });
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("h3", { text: "QA Group 12" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("QA Group marker")
|
||
.setDesc("When a QA heading ends with this hashtag marker, the whole heading block syncs as one ObsiAnki QA Group 12 note.")
|
||
.addText((text) => {
|
||
text.setPlaceholder("#anki-list").setValue(settings.qaGroupMarker).onChange(async (value) => {
|
||
const nextValue = value.trim();
|
||
if (!nextValue || !isValidHashtagMarker(nextValue) || nextValue === settings.semanticQaMarker) {
|
||
return;
|
||
}
|
||
|
||
await this.plugin.updateSettings({ qaGroupMarker: nextValue });
|
||
});
|
||
});
|
||
|
||
this.renderQaGroupModelStatus(containerEl);
|
||
|
||
containerEl.createEl("h3", { text: "Semantic QA" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("Semantic QA marker")
|
||
.setDesc("When a QA heading ends with this hashtag marker, first-level list items with indented child content become separate cards.")
|
||
.addText((text) => {
|
||
text.setPlaceholder("#anki-list-qa").setValue(settings.semanticQaMarker).onChange(async (value) => {
|
||
const nextValue = value.trim();
|
||
if (!nextValue || !isValidSemanticQaMarker(nextValue)) {
|
||
return;
|
||
}
|
||
|
||
await this.plugin.updateSettings({ semanticQaMarker: nextValue });
|
||
this.display();
|
||
});
|
||
});
|
||
|
||
this.renderSemanticQaPreview(containerEl, settings.semanticQaMarker);
|
||
|
||
this.renderScopeSection(containerEl, settings);
|
||
|
||
new Setting(containerEl)
|
||
.setName("Add Obsidian backlink")
|
||
.setDesc("Append a backlink to the source heading into synced cards.")
|
||
.addToggle((toggle) => {
|
||
toggle.setValue(settings.addObsidianBacklink).onChange((value) => {
|
||
void this.plugin.updateSettings({ addObsidianBacklink: value });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName("Highlights to Cloze")
|
||
.setDesc("Convert ==highlight== segments into cloze deletions for cloze cards.")
|
||
.addToggle((toggle) => {
|
||
toggle.setValue(settings.convertHighlightsToCloze).onChange((value) => {
|
||
void this.plugin.updateSettings({ convertHighlightsToCloze: value });
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("h3", { text: "Note type field mappings" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("Refresh note types from Anki")
|
||
.setDesc(this.noteTypeStatus)
|
||
.addButton((button) => {
|
||
button.setButtonText("Refresh note types").onClick(() => {
|
||
void this.refreshNoteTypes();
|
||
});
|
||
});
|
||
|
||
this.renderMappingSection(containerEl, {
|
||
cardType: "basic",
|
||
title: "QA / Basic",
|
||
description: "Choose the QA note type, read its fields from Anki, then confirm the title/body mapping.",
|
||
});
|
||
this.renderMappingSection(containerEl, {
|
||
cardType: "cloze",
|
||
title: "Cloze",
|
||
description: "Choose the cloze note type, read its fields from Anki, then confirm the main field mapping.",
|
||
});
|
||
this.renderMappingSection(containerEl, {
|
||
cardType: "semantic-qa",
|
||
title: "Semantic QA",
|
||
description: "Choose the semantic QA note type, read its fields from Anki, then confirm the title/body mapping for child cards.",
|
||
});
|
||
}
|
||
|
||
private renderMappingSection(containerEl: HTMLElement, config: MappingSectionConfig): void {
|
||
const selectedModelName = this.getSelectedMappingNoteType(config.cardType);
|
||
const mappingKey = createNoteFieldMappingKey(config.cardType, selectedModelName);
|
||
const currentMapping = this.getCurrentMapping(mappingKey);
|
||
|
||
containerEl.createEl("h4", { text: config.title });
|
||
containerEl.createEl("p", { text: config.description });
|
||
|
||
new Setting(containerEl)
|
||
.setName(`${config.title} note type`)
|
||
.setDesc("Loaded from Anki note types. Refresh if the latest models are not shown.")
|
||
.addDropdown((dropdown) => {
|
||
for (const noteModel of this.getSelectableNoteModels(config.cardType, selectedModelName)) {
|
||
dropdown.addOption(noteModel, noteModel);
|
||
}
|
||
|
||
dropdown.setValue(selectedModelName).onChange((value) => {
|
||
void this.updateSelectedNoteType(config.cardType, value);
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName(`${config.title} fields`)
|
||
.setDesc("Load the current note type fields from Anki, then review the suggested mapping.")
|
||
.addButton((button) => {
|
||
button.setButtonText("Read fields from Anki").onClick(() => {
|
||
void this.loadFieldsFromAnki(config.cardType);
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("p", {
|
||
text:
|
||
currentMapping?.loadedFieldNames.length
|
||
? `Loaded fields: ${currentMapping.loadedFieldNames.join(", ")}`
|
||
: "Loaded fields: none. Read fields from Anki first.",
|
||
});
|
||
|
||
if (config.cardType === "cloze") {
|
||
this.renderClozeFieldSelector(containerEl, selectedModelName, currentMapping);
|
||
} else {
|
||
this.renderBasicFieldSelectors(containerEl, selectedModelName, currentMapping, config.title);
|
||
}
|
||
|
||
new Setting(containerEl)
|
||
.setName(`${config.title} mapping`)
|
||
.setDesc("Save the current field mapping for this specific note type.")
|
||
.addButton((button) => {
|
||
button.setButtonText("Save mapping").onClick(() => {
|
||
void this.saveMapping(config.cardType);
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("p", {
|
||
text:
|
||
this.sectionStatuses[config.cardType] ??
|
||
(this.plugin.settings.noteFieldMappings[mappingKey]
|
||
? `Saved mapping is ready for ${config.title}.`
|
||
: `No saved mapping for ${config.title}. Read fields from Anki first.`),
|
||
});
|
||
}
|
||
|
||
private renderBasicFieldSelectors(
|
||
containerEl: HTMLElement,
|
||
selectedModelName: string,
|
||
mapping: NoteModelFieldMapping | undefined,
|
||
sectionTitle: string,
|
||
): void {
|
||
const fieldNames = mapping?.loadedFieldNames ?? [];
|
||
|
||
new Setting(containerEl)
|
||
.setName(`${sectionTitle} title field`)
|
||
.setDesc("Which Anki field should receive the heading/title fragment.")
|
||
.addDropdown((dropdown) => {
|
||
this.populateFieldDropdown(dropdown, fieldNames, mapping?.titleField);
|
||
dropdown.onChange((value) => {
|
||
this.updateDraftMapping(mapping?.cardType ?? inferBasicLikeCardType(sectionTitle), selectedModelName, { titleField: value || undefined });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName(`${sectionTitle} body field`)
|
||
.setDesc("Which Anki field should receive the body fragment.")
|
||
.addDropdown((dropdown) => {
|
||
this.populateFieldDropdown(dropdown, fieldNames, mapping?.bodyField);
|
||
dropdown.onChange((value) => {
|
||
this.updateDraftMapping(mapping?.cardType ?? inferBasicLikeCardType(sectionTitle), selectedModelName, { bodyField: value || undefined });
|
||
});
|
||
});
|
||
}
|
||
|
||
private renderClozeFieldSelector(
|
||
containerEl: HTMLElement,
|
||
selectedModelName: string,
|
||
mapping: NoteModelFieldMapping | undefined,
|
||
): void {
|
||
const fieldNames = mapping?.loadedFieldNames ?? [];
|
||
|
||
new Setting(containerEl)
|
||
.setName("Cloze main field")
|
||
.setDesc("The selected field receives title + <br><br> + body during sync.")
|
||
.addDropdown((dropdown) => {
|
||
this.populateFieldDropdown(dropdown, fieldNames, mapping?.mainField);
|
||
dropdown.onChange((value) => {
|
||
this.updateDraftMapping("cloze", selectedModelName, { mainField: value || undefined });
|
||
});
|
||
});
|
||
}
|
||
|
||
private populateFieldDropdown(dropdown: SimpleDropdown, fieldNames: string[], selectedValue: string | undefined): void {
|
||
dropdown.addOption("", "-- Select field --");
|
||
|
||
for (const fieldName of fieldNames) {
|
||
dropdown.addOption(fieldName, fieldName);
|
||
}
|
||
|
||
dropdown.setValue(selectedValue ?? "");
|
||
}
|
||
|
||
private async refreshNoteTypes(): Promise<void> {
|
||
try {
|
||
const noteModels = await this.plugin.listNoteModels();
|
||
this.availableNoteModels = [...noteModels].sort((left, right) => left.localeCompare(right));
|
||
this.noteTypeStatus =
|
||
this.availableNoteModels.length > 0
|
||
? `Loaded ${this.availableNoteModels.length} note types from Anki.`
|
||
: "Anki returned no note types.";
|
||
} catch (error) {
|
||
this.noteTypeStatus = error instanceof Error ? error.message : "Failed to load note types from Anki.";
|
||
}
|
||
|
||
this.display();
|
||
}
|
||
|
||
private async updateSelectedNoteType(cardType: CardType, modelName: string): Promise<void> {
|
||
if (cardType === "basic") {
|
||
await this.plugin.updateSettings({ qaNoteType: modelName });
|
||
} else if (cardType === "cloze") {
|
||
await this.plugin.updateSettings({ clozeNoteType: modelName });
|
||
} else {
|
||
await this.plugin.updateSettings({ semanticQaNoteType: modelName });
|
||
}
|
||
|
||
const mappingKey = createNoteFieldMappingKey(cardType, modelName);
|
||
this.sectionStatuses[cardType] = this.plugin.settings.noteFieldMappings[mappingKey]
|
||
? `Loaded saved mapping for ${modelName}.`
|
||
: `Selected ${modelName}. Read fields from Anki to create or refresh its mapping.`;
|
||
this.display();
|
||
}
|
||
|
||
private async loadFieldsFromAnki(cardType: CardType): Promise<void> {
|
||
const modelName = this.getSelectedMappingNoteType(cardType);
|
||
|
||
try {
|
||
const modelDetails = await this.plugin.getNoteModelDetails(modelName);
|
||
const mapping = this.noteFieldMappingService.suggest(cardType, modelName, modelDetails.fieldNames);
|
||
const mappingKey = createNoteFieldMappingKey(cardType, modelName);
|
||
|
||
this.draftMappings[mappingKey] = mapping;
|
||
this.loadedModelDetails[mappingKey] = modelDetails;
|
||
this.sectionStatuses[cardType] = `Loaded fields for ${modelName}. Review the suggested mapping and save it.`;
|
||
} catch (error) {
|
||
this.sectionStatuses[cardType] = error instanceof Error ? error.message : `Failed to load fields for ${modelName}.`;
|
||
}
|
||
|
||
this.display();
|
||
}
|
||
|
||
private async saveMapping(cardType: CardType): Promise<void> {
|
||
const modelName = this.getSelectedMappingNoteType(cardType);
|
||
const mappingKey = createNoteFieldMappingKey(cardType, modelName);
|
||
const mapping = this.getCurrentMapping(mappingKey);
|
||
|
||
if (!mapping) {
|
||
this.sectionStatuses[cardType] = `No loaded fields for ${modelName}. Read fields from Anki first.`;
|
||
this.display();
|
||
return;
|
||
}
|
||
|
||
try {
|
||
this.noteFieldMappingService.validateMapping(mapping, this.loadedModelDetails[mappingKey] ?? {
|
||
fieldNames: mapping.loadedFieldNames,
|
||
isCloze: cardType === "cloze",
|
||
});
|
||
|
||
await this.plugin.updateSettings({
|
||
noteFieldMappings: {
|
||
...this.plugin.settings.noteFieldMappings,
|
||
[mappingKey]: {
|
||
...mapping,
|
||
loadedFieldNames: [...mapping.loadedFieldNames],
|
||
},
|
||
},
|
||
});
|
||
|
||
this.sectionStatuses[cardType] = `Saved mapping for ${modelName}.`;
|
||
} catch (error) {
|
||
this.sectionStatuses[cardType] = error instanceof Error ? error.message : `Failed to save mapping for ${modelName}.`;
|
||
}
|
||
|
||
this.display();
|
||
}
|
||
|
||
private getSelectableNoteModels(cardType: CardType, selectedModelName: string): string[] {
|
||
void cardType;
|
||
const noteModels = this.getSelectableMappingNoteModels();
|
||
|
||
if (!noteModels.includes(selectedModelName)) {
|
||
noteModels.unshift(selectedModelName);
|
||
}
|
||
|
||
return noteModels;
|
||
}
|
||
|
||
private getSelectableMappingNoteModels(): string[] {
|
||
return this.availableNoteModels.length > 0 ? [...this.availableNoteModels] : [];
|
||
}
|
||
|
||
private updateDraftMapping(
|
||
cardType: CardType,
|
||
modelName: string,
|
||
partialMapping: Partial<NoteModelFieldMapping>,
|
||
): void {
|
||
const mappingKey = createNoteFieldMappingKey(cardType, modelName);
|
||
const currentMapping = this.getCurrentMapping(mappingKey);
|
||
|
||
if (!currentMapping) {
|
||
return;
|
||
}
|
||
|
||
this.draftMappings[mappingKey] = {
|
||
...currentMapping,
|
||
...partialMapping,
|
||
};
|
||
}
|
||
|
||
private getCurrentMapping(mappingKey: string): NoteModelFieldMapping | undefined {
|
||
const mapping = this.draftMappings[mappingKey] ?? this.plugin.settings.noteFieldMappings[mappingKey];
|
||
|
||
if (!mapping) {
|
||
return undefined;
|
||
}
|
||
|
||
return {
|
||
...mapping,
|
||
loadedFieldNames: [...mapping.loadedFieldNames],
|
||
};
|
||
}
|
||
|
||
private getSelectedNoteType(cardType: CardType): string {
|
||
if (cardType === "basic") {
|
||
return this.plugin.settings.qaNoteType;
|
||
}
|
||
|
||
if (cardType === "cloze") {
|
||
return this.plugin.settings.clozeNoteType;
|
||
}
|
||
|
||
return this.plugin.settings.semanticQaNoteType;
|
||
}
|
||
|
||
private getSelectedMappingNoteType(cardType: CardType): string {
|
||
return this.getSelectedNoteType(cardType);
|
||
}
|
||
|
||
private renderQaGroupModelStatus(containerEl: HTMLElement): void {
|
||
const definition = buildQaGroupModelDefinition();
|
||
containerEl.createEl("p", {
|
||
text: `Managed note type: ${definition.modelName}. QA Group sync writes Stem / GroupId / Src / S01..S12 directly. The same note type can also appear in the field mapping panels below if you want to reuse it for other routes.`,
|
||
});
|
||
containerEl.createEl("p", {
|
||
text: `Managed model contract: ${definition.fieldNames.length} fields and ${definition.templates.length} templates are checked automatically during sync.`,
|
||
});
|
||
}
|
||
|
||
private renderSemanticQaPreview(containerEl: HTMLElement, marker: string): void {
|
||
containerEl.createEl("h4", { text: "Semantic QA preview" });
|
||
containerEl.createEl("p", { text: `Trigger heading example: 城市更新 ${marker}` });
|
||
|
||
const previewCards = this.semanticQaListParser.parse({
|
||
parentHeadingText: `城市更新 ${marker}`,
|
||
marker,
|
||
bodyLines: [
|
||
"- 核心产品",
|
||
" 百人会、城市更新研习社、城市更新创投营。",
|
||
"- 目标客户",
|
||
" 对城市更新有系统学习需求的从业者。",
|
||
],
|
||
bodyStartLine: 2,
|
||
});
|
||
|
||
if (previewCards.length === 0) {
|
||
containerEl.createEl("p", { text: "Preview unavailable. Use a trailing hashtag marker such as #anki-list-qa." });
|
||
return;
|
||
}
|
||
|
||
const firstPreview = previewCards[0];
|
||
containerEl.createEl("p", { text: `Question preview: ${firstPreview.heading}` });
|
||
containerEl.createEl("p", { text: `Answer preview: ${firstPreview.bodyMarkdown}` });
|
||
}
|
||
|
||
private renderDeckSection(containerEl: HTMLElement, settings: AnkiHeadingSyncPlugin["settings"]): void {
|
||
containerEl.createEl("h3", { text: "默认牌组" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("默认牌组")
|
||
.setDesc("优先级最低：当文件级 deck 与文件夹映射都未命中时使用。")
|
||
.addText((text) => {
|
||
text.setValue(settings.defaultDeck).onChange((value) => {
|
||
void this.plugin.updateSettings({ defaultDeck: value });
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("h3", { text: "文件级自定义牌组" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("开启文件级自定义牌组")
|
||
.setDesc("开启后，允许用统一 marker 在 YAML 或正文中为整篇笔记指定 deck。")
|
||
.addToggle((toggle) => {
|
||
toggle.setValue(settings.fileDeckEnabled).onChange(async (value) => {
|
||
await this.plugin.updateSettings({ fileDeckEnabled: value });
|
||
this.display();
|
||
});
|
||
});
|
||
|
||
if (settings.fileDeckEnabled) {
|
||
new Setting(containerEl)
|
||
.setName("牌组识别名")
|
||
.setDesc("YAML key 与正文 marker 共用同一个识别名。默认是 TARGET DECK。")
|
||
.addText((text) => {
|
||
text.setValue(settings.fileDeckMarker).onChange((value) => {
|
||
const nextValue = value.trim();
|
||
if (!nextValue) {
|
||
return;
|
||
}
|
||
|
||
void this.plugin.updateSettings({ fileDeckMarker: nextValue });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName("默认牌组模板")
|
||
.setDesc("只支持 filename 变量，插入时会展开为当前文件名（不含 .md）。")
|
||
.addText((text) => {
|
||
text.setValue(settings.fileDeckTemplate).onChange((value) => {
|
||
const nextValue = value.trim();
|
||
if (!nextValue) {
|
||
return;
|
||
}
|
||
|
||
void this.plugin.updateSettings({ fileDeckTemplate: nextValue });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName("模板插入位置")
|
||
.setDesc("选择将 deck 模板写入 YAML frontmatter 还是正文前部。")
|
||
.addDropdown((dropdown) => {
|
||
this.populateFileDeckInsertLocationDropdown(dropdown, settings.fileDeckInsertLocation);
|
||
dropdown.onChange((value) => {
|
||
if (value !== "yaml" && value !== "body") {
|
||
return;
|
||
}
|
||
|
||
void this.plugin.updateSettings({ fileDeckInsertLocation: value });
|
||
});
|
||
});
|
||
|
||
new Setting(containerEl)
|
||
.setName("向当前文件插入 deck 模板")
|
||
.setDesc("按当前 marker、模板和插入位置，把 deck 声明写入当前活动 Markdown 文件。")
|
||
.addButton((button) => {
|
||
button.setButtonText("插入 deck 模板").onClick(() => {
|
||
void this.plugin.insertDeckTemplateToCurrentFile();
|
||
});
|
||
});
|
||
}
|
||
|
||
containerEl.createEl("h3", { text: "高级：文件夹映射" });
|
||
|
||
new Setting(containerEl)
|
||
.setName("文件夹映射模式")
|
||
.setDesc("关闭 / 仅父文件夹 / 父文件夹加当前文件名。")
|
||
.addDropdown((dropdown) => {
|
||
this.populateFolderDeckModeDropdown(dropdown, settings.folderDeckMode);
|
||
dropdown.onChange((value) => {
|
||
if (value !== "off" && value !== "folder" && value !== "folder-and-file") {
|
||
return;
|
||
}
|
||
|
||
void this.plugin.updateSettings({ folderDeckMode: value });
|
||
});
|
||
});
|
||
|
||
containerEl.createEl("p", { text: "文件夹级映射示例：数学/第一章/第一节.md -> 数学::第一章" });
|
||
containerEl.createEl("p", { text: "文件夹及文件名级映射示例：数学/第一章/第一节.md -> 数学::第一章::第一节" });
|
||
|
||
containerEl.createEl("h3", { text: "最终优先级说明" });
|
||
containerEl.createEl("p", {
|
||
text: "最终 deck 优先级：文件级自定义牌组 > 文件夹映射 deck > 默认牌组。旧卡 deck 行为保持当前实现。",
|
||
});
|
||
}
|
||
|
||
private populateFileDeckInsertLocationDropdown(dropdown: SimpleDropdown, selectedValue: FileDeckInsertLocation): void {
|
||
dropdown.addOption("body", "正文前部");
|
||
dropdown.addOption("yaml", "YAML frontmatter");
|
||
dropdown.setValue(selectedValue);
|
||
}
|
||
|
||
private populateFolderDeckModeDropdown(dropdown: SimpleDropdown, selectedValue: FolderDeckMode): void {
|
||
dropdown.addOption("off", "关闭");
|
||
dropdown.addOption("folder", "文件夹级映射");
|
||
dropdown.addOption("folder-and-file", "文件夹及文件名级映射");
|
||
dropdown.setValue(selectedValue);
|
||
}
|
||
|
||
private renderScopeSection(containerEl: HTMLElement, settings: AnkiHeadingSyncPlugin["settings"]): void {
|
||
new Setting(containerEl)
|
||
.setName("运行范围")
|
||
.setDesc(getScopeModeSummary(settings.scopeMode))
|
||
.addDropdown((dropdown) => {
|
||
dropdown
|
||
.addOption("all", "全部文件")
|
||
.addOption("include", "仅在指定文件夹")
|
||
.addOption("exclude", "排除指定文件夹")
|
||
.setValue(settings.scopeMode)
|
||
.onChange((value) => {
|
||
if (value !== "all" && value !== "include" && value !== "exclude") {
|
||
return;
|
||
}
|
||
|
||
void this.updateScopeMode(value);
|
||
});
|
||
});
|
||
|
||
if (settings.scopeMode === "all") {
|
||
return;
|
||
}
|
||
|
||
this.ensureFolderTreeLoaded();
|
||
|
||
const scopeContainer = containerEl.createDiv();
|
||
scopeContainer.createEl("p", { text: getScopeModeTreeDescription(settings.scopeMode) });
|
||
|
||
if (this.folderTreeLoadPromise) {
|
||
scopeContainer.createEl("p", { text: this.folderTreeStatus });
|
||
return;
|
||
}
|
||
|
||
if (this.folderTree.length === 0) {
|
||
scopeContainer.createEl("p", { text: this.folderTreeStatus });
|
||
return;
|
||
}
|
||
|
||
const selectedFolders = settings.scopeMode === "include" ? settings.includeFolders : settings.excludeFolders;
|
||
const selectionTree = buildFolderTreeSelection(this.folderTree, selectedFolders);
|
||
const treeContainer = scopeContainer.createDiv();
|
||
treeContainer.style.marginTop = "8px";
|
||
treeContainer.style.display = "flex";
|
||
treeContainer.style.flexDirection = "column";
|
||
treeContainer.style.gap = "2px";
|
||
|
||
for (const node of selectionTree) {
|
||
this.renderFolderNode(treeContainer, node, settings.scopeMode, 0);
|
||
}
|
||
}
|
||
|
||
private renderFolderNode(containerEl: HTMLElement, node: FolderTreeSelectionNode, scopeMode: ScopeMode, depth: number): void {
|
||
const row = containerEl.createDiv();
|
||
row.dataset.folderRow = node.path;
|
||
row.dataset.folderDepth = String(depth);
|
||
row.style.display = "flex";
|
||
row.style.alignItems = "center";
|
||
row.style.gap = "6px";
|
||
row.style.minHeight = "24px";
|
||
row.style.paddingLeft = `${depth * 18}px`;
|
||
|
||
const hasChildren = node.children.length > 0;
|
||
const expanded = hasChildren && this.expandedFolderPaths.has(node.path);
|
||
const toggleControl = row.createEl(hasChildren ? "button" : "span");
|
||
toggleControl.dataset.folderToggle = node.path;
|
||
toggleControl.textContent = hasChildren ? (expanded ? "▾" : "▸") : "";
|
||
toggleControl.style.width = "18px";
|
||
toggleControl.style.display = "inline-flex";
|
||
toggleControl.style.alignItems = "center";
|
||
toggleControl.style.justifyContent = "center";
|
||
toggleControl.style.flexShrink = "0";
|
||
toggleControl.style.padding = "0";
|
||
toggleControl.style.border = "0";
|
||
toggleControl.style.background = "transparent";
|
||
toggleControl.style.color = "var(--text-muted)";
|
||
toggleControl.style.cursor = hasChildren ? "pointer" : "default";
|
||
|
||
if (hasChildren) {
|
||
toggleControl.setAttr("aria-label", expanded ? `收起 ${node.name}` : `展开 ${node.name}`);
|
||
toggleControl.setAttr("aria-expanded", String(expanded));
|
||
toggleControl.addEventListener("click", () => {
|
||
this.toggleFolderExpanded(node.path);
|
||
});
|
||
}
|
||
|
||
const checkbox = row.createEl("input") as HTMLInputElement;
|
||
checkbox.type = "checkbox";
|
||
checkbox.checked = node.checked;
|
||
checkbox.indeterminate = node.indeterminate;
|
||
checkbox.dataset.folderPath = node.path;
|
||
checkbox.style.margin = "0";
|
||
checkbox.addEventListener("change", () => {
|
||
void this.updateFolderSelection(scopeMode, node.path, checkbox.checked);
|
||
});
|
||
|
||
const label = row.createEl("span", { text: node.name });
|
||
label.dataset.folderPathLabel = node.path;
|
||
label.style.userSelect = "none";
|
||
|
||
if (!hasChildren || !expanded) {
|
||
return;
|
||
}
|
||
|
||
const childrenContainer = containerEl.createDiv();
|
||
childrenContainer.dataset.folderChildren = node.path;
|
||
childrenContainer.style.display = "flex";
|
||
childrenContainer.style.flexDirection = "column";
|
||
childrenContainer.style.gap = "2px";
|
||
for (const child of node.children) {
|
||
this.renderFolderNode(childrenContainer, child, scopeMode, depth + 1);
|
||
}
|
||
}
|
||
|
||
private ensureFolderTreeLoaded(): void {
|
||
if (this.hasLoadedFolderTree || this.folderTreeLoadPromise) {
|
||
return;
|
||
}
|
||
|
||
this.folderTreeStatus = FOLDER_TREE_STATUS_LOADING;
|
||
this.folderTreeLoadPromise = this.plugin
|
||
.listFolderTree()
|
||
.then((folderTree) => {
|
||
this.folderTree = folderTree;
|
||
this.folderTreeStatus = folderTree.length > 0 ? "" : "当前 vault 中没有可选文件夹。";
|
||
})
|
||
.catch((error) => {
|
||
this.folderTree = [];
|
||
this.folderTreeStatus = error instanceof Error ? error.message : "读取 vault 文件夹失败。";
|
||
})
|
||
.finally(() => {
|
||
this.hasLoadedFolderTree = true;
|
||
this.folderTreeLoadPromise = null;
|
||
this.display();
|
||
});
|
||
}
|
||
|
||
private async updateScopeMode(scopeMode: ScopeMode): Promise<void> {
|
||
await this.plugin.updateSettings({ scopeMode });
|
||
this.display();
|
||
}
|
||
|
||
private async updateFolderSelection(scopeMode: ScopeMode, folderPath: string, checked: boolean): Promise<void> {
|
||
const currentSelection = scopeMode === "include" ? this.plugin.settings.includeFolders : this.plugin.settings.excludeFolders;
|
||
const nextSelection = toggleFolderTreeSelection(this.folderTree, currentSelection, folderPath, checked);
|
||
|
||
await this.plugin.updateSettings(scopeMode === "include" ? { includeFolders: nextSelection } : { excludeFolders: nextSelection });
|
||
this.display();
|
||
}
|
||
|
||
private toggleFolderExpanded(folderPath: string): void {
|
||
if (this.expandedFolderPaths.has(folderPath)) {
|
||
this.expandedFolderPaths.delete(folderPath);
|
||
} else {
|
||
this.expandedFolderPaths.add(folderPath);
|
||
}
|
||
|
||
this.display();
|
||
}
|
||
}
|
||
|
||
function inferBasicLikeCardType(sectionTitle: string): Extract<CardType, "basic" | "semantic-qa"> {
|
||
return sectionTitle === "Semantic QA" ? "semantic-qa" : "basic";
|
||
}
|
||
|
||
function getScopeModeSummary(scopeMode: ScopeMode): string {
|
||
if (scopeMode === "include") {
|
||
return "仅处理下方勾选文件夹中的 Markdown 文件";
|
||
}
|
||
|
||
if (scopeMode === "exclude") {
|
||
return "处理整个 vault，但跳过下方勾选文件夹中的 Markdown 文件";
|
||
}
|
||
|
||
return "处理整个 vault 中的 Markdown 文件";
|
||
}
|
||
|
||
function getScopeModeTreeDescription(scopeMode: ScopeMode): string {
|
||
if (scopeMode === "include") {
|
||
return "仅在指定文件夹：只处理下方勾选文件夹中的 Markdown 文件";
|
||
}
|
||
|
||
return "排除指定文件夹：处理整个 vault，但跳过下方勾选文件夹中的 Markdown 文件";
|
||
}
|