Skip to content
Back to search

dsh-superagent-local

dsh-superagent 的本地改造版:每个工作区一个主会话,需求来自本机操作者而不是 GitHub/飞书(fork of dsh-superagent)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mengzhongjie--dsh-superagent-local/badge.svg)](/listings/mengzhongjie--dsh-superagent-local)

HTML

<a href="/listings/mengzhongjie--dsh-superagent-local"><img src="/api/listings/mengzhongjie--dsh-superagent-local/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This bundle is not published to npm. Install it from the repository or from a prebuilt tarball:

# from source: the `prepare` script builds lib/ during install
dsh plugin add github:mengzhongjie/dsh-superagent-local

# or a prebuilt tarball from the latest release
dsh plugin add https://github.com/mengzhongjie/dsh-superagent-local/releases/download/v0.2.1/dsh-superagent-0.2.1.tgz

Then follow [SETUP.md](SETUP.md) for the profile configuration and the first start.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 79 lines
  1. # dsh-superagent
  2. > **Research prototype for reference only, not an official DeepSeek product.** This code grew out of our team's day-to-day development work, with much of the engineering done by coding agents. Treat it as research code, not production-ready software. It may still contain bugs, and its coding style and engineering practices may be inconsistent. Review and adapt it before using it in your own environment.
  3. >
  4. > We have adapted it for publication, so it is not identical to our internal version or the implementation described in *Exploring Super-agent Design: Towards a More Autonomous Agent System*. Some designs discussed in the article are directions for future development and are not implemented in this prototype.
  5. dsh-superagent is a proactive coding agent for one GitHub repository, packaged as a bundle for [DeepSeek Harness](https://www.deepseek.com/en/harness/). It listens to GitHub and, optionally, Feishu. When someone allowed asks the agent for work, it opens a work item, works on it in its own agent session and directory, and answers in the original conversation, for example with a pull request. A web panel shows what needs a person.
  6. ## This fork: work from your own machine
  7. This repository is a fork of [dsh-superagent](https://github.com/deepseek-ai/dsh-superagent) that serves
  8. **the person sitting at the machine** instead of a GitHub repository. Four things differ from upstream:
  9. - **A local Source.** `src/sources/dsh.ts` (exported as `./local-watch`) turns a message in the main
  10. Session into a Trigger, and sends the answer back to that same Session. `source.kind === 'user'` is
  11. the filter, so messages that the orchestrator injects itself never loop back in.
  12. - **One main Session per workspace.** Every sidebar workspace has its own orchestrator, created on
  13. demand and remembered in `KV.runtime.masters` (workspaceId to sessionId). `GET
  14. /orchestrator/api/master?workspace=<id>` returns it, creating it when missing.
  15. - **A sidebar entry.** The client half injects a star button into each workspace group row
  16. (`[data-row-key^="workspace:"]`), opens that workspace's main Session, and hides main-session rows
  17. from the list.
  18. - **Attachments.** Images and files travel with the request: the Trigger carries
  19. `meta.attachments`, and the Worker receives the attachment-store path so it can open the file
  20. before deciding anything.
  21. It also runs without GitHub: `resolveDeployment` returns an empty repository when no remote is
  22. configured, and the GitHub watcher reports `paused` instead of polling.
  23. When an operator asks for work, the main Session routes it into a Ticket and a Worker does it in that
  24. workspace's directory; the main Session never edits files itself.
  25. It is also a way of working with an agent: **take as little human attention as possible, and give as much value as possible.** An agent that can act for a whole team can also waste a whole team's attention, so it acts only when asked or when a rule the team wrote allows it, and speaks only when someone must act or can use a result. [docs/000-philosophy.md](docs/000-philosophy.md) explains the principle and what it asks of the operator.
  26. ## Install
  27. This bundle is not published to npm. Install it from the repository or from a prebuilt tarball:
  28. ```sh
  29. # from source: the `prepare` script builds lib/ during install
  30. dsh plugin add github:mengzhongjie/dsh-superagent-local
  31. # or a prebuilt tarball from the latest release
  32. dsh plugin add https://github.com/mengzhongjie/dsh-superagent-local/releases/download/v0.2.1/dsh-superagent-0.2.1.tgz
  33. ```
  34. Then follow [SETUP.md](SETUP.md) for the profile configuration and the first start.
  35. ## Setup
  36. Setup has many steps, so an agent does it with you. Ask your coding agent:
  37. > Read SETUP.md in this repository and set up dsh-superagent with me.
  38. It asks one short question at a time, shows the full plan once, and then installs and configures everything. [SETUP.md](SETUP.md) is what it follows.
  39. ## Documentation
  40. Read the numbered documents in order; each builds only on the ones before it.
  41. - [000 Philosophy](docs/000-philosophy.md)
  42. - [001 Domain model](docs/001-domain.md)
  43. - [002 Authorization](docs/002-authorization.md)
  44. - [003 Execution](docs/003-execution.md)
  45. - [004 Prompts](docs/004-prompts.md)
  46. - [005 Panel](docs/005-panel.md)
  47. - [006 Deployment](docs/006-deployment.md): manual setup, configuration, upgrades and troubleshooting
  48. - [007 Architecture](docs/007-architecture.md)
  49. - [008 Cookbook](docs/008-cookbook.md): adding a Source
  50. ## Development
  51. `pnpm check` runs the typecheck, the tests and the build. `pnpm pack` produces the installable
  52. bundle used by `dsh plugin add`. A fresh clone has no `lib/` (it is built, not committed); the
  53. `prepare` script builds it, so `pnpm install` is enough before starting the harness from source.
  54. ## License
  55. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.