show
Navigate to and display areas, projects, tags, todos, or built-in lists like inbox, today, and upcoming in your Things 3 task management system.
Instructions
导航到并显示区域、项目、标签、待办事项或内置列表。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ID或内置列表名(inbox, today, anytime, upcoming, someday, logbook等) | |
| query | No | 查询名称（如果未提供id） | |
| filter | No | 按标签筛选，逗号分隔 |
Implementation Reference
- src/index.js:541-553 (handler)The main handler function for the 'show' tool. It constructs a Things URL scheme for 'show' command using the provided arguments and opens it via openThingsUrl method.async handleShow(args) { const url = buildThingsUrl('show', args); await this.openThingsUrl(url); return { content: [ { type: 'text', text: `✅ 导航命令已发送${args.id ? ` (${args.id})` : args.query ? ` (${args.query})` : ''}`, }, ], }; }
- src/index.js:318-339 (schema)The schema and metadata definition for the 'show' tool, used in the ListTools response.{ name: 'show', description: '导航到并显示区域、项目、标签、待办事项或内置列表。', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'ID或内置列表名(inbox, today, anytime, upcoming, someday, logbook等)', }, query: { type: 'string', description: '查询名称（如果未提供id）', }, filter: { type: 'string', description: '按标签筛选，逗号分隔', }, }, }, }, {
- src/index.js:439-440 (registration)Registration of the 'show' tool handler in the CallToolRequest switch statement.case 'show': return await this.handleShow(args);
- src/utils.js:84-93 (helper)Helper function used by the handler to build the Things URL scheme for the 'show' command.export function buildThingsUrl(command, params = {}) { const baseUrl = `things:///${command}`; const queryString = buildQueryString(params); if (!queryString) { return baseUrl; } return `${baseUrl}?${queryString}`; }