@creative-dswork/dscode 0.2.5 → 0.2.7

package/README.md

@@ -4,8 +4,8 @@
 
 <p align="center">
   <strong>
-    MCP-first coding agent for digital studios.<br />
-    Powering creative work across Blender, game engines, and production tools.
+    A digital studio for content-driven creation.<br />
+    Code, write, design, and build — with an AI that thinks like a maker.
   </strong>
 </p>
 
@@ -24,20 +24,11 @@
 
 ## See it in action
 
-<table align="center">
-<tr>
-<td align="center" width="50%">
-  <video src="https://github.com/user-attachments/assets/b92aedab-93cc-4188-976a-0fcae614c04d" controls width="100%"></video>
-  <br /><sub><b>Web UI</b> — streaming chat, tool calls, permission dialogs</sub>
-</td>
-<td align="center" width="50%">
-  <video src="https://github.com/user-attachments/assets/79790daa-d6f3-4d43-8306-e1d93561600c" controls width="100%"></video>
-  <br /><sub><b>Terminal UI</b> — real-time streaming, slash commands, inline rendering</sub>
-</td>
-</tr>
-
+<p align="center">
+  <img src="docs/assets/work-main-ui.png" alt="dscode — editorial workshop" width="800" />
+</p>
 
-> **Tip:** Videos play inline — click to watch demos directly in GitHub.
+> dscode's editorial workshop — a creative space for code, design, and conversation.
 
 ## What makes dscode different
 
@@ -74,11 +65,11 @@ Too many MCP servers? Context explosion is a real problem when every tool schema
 </td>
 <td width="50%" valign="top">
 
-### 🐋 DeepSeek V4 Pro — Recommended
+### 🎨 Editorial Workshop
 
-dscode is purpose-built for DeepSeek V4 Pro — our recommended model for digital creation. Its reasoning depth handles complex multi-tool workflows ("model this in Blender, render in PlayCanvas, document the result") without losing context. A **vision model fallback pipeline** transparently routes screenshots and reference images to vision-capable models. Prompt caching is tuned to maintain **97–99% cache hit rates** via `prompt_cache_key` affinity and prefix-stable message construction. Every optimization is measured against DeepSeek's API behavior.
+dscode is not a chatbot with a dark theme. It's a **digital studio** — a creative workspace with editorial typography, generous whitespace, and a warm, tool-like aesthetic. The interface is designed for makers: phase-labeled message groups, serif structural labels, sidebar detail panels, and a Dashboard that's a mode of Chat, not a separate page. Every pixel earns its place.
 
-**DeepSeek V4 Pro. For when your toolchain needs more than autocomplete.**
+**A creative space. Not just a chat window.**
 
 </td>
 </tr>
@@ -113,8 +104,8 @@ dscode is purpose-built for DeepSeek V4 Pro — our recommended model for digita
   <sub>Auto-routing to vision-capable models. tesseract OCR fallback (ENG + CHI). Drag, paste, or @-file images.</sub>
 </td>
 <td width="33%" valign="top">
-  <strong>🔧 Built-in Drivers</strong><br />
-  <sub><code>read_file</code>, <code>write_file</code>, <code>edit</code> (hash-anchor), <code>bash</code>, <code>grep</code>, <code>glob</code>. MCP tools discovered on-demand via <code>search_tools</code>.</sub>
+  <strong>🔧 Open Design</strong><br />
+  <sub>AI-driven visual design workspace with frontend generation, image-to-code, and design-system management. Integrated via MCP.</sub>
 </td>
 </tr>
 <tr>
@@ -303,26 +294,45 @@ All settings can also be set via environment variables for CI / containers:
 ---
 
 
-## Harness Philosophy
+## Open Design
+
+dscode integrates **[Open Design](https://github.com/wangcan26/open-design)** — a visual design workspace that brings AI-driven frontend generation directly into your workflow. Think of it as Figma meets AI: design tokens, components, and entire layouts generated through natural language, with real-time preview and iteration.
 
-We follow **Occam's razor** in harness design. dscode does not pre-build intent understanding modules, plan modes, or elaborate agentic scaffolding until the system prompt proves insufficient. Most coding agents pile on pre-turn planning, reflection loops, and multi-agent orchestration upfront — we wait until the model demands it.
+### What Open Design does for dscode
 
-That doesn't mean the harness is bare. It means every piece earns its place.
+- **Visual design workspace** — create, edit, and iterate on frontend designs without leaving dscode
+- **Image-to-code** — generate production-ready HTML/CSS from design mockups
+- **Design system management** — maintain consistent design tokens, typography scales, and color palettes across projects
+- **Multi-file artifact generation** — produce complete frontend projects with structured file trees
 
-One example where we went deeper: the **edit tool**. Based on [@_can1357's hash-anchor protocol](https://x.com/_can1357/status/2021828033640911196), our `edit` tool replaces fragile line-number and regex-based editing with a **content-addressable anchor system** ([spec](openspec/specs/edit-tool/spec.md)):
+### Installation
 
-- **Three-level adaptive resolution** — ambiguous 6-char hashes are resolved silently through 8-char → context-augmented (3-line window) matching before rejection
-- **Occurrence + line-hint disambiguation** — `occurrence: 3` picks the Nth match; `line` field auto-selects the closest candidate, rejecting only when equidistant
-- **Proximity-based range resolution** — for range endpoints, if one side is unique the other automatically resolves to the nearest candidate in the correct direction
-- **Low-entropy filtering** — lines like `}` are rejected as anchors; the tool returns up to 6 neighboring `[high]` anchors as alternatives
-- **Atomic batch + overlap detection** — 6 operation types in one call, all-or-nothing. Overlapping ranges within a batch are detected and rejected
-- **Checkpoint + safety rollback** — file checkpointed before edit. Post-edit sanity checks (duplicate lines, delimiter balance, orphan `else`) roll back suspicious changes
-- **Structured invalidation scope** — `anchors_valid_through` and `must_refresh_from_line` tell the model exactly which anchors survive, enabling chained edits without re-reading
-- **Localized diff with live anchors** — successful edits return a diff with fresh 6-char hashes, so the model can continue editing immediately
+```bash
+git clone https://github.com/wangcan26/open-design.git
+cd open-design
+npm install
+```
+
+Then configure the MCP server in `~/.dscode/settings.json`:
 
-**dscode builds dscode.** This edit tool — combined with our spec-driven workflow — is what enabled dscode to develop itself. Every feature, from the hash-anchor protocol to the checkpoint system, was implemented by dscode running on DeepSeek V4 Pro, editing its own source tree through MCP-driven tools. It's not a demo. It's how this project ships.
+```jsonc
+{
+  "mcpServers": {
+    "open-design": {
+      "command": "npx",
+      "args": [
+        "tsx",
+        "/path/to/open-design/apps/daemon/src/cli.ts",
+        "mcp",
+        "--daemon-url",
+        "http://127.0.0.1:7456"
+      ]
+    }
+  }
+}
+```
 
-This is the kind of harness work we invest in: not adding more AI, but making the AI's tools dependable.
+> **Note:** Open Design's dscode integration currently lives on the `add-dscode-agent` branch and has not yet been submitted as a PR to upstream. The integration provides dscode-specific installer targets and agent configuration. Track the progress at [github.com/wangcan26/open-design](https://github.com/wangcan26/open-design).
 
 ---