Skip to content

Commit 3dc0c98

Browse files
committed
fixup! docs: 架构设计文档、roadmap 与模块设计说明
1 parent 5ec537c commit 3dc0c98

3 files changed

Lines changed: 1320 additions & 14 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,3 +29,4 @@ server/.air/
2929

3030
# Test range
3131
testrange/
32+
docs/N_DRC/

docs/architecture/coding-agent-design.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 本地 Coding Agent 架构设计文档
1+
# 本地 Agent 架构设计文档
22

33
> 版本:v1.1 · 2026-06-17 · 状态:可开工
44
>
@@ -18,7 +18,7 @@
1818
§6 │ 阶段路线图 Phase 0→3
1919
§7 │ 关键决策与权衡(TS vs Go、UI 选型、安全模型、Provider 抽象)
2020
§8 │ 风险与对策
21-
§9 │ 参考实现对照(Claude Code / Aider / Cline / Devin / Codin
21+
§9 │ 参考实现对照(Claude Code / Aider / Cline / Devin / )
2222
§10 │ 未决事项
2323
§11 │ Harness 框架(定义 / 何时创建 / Markdown schema 示例 / 生命周期 / 7 个工具 / .liskin/harness/ 目录)
2424
§12 │ IDE 插件(Daemon 化策略 / 启动流程 / /v1/ 协议 / 单进程→Daemon 演进点)
@@ -79,10 +79,10 @@
7979
**合理,且强烈推荐。** 理由:
8080

8181
- **价值锚点早**:用户第一天就能用客户端单端跑通对话 + 工具调用。
82-
- **避免提前抽象**:在没有真实多端/多用户压力前,任何 IDL/RPC/微服务设计都是空想。参见 liskin/Codin "先画 645 个 IDL 方法"——那是 SaaS 平台型语境下的产物,套到本地 Agent 上就是过度设计。
82+
- **避免提前抽象**:在没有真实多端/多用户压力前,任何 IDL/RPC/微服务设计都是空想。参见 liskin/ "先画 645 个 IDL 方法"——那是 SaaS 平台型语境下的产物,套到本地 Agent 上就是过度设计。
8383
- **可逆**:客户端把 LLM Provider 抽象成 `LLMProvider` 接口,未来要走后端中转,只需新增一个 `RemoteGatewayProvider` 实现,业务代码零改动。
8484

85-
### 2.3 与平台型 SaaS(Devin / Codin)的差异
85+
### 2.3 与平台型 SaaS(Devin / )的差异
8686

8787
| 维度 | 平台型 SaaS | 本项目(本地 Agent) |
8888
| ------------ | ---------------------- | ---------------------------------- |
@@ -231,7 +231,7 @@ liskarm_cc/
231231

232232
### 5.3 明确不做的事
233233

234-
- ❌ 先画几百个 IDL/RPC 方法(liskin/Codin 反例)
234+
- ❌ 先画几百个 IDL/RPC 方法(liskin/ 反例)
235235
- ❌ 提前微服务化,一个 Hono 单体撑到 1k 用户没问题
236236
- ❌ 照搬特定框架/RPC 协议
237237
- ❌ 在后端做 Agent 推理逻辑(推理只在客户端,后端是无状态网关)
@@ -319,15 +319,15 @@ type LLMEvent =
319319

320320
## 9. 参考实现对照
321321

322-
| 产品 | 形态 | 后端 | UI | 关系 |
323-
| ----------------- | ---------------------- | --------------------- | -------------- | ------------------------------- |
324-
| **Claude Code** | 本地 CLI / VSCode 扩展 | 仅 Anthropic API | Terminal + IDE | **形态最接近**,参考基准 |
325-
| **Cursor CLI** | 本地 CLI | 有(Cursor 自营网关) | Terminal | 后端是商业 Key 托管,MVP 不需要 |
326-
| **Aider** | 本地 CLI(Python) || Terminal | 架构理念接近:单端 + 自带 Key |
327-
| **Cline** | VSCode 扩展(TS) || IDE 侧栏 | TS 同生态,工具集设计可参考 |
328-
| **Devin / Codin** | 云端 SaaS | 重后端、多服务 | Web | **不参考**:会引入过度设计 |
322+
| 产品 | 形态 | 后端 | UI | 关系 |
323+
| --------------- | ---------------------- | --------------------- | -------------- | ------------------------------- |
324+
| **Claude Code** | 本地 CLI / VSCode 扩展 | 仅 Anthropic API | Terminal + IDE | **形态最接近**,参考基准 |
325+
| **Cursor CLI** | 本地 CLI | 有(Cursor 自营网关) | Terminal | 后端是商业 Key 托管,MVP 不需要 |
326+
| **Aider** | 本地 CLI(Python) || Terminal | 架构理念接近:单端 + 自带 Key |
327+
| **Cline** | VSCode 扩展(TS) || IDE 侧栏 | TS 同生态,工具集设计可参考 |
328+
| **Devin / ** | 云端 SaaS | 重后端、多服务 | Web | **不参考**:会引入过度设计 |
329329

330-
**立场**:靠近 Aider/Claude Code,远离 Devin/Codin
330+
**立场**:靠近 Aider/Claude Code,远离 Devin/。
331331

332332
---
333333

@@ -345,7 +345,7 @@ type LLMEvent =
345345

346346
### 11.1 定义与定位
347347

348-
**Harness**Coding Agent 在执行复杂任务时维护的一份**任务真相文档**:以 Markdown 文件形式落盘,记录用户意图、待办节点、已完成节点、闸门、理解笔记与控制状态,作为「可中断、可重连、可审计」的执行单元。
348+
**Harness**g Agent 在执行复杂任务时维护的一份**任务真相文档**:以 Markdown 文件形式落盘,记录用户意图、待办节点、已完成节点、闸门、理解笔记与控制状态,作为「可中断、可重连、可审计」的执行单元。
349349

350350
**与会话历史的区别**
351351

0 commit comments

Comments
 (0)