@dsh-workbench/shared 0.1.0

package/dist/i18n/zh.js

@@ -0,0 +1,162 @@
+export const zh = {
+    'brand.name': '工作台',
+    'toggle.open': '打开侧边栏',
+    'toggle.collapse': '收起侧边栏',
+    'project.label': '切换项目',
+    'workspace.section': '工作区',
+    'project.none': '未选择项目',
+    'project.empty': '还没有项目。用下面的「添加项目」选一个目录。',
+    'project.add': '添加项目…',
+    'session.new': '新会话',
+    'session.new.label': '在当前项目新建会话',
+    'session.empty': '这个项目还没有会话。',
+    'session.noProject': '先添加一个项目。',
+    'session.pinned': '已置顶',
+    'session.actions': '{name} 的操作',
+    'status.idle': '空闲',
+    'status.running': '运行中',
+    'status.waitingApproval': '等待授权',
+    'status.planReview': '等待计划确认',
+    'status.waitingAnswer': '等待回答',
+    'status.completed': '已完成',
+    'status.subagentsRunning.one': '{n} 个子代理运行中',
+    'status.subagentsRunning.other': '{n} 个子代理运行中',
+    'time.now': '刚刚',
+    'time.minutes': '{n} 分钟前',
+    'time.hours': '{n} 小时前',
+    'time.days': '{n} 天前',
+    'panels.title': '面板模块',
+    'panels.reset': '恢复默认',
+    'panels.enabled': '这个项目已启用',
+    'panels.disabled': '这个项目未启用',
+    'panels.choose': '选择模块',
+    'panels.failed': '改配置失败了，再试一次。',
+    'panels.hintEffect': '停用 = agent 拿不到相关数据',
+    'panels.dragHint': '拖动调整顺序',
+    'panels.unknownStep': '这一层没有套件提供',
+    'panels.labelWithHint': '{label}（{hint}）',
+    'panels.dep.missingPlugin': '⚠ 还没装好',
+    'panels.dep.missingCommands': '⚠ 需要更新',
+    'panels.dep.unchecked': '⚠ 检测不了',
+    'panels.tab.modules': '面板配置',
+    'panels.tab.market': '工作台模块市场',
+    'panels.browseMarket': '浏览模块市场',
+    'panels.noneInstalled': '这些模块要的插件都还没装',
+    'panels.noneInstalledHint': '装好之后它们会回到这里，再由你决定放哪几个上板。',
+    'panels.market.installed': '已装',
+    'panels.market.outdated': '要更新',
+    'panels.market.hasNew': '有新版本',
+    'panels.market.missing': '未装',
+    'panels.market.unchecked': '状态未知',
+    'panels.market.checking': '检测中',
+    'panels.market.sectionInstalled': '已安装',
+    'panels.market.sectionPending': '未安装',
+    'panels.market.sectionShared': '共用依赖',
+    'panels.market.sharedUsedBy': '供 {modules} 使用',
+    'panels.market.listSeparator': '、',
+    'panels.market.sharedMissing': '未装',
+    'panels.market.sharedOutdated': '有新版',
+    'panels.market.sharedUnsatisfied': '版本不对',
+    'panels.market.sharedOk': '已装',
+    'panels.market.versionArrow': '{from} → {to}',
+    'panels.market.lead': '装在这台机器上，所有项目共用。',
+    'panels.market.install': '安装',
+    'panels.market.update': '更新',
+    'panels.market.uninstall': '卸载',
+    'panels.market.installing': '正在安装…',
+    'panels.market.updating': '正在更新…',
+    'panels.market.uninstalling': '正在卸载…',
+    'panels.market.confirmUninstall': '要卸载吗？',
+    'panels.market.confirmUninstallDetail': '卸载后这台机器上就没有它了，所有项目的面板也会把它一起拿掉（绑定与设置不会丢）。',
+    'panels.market.confirmYes': '确定卸载',
+    'panels.market.confirmNo': '取消',
+    'panels.market.failed': '没成功：{reason}',
+    'panels.market.needEnv': '先在启动工作台的终端里设 {env}',
+    'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
+    'panels.market.badSource': '安装方式没写全，只能自己动手',
+    'panels.market.empty': '暂无可用模块',
+    'panels.market.foot': '装好后到那个项目的面板页勾选它，模块才会出现。',
+    'panels.market.recheck': '重新检查更新',
+    'panels.market.checkUpdates': '检查更新',
+    'panels.market.checkedAt': '最近检查：{time}',
+    'panels.market.justNow': '刚刚',
+    'panels.market.minutesAgo': '{n} 分钟前',
+    'panels.market.hoursAgo': '{n} 小时前',
+    'blocker.fix.install': '帮我安装',
+    'blocker.fix.update': '帮我升级',
+    'blocker.fix.running': '正在执行…',
+    'blocker.fix.failed': '执行失败：',
+    'blocker.retry': '重试',
+    'blocker.retry.running': '重试中…',
+    'blocker.copy': '复制命令',
+    'blocker.market.open': '去模块市场',
+    'blocker.login.title': '需要登录 {platform}',
+    'blocker.login.titleGeneric': '需要登录',
+    'blocker.login.hint': '工作台用你的浏览器登录态；登录一次就行，之后不用再登。',
+    'blocker.login.go': '去登录',
+    'blocker.login.manual': '在终端执行 `opencli coding team-current`，按提示完成登录后重试。',
+    'blocker.forbidden.title': '没有权限访问 {platform}',
+    'blocker.forbidden.titleGeneric': '没有权限',
+    'blocker.forbidden.hint': '账号已登录，但没有这个项目/仓库的权限；申请之后再试。',
+    'blocker.forbidden.open': '打开权限页',
+    'blocker.timeout.hint': '无头浏览器可能没起来，重试一次通常就好。',
+    'blocker.exec.hint': '确认 opencli 已安装且在 PATH 里（which opencli）。',
+    'blocker.unknown.title': '出了点问题',
+    'panels.reading': '正在读取面板配置…',
+    'panels.empty': '面板里还没有模块',
+    'panels.emptyHint': '也可以直接跟 agent 说：「把某个模块加到面板」。',
+    'env.title': '准备工作台',
+    'env.checking': '正在检测运行环境…',
+    'env.installing': '正在安装缺失的依赖…',
+    'env.failed': '还差一步就能用了',
+    'env.elapsed': '已等待 {seconds} 秒',
+    'env.stepFailed.install': '装不上',
+    'env.stepFailed.path': '装了但还找不到',
+    'env.stepFailed.shell': '执行通道不可用',
+    'env.bridge.ok': '已连接',
+    'env.bridge.short': '没连上',
+    'env.bridge.why': '面板的数据要走你浏览器里的登录态：这个通道没连上，模块就取不到数据（不拦路，但先修好它）。',
+    'env.bridge.daemon': '后台服务没起来：正常它会自己起，先在终端跑下面这条命令。',
+    'env.bridge.extension': '浏览器扩展没连上：在 Chrome 应用商店装一次就好（装完回来点「重试」）。已经装过的话，先跑下面这条命令。',
+    'env.bridge.extensionLink': '去 Chrome 应用商店装扩展',
+    'env.bridge.profile': '连上了多个浏览器 profile，但没选默认的那个：先看有哪些（下面这条命令），再选一个。',
+    'env.bridge.stale': '默认的浏览器 profile 已经失效（它记的是上一次的扩展实例）：重新选一个。',
+    'env.bridge.unknown': '没认出是哪种问题：下面原始输出里有 opencli 自己给的步骤。',
+    'env.fix.title': '怎么解决',
+    'env.fix.why': '工作台用它自己那份 opencli（与你在终端里那套分开装，互不影响），这台机器上还没装好它。',
+    'env.fix.whyPath': 'opencli 装上了，但当前环境还找不到它 —— 通常是 PATH 或终端会话的问题。',
+    'env.fix.whyShell': '工作台拿不到执行命令的通道，所以取不了数据 —— 这一步用户自己装不了。',
+    'env.fix.step': '在终端里运行下面这条命令，装好之后点「重试」：',
+    'env.fix.stepPath': '新开一个终端窗口（或确认 npm 的全局 bin 目录在 PATH 里），然后点「重试」。',
+    'env.fix.stepShell': '重启一次工作台（或 dsh）；如果反复出现，说明执行通道没配好。',
+    'env.fix.permission': '权限不够：在命令前加 sudo 重跑，或先把 npm 的全局目录配到你的用户目录。',
+    'env.fix.network': '网络不通：检查网络或代理设置后重试。',
+    'env.fix.details': '详细输出（排障用）',
+    'env.retry': '重试',
+    'env.copyCommand': '复制命令',
+    'env.copied': '已复制',
+    'env.step.opencli': '检测工作台的 opencli',
+    'env.step.codingPlugin': '检测 coding 插件',
+    'env.step.bridge': '检测浏览器通道',
+    'env.step.warm': '预热站点登录态',
+    'env.warm.done': '已预热 {n} 个站点',
+    'env.warm.short': '这次没热上 —— 不影响用，面板第一次读取会自己补',
+    'env.unit.missingPlugin': '这个模块还没装好',
+    'env.unit.missingCommandsHint': '更新之后就能用了。',
+    'env.unit.unchecked': '检测不了：拿不到执行通道',
+    'env.unit.uncheckedHint': '不是这个模块的问题，是执行通道不可用 —— 重启一次工作台再试。',
+    'env.unit.missingCommands': '这个模块的版本旧了',
+    'env.unit.hint': '装好之后点重试；不影响其它模块。',
+    'rightbar.label': '数据面板',
+    'rightbar.expand': '展开数据面板',
+    'rightbar.collapse': '收起数据面板',
+    'rightbar.refresh': '刷新',
+    'rightbar.refreshing': '刷新中…',
+    'rightbar.updatedAt': '更新于 {time}',
+    'rightbar.noProject': '当前会话没有所属项目',
+    'coding.notARepo.title': '这个项目不是 Coding 仓库',
+    'error.unknown': '出错了',
+    'board.title': '看板',
+    'panel.conversation': '对话',
+    'panels.label': '全局面板',
+};

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export * from './api/blocker-table';
+export * from './api/blocker';
+export * from './api/context-ref';
+export * from './api/dsh-client';
+export * from './api/dsh';
+export * from './api/facts';
+export * from './api/host-write';
+export * from './api/long-task';
+export * from './api/unit-board';
+export * from './api/unit';
+export * from './api/workbench-client';
+export * from './api/workbench-contract';
+export * from './components/ApprovalDetail';
+export * from './components/CardHead';
+export * from './components/ChoiceGroup';
+export * from './components/LongTaskRow';
+export * from './components/MockStrip';
+export * from './components/ResourceStates';
+export * from './components/SaveBar';
+export * from './components/StateDot';
+export * from './components/board-module';
+export * from './components/icons';
+export * from './config/constants';
+export * from './config/storage';
+export * from './i18n/en';
+export * from './i18n/index';
+export * from './i18n/merge';
+export * from './i18n/zh';
+export * from './lib/blocker-action';
+export * from './lib/busy';
+export * from './lib/react';
+export * from './lib/text';
+export * from './lib/ui';

package/dist/index.js

@@ -0,0 +1,33 @@
+export * from './api/blocker-table';
+export * from './api/blocker';
+export * from './api/context-ref';
+export * from './api/dsh-client';
+export * from './api/dsh';
+export * from './api/facts';
+export * from './api/host-write';
+export * from './api/long-task';
+export * from './api/unit-board';
+export * from './api/unit';
+export * from './api/workbench-client';
+export * from './api/workbench-contract';
+export * from './components/ApprovalDetail';
+export * from './components/CardHead';
+export * from './components/ChoiceGroup';
+export * from './components/LongTaskRow';
+export * from './components/MockStrip';
+export * from './components/ResourceStates';
+export * from './components/SaveBar';
+export * from './components/StateDot';
+export * from './components/board-module';
+export * from './components/icons';
+export * from './config/constants';
+export * from './config/storage';
+export * from './i18n/en';
+export * from './i18n/index';
+export * from './i18n/merge';
+export * from './i18n/zh';
+export * from './lib/blocker-action';
+export * from './lib/busy';
+export * from './lib/react';
+export * from './lib/text';
+export * from './lib/ui';

package/dist/lib/blocker-action.d.ts

@@ -0,0 +1,13 @@
+export type BlockerLabelTranslate = (key: string) => string;
+export interface BlockerActionShape {
+    readonly kind: string;
+    readonly label: string;
+    readonly text?: string | undefined;
+}
+export interface BlockerLabelState {
+    readonly retrying: boolean;
+    readonly running: string | null;
+    readonly copied: string | null;
+}
+export declare function blockerPending(busy: boolean, running: string | null): boolean;
+export declare function blockerActionLabel(action: BlockerActionShape, state: BlockerLabelState, t: BlockerLabelTranslate): string;

package/dist/lib/blocker-action.js

@@ -0,0 +1,12 @@
+export function blockerPending(busy, running) {
+    return busy || running !== null;
+}
+export function blockerActionLabel(action, state, t) {
+    if (action.kind === 'retry' && state.retrying)
+        return t('blocker.retry.running');
+    if (state.running === action.label)
+        return t('blocker.fix.running');
+    if (action.kind === 'copy' && state.copied === action.text)
+        return t('env.copied');
+    return action.label;
+}

package/dist/lib/busy.d.ts

@@ -0,0 +1,5 @@
+export interface BusyHold {
+    readonly visible: boolean;
+    readonly releaseInMs: number;
+}
+export declare function holdBusy(since: number | null, now: number, floorMs: number): BusyHold;

package/dist/lib/busy.js

@@ -0,0 +1,7 @@
+export function holdBusy(since, now, floorMs) {
+    if (since === null)
+        return { visible: false, releaseInMs: 0 };
+    const elapsed = Math.max(0, now - since);
+    const left = floorMs - elapsed;
+    return left <= 0 ? { visible: false, releaseInMs: 0 } : { visible: true, releaseInMs: left };
+}

package/dist/lib/react.d.ts

@@ -0,0 +1,10 @@
+import type * as ReactTypes from 'react';
+export declare const h: typeof ReactTypes.createElement;
+export declare const Fragment: ReactTypes.ExoticComponent<ReactTypes.FragmentProps>;
+export declare const useState: typeof ReactTypes.useState;
+export declare const useEffect: typeof ReactTypes.useEffect;
+export declare const useMemo: typeof ReactTypes.useMemo;
+export declare const useCallback: typeof ReactTypes.useCallback;
+export declare const useRef: typeof ReactTypes.useRef;
+export declare const useSyncExternalStore: typeof ReactTypes.useSyncExternalStore;
+export type { ReactNode, CSSProperties, ChangeEvent } from 'react';

package/dist/lib/react.js

@@ -0,0 +1,9 @@
+const react = require('react');
+export const h = react.createElement;
+export const Fragment = react.Fragment;
+export const useState = react.useState;
+export const useEffect = react.useEffect;
+export const useMemo = react.useMemo;
+export const useCallback = react.useCallback;
+export const useRef = react.useRef;
+export const useSyncExternalStore = react.useSyncExternalStore;

package/dist/lib/text.d.ts

@@ -0,0 +1,4 @@
+export declare function quoteShellArg(value: unknown): string;
+export declare function tailLines(text: string | null | undefined, lines?: number): string;
+export declare function parseJsonLoose(text: string | null | undefined): unknown;
+export declare function excerpt(text: string | null | undefined, limit?: number): string;

package/dist/lib/text.js

@@ -0,0 +1,48 @@
+export function quoteShellArg(value) {
+    return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+export function tailLines(text, lines = 6) {
+    const all = String(text ?? '')
+        .trim()
+        .split('\n');
+    return all.slice(-lines).join('\n');
+}
+export function parseJsonLoose(text) {
+    const raw = String(text ?? '').trim();
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        const starts = [raw.indexOf('['), raw.indexOf('{')].filter((index) => index >= 0);
+        if (starts.length === 0)
+            return undefined;
+        const from = Math.min(...starts);
+        const open = raw[from];
+        const close = open === '[' ? ']' : '}';
+        const to = raw.lastIndexOf(close);
+        if (to <= from)
+            return undefined;
+        try {
+            return JSON.parse(raw.slice(from, to + 1));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+const MARKDOWN_IMAGE = /!\[[^\]]*\]\([^)]*\)/g;
+const MARKDOWN_LINK = /\[([^\]]*)\]\([^)]*\)/g;
+const MARKDOWN_MARKS = /[*`_>#]/g;
+export function excerpt(text, limit = 80) {
+    const flat = String(text ?? '')
+        .replace(MARKDOWN_IMAGE, ' ')
+        .replace(MARKDOWN_LINK, '$1')
+        .replace(MARKDOWN_MARKS, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (flat.length <= limit)
+        return flat;
+    return `${flat.slice(0, limit).trimEnd()}…`;
+}

package/dist/lib/ui.d.ts

@@ -0,0 +1,11 @@
+export declare function cx(...parts: Array<string | false | null | undefined>): string;
+export type TimeTranslate = (key: string, params?: Record<string, unknown>) => string;
+export declare function relativeTime(epochMs: number, t: TimeTranslate): string;
+export declare function shortenPath(path: unknown): string;
+export declare const LINK_BUTTON_STYLE: {
+    readonly display: "inline-flex";
+    readonly alignItems: "center";
+    readonly gap: "var(--wb-gap-xs)";
+    readonly textDecoration: "none";
+};
+export declare function parseLocalTimestamp(text: string | null | undefined): number;

package/dist/lib/ui.js

@@ -0,0 +1,37 @@
+export function cx(...parts) {
+    return parts.filter(Boolean).join(' ');
+}
+const MINUTE = 60 * 1000;
+export function relativeTime(epochMs, t) {
+    if (!Number.isFinite(epochMs))
+        return '';
+    const diff = Date.now() - epochMs;
+    if (diff < MINUTE)
+        return t('time.now');
+    if (diff < 60 * MINUTE)
+        return t('time.minutes', { n: Math.floor(diff / MINUTE) });
+    if (diff < 24 * 60 * MINUTE)
+        return t('time.hours', { n: Math.floor(diff / (60 * MINUTE)) });
+    if (diff < 7 * 24 * 60 * MINUTE)
+        return t('time.days', { n: Math.floor(diff / (24 * 60 * MINUTE)) });
+    return new Date(epochMs).toLocaleDateString();
+}
+export function shortenPath(path) {
+    if (typeof path !== 'string')
+        return '';
+    const hit = path.match(/^\/Users\/[^/]+/);
+    return hit === null ? path : path.replace(hit[0], '~');
+}
+export const LINK_BUTTON_STYLE = {
+    display: 'inline-flex',
+    alignItems: 'center',
+    gap: 'var(--wb-gap-xs)',
+    textDecoration: 'none',
+};
+const LOCAL_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})$/;
+export function parseLocalTimestamp(text) {
+    const raw = String(text ?? '').trim();
+    if (!LOCAL_TIMESTAMP.test(raw))
+        return Number.NaN;
+    return new Date(raw.replace(' ', 'T')).getTime();
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@dsh-workbench/shared",
+  "version": "0.1.0",
+  "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "*"
+  },
+  "devDependencies": {
+    "@arch-guard/core": "^0.10.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^5.0.2",
+    "react": "^18.0.0",
+    "vitest": "^5.0.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "selfcheck": "node scripts/check-state.mjs",
+    "arch:report": "arch-guard --report-only",
+    "arch": "arch-guard"
+  }
+}