@atlisp/agent 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +215 -0
  2. package/README.md~ +215 -0
  3. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,215 @@
1
+ # @lisp Agent
2
+
3
+ AI Agent for @lisp - 通过 MCP 连接到 CAD 执行 AI 辅助操作。
4
+
5
+ ## 安装
6
+
7
+ ### Windows (PowerShell)
8
+
9
+ ```powershell
10
+ iwr -useb https://atlisp.cn/install.ps1 | iex
11
+ ```
12
+
13
+ ### 手动安装
14
+
15
+ ```bash
16
+ npm i -g @atlisp/agent
17
+ ```
18
+
19
+ ## 配置
20
+
21
+ 配置文件位置: `~/.atlisp/atlisp.json` 或 `~/.atlisp/atlisp.yaml`
22
+
23
+ ### 配置示例 (JSON)
24
+
25
+ ```json
26
+ {
27
+ "agent": {
28
+ "enabled": true,
29
+ "maxSteps": 10,
30
+ "verbose": false
31
+ },
32
+ "llm": {
33
+ "provider": "deepseek",
34
+ "baseURL": "",
35
+ "model": "deepseek-v4-flash",
36
+ "apiKey": "sk-xxxxx",
37
+ "temperature": 0.7,
38
+ "maxTokens": 2048
39
+ },
40
+ "mcp": {
41
+ "mode": "stdio",
42
+ "command": "atlisp-mcp",
43
+ "args": ["--stdio"]
44
+ }
45
+ }
46
+ ```
47
+
48
+ ### 配置示例 (YAML)
49
+
50
+ ```yaml
51
+ agent:
52
+ enabled: true
53
+ maxSteps: 10
54
+ verbose: false
55
+
56
+ llm:
57
+ provider: deepseek
58
+ baseURL: ""
59
+ model: deepseek-v4-flash
60
+ apiKey: sk-xxxxx
61
+ temperature: 0.7
62
+ maxTokens: 2048
63
+
64
+ mcp:
65
+ mode: stdio
66
+ command: atlisp-mcp
67
+ args:
68
+ - --stdio
69
+ ```
70
+
71
+ ## 配置说明
72
+
73
+ ### Agent 配置
74
+
75
+ | 配置项 | 类型 | 默认值 | 说明 |
76
+ |--------|------|--------|------|
77
+ | enabled | boolean | true | 是否启用 agent |
78
+ | maxSteps | number | 10 | 最大执行步数 |
79
+ | verbose | boolean | false | 调试模式 |
80
+
81
+ ### LLM 配置
82
+
83
+ | 配置项 | 类型 | 默认值 | 说明 |
84
+ |--------|------|--------|------|
85
+ | provider | string | deepseek | LLM 提供商: deepseek, vllm |
86
+ | baseURL | string | 空 | API 地址（留空使用默认值） |
87
+ | model | string | deepseek-v4-flash | 模型名称 |
88
+ | apiKey | string | 空 | API Key |
89
+ | temperature | number | 0.7 | 温度参数 |
90
+ | maxTokens | number | 2048 | 最大 token 数 |
91
+
92
+ ### MCP 配置
93
+
94
+ | 配置项 | 类型 | 默认值 | 说明 |
95
+ |--------|------|--------|------|
96
+ | mode | string | stdio | 连接模式: http, stdio |
97
+ | url | string | http://localhost:8110 | HTTP 模式端点 |
98
+ | command | string | atlisp-mcp | stdio 模式命令 |
99
+ | args | array | ["--stdio"] | stdio 模式参数 |
100
+
101
+ ## 环境变量
102
+
103
+ 配置可被环境变量覆盖（优先级最高）:
104
+
105
+ ```bash
106
+ # LLM
107
+ export LLM_PROVIDER=deepseek
108
+ export LLM_MODEL=deepseek-v4-flash
109
+ export DEEPSEEK_API_KEY=sk-xxxxx
110
+ export LLM_TEMPERATURE=0.7
111
+ export LLM_MAX_TOKENS=2048
112
+
113
+ # MCP
114
+ export MCP_MODE=stdio
115
+ export MCP_COMMAND=atlisp-mcp
116
+ export MCP_ARGS="--stdio"
117
+
118
+ # Agent
119
+ export AGENT_VERBOSE=true
120
+ export AGENT_MAX_STEPS=20
121
+ ```
122
+
123
+ ## 使用方式
124
+
125
+ ### CLI 交互模式
126
+
127
+ ```bash
128
+ npx atlisp-agent chat
129
+ ```
130
+
131
+ ### 单次执行
132
+
133
+ ```bash
134
+ npx atlisp-agent exec "查询 CAD 版本"
135
+ ```
136
+
137
+ ### 列出工具
138
+
139
+ ```bash
140
+ npx atlisp-agent tools
141
+ ```
142
+
143
+ ### HTTP Server 模式
144
+
145
+ ```bash
146
+ npm run server
147
+ # 启动在 http://0.0.0.0:8120
148
+ ```
149
+
150
+ ### API 端点
151
+
152
+ | 方法 | 路径 | 说明 |
153
+ |------|------|------|
154
+ | POST | /chat | AI 对话 |
155
+ | POST | /exec | 单次执行 |
156
+ | GET | /tools | 列出工具 |
157
+ | GET | /health | 健康检查 |
158
+ | GET | /history | 获取历史 |
159
+ | DELETE | /history | 清除历史 |
160
+
161
+ ### API 调用示例
162
+
163
+ ```bash
164
+ curl -X POST http://localhost:8120/chat \
165
+ -H "Content-Type: application/json" \
166
+ -d '{"message": "查询 CAD 版本"}'
167
+ ```
168
+
169
+ ## MCP 工具
170
+
171
+ | 工具名 | 说明 |
172
+ |--------|------|
173
+ | connect_cad | 连接 CAD |
174
+ | eval_lisp | 执行 LISP 代码（无返回） |
175
+ | eval_lisp_with_result | 执行 LISP 代码（返回结果） |
176
+ | get_cad_info | 获取 CAD 信息 |
177
+ | list_packages | 列出已安装包 |
178
+ | search_packages | 搜索包 |
179
+ | install_package | 安装包 |
180
+ | get_platform_info | 获取平台信息 |
181
+ | at_command | 执行 @lisp 命令 |
182
+
183
+ ## LLM Provider
184
+
185
+ ### deepseek
186
+
187
+ 使用 DeepSeek API。
188
+
189
+ ```json
190
+ {
191
+ "llm": {
192
+ "provider": "deepseek",
193
+ "apiKey": "sk-xxxxx",
194
+ "model": "deepseek-v4-flash"
195
+ }
196
+ }
197
+ ```
198
+
199
+ ### vllm
200
+
201
+ 使用本地 vLLM 服务器。
202
+
203
+ ```json
204
+ {
205
+ "llm": {
206
+ "provider": "vllm",
207
+ "baseURL": "http://192.168.1.8:8001/v1",
208
+ "model": "your-model"
209
+ }
210
+ }
211
+ ```
212
+
213
+ ## 许可证
214
+
215
+ ISC
package/README.md~ ADDED
@@ -0,0 +1,215 @@
1
+ # @lisp Agent
2
+
3
+ AI Agent for @lisp - 通过 MCP 连接到 CAD 执行 AI 辅助操作。
4
+
5
+ ## 安装
6
+
7
+ ### Windows (PowerShell)
8
+
9
+ ```powershell
10
+ iwr -useb https://atlisp.cn/install.ps1 | iex
11
+ ```
12
+
13
+ ### 手动安装
14
+
15
+ ```bash
16
+ npm i -g @atlisp/agent
17
+ ```
18
+
19
+ ## 配置
20
+
21
+ 配置文件位置: `~/.atlisp/atlisp.json` 或 `~/.atlisp/atlisp.yaml`
22
+
23
+ ### 配置示例 (JSON)
24
+
25
+ ```json
26
+ {
27
+ "agent": {
28
+ "enabled": true,
29
+ "maxSteps": 10,
30
+ "verbose": false
31
+ },
32
+ "llm": {
33
+ "provider": "deepseek",
34
+ "baseURL": "",
35
+ "model": "deepseek-v4-flash",
36
+ "apiKey": "sk-xxxxx",
37
+ "temperature": 0.7,
38
+ "maxTokens": 2048
39
+ },
40
+ "mcp": {
41
+ "mode": "stdio",
42
+ "command": "atlisp-mcp",
43
+ "args": ["--stdio"]
44
+ }
45
+ }
46
+ ```
47
+
48
+ ### 配置示例 (YAML)
49
+
50
+ ```yaml
51
+ agent:
52
+ enabled: true
53
+ maxSteps: 10
54
+ verbose: false
55
+
56
+ llm:
57
+ provider: deepseek
58
+ baseURL: ""
59
+ model: deepseek-v4-flash
60
+ apiKey: sk-xxxxx
61
+ temperature: 0.7
62
+ maxTokens: 2048
63
+
64
+ mcp:
65
+ mode: stdio
66
+ command: atlisp-mcp
67
+ args:
68
+ - --stdio
69
+ ```
70
+
71
+ ## 配置说明
72
+
73
+ ### Agent 配置
74
+
75
+ | 配置项 | 类型 | 默认值 | 说明 |
76
+ |--------|------|--------|------|
77
+ | enabled | boolean | true | 是否启用 agent |
78
+ | maxSteps | number | 10 | 最大执行步数 |
79
+ | verbose | boolean | false | 调试模式 |
80
+
81
+ ### LLM 配置
82
+
83
+ | 配置项 | 类型 | 默认值 | 说明 |
84
+ |--------|------|--------|------|
85
+ | provider | string | deepseek | LLM 提供商: deepseek, vllm |
86
+ | baseURL | string | 空 | API 地址（留空使用默认值） |
87
+ | model | string | deepseek-v4-flash | 模型名称 |
88
+ | apiKey | string | 空 | API Key |
89
+ | temperature | number | 0.7 | 温度参数 |
90
+ | maxTokens | number | 2048 | 最大 token 数 |
91
+
92
+ ### MCP 配置
93
+
94
+ | 配置项 | 类型 | 默认值 | 说明 |
95
+ |--------|------|--------|------|
96
+ | mode | string | stdio | 连接模式: http, stdio |
97
+ | url | string | http://localhost:8110 | HTTP 模式端点 |
98
+ | command | string | atlisp-mcp | stdio 模式命令 |
99
+ | args | array | ["--stdio"] | stdio 模式参数 |
100
+
101
+ ## 环境变量
102
+
103
+ 配置可被环境变量覆盖（优先级最高）:
104
+
105
+ ```bash
106
+ # LLM
107
+ export LLM_PROVIDER=deepseek
108
+ export LLM_MODEL=deepseek-v4-flash
109
+ export DEEPSEEK_API_KEY=sk-xxxxx
110
+ export LLM_TEMPERATURE=0.7
111
+ export LLM_MAX_TOKENS=2048
112
+
113
+ # MCP
114
+ export MCP_MODE=stdio
115
+ export MCP_COMMAND=atlisp-mcp
116
+ export MCP_ARGS="--stdio"
117
+
118
+ # Agent
119
+ export AGENT_VERBOSE=true
120
+ export AGENT_MAX_STEPS=20
121
+ ```
122
+
123
+ ## 使用方式
124
+
125
+ ### CLI 交互模式
126
+
127
+ ```bash
128
+ npx atlisp-agent chat
129
+ ```
130
+
131
+ ### 单次执行
132
+
133
+ ```bash
134
+ npx atlisp-agent exec "查询 CAD 版本"
135
+ ```
136
+
137
+ ### 列出工具
138
+
139
+ ```bash
140
+ npx atlisp-agent tools
141
+ ```
142
+
143
+ ### HTTP Server 模式
144
+
145
+ ```bash
146
+ npm run server
147
+ # 启动在 http://0.0.0.0:8120
148
+ ```
149
+
150
+ ### API 端点
151
+
152
+ | 方法 | 路径 | 说明 |
153
+ |------|------|------|
154
+ | POST | /chat | AI 对话 |
155
+ | POST | /exec | 单次执行 |
156
+ | GET | /tools | 列出工具 |
157
+ | GET | /health | 健康检查 |
158
+ | GET | /history | 获取历史 |
159
+ | DELETE | /history | 清除历史 |
160
+
161
+ ### API 调用示例
162
+
163
+ ```bash
164
+ curl -X POST http://localhost:8120/chat \
165
+ -H "Content-Type: application/json" \
166
+ -d '{"message": "查询 CAD 版本"}'
167
+ ```
168
+
169
+ ## MCP 工具
170
+
171
+ | 工具名 | 说明 |
172
+ |--------|------|
173
+ | connect_cad | 连接 CAD |
174
+ | eval_lisp | 执行 LISP 代码（无返回） |
175
+ | eval_lisp_with_result | 执行 LISP 代码（返回结果） |
176
+ | get_cad_info | 获取 CAD 信息 |
177
+ | list_packages | 列出已安装包 |
178
+ | search_packages | 搜索包 |
179
+ | install_package | 安装包 |
180
+ | get_platform_info | 获取平台信息 |
181
+ | at_command | 执行 @lisp 命令 |
182
+
183
+ ## LLM Provider
184
+
185
+ ### deepseek
186
+
187
+ 使用 DeepSeek API。
188
+
189
+ ```json
190
+ {
191
+ "llm": {
192
+ "provider": "deepseek",
193
+ "apiKey": "sk-xxxxx",
194
+ "model": "deepseek-v4-flash"
195
+ }
196
+ }
197
+ ```
198
+
199
+ ### vllm
200
+
201
+ 使用本地 vLLM 服务器。
202
+
203
+ ```json
204
+ {
205
+ "llm": {
206
+ "provider": "vllm",
207
+ "baseURL": "http://192.168.1.8:8001/v1",
208
+ "model": "your-model"
209
+ }
210
+ }
211
+ ```
212
+
213
+ ## 许可证
214
+
215
+ ISC
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlisp/agent",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "AI Agent for @lisp - Connects to MCP Server for CAD operations",
5
5
  "type": "module",
6
6
  "main": "index.js",