# DSH Go-workspace

**DSHarness Go companion plugin**, adapted and supported exclusively for the **DSHarness Go Android App**. Connect the App to workspaces, sessions, messages and tasks on the user's DeepSeek Harness computer.

[简体中文](README.md) | [M0 validation](docs/DSHarness-Go-M0.md) | [Licenses and attribution](THIRD_PARTY_NOTICES.md)

## Compatibility

M0 developer preview `0.6.4-desktop.9`. Actual installation and pairing were tested with isolated DSH `0.2.0-rc.2` profiles. DSH Desktop `0.1.5-rc.2` has not passed installation acceptance. Retained upstream browser features and documentation do not imply support for other Apps or standalone mobile browsers.

## Quick start

1. Download `dsh-go-workspace-0.6.4-desktop.9.tgz` from the [current Release](https://github.com/Xiamen-Menggenda-Technology-Co-Ltd/DSH-Go-workspace/releases/tag/v0.6.4-desktop.9). This package is prebuilt; npm publication is pending.
2. Install the local package using DSH's plugin manager, enable **DSH Go-workspace**, then open its **DSHarness Go** connection panel.
3. Enable LAN access and pairing on the computer. Scan or enter its pairing information in DSHarness Go's Connect Computer page.

Marketplace submission [PR #7579](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/7579) is awaiting review and merge. Its entry uses the Release tarball, so marketplace installation does not require npm publication. Package-name installation still requires publishing `dsh-go-workspace` to npm. For a DSH Web profile, install the downloaded tarball with:

```sh
dsh plugin --profile web add ./dsh-go-workspace-0.6.4-desktop.9.tgz
```

Or install the public prebuilt package directly:

```sh
dsh plugin --profile web add https://github.com/Xiamen-Menggenda-Technology-Co-Ltd/DSH-Go-workspace/releases/download/v0.6.4-desktop.9/dsh-go-workspace-0.6.4-desktop.9.tgz
```

`https://github.com/dsh-market/dsh-market` is the marketplace's source repository, not this plugin. If installing the marketplace itself fails with `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`, use the published `dshmarket` npm package. See [market PR #890](https://github.com/dsh-market/dsh-market/pull/890).

Desktop manages its own profile; use its plugin page.

## What it does

- HTTPS pairing, device authorization and revocation.
- Workspace, session history, message, task and event interfaces for the Go App.
- LAN connections and existing remote access providers.

## Connection guide

Start on the same LAN. Open a short-lived pairing window on the computer and connect from the App. Existing device records, certificate checks and authorization remain in place. Never share pairing credentials publicly.

### Local network

The phone must be able to reach the computer's selected address. Enable LAN access in the connection panel before opening pairing. See [trusted network configuration](docs/TRUSTED_NETWORKS.en.md).

## Device management

Review and revoke devices in the computer's connection panel. The `mobile-access` storage and `dsh-mobile:` pairing protocol remain compatible with existing records.

## Security

Current data comes directly from the user's computer. No account or relay server has been deployed. Planned account registration, login synchronization, phone-local history and end-to-end encrypted relay transport are not implemented in M0.

The Go APK is currently a debug build. There is no verified stable Go APK descriptor. The upstream Android sources in `apps/mobile/` describe a different application. See [security information](SECURITY.md).

## Extend and customize

Upstream extension mechanisms remain for existing configuration compatibility. Only behavior compatible with the Go App's actual interfaces is supported.

### Optional modules and advanced configuration

Manage client modules in the connection panel. See [client modules](docs/CLIENT_MODULES.en.md) for switches and dependency restrictions, then reconnect as prompted.

## Third-party plugin compatibility

Arbitrary third-party combinations are not guaranteed. Include DSH, Go App and plugin versions in reports.

## Development

```sh
npm ci
npm run typecheck
npm test
npm run build
npm pack
```

See [M0 evidence](docs/DSHarness-Go-M0.md) and [contribution guidance](CONTRIBUTING.md). Historical upstream Android publishing instructions do not publish the Go App.

## License

Apache-2.0 and AGPL-3.0 portions retain their respective licenses. The combined distribution contains AGPL-covered code. See [third-party notices](THIRD_PARTY_NOTICES.md).