/project

name: project
description: 用于在思源任务笔记管理插件中管理项目看板及文件夹分组的 MCP 工具。

项目与看板管理技能 (project)

本技能提供思源任务笔记管理插件的项目管理接口，支持搜索/列出项目、创建/更新项目、获取项目详情，以及管理项目看板列分组和分类文件夹。

支持操作与参数

1. `search_project`

搜索或列出项目。不传任何参数时返回所有项目。

• **keyword** (字符串, 可选): 关键词，同时匹配项目名称和文件夹名称。文件夹名称命中时，返回该文件夹下的所有项目。
• **folderId** (字符串, 可选): 仅获取指定项目文件夹下的项目。

2. `create_project`

创建新项目。

• **name** (字符串, 必填): 项目名称。
• **status** (字符串, 可选): 项目状态 (例如 `"active"` 激活, `"someday"` 也许, `"archived"` 归档)。
• **color** (字符串, 可选): 十六进制项目颜色 (如 `"#4f46e5"`)。
• **priority** (字符串, 可选): 优先级 (`"high"`, `"medium"`, `"low"`, `"none"`)。
• **folderId** (字符串, 可选): 归属项目文件夹 ID。
• **categoryId** (字符串, 可选): 分类 ID。
• **startDate** (字符串, 可选): 开始日期 `YYYY-MM-DD`。
• **blockId** (字符串, 可选): 绑定的思源块或文档 ID，自动保存项目绑定并同步块属性 `custom-task-projectId`。

3. `update_project`

更新已有项目的信息，只传需要修改的字段。

• **projectId** (字符串, 必填): 项目 ID。
• **name** (字符串, 可选): 项目名称。
• **status** (字符串, 可选): 项目状态。
• **color** (字符串, 可选): 十六进制项目颜色。
• **priority** (字符串, 可选): 优先级 (`"high"`, `"medium"`, `"low"`, `"none"`)。
• **folderId** (字符串, 可选): 归属项目文件夹 ID，传空字符串 `""` 可解除归属。
• **categoryId** (字符串, 可选): 分类 ID。
• **startDate** (字符串, 可选): 开始日期 `YYYY-MM-DD`。
• **blockId** (字符串, 可选): 绑定的思源块或文档 ID。不传保留原绑定，传新 ID 自动换绑，传空字符串 `""` 解除绑定；换绑和解绑仅移除此项目的块属性关联，保留同块的其他项目。

4. `get_project`

获取项目详情及统计信息（如任务总数及未完成数）。

• **projectId** (字符串, 必填): 项目 ID。

5. `list_columns`

列出项目看板自定义的列分组。

• **projectId** (字符串, 必填): 项目 ID。

6. `create_column`

为项目看板创建一列分组。

• **projectId** (字符串, 必填): 项目 ID。
• **name** (字符串, 必填): 分组名称。
• **color** (字符串, 可选): 分组标识颜色。
• **icon** (字符串, 可选): 分组图标。
• **sort** (数字, 可选): 排序权重。

7. `update_column`

修改自定义列分组。

• **projectId** (字符串, 必填): 项目 ID。
• **columnId** (字符串, 必填): 看板分组 ID。
• **name** (字符串, 可选): 看板列名。
• **color** (字符串, 可选): 列颜色。
• **icon** (字符串, 可选): 图标。
• **sort** (数字, 可选): 排序权重。

8. `list_folders`

列出所有分类文件夹。

• （无参数）

9. `create_folder`

创建项目分类文件夹。

• **name** (字符串, 必填): 文件夹名称。
• **icon** (字符串, 可选): 文件夹图标。
• **parentId** (字符串, 可选): 父文件夹 ID。

10. `update_folder`

更新项目分类文件夹信息。

• **folderId** (字符串, 必填): 文件夹 ID。
• **name** (字符串, 可选): 文件夹名称。
• **icon** (字符串, 可选): 图标。
• **parentId** (字符串, 可选): 父文件夹 ID。

11. `delete_folder`

删除分类文件夹并解除其下所有项目的关联。

• **folderId** (字符串, 必填): 文件夹 ID。

调用示例

列出所有项目

{
  "action": "search_project"
}

按关键词搜索项目（命中文件夹名时返回该文件夹下所有项目）

{
  "action": "search_project",
  "keyword": "工作"
}

创建一个项目归类文件夹

{
  "action": "create_folder",
  "name": "工作相关",
  "icon": "💼"
}

创建项目并绑定文档

{
  "action": "create_project",
  "name": "论文修改",
  "blockId": "20261009120000-abcdefg"
}

解除项目的块绑定

{
  "action": "update_project",
  "projectId": "project_...",
  "blockId": ""
}