weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/blog/manifest.js

@@ -0,0 +1,415 @@
+const DATE = '^\\d{4}-\\d{2}-\\d{2}$';
+const POSITIVE_ID = { type: 'string', pattern: '^[1-9]\\d*$' };
+const CONFIRM_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        continuation: { type: 'string', minLength: 1, description: 'prepare 返回的确认令牌（HMAC 签发，10 分钟有效）' },
+        confirm: { const: true, description: '必须显式为 true，否则 CLI 拒绝写入' },
+    },
+    required: ['continuation', 'confirm'],
+};
+/** 本模块全部 operation 合约（WHAT）：名称、风险等级、固定参数与输入 JSON Schema。 */
+export const blogOperations = [
+    {
+        name: 'blog.query',
+        risk: 'read',
+        summary: '群体日报查询（直接/间接/全部下属、我关注的人），窗口裁剪在客户端完成',
+        fixed: { blogType: 'order', timezoneOffset: -8 },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                user_type: {
+                    type: 'string',
+                    enum: ['directSubordinate', 'indirectSubordinate', 'allSubordinate', 'myFollow'],
+                    description: '人员范围：directSubordinate=直接下属，indirectSubordinate=间接下属，allSubordinate=全部下属，myFollow=我关注的人。查指定个人请改用 blog.query_user。',
+                },
+                start_date: { type: 'string', pattern: DATE, description: '窗口起始日期（客户端裁剪用）' },
+                end_date: { type: 'string', pattern: DATE, description: '窗口结束日期（含）；区间按天计数，上限 62 天' },
+                keywords: { type: 'string', description: '按内容关键字服务端模糊过滤，可传空串' },
+                page_size: { type: 'integer', minimum: 1, maximum: 300, default: 300, description: '服务端单页返回行数（上限 300）。行数 ≈ 人数 × 天数，窗口大时保持默认 300 以尽量覆盖' },
+                page_no: { type: 'integer', minimum: 1, default: 1, description: '透传页码；服务端实测忽略 pageNo（返回同一批数据），调大不会拿到更多数据' },
+            },
+            required: ['user_type', 'start_date', 'end_date'],
+        },
+        inputExamples: [
+            {
+                name: '查我关注的人本周日报',
+                input: { user_type: 'myFollow', start_date: '2026-09-14', end_date: '2026-09-18' },
+                source: 'scripts/query-weaver-e10-blog.mjs（--userType myfollow 用法）',
+                sourceType: 'source-provided',
+            },
+            {
+                name: '查直接下属日报',
+                input: { user_type: 'directSubordinate', start_date: '2026-09-01', end_date: '2026-09-30' },
+                source: 'SKILL.md 能力表（下属日报查询场景）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.query_user',
+        risk: 'read',
+        summary: '单人日报逐日扫描（detailsByDate），区间上限 62 天；查指定个人的唯一可靠路径',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                user_id: { ...POSITIVE_ID, description: '目标人员 userId；与 name 二选一，都缺省时查当前登录人的日报' },
+                name: { type: 'string', minLength: 1, description: '目标人员姓名，经 HRM 精确解析；与 user_id 二选一，同名多命中时报错并列出候选' },
+                date: { type: 'string', pattern: DATE, description: '起始日期 YYYY-MM-DD' },
+                end_date: { type: 'string', pattern: DATE, description: '结束日期（含），缺省时只查 date 当天；区间按天扫描，上限 62 天' },
+            },
+            required: ['date'],
+        },
+        inputExamples: [
+            {
+                name: '按姓名查某天日报',
+                input: { name: '章智涵', date: '2026-08-18' },
+                source: 'scripts/query-day.mjs 用法示例（node query-day.mjs 2026-08-18 --name 章智涵）',
+                sourceType: 'source-provided',
+            },
+            {
+                name: '按 userId 查一段日报',
+                input: { user_id: '1077039731822690306', date: '2026-08-17', end_date: '2026-08-20' },
+                source: 'scripts/query-day.mjs 用法示例（--userId 1077039731822690306）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.resolve_users',
+        risk: 'read',
+        summary: 'HRM 按姓名精确解析 userId（取 id 字段，不是 userid）',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                name: { type: 'string', minLength: 1, description: '员工姓名（精确匹配）' },
+            },
+            required: ['name'],
+        },
+        inputExamples: [
+            {
+                name: '按姓名解析',
+                input: { name: '章智涵' },
+                source: 'scripts/query-weaver-e10-blog.mjs（HRM 解析姓名段）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.comments',
+        risk: 'read',
+        summary: '查某条日报的评论列表（commentPage）',
+        fixed: { module: 'blog', foldCommentList: false },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                blog_id: { ...POSITIVE_ID, description: '日报记录 id（detailsByDate 的 blog.id）' },
+                page_no: { type: 'integer', minimum: 1, maximum: 10_000, default: 1 },
+                page_size: { type: 'integer', minimum: 1, maximum: 100, default: 20 },
+            },
+            required: ['blog_id'],
+        },
+        inputExamples: [
+            {
+                name: '查某日报评论',
+                input: { blog_id: '1310837921662951425' },
+                source: 'scripts/query-comments.mjs（--blogId 入参）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.default_permission',
+        risk: 'read',
+        summary: '查某日期的默认共享对象，供发布时回填 permissionList',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                date: { type: 'string', pattern: DATE, description: '日报归属日期，返回的 data.list 可直接作为发布时的共享对象' },
+            },
+            required: ['date'],
+        },
+        inputExamples: [
+            {
+                name: '查默认共享（按日期）',
+                input: { date: '2026-08-19' },
+                source: 'references/daily-report-blog-get-default-permission.md（blogTime 入参）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.export',
+        risk: 'local-file-write',
+        summary: '导出日报报表为 xlsx（拒绝覆盖已有文件）',
+        fixed: { blogType: 'all', searchType: 'all', disableType: 'all', isNeedConvert: false },
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                start_date: { type: 'string', pattern: DATE },
+                end_date: { type: 'string', pattern: DATE },
+                output: { type: 'string', minLength: 1, description: '本地输出 .xlsx 路径；文件已存在时拒绝覆盖' },
+                page_size: { type: 'integer', minimum: 1, maximum: 500, default: 200 },
+            },
+            required: ['start_date', 'end_date', 'output'],
+        },
+        inputExamples: [
+            {
+                name: '导出某月日报',
+                input: { start_date: '2026-08-01', end_date: '2026-08-31', output: 'C:/path/to/aug.xlsx' },
+                source: 'scripts/export-blog.mjs 用法示例（node export-blog.mjs 2026-08-01 2026-08-31 --out ...）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.publish.prepare',
+        risk: 'read-before-write',
+        summary: '发布准备：查当日是否已有日报 + 回填默认共享 + 签发 continuation（不写数据）',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                date: { type: 'string', pattern: DATE, description: '日报归属日期（只能发布当前登录人自己的日报）' },
+                content: { type: 'string', minLength: 1, description: '日报正文；纯文本自动包裹 <p>，HTML 原样保留' },
+                share_default: { type: 'boolean', default: true, description: '是否回填该日期的默认共享对象；false 表示仅自己可见' },
+            },
+            required: ['date', 'content'],
+        },
+        inputExamples: [
+            {
+                name: '准备发布某日日报',
+                input: { date: '2026-08-19', content: '<p>今日工作总结</p>', share_default: true },
+                source: 'scripts/publish-blog.mjs 用法示例（node publish-blog.mjs 2026-08-14 "<p>补交内容</p>" --share）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.publish.apply',
+        risk: 'high-risk-write',
+        summary: '发布落库：校验 continuation 与写前状态后调用 addBlog，并回查验证',
+        inputSchema: CONFIRM_SCHEMA,
+        missingExamples: [
+            {
+                reason: 'apply 的唯一入参是 prepare 当场签发的 continuation，源资料不提供固定样例',
+                missingFacts: ['continuation'],
+                source: 'scripts/publish-blog.mjs（无 continuation 概念）',
+            },
+        ],
+    },
+    {
+        name: 'blog.edit.prepare',
+        risk: 'read-before-write',
+        summary: '编辑准备：回查原内容与差异 + 目标指纹 + 签发 continuation（不写数据）',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                user_id: { ...POSITIVE_ID, description: '目标人员 userId；与 name 二选一；都不传时编辑当前登录人的日报' },
+                name: { type: 'string', minLength: 1, description: '目标人员姓名；与 user_id 二选一' },
+                date: { type: 'string', pattern: DATE },
+                content: { type: 'string', minLength: 1, description: '新日报正文；纯文本自动包裹 <p>' },
+            },
+            required: ['date', 'content'],
+        },
+        inputExamples: [
+            {
+                name: '准备编辑自己的日报',
+                input: { date: '2026-08-19', content: '<p>修正后的内容</p>' },
+                source: 'scripts/edit-blog.mjs（blogTime + content 入参）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.edit.apply',
+        risk: 'high-risk-write',
+        summary: '编辑落库：目标指纹校验后调用 updateBlog，并回查内容一致性',
+        inputSchema: CONFIRM_SCHEMA,
+        missingExamples: [
+            {
+                reason: 'apply 的唯一入参是 prepare 当场签发的 continuation，源资料不提供固定样例',
+                missingFacts: ['continuation'],
+                source: 'scripts/edit-blog.mjs（无 continuation 概念）',
+            },
+        ],
+    },
+    {
+        name: 'blog.comment.prepare',
+        risk: 'read-before-write',
+        summary: '评论准备：定位目标日报（blog_id 或 date+user）后签发 continuation',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                blog_id: { ...POSITIVE_ID, description: '日报记录 id；与 date（+ user_id/name）二选一' },
+                user_id: POSITIVE_ID,
+                name: { type: 'string', minLength: 1 },
+                date: { type: 'string', pattern: DATE },
+                content: { type: 'string', minLength: 1, description: '评论内容' },
+            },
+            required: ['content'],
+            anyOf: [{ required: ['blog_id'] }, { required: ['date'] }],
+        },
+        inputExamples: [
+            {
+                name: '按日期定位并评论',
+                input: { date: '2026-08-19', content: '收到，请补齐明细' },
+                source: 'scripts/comment-blog.mjs（blogId 或 date+name 定位）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.comment.apply',
+        risk: 'high-risk-write',
+        summary: '评论落库：createComment 后从评论列表回查该评论',
+        inputSchema: CONFIRM_SCHEMA,
+        missingExamples: [
+            {
+                reason: 'apply 的唯一入参是 prepare 当场签发的 continuation，源资料不提供固定样例',
+                missingFacts: ['continuation'],
+                source: 'scripts/comment-blog.mjs（无 continuation 概念）',
+            },
+        ],
+    },
+    {
+        name: 'blog.like.prepare',
+        risk: 'read-before-write',
+        summary: '点赞/取消点赞准备：定位目标日报后签发 continuation',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                blog_id: { ...POSITIVE_ID, description: '日报记录 id；与 date（+ user_id/name）二选一' },
+                user_id: POSITIVE_ID,
+                name: { type: 'string', minLength: 1 },
+                date: { type: 'string', pattern: DATE },
+                cancel: { type: 'boolean', default: false, description: 'false=点赞（vote），true=取消点赞（cancelVote）' },
+            },
+            anyOf: [{ required: ['blog_id'] }, { required: ['date'] }],
+        },
+        inputExamples: [
+            {
+                name: '按日期点赞',
+                input: { date: '2026-08-19' },
+                source: 'scripts/like-blog.mjs（vote / cancelVote 两种路径）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.like.apply',
+        risk: 'high-risk-write',
+        summary: '点赞落库：vote / cancelVote，以业务码为生效依据（无只读回查接口）',
+        inputSchema: CONFIRM_SCHEMA,
+        missingExamples: [
+            {
+                reason: 'apply 的唯一入参是 prepare 当场签发的 continuation，源资料不提供固定样例',
+                missingFacts: ['continuation'],
+                source: 'scripts/like-blog.mjs（无 continuation 概念）',
+            },
+        ],
+    },
+    {
+        name: 'blog.remind.prepare',
+        risk: 'read-before-write',
+        summary: '提醒准备：解析被提醒人 + 生成默认文案 + 签发 continuation（不发送）',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                user_ids: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 50,
+                    items: POSITIVE_ID,
+                    description: '被提醒人 userId 列表（或逗号分隔字符串）；与 names 二选一',
+                },
+                names: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 50,
+                    items: { type: 'string', minLength: 1 },
+                    description: '被提醒人姓名列表，经 HRM 解析；与 user_ids 二选一',
+                },
+                date: { type: 'string', pattern: DATE, description: '日报归属日期，用于默认文案与年份' },
+                content: { type: 'string', minLength: 1, description: '提醒文案；缺省时生成「请填写 YYYY年 M月 D日 的日报！」，自定义文案必须包含日期' },
+                year: { type: 'integer', minimum: 2000, maximum: 2100, description: '日报所属年份；缺省时从 date 推断' },
+            },
+            required: ['date'],
+            oneOf: [{ required: ['user_ids'] }, { required: ['names'] }],
+        },
+        inputExamples: [
+            {
+                name: '按 userId 提醒（默认文案）',
+                input: { user_ids: ['1077039731822690306'], date: '2026-08-19' },
+                source: 'scripts/remind-blog.mjs 用法示例（--userId 1077039731822690306 --date 2026-08-19）',
+                sourceType: 'source-provided',
+            },
+            {
+                name: '按姓名提醒（自定义文案）',
+                input: { names: ['章智涵'], content: '请尽快提交 8 月 19 日日报', year: 2026 },
+                source: 'scripts/remind-blog.mjs 用法示例（--name 章智涵 --content ... --year 2026）',
+                sourceType: 'source-provided',
+            },
+        ],
+    },
+    {
+        name: 'blog.remind.apply',
+        risk: 'high-risk-write',
+        summary: '提醒落库：逐人 POST sendUrge；部分失败返回 PARTIAL，中断返回 write_uncertain',
+        inputSchema: CONFIRM_SCHEMA,
+        missingExamples: [
+            {
+                reason: 'apply 的唯一入参是 prepare 当场签发的 continuation，源资料不提供固定样例',
+                missingFacts: ['continuation'],
+                source: 'scripts/remind-blog.mjs（无 continuation 概念）',
+            },
+        ],
+    },
+];
+export const blogManifest = {
+    schemaVersion: 1,
+    name: 'blog',
+    title: '泛微E10工作日报',
+    version: '0.1.0',
+    host: 'e10-blog',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-blog',
+    capabilities: ['query', 'query-user', 'comments', 'export', 'publish', 'edit', 'comment', 'like', 'remind'],
+    operations: blogOperations,
+    withheldOperations: [
+        {
+            name: 'blog.query_by_ids',
+            reason: 'blogs 接口的 filter.userIds/empIds/userId/creator 被服务端忽略（内网租户实测，恒定返回当前登录人且 HTTP 200），按 userId 列表查个人会静默变成查自己；查指定个人统一走 blog.query_user（detailsByDate）。',
+        },
+        {
+            name: 'blog.unread',
+            reason: 'POST /api/blog/query/unRead 在当前租户多种 body 形态实测恒返回空 blogList，不可作为数据源。',
+        },
+        {
+            name: 'blog.eb.*',
+            reason: 'EB 日报应用接口族（ebuilder getFormDataList + secondev addBlog/editBlog）依赖租户是否启用 EB 日报应用，当前租户未启用；启用后需另行转换并按租户探测。',
+        },
+        {
+            name: 'blog.delete',
+            reason: '服务端未提供日报删除接口，源资料亦无删除脚本；不做推测实现。',
+        },
+        {
+            name: 'blog.remind.cancel',
+            reason: '已发送提醒无法撤回（源资料无对应接口）。',
+        },
+    ],
+};
+export function hasBlogOperation(operation) {
+    return blogOperations.some((item) => item.name === operation);
+}

package/dist/shortcuts/blog/operations/comment.js

@@ -0,0 +1,125 @@
+import { blogConfirmationError, blogPartialError, blogValidationError, isBlogNetworkError, } from '../errors.js';
+import { objectFingerprint, resolveTargetBlog, sessionMatches } from './shared.js';
+import { workflow } from './types.js';
+/** 评论 prepare：定位目标日报（无日报直接报错，不追问），签发 continuation */
+export class BlogCommentPrepareOperation {
+    name = 'blog.comment.prepare';
+    async execute(input, { host, continuation }) {
+        const content = typeof input.content === 'string' ? input.content.trim() : '';
+        if (!content)
+            throw blogValidationError('input_invalid', 'content 必须是非空字符串');
+        const target = await resolveTargetBlog(input, host, '评论');
+        const session = await host.getSession();
+        const continuationToken = await continuation.issue({
+            operation: 'blog.comment.apply',
+            workflow: workflow('blog.comment', 'AWAITING_CONFIRMATION'),
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            blogId: target.blogId,
+            content,
+            fingerprint: objectFingerprint(target.blog ? { id: target.blog.id, content: target.blog.content } : { id: target.blogId }),
+        });
+        return {
+            status: 'AWAITING_CONFIRMATION',
+            data: {
+                blog_id: target.blogId,
+                target: target.date ? { date: target.date, user_id: target.userId } : undefined,
+                target_content_text: target.blog?.content_text,
+                comment: content,
+                continuation: continuationToken,
+                expires_in_seconds: 600,
+                workflow: workflow('blog.comment', 'AWAITING_CONFIRMATION'),
+                next: '向用户复述目标日报与评论内容，用户确认后调用 blog.comment.apply 并传 confirm=true',
+            },
+        };
+    }
+}
+/** 评论 apply：确认 + continuation + 写后从评论列表回查该评论 */
+export class BlogCommentApplyOperation {
+    name = 'blog.comment.apply';
+    async execute(input, { host, continuation }) {
+        if (input.confirm !== true) {
+            throw blogConfirmationError('blog.comment.apply', { hint: '重新调用时传入 confirm=true' });
+        }
+        const lease = await continuation.verify(input.continuation, 'blog.comment.apply');
+        if (typeof lease.blogId !== 'string' || typeof lease.content !== 'string') {
+            throw blogValidationError('continuation_invalid', '评论 continuation 缺少有效目标或内容');
+        }
+        const session = await host.getSession();
+        if (!sessionMatches(lease, session)) {
+            throw blogValidationError('context_mismatch', '确认上下文已变化，请重新准备评论');
+        }
+        let result;
+        try {
+            result = await host.blogRequest({
+                path: '/api/blog/common/comment/createComment',
+                body: {
+                    comment: {
+                        targetId: lease.blogId,
+                        disableMessage: false,
+                        relevanceList: [],
+                        imAtContent: lease.content,
+                        atLinkList: [],
+                        content: lease.content,
+                        originContent: lease.content,
+                        module: 'blog',
+                    },
+                    attachments: '',
+                    attachmentsList: [],
+                    client: 'pc',
+                },
+                operation: 'blog.comment.apply',
+            });
+        }
+        catch (error) {
+            if (isBlogNetworkError(error)) {
+                throw blogPartialError('评论请求发送后连接中断，结果不确定，禁止自动重试', {
+                    blog_id: lease.blogId,
+                    workflow: workflow('blog.comment', 'EXECUTING'),
+                }, { stage: 'comment' });
+            }
+            throw error;
+        }
+        // 写后回查：评论列表中应能找到该评论
+        let verified = false;
+        let commentId = null;
+        try {
+            const page = await host.blogRequest({
+                path: '/api/blog/common/comment/commentPage',
+                body: { pageNo: 1, pageSize: 50, targetId: lease.blogId, module: 'blog', foldCommentList: false },
+                operation: 'blog.comment.apply',
+            });
+            const comments = Array.isArray(page?.data?.page?.result) ? page.data.page.result : [];
+            const matched = comments.find((item) => item?.content === lease.content);
+            if (matched?.id) {
+                verified = true;
+                commentId = String(matched.id);
+            }
+        }
+        catch {
+            throw blogPartialError('评论接口已返回成功，但评论列表回查失败，结果不确定', {
+                blog_id: lease.blogId,
+                result,
+                workflow: workflow('blog.comment', 'VERIFYING'),
+            }, { stage: 'readback' });
+        }
+        if (!verified) {
+            throw blogPartialError('评论接口已返回成功，但评论列表中未找到该评论', {
+                blog_id: lease.blogId,
+                result,
+                workflow: workflow('blog.comment', 'VERIFYING'),
+            }, { stage: 'readback' });
+        }
+        return {
+            status: 'COMPLETE',
+            data: {
+                blog_id: lease.blogId,
+                comment_id: commentId,
+                verified: true,
+                result,
+                workflow: workflow('blog.comment', 'COMPLETE'),
+            },
+        };
+    }
+}

package/dist/shortcuts/blog/operations/comments.js

@@ -0,0 +1,31 @@
+import { asInteger, asPositiveString } from './shared.js';
+export class BlogCommentsOperation {
+    name = 'blog.comments';
+    async execute(input, { host }) {
+        const blogId = asPositiveString(input.blog_id, 'blog_id');
+        const pageNo = asInteger(input.page_no, 'page_no', { min: 1, max: 10_000, dflt: 1 });
+        const pageSize = asInteger(input.page_size, 'page_size', { min: 1, max: 100, dflt: 20 });
+        const value = await host.blogRequest({
+            path: '/api/blog/common/comment/commentPage',
+            body: {
+                pageNo,
+                pageSize,
+                targetId: blogId,
+                module: 'blog',
+                foldCommentList: false,
+            },
+            operation: 'blog.comments',
+        });
+        const page = value?.data?.page ?? {};
+        return {
+            status: 'COMPLETE',
+            data: {
+                blog_id: blogId,
+                total_count: page.totalCount ?? null,
+                page_no: page.pageNo ?? pageNo,
+                page_size: page.pageSize ?? pageSize,
+                comments: Array.isArray(page.result) ? page.result : [],
+            },
+        };
+    }
+}