@alphalawyer/alpha-classic-cli 0.1.2 → 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.
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Alpha Classic CLI 是为 **Alpha 律所管理系统** 开发的 AI-friendly CLI
|
|
|
5
5
|
- CLI 命令能访问 Web 应用 API
|
|
6
6
|
- Codex 能通过 Skill 理解该怎么调用 CLI
|
|
7
7
|
- 登录、诊断、业务查询形成最小闭环
|
|
8
|
-
-
|
|
8
|
+
- 默认环境是 `prod`,也可以通过 `env use` 在预设环境间切换
|
|
9
9
|
|
|
10
10
|
## 安装依赖
|
|
11
11
|
|
|
@@ -16,10 +16,10 @@ npm install
|
|
|
16
16
|
## 构建
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
|
-
npm run build
|
|
19
|
+
npm run build
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
默认构建生产环境产物;本地调试也保留按环境构建的脚本:
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
25
|
npm run build:local
|
|
@@ -41,10 +41,10 @@ npm run release:patch
|
|
|
41
41
|
- `release:patch`:先确认 npm 登录用户,再完成发布前检查、自动升级补丁版本、重新生产构建并发布到公开 npm 仓库。
|
|
42
42
|
- 如果 npm 要求 OTP,命令后追加参数即可,例如 `npm run release:patch -- --otp=123456`。
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
默认 prod 环境:
|
|
45
45
|
|
|
46
46
|
```text
|
|
47
|
-
baseUrl/apiBaseUrl: https://
|
|
47
|
+
baseUrl/apiBaseUrl: https://alphalawyer.cn
|
|
48
48
|
current user API: GET /im/v1/users/me
|
|
49
49
|
auth header: token: <token>
|
|
50
50
|
device header: deviceType: ai
|
|
@@ -56,7 +56,10 @@ device header: deviceType: ai
|
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
58
|
alpha-classic-cli version
|
|
59
|
+
alpha-classic-cli env list
|
|
59
60
|
alpha-classic-cli env current
|
|
61
|
+
alpha-classic-cli env use test
|
|
62
|
+
alpha-classic-cli env use prod
|
|
60
63
|
alpha-classic-cli login
|
|
61
64
|
alpha-classic-cli doctor
|
|
62
65
|
alpha-classic-cli matter search --keyword 合同 --limit 10
|
|
@@ -68,7 +71,7 @@ alpha-classic-cli appro initiators --keyword 张三
|
|
|
68
71
|
alpha-classic-cli appro detail --id <审批ID>
|
|
69
72
|
```
|
|
70
73
|
|
|
71
|
-
`env use
|
|
74
|
+
`env use <local|dev|test|prod>` 会写入本地配置并清空旧登录态,切换后需要重新执行 `alpha-classic-cli login`。
|
|
72
75
|
|
|
73
76
|
源码调试时也可以使用:
|
|
74
77
|
|
|
@@ -115,7 +118,7 @@ alpha-classic-cli install
|
|
|
115
118
|
默认安装 Codex Skill:
|
|
116
119
|
|
|
117
120
|
```text
|
|
118
|
-
~/.codex/skills/alpha-classic
|
|
121
|
+
~/.codex/skills/alpha-classic/SKILL.md
|
|
119
122
|
```
|
|
120
123
|
|
|
121
124
|
用户也可以选择安装目标:
|
|
@@ -136,10 +139,12 @@ alpha-classic-cli uninstall --agent alphaclaw
|
|
|
136
139
|
alpha-classic-cli uninstall --agent all
|
|
137
140
|
```
|
|
138
141
|
|
|
139
|
-
Alpha-claw
|
|
142
|
+
Alpha-claw 安装方式会写入所有已经存在的 AlphaClaw workspace,不会主动创建未安装的环境目录:
|
|
140
143
|
|
|
141
144
|
```text
|
|
142
|
-
~/.openclaw-devalphaclaw/workspace/skills/alpha-classic
|
|
145
|
+
~/.openclaw-devalphaclaw/workspace/skills/alpha-classic/SKILL.md
|
|
146
|
+
~/.openclaw-testalphaclaw/workspace/skills/alpha-classic/SKILL.md
|
|
147
|
+
~/.openclaw-alphaclaw/workspace/skills/alpha-classic/SKILL.md
|
|
143
148
|
```
|
|
144
149
|
|
|
145
150
|
Claude Code 安装方式:
|
|
@@ -221,5 +226,5 @@ alpha-classic-cli capabilities
|
|
|
221
226
|
- 默认输出 JSON envelope,方便 AI 解析。
|
|
222
227
|
- 只支持查询,不执行写操作。
|
|
223
228
|
- 不在终端输出 token。
|
|
224
|
-
-
|
|
229
|
+
- 运行时只允许切换内置环境预设,不接受任意 baseUrl/apiBaseUrl 参数。
|
|
225
230
|
- Skill 负责告诉 AI 什么时候用哪个命令。
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: alpha-classic
|
|
2
|
+
name: alpha-classic
|
|
3
3
|
description: 使用 alpha-classic-cli 查询 Alpha 律所管理系统里的项目、审批等数据。先运行 doctor,优先使用稳定 CLI 命令,不自行猜 REST API。
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -7,7 +7,7 @@ description: 使用 alpha-classic-cli 查询 Alpha 律所管理系统里的项
|
|
|
7
7
|
|
|
8
8
|
当用户询问 Alpha 律所管理系统里的项目、审批等数据时,优先使用 `alpha-classic-cli`。
|
|
9
9
|
|
|
10
|
-
如果用户同时安装了 `e-alpha-cli` 项目的 `
|
|
10
|
+
如果用户同时安装了 `e-alpha-cli` 项目的 `alpha-oa` skill 和本项目的 `alpha-classic` skill,必须优先使用 `alpha-oa` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills;只有在这些 skills 不适用、不可用或明确缺少所需能力时,才使用本项目 skill。
|
|
11
11
|
|
|
12
12
|
## 使用顺序
|
|
13
13
|
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
## Skill 优先级
|
|
4
4
|
|
|
5
|
-
- 如果用户同时安装了 `e-alpha-cli` 项目的 `
|
|
6
|
-
- 只有在 `
|
|
5
|
+
- 如果用户同时安装了 `e-alpha-cli` 项目的 `alpha-oa` skill 和本项目的 `alpha-classic` skill,优先使用 `alpha-oa` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills。
|
|
6
|
+
- 只有在 `alpha-oa` 及服务端动态 skills 不适用、不可用或明确缺少所需能力时,才使用本项目 skill。
|
|
7
7
|
|
|
8
8
|
## 登录与环境
|
|
9
9
|
|
|
10
10
|
- 使用前先运行 `alpha-classic-cli doctor`。
|
|
11
11
|
- 未登录时提示用户运行 `alpha-classic-cli login`。
|
|
12
12
|
- Agent 异步登录使用 `alpha-classic-cli login --no-wait --json`,把 `data.verification_url` 原样交给用户;用户确认后运行 `alpha-classic-cli login --device-code <device_code>`。
|
|
13
|
-
-
|
|
13
|
+
- 默认环境是 `prod`;如环境不对,使用 `alpha-classic-cli env use <local|dev|test|prod>` 切换,并在切换后重新登录。
|
|
14
14
|
|
|
15
15
|
## 输出处理
|
|
16
16
|
|
|
@@ -107,7 +107,7 @@ alpha-classic-cli appro detail --id <approId> --comments 10
|
|
|
107
107
|
|
|
108
108
|
- 除非用户明确要求做 CLI 开发工作,否则只使用查询 / 读取命令。
|
|
109
109
|
- 不要输出 token 或 refreshToken。
|
|
110
|
-
-
|
|
110
|
+
- 默认环境是 `prod`;需要切换时使用 `alpha-classic-cli env use <local|dev|test|prod>`,切换后重新登录。
|
|
111
111
|
- 优先使用 `matter`,`project` 只是别名。
|
|
112
112
|
- 在项目详情页里,任务表用 `matter task`。
|
|
113
113
|
- 最终回答默认隐藏内部 ID,包括 `项目ID`、`审批ID`、`任务ID`、`流程任务ID`、`节点ID`、`字段ID`、`文件ID`、`评论ID`、`动态ID`;这些只留给后续 CLI 调用。`项目编号`、`审批编号` 这类业务编号可以展示。
|