滴答清单任务面板PerryLink/dsh-ticktick

dsh-ticktick

License
Node
DSH plugin
dsh-doctor
Gitee
CI
Version
npm version
npm downloads

面向 DeepSeek Harness 的 TickTick / Dida365（滴答清单）任务桥接：一个 Session 头部任务面板（列表筛选、快速添加、完成、删除、截止日期、拖拽排序）、十一个精选的 agent 工具、一张插件设置卡片，以及一个类型化的 Remote 服务——全部基于官方 TickTick MCP 端点。

兼容性

| 界面 | 状态 |
|---|---|
| Harness | DeepSeek Harness dsh-v0.1.5-rc.2（GitHub tag）。npm 依赖线：@deepseek-ai/dsh 0.1.5-rc.2（peers >=0.1.2-rc.1 =0.1.5-alpha.1 =24.0.0 |

功能

- Session 头部面板——Session 头部中的 ticktick 操作会打开一个弹窗：按列表筛选（All + 每个列表）、切换未完成/已完成视图、全文搜索、添加任务并可选择截止日期、完成、删除（带确认）、通过逾期/今天/明天快捷选项设置/清除截止日期，以及拖拽排序（未完成、单列表视图）。状态圆点显示连接状态；未配置 token 时，面板会提供一步式的面板内 token 设置。
- 十一个 agent 工具——ticktick_status、ticktick_lists、ticktick_tasks、ticktick_add、ticktick_complete、ticktick_delete、ticktick_due、ticktick_reorder、ticktick_completed、ticktick_search、ticktick_batch_add；Code Mode 可免费获得 await tools.ticktick_(args)。
- 设置卡片——Settings → Plugins → TickTick：API token（secret）、token 文件、带 CN/International 预设的 MCP 端点、受保护的任务 id、一个 Test-connection 按钮，以及一个 Clear-credentials 按钮。
- 实时令牌重读 — 每个请求都会重新读取 Bearer 令牌（卡片密钥 > 令牌文件，默认 $DSH_HOME/.ticktick-token）；401 会重置客户端，因此轮换后的令牌无需重启即可生效。
- 经过实测的变通方案 — TickTick MCP 服务器会拒绝针对常规项目内任务的 update_task（“Expecting value: line 1 column 1”）；桥接层会通过“移到收件箱 → 更新 → 移回”的迂回方式重试。服务器端校验失败的列表（历史 repeatFrom: '' 数据）会被跳过并报告为警告，绝不会被静默丢弃。
- 受保护的 id — 变更操作会在任何网络调用之前拒绝受保护 id 列表中的任务。
- 多设备同步 — 每次写入都会落到 TickTick 云账户，因此手机/桌面/网页应用都能看到；每次读取都会获取当前状态。

安装

npm（已发布的产物包含 lib/，无需构建权限）
dsh plugin --profile web add @perrylink/dsh-ticktick

git 源（固定一个提交；pnpm 会要求你允许一次 prepare 构建）
dsh plugin --profile web add "github:PerryLink/dsh-ticktick#"

本地开发
dsh plugin --profile web add link:/path/to/dsh-ticktick

重启 dsh web（打包插件在重启时激活）。ticktick 操作会出现在会话标题栏中；卡片会出现在设置 → 插件下。

配置

1. 从滴答清单/TickTick 网页应用获取 API 口令（一个以 dp_ 为前缀的令牌）：个人资料 → 设置 → 账户与安全 → API 口令。
2. 从三个令牌来源中选择一个（优先级顺序）：设置 → 插件 → TickTick 卡片的密钥字段、DIDA365_TOKEN 环境变量，或令牌文件（默认 $DSH_HOME/.ticktick-token，一行）。写入该文件即可激活桥接层，无需任何配置更改。
3. 使用卡片上的 Test connection 按钮验证令牌，使用 Clear credentials 将其清除。

| 键 | 默认值 | 含义 |
|---|---|---|
| tokenFile | '' | 存放令牌的文本文件路径；为空时解析为 $DSH_HOME/.ticktick-token |
| mcpUrl | https://mcp.dida365.com | TickTick MCP 端点（国际端点未经证实——见下文） |
| toolCallTimeoutMs | 30000 | 每次 tools/call 的超时时间（毫秒） |
| protectedTaskIds | [] | 每个变更操作都会拒绝的任务 id |
| tools. | 各自为 '' | 原始 MCP 工具名固定值（projects/tasks/create/complete/remove/update/move）；'' = 按模式发现 |

代理工具

| 工具 | 用途 |
|---|---|
| ticktick_status | 连接状态：令牌已配置、客户端已连接、端点、上次错误 |
| ticktick_lists | 每个列表（项目），包括虚拟收件箱 |
| ticktick_tasks | 未完成任务：单个列表或全部聚合，并附带每个列表的警告 |
| ticktick_add | 创建任务（列表、可选的 ISO 截止日期） |
| ticktick_complete | 完成任务（任务 id + 列表 id） |
| ticktick_delete | 删除任务（任务 id + 列表 id） |
| ticktick_due | 设置/清除截止日期（省略日期即清除） |
| ticktick_reorder | 分配一个新的整数 sortOrder（列表按 sortOrder 降序排列） |
| ticktick_completed | 在某个时间窗口内完成的任务（默认 30 天），可选指定一个列表 |
| ticktick_search | 对任务进行全文搜索（官方搜索工具） |
| ticktick_batch_add | 在一次调用中创建多个任务 |

架构

browser panel ── ctx.remote.ticktick.* ──▶ TicktickService (Typert Remote)
settings card ── ctx.settingsScope ──────▶ settings namespace "ticktick"
agent tools ─── ctx.tools (ticktick_*) ──▶ the same service
│
▼
minimal streamable-HTTP MCP client
(session id, protocol version, Retry-After)
│
▼
https://mcp.dida365.com  (official TickTick MCP)

已知限制

- 国际版 TickTick 端点尚未验证：mcpUrl 默认指向中国版端点，国际版 MCP URL 尚未探测。
- 已完成视图、搜索和批量添加依赖 MCP 工具 list_completed_tasks_by_date、search 和 batch_add_tasks；它们的通信协议来自已发布的目录（dida365-sdk 存根），针对实时端点的重新验证仍待进行——在声称它们已验证之前，请使用真实 token 运行 probes/probe-queries.mjs。
- 已测得的 update_task 崩溃和列表验证失败属于服务端行为；probes/ 会在发布前针对实时端点重新验证它们（运行时需导出 DIDA365_TOKEN）。
- 面板使用的 /api 接口是标准 harness Typert 网关；token 存储在本地（设置文档或 token 文件），且仅发送至 TickTick 自己的服务器。请勿将 dsh web 实例暴露到公共互联网。

针对实时端点验证桥接

PowerShell
$env:DIDA365_TOKEN='dp_...'
node probes/probe-bootstrap.mjs      # handshake + tool catalogue
node probes/probe-crud.mjs           # create/complete/delete round trip
node probes/probe-due.mjs            # due dates (+ detour with a PROJECT_ID)
node probes/probe-reorder.mjs        # sortOrder semantics
node probes/probe-queries.mjs        # P2 query-tool contract discovery

卸载

dsh plugin --profile web remove @perrylink/dsh-ticktick

重启 dsh web。所有运行时注册项（工具、面板、设置卡片、提示词片段）都会随插件一并移除。唯一的静态残留是用户设置文档中的 token——请先用卡片上的 Clear credentials 按钮清除它（或删除 token 文件 / DIDA365_TOKEN 变量）以完全解除关联。若想保留已安装的包但使其处于非活动状态，请改为禁用该行：

- id: ticktick
disabled: true

从 DSH Desktop Market 安装
所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍需经过 Market 的 npm 身份验证以及你的确认。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也一样：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败即关闭 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息传递和中断功能 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排和延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 等同于 Claude Code 的 /rewind：快照、会话分叉、一键恢复 | |
| dsh-claude-move | 将 Claude Code 的会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——以 Windows 优先。 | |
| dsh-composer-history | Web 输入框的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查和引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 通过语言服务器实现 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界处匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置标签页，展示状态、工具和错误 | |
| dsh-memento | 需审批的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 与 Claude Code outputStyles 等价的运行时样式切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 以按需智能体技能形式提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本和密封版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖项和供应链审查 | |
| dsh-talk | 面向 DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试驱动。 | |
| dsh-translate | 面向 DeepSeek Harness 的供应商参数转换和确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，聊天内审批 |
| dsh-autotier | 自动强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，暴露认证注册表：等级、快照和五维证据 | |
| dsh-kit | 一键安装核心系列入门包 | |
| dsh-plugin-certification | 社区认证注册表，带可复现检查的等级和徽章 | |
| dsh-plugin-kit | PerryLink DSH 插件共享的零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为单页 | |
| dsh-plugin-upgrade-015 | 合并的 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件均可在内置 DSH Desktop Market 中浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选择它。安装仍需经过 Market 的 npm 身份验证和你的确认。

许可证

Apache-2.0