@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
- - 环境在构建时固化,运行时不能切换,避免误连 dev/prod
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:dev
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
- 当前 dev 环境:
44
+ 默认 prod 环境:
45
45
 
46
46
  ```text
47
- baseUrl/apiBaseUrl: https://dev.alphalawyer.cn
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` 已移除。只保留 `env list` 和 `env current`;切换环境必须重新构建对应环境版本。
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-cli/SKILL.md
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 安装方式会跟随 CLI 构建环境,例如 dev 构建安装到:
142
+ Alpha-claw 安装方式会写入所有已经存在的 AlphaClaw workspace,不会主动创建未安装的环境目录:
140
143
 
141
144
  ```text
142
- ~/.openclaw-devalphaclaw/workspace/skills/alpha-classic-cli/SKILL.md
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
- - 不接受运行时 baseUrl/apiBaseUrl 参数。
229
+ - 运行时只允许切换内置环境预设,不接受任意 baseUrl/apiBaseUrl 参数。
225
230
  - Skill 负责告诉 AI 什么时候用哪个命令。
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: alpha-classic-cli
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` 项目的 `agent-assistant` skill 和本项目的 `alpha-classic-cli` skill,必须优先使用 `agent-assistant` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills;只有在这些 skills 不适用、不可用或明确缺少所需能力时,才使用本项目 skill。
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` 项目的 `agent-assistant` skill 和本项目的 `alpha-classic-cli` skill,优先使用 `agent-assistant` 及其通过 `alpha-cli skills update` 拉取的服务端动态 skills。
6
- - 只有在 `agent-assistant` 及服务端动态 skills 不适用、不可用或明确缺少所需能力时,才使用本项目 skill。
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
- - 环境由 CLI 构建时固化,运行时不能切换;如环境不对,提示用户重新构建对应环境版本。
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
- - 不要使用 `env use`;这个命令已经移除,只保留 `env list` 和 `env current`,环境在构建时已经锁定。
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 调用。`项目编号`、`审批编号` 这类业务编号可以展示。