xtep-workspace 1.10.10

package/dist/types/settings.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 日志级别类型
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * 有效的日志级别值
+ */
+export declare const VALID_LOG_LEVELS: LogLevel[];
+/**
+ * 全局配置接口
+ * 存储在 ~/.xtep-workspace/config.json
+ */
+export interface GlobalConfig {
+    version: "1.0";
+    defaultDispatchMode: "none" | "git" | "no-git";
+    logLevel?: LogLevel;
+    tutorialCreated?: boolean;
+    tutorialVersion?: string;
+}
+/**
+ * 默认日志级别
+ */
+export declare const DEFAULT_LOG_LEVEL: LogLevel;
+/**
+ * 默认全局配置
+ */
+export declare const DEFAULT_CONFIG: GlobalConfig;
+/**
+ * config_get 输出
+ */
+export interface ConfigGetResult {
+    config: GlobalConfig;
+}
+/**
+ * config_set 输入
+ */
+export interface ConfigSetParams {
+    defaultDispatchMode?: "none" | "git" | "no-git";
+    logLevel?: LogLevel;
+}
+/**
+ * config_set 输出
+ */
+export interface ConfigSetResult {
+    success: boolean;
+    config: GlobalConfig;
+}
+/**
+ * 支持的平台类型
+ */
+export type PlatformType = "claudeCode" | "cursor" | "codex";
+/**
+ * 组件安装信息
+ */
+export interface ComponentInfo {
+    installed: boolean;
+    version?: string;
+}
+/**
+ * 平台组件安装信息
+ */
+export interface PlatformInstallation {
+    enabled: boolean;
+    installedAt: string;
+    components: {
+        hooks: ComponentInfo;
+        mcp: ComponentInfo;
+        agents?: ComponentInfo;
+        skills?: ComponentInfo;
+        agentsMd?: ComponentInfo;
+        modes?: ComponentInfo;
+    };
+}
+/**
+ * 安装元信息
+ * 记录全局组件安装状态
+ */
+export interface InstallationMeta {
+    schemaVersion: "1.0";
+    global: {
+        installedAt: string;
+        lastUpdatedAt: string;
+        packageVersion: string;
+        platforms: {
+            claudeCode?: PlatformInstallation;
+            cursor?: PlatformInstallation;
+            codex?: PlatformInstallation;
+        };
+    };
+}
+/**
+ * 默认安装元信息
+ */
+export declare const DEFAULT_INSTALLATION_META: InstallationMeta;
+/**
+ * 组件类型
+ */
+export type ComponentType = "hooks" | "mcp" | "agents" | "skills";
+/**
+ * 安装警告
+ */
+export interface InstallationWarning {
+    platform: PlatformType;
+    component: ComponentType;
+    installedVersion: string;
+    currentVersion: string;
+    message: string;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/types/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,EAAuC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,mBAAmB,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAiB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAI5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAOD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,KAAK,EAAE,aAAa,CAAC;QACrB,GAAG,EAAE,aAAa,CAAC;QACnB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,KAAK,CAAC,EAAE,aAAa,CAAC;KACvB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE;YACT,UAAU,CAAC,EAAE,oBAAoB,CAAC;YAClC,MAAM,CAAC,EAAE,oBAAoB,CAAC;YAC9B,KAAK,CAAC,EAAE,oBAAoB,CAAC;SAC9B,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAQvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/settings.js

@@ -0,0 +1,30 @@
+// src/types/settings.ts
+/**
+ * 有效的日志级别值
+ */
+export const VALID_LOG_LEVELS = ["debug", "info", "warn", "error"];
+/**
+ * 默认日志级别
+ */
+export const DEFAULT_LOG_LEVEL = "info";
+/**
+ * 默认全局配置
+ */
+export const DEFAULT_CONFIG = {
+    version: "1.0",
+    defaultDispatchMode: "none", // 默认不启用派发
+    logLevel: DEFAULT_LOG_LEVEL, // 默认日志级别
+};
+/**
+ * 默认安装元信息
+ */
+export const DEFAULT_INSTALLATION_META = {
+    schemaVersion: "1.0",
+    global: {
+        installedAt: new Date().toISOString(),
+        lastUpdatedAt: new Date().toISOString(),
+        packageVersion: "0.0.0",
+        platforms: {},
+    },
+};
+//# sourceMappingURL=settings.js.map

package/dist/types/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAOxB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAc/E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAa,MAAM,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,OAAO,EAAE,KAAK;IACd,mBAAmB,EAAE,MAAM,EAAG,UAAU;IACxC,QAAQ,EAAE,iBAAiB,EAAG,SAAS;CACxC,CAAC;AA6EF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,aAAa,EAAE,KAAK;IACpB,MAAM,EAAE;QACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvC,cAAc,EAAE,OAAO;QACvB,SAAS,EAAE,EAAE;KACd;CACF,CAAC"}

package/dist/types/workspace.d.ts

@@ -0,0 +1,357 @@
+/**
+ * 任务场景类型
+ */
+export type TaskScenario = 'feature' | 'summary' | 'optimize' | 'debug' | 'misc';
+/**
+ * 场景配置（用于引导生成）
+ */
+export interface ScenarioConfig {
+    scenario: TaskScenario;
+    isNeedTest: boolean;
+    baseGuidance: string[];
+}
+/**
+ * 工作区索引 - 存储在 ~/.xtep-workspace/index.json（全局）
+ */
+export interface WorkspaceIndex {
+    version: string;
+    workspaces: WorkspaceEntry[];
+}
+/**
+ * 工作区索引条目
+ */
+export interface WorkspaceEntry {
+    id: string;
+    name: string;
+    dirName: string;
+    projectRoot: string;
+    status: WorkspaceStatus;
+    createdAt: string;
+    updatedAt: string;
+    errorInfo?: WorkspaceErrorInfo;
+    hasUnresolvedIssues?: boolean;
+    lastWarningAt?: string;
+    pinned?: boolean;
+}
+/**
+ * 工作区状态
+ */
+export type WorkspaceStatus = "active" | "archived" | "error";
+/**
+ * 工作区错误信息
+ */
+export interface WorkspaceErrorInfo {
+    message: string;
+    detectedAt: string;
+    type?: "dir_missing" | "config_corrupted" | "graph_corrupted" | "version_too_high" | "node_corrupted" | "unknown";
+    previousStatus?: "active" | "archived";
+}
+/**
+ * 派发资源限制配置
+ */
+export interface DispatchLimits {
+    timeoutMs?: number;
+    maxRetries?: number;
+}
+/**
+ * Review 配置
+ */
+export interface ReviewConfig {
+    specReviewEnabled: boolean;
+    qualityReviewEnabled: boolean;
+}
+/**
+ * 派发配置 - 存储在 workspace.json 中
+ */
+export interface DispatchConfig {
+    enabled: boolean;
+    useGit: boolean;
+    enabledAt: number;
+    originalBranch?: string;
+    processBranch?: string;
+    backupBranches?: string[];
+    limits?: DispatchLimits;
+    review?: ReviewConfig;
+}
+/**
+ * 工作区配置 - 存储在 .xtep-workspace/[dirName]/workspace.json
+ */
+export interface WorkspaceConfig {
+    id: string;
+    name: string;
+    dirName: string;
+    status: WorkspaceStatus;
+    createdAt: string;
+    updatedAt: string;
+    rootNodeId: string;
+    scenario?: TaskScenario;
+    dispatch?: DispatchConfig;
+    pendingManualChanges?: ManualChange[];
+}
+/**
+ * Memo 元信息（用于 memo:// 引用）
+ */
+export interface MemoMeta {
+    id: string;
+    title: string;
+    summary: string;
+    tags: string[];
+}
+/**
+ * 文档引用状态
+ */
+export type DocRefStatus = "active" | "expired";
+/**
+ * 文档引用
+ */
+export interface DocRef {
+    path: string;
+    description: string;
+    memoMeta?: MemoMeta;
+    status?: DocRefStatus;
+}
+/**
+ * Workspace.md 数据结构
+ */
+export interface WorkspaceMdData {
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    rules: string[];
+    docs: DocRef[];
+}
+/**
+ * 日志条目
+ */
+export interface LogEntry {
+    time: string;
+    operator: string;
+    event: string;
+}
+/**
+ * 问题数据
+ */
+export interface ProblemData {
+    currentProblem: string;
+    nextStep: string;
+}
+/**
+ * workspace_init 输入
+ */
+export interface WorkspaceInitParams {
+    name: string;
+    goal: string;
+    projectRoot?: string;
+    scenario?: TaskScenario;
+    rules?: string[];
+    docs?: DocRef[];
+}
+/**
+ * 项目文档信息（用于 workspace_init 扫描结果）
+ */
+export interface ProjectDocInfo {
+    path: string;
+    hasFrontmatter: boolean;
+    isFolder?: boolean;
+}
+/**
+ * 项目文档扫描结果
+ */
+export interface ProjectDocsScanResult {
+    files: ProjectDocInfo[];
+    folders: string[];
+    totalFound: number;
+    degraded: boolean;
+}
+/**
+ * AI 必须执行的行为类型
+ */
+export type ActionRequiredType = "invoke_skill" | "ask_user" | "show_plan" | "check_docs" | "review_structure" | "ask_dispatch" | "dispatch_task" | "dispatch_complete_choice";
+/**
+ * AI 必须执行的行为
+ * 当此字段存在时，AI 必须执行相应行为，不可忽略
+ */
+export interface ActionRequired {
+    type: ActionRequiredType;
+    message: string;
+    data?: Record<string, unknown>;
+    confirmationToken?: string;
+}
+/**
+ * workspace_init 输出
+ */
+export interface WorkspaceInitResult {
+    workspaceId: string;
+    path: string;
+    projectRoot: string;
+    rootNodeId: string;
+    scenario: TaskScenario;
+    webUrl?: string;
+    hint?: string;
+    projectDocs?: ProjectDocsScanResult;
+    actionRequired?: ActionRequired;
+}
+/**
+ * workspace_list 输入
+ */
+export interface WorkspaceListParams {
+    status?: "active" | "archived" | "all";
+    cwd?: string;
+}
+/**
+ * workspace_list 输出项（包含 webUrl）
+ */
+export interface WorkspaceListItem extends WorkspaceEntry {
+    webUrl: string;
+}
+/**
+ * workspace_list 输出
+ */
+export interface WorkspaceListResult {
+    workspaces: WorkspaceListItem[];
+    hint?: string;
+}
+/**
+ * 拓扑节点 - 用于轻量级工作区结构展示
+ * 基于状态的智能折叠策略，压缩完整节点树
+ */
+export interface TopologyNode {
+    id: string;
+    title: string;
+    status: string;
+    role?: string;
+    children?: TopologyNode[];
+    _done?: string[];
+    _sum?: string;
+    _c?: number;
+}
+/**
+ * workspace_get 输入
+ */
+export interface WorkspaceGetParams {
+    workspaceId: string;
+}
+/**
+ * workspace_get 输出
+ */
+export interface WorkspaceGetResult {
+    config: WorkspaceConfig;
+    graph: import("./node.js").NodeGraph;
+    workspaceMd: string;
+    logMd: string;
+    webUrl: string;
+    rulesCount: number;
+    rulesHash: string;
+    topology?: TopologyNode;
+    warning?: {
+        message: string;
+        issues: import("./health.js").HealthIssue[];
+        suggestion: string;
+    };
+}
+/**
+ * workspace_delete 输入
+ */
+export interface WorkspaceDeleteParams {
+    workspaceId: string;
+    force?: boolean;
+}
+/**
+ * workspace_delete 输出
+ */
+export interface WorkspaceDeleteResult {
+    success: boolean;
+}
+/**
+ * workspace_status 输入
+ */
+export interface WorkspaceStatusParams {
+    workspaceId: string;
+    format?: "box" | "markdown";
+}
+/**
+ * workspace_status 输出
+ */
+export interface WorkspaceStatusResult {
+    output: string;
+    summary: {
+        name: string;
+        goal: string;
+        status: string;
+        totalNodes: number;
+        completedNodes: number;
+        currentFocus: string | null;
+    };
+    webUrl: string;
+    memos?: {
+        items: Array<{
+            id: string;
+            title: string;
+            summary: string;
+            tags: string[];
+            updatedAt: string;
+        }>;
+        allTags: string[];
+        totalCount: number;
+    };
+}
+/**
+ * workspace_update_rules 输入
+ */
+export interface WorkspaceUpdateRulesParams {
+    workspaceId: string;
+    action: "add" | "remove" | "replace";
+    rule?: string;
+    rules?: string[];
+}
+/**
+ * workspace_update_rules 输出
+ */
+export interface WorkspaceUpdateRulesResult {
+    success: boolean;
+    rulesCount: number;
+    rulesHash: string;
+    rules: string[];
+}
+/**
+ * workspace_archive 输入
+ */
+export interface WorkspaceArchiveParams {
+    workspaceId: string;
+}
+/**
+ * workspace_archive 输出
+ */
+export interface WorkspaceArchiveResult {
+    success: boolean;
+    archivePath: string;
+}
+/**
+ * workspace_restore 输入
+ */
+export interface WorkspaceRestoreParams {
+    workspaceId: string;
+}
+/**
+ * workspace_restore 输出
+ */
+export interface WorkspaceRestoreResult {
+    success: boolean;
+    path: string;
+    webUrl: string;
+}
+/**
+ * 手动变更记录（WebUI 手动操作）
+ */
+export interface ManualChange {
+    id: string;
+    timestamp: string;
+    type: "transition" | "create" | "delete" | "focus" | "update";
+    nodeId?: string;
+    nodeName?: string;
+    fromStatus?: string;
+    toStatus?: string;
+    description: string;
+    source: "webui";
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/types/workspace.d.ts.map

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

package/dist/types/workspace.js

@@ -0,0 +1,3 @@
+// src/types/workspace.ts
+export {};
+//# sourceMappingURL=workspace.js.map

package/dist/types/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/types/workspace.ts"],"names":[],"mappings":"AAAA,yBAAyB"}

package/dist/utils/contentValidation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 验证多行内容（不能包含行首 ## 标题）
+ *
+ * Info.md/Problem.md/Workspace.md 使用 ## 作为 section 分隔符
+ * 解析正则使用 (?=\n## |$) 作为边界，所以只有 ## 会触发边界
+ *
+ * 注意：# 一级标题和 ### 三级标题等不会破坏解析，允许使用
+ *
+ * @param content 要验证的内容
+ * @param fieldName 字段名称（用于错误信息）
+ * @throws XtepError 如果内容包含 ## 标题
+ */
+export declare function validateMultilineContent(content: string, fieldName: string): void;
+/**
+ * 验证单行内容（不能包含换行符）
+ * Frontmatter 和列表项使用单行格式，换行符会破坏解析
+ *
+ * @param content 要验证的内容
+ * @param fieldName 字段名称（用于错误信息）
+ * @throws XtepError 如果内容包含换行符
+ */
+export declare function validateSingleLineContent(content: string, fieldName: string): void;
+/**
+ * 转义表格单元格内容
+ * Log.md 使用 Markdown 表格格式，需要转义特殊字符
+ *
+ * @param content 原始内容
+ * @returns 转义后的内容
+ */
+export declare function escapeTableCell(content: string): string;
+/**
+ * 还原表格单元格内容
+ * 读取时将转义的内容还原
+ *
+ * @param content 转义后的内容
+ * @returns 原始内容
+ */
+export declare function unescapeTableCell(content: string): string;
+/**
+ * 验证规则列表
+ * 每条规则必须是单行，不能包含 ## 标题
+ *
+ * @param rules 规则列表
+ * @throws XtepError 如果任何规则不合法
+ */
+export declare function validateRules(rules: string[]): void;
+//# sourceMappingURL=contentValidation.d.ts.map

package/dist/utils/contentValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentValidation.d.ts","sourceRoot":"","sources":["../../src/utils/contentValidation.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAcjF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAUlF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAYnD"}

package/dist/utils/contentValidation.js

@@ -0,0 +1,93 @@
+// src/utils/contentValidation.ts
+import { XtepError } from "../types/errors.js";
+/**
+ * 验证多行内容（不能包含行首 ## 标题）
+ *
+ * Info.md/Problem.md/Workspace.md 使用 ## 作为 section 分隔符
+ * 解析正则使用 (?=\n## |$) 作为边界，所以只有 ## 会触发边界
+ *
+ * 注意：# 一级标题和 ### 三级标题等不会破坏解析，允许使用
+ *
+ * @param content 要验证的内容
+ * @param fieldName 字段名称（用于错误信息）
+ * @throws XtepError 如果内容包含 ## 标题
+ */
+export function validateMultilineContent(content, fieldName) {
+    if (!content)
+        return;
+    // 只检测行首的 ## 二级标题格式（唯一会破坏 section 解析的格式）
+    // 匹配：行首的 ##（后跟空格），但不匹配 ### 及更多 #
+    const headerPattern = /^##(?!#)\s/m;
+    if (headerPattern.test(content)) {
+        throw new XtepError("INVALID_CONTENT", `「${fieldName}」不能包含 Markdown 二级标题（## ）格式，这会破坏文件的 section 解析。` +
+            `请使用其他格式替代，如：### 三级标题、# 一级标题、**加粗文本**、或直接去掉 ## 前缀。`);
+    }
+}
+/**
+ * 验证单行内容（不能包含换行符）
+ * Frontmatter 和列表项使用单行格式，换行符会破坏解析
+ *
+ * @param content 要验证的内容
+ * @param fieldName 字段名称（用于错误信息）
+ * @throws XtepError 如果内容包含换行符
+ */
+export function validateSingleLineContent(content, fieldName) {
+    if (!content)
+        return;
+    // 检测任何形式的换行符
+    if (/[\r\n]/.test(content)) {
+        throw new XtepError("INVALID_CONTENT", `「${fieldName}」不能包含换行符，必须是单行文本。`);
+    }
+}
+/**
+ * 转义表格单元格内容
+ * Log.md 使用 Markdown 表格格式，需要转义特殊字符
+ *
+ * @param content 原始内容
+ * @returns 转义后的内容
+ */
+export function escapeTableCell(content) {
+    if (!content)
+        return "";
+    return content
+        // 换行符转为 <br>
+        .replace(/\r\n/g, "<br>")
+        .replace(/\r/g, "<br>")
+        .replace(/\n/g, "<br>")
+        // 管道符转为全角（避免破坏表格结构）
+        .replace(/\|/g, "｜");
+}
+/**
+ * 还原表格单元格内容
+ * 读取时将转义的内容还原
+ *
+ * @param content 转义后的内容
+ * @returns 原始内容
+ */
+export function unescapeTableCell(content) {
+    if (!content)
+        return "";
+    return content
+        // <br> 还原为换行符
+        .replace(/<br>/g, "\n")
+        // 全角管道符还原
+        .replace(/｜/g, "|");
+}
+/**
+ * 验证规则列表
+ * 每条规则必须是单行，不能包含 ## 标题
+ *
+ * @param rules 规则列表
+ * @throws XtepError 如果任何规则不合法
+ */
+export function validateRules(rules) {
+    for (let i = 0; i < rules.length; i++) {
+        const rule = rules[i];
+        if (!rule || rule.trim().length === 0) {
+            throw new XtepError("INVALID_CONTENT", `第 ${i + 1} 条规则不能为空`);
+        }
+        // 规则是列表项，不能包含换行
+        validateSingleLineContent(rule, `第 ${i + 1} 条规则`);
+    }
+}
+//# sourceMappingURL=contentValidation.js.map

package/dist/utils/contentValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentValidation.js","sourceRoot":"","sources":["../../src/utils/contentValidation.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,SAAiB;IACzE,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,wCAAwC;IACxC,iCAAiC;IACjC,MAAM,aAAa,GAAG,aAAa,CAAC;IAEpC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CACjB,iBAAiB,EACjB,IAAI,SAAS,gDAAgD;YAC7D,mDAAmD,CACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe,EAAE,SAAiB;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,aAAa;IACb,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CACjB,iBAAiB,EACjB,IAAI,SAAS,mBAAmB,CACjC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,OAAO,OAAO;QACZ,aAAa;SACZ,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;SACxB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,oBAAoB;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,OAAO,OAAO;QACZ,cAAc;SACb,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;QACvB,UAAU;SACT,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CACjB,iBAAiB,EACjB,KAAK,CAAC,GAAG,CAAC,UAAU,CACrB,CAAC;QACJ,CAAC;QACD,gBAAgB;QAChB,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}