TomiLite 任务桥 xxwj225-James/tomilite-dsh-plugin

面向 DeepSeek Harness 的 TomiLite —— 给你的智能体持久记忆与任务

DeepSeek Harness 插件，让你的 DSH 智能体访问本地 TomiLite —— 任务、笔记和项目统计。

智能体在 TomiLite 里创建任务，任务立刻出现在你的 Tasks 面板。你的 DSH 智能体负责动手，TomiLite 始终是工作区。

🚀 获取 TomiLite

本插件需要 TomiLite 桌面应用 在同一台机器上运行。

Windows 一行命令（TomiLite 已在运行就跳过安装，否则下载 + 安装 + 启动）：

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/xxwj225-James/tomilite-dsh-plugin/main/scripts/install-tomilite.ps1 | iex"

也可以手动下载安装包：TomiLite Releases

TomiLite 没在运行，工具会报错并给出可操作的提示（附下载链接）—— 智能体会转告你。

前置条件

- 已安装 DeepSeek Harness（npx @deepseek-ai/dsh web，或从源码构建）
- TomiLite 桌面应用正在运行 —— 插件访问它的本地 API http://localhost:3192（localhost 调用免 token，无需 API key）
- Node.js 22.19+（与 DSH 要求一致）

安装

npm (recommended once published)
dsh plugin --profile web add tomilite-dsh-plugin

git (installs from this repository)
dsh plugin --profile web add github:xxwj225-James/tomilite-dsh-plugin

local checkout
dsh plugin --profile web add ./tomilite-dsh-plugin

安装后重启 DSH web UI（或 dsh 命令行）。

配置

本地 TomiLite 应用用默认值即可开箱使用。在配置档的 cordis.patch.yml 里覆盖：

- id: tomilite
name: tomilite-dsh-plugin
config:
baseUrl: http://localhost:3192 # default
apiToken: '' # only for remote instances (Settings → API Keys)
projectId: proj-default # default single-user project

apiToken 也可以从环境变量 TOMILITE_API_TOKEN 读取。远程实例请优先用 HTTPS —— 否则 token 会以明文 HTTP 传输。

工具

| 工具 | 说明 |
| tomilite_list_tasks | 列出任务，可选 status 过滤（todo / in_progress / done）。返回精简行（描述截断到 300 字符） |
| tomilite_create_task | 创建任务（标题、描述、类型、优先级、故事点） |
| tomilite_update_task | 更新状态 / 优先级 / 描述 |
| tomilite_list_notes | 列出知识库笔记，可选分类过滤。返回精简行（内容预览截断到 500 字符） |
| tomilite_create_note | 创建 Markdown 笔记 |
| tomilite_get_stats | 看板统计 —— 按状态 / 优先级 / 类型计数 —— 写日报前很好用 |
TomiLite 没在运行时，工具会报错并给出可操作的提示（智能体会让你先启动 TomiLite）。每次 HTTP 调用都带 15 秒超时，所以 TomiLite 卡住也不会拖住智能体的一轮对话。

工作原理

这个插件是宿主侧的 Cordis 插件，使用与 TomiLite 自带 Web 前端（apps/web/src/lib/api.ts）相同的 tRPC 线格式：

- 读取：GET /api/<router>.<procedure>?input=<urlencoded JSON>
- 变更：POST /api/<router>.<procedure>，请求体为 JSON
- 响应：tRPC 信封 { result: { data: ... } }
- 认证：x-tl-token 请求头，只有非 localhost 实例才需要

插件注册的工具（ctx.tools.register + 来自 @deepseek-ai/dsh-tools 的 defineTool）就是普通的、模型可见的工具——schema 在 execute 运行前强制校验，结果渲染为紧凑的 JSON 块。

语言

工具描述和结果消息都是英文。DSH 的 locale 服务只在浏览器侧，所以宿主侧的工具插件（包括每个官方 DSH 工具包）都提供静态英文文案；等 DSH 暴露宿主侧 locale 后可以再加翻译。

开发

npm install
npm run build # tsc → lib/
npm test # smoke + real-Cordis load tests (no network)
npm run test:integration # round-trips against a RUNNING TomiLite on :3192

- test/smoke.mjs —— 用 mock 上下文检查注册和模型可见面（不走网络）
- test/cordis-load.mjs —— 启动真实的 @deepseek-ai/cordis 上下文，通过 ctx.plugin() 加载插件，验证 inject 解析、工具注册，以及 Config schema 对非法配置的拒绝（不走网络）
- test/integration.mjs —— 对运行中的 TomiLite 做实时往返；自己创建、自己删除数据行，不碰用户数据

lib/ 已提交到仓库，所以 git 安装无需构建步骤；CI 会重新构建它以保证新鲜度（提交前先跑 npm run build）。

说明

- DeepSeek Harness 处于开发者预览阶段（rc 版本），不同版本之间可能破坏插件 API；本插件锁定 dsh-tools@0.1.0-rc.7。
- GitHub topic：dsh-plugin（用于发现插件生态）

许可证

MIT © 2026 Tomatovector