Introduction

In DeepSeek Harness (DSH) sessions, model requests, tool executions, and turn endings typically appear as events. For a single event, the chat stream can be viewed; for multiple agents, sub-sessions, or consecutive tool calls, a more intuitive way is needed to verify current status, planned tasks, and the most recent public tool events.

Below is an introduction to the DSH plugin lhwu1/dsh-lookseek. It displays real agent status, planned tasks, recent tool events, and an interactive 3D office area in the “Workspace” tab of the DSH session. It is not a second chat window and does not guess the model’s internal reasoning; the robot only moves and displays status based on Harness session state and trusted activity events.

What is it

lhwu1/dsh-lookseek is a visual workspace plugin for DeepSeek Harness. The repository path is:

lhwu1/dsh-lookseek

The plugin code uses the MIT License. The core problem it solves is: displaying the real status within the current and sub-sessions outside of the DSH session using a workspace page, rather than fabricating extra teams or extra chat windows.

Core Features

Workspace Display

The plugin displays three types of content in the “Workspace” tab:

  • Left Member Bar: Displays agents, presets, Chinese status, current workstations, and time elapsed in the current turn for the current and sub-sessions.
  • Central 3D Scene: Displays the robot, workstations, status tags, dialogue bubbles, and route animations.
  • Right Dashboard: Displays planned tasks and recent public tool events.

Different agents use different colors and are bound to real agentId, session presets, and status.

Real Event Mapping

The plugin listens for the following events in the current session:

  • Session Start
  • Model Request
  • Tool Execution
  • Turn End

These events are mapped to fixed workstations. The page displays safe summaries and does not show full commands, absolute paths, keys, tokens, passwords, or raw tool parameters.

Custom GLB Scenes

The plugin supports importing .glb files up to 30MB as scenes to be choreographed. After import, it will not immediately replace the current workspace; it requires completing workstation calibration and route drawing, and clicking “Save and Enable Route” to take effect.

Scenes to be choreographed are saved in:

DSH_HOME/lookseek/scene-draft.glb

If the default DSH_HOME is not set, it is usually located under .dsh/lookseek/ in the user directory.

Route Choreography

The plugin supports calibrating workstations and drawing straight or curved routes sequentially. Available keys for route editing include:

  • Left click to select highlighted points
  • W / A / S / D to adjust planar position
  • Space to move up
  • Shift to move down
  • Hold Alt for fine-tuning

Straight line mode draws based on start and end points; curve mode draws based on start, bend point, and end points.

Each scene layout is saved as:

DSH_HOME/lookseek/layout.json

After changing a scene, workstations need to be recalibrated because old coordinates may not apply to the new model.

Built-in Robot and Preset Reporting

The current version includes a robot character with a metallic material and working posture, displaying status based on real activities.

Custom agent presets can call lookseek_report to report a line of public summary. The fields that can be passed include:

agentId
agentName
role
activity
target
summary

The reported content should remain short, public, and free of sensitive information.

Installation and Activation

Prerequisites: DeepSeek Harness is installed and available, and the dsh command can be used. The following examples use the web profile; if using another profile, change web in the command to the actual name.

Install the plugin:

dsh plugin --profile web add github:lhwu1/dsh-lookseek

If the first installation from GitHub prompts for build permission, add the following to the pnpm-workspace.yaml specified in the command output:

allowBuilds:
  dsh-lookseek: true

Then execute the installation command again. Only grant build permissions to repositories you trust.

Start Harness:

dsh web --port 3080

Open in browser:

http://127.0.0.1:3080/

After entering any session, select the “Workspace” tab.

Typical Usage

View Workspace

After entering a DSH session, switch to the “Workspace” tab. The page displays members, status, planned tasks, and recent public tool events of the current and sub-sessions.

Import Custom GLB Scenes

Follow these steps when importing a scene:

  1. Import a .glb file not exceeding 30MB.
  2. Confirm the file appears as a “Scene to be Choreographed”.
  3. Click “Enter Choreography”.
  4. Use the “Step 0 / 2” scale slider to adjust the model size, ranging from 25% to 300%.
  5. Calibrate all workstations.
  6. Draw the route.
  7. Click “Save and Enable Route”.

Only after saving and enabling will the new model and route officially replace the current workspace. Closing the choreographer before saving retains the original model and route for the current workspace.

Edit Route

Route editing is divided into two phases:

  1. Calibrate workstations.
  2. Draw the route.

When calibrating workstations, you can first left-click to select a highlighted point, then use keys to adjust the position. When drawing the route:

  • Straight line mode: Left-click the start point, then left-click the end point.
  • Curve mode: Left-click the start point, right-click to add a bend point, and finally left-click the end point.

Report Status for Presets

Custom agent presets can call lookseek_report passing public summary fields. Example fields:

{
  "agentId": "",
  "agentName": "",
  "role": "",
  "activity": "",
  "target": "",
  "summary": ""
}

summary should be a short, public summary without sensitive information.

Update Plugin

Update an installed plugin:

dsh plugin --profile web update dsh-lookseek

Develop from Source

Get and build from source:

git clone https://github.com/lhwu1/dsh-lookseek.git
cd dsh-lookseek
npm install
npm run typecheck
npm run test
npm run bundle

Troubleshooting Missing “Workspace” Tab

If you cannot see the “Workspace” tab, run:

dsh --profile web --dump-config

Confirm the output contains:

dsh-lookseek
dsh-lookseek-web

Suitable Scenarios and Notes

Who is it for

This plugin is suitable for the following usage:

  • Want to verify agent current status outside DSH conversations.
  • Sessions contain sub-sessions or sub-agents and want to see real members in the member bar.
  • Want to import their own .glb office scene as a choreographed workspace.
  • Want to calibrate workstations and draw routes for the workspace.

Current Limitations

The current version does not support importing independent robot or character .glb files, nor does it support uploading custom 3D appearances for each agent. The robotAsset configuration field should not be considered an open import feature.

Currently customizable are the workspace scene, scale, workstations, and routes. Character model import is a future capability.

Scenes and Layouts

Uploading a .glb does not immediately replace the current workspace. You must complete the workstations, routes, and click “Save and Enable Route”.

Scenes to be choreographed are saved in:

DSH_HOME/lookseek/scene-draft.glb

Each scene layout is saved in:

DSH_HOME/lookseek/layout.json

Scenes must be recalibrated after changing a scene.

Display Boundaries

The plugin displays safe summaries and does not show:

  • Full commands
  • Absolute paths
  • Keys
  • Tokens
  • Passwords
  • Raw tool parameters

It also does not guess the model’s internal reasoning. The robot only moves and displays status based on Harness session state and trusted activity events.

Assets and Permissions

The plugin code uses the MIT License. The built-in office models are provided separately by the repository owner, see ATTRIBUTIONS.md for license details. Before forking or republishing, ensure you have redistribution permissions for the models and screenshots, or replace them with assets you have permission to use.

As a DSH plugin, check the repository source code, license, and build prompts before installation. Once enabled, it runs with DSH; only grant build or installation permissions to repositories you trust.

Conclusion

The value of lhwu1/dsh-lookseek lies in putting the real status, planned tasks, and public tool events of the DSH session into a workspace page for viewing, while also allowing the import of custom .glb scenes and route choreography. It does not replace chat and does not fabricate the model’s internal state, only displaying safe summaries corresponding to trusted session events.

Repository URL:

https://github.com/lhwu1/dsh-lookseek