@qzsy/zhidao-skill 0.0.0-stage → 0.1.1

package/dist/form.js

@@ -0,0 +1,37 @@
+/**
+ * 按至道页面的 jQuery 方式编码表单。
+ * JSON 请求体在发出去之前先过这里。
+ */
+/**
+ * 把对象编码成查询串。
+ * `undefined` 省略，`null` 编码成空字符串。
+ */
+export function encodeForm(data) {
+    if (!data)
+        return "";
+    const pairs = [];
+    for (const key of Object.keys(data)) {
+        const value = data[key];
+        if (value === undefined)
+            continue;
+        appendParam(pairs, key, value);
+    }
+    return pairs.join("&");
+}
+function appendParam(pairs, key, value) {
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => {
+            const marker = item !== null && typeof item === "object" ? String(index) : "";
+            appendParam(pairs, `${key}[${marker}]`, item);
+        });
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        for (const child of Object.keys(value))
+            appendParam(pairs, `${key}[${child}]`, value[child]);
+        return;
+    }
+    const text = value == null ? "" : String(value);
+    pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(text)}`);
+}
+//# sourceMappingURL=form.js.map

package/dist/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAA2C;IACpE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,KAAe,EAAE,GAAW,EAAE,KAAgB;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAC7E,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,MAAM,GAAG,EAAE,IAAI,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QACF,OAAM;IACR,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,KAAK,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QAC5F,OAAM;IACR,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACtE,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 用 Node.js 全局 fetch 调用至道后台。
+ * Cookie 从会话带上，响应里的 Set-Cookie 写回同一份会话。
+ */
+import type { FormValue } from "./form.js";
+import type { ZhidaoSession } from "./session.js";
+/**
+ * 一次上游调用。
+ * `path` 以 `/` 开头，和 OpenAPI 里的路径一致。
+ */
+export interface ZhidaoCall {
+    /**
+     * HTTP 方法。
+     * 使用大写，例如 `GET`、`POST`。
+     */
+    method: string;
+    /**
+     * 上游路径。
+     * 例如 `/login/captcha`、`/tableRecord/submitTaskNew`。
+     */
+    path: string;
+    /**
+     * 查询参数。
+     * 登录令牌会另外附在 `idToken` 上，不必在这里重复。
+     */
+    query?: Record<string, FormValue>;
+    /**
+     * 表单字段。
+     * POST 时按 `application/x-www-form-urlencoded` 提交。
+     */
+    body?: Record<string, FormValue>;
+    /**
+     * 是否附带登录令牌。
+     * 验证码和登录请求本身不要带。
+     */
+    withToken?: boolean;
+}
+/**
+ * fetch 的原始结果。
+ * 业务是否成功由调用方看 JSON 里的 `code`。
+ */
+export interface ZhidaoHttpResult {
+    /**
+     * HTTP 状态码。
+     * 跟随重定向之后的最终响应。
+     */
+    status: number;
+    /**
+     * 响应 Content-Type。
+     * 不带参数。
+     */
+    contentType: string;
+    /**
+     * 响应体字节。
+     * 验证码图片直接用它转 base64。
+     */
+    bytes: Uint8Array;
+}
+/**
+ * 发送一次请求，并把新 Cookie 留在会话对象上。
+ * 调用方负责 `saveSession`。
+ */
+export declare function request(session: ZhidaoSession, call: ZhidaoCall): Promise<ZhidaoHttpResult>;
+/**
+ * 拼出最终地址。
+ * 有令牌且这次调用允许时，加上查询参数 `idToken`。
+ */
+export declare function buildUrl(session: ZhidaoSession, call: ZhidaoCall): string;
+/**
+ * 根据文件头判断图片类型。
+ * 对不上时返回空字符串。
+ */
+export declare function imageMediaType(headerType: string, bytes: Uint8Array): string;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEhC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,KAAK,EAAE,UAAU,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqCjG;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAmB5E"}

package/dist/http.js

@@ -0,0 +1,94 @@
+import { encodeForm } from "./form.js";
+/**
+ * 发送一次请求，并把新 Cookie 留在会话对象上。
+ * 调用方负责 `saveSession`。
+ */
+export async function request(session, call) {
+    const fetchImpl = globalThis.fetch;
+    if (!fetchImpl)
+        throw new Error("当前 Node 没有 fetch");
+    let current = buildUrl(session, call);
+    let method = call.method.toUpperCase();
+    let body;
+    if (method !== "GET" && method !== "HEAD")
+        body = encodeForm(call.body);
+    for (let hop = 0; hop < 5; hop += 1) {
+        const headers = new Headers();
+        headers.set("accept", "application/json, text/plain, image/*, */*");
+        headers.set("x-requested-with", "XMLHttpRequest");
+        headers.set("origin", session.baseUrl);
+        headers.set("referer", `${session.baseUrl}/login`);
+        if (Object.keys(session.cookies).length) {
+            headers.set("cookie", Object.entries(session.cookies).map(([key, value]) => `${key}=${value}`).join("; "));
+        }
+        if (body !== undefined)
+            headers.set("content-type", "application/x-www-form-urlencoded; charset=UTF-8");
+        const response = await fetchImpl(current, { method, headers, body, redirect: "manual" });
+        absorbCookies(session, response);
+        if (response.status < 300 || response.status >= 400) {
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            const contentType = (response.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+            return { status: response.status, contentType, bytes };
+        }
+        const location = response.headers.get("location");
+        if (!location) {
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            const contentType = (response.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+            return { status: response.status, contentType, bytes };
+        }
+        current = new URL(location, current).toString();
+        if (response.status === 303 || method !== "GET") {
+            method = "GET";
+            body = undefined;
+        }
+    }
+    throw new Error("上游重定向次数过多");
+}
+/**
+ * 拼出最终地址。
+ * 有令牌且这次调用允许时，加上查询参数 `idToken`。
+ */
+export function buildUrl(session, call) {
+    const path = call.path.startsWith("/") ? call.path : `/${call.path}`;
+    const query = { ...(call.query ?? {}) };
+    if (call.withToken !== false && session.token)
+        query.idToken = session.token;
+    const encoded = encodeForm(query);
+    return encoded ? `${session.baseUrl}${path}?${encoded}` : `${session.baseUrl}${path}`;
+}
+/**
+ * 根据文件头判断图片类型。
+ * 对不上时返回空字符串。
+ */
+export function imageMediaType(headerType, bytes) {
+    if (bytes.length >= 8 && bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47)
+        return "image/png";
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return "image/jpeg";
+    if (bytes.length >= 6 && bytes[0] === 0x47 && bytes[1] === 0x49 && bytes[2] === 0x46)
+        return "image/gif";
+    if (bytes.length >= 12 &&
+        bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46 &&
+        bytes[8] === 0x57 &&
+        bytes[9] === 0x45 &&
+        bytes[10] === 0x42 &&
+        bytes[11] === 0x50) {
+        return "image/webp";
+    }
+    if (headerType.startsWith("image/"))
+        return headerType;
+    return "";
+}
+function absorbCookies(session, response) {
+    const setCookies = typeof response.headers.getSetCookie === "function" ? response.headers.getSetCookie() : [];
+    for (const raw of setCookies) {
+        const pair = raw.split(";")[0] ?? "";
+        const eq = pair.indexOf("=");
+        if (eq > 0)
+            session.cookies[pair.slice(0, eq).trim()] = pair.slice(eq + 1).trim();
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/login.d.ts

@@ -0,0 +1,43 @@
+import { type ZhidaoSession } from "./session.js";
+/**
+ * 交给用户看的验证码。
+ * `image` 是 data URL，可以直接放进 Markdown 图片。
+ */
+export interface CaptchaImage {
+    /**
+     * data URL。
+     * 形如 `data:image/png;base64,...`。
+     */
+    image: string;
+    /**
+     * 图片媒体类型。
+     * 来自文件头，例如 `image/png`。
+     */
+    mediaType: string;
+    /**
+     * 写到本机的图片路径。
+     * 对话里展示不出来 data URL 时，改读这个文件。
+     */
+    file: string;
+}
+/**
+ * 拉取一张图形验证码并保存 Cookie。
+ * 同一次登录里的 `login` 会复用这份 Cookie。
+ */
+export declare function fetchCaptcha(session: ZhidaoSession): Promise<CaptchaImage>;
+/**
+ * 用账号、密码和用户看到的验证码登录。
+ * 成功后把 `token` 和 Cookie 写进会话，不保存密码。
+ */
+export declare function login(session: ZhidaoSession, userName: string, password: string, captcha: string, priorityId?: string): Promise<Record<string, unknown>>;
+/**
+ * 读取登录页上的 RSA 公钥。
+ * 页面没有 `setPublicKey` 时抛错。
+ */
+export declare function publicKeyFor(baseUrl: string): Promise<string>;
+/**
+ * 把账号和密码打成 `identification`。
+ * 算法与登录页一致，使用 RSA PKCS1。
+ */
+export declare function encryptLogin(publicKey: string, userName: string, password: string): string;
+//# sourceMappingURL=login.d.ts.map

package/dist/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAQA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAahF;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkB3J;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1F"}

package/dist/login.js

@@ -0,0 +1,87 @@
+/**
+ * 图形验证码和账号密码登录。
+ * 账号密码按登录页的 RSA PKCS1 加密后再提交。
+ */
+import { constants, publicEncrypt } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { imageMediaType, request } from "./http.js";
+import { saveSession, sessionPath } from "./session.js";
+/**
+ * 拉取一张图形验证码并保存 Cookie。
+ * 同一次登录里的 `login` 会复用这份 Cookie。
+ */
+export async function fetchCaptcha(session) {
+    const result = await request(session, { method: "GET", path: "/login/captcha", withToken: false });
+    saveSession(session);
+    const mediaType = imageMediaType(result.contentType, result.bytes);
+    if (!mediaType) {
+        const text = new TextDecoder().decode(result.bytes).slice(0, 180);
+        throw new Error(`验证码不是图片（HTTP ${result.status}）${text ? `：${text}` : ""}`);
+    }
+    const base64 = Buffer.from(result.bytes).toString("base64");
+    const file = join(dirname(sessionPath()), "captcha.png");
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, result.bytes);
+    return { image: `data:${mediaType};base64,${base64}`, mediaType, file };
+}
+/**
+ * 用账号、密码和用户看到的验证码登录。
+ * 成功后把 `token` 和 Cookie 写进会话，不保存密码。
+ */
+export async function login(session, userName, password, captcha, priorityId = "1") {
+    const key = await publicKeyFor(session.baseUrl);
+    const identification = encryptLogin(key, userName, password);
+    const result = await request(session, {
+        method: "POST",
+        path: "/login/doLogin",
+        withToken: false,
+        body: {
+            captcha,
+            identification,
+            uniqueId: session.uniqueId,
+            priorityId,
+        },
+    });
+    const payload = parseJson(result.bytes);
+    if (typeof payload.token === "string" && payload.token)
+        session.token = payload.token;
+    saveSession(session);
+    return payload;
+}
+/**
+ * 读取登录页上的 RSA 公钥。
+ * 页面没有 `setPublicKey` 时抛错。
+ */
+export async function publicKeyFor(baseUrl) {
+    const response = await fetch(new URL("/login", baseUrl));
+    const html = await response.text();
+    const match = html.match(/setPublicKey\(["']([A-Za-z0-9+/=]+)["']\)/);
+    const key = match?.[1];
+    if (!key)
+        throw new Error("登录页没有读到加密公钥");
+    return key;
+}
+/**
+ * 把账号和密码打成 `identification`。
+ * 算法与登录页一致，使用 RSA PKCS1。
+ */
+export function encryptLogin(publicKey, userName, password) {
+    const body = publicKey.match(/.{1,64}/g)?.join("\n") ?? publicKey;
+    const pem = `-----BEGIN PUBLIC KEY-----\n${body}\n-----END PUBLIC KEY-----`;
+    const payload = Buffer.from(JSON.stringify({ userName, password }), "utf8");
+    return publicEncrypt({ key: pem, padding: constants.RSA_PKCS1_PADDING }, payload).toString("base64");
+}
+function parseJson(bytes) {
+    const text = new TextDecoder().decode(bytes);
+    try {
+        const payload = JSON.parse(text);
+        if (payload && typeof payload === "object" && !Array.isArray(payload))
+            return payload;
+    }
+    catch {
+        return { code: -1, msg: text.slice(0, 180) || "登录响应不是 JSON" };
+    }
+    return { code: -1, msg: "登录响应不是 JSON 对象" };
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"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"}

package/dist/session.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 一份已保存的登录态。
+ * 验证码和后续请求都读这里的 Cookie。
+ */
+export interface ZhidaoSession {
+    /**
+     * 后台根地址。
+     * 不要以斜杠结尾，默认是泉州五中至道 OA。
+     */
+    baseUrl: string;
+    /**
+     * 上游 Cookie。
+     * 键是 Cookie 名。没有键就视为未登录。
+     */
+    cookies: Record<string, string>;
+    /**
+     * 登录令牌。
+     * 来自 `doLogin` 的 `token`，请求时作为查询参数 `idToken`。
+     */
+    token?: string;
+    /**
+     * 设备标识。
+     * 对应登录请求里的 `uniqueId`，同一份会话保持不变。
+     */
+    uniqueId: string;
+    /**
+     * 最近一次写盘时间。
+     * ISO 8601 字符串。
+     */
+    updatedAt: string;
+}
+/**
+ * 会话文件路径。
+ * `ZHIDAO_SESSION` 优先，否则用用户目录下的 `.zhidao-oa/session.json`。
+ */
+export declare function sessionPath(): string;
+/**
+ * 读会话，没有文件时给一份空会话。
+ * 环境变量里的 Cookie 和令牌会盖过文件。
+ */
+export declare function loadSession(): ZhidaoSession;
+/**
+ * 把会话写回磁盘。
+ * 不写入账号和密码。
+ */
+export declare function saveSession(session: ZhidaoSession): void;
+/**
+ * 是否已经有上游 Cookie。
+ * 技能把 Cookie 当作登录秘钥，空对象表示还要走登录。
+ */
+export declare function hasCookie(session: ZhidaoSession): boolean;
+/**
+ * 是否可以调用业务接口。
+ * 需要 Cookie，也需要登录令牌。
+ */
+export declare function isLoggedIn(session: ZhidaoSession): boolean;
+/**
+ * 换成另一个后台时清掉旧站点的登录态。
+ * 地址没变时原样返回。
+ */
+export declare function assignBase(session: ZhidaoSession, value: string | undefined): void;
+/**
+ * 丢掉 Cookie 和令牌。
+ * `uniqueId` 保留，避免同一台机器的设备标识来回变。
+ */
+export declare function clearLogin(session: ZhidaoSession): void;
+/**
+ * 校正后台根地址。
+ * 只接受 http 和 https，并去掉末尾斜杠。
+ */
+export declare function normalizeBase(value: string | undefined): string;
+/**
+ * 给技能看的令牌摘要。
+ * 只留前 8 位，避免整段令牌出现在对话里。
+ */
+export declare function tokenPreview(token: string | undefined): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAS3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKxD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOlF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAGvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK/D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D"}

package/dist/session.js

@@ -0,0 +1,133 @@
+/**
+ * 本机至道会话。
+ * Cookie 和登录令牌写在用户目录，不进仓库。
+ */
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULT_BASE = "https://wzoa.qz5z.com";
+/**
+ * 会话文件路径。
+ * `ZHIDAO_SESSION` 优先，否则用用户目录下的 `.zhidao-oa/session.json`。
+ */
+export function sessionPath() {
+    const override = process.env.ZHIDAO_SESSION?.trim();
+    if (override)
+        return override;
+    return join(homedir(), ".zhidao-oa", "session.json");
+}
+/**
+ * 读会话，没有文件时给一份空会话。
+ * 环境变量里的 Cookie 和令牌会盖过文件。
+ */
+export function loadSession() {
+    const session = readSessionFile();
+    const base = process.env.ZHIDAO_BASE_URL?.trim();
+    if (base)
+        session.baseUrl = normalizeBase(base);
+    const cookie = process.env.ZHIDAO_COOKIE?.trim();
+    if (cookie)
+        session.cookies = { ...session.cookies, ...parseCookieHeader(cookie) };
+    const token = process.env.ZHIDAO_TOKEN?.trim();
+    if (token)
+        session.token = token;
+    return session;
+}
+/**
+ * 把会话写回磁盘。
+ * 不写入账号和密码。
+ */
+export function saveSession(session) {
+    session.updatedAt = new Date().toISOString();
+    const file = sessionPath();
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify(session, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+}
+/**
+ * 是否已经有上游 Cookie。
+ * 技能把 Cookie 当作登录秘钥，空对象表示还要走登录。
+ */
+export function hasCookie(session) {
+    return Object.keys(session.cookies).length > 0;
+}
+/**
+ * 是否可以调用业务接口。
+ * 需要 Cookie，也需要登录令牌。
+ */
+export function isLoggedIn(session) {
+    return hasCookie(session) && Boolean(session.token);
+}
+/**
+ * 换成另一个后台时清掉旧站点的登录态。
+ * 地址没变时原样返回。
+ */
+export function assignBase(session, value) {
+    if (!value)
+        return;
+    const next = normalizeBase(value);
+    if (next === session.baseUrl)
+        return;
+    session.baseUrl = next;
+    session.cookies = {};
+    session.token = undefined;
+}
+/**
+ * 丢掉 Cookie 和令牌。
+ * `uniqueId` 保留，避免同一台机器的设备标识来回变。
+ */
+export function clearLogin(session) {
+    session.cookies = {};
+    session.token = undefined;
+}
+/**
+ * 校正后台根地址。
+ * 只接受 http 和 https，并去掉末尾斜杠。
+ */
+export function normalizeBase(value) {
+    const raw = (value || DEFAULT_BASE).trim().replace(/\/+$/, "");
+    const url = new URL(raw);
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+        throw new Error("服务地址需要是 http 或 https");
+    return raw;
+}
+/**
+ * 给技能看的令牌摘要。
+ * 只留前 8 位，避免整段令牌出现在对话里。
+ */
+export function tokenPreview(token) {
+    if (!token)
+        return "";
+    return `${token.slice(0, 8)}…`;
+}
+function readSessionFile() {
+    try {
+        const parsed = JSON.parse(readFileSync(sessionPath(), "utf8"));
+        return {
+            baseUrl: normalizeBase(parsed.baseUrl),
+            cookies: parsed.cookies && typeof parsed.cookies === "object" ? parsed.cookies : {},
+            token: typeof parsed.token === "string" ? parsed.token : undefined,
+            uniqueId: typeof parsed.uniqueId === "string" && parsed.uniqueId ? parsed.uniqueId : randomUUID(),
+            updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : "",
+        };
+    }
+    catch {
+        return {
+            baseUrl: normalizeBase(undefined),
+            cookies: {},
+            uniqueId: randomUUID(),
+            updatedAt: "",
+        };
+    }
+}
+function parseCookieHeader(header) {
+    const cookies = {};
+    for (const part of header.split(";")) {
+        const eq = part.indexOf("=");
+        if (eq <= 0)
+            continue;
+        cookies[part.slice(0, eq).trim()] = part.slice(eq + 1).trim();
+    }
+    return cookies;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/flows.md

@@ -0,0 +1,51 @@
+# 请假和审批
+
+字段以 `describe` 的结果为准。下面是办公场景里先查哪条路径。
+
+提交前把路径和字段复述给用户，得到同意再 `call`。
+
+## 先看有没有待办
+
+登录后如果用户只说「有没有要我批的」：
+
+1. `POST /desk/systemTaskList` 看办公桌系统待办。
+2. `POST /tableRecord/taskHandleList` 看待我办理的流程。
+3. `POST /tableRecord/taskQueryMeList` 看我发起的。常用字段：`pageNumber`、`pageSize`、`search_text`、`oaStatus`、`tableId`。
+
+把标题、时间和状态列出来，让用户选一条，不要擅自审批。
+
+## OA 流程单
+
+请假单如果走的是「我的工作」流程，而不是考勤模块：
+
+1. 用 `find 流程` 或用户给出的表单名定位 `process_id`。没有 id 时先查列表，让用户选定。
+2. 需要请假天数时 `POST /tableRecord/calcLeaveDays`。字段：`startTime`、`endTime`、`includeWeekend`。
+3. 草稿是 `POST /tableRecord/saveTaskNewAsDraft`。字段：`process_id`、`fieldDescs`。
+4. 正式提交是 `POST /tableRecord/submitTaskNew`。字段：`process_id`、`content`、`processes`、`copyPerson`、`fieldDescs`、`isSms`、`autoIndexUpdate`、`autoRelationJson`。
+5. 办理已有单是 `POST /tableRecord/submitTaskHandle`。字段：`id`、`content`、`processes`、`copyPerson`、`isSms`、`autoIndexUpdate`。
+
+`content`、`processes`、`fieldDescs` 通常是页面拼出来的 JSON 字符串。缺结构时先 `describe` 相邻的 `editTaskNew`、`editTaskHandle`，用返回值里的字段问用户，不要手写一套流程 JSON。
+
+## 教师考勤请假
+
+路径在 `/teacherAttendance/selfRecord/`：
+
+- `findTeacherLeaveRecord` 查请假记录
+- `findAttendanceApply`、`editAttendanceApply` 看已有申请
+- `saveAttendanceApply` 新建
+- `updateAttendanceApply` 修改
+- `deleteAttendanceApply` 删除
+
+`saveAttendanceApply` 的请求体在扫描结果里没有固定字段。先拉编辑接口看现有单，再只提交用户确认过的键。
+
+## 学生请假和临时请假
+
+- 学生请假申请：`POST /stuAttendance/stuLeaveApplication`
+- 临时请假：`/leave/temporaryLeave` 下的 `list`、`edit`、`save`、`update`
+- 离校通知：`/leave/leaveSchoolNotice` 下的 `list`、`edit`、`save`、`update`
+
+先 `list` 或 `edit`，把可选项告诉用户，再提交。
+
+## 调用失败
+
+`code` 为 `-1` 时会话失效，清掉后重新走验证码登录。`code` 为 `1` 时看 `errors`，把字段提示问回用户，改完再提交。