dsh-config-manager 0.1.40 → 0.1.42

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiajiajun516
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/client.d.ts

@@ -568,6 +568,31 @@ interface RestoreResponse {
   plan?: RestorePlan;
   report?: RestoreReport;
 }
+/** Star 引导弹窗状态（GET /star-prompt；纯偏好，无 secret） */
+interface StarPromptStatus {
+  ok: boolean;
+  /** 引导用户点 Star 的 GitHub 仓库地址（Host 提供，硬编码常量） */
+  repoUrl: string;
+  /** 首次进入页面时间（ms 时间戳）；undefined = 尚未进入过页面 */
+  firstSeenAt?: number;
+  /** 用户点过「不再提示」 */
+  dismissed: boolean;
+  /** 用户点过「去点 Star」（方案 A：引导完成） */
+  clicked: boolean;
+}
+/** Star 引导弹窗状态的局部更新补丁（POST /star-prompt；全部可选） */
+interface StarPromptPatch {
+  firstSeenAt?: number;
+  dismissed?: boolean;
+  clicked?: boolean;
+}
+/** POST /star-prompt 响应（更新后的最新状态） */
+interface StarPromptSaveResponse {
+  ok: boolean;
+  firstSeenAt?: number;
+  dismissed: boolean;
+  clicked: boolean;
+}
 /** 携带路由 JSON error 消息的错误类型 */
 declare class ConfigManagerApiError extends Error {
   constructor(message: string);
@@ -599,6 +624,11 @@ declare class ConfigManagerApi {
   constructor(t?: UiT);
   /** 健康/版本检查（主页横幅：插件版本 / DSH 版本 / 平台） */
   status(): Promise<ServiceStatus>;
+  /** Star 引导弹窗状态（进入页面时判定是否展示 / 是否补记首次使用时间）。 */
+  starPromptStatus(): Promise<StarPromptStatus>;
+  /** 保存 Star 引导弹窗状态（局部更新：firstSeenAt / dismissed / clicked）。
+   * 纯偏好无 secret；失败由调用方静默降级（本次不弹/不记，下次再判）。 */
+  saveStarPrompt(patch: StarPromptPatch): Promise<StarPromptSaveResponse>;
   /** ExportPort.export：调用 Host 侧导出编排（core Exporter）。加密密码随请求体传输（仅内存）。
    * 带 AbortController 超时：宿主若卡死，客户端得到明确错误而不是永远停在进度条。 */
   export(options: ExportOptions): Promise<ExportResponse>;
@@ -962,6 +992,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 +1021,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>;
   /** 远端历史快照列表（供「选择历史快照」下拉）。 */
@@ -1071,6 +1115,8 @@ interface MarketListItem {
   categories?: string[];
   /** 条目来源仓库 URL（来自 index 条目；UI 据此显示来源徽章）；缺省 = 市场仓库自身 */
   repo?: string;
+  /** 条目来源仓库的 star 数（仓库级，非条目级；undefined = 无数据——查询失败/非 GitHub 仓库） */
+  stars?: number;
   /** 本地缓存状态：cached | fresh | none（UI 徽章） */
   cacheState: 'cached' | 'fresh' | 'none';
 }
@@ -1110,6 +1156,8 @@ interface MarketStatusResponse {
   /** 是否已添加过至少一个市场 */
   configured: boolean;
   markets: MarketSummary[];
+  /** 本次 dsh 启动后市场是否已刷新过（首次打开市场页自动更新一次的依据；进程内存，dsh 重启后重置） */
+  bootAutoRefreshed?: boolean;
 }
 /** POST /market/refresh 响应：{ ok, items, market } */
 interface MarketRefreshResponse {
@@ -1190,7 +1238,15 @@ interface MyRepoForm {
   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;
@@ -1199,14 +1255,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;
@@ -1221,6 +1310,8 @@ interface MyItemEntry {
   prUrl?: string;
   /** 用户公开仓库 URL */
   repoUrl: string;
+  /** 用户公开仓库（<login>/dsh-configs）的 star 数（仓库级；undefined = 无数据） */
+  stars?: number;
 }
 //#endregion
 //#region src/client/market/my-configs-api.d.ts
@@ -1276,6 +1367,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
@@ -1426,6 +1523,10 @@ declare const zh$2: {
   readonly 'report.needsRestart': "插件 / MCP 变更将在重启 DSH 后生效。";
   readonly 'error.title': "操作失败";
   readonly 'error.hint': "错误消息已自动脱敏，不会泄露任何密钥信息。";
+  readonly 'starPrompt.title': "喜欢 Config Manager 吗？";
+  readonly 'starPrompt.body': "如果你觉得这个插件有用，欢迎到 GitHub 点个 ⭐ Star 支持一下——你的支持是持续维护的最大动力！";
+  readonly 'starPrompt.star': "去点 Star";
+  readonly 'starPrompt.dismiss': "不再提示";
   readonly 'about.title': "关于 DSH Config Manager";
   readonly 'about.subtitle': "插件信息、作者与反馈入口";
   readonly 'about.official': "官方";
@@ -1464,10 +1565,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/ 子目录下。请勿在地址中包含用户名/密码。";
@@ -1483,6 +1588,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 登录。";
@@ -1631,27 +1737,28 @@ 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': "正在读取市场…";
   readonly 'list.noItems': "该市场暂无条目。";
   readonly 'list.searchPlaceholder': "搜索名称 / 作者 / 描述…";
   readonly 'list.categoriesAll': "全部类别";
+  readonly 'list.sourceAll': "全部来源";
+  readonly 'list.sourceOfficial': "官方配置";
+  readonly 'list.sourcePersonal': "个人配置";
+  readonly 'list.sortDefault': "默认排序";
+  readonly 'list.sortUpdated': "最新更新";
+  readonly 'list.sortStars': "⭐ 最多";
+  readonly 'list.sortName': "名称 A–Z";
+  readonly 'list.stars': "⭐ {count}";
+  readonly 'list.starsHint': "来源仓库 star 数（仓库级，非本条目）";
   readonly 'list.count': "共 {count} 个条目";
   readonly 'list.filtered': "（筛选后 {count} 个）";
   readonly 'list.cacheCached': "已缓存";
   readonly 'list.cacheFresh': "刚刚拉取";
   readonly 'list.cacheNone': "未缓存";
-  readonly 'list.sourceOfficial': "官方来源";
-  readonly 'list.sourceThirdParty': "第三方来源";
   readonly 'list.download': "查看详情";
   readonly 'detail.title': "条目详情";
   readonly 'detail.downloadedAt': "下载时间：{time}";
@@ -1705,6 +1812,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}";
@@ -1713,6 +1822,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': "正在读取…";
@@ -1722,6 +1834,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': "取消";