dsh-config-manager 0.1.39 → 0.1.41

package/lib/client.d.ts

@@ -962,6 +962,17 @@ interface GithubPollResponse {
   /** success 时恒 true（凭据已配置）；便于 UI 直接刷新状态 */
   credentialConfigured?: boolean;
 }
+/** POST /sync/github/validate 响应：token 是否已配置 + 是否有效（GET /user；
+ *  401 → 无效）。只回布尔 + 登录名（非敏感），token 值永不回传浏览器。 */
+interface GithubValidateResponse {
+  ok: boolean;
+  /** token 是否存在于 DSH credentials */
+  configured: boolean;
+  /** token 是否有效（GitHub GET /user 成功；configured=false 时恒 false） */
+  valid: boolean;
+  /** GitHub 登录名（valid=true 时；非敏感展示位） */
+  login?: string;
+}
 /** 远程同步浏览器半数据入口（备份与迁移页第 4 个 tab 的注入业务面） */
 declare class SyncApi {
   readonly t: UiT;
@@ -980,6 +991,9 @@ declare class SyncApi {
   githubCancel(flowId: string): Promise<{
     ok: boolean;
   }>;
+  /** GitHub token 有效性校验（判定「是否已登录」：token 存在且 GitHub API 接受；
+   *  401 → valid:false 引导重新登录；非 401 错误向上抛，UI 兜底不误判登出） */
+  githubValidate(): Promise<GithubValidateResponse>;
   /** 同步历史：列出本地祖先快照 + 自动同步执行记录（按 createdAt 倒序合并）。 */
   history(): Promise<SyncHistoryResponse>;
   /** 远端历史快照列表（供「选择历史快照」下拉）。 */
@@ -1110,6 +1124,8 @@ interface MarketStatusResponse {
   /** 是否已添加过至少一个市场 */
   configured: boolean;
   markets: MarketSummary[];
+  /** 本次 dsh 启动后市场是否已刷新过（首次打开市场页自动更新一次的依据；进程内存，dsh 重启后重置） */
+  bootAutoRefreshed?: boolean;
 }
 /** POST /market/refresh 响应：{ ok, items, market } */
 interface MarketRefreshResponse {
@@ -1184,10 +1200,21 @@ type MyItemStatus = 'not-listed' | 'pr-pending' | 'listed';
 interface MyRepoForm {
   /** 配置名（预填 zip 文件名，可改）；id 由其派生稳定 slug */
   name: string;
+  /** 显式目标条目 id（**仅 update 模式**用：由列表「更新」按钮预填，避免靠 name→slug 猜测匹配；
+   *  上传（新条目）时省略；后端校验存在性，缺省回退 name slug 匹配（向后兼容） */
+  id?: string;
   description?: string;
   categories?: string[];
 }
-/** upload / update 返回（ok=false 时携带已脱敏 error + errorCode） */
+/** 收录流程状态：pending=已提交、后台处理中；done=已提交收录（PR 已开/复用）；failed=收录失败可重试 */
+type ListingState = 'pending' | 'done' | 'failed';
+/**
+ * upload / update 返回（ok=false 时携带已脱敏 error + errorCode）。
+ * 流程拆分（2026-08-20 优化）：upload/update 只同步执行「推用户仓库」并立即返回
+ * （listing='pending'），「收录流程」（fork + 官方 index + PR）在后台异步执行，
+ * 避免 GitHub fork 排队时整个上传请求长时间挂起；收录结果经 listingStatus /
+ * /me/items 状态徽章查询。
+ */
 interface UploadResult {
   ok: boolean;
   itemId: string;
@@ -1196,14 +1223,47 @@ interface UploadResult {
   sections: SectionId[];
   /** 用户公开仓库 URL（https://github.com/<login>/dsh-configs） */
   repoUrl: string;
+  /** 收录 PR 编号（异步模式下收起完成前为 null；完成经 listingStatus 查询） */
   prNumber: number | null;
+  /** 收录 PR 链接（同上） */
   prUrl: string | null;
   warnings: string[];
+  /** 收录流程状态：ok=true 且上传成功后为 'pending'（后台进行中）；失败无收录流程时 'done' 无意义 */
+  listing: ListingState;
+  /** listing='failed' 时：收录失败原因（已脱敏，含重试指引） */
+  listingError?: string;
   /** ok=false 时：可展示错误（已脱敏，无 token 形态） */
   error?: string;
   /** ok=false 时：错误分类码（unauthorized/prepare_failed/...；无则 'internal'） */
   errorCode?: string;
 }
+/** POST /me/listing 响应：收录任务状态（结果卡轮询用，比拉全列表更轻） */
+interface ListingStatusResponse {
+  itemId: string;
+  listing: ListingState;
+  /** listing='done' 时：PR 编号 */
+  prNumber: number | null;
+  /** listing='done' 时：PR 链接 */
+  prUrl: string | null;
+  /** listing='failed' 时：失败原因（已脱敏） */
+  error?: string;
+}
+/** POST /me/delete 响应：删除条目结果 */
+interface DeleteResult {
+  ok: boolean;
+  itemId: string;
+  /** 是否已异步提交「下架 PR」（条目此前已收录进官方市场时 true） */
+  delisted: boolean;
+  /** 被关闭的收录 PR（条目处于待审核、有 open PR 时关闭它） */
+  prNumber: number | null;
+  /** 被关闭 PR 的链接（同上） */
+  prUrl: string | null;
+  warnings: string[];
+  /** ok=false 时：可展示错误（已脱敏） */
+  error?: string;
+  /** ok=false 时：错误分类码（item_not_found/unauthorized/...） */
+  errorCode?: string;
+}
 /** listItems 条目：用户仓库 index.json 条目 + 收录状态 */
 interface MyItemEntry {
   id: string;
@@ -1273,6 +1333,12 @@ declare class MyConfigsApi {
     zipPath: string;
     form: MyConfigsFormPayload;
   }): Promise<MyUploadResult>;
+  /** 查询收录/下架任务状态（结果卡轮询；任务表未命中时 Host 回退 GitHub 实况推导；无任务无实况 → null） */
+  meListing(itemId: string): Promise<ListingStatusResponse | null>;
+  /** 重新提交收录（失败/重启丢失后重试；幂等复用已存在 fork/open PR） */
+  meRelist(itemId: string): Promise<ListingStatusResponse>;
+  /** 删除条目（同步删本地索引+文件；已收录自动后台提下架 PR；待审核自动关闭收录 PR） */
+  meDelete(itemId: string): Promise<DeleteResult>;
 }
 //#endregion
 //#region src/client/client-types.d.ts
@@ -1461,10 +1527,14 @@ declare const zh$1: {
   readonly 'config.saving': "保存中…";
   readonly 'config.saveHint': "表单改动会自动保存（密码/token 安全写入 DSH credentials，不会写入同步文件或日志）；也可点击按钮立即保存。";
   readonly 'channel.title': "同步通道";
-  readonly 'channel.hint': "选择远程同步通道：Git 私有仓库或 WebDAV 服务器。";
   readonly 'channel.git': "Git 私有仓库";
   readonly 'channel.webdav': "WebDAV 服务器";
   readonly 'channel.perChannelHint': "GitHub 与 WebDAV 通道的自动同步、同步模式、加密与远端快照各自独立配置。";
+  readonly 'channel.open': "配置同步通道";
+  readonly 'channel.openHint': "远程同步通过「同步通道」进行：Git 私有仓库或 WebDAV 服务器。点击按钮在弹窗中配置或修改。";
+  readonly 'channel.configured': "已配置";
+  readonly 'channel.notConfigured': "未配置";
+  readonly 'channel.currentUrl': "当前地址";
   readonly 'webdav.title': "WebDAV 配置";
   readonly 'webdav.url': "服务器地址";
   readonly 'webdav.urlHint': "WebDAV 服务器根地址（https://…）。同步快照与索引存放于该地址的 snapshots/ 子目录下。请勿在地址中包含用户名/密码。";
@@ -1480,6 +1550,7 @@ declare const zh$1: {
   readonly 'github.login': "使用 GitHub 登录";
   readonly 'github.retry': "重新登录";
   readonly 'github.cancel': "取消";
+  readonly 'github.tokenInvalid': "GitHub 登录已失效，请重新登录。";
   readonly 'github.userCode': "一次性授权代码";
   readonly 'github.openAuth': "打开 GitHub 授权页面";
   readonly 'github.clientIdHint': "需要插件配置 githubClientId（GitHub OAuth App 的 client_id）才能使用 GitHub 登录。";
@@ -1628,14 +1699,8 @@ declare const zh: {
   readonly 'section.label': "配置市场";
   readonly 'section.description': "浏览并下载社区共享的配置（公开 Git 仓库；下载内容一律视为不可信，导入前必经校验与确认）";
   readonly 'config.title': "市场仓库";
-  readonly 'config.builtinHint': "内置官方市场，只读、不可编辑（由创建者维护的公开 Git 仓库）。";
-  readonly 'config.official': "内置官方市场";
-  readonly 'config.custom': "自定义市场地址";
-  readonly 'config.repoUrlHint': "内置公开 Git 仓库地址。市场只读拉取（绝不推送）。";
   readonly 'config.refresh': "拉取最新";
   readonly 'config.refreshing': "拉取中…";
-  readonly 'config.addedAt': "更新于：{time}";
-  readonly 'config.itemCount': "{count} 个条目";
   readonly 'list.empty': "内置市场尚未加载。请先「拉取最新」。";
   readonly 'list.browse': "浏览";
   readonly 'list.loading': "正在读取市场…";
@@ -1702,6 +1767,8 @@ declare const zh: {
   readonly 'myconfigs.update.hint': "版本将自动 +1，已预填原条目信息（名称可改）。";
   readonly 'myconfigs.update.run': "一键更新";
   readonly 'myconfigs.update.running': "更新中…";
+  readonly 'myconfigs.update.zipHint': "更新需要新的配置包：选择新 zip 后自动校验，通过后即可一键更新。";
+  readonly 'myconfigs.update.selectZip': "选择新 ZIP…";
   readonly 'myconfigs.result.title': "上传/更新完成";
   readonly 'myconfigs.result.version': "版本 {version}";
   readonly 'myconfigs.result.sha256': "SHA-256：{hash}";
@@ -1710,6 +1777,9 @@ declare const zh: {
   readonly 'myconfigs.result.openRepo': "打开仓库";
   readonly 'myconfigs.result.pr': "收录 PR #{number}";
   readonly 'myconfigs.result.openPr': "查看 PR";
+  readonly 'myconfigs.result.listingPending': "已上传 ✓ 正在后台提交收录（fork + 收录 PR），稍后列表状态自动更新";
+  readonly 'myconfigs.result.listingFailed': "收录失败";
+  readonly 'myconfigs.result.relist': "重新提交收录";
   readonly 'myconfigs.list.title': "已上传";
   readonly 'myconfigs.list.empty': "尚未上传任何配置";
   readonly 'myconfigs.list.loading': "正在读取…";
@@ -1719,6 +1789,18 @@ declare const zh: {
   readonly 'myconfigs.item.update': "更新";
   readonly 'myconfigs.item.install': "装回本地";
   readonly 'myconfigs.item.openPr': "查看收录 PR";
+  readonly 'myconfigs.delete.run': "删除";
+  readonly 'myconfigs.delete.confirm': "确认删除";
+  readonly 'myconfigs.delete.confirmTitle': "删除条目";
+  readonly 'myconfigs.delete.confirmText': "确认删除？该操作会从配置仓库永久删除该条目的索引与文件（不可恢复）";
+  readonly 'myconfigs.delete.delistStarted': "已删除本地条目，并自动提交「下架 PR」（官方市场移除需人工合并，期间市场可能仍显示该条目）";
+  readonly 'myconfigs.delete.prClosed': "已删除本地条目，并关闭该条目的待审核收录 PR";
+  readonly 'disclaimer.title': "免责声明";
+  readonly 'disclaimer.upload.text': "你即将把配置上传到你的公开仓库（<login>/dsh-configs）并提交官方市场收录申请。\n\n上传后内容将对所有人公开可见，且需经过人工审核才能进入官方市场。请确保：\n· 内容不包含任何真实密钥 / 凭据（环境变量引用如 $VAR 是安全的）；\n· 内容不包含个人隐私或本地环境信息；\n· 你有权分享这些配置。";
+  readonly 'disclaimer.download.text': "你即将从公共网络市场下载配置并导入本地。\n\n下载内容属于不可信输入：未经官方审核、可能包含风险（安装插件 / 写入文件 / 修改设置）。\n· 导入前会逐项展示并校验，高风险分区默认不导入、需逐项批准；\n· 导入会先自动创建快照，失败可回滚；\n· 请核对来源与内容后再确认导入。";
+  readonly 'disclaimer.install.text': "你即将把配置从你的公开仓库装回本地。\n\n该内容属于你此前上传的配置，但同样会经过安全校验与逐分区批准：\n· 高风险分区默认不导入、需逐项批准；\n· 导入前自动创建快照，失败可回滚。";
+  readonly 'disclaimer.confirm': "我已了解，继续";
+  readonly 'disclaimer.dontAsk': "不再提示（该操作以后不再显示免责声明）";
   readonly 'myconfigs.error.loadStatus': "登录状态读取失败";
   readonly 'myconfigs.error.loadItems': "已上传列表读取失败";
   readonly 'common.cancel': "取消";