@playform/ets-plugin-dsh-workspace
工作区代理：一个 DeepSeek Harness 插件，它就是工作区机制的对话界面——对话所面向的操作视图。它使用 Wave-1 图服务（ctx.workspaceGraph），并呈现图状、系统化的 s
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @playform/ets-plugin-dsh-workspace@0.2.1Ets Plugin Dsh Workspace 以 @playform/ets-plugin-dsh-workspace 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
v0.2.1 - UNPUBLISHED - plan: Workspace/WORKSPACE-AGENT
The workspace agent supplies the conversational surface of the workspace regime (the operational
view, Documentation/Plans/Workspace/WORKSPACE-AGENT.md).
The conversation addresses the workspace through this plugin, and everything else in the family (the stamps, the indexes, the validations, the licenses, the journals, the gates) stays the invisible plugin flow until an event surfaces it (the visibility rule).
The plugin offers five tools over the Wave-1 graph service (ctx.workspaceGraph): the four
navigation tools plus the indexing trigger that fills the graph.
| Tool | Input | Returns |
|---|---|---|
workspace_map | path/module, depth | top modules + roles, file count, entry points, hot symbols |
workspace_find | name/pattern, kind, limit | matching nodes with id, path, span, kind (cursor pagination) |
workspace_expand | node id, edge kinds, depth | the neighbors (contains, imports; references/calls/tests deferred to W2+, honestly) |
workspace_context | node id or query, budget | the orientation packet (WORKSPACE/SCOPE/MAP/FOCUS/NEIGHBORS/EVIDENCE/OPEN/STALE) |
workspace_index | path (default = session cwd), maxFiles | the walk's counts: indexed, skipped, failed, files |
The tables are compact and carry ids, with no full file bodies and pagination by cursor, never offset.
The packet is bounded (target 2k tokens), ranked by edge strength, and always versioned, so a stale view is detectable.
workspace_index is the indexing trigger: it delegates to indexWorkspace of the graph service, so
the walk, the per-file gates, the maxFiles bound, and the counts all stay in
@playform/plugin-dsh-workspace-graph, and the agent never touches ctx.fs itself.
Run the tool first when the graph is empty, because workspace_map on an unindexed workspace
honestly reports zero files.
Its byte-exact ledger line is the one NEW line that this work adds (the rest are unchanged in SCHEME.md):
workspace: index <path> (<indexed> indexed, <skipped> skipped, <failed> failed, <files> files)
The activation line moved with the fifth tool: workspace: activated (bundle 0.2.1, tools=5).
The plugin ships disabled (enabled: false), and every knob is volatile: enabled,
log/logFile, mapDepth, mapMaxModules, findLimit, findLimitMax, expandDepth,
expandMaxNeighbors, packetTokenBudget, packetTokenMax, tokenCharsPerToken, and kinds.
The knobs of the graph machinery (domain, languages, include/exclude, limits) belong to the Config
of @playform/plugin-dsh-workspace-graph itself, per the distribution law: each package's Config
its own.
The config carries the shared per-action allowlist (policy: Policy(), composed from the factory's
block) and maps it to State.Allow:
| action | default | action | default |
|---|---|---|---|
read | auto | write | approve |
index | auto | commit | approve |
record | auto | spawn | approve |
suggest | auto | message | auto |
The actions of the workspace agent are read-only, all AUTOMATIC.
It has no gated action (no file write, no batch commit, no spawn), so the block documents the posture and refuses nothing.
The block is one volatile object, so a policy flip is hot-editable without a remount.
The policy section of a resolved pack overrides the defaults for each action (the wiring is the
next refinement).
The agent orchestrates every hook and is the only conversational surface, and its Config is the surface knobs of the family.
It is a pure consumer in v0: inject: ["workspaceGraph", "pluginFactory", "tools"], with no event
listeners.
Plan: Documentation/Plans/Workspace-Family/WORKSPACE-AGENT.md;
Documentation/Plans/WORKSPACE-FAMILY-V4-1.md sections 3.4-3.5.
The plugin is a planned PoC (tier: 2-planned in Temporary/npm-bootstrap/MANIFEST.json), and the
smoke suite is the end-phase deliverable.
CC0-1.0.