笔记与 Issue

笔记和 Issue 是 Cocurdex 中的一等产品记录。它们存放在应用私有存储(cocurdex.sqlite)中，而不是在仓库里隐式双写一棵 Markdown 树。

为什么应用私有

Markdown 之后仍可用于显式导入导出。在此之前，请把 CLI 和桌面 UI 当作唯一受支持的写入方。

笔记

笔记支持：

• 层级文件夹与笔记页（含新建子页面）
• 与正文分开的笔记标题字段
• 以块编辑的 Markdown 正文
• 标签
• 笔记之间的反向链接
• 可选关联到某个工作区

笔记侧栏按个人笔记和各工作区分组。拖动笔记，或用移动到，可以改它的父级。双击标题，或选择重命名，即可就地改名——演示文稿列表用的是同一套操作。

桌面编辑器

标题在正文上方。在标题里按 Enter 或 Down 会把光标移进正文。

正文占位是 开始写作，或按 “/” 插入块…。/ 打开插入块：

表格边缘有点击/拖动手柄（点击添加，拖动可添加多个）。行、列菜单覆盖插入、删除、复制、清空内容、对齐（左对齐 / 居中 / 右对齐）、升序排列 / 降序排列，以及删除表格。如果笔记的最后一块是表格，点击它下方的空白会插入一个空行，方便继续写。

保存状态显示为 保存中… / 已保存。保持稳定的笔记标题和链接，这样 Agent 和人之后能找到同一条记录。

在 PDF 阅读器里看文档时，选中文字并选择加入笔记，即可把它摘录进笔记。

CLI

cocurdex note list
cocurdex note create --title "Architecture notes" --body "## Context\n..."
cocurdex note show <id>
cocurdex note update <id> --body "..."
cocurdex note move <id> --parent <note-id>
cocurdex note move <id> --root
cocurdex note backlinks <id>
cocurdex note tags
cocurdex note delete <id>

--body - 从 stdin 读 Markdown；--body-file <path> 从文件读。

创建文件夹：

cocurdex note create --title "PRDs" --folder

Issue

Issue 是产品中的 todo / ticket / 看板卡片模型。叫法不同，存储是同一个池：

默认看板列（状态）

默认优先级

视图

内置视图 id 是 project。Issue 侧栏列出视图，以及快捷入口：进行中、全部 Issue、Backlog 和 Agent 在做。视图可以按状态或优先级分组，布局可以是看板或列表。拖动卡片（和列）会更新被分组的字段。视图显示只作用于该视图。用添加视图再建视图；删除视图不会删除 Issue。

打开一条 Issue 可编辑标题、描述、标签、父 issue / 子 issue、关联（阻塞 / 相关 / 重复）、已链接的 Agent 会话、评论，以及动态记录。筛选可以隐藏已完成和已取消的卡片，或按工作区和标签收窄。

列表视图以及创建/移动操作都经由 daemon（桌面 UI 或 CLI）——不要手工编造 issue id。

cocurdex issue views
cocurdex issue list
cocurdex issue list --status doing [--label <name>] [--parent <id>] [--open]
cocurdex issue create --title "Wire download artifacts" --status backlog --priority high [--labels <ids>] [--parent <id>]
cocurdex issue update <id> [--title <title>] [--body <text>] [--status <column>] [--priority <id>]
cocurdex issue move <id> doing
cocurdex issue show <id> [--detail]
cocurdex issue comment <id> --body "Shipped on main"
cocurdex issue relate <id> blocks|related|duplicate <id>
cocurdex issue unrelate <id> blocks|related|duplicate <id>
cocurdex issue labels
cocurdex issue label create --name "release" [--color <color>]
cocurdex issue label delete <id|name>
cocurdex issue delete <id>

搜索

cocurdex search "download"
cocurdex search "auth" --kind note
cocurdex search "release" --kind issue --workspace <workspace-id>

与 Agent 协作

直接在输入框里把 Issue 或笔记交给 Agent:+ → Issue 或 + → 笔记 会把它作为标签附加上去，Agent 在提示词里就能拿到完整的标题和正文。在对话记录里点击该标签即可打开对应记录。

产品 Skills(/cocurdex-note、/cocurdex-issue 等)调用同一套 CLI,因此 Agent 不需要打开 SQLite。见 Skills。

产品工作的推荐循环：

/cocurdex-note(PRD 或 spec)  →  /cocurdex-issue  →  /cocurdex-ship

PRD 和 spec 就是普通笔记，默认存为私有笔记。要发布到仓库中需要明确的用户请求——绝不要认为「打开工作区」就等于「把产品文档写进仓库」。

不要做的事

• 不要把项目下的路径当作 Issue 身份
• 不要手工编辑 cocurdex.sqlite
• 不要在脚本里编造 issue 或 note id——通过 CLI 创建并保存返回的 id
• 除非你自己负责一条显式的导出流程，否则不要「保险起见」双写 Markdown 副本

相关

• 演示文稿
• 工作区与数据
• CLI
• Skills