@dinoxx/dinox-cli 1.0.11 → 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/index.js

@@ -61,6 +61,26 @@ async function parseStringListInput(value, optionName) {
     const raw = await readStringOrFile(value);
     return parseListInput(raw, optionName);
 }
+async function parseSearchListInput(value, optionName) {
+    const raw = await readStringOrFile(value);
+    return {
+        values: parseListInput(raw, optionName),
+        isExplicitEmptyArray: isExplicitEmptyArrayLiteral(raw),
+    };
+}
+function isExplicitEmptyArrayLiteral(value) {
+    const normalized = value.trim();
+    if (!normalized.startsWith('[')) {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse(normalized);
+        return Array.isArray(parsed) && parsed.length === 0;
+    }
+    catch {
+        return false;
+    }
+}
 async function parseTargetNoteIds(idArg, idsOption, commandName) {
     const merged = [];
     const idFromArg = typeof idArg === 'string' ? idArg.trim() : '';
@@ -91,11 +111,11 @@ export function registerNoteCommands(program) {
         .command('search')
         .description('Search notes and return note list for AI agents')
         .argument('[query]', 'search query')
-        .option('--tags <expr>', 'tag expression with AND/OR/NOT, e.g. \'(work OR life) AND NOT archived\'')
+        .option('--tags <expr>', 'tag expression with AND/OR/NOT, or [] for empty tags')
         .option('--from <date>', 'created_at start (YYYY-MM-DD or ISO datetime)')
         .option('--to <date>', 'created_at end (YYYY-MM-DD or ISO datetime)')
         .option('--days <n>', 'recent N days by created_at (cannot be used with --from/--to)')
-        .option('--box <string|@file>', 'zettel box names (JSON array or comma/newline-separated)')
+        .option('--box <string|@file>', 'zettel box names (JSON array/comma list), or [] for empty boxes')
         .option('--sql <expr>', 'SQL-like expression over id/content_md/summary/tags/zettel_boxes/created_at/type')
         .option('--include-deleted', 'include soft-deleted notes')
         .action(async (query, options, command) => {
@@ -114,8 +134,10 @@ export function registerNoteCommands(program) {
                 days: options.days,
             });
             const boxInput = typeof options.box === 'string' ? options.box : '';
-            const zettelBoxNames = boxInput ? await parseStringListInput(boxInput, '--box') : [];
-            const zettelBoxIds = await resolveZettelBoxIdsForSearch(db, zettelBoxNames);
+            const parsedBoxInput = boxInput
+                ? await parseSearchListInput(boxInput, '--box')
+                : { values: [], isExplicitEmptyArray: false };
+            const zettelBoxIds = await resolveZettelBoxIdsForSearch(db, parsedBoxInput.values);
             const sqlExpression = typeof options.sql === 'string' ? options.sql.trim() : '';
             const rows = await searchNotes(db, keyword, {
                 includeDeleted: Boolean(options.includeDeleted),
@@ -123,6 +145,7 @@ export function registerNoteCommands(program) {
                 createdAtFrom,
                 createdAtTo,
                 zettelBoxIds,
+                matchEmptyZettelBoxes: parsedBoxInput.isExplicitEmptyArray,
                 sqlExpression: sqlExpression || undefined,
             });
             printYaml(rows);

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

@@ -19,6 +19,7 @@ type SearchNotesOptions = {
     createdAtFrom?: string;
     createdAtTo?: string;
     zettelBoxIds?: string[];
+    matchEmptyZettelBoxes?: boolean;
     sqlExpression?: string;
 };
 export type SearchedNote = {
@@ -60,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

@@ -9,7 +9,7 @@ export async function searchNotes(db, query, options) {
     const normalizedQuery = query.trim();
     const tagFilter = buildTagFilter(options.tagsExpression, 'n');
     const createdAtFilter = buildCreatedAtFilter(options.createdAtFrom, options.createdAtTo, 'n');
-    const zettelBoxFilter = buildZettelBoxFilter(options.zettelBoxIds, 'n');
+    const zettelBoxFilter = buildZettelBoxFilter(options.zettelBoxIds, options.matchEmptyZettelBoxes, 'n');
     const sqlFilter = await buildNoteSearchSqlFilter({
         expression: options.sqlExpression,
         noteAlias: 'n',
@@ -211,6 +211,12 @@ function buildTagFilter(tagsExpression, noteAlias) {
     if (!expression) {
         return null;
     }
+    if (isExplicitEmptyArrayLiteral(expression)) {
+        return {
+            sql: `NOT (${buildJsonArrayHasValuesSql(noteAlias, 'tags', 'tag_item')})`,
+            params: [],
+        };
+    }
     let ast;
     try {
         ast = parseTagExpression(expression);
@@ -242,16 +248,19 @@ function buildCreatedAtFilter(createdAtFrom, createdAtTo, noteAlias) {
         params,
     };
 }
-function buildZettelBoxFilter(zettelBoxIds, noteAlias) {
+function buildZettelBoxFilter(zettelBoxIds, matchEmptyZettelBoxes, noteAlias) {
     const normalizedIds = Array.from(new Set((zettelBoxIds ?? [])
         .map((id) => id.trim())
         .filter((id) => id.length > 0)));
-    if (normalizedIds.length === 0) {
+    const shouldMatchEmpty = Boolean(matchEmptyZettelBoxes);
+    if (normalizedIds.length === 0 && !shouldMatchEmpty) {
         return null;
     }
-    const placeholders = normalizedIds.map(() => '?').join(', ');
-    return {
-        sql: `
+    const clauses = [];
+    const params = [];
+    if (normalizedIds.length > 0) {
+        const placeholders = normalizedIds.map(() => '?').join(', ');
+        clauses.push(`
       EXISTS (
         SELECT 1
         FROM json_each(
@@ -262,8 +271,18 @@ function buildZettelBoxFilter(zettelBoxIds, noteAlias) {
         ) box_item
         WHERE TRIM(CAST(box_item.value AS TEXT)) IN (${placeholders})
       )
-    `,
-        params: normalizedIds,
+      `);
+        params.push(...normalizedIds);
+    }
+    if (shouldMatchEmpty) {
+        clauses.push(`NOT (${buildJsonArrayHasValuesSql(noteAlias, 'zettel_boxes', 'box_item')})`);
+    }
+    if (clauses.length === 1) {
+        return { sql: clauses[0], params };
+    }
+    return {
+        sql: `(${clauses.join(' OR ')})`,
+        params,
     };
 }
 function parseTagExpression(expression) {
@@ -434,6 +453,32 @@ function compileTagExpression(node, noteAlias, params) {
 function normalizeTagValue(value) {
     return value.trim().toLowerCase();
 }
+function isExplicitEmptyArrayLiteral(value) {
+    if (!value.startsWith('[')) {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) && parsed.length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function buildJsonArrayHasValuesSql(noteAlias, field, itemAlias) {
+    return `
+      EXISTS (
+        SELECT 1
+        FROM json_each(
+          CASE
+            WHEN json_valid(COALESCE(${noteAlias}.${field}, '')) THEN ${noteAlias}.${field}
+            ELSE '[]'
+          END
+        ) ${itemAlias}
+        WHERE LENGTH(TRIM(CAST(${itemAlias}.value AS TEXT))) > 0
+      )
+    `;
+}
 export async function getNote(db, id) {
     return db.getOptional(`
     SELECT
@@ -526,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() ?? '')
@@ -583,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 {};