DeepSeek Harness 插件

tomilite-dsh-plugin

DeepSeek Harness plugin: give your DSH agent access to your local TomiLite tasks, notes, and project stats(英文原文)

跳到安装方式

来源信息

GitHub 仓库
xxwj225-James/tomilite-dsh-plugin
最近更新
2026年8月20日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-21

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/xxwj225-James/tomilite-dsh-plugin
插件名:tomilite-dsh-plugin
作者:xxwj225-James

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

tomilite-dsh-plugin

A DeepSeek Harness plugin that gives your DSH agent access to your local TomiLite — tasks, notes, and project stats.

The agent creates a task in TomiLite and it shows up in your Tasks panel instantly. Your DSH agent becomes the hands, TomiLite stays the workspace.

🚀 Get TomiLite

This plugin needs the TomiLite desktop app running on the same machine.

Windows one-liner (skips install if TomiLite is already running, otherwise downloads + installs + starts it):

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

Or download the installer manually: TomiLite Releases

If TomiLite is not running, the tools fail with an actionable message (with the download link) — the agent will relay it to you.

Prerequisites

  • DeepSeek Harness installed (npx @deepseek-ai/dsh web, or built from source)
  • TomiLite desktop app running — the plugin talks to its local API at http://localhost:3192 (localhost calls are token-exempt; no API key needed)
  • Node.js 22.19+ (matches DSH requirements)

Install

# 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

Restart the DSH web UI (or dsh CLI) after installing.

Configuration

Defaults work out of the box for the local TomiLite app. Override in your profile's 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 can also come from the TOMILITE_API_TOKEN environment variable. For remote instances prefer HTTPS — the token travels in plain HTTP otherwise.

Tools

ToolDescription
tomilite_list_tasksList tasks, optional status filter (todo / in_progress / done). Returns compact rows (description truncated to 300 chars)
tomilite_create_taskCreate a task (title, description, type, priority, story points)
tomilite_update_taskUpdate status / priority / description
tomilite_list_notesList knowledge-base notes, optional category filter. Returns compact rows (content preview truncated to 500 chars)
tomilite_create_noteCreate a Markdown note
tomilite_get_statsBoard statistics — counts per status / priority / type — handy before writing daily reports

If TomiLite is not running, tools fail with an actionable message (the agent will tell you to start TomiLite). Every HTTP call carries a 15-second timeout so a hung TomiLite never stalls an agent turn.

How it works

The plugin is a host-side Cordis plugin that speaks the same tRPC wire format as TomiLite's own web frontend (apps/web/src/lib/api.ts):

  • Reads: GET /api/<router>.<procedure>?input=<urlencoded JSON>
  • Mutations: POST /api/<router>.<procedure> with a JSON body
  • Responses: tRPC envelope { result: { data: ... } }
  • Auth: x-tl-token header, only needed for non-localhost instances

The tools registered by this plugin (ctx.tools.register + defineTool from @deepseek-ai/dsh-tools) become regular model-visible tools — schemas are enforced before execute runs, results are rendered as compact JSON blocks.

Language

Tool descriptions and result messages are in English. DSH's locale service is browser-side only, so host-side tool plugins (including every official DSH tool package) ship static English copy; translations can be added once DSH exposes a host-side locale.

Development

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 — registration + model-surface checks with a mock context (no network)
  • test/cordis-load.mjs — boots a real @deepseek-ai/cordis context, loads the plugin through ctx.plugin(), verifies inject resolution, tool registration, and Config-schema rejection of invalid config (no network)
  • test/integration.mjs — live round-trips against a running TomiLite; creates and deletes its own rows, no user data touched

lib/ is committed so git installs work without a build step; CI rebuilds it to guarantee freshness (npm run build before committing).

Notes

  • DeepSeek Harness is in developer preview (rc releases) and may break plugin APIs between releases; this plugin is pinned to dsh-tools@0.1.0-rc.7.
  • GitHub topic: dsh-plugin (for plugin ecosystem discovery)

License

[MIT](LICENSE) © 2026 Tomatovector