refactor(*): 稳定期治理 - 收敛核心架构、错误语义并修复跨项目数据竞态

This commit is contained in:
ddCat committed 2026-09-09 22:02:10 +08:00
1 parent 83d9622fd0
commit bf41ef3172
298 files changed
+12681 -26428

No files matched your search

+74 -76
View File
@@ -1,8 +1,6 @@
import { compactApiParams, serializeApiParams, type ApiParams } from "@/services/api/request";
import { apiClient, request } from "@/services/api/request";
import { http, apiBaseURL, compactApiParams, serializeApiParams, type ApiParams } from "@/services/api/request";
import { getActiveUserScope } from "@/lib/user-scope";
const api = apiClient;
let addedSkillsRequest: { scope: string; promise: Promise<{ skills: Skill[] }> } | null = null;
let addedSkillsCache: { scope: string; value: { skills: Skill[] }; expiresAt: number } | null = null;
@@ -13,66 +11,66 @@ export type SkillMediaType = "image" | "video";
export type SkillShowcaseMedia = {
type: SkillMediaType;
showcase_uri: string;
showcase_url: string;
showcaseUri: string;
showcaseUrl: string;
};
export type Skill = {
skill_id: string;
skill_name: string;
skillId: string;
skillName: string;
description: string;
instruction?: string;
version_id: string;
versionId: string;
version: string;
content_hash: string;
file_count: number;
total_bytes: number;
source_type: "builtin" | "markdown" | "zip" | "github" | string;
source_url: string;
source_ref: string;
source_subdir: string;
source_commit: string;
sync_status: "synced" | "failed" | "syncing" | string;
sync_error?: string;
auto_update: boolean;
last_checked_at: number;
last_synced_at: number;
contentHash: string;
fileCount: number;
totalBytes: number;
sourceType: "builtin" | "markdown" | "zip" | "github" | string;
sourceUrl: string;
sourceRef: string;
sourceSubdir: string;
sourceCommit: string;
syncStatus: "synced" | "failed" | "syncing" | string;
syncError?: string;
autoUpdate: boolean;
lastCheckedAt?: string;
lastSyncedAt?: string;
status: number;
markdown_url: string;
create_time: number;
update_time: number;
markdownUrl: string;
createdAt: string;
updatedAt: string;
source: number;
tag: string;
sort_weight: number;
is_private: boolean;
like_count: number;
is_like: boolean;
owner_uid: string;
effective_user: { name: string; avatar_url: string; uid: string };
original_skill_id: string | null;
showcase_media: SkillShowcaseMedia[];
added_count: number;
is_test: boolean;
extra_info: string;
is_added: boolean;
is_owner: boolean;
sortWeight: number;
isPrivate: boolean;
likeCount: number;
isLike: boolean;
ownerUid: string;
effectiveUser: { name: string; avatarUrl: string; uid: string };
originalSkillId: string | null;
showcaseMedia: SkillShowcaseMedia[];
addedCount: number;
isTest: boolean;
extraInfo: string;
isAdded: boolean;
isOwner: boolean;
};
export type SkillCategory = { value: string; label: string };
export type SkillList = {
skills: Skill[];
total_count: number;
has_more: boolean;
next_offset: number;
totalCount: number;
hasMore: boolean;
nextOffset: number;
page: number;
page_size: number;
pageSize: number;
categories: SkillCategory[];
};
export type ListSkillsInput = {
page?: number;
page_size?: number;
pageSize?: number;
scope?: SkillScope;
sort?: SkillSort;
search?: string;
@@ -80,20 +78,20 @@ export type ListSkillsInput = {
};
export type SkillMutationInput = {
skill_name: string;
skillName: string;
description: string;
instruction?: string;
tag: string;
is_private: boolean;
markdown_url: string;
showcase_media: SkillShowcaseMedia[];
extra_info: string;
isPrivate: boolean;
markdownUrl: string;
showcaseMedia: SkillShowcaseMedia[];
extraInfo: string;
};
export type SkillPackageFile = {
path: string;
kind: "markdown" | "code" | "text" | "image" | "video" | "audio" | "binary" | string;
mime_type: string;
mimeType: string;
size: number;
sha256: string;
};
@@ -105,24 +103,24 @@ export type SkillPackageFileContent = {
};
export type SkillPackageBundle = {
skill_id: string;
skillId: string;
name: string;
description: string;
version_id: string;
versionId: string;
version: string;
content_hash: string;
files: Array<{ path: string; mime_type: string; content_base64: string }>;
contentHash: string;
files: Array<{ path: string; mimeType: string; contentBase64: string }>;
};
export type SkillFileSearchResult = { path: string; line: number; snippet: string };
export type InstallSkillUploadInput = {
file: File;
source_type?: "markdown" | "zip";
sourceType?: "markdown" | "zip";
name?: string;
description?: string;
tag?: string;
is_private?: boolean;
isPrivate?: boolean;
};
export type InstallGitHubSkillInput = {
@@ -130,18 +128,18 @@ export type InstallGitHubSkillInput = {
ref?: string;
subdir?: string;
tag?: string;
is_private?: boolean;
auto_update?: boolean;
isPrivate?: boolean;
autoUpdate?: boolean;
};
export function listSkills(input: ListSkillsInput = {}) {
const params = serializeApiParams(compactApiParams(input as ApiParams));
return request<SkillList>(api.get(`/skills?${params.toString()}`));
return http.get<SkillList>(`/skills?${params.toString()}`);
}
export function getSkill(id: string) {
return request<{ skill: Skill }>(api.get(`/skills/${encodeURIComponent(id)}`));
return http.get<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}`);
}
export function listAddedSkills() {
@@ -149,7 +147,7 @@ export function listAddedSkills() {
const now = Date.now();
if (addedSkillsCache?.scope === scope && addedSkillsCache.expiresAt > now) return Promise.resolve(addedSkillsCache.value);
if (addedSkillsRequest?.scope === scope) return addedSkillsRequest.promise;
const promise = request<{ skills: Skill[] }>(api.get("/skills/added"))
const promise = http.get<{ skills: Skill[] }>("/skills/added")
.then((value) => {
addedSkillsCache = { scope, value, expiresAt: Date.now() + 15_000 };
return value;
@@ -166,69 +164,69 @@ function invalidateAddedSkillsCache() {
}
export function createSkill(input: SkillMutationInput) {
return request<{ skill: Skill }>(api.post("/skills", input)).finally(invalidateAddedSkillsCache);
return http.post<{ skill: Skill }>("/skills", input).finally(invalidateAddedSkillsCache);
}
export function installSkillUpload(input: InstallSkillUploadInput) {
const form = new FormData();
form.append("file", input.file);
if (input.source_type) form.append("source_type", input.source_type);
if (input.sourceType) form.append("sourceType", input.sourceType);
if (input.name) form.append("name", input.name);
if (input.description) form.append("description", input.description);
if (input.tag) form.append("tag", input.tag);
form.append("is_private", String(Boolean(input.is_private)));
return request<{ skill: Skill }>(api.post("/skills/install", form)).finally(invalidateAddedSkillsCache);
form.append("isPrivate", String(Boolean(input.isPrivate)));
return http.post<{ skill: Skill }>("/skills/install", form).finally(invalidateAddedSkillsCache);
}
export function installGitHubSkill(input: InstallGitHubSkillInput) {
return request<{ skill: Skill }>(api.post("/skills/install/github", input)).finally(invalidateAddedSkillsCache);
return http.post<{ skill: Skill }>("/skills/install/github", input).finally(invalidateAddedSkillsCache);
}
export function listSkillFiles(id: string) {
return request<{ files: SkillPackageFile[] }>(api.get(`/skills/${encodeURIComponent(id)}/files`));
return http.get<{ files: SkillPackageFile[] }>(`/skills/${encodeURIComponent(id)}/files`);
}
export function getSkillFile(id: string, path: string) {
return request<{ file: SkillPackageFileContent }>(api.get(`/skills/${encodeURIComponent(id)}/file`, { params: { path } }));
return http.get<{ file: SkillPackageFileContent }>(`/skills/${encodeURIComponent(id)}/file`, { params: { path } });
}
export function getSkillBundle(id: string) {
return request<{ bundle: SkillPackageBundle }>(api.get(`/skills/${encodeURIComponent(id)}/bundle`));
return http.get<{ bundle: SkillPackageBundle }>(`/skills/${encodeURIComponent(id)}/bundle`);
}
export function searchSkillFiles(id: string, query: string) {
return request<{ results: SkillFileSearchResult[] }>(api.get(`/skills/${encodeURIComponent(id)}/search`, { params: { q: query } }));
return http.get<{ results: SkillFileSearchResult[] }>(`/skills/${encodeURIComponent(id)}/search`, { params: { q: query } });
}
export function syncSkill(id: string) {
return request<{ skill: Skill }>(api.post(`/skills/${encodeURIComponent(id)}/sync`)).finally(invalidateAddedSkillsCache);
return http.post<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}/sync`).finally(invalidateAddedSkillsCache);
}
export function skillFileRawURL(id: string, path: string) {
const base = String(api.defaults.baseURL || "/api").replace(/\/$/, "");
const base = String(apiBaseURL).replace(/\/$/, "");
return `${base}/skills/${encodeURIComponent(id)}/file/raw?path=${encodeURIComponent(path)}`;
}
export function updateSkill(id: string, input: SkillMutationInput) {
return request<{ skill: Skill }>(api.put(`/skills/${encodeURIComponent(id)}`, input)).finally(invalidateAddedSkillsCache);
return http.put<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}`, input).finally(invalidateAddedSkillsCache);
}
export function deleteSkill(id: string) {
return request<{ deleted: boolean }>(api.delete(`/skills/${encodeURIComponent(id)}`)).finally(invalidateAddedSkillsCache);
return http.delete<{ deleted: boolean }>(`/skills/${encodeURIComponent(id)}`).finally(invalidateAddedSkillsCache);
}
export function addSkill(id: string) {
return request<{ skill: Skill }>(api.post(`/skills/${encodeURIComponent(id)}/add`)).finally(invalidateAddedSkillsCache);
return http.post<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}/add`).finally(invalidateAddedSkillsCache);
}
export function removeSkill(id: string) {
return request<{ skill: Skill }>(api.delete(`/skills/${encodeURIComponent(id)}/add`)).finally(invalidateAddedSkillsCache);
return http.delete<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}/add`).finally(invalidateAddedSkillsCache);
}
export function likeSkill(id: string) {
return request<{ skill: Skill }>(api.post(`/skills/${encodeURIComponent(id)}/like`));
return http.post<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}/like`);
}
export function unlikeSkill(id: string) {
return request<{ skill: Skill }>(api.delete(`/skills/${encodeURIComponent(id)}/like`));
return http.delete<{ skill: Skill }>(`/skills/${encodeURIComponent(id)}/like`);
}