hiwork-core 0.0.2 → 0.0.6

package/lib/daily-rpc.js

@@ -0,0 +1,161 @@
+/**
+ * `/hiwork-daily` loopback RPC 的 Host 实现（新建任务 hero 页「每日一句」的唯一取数口）。
+ *
+ * 设计要点（与 `src/usage-rpc.ts` 完全同构）：
+ *  - 只注册一个 channel，endpoint 白名单在 {@link DAILY_RPC_ENDPOINTS}，未知 endpoint
+ *    直接 `bad-request`；
+ *  - payload 严格校验：`today` 只接受空对象，`random` 只接受 `{ excludeId?: 正整数 }`，
+ *    任何其它字段 / 类型不符一律 `bad-request`；
+ *  - **网关会话 cookie 绝不离开 Host**：调用方只拿到端点原始响应，cookie 只在
+ *    `resolveSession()` 内部出现；
+ *  - 网关 `GatewayError` 的稳定 code 原样透传，但 message 先经
+ *    {@link displayDailyGatewayMessage} 消毒——baseURL / HTTP 状态码这类实现细节不进 UI；
+ *  - 其余异常收敛为通用失败（code `internal`），Host 只记日志、不把堆栈或原始消息
+ *    交给客户端。
+ *
+ * 消毒逻辑是**同构复制**而非复用 usage-rpc 的导出：后者的兜底文案是用量域的
+ * （「用量数据暂时无法获取…」），复用会让每日一句的失败吐出错误域的文案；且本仓库的
+ * 频道模块本就各自自带一份同实现（usage-rpc 与 hiwork-automation 的 rpc.ts 亦然），
+ * 保持模块自包含。
+ *
+ * 本模块不 import cordis 运行时，只依赖结构化的 {@link DailyRpcContext} 端口，
+ * 便于单测直接伪造。
+ */
+import { GatewayError, } from "./ai-router-client.js";
+/** RPC 频道；必须与 client 半边 `src/client/daily-data.ts` 的 `DAILY_CHANNEL` 一致（由测试锁定）。 */
+export const DAILY_RPC_CHANNEL = '/hiwork-daily';
+/** 端点白名单：当日条目 + 换一句（随机）。 */
+export const DAILY_RPC_ENDPOINTS = ['today', 'random'];
+/** 请求侧错误（只有 `bad-request`：未知端点 / 非法 payload）。 */
+export class DailyRequestError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'DailyRequestError';
+    }
+}
+/** 各稳定错误码的用户可见文案（网关 message 含实现细节时用它兜底）。 */
+const DAILY_MESSAGE_FALLBACK = {
+    SESSION_EXPIRED: '登录状态已过期，请重新登录',
+    GATEWAY_UNREACHABLE: '网关暂时不可用，请稍后重试',
+    RATE_LIMITED: '请求过于频繁，请稍后再试',
+    NOT_FOUND: '网关未找到对应的数据',
+    AUTH_FAILED: '登录状态异常，请重新登录',
+};
+/** 通用失败文案：不暴露任何网关细节。 */
+export const DAILY_GENERIC_FAILURE_MESSAGE = '每日一句暂时无法获取，请稍后重试';
+/** 未登录 / 会话失效的统一文案（与用量频道的 `SESSION_EXPIRED` 口径一致）。 */
+export const DAILY_SESSION_EXPIRED_MESSAGE = '登录状态已过期，请重新登录';
+/**
+ * 网关 message 消毒（与 `usage-rpc.ts` 的 `displayGatewayMessage` 同实现）：
+ * 含 baseURL / HTTP 状态码 / URL 的原始消息一律换成稳定文案，其余（网关自己写好的
+ * 中文业务文案）原样保留。code 不受影响，始终原样透传。
+ */
+export function displayDailyGatewayMessage(code, message) {
+    const text = typeof message === 'string' ? message.trim() : '';
+    if (text === '')
+        return DAILY_MESSAGE_FALLBACK[code] ?? DAILY_GENERIC_FAILURE_MESSAGE;
+    const leaksImplementationDetail = /https?:\/\//i.test(text)
+        || /\bHTTP\s*\d{3}\b/i.test(text)
+        || /\bbaseURL\b/i.test(text);
+    if (leaksImplementationDetail)
+        return DAILY_MESSAGE_FALLBACK[code] ?? DAILY_GENERIC_FAILURE_MESSAGE;
+    return text;
+}
+/**
+ * payload 校验：`today` 只放行空对象，`random` 只放行 `{ excludeId?: 正整数 }`；
+ * 其余字段 / 类型不符一律 `bad-request`。
+ */
+export function parseDailyPayload(endpoint, raw) {
+    if (raw === undefined || raw === null)
+        return {};
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new DailyRequestError('bad-request', '每日一句请求参数不合法。');
+    }
+    const record = raw;
+    const keys = Object.keys(record);
+    if (endpoint === 'today') {
+        // today 无任何入参：出现任何字段都是客户端实现缺陷
+        if (keys.length > 0)
+            throw new DailyRequestError('bad-request', `每日一句请求包含未知字段 '${keys[0]}'。`);
+        return {};
+    }
+    for (const key of keys) {
+        if (key !== 'excludeId')
+            throw new DailyRequestError('bad-request', `每日一句请求包含未知字段 '${key}'。`);
+    }
+    const payload = {};
+    const rawExcludeId = record['excludeId'];
+    if (rawExcludeId !== undefined) {
+        if (typeof rawExcludeId !== 'number' || !Number.isInteger(rawExcludeId) || rawExcludeId <= 0) {
+            throw new DailyRequestError('bad-request', '每日一句请求的 excludeId 必须是正整数。');
+        }
+        payload.excludeId = rawExcludeId;
+    }
+    return payload;
+}
+/** 是否为白名单端点。 */
+export function isDailyRpcEndpoint(endpoint) {
+    return DAILY_RPC_ENDPOINTS.includes(endpoint);
+}
+/** 取消判定（用函数包一层，避免 TS 把属性窄化固化到 `await` 之后）。 */
+function isAborted(signal) {
+    return signal?.aborted === true;
+}
+/**
+ * 处理一次端点调用：返回 DSH Connection 的结果信封，**永不抛异常**。
+ * 导出以便单测直接驱动（无需伪造 `ctx.connection`）。
+ */
+export async function handleDailyEndpoint(endpoint, rawPayload, deps, signal) {
+    try {
+        if (isAborted(signal))
+            return failure('cancelled', '每日一句请求已取消。');
+        if (!isDailyRpcEndpoint(endpoint)) {
+            throw new DailyRequestError('bad-request', `未知的每日一句端点 '${endpoint}'`);
+        }
+        const payload = parseDailyPayload(endpoint, rawPayload);
+        const sessionCookie = await deps.resolveSession();
+        if (sessionCookie === undefined || sessionCookie === '') {
+            return failure('SESSION_EXPIRED', DAILY_SESSION_EXPIRED_MESSAGE);
+        }
+        const gateway = deps.gateway();
+        if (gateway === undefined) {
+            return failure('GATEWAY_UNREACHABLE', '网关地址未配置，请先在「网关模型」里完成登录');
+        }
+        if (isAborted(signal))
+            return failure('cancelled', '每日一句请求已取消。');
+        const value = await callEndpoint(gateway, sessionCookie, endpoint, payload);
+        return { ok: true, value };
+    }
+    catch (error) {
+        if (error instanceof DailyRequestError)
+            return failure(error.code, error.message);
+        if (error instanceof GatewayError) {
+            // code 原样透传（稳定契约），message 消毒后再给客户端。
+            return failure(error.code, displayDailyGatewayMessage(error.code, error.message));
+        }
+        deps.log?.(`hiwork-core: 每日一句 RPC '${endpoint}' 失败（${error instanceof Error ? error.name : typeof error}）`);
+        return failure('internal', DAILY_GENERIC_FAILURE_MESSAGE);
+    }
+}
+/** 单端点转发：返回网关原始响应，不做任何字段重包装（形状校验由客户端取数层负责）。 */
+async function callEndpoint(gateway, sessionCookie, endpoint, payload) {
+    switch (endpoint) {
+        case 'today':
+            return await gateway.getMyDailyQuote(sessionCookie);
+        case 'random':
+            return await gateway.getMyDailyQuoteRandom(sessionCookie, payload.excludeId);
+    }
+}
+function failure(code, message) {
+    return { ok: false, error: { code, message, details: {} } };
+}
+/**
+ * 注册 `/hiwork-daily` 频道，返回异步 disposer（交给 `ctx.effect` 管理生命周期）。
+ */
+export function registerDailyRpc(ctx, deps) {
+    const handler = (endpoint, payload, signal) => handleDailyEndpoint(endpoint, payload, deps, signal);
+    const remove = ctx.connection.rpc.handle(DAILY_RPC_CHANNEL, handler, { authority: 'loopback' });
+    return async () => { await remove(); };
+}

package/lib/default-model.js

@@ -0,0 +1,39 @@
+/**
+ * 默认模型校正。
+ *
+ * `agent-default-model` 是 dsh 的默认模型选择（provider + model），dsh-base 的组合默认值
+ * 指向官方 DeepSeek 提供方（`deepseek-official/deepseek-v4-flash`）。本产品停用了官方提供方、
+ * 只供给网关线路，所以全新安装或提供方/模型变动后，这个默认值可能指向一个不再注册的
+ * provider 或已下架的 model —— 新会话第一次发请求会 UNKNOWN_MODEL，用户必须先去模型选择器
+ * 手动选一次。供给成功后在这里校正它：当前选择仍可路由就不动，否则回落到兜底线路的第一个模型。
+ *
+ * 不写 composition 配置、只写用户层，所以用户自己选过的模型只要仍然可用就不会被覆盖。
+ */
+import { pickFallbackDefaultModel } from "./provision.js";
+/** dsh-agent-default-model 的 settings 命名空间。 */
+export const DEFAULT_MODEL_NS = 'agent-default-model';
+/**
+ * 供给成功后校正默认模型。
+ * @param routeModels - 本次供给出的各线路模型归属。
+ * @param ports - settings / llm 端口。
+ * @returns 实际写入的新选择；无需变更时 undefined。
+ */
+export async function ensureDefaultModel(routeModels, ports) {
+    if (!ports.available())
+        return undefined;
+    const current = ports.read();
+    if (current !== undefined && await routable(current, routeModels, ports))
+        return undefined;
+    const next = pickFallbackDefaultModel(routeModels);
+    if (next === undefined)
+        return undefined;
+    await ports.write(next);
+    return next;
+}
+/** 当前选择是否仍可路由：本插件供给的线路内查表，其它提供方问 llm 注册表。 */
+async function routable(selection, routeModels, ports) {
+    const models = routeModels[selection.provider];
+    if (models !== undefined)
+        return models.some((model) => model.id === selection.model);
+    return ports.isRoutableElsewhere(selection);
+}