@dinoxx/dinox-cli 1.0.12 → 1.0.13

package/README.md

@@ -13,10 +13,11 @@
 1. 登录账号：`dino auth login ...`
 2. 同步数据：`dino sync`
 3. 搜索笔记：`dino note search "关键词"`
-4. 新建笔记：`dino note create ...`
-5. 新建标签：`dino tag add ...`
-6. 新建卡片盒：`dino box add ...`
-7. 看当前版本：`dino info`
+4. 搜索待办：`dino todo search ...`
+5. 新建笔记：`dino note create ...`
+6. 新建标签：`dino tag add ...`
+7. 新建卡片盒：`dino box add ...`
+8. 看当前版本：`dino info`
 
 ---
 
@@ -119,6 +120,38 @@ dino note search "AI" --box "Inbox"
 dino note search --sql 'type = "crawl" AND zettel_boxes IN ("Inbox","Project")'
 ```
 
+搜索待办（基于 `image_detail` 的 taskList）：
+
+```bash
+dino todo search
+dino todo search "付款"
+dino todo search "付款" --status uncompleted --tags "工作,财务"
+dino todo search --from 2026-03-01 --to 2026-03-07 --limit 100
+```
+
+追加待办到现有笔记：
+
+```bash
+dino todo append "补交报销单"
+dino todo append --note-id <note-id> --task "补交报销单" --task "整理发票"
+dino todo append --tasks '["补交报销单","整理发票"]'
+```
+
+创建新的待办笔记：
+
+```bash
+dino todo create "补交报销单"
+dino todo create --task "补交报销单" --task "整理发票" --title "本周财务待办"
+dino todo create --tasks @./todo.txt
+```
+
+更新待办完成状态：
+
+```bash
+dino todo update <task-id> --status completed
+dino todo update <task-id> --status uncompleted
+```
+
 创建笔记：
 
 ```bash
@@ -526,6 +559,101 @@ sync.timeoutMs    (必须为正整数)
 
 支持全局参数：`--json`
 
+## 8.10 `todo` 命令
+
+### `dino todo search [query]`
+
+搜索待办任务（任务来源：`c_note.image_detail` 中的 taskItem/taskList）。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[query]` | 否 | 按任务文本模糊匹配（不区分大小写）。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--status <status>` | 否 | 任务状态：`all` / `completed` / `uncompleted`（默认 `all`）。 |
+| `--tags <string\|@file>` | 否 | 任务标签筛选（JSON 数组或逗号/换行分隔），任务需包含全部标签。 |
+| `--from <date>` | 否 | 任务时间范围起点（`YYYY-MM-DD` 或 ISO datetime）。 |
+| `--to <date>` | 否 | 任务时间范围终点（`YYYY-MM-DD` 或 ISO datetime）。 |
+| `--days <n>` | 否 | 最近 N 天（不能与 `--from/--to` 同时使用）。 |
+| `--limit <n>` | 否 | 返回任务数上限（默认 `50`，最大 `500`）。 |
+| `--scan-limit <n>` | 否 | 扫描 `c_note` 行数上限（默认 `200`，最大 `5000`）。 |
+| `--include-deleted` | 否 | 包含软删除笔记中的任务。 |
+
+输出结构说明（AI 友好）：
+
+- 顶层包含 `meta`（查询条件回显、返回数量、是否截断）与 `tasks`（任务数组）。
+- 每条任务包含 `task_key`、`note_id`、`note_title`、`status`、层级关系与时间字段。
+
+支持全局参数：`--offline`、`--sync-timeout`
+
+### `dino todo append [task]`
+
+向笔记末尾追加一个或多个待办任务。
+
+说明：
+
+- `content_json` 是真源，`image_detail` 会从更新后的 `content_json` 派生回写。
+- 若不传 `--note-id`，默认选择 `image_detail` 非空且不为 `[]` 的最新笔记（按 `created_at` 降序）。
+- 若笔记末尾已有 `taskList`，会并入该 `taskList`；否则在末尾创建新的 `taskList`。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[task]` | 否 | 单个任务文本。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--task <text>` | 否 | 任务文本（可重复传入）。 |
+| `--tasks <string\|@file>` | 否 | 任务列表（JSON 数组或逗号/换行分隔）。 |
+| `--note-id <id>` | 否 | 指定目标笔记 ID。 |
+
+说明：`[task]`、`--task`、`--tasks` 至少提供一个。
+
+支持全局参数：`--offline`、`--sync-timeout`
+
+### `dino todo create [task]`
+
+创建一篇新笔记，并写入一个或多个待办任务。
+
+说明：
+
+- `content_json` 是真源，`image_detail` 从 `content_json` 派生回写。
+- 默认自动生成总结性标题（可用 `--title` 覆盖）。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[task]` | 否 | 单个任务文本。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--task <text>` | 否 | 任务文本（可重复传入）。 |
+| `--tasks <string\|@file>` | 否 | 任务列表（JSON 数组或逗号/换行分隔）。 |
+| `--title <string>` | 否 | 自定义笔记标题。 |
+
+说明：`[task]`、`--task`、`--tasks` 至少提供一个。
+
+支持全局参数：`--offline`、`--sync-timeout`
+
+### `dino todo update <taskId> --status <status>`
+
+更新任务完成状态（按 taskId 定位）。
+
+说明：
+
+- 只接受合法状态值：`completed` / `uncompleted`（兼容 `done` / `undone` / `true` / `false` / `1` / `0`）。
+- `content_json` 是真源，更新后会同步回写 `image_detail`、`content_md`、`content_text`。
+- 若同一个 taskId 出现在多篇笔记，会报错并拒绝更新（避免误改）。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<taskId>` | 是 | 任务 ID。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--status <status>` | 是 | 目标状态。 |
+
+支持全局参数：`--offline`、`--sync-timeout`
+
 ---
 
 ## 9. 查看帮助

package/dist/cli.js

@@ -8,6 +8,7 @@ import { registerPromptCommands } from './commands/prompt/index.js';
 import { registerSyncCommand } from './commands/sync.js';
 import { registerUpdateCommand } from './commands/update.js';
 import { registerTagsCommand } from './commands/tags/index.js';
+import { registerTodoCommands } from './commands/todo/index.js';
 import { getPackageVersion } from './utils/version.js';
 export function createCli() {
     const program = new Command();
@@ -29,6 +30,7 @@ export function createCli() {
     registerUpdateCommand(program);
     registerPromptCommands(program);
     registerTagsCommand(program);
+    registerTodoCommands(program);
     registerNoteCommands(program);
     return program;
 }

package/dist/commands/notes/repo.d.ts

@@ -61,6 +61,7 @@ export declare function createNote(db: AbstractPowerSyncDatabase, input: {
     tags: string[];
     zettelBoxIds: string[];
     userId: string;
+    imageDetail?: unknown[];
 }): Promise<{
     id: string;
 }>;

package/dist/commands/notes/repo.js

@@ -571,6 +571,7 @@ export async function createNote(db, input) {
     const contentJson = JSON.stringify(input.contentJson);
     const tags = JSON.stringify(input.tags);
     const zettelBoxes = JSON.stringify(input.zettelBoxIds);
+    const imageDetail = JSON.stringify(Array.isArray(input.imageDetail) ? input.imageDetail : []);
     const columns = await db.getAll('PRAGMA table_info(c_note)', []);
     const columnNames = new Set(columns
         .map((row) => row.name?.trim().toLowerCase() ?? '')
@@ -628,7 +629,7 @@ export async function createNote(db, input) {
         ['files', '[]'],
         ['audios', '[]'],
         ['audio_detail', '{}'],
-        ['image_detail', '{}'],
+        ['image_detail', imageDetail],
         ['source', ''],
         ['resource_id', null],
         ['note_ids', '[]'],

package/dist/commands/todo/contentModel.d.ts

@@ -0,0 +1,30 @@
+type JsonRecord = Record<string, unknown>;
+type TodoTaskItemNode = {
+    type: 'taskItem';
+    id: string;
+    checked: boolean;
+    attrs: {
+        id: string;
+        checked: boolean;
+        [key: string]: unknown;
+    };
+    content: unknown[];
+};
+export type ApplyTaskCheckedStatusResult = {
+    nextDoc: JsonRecord;
+    taskOrder: string[];
+    matchedIndices: number[];
+    changedCount: number;
+};
+export declare function parseTiptapDocFromDb(rawContentJson: string | null): JsonRecord;
+export declare function createTodoDocFromTasks(taskTexts: string[]): JsonRecord;
+export declare function appendTasksToDoc(doc: JsonRecord, taskTexts: string[]): JsonRecord;
+export declare function deriveImageDetailFromContentJson(doc: JsonRecord): TodoTaskItemNode[];
+export declare function buildAppendMarkdown(existingMarkdown: string | null, taskTexts: string[]): string;
+export declare function buildCreateMarkdown(taskTexts: string[]): string;
+export declare function buildContentTextPreview(contentMd: string): string;
+export declare function buildSummaryTitle(taskTexts: string[]): string;
+export declare function normalizeTaskTexts(values: string[]): string[];
+export declare function applyTaskCheckedStatus(doc: JsonRecord, taskId: string, checked: boolean): ApplyTaskCheckedStatusResult;
+export declare function patchTaskMarkdownByOrder(contentMd: string | null, taskOrder: string[], matchedIndices: number[], checked: boolean): string;
+export {};

package/dist/commands/todo/contentModel.js

@@ -0,0 +1,325 @@
+import { DinoxError } from '../../utils/errors.js';
+import { generateId } from '../../utils/id.js';
+import { stripMarkdown } from '../../utils/text.js';
+const CONTENT_TEXT_PREVIEW_LIMIT = 300;
+const DEFAULT_TITLE_PREFIX = '待办清单';
+export function parseTiptapDocFromDb(rawContentJson) {
+    const raw = (rawContentJson ?? '').trim();
+    if (!raw) {
+        throw new DinoxError('Invalid note content_json: empty value');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new DinoxError('Invalid note content_json: malformed JSON', { cause: error });
+    }
+    return assertTiptapDoc(parsed);
+}
+export function createTodoDocFromTasks(taskTexts) {
+    const tasks = buildTaskItemNodes(taskTexts);
+    return {
+        type: 'doc',
+        content: [
+            {
+                type: 'taskList',
+                content: tasks,
+            },
+        ],
+    };
+}
+export function appendTasksToDoc(doc, taskTexts) {
+    const nextDoc = cloneJson(doc);
+    const tasks = buildTaskItemNodes(taskTexts);
+    const content = ensureDocContentArray(nextDoc);
+    const lastIndex = content.length - 1;
+    const lastNode = lastIndex >= 0 ? content[lastIndex] : null;
+    if (isTaskListNode(lastNode)) {
+        const listContent = ensureNodeContentArray(lastNode);
+        listContent.push(...tasks);
+        return nextDoc;
+    }
+    content.push({
+        type: 'taskList',
+        content: tasks,
+    });
+    return nextDoc;
+}
+export function deriveImageDetailFromContentJson(doc) {
+    const root = assertTiptapDoc(doc);
+    const rootContent = ensureNodeContentArray(root);
+    const result = [];
+    const nodeStack = [];
+    const insideTaskStack = [];
+    for (let index = rootContent.length - 1; index >= 0; index -= 1) {
+        nodeStack.push(rootContent[index]);
+        insideTaskStack.push(false);
+    }
+    while (nodeStack.length > 0) {
+        const current = nodeStack.pop();
+        const insideTaskItem = insideTaskStack.pop() ?? false;
+        if (!current || typeof current !== 'object') {
+            continue;
+        }
+        const node = current;
+        const type = typeof node.type === 'string' ? node.type : '';
+        const content = Array.isArray(node.content) ? node.content : [];
+        if (type === 'taskItem' && !insideTaskItem) {
+            result.push(normalizeTaskItemNode(node));
+        }
+        const nextInsideTaskItem = insideTaskItem || type === 'taskItem';
+        for (let index = content.length - 1; index >= 0; index -= 1) {
+            nodeStack.push(content[index]);
+            insideTaskStack.push(nextInsideTaskItem);
+        }
+    }
+    return result;
+}
+export function buildAppendMarkdown(existingMarkdown, taskTexts) {
+    const trimmed = (existingMarkdown ?? '').trimEnd();
+    const taskBlock = buildTaskMarkdown(taskTexts);
+    if (!trimmed) {
+        return taskBlock;
+    }
+    return `${trimmed}\n\n${taskBlock}`;
+}
+export function buildCreateMarkdown(taskTexts) {
+    return buildTaskMarkdown(taskTexts);
+}
+export function buildContentTextPreview(contentMd) {
+    const plain = stripMarkdown(contentMd);
+    const chars = Array.from(plain);
+    if (chars.length <= CONTENT_TEXT_PREVIEW_LIMIT) {
+        return plain;
+    }
+    return chars.slice(0, CONTENT_TEXT_PREVIEW_LIMIT).join('');
+}
+export function buildSummaryTitle(taskTexts) {
+    const count = taskTexts.length;
+    const keywords = taskTexts
+        .slice(0, 2)
+        .map((task) => task.trim())
+        .filter(Boolean)
+        .map((task) => truncateChars(task, 12))
+        .join('、');
+    if (!keywords) {
+        return `${DEFAULT_TITLE_PREFIX}（${count}项）`;
+    }
+    const base = `${DEFAULT_TITLE_PREFIX}（${count}项）：${keywords}`;
+    return truncateChars(base, 60);
+}
+export function normalizeTaskTexts(values) {
+    const normalized = values
+        .map((value) => value.replace(/\s+/g, ' ').trim())
+        .filter((value) => value.length > 0);
+    if (normalized.length === 0) {
+        throw new DinoxError('At least one non-empty task is required');
+    }
+    return normalized;
+}
+export function applyTaskCheckedStatus(doc, taskId, checked) {
+    const normalizedTaskId = taskId.trim();
+    if (!normalizedTaskId) {
+        throw new DinoxError('taskId is required');
+    }
+    const nextDoc = cloneJson(assertTiptapDoc(doc));
+    const taskOrder = [];
+    const matchedIndices = [];
+    let changedCount = 0;
+    const visitNode = (value) => {
+        if (!value || typeof value !== 'object') {
+            return;
+        }
+        const node = value;
+        const type = typeof node.type === 'string' ? node.type : '';
+        if (type === 'taskItem') {
+            const currentTaskId = resolveTaskId(node);
+            if (currentTaskId) {
+                const currentIndex = taskOrder.length;
+                taskOrder.push(currentTaskId);
+                if (currentTaskId === normalizedTaskId) {
+                    matchedIndices.push(currentIndex);
+                    const attrs = ensureNodeAttrs(node);
+                    const previousChecked = normalizeChecked(node.checked) ?? normalizeChecked(attrs.checked) ?? false;
+                    if (previousChecked !== checked) {
+                        changedCount += 1;
+                    }
+                    node.id = currentTaskId;
+                    node.checked = checked;
+                    attrs.id = currentTaskId;
+                    attrs.checked = checked;
+                }
+            }
+        }
+        const content = Array.isArray(node.content) ? node.content : [];
+        for (const child of content) {
+            visitNode(child);
+        }
+    };
+    visitNode(nextDoc);
+    return {
+        nextDoc,
+        taskOrder,
+        matchedIndices,
+        changedCount,
+    };
+}
+export function patchTaskMarkdownByOrder(contentMd, taskOrder, matchedIndices, checked) {
+    if (taskOrder.length === 0 || matchedIndices.length === 0) {
+        return contentMd ?? '';
+    }
+    const markdown = contentMd ?? '';
+    if (!markdown.trim()) {
+        throw new DinoxError('Cannot update task markdown: note has task entries in content_json but empty content_md.');
+    }
+    const lines = markdown.split('\n');
+    const checklistLineIndexes = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        if (TASK_MARKDOWN_LINE_RE.test(lines[index] ?? '')) {
+            checklistLineIndexes.push(index);
+        }
+    }
+    if (checklistLineIndexes.length !== taskOrder.length) {
+        throw new DinoxError(`Cannot update task markdown: checklist line count (${checklistLineIndexes.length}) does not match content_json task count (${taskOrder.length}).`);
+    }
+    for (const matchedIndex of matchedIndices) {
+        const lineIndex = checklistLineIndexes[matchedIndex];
+        if (lineIndex === undefined) {
+            throw new DinoxError('Cannot update task markdown: task index is out of range.');
+        }
+        lines[lineIndex] = patchChecklistLine(lines[lineIndex] ?? '', checked);
+    }
+    return lines.join('\n');
+}
+function buildTaskItemNodes(taskTexts) {
+    const normalizedTasks = normalizeTaskTexts(taskTexts);
+    return normalizedTasks.map((text) => {
+        const taskId = generateId();
+        return {
+            type: 'taskItem',
+            id: taskId,
+            checked: false,
+            attrs: {
+                id: taskId,
+                checked: false,
+            },
+            content: [
+                {
+                    type: 'paragraph',
+                    content: [
+                        {
+                            type: 'text',
+                            text,
+                        },
+                    ],
+                },
+            ],
+        };
+    });
+}
+function buildTaskMarkdown(taskTexts) {
+    const normalizedTasks = normalizeTaskTexts(taskTexts);
+    return normalizedTasks.map((task) => `- [ ] ${task}`).join('\n');
+}
+function assertTiptapDoc(value) {
+    if (!value || typeof value !== 'object') {
+        throw new DinoxError('Invalid note content_json: expected object');
+    }
+    const doc = value;
+    if (doc.type !== 'doc') {
+        throw new DinoxError('Invalid note content_json: root.type must be "doc"');
+    }
+    if (!Array.isArray(doc.content)) {
+        throw new DinoxError('Invalid note content_json: root.content must be an array');
+    }
+    return doc;
+}
+function ensureDocContentArray(doc) {
+    const content = doc.content;
+    if (Array.isArray(content)) {
+        return content;
+    }
+    doc.content = [];
+    return doc.content;
+}
+function ensureNodeContentArray(node) {
+    const content = node.content;
+    if (Array.isArray(content)) {
+        return content;
+    }
+    node.content = [];
+    return node.content;
+}
+function isTaskListNode(node) {
+    return Boolean(node && typeof node === 'object' && node.type === 'taskList');
+}
+function ensureNodeAttrs(node) {
+    if (!isObject(node.attrs)) {
+        node.attrs = {};
+    }
+    return node.attrs;
+}
+function resolveTaskId(node) {
+    const nodeId = normalizeString(node.id);
+    if (nodeId) {
+        return nodeId;
+    }
+    const attrs = isObject(node.attrs) ? node.attrs : null;
+    const attrsId = normalizeString(attrs?.id);
+    return attrsId;
+}
+function normalizeTaskItemNode(node) {
+    const attrsSource = isObject(node.attrs) ? node.attrs : {};
+    const nodeId = normalizeString(node.id);
+    const attrsId = normalizeString(attrsSource.id);
+    const taskId = nodeId || attrsId || generateId();
+    const checked = normalizeChecked(node.checked) ?? normalizeChecked(attrsSource.checked) ?? false;
+    return {
+        type: 'taskItem',
+        id: taskId,
+        checked,
+        attrs: {
+            ...attrsSource,
+            id: taskId,
+            checked,
+        },
+        content: Array.isArray(node.content) ? cloneJson(node.content) : [],
+    };
+}
+function normalizeChecked(value) {
+    if (value === true)
+        return true;
+    if (value === false)
+        return false;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return undefined;
+}
+function normalizeString(value) {
+    if (typeof value !== 'string') {
+        return '';
+    }
+    return value.trim();
+}
+function truncateChars(value, limit) {
+    const chars = Array.from(value);
+    if (chars.length <= limit) {
+        return value;
+    }
+    return chars.slice(0, limit).join('');
+}
+function isObject(value) {
+    return Boolean(value && typeof value === 'object');
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function patchChecklistLine(line, checked) {
+    return line.replace(TASK_MARKDOWN_LINE_RE, (_, prefix, suffix) => {
+        return `${prefix}${checked ? 'x' : ' '}${suffix}`;
+    });
+}
+const TASK_MARKDOWN_LINE_RE = /^(\s*[-*+]\s+\[)[ xX](\].*)$/;

package/dist/commands/todo/index.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerTodoCommands(program: Command): void;