hiwork-core 0.0.21 → 0.0.22

package/lib/client.js

@@ -142,7 +142,7 @@ function browserLoginViewOf(value) {
   if (loginMode === "form") return { loginMode, browserLoginUrl: void 0, browserLoginPending: false };
   return { loginMode, browserLoginUrl: authorizeUrlOf(value), browserLoginPending: browserLoginPendingOf(value) };
 }
-function openAuthorizeUrl(url) {
+function openExternalUrl(url) {
   if (url === void 0 || url === "") return;
   if (typeof window === "undefined") return;
   let protocol;
@@ -154,6 +154,9 @@ function openAuthorizeUrl(url) {
   if (protocol !== "https:" && protocol !== "http:") return;
   window.open(url, "_blank", "noopener,noreferrer");
 }
+function openAuthorizeUrl(url) {
+  openExternalUrl(url);
+}
 async function requestBrowserLogin(scope) {
   await scope.set("browserLoginRequest", { at: (/* @__PURE__ */ new Date()).toISOString() });
 }
@@ -1318,6 +1321,64 @@ function removeStaleHeroGreeting(doc) {
   for (const stale of Array.from(doc.querySelectorAll("[data-hiwork-hero-greeting]"))) stale.remove();
 }
 
+// src/client/manual-link.ts
+var MANUAL_URL = "https://hiworkapp.hivery.cn/manual.html";
+var MANUAL_STYLE_ID = "hiwork-core-manual-style";
+var MANUAL_STYLE = `
+[data-hiwork-core-manual-entry]{box-sizing:border-box;flex:none;display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;margin-left:auto;padding:0;border:0;border-radius:999px;background:transparent;color:var(--dsw-alias-label-tertiary,#71717a);font-family:inherit;font-size:14px;line-height:1;font-weight:600;cursor:pointer;user-select:none;transition:background .16s ease,color .16s ease}
+[data-hiwork-core-manual-entry]:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(24,24,27,.06));color:var(--dsw-alias-label-secondary,#3f3f46)}
+[data-hiwork-core-manual-entry]:focus-visible{outline:2px solid var(--dsw-alias-button-info-fill,#4c8dff);outline-offset:2px}
+body[data-ds-dark-theme] [data-hiwork-core-manual-entry]{color:var(--dsw-alias-label-tertiary,#9ba3b4)}
+body[data-ds-dark-theme] [data-hiwork-core-manual-entry]:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08));color:var(--dsw-alias-label-secondary,#a6adb8)}
+@media (prefers-reduced-motion: reduce){[data-hiwork-core-manual-entry]{transition:none}}
+`;
+function ensureManualStyle(doc) {
+  if (doc.getElementById(MANUAL_STYLE_ID) !== null) return;
+  if (doc.head === null) return;
+  const style = doc.createElement("style");
+  style.id = MANUAL_STYLE_ID;
+  style.textContent = MANUAL_STYLE;
+  doc.head.append(style);
+}
+function openManual() {
+  openExternalUrl(MANUAL_URL);
+}
+function findManualMount(doc) {
+  const hero = doc.querySelector('[data-phase="hero"]');
+  if (hero === null) return null;
+  return hero.querySelector('[class*="_heroWorkspaceRow"]');
+}
+function buildButton(doc) {
+  const button = doc.createElement("button");
+  button.dataset.hiworkCoreManualEntry = "";
+  button.type = "button";
+  button.title = "\u4F7F\u7528\u624B\u518C";
+  button.setAttribute("aria-label", "\u4F7F\u7528\u624B\u518C");
+  button.append(doc.createTextNode("?"));
+  button.addEventListener("click", (event) => {
+    event.preventDefault();
+    event.stopPropagation();
+    openManual();
+  });
+  return button;
+}
+function removeStaleManualEntry(doc) {
+  for (const stale of Array.from(doc.querySelectorAll("[data-hiwork-core-manual-entry]"))) {
+    stale.remove();
+  }
+}
+function decorateManualEntry(doc) {
+  const row = findManualMount(doc);
+  if (row === null) {
+    removeStaleManualEntry(doc);
+    return;
+  }
+  const existing = row.querySelector(":scope > [data-hiwork-core-manual-entry]");
+  if (existing !== null) return;
+  removeStaleManualEntry(doc);
+  row.append(buildButton(doc));
+}
+
 // src/client/daily-card.ts
 var DAILY_CARD_STYLE_ID = "dcu-daily-card-style";
 var DAILY_MAIN_FONT_SIZE_MAX = 64;
@@ -1608,6 +1669,7 @@ function observeHeroDecorations(doc, quotes) {
   };
   ensureDailyCardStyle(doc);
   ensureHeroStyle(doc);
+  ensureManualStyle(doc);
   let applying = false;
   let frame;
   let lastDailyDay = -1;
@@ -1620,6 +1682,7 @@ function observeHeroDecorations(doc, quotes) {
       if (today !== lastDailyDay) lastDailyDay = today;
       decorateDailyCard(doc, quotes);
       decorateHeroGreeting(doc);
+      decorateManualEntry(doc);
     } finally {
       applying = false;
     }
@@ -1752,6 +1815,8 @@ var footStyle = { margin: "2px 0 0", fontSize: 11, color: INK_CAPTION, textAlign
 var browserHintStyle = { margin: 0, fontSize: 12, lineHeight: 1.6, color: INK_CAPTION, textAlign: "center" };
 var browserActionsStyle = { display: "flex", alignItems: "center", justifyContent: "center", gap: 18 };
 var toggleStyle = { ...linkButton, alignSelf: "center", fontSize: 12.5 };
+var footBlockStyle = { display: "flex", flexDirection: "column", alignItems: "center", gap: 4 };
+var manualLinkStyle = { ...linkButton, fontWeight: 500 };
 function describeLoginError(error) {
   if (error === void 0) return void 0;
   if (error.code === "GATEWAY_UNREACHABLE") return "\u7F51\u5173\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u6539\u7528\u8D26\u53F7\u5BC6\u7801\u767B\u5F55";
@@ -1887,7 +1952,10 @@ function LoginGateModal(props) {
         browserLogin,
         form,
         showBrowserLogin && formVisible ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { "data-hiwork-core-secondary": true, "data-hiwork-core-form-collapse": true, type: "button", style: toggleStyle, onClick: () => setFormOpen(false), children: "\u6536\u8D77\u8D26\u53F7\u5BC6\u7801\u767B\u5F55" }) : null,
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: footStyle, children: "\u4F01\u4E1A\u7EDF\u4E00\u8EAB\u4EFD\u8BA4\u8BC1 \xB7 LDAP" })
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: footBlockStyle, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: footStyle, children: "\u4F01\u4E1A\u7EDF\u4E00\u8EAB\u4EFD\u8BA4\u8BC1 \xB7 LDAP" }),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("button", { "data-hiwork-core-secondary": true, "data-hiwork-core-manual-login": true, type: "button", style: manualLinkStyle, onClick: openManual, children: "\u4F7F\u7528\u624B\u518C" })
+        ] })
       ] })
     ] })
   ] });

package/lib/index.js

@@ -3137,7 +3137,7 @@ function isUnloading(ctx) {
 }
 
 // src/version.ts
-var PKG_VERSION = false ? "dev" : "0.0.21";
+var PKG_VERSION = false ? "dev" : "0.0.22";
 
 // src/ai-router-client.ts
 var AUTH_AUTHORIZE_PATH = "/api/auth/authorize";

package/lib/types/client/controller.d.ts

@@ -158,8 +158,16 @@ export declare function browserLoginViewOf(value: AiRouterCardSettings | undefin
     browserLoginPending: boolean;
 };
 /**
- * 打开授权页（渲染层职责）：桌面端 `shell.openExternal` 路由接管 https 外链，桌面端无需改动。
- * 命名空间值可被任意写入，因此只放行 http(s)，其余静默忽略。
+ * 在系统浏览器里打开外链（渲染层职责）：桌面端 `shell.openExternal` 路由接管 https 外链，
+ * 桌面端无需改动。
+ *
+ * 只放行 http(s)：调用方给的可能是命名空间里被任意写入的值，也可能是将来变成用户可填的常量，
+ * `javascript:` / `file:` 之类一律静默忽略。URL 非法同样 no-op —— 外链打开失败不该抛错打断调用方。
+ * @param url - 目标地址；缺省 / 非 http(s) / 非法时为 no-op。
+ */
+export declare function openExternalUrl(url: string | undefined): void;
+/**
+ * 打开授权页。
  * @param url - Host 回写的授权页 URL；缺省 / 非法时为 no-op。
  */
 export declare function openAuthorizeUrl(url: string | undefined): void;

package/lib/types/client/daily-card.d.ts

@@ -72,8 +72,10 @@ export declare function decorateDailyCard(doc: Document, quotes: DailyQuoteSourc
 export declare function removeStaleDailyCard(doc: Document): void;
 /**
  * 观察新建任务 hero 页并装饰同页组件：每日一句（服务端下发）+ hero 问候语轮换
- * （见 hero-greeting.ts）。DOM 变更按帧合并，避免流式输出时每个 token 都全文档扫描；
- * 页面完全空闲跨午夜时 MutationObserver 不会触发，靠周期轮询兜底换日（本地日变更
- * 触发重新拉取，服务端日期随之更新）。返回卸载清理函数。
+ * （见 hero-greeting.ts）+ 输入框右上方居右的「使用手册」问号按钮（见 manual-link.ts）。
+ * DOM 变更按帧合并，避免流式输出时每个 token 都全文档扫描；页面完全空闲跨午夜时
+ * MutationObserver 不会触发，靠周期轮询兜底换日（本地日变更触发重新拉取，服务端日期
+ * 随之更新）。三个装饰共用一个观察循环，不各自起 MutationObserver。
+ * 返回卸载清理函数。
  */
 export declare function observeHeroDecorations(doc: Document, quotes: DailyQuoteSource): () => void;

package/lib/types/client/manual-link.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 使用手册地址 —— **全仓唯一一处**写死这个域名的地方（与 pms-client 的 PMS_BASE_URL 同一约定）。
+ *
+ * 为什么固定而不是配置项：官网是组织自建且只有这一个生产部署，做成设置项只会多一个能填错、
+ * 又没人能集中改的地方；真要换部署，改这一个常量、发一版即可。**任何别处都不许再写这个域名**
+ * （包括错误消息、日志、文档示例之外的代码），否则「唯一的基址」立刻变成两处能漂移的真相。
+ */
+export declare const MANUAL_URL = "https://hiworkapp.hivery.cn/manual.html";
+export declare const MANUAL_STYLE_ID = "hiwork-core-manual-style";
+/**
+ * 问号按钮：28×28 的圆形热区、无边框（与输入框自身的图标按钮同语言），hover 才浮出一层浅底。
+ * `margin-left:auto` 是「居右」的全部机制——该行是 flex 容器，自动外边距吃掉剩余空间。
+ * `flex:none` 保证窄窗口下被两个 chip 挤扁时不至于缩成一个点。
+ */
+export declare const MANUAL_STYLE = "\n[data-hiwork-core-manual-entry]{box-sizing:border-box;flex:none;display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;margin-left:auto;padding:0;border:0;border-radius:999px;background:transparent;color:var(--dsw-alias-label-tertiary,#71717a);font-family:inherit;font-size:14px;line-height:1;font-weight:600;cursor:pointer;user-select:none;transition:background .16s ease,color .16s ease}\n[data-hiwork-core-manual-entry]:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(24,24,27,.06));color:var(--dsw-alias-label-secondary,#3f3f46)}\n[data-hiwork-core-manual-entry]:focus-visible{outline:2px solid var(--dsw-alias-button-info-fill,#4c8dff);outline-offset:2px}\nbody[data-ds-dark-theme] [data-hiwork-core-manual-entry]{color:var(--dsw-alias-label-tertiary,#9ba3b4)}\nbody[data-ds-dark-theme] [data-hiwork-core-manual-entry]:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08));color:var(--dsw-alias-label-secondary,#a6adb8)}\n@media (prefers-reduced-motion: reduce){[data-hiwork-core-manual-entry]{transition:none}}\n";
+export declare function ensureManualStyle(doc: Document): void;
+/** 在系统浏览器里打开使用手册（桌面端 shell 接管 https 外链）。 */
+export declare function openManual(): void;
+/**
+ * hero 页里 workspace 行的定位：只在 `[data-phase="hero"]` 下找。
+ * 类名后缀稳定、前缀是构建哈希，故按 `*=` 匹配（同 daily-card 的 `[class$="_headline"]`）。
+ * 行本身缺失（非 hero 页 / 宿主改版）→ null，调用方只做清理。
+ */
+export declare function findManualMount(doc: Document): HTMLElement | null;
+/** 清掉非 hero 状态下（以及行被重建后）残留的按钮节点。 */
+export declare function removeStaleManualEntry(doc: Document): void;
+/**
+ * 幂等装饰：把问号按钮挂到 hero 输入框那一行的末尾（`margin-left:auto` 使其居右）。
+ *
+ * 已挂着且仍在该行内 → 不动（宿主流式重渲染时不做无谓的摘挂，避免按钮闪一下）；
+ * 行不在场（会话记录页 / 登录门禁 / 宿主未渲染）→ 清掉残留。
+ * 只在**最后一个**子节点插入：宿主自己的 chip 顺序不受影响，将来它再往行里加东西，
+ * 我们的按钮仍在右侧。
+ */
+export declare function decorateManualEntry(doc: Document): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiwork-core",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "type": "module",
   "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
   "license": "UNLICENSED",