bdip-office-assistant-cli 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# 毕埃慕ai助手 CLI 1.0.1
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+BDIP5办公平台的命令行工具，由毕埃慕(上海)建筑数据技术股份有限公司提供。配合WorkBuddy的“毕埃慕ai助手”技能使用，也可直接运行`bdip --help`查看命令。
+
+## 安装
+
+需要Node.js 18或更高版本及npm。在实际运行助手的环境安装；手机使用云电脑时需要安装在云电脑。
+
+```text
+npm install -g bdip-office-assistant-cli@1.0.1 --registry=https://registry.npmjs.org/
+bdip version
+bdip --help
+```
+
+当前配套技能版本为 1.0.1，CLI 版本为 1.0.1。安装时固定版本，两种交付包必须使用相同源码。CLI 版本不匹配时手机适配器会停止。
+
+## 配置
+
+```text
+bdip config set baseUrl https://你的BDIP5平台
+```
+
+需要BDIP5平台账号及相应业务权限，运行环境必须能访问平台。HTTP站点仍支持手机密码登录，须按用户明确授权设置当前站点：
+
+```text
+bdip config set baseUrl http://你的平台主机:端口
+bdip config set httpPasswordLoginOrigin http://你的平台主机:端口
+```
+
+HTTP设置只对同协议、主机和端口有效；HTTP没有传输加密，登录前按技能说明明示风险。用户凭据通过独立stdin传入，不写入命令或临时文件。验证码由用户人工填写，动态口令、设备验证、强制改密等平台要求不能跳过。
+
+## 使用与数据
+
+支持查询与办理待办、普通流程与草稿、台账、日报、邮件、日程、公文及考勤，具体命令与适配边界以`bdip --help`及配套技能参考为准。写操作需先预览并取得明确确认；接口返回不确定时不自动重复提交。
+
+配置与登录态保存在运行环境用户目录`.bdip/`，不在安装包内。使用技能时相关办公信息会经过助手所用模型平台；登录及权限说明见配套技能。
+
+基础密码登录不需要额外Java扩展；长会话TTL与免登录桥接等增强能力依赖另行部署的服务端扩展，npm安装不会自动部署。手机原图验证码显示仍需宿主支持，不宣称所有宿主均已验证。

package/dist/accounts.js

@@ -0,0 +1,30 @@
+import { createApiFromProfile } from './client.js';
+import { ensureSessionHeartbeat } from './session.js';
+
+export async function listAccounts(cfg) {
+    const api = await createApiFromProfile(cfg);
+    const r = await api.get('/api/hrm/login/getAccountList', { __random__: Date.now() }, { forceCookie: true });
+    const accounts = r.json?.data?.accountlist;
+    if (!Array.isArray(accounts) || !accounts.length) throw new Error('未获取到关联账号，请检查登录状态。');
+    return accounts.map(a => ({ id: String(a.userid), name: a.username, company: a.subcompanyname,
+        department: a.deptname, job: a.jobs, current: String(a.iscurrent) === '1', type: String(a.usertype) }));
+}
+
+export async function switchAccount(cfg, id) {
+    const accounts = await listAccounts(cfg);
+    const target = accounts.find(a => a.id === String(id));
+    if (!target) throw new Error('目标账号不在当前登录的关联账号列表中。');
+    if (target.current) return target;
+    const api = await createApiFromProfile(cfg);
+    const r = await api.post('/api/hrm/login/identityShift', { shiftid: target.id }, { forceCookie: true });
+    const currentAccounts = (await listAccounts(cfg)).filter(a => a.current);
+    const current = currentAccounts.length === 1 ? currentAccounts[0] : null;
+    if (String(r.json?.status) !== '1' || current?.id !== target.id)
+        throw new Error('账号切换未验证成功，请查询 bdip account list 核实当前身份。');
+    // Refresh the shared identity before another business request can select an old token.
+    const heartbeat = await ensureSessionHeartbeat(cfg);
+    const state = await heartbeat?.tick();
+    if (state && (!state.authenticated || state.userId !== target.id))
+        throw new Error('账号已切换，但保活身份未核验一致；请检查登录状态后再办理业务。');
+    return current;
+}

package/dist/args.js

@@ -0,0 +1,36 @@
+export function parseArgs(argv) {
+    const args = { _: [], flags: {} };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith('--')) {
+            const key = a.slice(2);
+            // --key=value 形式
+            const eq = key.indexOf('=');
+            if (eq >= 0) {
+                args.flags[key.slice(0, eq)] = key.slice(eq + 1);
+                continue;
+            }
+            const next = argv[i + 1];
+            if (next === undefined || next.startsWith('--')) {
+                args.flags[key] = true;
+            }
+            else {
+                args.flags[key] = next;
+                i++;
+            }
+        }
+        else {
+            args._.push(a);
+        }
+    }
+    return args;
+}
+/** 取字符串型 flag；布尔/缺省返回 undefined。 */
+export function flagStr(args, key) {
+    const v = args.flags[key];
+    return typeof v === 'string' ? v : undefined;
+}
+/** 取布尔型 flag。 */
+export function flagBool(args, key) {
+    return args.flags[key] === true;
+}