# las-updates

**Repository Path**: thinkpadpadthink/las-updates

## Basic Information

- **Project Name**: las-updates
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LAS · Liweihua Agent Shell

LAS 是一个装在 VS Code 系编辑器里的 AI 编程助手扩展。它不只是聊天框：接上模型后，它能直接读写你工作区里的文件、跑命令、查代码、改代码，并把每一步操作摊开给你看。

本仓库存放 LAS 的安装包，从这里下载即可使用。

---

## 一、LAS 能做什么

### 侧边栏里的 Agent

装好后编辑器活动栏会多一个 LAS 图标，点开就是聊天面板。你用自然语言提需求，LAS 自己决定要读哪些文件、搜哪些关键词、动哪几行代码，然后执行。

面板上能看到的东西：

- **过程卡片**：每次工具调用（读文件、搜索、跑命令）都单独成卡，写清楚动了什么、结果多大。不是黑盒。
- **思考流**：用推理模型时，思考内容单独一栏折叠展示，不和正文混。
- **变更集面板**：本轮改过的文件集中列出，可直接点开 diff 对比，也可整轮撤销。
- **任务清单**：多步骤任务会先列清单再逐项推进，做完一项勾一项，进度可见。
- **多会话页签**：几个任务并行开着，互不干扰，各自记住自己的工作区。

### 工作区：想让它看哪，它才看哪

LAS 不默认扫你整个磁盘。你手动挂载目录（一个主目录 + 若干附加目录），它的读写和搜索就锁在这些根之内。

- 目录树 + 文件名搜索，直接在面板里挂载、移除
- 越界路径会被拒绝，不会写到挂载范围外
- 自动跳过 `node_modules`、构建产物，以及 `.gitignore` / `.ignore` 里的条目

面板右侧内置 Git 区：查看变更、暂存、提交、拉取推送、处理冲突、还原文件、翻 git log，不用切终端。

### 工具箱

LAS 给模型配了一组内置工具，聊天时你会在过程卡片上看到它们的名字，都以 `las_` 开头：

| 类别 | 工具 | 说明 |
| --- | --- | --- |
| 读文件 | `las_read_text` | 按行区间读文本/代码/配置，大文件自动分片 |
| 写文件 | `las_write_text` / `las_edit_text` | 整文件写入 / 局部替换（多处改动原子生效，一处没匹配就整体回滚） |
| 删除 | `las_delete_file` | 删文件；删目录需显式声明递归 |
| 搜索 | `las_grep` / `las_glob` | 内容搜索走 ripgrep；文件名按 glob 匹配 |
| 目录 | `las_list_directory` | 按层列目录，默认跳过库和构建目录 |
| 表格 | `las_read_excel` / `las_write_excel` | 读写 `.xlsx` / `.xls` / `.ods` |
| 文档 | `las_read_doc` / `las_write_doc` | 读写 `.doc` / `.docx` / `.odt` / `.rtf` |
| PDF | `las_read_pdf` | 按页渲染成图交给视觉模型 |
| 图片 | `las_read_image` | 图片内容识别 |
| 附件 | `las_save_attachment` | 把你上传的附件落到工作区 |
| 命令 | `las_shell_run` / `las_shell_list` / `las_shell_status` / `las_shell_stop` | 跑命令，支持后台任务与状态查询 |
| 开发服务 | `las_dev_server_start` / `_stop` / `_status` / `_list` | 后台起 dev server、探测端口占用 |
| 协作 | `las_ask_user` / `las_write_todos` | 需要你确认时提问；多步任务维护清单 |
| 模式 | `las_select_response_mode` | 按任务类型切换回复风格 |

Office 文档和表格的转换依赖本机已安装 LibreOffice。

### 应答模式

LAS 会先判断这轮该用什么姿态回答，再决定要不要动工具：自然讨论、澄清追问、只读分析、代码修改、文件生成、命令操作、任务总结、失败说明。问一句话不会换来一篇报告，让它改代码也不会只给建议。

### 附件与多模态

截图、PDF、Word、Excel 直接拖进对话框。图片交给视觉模型识别，文档抽成文本，附件也能一键保存进工作区供后续引用。

### 模型配置

自带模型管理界面，可配多个模型并随时切换。走 OpenAI 兼容协议，支持自定义 base URL、API Key、温度和上下文窗口等参数，因此绝大多数兼容服务都能接。

### 外部 MCP 扩展

除内置工具外，还能挂第三方 MCP 服务，支持 `streamable-http`、`sse`、`stdio` 三种传输。挂上之后，外部工具和内置工具在同一个列表里供模型调用。

### 工作区 Rules

在工作区根目录建 `.las/rules`（`.md` / `.mdc` / `.txt`），里面写的约束会作为常驻要求带进每轮对话。适合固定项目规范，比如「UI 统一用小尺寸」「不要自动跑 build」「优先复用现有组件」，不用每次重复交代。

### 长会话处理

上下文接近上限时自动压缩历史，保留摘要继续对话，不用重开会话。历史消息分页加载，翻旧记录不卡。压缩中断会回滚，不会留下半截状态。

### 编辑器联动

选中代码按快捷键，路径（可带行号）直接送进对话框：

| 快捷键 | 动作 |
| --- | --- |
| `Ctrl+U` | 把当前文件路径 + 选中行号加入 LAS |
| `Ctrl+Shift+U` | 只把文件路径加入 LAS |

命令面板可用：打开聊天、add to las（两种）、Check for Updates。

### 数据与账号

LAS 使用账号登录，会话和消息存在服务端。客户端不保存数据库连接串或凭据，数据读写都经服务端接口完成。

---

## 二、安装

### 环境要求

编辑器内核需 VS Code 1.105.0 及以上（VS Code / Cursor / Trae 等均可）。

### 装包

从本仓库 `releases/` 目录下载最新的 `.vsix`，然后任选一种方式：

- 编辑器扩展面板 → 右上角 `...` → Install from VSIX
- 命令行：`code --install-extension liweihua-agent-shell-<version>.vsix`

装完在活动栏点 LAS 图标打开面板，登录账号即可开始用。

### 自动更新

装过一次之后就不用再手动下载了。LAS 每次启动会在后台静默检查新版本：

1. 发现更高版本，自动下载安装包
2. 校验文件完整性（SHA-256）
3. 校验通过后安装，并重载编辑器启用新版本

检查设有短超时，**不会阻塞 LAS 启动**。没有更新、网络超时、下载失败、校验不通过，LAS 都照常打开。

也可以手动触发：LAS 面板标题栏的刷新图标，或命令面板里的 Check for Updates。

---

## License

MIT，见 `LICENSE`。