From f3d032c0e8d7a6f7fa4bf8da5622dc686863e898 Mon Sep 17 00:00:00 2001
From: Qiyuanqiii <267806965+Qiyuanqiii@users.noreply.github.com>
Date: Wed, 21 Oct 2026 21:56:52 +0800
Subject: [PATCH 1/8] docs: align current guidance with implemented
capabilities
---
CONTRIBUTING.md | 4 +-
README.en.md | 7 +--
README.md | 6 +--
docs/architecture.md | 7 ++-
docs/architecture/bounded-project-tests.md | 24 ++++++----
.../evidence/markdown-current-state/after.png | Bin 0 -> 71379 bytes
.../markdown-current-state/before.png | Bin 0 -> 77181 bytes
docs/extensions.md | 9 ++--
docs/releases/v1.0.0.md | 7 ++-
docs/sandbox-environments.md | 4 +-
docs/schema-baseline.md | 22 +++++----
docs/technical-reference.en.md | 2 +-
docs/usage.md | 45 +++++++++---------
web/README.md | 21 ++++----
14 files changed, 89 insertions(+), 69 deletions(-)
create mode 100644 docs/evidence/markdown-current-state/after.png
create mode 100644 docs/evidence/markdown-current-state/before.png
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4faa0e49f..69ea0880c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -175,7 +175,7 @@ cd ..
- **React 前端** 负责用户交互呈现与视觉效果,不私自推导或伪造未经后端确认的状态。
3. **纯 CSS 现代性能标准**:
- 界面视觉效果优先使用现代纯 CSS 属性(如 `backdrop-filter`、多层 `box-shadow` 内阴影、`linear-gradient`)。
- - 避免引入高开销的 SVG 位移滤镜(如 `feTurbulence`)或全屏 WebGL Canvas,确保在展示大量代码和日志输出时保持 120fps 丝滑滚动。
+ - 涉及滚动和视觉效果的改动应在实际页面验证;性能结论应记录测量环境与结果。
4. **统一规范的产品命名**:
- 所有面向用户的标题、文案、关于页面与文档中,产品官方名称一律统一为 **`Universal-Code`**。
@@ -190,7 +190,7 @@ cd ..
git checkout -b feat/support-deepseek-r1
```
2. 保持 Commit 粒度清晰,提交信息简明扼要。
-3. 在本地完整运行并通过 `npm test` 和 `go test`。
+3. 运行覆盖本次改动的相关测试和必需检查,在 PR 中记录验证范围与结果。
4. 在 GitHub 上发起 Pull Request,简要说明:
- **改动背景**:解决了什么问题或增加了什么特性。
- **关键设计**:采用了什么样的架构思路。
diff --git a/README.en.md b/README.en.md
index 992312379..ed48f2c6d 100644
--- a/README.en.md
+++ b/README.en.md
@@ -16,7 +16,7 @@
-
+
@@ -31,10 +31,10 @@
## Highlights
- **Built for Local Repositories**: Read, inspect, and edit local codebases with built-in line-by-line diff inspection and auditable checkpoints (Rewind).
-- **Transparent Permission Control**: Choose between read-only analysis, approval-gated runs, and automated Full Access. High-risk actions (file deletion, unlisted commands) always require manual confirmation.
+- **Transparent Permission Control**: Ask / Auto / Full authorization allows, requests approval for, or denies operations according to current permissions, verified effects, and safety policy. Full requires explicit activation in the current process.
- **Ready for Any Model**: Native support for OpenAI, Anthropic Claude, DeepSeek, Kimi, local Ollama models, and custom OpenAI-compatible endpoints with on-the-fly model switching. Also supports quick browser-based ChatGPT account sign-in.
- **Traceable Web Research**: Prioritizes provider-hosted native search, fetches GitHub Issues/PRs, Hacker News, and RSS/Atom feeds, and keeps source snapshots and citations.
-- **Modern Liquid Glass Aesthetic**: Crafted with pure CSS optical refraction (macOS / VisionOS acrylic style), supporting Dark, Light, and Mist frosted themes at a responsive 120fps.
+- **Switchable Interface Themes**: Dark, Light, and Mist themes use CSS blur, translucent backgrounds, gradients, and edge shadows for a glass-like appearance.
---
@@ -110,6 +110,7 @@ Switch between **System, Light, Dark, and Mist** under **Settings → Appearance
| :--- | :--- | :--- |
| **User Guide** | [Usage Guide](docs/usage.md) | Client walkthrough, CLI commands, and typical workflows |
| **Web Research** | [Search & Citations](docs/web-evidence.md) | Search setup, snapshot storage, URL provenance, and diagnostics |
+| **Chat Resources** | [Links, Files & Clipboard](docs/chat-resource-interactions.md) | Link previews, resource context menus, and file/image copy and paste |
| **Code Auditing** | [Workspace Checkpoints](docs/workspace-checkpoints.md) | Line-by-line diff review, snapshots, and safe Rewind |
| **Extensions** | [Extensions & MCP](docs/extensions.md) | Integrating Model Context Protocol (MCP) and custom skills |
| **Code Intelligence** | [LSP Support](docs/code-intelligence.md) | Symbol jump, type inference, and repository index |
diff --git a/README.md b/README.md
index 6c05fa64e..f4ed4e7ab 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@
-
+
@@ -31,10 +31,10 @@
## 核心特性
- **深度聚焦本地项目**:直接阅读、分析与修改本地代码库,内置 Diff 逐行审阅与可信撤销(Rewind / Checkpoints)能力。
-- **透明可控的安全策略**:支持只读分析、交互审批(Approval Mode)与全自动(Full Access)权限分级,高危操作(文件删除、非白名单命令)严格阻断并要求人工确认。
+- **透明可控的安全策略**:采用 Ask / Auto / Full 分级授权;操作按当前权限、实际影响和安全策略自动执行、请求审批或拒绝,Full 须在当前进程显式激活。
- **主流模型即开即用**:原生接入 OpenAI、Anthropic Claude、DeepSeek、Kimi、Ollama 本地模型与任何兼容 OpenAI 的第三方 API,支持单会话内即时热切,并支持通过系统浏览器快速完成 ChatGPT 账户授权登录。
- **真实来源的网络检索**:优先调用供应商原生搜索,支持直接抓取 GitHub PR/Issue、Hacker News 与 RSS/Atom 资讯,自动附带快照存证与引用出处。
-- **现代苹果液态玻璃美学**:采用纯 CSS 物理折射模型(macOS / VisionOS 亚克力液态玻璃风格),提供深色、浅色与雾透磨砂质感,兼具 120fps 极速渲染。
+- **可切换的界面主题**:提供深色、浅色与雾透主题,使用 CSS 模糊、半透明背景、渐变和边缘阴影呈现玻璃质感。
---
diff --git a/docs/architecture.md b/docs/architecture.md
index 4c442b8f0..5344b3917 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -157,7 +157,7 @@ The production React bundle is built by Vite but hosted only when Go receives an
## Core Domain
-`Run` is a domain aggregate, not a programming language, operating-system process, or replacement for Go/TypeScript/Rust. Go creates and owns Run lifecycle state; TypeScript may display and control it through Go APIs. Rust never owns a Run. The current analyzer fixture has no Run field or product bridge; a future Go adapter may bind a validated analyzer operation to a Run outside the Rust wire contract.
+`Run` is a domain aggregate, not a programming language, operating-system process, or replacement for Go/TypeScript/Rust. Go creates and owns Run lifecycle state; TypeScript may display and control it through Go APIs. Rust never owns a Run. Go application services bind the fixed embedded digest analyzer to a Run and commit its execution evidence. The Rust wire contract remains free of Run identity and authority. See the [Analyzer README](../analyzers/README.md) for the current execution boundary.
Budget, events, sandbox sessions, and reports are Run-scoped rather than embedded into one large object. Their modules remain independent and persist references by `run_id`; `AgentRunner` coordinates their lifecycle.
@@ -1041,7 +1041,7 @@ internal/store/ SQLite stores and migrations
internal/session/ Compatibility conversation service
internal/tui/ Bubble Tea adapter
internal/httpapi/ Loopback-only read/control API, OpenAPI contract, and bounded Run-event SSE
-internal/analyzer/ Go-owned analyzer protocol, validation, and future bridge boundary
+internal/analyzer/ Go-owned analyzer protocol, validation, and embedded WASI execution boundary
```
Packages split when a concrete implementation establishes different ownership. New tools and integrations reuse these services and add focused behavior tests for their contracts.
@@ -1334,6 +1334,9 @@ records these bounds.
## Go-Owned Analyzer Protocol And Rust Fixture
+The following P10-A/B sections record the initial implementation stages. For the
+current product execution path, see the [Analyzer README](../analyzers/README.md).
+
P10-A1 establishes `internal/analyzer` as a pure Go protocol owner rather than a process
launcher. `analyzer_protocol.v1` accepts one canonical inline Base64 payload plus explicit
limits and four capability declarations that must all be false. Strict decoding rejects
diff --git a/docs/architecture/bounded-project-tests.md b/docs/architecture/bounded-project-tests.md
index 552623f96..70c434581 100644
--- a/docs/architecture/bounded-project-tests.md
+++ b/docs/architecture/bounded-project-tests.md
@@ -1,11 +1,18 @@
# Bounded project tests
-`run_tests` is the root Supervisor's project test entry point in Code Plan and
-Deliver. Review is a workflow state, not an execution phase: the domain has
+`run_tests` is the project test entry point in Code Plan and Deliver for the root
+Supervisor and recorded `specialist_runner` workers with matching WorkerAuthority.
+Review is a workflow state, not an execution phase: the domain has
only `plan` and `deliver` phases.
-The request contains `version: "run-tests.v1"`, a relative directory `target`,
-and `timeout_milliseconds` from 1 through 25000. The host resolves the pinned
+The request contains `version: "run-tests.v1"`. `action: "run"` (the default when
+omitted) takes a relative directory `target` and `timeout_milliseconds` from 1
+through 25000. Longer tests use `action: "start"` with a timeout up to 1800000 ms,
+then `action: "wait"` with the original `job_id`, returned `cursor`, `max_bytes`
+(4–32768), and `wait_milliseconds` (1–5000). Wait observes the existing Job without
+a new target or timeout; repeating start is not a polling operation.
+
+The host resolves the pinned
project test ID or detects a supported project through the existing project
action registry. It chooses the executable, literal arguments, environment,
closed stdin, disabled network intent, output bounds and empty credentials.
@@ -21,10 +28,11 @@ fall back to the host. Dependency installation retains its sandbox-only gate.
The prepared command is pinned in the durable tool authority and regenerated
before approval and dispatch. The existing command authorizer, Run lease,
root attempt, gateway tool budget, command budget, timeout, cancellation and
-Job/output receipts remain authoritative. A test runs as one synchronous Job;
-failed or timed-out Jobs are returned as test evidence. A completed call is
-replayed without starting another Job. Specialist calls retain their existing
-bounded validation tools and child budget; `run_tests` grants no child access.
+Job/output receipts remain authoritative. Each run/start creates one Job; wait
+returns bounded output and status for that Job, retaining its original actor and
+authority. Failed or timed-out Jobs are returned as test evidence. A completed
+call is replayed without starting another Job. Worker execution retains its
+recorded assignment, WorkerAuthority, and child budget checks.
General `command_runtime` remains Deliver-only. Plan Job insertion additionally
requires a pending `run_tests` call with matching actor, command fingerprint,
diff --git a/docs/evidence/markdown-current-state/after.png b/docs/evidence/markdown-current-state/after.png
new file mode 100644
index 0000000000000000000000000000000000000000..728e4730caa90a07b5740ddfbd35a03323e99ded
GIT binary patch
literal 71379
zcmeEuWmsF^^Jk4xpoIbj3KVG3;>9Heic4{~5Q-Lemz1^?EAC$0-8Hzo1q&4S1Pu~M
zwqN<}?)#PhzS#3>?#X?g^O-qw=giERNr -lQ~o3@bwtVf>I4{H(I5!A^_nl(G8X`g@3JT@;A*1mRIIl$la5jA^!Fk
zY7S!@3&^gB!-tU$@Ptx%;_fApgDy_$Wwj`C=NKWUoi^Ro?WvIJ7%Y=vY=;Yiwvxm8
zR!=T@vVw|P@Xa;B!P17ke{=x#R+@)7lS0!yDRS18xFK
zdKbU?2Led@*XzNaY)P@zg)5h`+0PL<&X?^}B}baQR-!k~NDUR&*6s!{h0t+ZzX`^*
z+N((koRK%IGb)t3iOzVrhoI(aSsscX<}O4TywZX^#lHqNX{mDnGN8(R$sQi3Jigpq
zgyD==B1nH%iJDLLhZ_H$wn|+}yC#;MX}VXnGJqittM~7xR!8dSWaidyKo?Nfa@UCX
zt&g^hJ58fN5P~*jki)v%V@d7@8>?gNfm-oSVI3WJKhOY2lHeaUG#-%BlUt{GIbnJs
zWqawb>wTaN4SeO!FEwALnofstVnP<9S2*#|!}aER+m_DSRQ{+*$@KKQ{?$&d0gPWLuK~(TF@DJ?!(sEz1$K;
z!}r!&puA1!cn PqrNWfZUB{ON~pK4vC50yu6N
zKSXl`jD6p0j3_bjJ&d 8y$<)I-8yZmTRhi7SpHnfV8zlwbfmp^qIp|yR!h8dkE2>H-nd->(V1ACX_3e+O8
zQM}uPO>ZXs)^UmAk=}}|Y%^^|UyB|0l@vs#73Kg`R__<}{Dh$^c7g@k#^C}yB-8dr
z6O`4Ox#Zi4%?CMV$URZQvTRgI+%xG{J3AhCl_|HSv9pyX$F<%XwRex}bgS2~n)e3^
z4S2}M%{=z(wj6F2176rnxzfrwl<*#4PaX13`Ah~&yJ}=(zp1nQB$$6=KtxC6V`IIA
zEj6p`j%O{KnNxRTzcyB#xU>cLCwR_<
zuZN=MOc{fTyGQkp80jK^*_J~$Eg5E3ws3>y&oeYw6F+aYCVVO3nxEML5Ro%Ump(O(
z{@5ez=~o$0Btq2#CDzky35=^J&|*m5jLmE>lq?r4@*i_~f?6y0*EU8j2*Th(#G+}Y
z?gatVL
xdzjEBr==&L^IxBg_g=@hp%~C0~9-JDlV=aQ3*vw-p
zgiXO3FZI1p-_4{Wek;FUF@=Y*sCumVYzd;c50TP0U#h9rS33Ieq9W+>Eu)SK&d4d`
zH>E9yZq8_px_WtdSn=6W>X=$>
zY;SqUjR!D$^WGkszEx_
C2h>sC3mRl5Sp(40C@Jh
zL_)|&Q4u9N^ul3IV?_r0gOUCWvn*1}$kk6_vt5H{uhFHPNgy1l+<4)Dh|f*abzJG?
zuVZu>+Qy_s(387_5MjZgm|$t~u&sLiySQRlWGFMyOr_pONBgPLol^BA%AbbCb15
zgG1IS4|$A4dM%9NVkWMgk`IgEa`Ft51mHpB)P;K?&>@dm9`?&0#AIU=dEwJkkAHYk
zXfJN2P18bL!YVi7trTbs0T^BxEG5IysY!MnW)f{=lgwwfIOl2LtRCwoE*$?U`zZdl
zSfkm}j|r$1m?h@&p6$#p_;~)p{m6