dsh-cloudq 0.1.0 → 0.1.2

package/README.md

@@ -2,6 +2,12 @@
 
 面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 CloudQ 集成插件。插件为 Web Profile 提供 CloudQ 模式，内置 `cloudq` Skill，并提供 CloudQ 用量、架构视图、本地凭证配置和插件管理能力。
 
+## 截图
+
+![CloudQ 风险分析对话](assets/screenshots/chat-risk-analysis.png)
+
+![CloudQ 设置与插件管理](assets/screenshots/settings.png)
+
 ## 环境要求
 
 - Node.js `>=22.19.0`
@@ -35,7 +41,7 @@ dsh plugin --profile web remove dsh-cloudq
 
 ## 凭证配置
 
-设置卡片支持 CloudQ OAuth 流程，也支持手动配置腾讯云 `SecretId` 和 `SecretKey`。
+设置卡片支持配置腾讯云 `SecretId` 和 `SecretKey` 凭证。
 
 - 凭证保存在本机 `~/.tencent-cloudq/credential.json`，文件权限仅允许当前用户访问。
 - 敏感凭证通过标准输入传递给 Python 辅助脚本，不会放入命令行参数。
@@ -84,6 +90,11 @@ cordis.patch.yml             DSH Bundle 配置层
 
 源码在 [TencentCloud/cloudq-for-dsh](https://github.com/TencentCloud/cloudq-for-dsh) 完成评审和版本管理。只有仓库检查与安装包冒烟测试全部通过后，才可将 npm 版本发布到官方 Registry。
 
+## 更多文档
+
+- 更新日志：[`CHANGELOG.md`](CHANGELOG.md)
+- 开发与维护指南：[`DEVELOPMENT.md`](DEVELOPMENT.md)
+
 ## 许可证
 
 本项目采用 MIT 许可证，详情请参阅 [`LICENSE`](LICENSE)。

package/lib/client.js

@@ -100,6 +100,11 @@ window.__ModuleLoader__.load({
   background: var(--dsw-alias-bg-layer-3, #fff);
   color: var(--dsw-alias-label-primary, #17191c);
 }
+.dsh-cloudq-settings-card *,
+.dsh-cloudq-settings-card *::before,
+.dsh-cloudq-settings-card *::after {
+  box-sizing: border-box;
+}
 .dsh-cloudq-settings-card__summary {
   padding: 15px 16px;
 }
@@ -215,10 +220,11 @@ window.__ModuleLoader__.load({
   flex-wrap: wrap;
 }
 .dsh-cloudq-settings-card__actions--stacked {
-  flex-direction: column-reverse;
+  flex-direction: column;
+  align-items: stretch;
 }
 .dsh-cloudq-settings-card__actions--stacked button {
-  width: 100%;
+  align-self: flex-end;
 }
 .dsh-cloudq-settings-card__btn {
   display: inline-flex;
@@ -426,10 +432,6 @@ window.__ModuleLoader__.load({
   font-size: 11px;
   font-weight: 500;
 }
-.dsh-cloudq-pm__row-tag--self {
-  background: var(--dsw-alias-state-business-primary, #315efb);
-  color: #fff;
-}
 .dsh-cloudq-pm__row-tag--off {
   background: var(--dsw-alias-state-danger, #d54941);
   color: #fff;
@@ -1137,12 +1139,145 @@ body.dsh-cloudq-mode-active [class*=composerHero] [class*=root][class*=hero] {
   margin-bottom: 16px;
 }
 .dsh-cloudq-usage__card {
-  flex: 1;
+  flex: 0 1 auto;
+  min-width: 240px;
   padding: 14px 16px;
   border: 1px solid var(--dsw-alias-border-l2, #e1e4e8);
   border-radius: 10px;
   background: var(--dsw-alias-bg-sub, #f7f8fa);
 }
+.dsh-cloudq-usage__card-value-row {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+.dsh-cloudq-usage__card-unit {
+  font-size: 13px;
+  color: var(--dsw-alias-label-secondary, #626a76);
+}
+.dsh-cloudq-usage__free-badge {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 1px 8px;
+  border-radius: 999px;
+  background: var(--dsw-alias-state-business-primary-bg, #e8efff);
+  color: var(--dsw-alias-state-business-primary, #315efb);
+  font-size: 12px;
+  cursor: help;
+}
+.dsh-cloudq-usage__free-badge .dsh-cloudq-tooltip {
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity .12s ease;
+}
+.dsh-cloudq-usage__free-badge:hover .dsh-cloudq-tooltip,
+.dsh-cloudq-usage__free-badge:focus-visible .dsh-cloudq-tooltip {
+  opacity: 1;
+  visibility: visible;
+}
+.dsh-cloudq-usage__range {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+  margin-bottom: 12px;
+}
+.dsh-cloudq-usage__range-picker {
+  position: relative;
+}
+.dsh-cloudq-usage__range-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  height: 28px;
+  padding: 0 10px;
+  border: 1px solid var(--dsw-alias-interactive-border, #cdd3da);
+  border-radius: 6px;
+  background: var(--dsw-alias-bg-card, #fff);
+  color: var(--dsw-alias-label-primary, #1d2129);
+  font-size: 12px;
+  cursor: pointer;
+  transition: border-color .15s ease, box-shadow .15s ease;
+}
+.dsh-cloudq-usage__range-btn:hover {
+  border-color: var(--dsw-alias-state-business-primary, #315efb);
+}
+.dsh-cloudq-usage__range-picker.is-open .dsh-cloudq-usage__range-btn {
+  border-color: var(--dsw-alias-state-business-primary, #315efb);
+  box-shadow: 0 0 0 2px rgba(49, 94, 251, .12);
+}
+.dsh-cloudq-usage__range-btn-chevron {
+  font-size: 10px;
+  color: var(--dsw-alias-label-tertiary, #9aa1ab);
+  transition: transform .15s ease;
+}
+.dsh-cloudq-usage__range-picker.is-open .dsh-cloudq-usage__range-btn-chevron {
+  transform: rotate(180deg);
+}
+.dsh-cloudq-usage__range-menu {
+  position: absolute;
+  z-index: 1400;
+  top: calc(100% + 6px);
+  left: 0;
+  min-width: 136px;
+  padding: 4px;
+  border: 1px solid var(--dsw-alias-border-l2, #e1e4e8);
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-card, #fff);
+  box-shadow: 0 8px 24px rgba(29, 33, 41, .12);
+}
+.dsh-cloudq-usage__range-option {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  width: 100%;
+  padding: 6px 8px;
+  border: 0;
+  border-radius: 5px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary, #1d2129);
+  font-size: 12px;
+  text-align: left;
+  cursor: pointer;
+}
+.dsh-cloudq-usage__range-option:hover {
+  background: var(--dsw-alias-bg-sub, #f2f4f8);
+}
+.dsh-cloudq-usage__range-option.is-active {
+  color: var(--dsw-alias-state-business-primary, #315efb);
+  font-weight: 500;
+}
+.dsh-cloudq-usage__range-option-check {
+  width: 14px;
+  flex: none;
+  color: var(--dsw-alias-state-business-primary, #315efb);
+  visibility: hidden;
+}
+.dsh-cloudq-usage__range-option.is-active .dsh-cloudq-usage__range-option-check {
+  visibility: visible;
+}
+.dsh-cloudq-usage__date {
+  height: 28px;
+  padding: 0 8px;
+  border: 1px solid var(--dsw-alias-interactive-border, #cdd3da);
+  border-radius: 6px;
+  background: var(--dsw-alias-bg-card, #fff);
+  color: var(--dsw-alias-label-primary, #1d2129);
+  font-size: 12px;
+  outline: none;
+  transition: border-color .15s ease, box-shadow .15s ease;
+}
+.dsh-cloudq-usage__date:focus {
+  border-color: var(--dsw-alias-state-business-primary, #315efb);
+  box-shadow: 0 0 0 2px rgba(49, 94, 251, .12);
+}
+.dsh-cloudq-usage__range-error {
+  font-size: 12px;
+  color: var(--dsw-alias-state-danger, #d54941);
+}
 .dsh-cloudq-usage__card-label {
   font-size: 12px;
   color: var(--dsw-alias-label-tertiary, #9aa1ab);
@@ -1745,22 +1880,58 @@ display: none;
 		const API_ARCH_DIRECTORIES = "/api/dsh-cloudq/architecture/directories";
 		const API_ARCH_LIST = "/api/dsh-cloudq/architecture/list";
 		const CLOUDQ_ARCH_FOLDER_KEY = "dsh-cloudq.architecture-folder-id";
-		function defaultUsageRange() {
+		const USAGE_RANGE_PRESETS = [
+			{
+				id: "3d",
+				label: "最近 3 天",
+				days: 3
+			},
+			{
+				id: "7d",
+				label: "最近 1 周",
+				days: 7
+			},
+			{
+				id: "30d",
+				label: "最近 1 月",
+				days: 30
+			},
+			{
+				id: "custom",
+				label: "自定义",
+				days: 0
+			}
+		];
+		let usagePreset = "7d";
+		let usageCustomStart = "";
+		let usageCustomEnd = "";
+		function formatUsageTimestamp(d) {
+			const pad = (n) => String(n).padStart(2, "0");
+			return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+		}
+		/** Resolve the current range to API timestamps; null when custom dates are incomplete. */
+		function usageRangeTimestamps() {
+			if (usagePreset === "custom") {
+				if (!usageCustomStart || !usageCustomEnd) return null;
+				return {
+					start: `${usageCustomStart} 00:00:00`,
+					end: `${usageCustomEnd} 23:59:59`
+				};
+			}
+			const preset = USAGE_RANGE_PRESETS.find((item) => item.id === usagePreset) ?? USAGE_RANGE_PRESETS[1];
 			const end = /* @__PURE__ */ new Date();
-			const start = /* @__PURE__ */ new Date(end.getTime() - 6048e5);
-			const fmt = (d) => {
-				const pad = (n) => String(n).padStart(2, "0");
-				return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-			};
 			return {
-				start: fmt(start),
-				end: fmt(end)
+				start: formatUsageTimestamp(/* @__PURE__ */ new Date(end.getTime() - preset.days * 24 * 60 * 60 * 1e3)),
+				end: formatUsageTimestamp(end)
 			};
 		}
 		function formatCredits(value) {
 			const num = typeof value === "number" ? value : Number(value);
 			if (!Number.isFinite(num)) return "—";
-			return num.toFixed(2);
+			return num.toLocaleString("en-US", {
+				minimumFractionDigits: 2,
+				maximumFractionDigits: 2
+			});
 		}
 		function formatDateTime(raw) {
 			if (!raw) return "—";
@@ -1822,93 +1993,221 @@ display: none;
 		let architecturePickerCleanup = null;
 		function renderUsageView() {
 			panelBody.textContent = "";
-			const range = defaultUsageRange();
-			const hint = document.createElement("div");
-			hint.className = "dsh-cloudq-panel__hint";
-			hint.textContent = "正在加载用量…";
-			panelBody.appendChild(hint);
-			cloudqRequest(`${API_USAGE}?start=${encodeURIComponent(range.start)}&end=${encodeURIComponent(range.end)}`).then((data) => {
-				if (panelView !== "usage" || !panelExpanded) return;
-				panelBody.textContent = "";
-				const overview = data.overview ?? {};
-				const rows = Array.isArray(data.detail) ? data.detail : [];
-				const overviewWrap = document.createElement("div");
-				overviewWrap.className = "dsh-cloudq-usage__overview";
-				const createUsageCard = (labelText, valueText, detailText) => {
-					const card = document.createElement("div");
-					card.className = "dsh-cloudq-usage__card";
-					const label = document.createElement("div");
-					label.className = "dsh-cloudq-usage__card-label";
-					label.textContent = labelText;
-					const value = document.createElement("div");
-					value.className = "dsh-cloudq-usage__card-value";
-					value.textContent = valueText;
-					const detail = document.createElement("div");
-					detail.className = "dsh-cloudq-usage__card-sub";
-					detail.textContent = detailText;
-					card.append(label, value, detail);
-					return card;
-				};
-				const cardTotal = createUsageCard("剩余积分", formatCredits(overview.TotalCredits), `自 ${overview.TotalStartDate ?? "—"} 起累计`);
-				const monthly = overview.MonthlyCredits;
-				const cardMonthly = createUsageCard("本月积分", monthly === null || monthly === void 0 ? "—" : formatCredits(monthly), overview.MonthlyStartDate ? `起于 ${overview.MonthlyStartDate}` : "暂无月度数据");
-				overviewWrap.append(cardTotal, cardMonthly);
-				const table = document.createElement("table");
-				table.className = "dsh-cloudq-usage__table";
-				const thead = document.createElement("thead");
-				const headerRow = document.createElement("tr");
-				for (const heading of [
-					"时间",
-					"渠道",
-					"内容",
-					"积分"
-				]) {
-					const cell = document.createElement("th");
-					cell.textContent = heading;
-					headerRow.appendChild(cell);
-				}
-				thead.appendChild(headerRow);
-				table.appendChild(thead);
-				const tbody = document.createElement("tbody");
-				if (rows.length === 0) {
-					const tr = document.createElement("tr");
-					const empty = document.createElement("td");
-					empty.colSpan = 4;
-					empty.className = "dsh-cloudq-usage__table__empty";
-					empty.textContent = "近 7 天暂无用量记录";
-					tr.appendChild(empty);
-					tbody.appendChild(tr);
-				} else for (const row of rows) {
-					const tr = document.createElement("tr");
-					const time = document.createElement("td");
-					time.textContent = formatDateTime(row.StartTime);
-					const channel = document.createElement("td");
-					channel.textContent = row.Channel ?? "—";
-					const message = document.createElement("td");
-					const msgSpan = document.createElement("span");
-					msgSpan.className = "dsh-cloudq-usage__table__message";
-					msgSpan.textContent = row.Message ?? "";
-					message.appendChild(msgSpan);
-					const credits = document.createElement("td");
-					credits.className = "dsh-cloudq-usage__table__credits";
-					credits.textContent = formatCredits(row.Credits);
-					tr.appendChild(time);
-					tr.appendChild(channel);
-					tr.appendChild(message);
-					tr.appendChild(credits);
-					tbody.appendChild(tr);
+			const overviewWrap = document.createElement("div");
+			overviewWrap.className = "dsh-cloudq-usage__overview";
+			const card = document.createElement("div");
+			card.className = "dsh-cloudq-usage__card";
+			const label = document.createElement("div");
+			label.className = "dsh-cloudq-usage__card-label";
+			label.textContent = "累计消耗 Credit";
+			const valueRow = document.createElement("div");
+			valueRow.className = "dsh-cloudq-usage__card-value-row";
+			const value = document.createElement("span");
+			value.className = "dsh-cloudq-usage__card-value";
+			value.textContent = "…";
+			const unit = document.createElement("span");
+			unit.className = "dsh-cloudq-usage__card-unit";
+			unit.textContent = "个";
+			const freeBadge = document.createElement("span");
+			freeBadge.className = "dsh-cloudq-usage__free-badge";
+			freeBadge.textContent = "公测期免费 ⓘ";
+			freeBadge.tabIndex = 0;
+			const freeBadgeTip = document.createElement("span");
+			freeBadgeTip.className = "dsh-cloudq-tooltip";
+			freeBadgeTip.setAttribute("role", "tooltip");
+			freeBadgeTip.textContent = "正式计费将提前 1 个月通知";
+			freeBadge.appendChild(freeBadgeTip);
+			valueRow.append(value, unit, freeBadge);
+			card.append(label, valueRow);
+			overviewWrap.appendChild(card);
+			panelBody.appendChild(overviewWrap);
+			const rangeBar = document.createElement("div");
+			rangeBar.className = "dsh-cloudq-usage__range";
+			const picker = document.createElement("div");
+			picker.className = "dsh-cloudq-usage__range-picker";
+			const pickerBtn = document.createElement("button");
+			pickerBtn.type = "button";
+			pickerBtn.className = "dsh-cloudq-usage__range-btn";
+			pickerBtn.setAttribute("aria-haspopup", "listbox");
+			pickerBtn.setAttribute("aria-expanded", "false");
+			pickerBtn.setAttribute("aria-label", "用量时间范围");
+			const pickerLabel = document.createElement("span");
+			pickerLabel.className = "dsh-cloudq-usage__range-btn-label";
+			const pickerChevron = document.createElement("span");
+			pickerChevron.className = "dsh-cloudq-usage__range-btn-chevron";
+			pickerChevron.textContent = "▾";
+			pickerBtn.append(pickerLabel, pickerChevron);
+			const menu = document.createElement("div");
+			menu.className = "dsh-cloudq-usage__range-menu";
+			menu.setAttribute("role", "listbox");
+			menu.hidden = true;
+			const optionButtons = /* @__PURE__ */ new Map();
+			for (const preset of USAGE_RANGE_PRESETS) {
+				const option = document.createElement("button");
+				option.type = "button";
+				option.className = "dsh-cloudq-usage__range-option";
+				option.setAttribute("role", "option");
+				const check = document.createElement("span");
+				check.className = "dsh-cloudq-usage__range-option-check";
+				check.textContent = "✓";
+				const text = document.createElement("span");
+				text.textContent = preset.label;
+				option.append(check, text);
+				option.addEventListener("click", () => {
+					usagePreset = preset.id;
+					syncPicker();
+					closeMenu();
+					syncCustomVisibility();
+					loadUsage();
+				});
+				optionButtons.set(preset.id, option);
+				menu.appendChild(option);
+			}
+			const syncPicker = () => {
+				const active = USAGE_RANGE_PRESETS.find((item) => item.id === usagePreset) ?? USAGE_RANGE_PRESETS[1];
+				pickerLabel.textContent = active.label;
+				for (const [id, option] of optionButtons) {
+					const isActive = id === active.id;
+					option.classList.toggle("is-active", isActive);
+					option.setAttribute("aria-selected", String(isActive));
 				}
-				table.appendChild(tbody);
-				panelBody.appendChild(overviewWrap);
-				panelBody.appendChild(table);
-			}).catch((error) => {
-				if (!panelExpanded) return;
-				panelBody.textContent = "";
-				const err = document.createElement("div");
-				err.className = "dsh-cloudq-panel__error";
-				err.textContent = `用量加载失败：${error.message}`;
-				panelBody.appendChild(err);
+			};
+			const pickerAbort = new AbortController();
+			const closeMenu = () => {
+				menu.hidden = true;
+				picker.classList.remove("is-open");
+				pickerBtn.setAttribute("aria-expanded", "false");
+			};
+			pickerBtn.addEventListener("click", () => {
+				const willOpen = menu.hidden;
+				menu.hidden = !willOpen;
+				picker.classList.toggle("is-open", willOpen);
+				pickerBtn.setAttribute("aria-expanded", String(willOpen));
 			});
+			document.addEventListener("mousedown", (event) => {
+				if (!menu.isConnected) {
+					pickerAbort.abort();
+					return;
+				}
+				if (!picker.contains(event.target)) closeMenu();
+			}, { signal: pickerAbort.signal });
+			document.addEventListener("keydown", (event) => {
+				if (!menu.isConnected) return;
+				if (event.key === "Escape") closeMenu();
+			}, { signal: pickerAbort.signal });
+			syncPicker();
+			const startDate = document.createElement("input");
+			startDate.type = "date";
+			startDate.className = "dsh-cloudq-usage__date";
+			startDate.setAttribute("aria-label", "开始日期");
+			startDate.value = usageCustomStart;
+			const endDate = document.createElement("input");
+			endDate.type = "date";
+			endDate.className = "dsh-cloudq-usage__date";
+			endDate.setAttribute("aria-label", "结束日期");
+			endDate.value = usageCustomEnd;
+			const rangeError = document.createElement("span");
+			rangeError.className = "dsh-cloudq-usage__range-error";
+			const syncCustomVisibility = () => {
+				const custom = usagePreset === "custom";
+				startDate.hidden = !custom;
+				endDate.hidden = !custom;
+			};
+			const tableWrap = document.createElement("div");
+			const loadUsage = () => {
+				const range = usageRangeTimestamps();
+				rangeError.textContent = "";
+				if (!range) {
+					tableWrap.textContent = "";
+					const hint = document.createElement("div");
+					hint.className = "dsh-cloudq-panel__hint";
+					hint.textContent = "请选择开始日期与结束日期。";
+					tableWrap.appendChild(hint);
+					return;
+				}
+				if (usagePreset === "custom" && usageCustomStart > usageCustomEnd) {
+					rangeError.textContent = "开始日期不能晚于结束日期。";
+					return;
+				}
+				tableWrap.textContent = "";
+				const hint = document.createElement("div");
+				hint.className = "dsh-cloudq-panel__hint";
+				hint.textContent = "正在加载用量…";
+				tableWrap.appendChild(hint);
+				cloudqRequest(`${API_USAGE}?start=${encodeURIComponent(range.start)}&end=${encodeURIComponent(range.end)}`).then((data) => {
+					if (panelView !== "usage" || !panelExpanded) return;
+					value.textContent = formatCredits(data.overview?.TotalCredits);
+					const rows = Array.isArray(data.detail) ? data.detail : [];
+					tableWrap.textContent = "";
+					const table = document.createElement("table");
+					table.className = "dsh-cloudq-usage__table";
+					const thead = document.createElement("thead");
+					const headerRow = document.createElement("tr");
+					for (const heading of [
+						"时间",
+						"渠道",
+						"内容",
+						"积分"
+					]) {
+						const cell = document.createElement("th");
+						cell.textContent = heading;
+						headerRow.appendChild(cell);
+					}
+					thead.appendChild(headerRow);
+					table.appendChild(thead);
+					const tbody = document.createElement("tbody");
+					if (rows.length === 0) {
+						const tr = document.createElement("tr");
+						const empty = document.createElement("td");
+						empty.colSpan = 4;
+						empty.className = "dsh-cloudq-usage__table__empty";
+						empty.textContent = "当前时间范围内暂无用量记录";
+						tr.appendChild(empty);
+						tbody.appendChild(tr);
+					} else for (const row of rows) {
+						const tr = document.createElement("tr");
+						const time = document.createElement("td");
+						time.textContent = formatDateTime(row.StartTime);
+						const channel = document.createElement("td");
+						channel.textContent = row.Channel ?? "—";
+						const message = document.createElement("td");
+						const msgSpan = document.createElement("span");
+						msgSpan.className = "dsh-cloudq-usage__table__message";
+						msgSpan.textContent = row.Message ?? "";
+						message.appendChild(msgSpan);
+						const credits = document.createElement("td");
+						credits.className = "dsh-cloudq-usage__table__credits";
+						credits.textContent = formatCredits(row.Credits);
+						tr.appendChild(time);
+						tr.appendChild(channel);
+						tr.appendChild(message);
+						tr.appendChild(credits);
+						tbody.appendChild(tr);
+					}
+					table.appendChild(tbody);
+					tableWrap.appendChild(table);
+				}).catch((error) => {
+					if (panelView !== "usage" || !panelExpanded) return;
+					tableWrap.textContent = "";
+					const err = document.createElement("div");
+					err.className = "dsh-cloudq-panel__error";
+					err.textContent = cloudqPanelErrorText(error, "用量加载失败");
+					tableWrap.appendChild(err);
+				});
+			};
+			const onCustomDateChange = () => {
+				usageCustomStart = startDate.value;
+				usageCustomEnd = endDate.value;
+				loadUsage();
+			};
+			startDate.addEventListener("change", onCustomDateChange);
+			endDate.addEventListener("change", onCustomDateChange);
+			picker.append(pickerBtn, menu);
+			rangeBar.append(picker, startDate, endDate, rangeError);
+			syncCustomVisibility();
+			panelBody.appendChild(rangeBar);
+			panelBody.appendChild(tableWrap);
+			loadUsage();
 		}
 		const INSPIRATION_TABS = [
 			{
@@ -2009,7 +2308,7 @@ display: none;
 				list.textContent = "";
 				const err = document.createElement("div");
 				err.className = "dsh-cloudq-panel__error";
-				err.textContent = `灵感加载失败：${error instanceof Error ? error.message : "未知错误"}`;
+				err.textContent = cloudqPanelErrorText(error, "灵感加载失败");
 				list.appendChild(err);
 			});
 		}
@@ -2152,7 +2451,7 @@ display: none;
 				panelBody.textContent = "";
 				const err = document.createElement("div");
 				err.className = "dsh-cloudq-panel__error";
-				err.textContent = `制品加载失败：${error instanceof Error ? error.message : "未知错误"}`;
+				err.textContent = cloudqPanelErrorText(error, "制品加载失败");
 				panelBody.appendChild(err);
 			});
 		}
@@ -2433,7 +2732,7 @@ display: none;
 						summary.textContent = "加载失败";
 						const err = document.createElement("div");
 						err.className = "dsh-cloudq-panel__error";
-						err.textContent = `架构图加载失败：${error instanceof Error ? error.message : "未知错误"}`;
+						err.textContent = cloudqPanelErrorText(error, "架构图加载失败");
 						grid.appendChild(err);
 					});
 				};
@@ -2452,7 +2751,7 @@ display: none;
 				panelBody.textContent = "";
 				const err = document.createElement("div");
 				err.className = "dsh-cloudq-panel__error";
-				err.textContent = `架构目录加载失败：${error instanceof Error ? error.message : "未知错误"}`;
+				err.textContent = cloudqPanelErrorText(error, "架构目录加载失败");
 				panelBody.appendChild(err);
 			});
 		}
@@ -2732,8 +3031,6 @@ display: none;
 			};
 		}
 		const API_CREDENTIAL = "/api/dsh-cloudq/credential";
-		const API_LOGIN_URL = "/api/dsh-cloudq/login/url";
-		const API_LOGIN_SAVE = "/api/dsh-cloudq/login/save";
 		const API_LOGOUT = "/api/dsh-cloudq/logout";
 		const API_CREDENTIAL_TEST = "/api/dsh-cloudq/credential/test";
 		const API_CREDENTIAL_SAVE = "/api/dsh-cloudq/credential/save";
@@ -2744,6 +3041,14 @@ display: none;
 				this.code = code;
 			}
 		};
+		/**
+		* Panel-facing error text. A missing credential gets an actionable pointer to
+		* the settings card instead of a raw load failure message.
+		*/
+		function cloudqPanelErrorText(error, prefix) {
+			if (error instanceof CloudQApiError && error.code === "NeedAuth") return "尚未配置 AK/SK，请前往「设置 → 插件 → CloudQ」完成配置后重试。";
+			return `${prefix}：${error instanceof Error ? error.message : "未知错误"}`;
+		}
 		async function cloudqRequest(url, init, timeoutMs = 2e4) {
 			const controller = new AbortController();
 			const timeout = window.setTimeout(() => controller.abort(), timeoutMs);
@@ -2788,9 +3093,8 @@ display: none;
 			const [loading, setLoading] = react.useState(true);
 			const [busy, setBusy] = react.useState();
 			const [status, setStatus] = react.useState();
-			const [authorizeUrl, setAuthorizeUrl] = react.useState("");
-			const [code, setCode] = react.useState("");
 			const [feedback, setFeedback] = react.useState();
+			const [validated, setValidated] = react.useState(false);
 			const [secretId, setSecretId] = react.useState("");
 			const [secretKey, setSecretKey] = react.useState("");
 			const refresh = react.useCallback(async () => {
@@ -2810,61 +3114,13 @@ display: none;
 			react.useEffect(() => {
 				refresh();
 			}, [refresh]);
-			const handleGetAuthorizeUrl = async () => {
-				setBusy("url");
-				setFeedback(void 0);
-				try {
-					const response = await cloudqRequest(API_LOGIN_URL, { method: "POST" });
-					setAuthorizeUrl(response.authorize_url);
-					if (response.authorize_url) window.open(response.authorize_url, "_blank", "noopener");
-				} catch (error) {
-					setFeedback({
-						kind: "error",
-						text: error.message
-					});
-				} finally {
-					setBusy(void 0);
-				}
-			};
-			const handleSaveCode = async () => {
-				const trimmed = code.trim();
-				if (!trimmed) {
-					setFeedback({
-						kind: "error",
-						text: "请先在浏览器中完成授权，然后粘贴授权码。"
-					});
-					return;
-				}
-				setBusy("save");
-				setFeedback(void 0);
-				try {
-					const response = await cloudqRequest(API_LOGIN_SAVE, {
-						method: "POST",
-						body: JSON.stringify({ code: trimmed })
-					});
-					setStatus(response.status);
-					setCode("");
-					setFeedback({
-						kind: "success",
-						text: "登录成功，凭证已保存。"
-					});
-				} catch (error) {
-					setFeedback({
-						kind: "error",
-						text: error.message
-					});
-				} finally {
-					setBusy(void 0);
-				}
-			};
 			const handleLogout = async () => {
 				setBusy("logout");
 				setFeedback(void 0);
 				try {
 					await cloudqRequest(API_LOGOUT, { method: "POST" });
 					setStatus({ logged_in: false });
-					setAuthorizeUrl("");
-					setCode("");
+					setValidated(false);
 					setFeedback({
 						kind: "success",
 						text: "已退出登录。"
@@ -2903,26 +3159,27 @@ display: none;
 						setSecretId("");
 						setSecretKey("");
 					}
+					setValidated(true);
 					setFeedback({
 						kind: "success",
 						text: successText
 					});
 				} catch (error) {
+					setValidated(false);
+					const invalid = error instanceof CloudQApiError && error.code !== "network-error" && error.code !== "invalid-response";
 					setFeedback({
 						kind: "error",
-						text: error.message
+						text: invalid ? "AKSK 无效，请检查后重新配置。" : error.message
 					});
 				} finally {
 					setBusy(void 0);
 				}
 			};
-			const handleTestConnection = () => submitAccessKey(API_CREDENTIAL_TEST, "test", "连接成功，该密钥可用于 CloudQ。");
-			const handleSaveAccessKey = () => submitAccessKey(API_CREDENTIAL_SAVE, "save-ak", "配置已保存，密钥已安全存放在 DSH Host 端。");
+			const handleTestConnection = () => submitAccessKey(API_CREDENTIAL_TEST, "test", "连接成功，AKSK 有效。");
+			const handleSaveAccessKey = () => submitAccessKey(API_CREDENTIAL_SAVE, "save-ak", "配置已保存，AKSK 有效。");
 			const loggedIn = status?.logged_in === true;
-			const expired = status?.expired === true;
-			const badgeClass = expired ? "dsh-cloudq-settings-card__badge dsh-cloudq-settings-card__badge--warn" : loggedIn ? "dsh-cloudq-settings-card__badge dsh-cloudq-settings-card__badge--ok" : "dsh-cloudq-settings-card__badge dsh-cloudq-settings-card__badge--off";
-			const badgeText = expired ? "凭证已过期" : loggedIn ? "已登录" : "未登录";
-			const summarySubtitle = loggedIn ? "腾讯云 CloudQ 凭证已激活，可直接使用 CloudQ 模式。" : "用于在 CloudQ 模式下调用腾讯云 SSE API 与 CLI 工具。";
+			const akskValid = validated || loggedIn;
+			const summarySubtitle = akskValid ? "腾讯云 CloudQ 凭证已激活，可直接使用 CloudQ 模式。" : "用于在 CloudQ 模式下调用腾讯云 SSE API 与 CLI 工具。";
 			const disabled = loading || busy !== void 0;
 			return react_jsx_runtime.jsx("section", {
 				className: "dsh-cloudq-settings-card",
@@ -2938,9 +3195,9 @@ display: none;
 							children: [react_jsx_runtime.jsx("strong", { children: "CloudQ" }), react_jsx_runtime.jsx("small", { children: summarySubtitle })]
 						}), react_jsx_runtime.jsx("span", {
 							className: "dsh-cloudq-settings-card__summary-right",
-							children: [react_jsx_runtime.jsx("span", {
-								className: badgeClass,
-								children: [react_jsx_runtime.jsx("span", { className: "dsh-cloudq-settings-card__badge-dot" }), badgeText]
+							children: [akskValid && react_jsx_runtime.jsx("span", {
+								className: "dsh-cloudq-settings-card__badge dsh-cloudq-settings-card__badge--ok",
+								children: [react_jsx_runtime.jsx("span", { className: "dsh-cloudq-settings-card__badge-dot" }), "AKSK有效"]
 							}), react_jsx_runtime.jsx("span", {
 								className: `dsh-cloudq-settings-card__chevron${expanded ? " is-open" : ""}`,
 								children: "▾"
@@ -2952,20 +3209,10 @@ display: none;
 					children: [
 						loading ? react_jsx_runtime.jsx("div", {
 							className: "dsh-cloudq-settings-card__hint",
-							children: "正在检查 CloudQ 登录状态…"
+							children: "正在检查凭证状态…"
 						}) : react_jsx_runtime.jsx("div", {
 							className: "dsh-cloudq-settings-card__rows",
 							children: [
-								react_jsx_runtime.jsx("div", {
-									className: "dsh-cloudq-settings-card__row",
-									children: [react_jsx_runtime.jsx("span", {
-										className: "dsh-cloudq-settings-card__row-key",
-										children: "状态"
-									}), react_jsx_runtime.jsx("span", {
-										className: "dsh-cloudq-settings-card__row-val",
-										children: badgeText
-									})]
-								}),
 								status?.credential_file ? react_jsx_runtime.jsx("div", {
 									className: "dsh-cloudq-settings-card__row",
 									children: [react_jsx_runtime.jsx("span", {
@@ -3023,35 +3270,6 @@ display: none;
 							children: feedback.text
 						}) : null,
 						!loggedIn && react_jsx_runtime.jsx("div", { children: [
-							react_jsx_runtime.jsx("div", {
-								className: "dsh-cloudq-settings-card__actions",
-								children: [react_jsx_runtime.jsx("button", {
-									type: "button",
-									className: "dsh-cloudq-settings-card__btn dsh-cloudq-settings-card__btn--primary",
-									disabled,
-									onClick: handleGetAuthorizeUrl,
-									children: busy === "url" ? "获取中…" : "获取授权链接"
-								})]
-							}),
-							authorizeUrl && react_jsx_runtime.jsx("div", {
-								className: "dsh-cloudq-settings-card__hint",
-								children: "已在新标签页打开授权页。授权完成后，请将页面显示的授权码粘贴到下方："
-							}),
-							react_jsx_runtime.jsx("div", {
-								className: "dsh-cloudq-settings-card__actions dsh-cloudq-settings-card__actions--stacked",
-								children: [react_jsx_runtime.jsx("input", {
-									className: "dsh-cloudq-settings-card__input",
-									placeholder: "粘贴授权码",
-									value: code,
-									onChange: (event) => setCode(event.target.value)
-								}), react_jsx_runtime.jsx("button", {
-									type: "button",
-									className: "dsh-cloudq-settings-card__btn",
-									disabled,
-									onClick: handleSaveCode,
-									children: busy === "save" ? "登录中…" : "完成登录"
-								})]
-							}),
 							react_jsx_runtime.jsx("div", {
 								className: "dsh-cloudq-settings-card__field",
 								children: [
@@ -3281,17 +3499,10 @@ display: none;
 											className: "dsh-cloudq-pm__row-info",
 											children: [react_jsx_runtime.jsx("div", {
 												className: "dsh-cloudq-pm__row-name",
-												children: [
-													plugin.name,
-													plugin.self ? react_jsx_runtime.jsx("span", {
-														className: "dsh-cloudq-pm__row-tag dsh-cloudq-pm__row-tag--self",
-														children: "本插件"
-													}) : null,
-													!on ? react_jsx_runtime.jsx("span", {
-														className: "dsh-cloudq-pm__row-tag dsh-cloudq-pm__row-tag--off",
-														children: "已停用"
-													}) : null
-												]
+												children: [plugin.name, !on ? react_jsx_runtime.jsx("span", {
+													className: "dsh-cloudq-pm__row-tag dsh-cloudq-pm__row-tag--off",
+													children: "已停用"
+												}) : null]
 											}), react_jsx_runtime.jsx("div", {
 												className: "dsh-cloudq-pm__row-bundle",
 												children: `${plugin.id} · ${plugin.bundle}`

package/lib/index.js

@@ -392,9 +392,9 @@ function runScript$1(scriptsDirectory, scriptName, args, { timeoutMs = 3e4, json
 * and referenced through a directory `resourceBase`, so every `{baseDir}`
 * placeholder in the body resolves against the installed package directory.
 *
-* It also exposes a small credential-management API (status / authorize-url /
-* save-code / logout) that the client half renders in the settings panel, so
-* the CloudQ login flow no longer requires touching a terminal.
+* It also exposes a small credential-management API (status / AK-SK test &
+* save / logout) that the client half renders in the settings panel, so the
+* CloudQ credential flow no longer requires touching a terminal.
 *
 * @module dsh-cloudq
 */
@@ -420,8 +420,13 @@ function renderedSkillContent() {
 	return rawSkillContent().replace(/\{baseDir\}/g, baseDir);
 }
 /** Run one helper from the bundled CloudQ skill. */
-function runScript(scriptName, args, options) {
-	return runScript$1(resolve(skillDirectory(), "scripts"), scriptName, args, options);
+async function runScript(scriptName, args, options) {
+	try {
+		return await runScript$1(resolve(skillDirectory(), "scripts"), scriptName, args, options);
+	} catch (error) {
+		if (error instanceof HttpError && error.code === "NeedAuth") throw new HttpError(401, "NeedAuth", "尚未配置 AK/SK，请前往「设置 → 插件 → CloudQ」完成配置。");
+		throw error;
+	}
 }
 /** Remove host filesystem details before returning credential state to the browser. */
 function publicCredentialStatus(status) {
@@ -434,15 +439,6 @@ function publicCredentialStatus(status) {
 async function credentialStatus() {
 	return publicCredentialStatus(await runScript("login.py", ["--status"]));
 }
-function authorizeUrl() {
-	return runScript("login.py", ["--authorize-url"]);
-}
-async function saveAuthCode(code) {
-	return publicCredentialStatus(await runScript("login.py", ["--save", "--stdin"], {
-		stdin: JSON.stringify({ code }),
-		sensitiveValues: [code]
-	}));
-}
 function logout() {
 	return runScript("logout.py", [], { jsonOnly: false });
 }
@@ -616,23 +612,29 @@ const inject = [
 	"sessionQuery"
 ];
 function apply(ctx) {
-	ctx.effect(() => ctx.settings.register(SETTINGS_NAMESPACE, Config, { base: {} }), "dsh-cloudq: settings namespace");
-	ctx.effect(() => ctx.settings.register(PLUGIN_MANAGER_NAMESPACE, Config, { base: {} }), "dsh-cloudq: plugin-manager settings namespace");
-	ctx.effect(() => ctx.skills.register({
-		name: "cloudq",
-		description: "用户咨询腾讯云产品资源、AWS、阿里云等多云资源时，查看智能顾问架构图、架构目录、架构详情、架构评估结果、绘制架构图、开通智能顾问时、AI智能巡检、AI容量监测、AI混沌演练、AI云诊断、主动预警、架构健康度、云运维问答、云资源查询、云成本优化、安全合规、云资源盘点、闲置资源检查、云产品最佳实践等AIOps、ChatOps、CloudOps操作时使用。",
-		whenToUse: "用户要求进入 CloudQ 模式、使用 CloudQ、咨询云上架构/资源/成本/巡检/诊断等多云或腾讯云运维问题，或点击输入栏 CloudQ 按钮时使用；也适用于架构图查看/评估、AI 巡检、容量监测、混沌演练、云诊断等场景。",
-		source: "bundled",
-		resourceBase: {
-			kind: "directory",
-			path: skillDirectory()
-		},
-		content: renderedSkillContent(),
-		invocation: {
-			modelInvocable: true,
-			userInvocable: true
-		}
-	}), "dsh-cloudq: CloudQ skill");
+	ctx.effect(() => {
+		ctx.settings.register(SETTINGS_NAMESPACE, Config, { base: {} });
+	}, "dsh-cloudq: settings namespace");
+	ctx.effect(() => {
+		ctx.settings.register(PLUGIN_MANAGER_NAMESPACE, Config, { base: {} });
+	}, "dsh-cloudq: plugin-manager settings namespace");
+	ctx.effect(() => {
+		ctx.skills.register({
+			name: "cloudq",
+			description: "用户咨询腾讯云产品资源、AWS、阿里云等多云资源时，查看智能顾问架构图、架构目录、架构详情、架构评估结果、绘制架构图、开通智能顾问时、AI智能巡检、AI容量监测、AI混沌演练、AI云诊断、主动预警、架构健康度、云运维问答、云资源查询、云成本优化、安全合规、云资源盘点、闲置资源检查、云产品最佳实践等AIOps、ChatOps、CloudOps操作时使用。",
+			whenToUse: "用户要求进入 CloudQ 模式、使用 CloudQ、咨询云上架构/资源/成本/巡检/诊断等多云或腾讯云运维问题，或点击输入栏 CloudQ 按钮时使用；也适用于架构图查看/评估、AI 巡检、容量监测、混沌演练、云诊断等场景。",
+			source: "bundled",
+			resourceBase: {
+				kind: "directory",
+				path: skillDirectory()
+			},
+			content: renderedSkillContent(),
+			invocation: {
+				modelInvocable: true,
+				userInvocable: true
+			}
+		});
+	}, "dsh-cloudq: CloudQ skill");
 	ctx.effect(() => {
 		const disposers = [];
 		disposers.push(ctx.webServer.register({
@@ -650,41 +652,6 @@ function apply(ctx) {
 				}
 			}
 		}));
-		disposers.push(ctx.webServer.register({
-			kind: "exact",
-			path: "/api/dsh-cloudq/login/url",
-			handler: async (request, response) => {
-				try {
-					assertSafeRequest(request, "POST");
-					const result = await authorizeUrl();
-					sendJson(response, 200, {
-						ok: true,
-						authorize_url: result.authorize_url,
-						state: result.state
-					});
-				} catch (error) {
-					sendError(response, error);
-				}
-			}
-		}));
-		disposers.push(ctx.webServer.register({
-			kind: "exact",
-			path: "/api/dsh-cloudq/login/save",
-			handler: async (request, response) => {
-				try {
-					assertSafeRequest(request, "POST");
-					const body = await readJsonBody(request);
-					const code = typeof body?.code === "string" ? body.code.trim() : "";
-					if (!code) throw new HttpError(400, "missing-code", "缺少授权码。");
-					sendJson(response, 200, {
-						ok: true,
-						status: await saveAuthCode(code)
-					});
-				} catch (error) {
-					sendError(response, error);
-				}
-			}
-		}));
 		disposers.push(ctx.webServer.register({
 			kind: "exact",
 			path: "/api/dsh-cloudq/logout",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cloudq",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CloudQ integration for DeepSeek Harness with secure credential, workspace, and plugin-management surfaces",
   "license": "MIT",
   "type": "module",

package/skills/cloudq/scripts/login.py

@@ -139,7 +139,7 @@ def cmd_status() -> int:
     if cred_data is None:
         print(_json_ok({
             "logged_in": False,
-            "message": "未找到 OAuth 凭证",
+            "message": "未找到凭证",
         }))
         return 0