weaver-work-cli 0.1.26 → 0.1.28

package/skills/weaver-e10-caizhilian/references/setting-encrypt.md

@@ -2,7 +2,7 @@
 name: weaver-setting-encrypt
 description: "对话式修改 weapp 后台\"文件设置 → 加解密设置\"页面的全部 8 个子字段（加解密功能开关、 第三方加解密软件、软件地址、加解密场景、加密/未加密 × 上传/下载 4 个文件处理字段）。 通过自然语言 / `setting-encrypt set --item key=value` 即可完成读取全量 → modify（保留原值）→ diff 让用户确认 → POST 落库。查询优先使用 `GET /api/file/thirdPlugEncDec/config`，旧版本 404 时兼容 `POST /api/file/tenant/setting`；保存使用 `POST /api/file/tenant/setting/save`。Use for 加解密、加密场景、华途、天锐绿盾、亿赛通、文件设置加解密、 <your-e10-domain>/info/fileSet/encryption."
 license: Proprietary
-compatibility: 泛微E10采知连配套使用，内部可自由使用与修改，禁止对外分发
+compatibility: 泛微E10采知连配套使用，随 weaver-e10-caizhilian 技能分发
 metadata:
   maintainer: unknown
   type: capability
@@ -28,22 +28,13 @@ metadata:
 
 ### 认证前置（必须）
 
-本模块通过 CLI 托管的认证获取凭证（base_url + Cookie + eteamsid + User-Agent），凭证契约见同级 `weaver-e10-shared` 技能的共享规则，不依赖手动配置文件，Agent 不得自己读取或输出凭证。
+本模块通过 CLI 托管的认证获取凭证（base_url + Cookie + eteamsid + User-Agent），凭证契约见 `auth-and-install.md`，不依赖手动配置文件，Agent 不得自己读取或输出凭证。
 
 **使用前必须确保**：
 1. CLI 已安装：`weaver-work-cli --version` 能正常输出版本号
 2. 已完成登录：`weaver-work-cli auth status` 显示已登录
 
-**首次登录**：
-```text
-# OAuth2.0 浏览器授权（推荐）
-weaver-work-cli auth login
-
-# 或手动写入 ETEAMSID（从浏览器 DevTools 复制）
-weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx"
-```
-
-**凭证过期处理**：操作返回认证错误时，提示用户通过 `weaver-work-cli auth login` 或 `weaver-work-cli auth set` 重新登录。
+**登录与登录失效处理**：读取 `auth-and-install.md`，由 Agent 复用任务开始时的宿主判定，禁止调用任何其他登录 Skill。明确为 XiaoE 时只执行 `weaver-work-cli auth xiaoe`，失败即停止且不得改走浏览器；非 XiaoE 时先取得用户确认的真实 E10 域名，再执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。
 
 ## When to use
 
@@ -106,7 +97,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 
 ### 后端接口执行规则
 
-加解密设置必须通过 CLI 的加解密设置操作完成，禁止通过浏览器表单或浏览器自动化写入。浏览器仅可参与 `weaver-work-cli auth login` 登录授权。
+加解密设置必须通过 CLI 的加解密设置操作完成，禁止通过浏览器表单或浏览器自动化写入。浏览器仅可参与非 XiaoE 环境的 `weaver-work-cli auth login` 登录授权；XiaoE 环境不得回退浏览器登录。
 
 - 查询接口优先是 `GET /api/file/thirdPlugEncDec/config`；旧版本返回 404 时，使用
   `POST /api/file/tenant/setting` 读取 `data.encryptionSettings`。保存接口是
@@ -114,7 +105,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 - 保存前必须 GET 读取完整的 8 字段对象，合并目标字段后整体保存，不能只提交变更字段。
 - 保存后必须重新 GET，确认 `encryptPlugs`、`encryptUrl`、`encryptScene` 与目标值一致；否则明确报告“未保存成功”。
 - 下拉列表出现“亿赛通”仅说明前端提供该选项，不代表当前租户已经保存亿赛通；接口回读为空才是未配置。
-- `[http://12332](http://12332).com` 不是无歧义的 URL。应先确认用户是否要写入 `http://12332.com`，不能由 agent 静默猜测。
+- 用户给出的加解密服务地址若不是无歧义的 URL（例如只有主机片段、缺协议头），应先确认用户要写入的完整地址（协议 + 主机），不能由 agent 静默猜测补全。
 - 用户明确表达“设置为 X”是修改意图；在提交外部写入前仍需按对话确认规则取得明确确认。确认一旦收到，应继续当前待保存流程，不要再次结束在“等待确认”。
 
 ## 对话式交互规则
@@ -124,7 +115,7 @@ CLI 接受三种写法：snake-case 别名 / 中英别名 / DTO 字段名。完
 
 1. **操作前必查登录态**
    每次执行业务操作前，确认 CLI 已完成登录：
-   - 若 `weaver-work-cli auth status` 显示未登录，提示用户执行 `weaver-work-cli auth login` 或 `weaver-work-cli auth set` 完成登录
+   - 若 `weaver-work-cli auth status` 显示未登录，立即停止业务操作并按 `auth-and-install.md` 的宿主分流恢复会话，不得直接指定或调用其他登录 Skill
    - 登录完成后**立刻**继续用户原本的请求，不要让用户再敲一次命令
 
 2. **查询要简洁**（`show` / 读设置时的输出格式）

package/skills/weaver-e10-caizhilian/references/setting-storage-docs-summary.md

@@ -0,0 +1,126 @@
+# 文件存储目录知识库摘要
+
+> 用途：改存储设置时核对概念、确认目录归属、解释字段业务含义。字段对照见 `setting-storage-field-map.md`。
+> 操作入口见 `setting-storage.md`，以 `weaver-work-cli caizhilian run caizhilian.setting-storage.<操作>` 为准。
+
+---
+
+## 1. 文件存储目录架构（7 个标识）
+
+物理文件存储分 **业务文件** + **静态文件** 两类，目录结构按「标识 1～7」分：
+
+| 标识 | 目录 | 分类 | 内容 | 走哪条规则 |
+|---|---|---|---|---|
+| 1 | 根目录 | — | 文件存储最外层目录（如共享存储根路径） | — |
+| 2 | `all_teams` | 业务 | 系统公共业务文件（模版等） | 系统级业务规则 |
+| 3 | `ecodedev` / `ecodestatict` | 静态 | ecode 模块二开文件 + 静态文件 | 系统级静态规则 |
+| 4 | `static` | 静态 | 国际化静态文件 | 系统级静态规则 |
+| 5 | `visitstatic` | 静态 | 系统通用静态文件（素材库图片等） | 系统级静态规则 |
+| 6 | `weatempfiles`（旧版 `weaTempFiles` 逐渐废弃） | 业务 | 系统临时文件：ESB 日志 / 表单日志 / 云桥日志 | 系统级业务规则 |
+| 7 | `租户标识` | 业务 | 单租户内的业务文件（每个租户一个子目录） | **先用系统级业务规则；租户级也可以在「后台管理中心 → 文件设置 → 存储设置」里建自己的实例和规则覆盖** |
+
+**访问路径**：
+
+- 静态文件 → nginx 直接代理到物理存储
+- 业务文件 → 走 E10 服务和物理存储交互
+
+**操作对应**：
+
+- 改「系统级业务规则」= 改业务文件最终落到哪个实例 + 路径 → 存储规则保存（业务规则）
+- 改「系统级静态规则」= 改静态文件最终落到哪个实例 + nginx 配置 → 存储规则保存（静态规则）
+- 改「租户级业务规则」= 单租户覆盖 → 租户级存储规则
+
+---
+
+## 2. 确认「现在用的是哪个存储」
+
+### 业务文件（标识 7 `租户标识`）
+
+```text
+1. 租户平台 → 文件存储设置 → 存储规则 → 业务文件存储规则
+   看「业务文件存储规则」上的存储实例
+2. 进存储实例详情，确认存储类型
+   - 云存储 → 文件在云存储桶里，结构：<bucket>/all_teams/weatempfiles/<租户标识>
+   - 本地存储 → 文件在配置的根目录下，结构：/<根目录>/all_teams/weatempfiles/<租户标识>
+3. 进 E10 后台管理中心 → 文件设置 → 存储设置 → 存储规则
+   看「默认存储规则」绑定的存储实例
+   - 与上面一致 → 标识 7 目录就在这个实例里
+   - 不一致 → 租户自己新建了实例，标识 7 在租户自己的实例里
+```
+
+### 静态文件（标识 3/4/5）
+
+```text
+1. 租户平台 → 文件存储设置 → 存储规则 → 静态文件存储规则
+   看静态规则上的存储实例
+2. 进存储实例详情确认存储类型（同上）
+```
+
+**用 CLI 复核**：`caizhilian.setting-storage.instance.list` / `instance.get` 看实例类型和路径；`rule.table` / `rule.search` / `rule.form` 看哪条规则用了哪个实例。
+
+---
+
+## 3. 7 种支持的存储类型
+
+| 编号 | 类型 | 关键字段 | 适用 |
+|---|---|---|---|
+| 0 | 本地存储 | `storagePath`（共享根目录） | 客户自己有文件服务器，能挂载到所有 E10 节点 |
+| 1 | 腾讯云 COS | region / bucket / accessId / accessKey / endPoint | 公有云 |
+| 2 | 阿里云 OSS | 同上 + cname | 公有云 |
+| 3 | 华为云 OBS | 同上 + rootPath | 公有云（region 信息在 endPoint 里，不单独传） |
+| 4 | S3 标准云存储 | region / bucket / accessId / accessKey / storageHost / pathStyle / rootPath | 自建 S3 兼容存储 |
+| 5 | FastDFS | trackerServers / downLoadHost | 内网分布式 |
+| 6 | HDFS | hdfsServerIp / hdfsServerPort / hdfsUserName / rootPath | 内网分布式 |
+
+**本地存储额外要求**：共享目录必须挂载到所有需要访问文件的节点（应用节点、nginx 节点、二开服务节点；微服务部署时含所有微服务节点）。共享目录可自定义。
+
+**对象存储额外要求**：业务文件桶用**私有读写**权限；静态文件桶用**公共读 + 私有写**权限（公共读不开会导致静态资源访问 403）。业务文件量大的场景对象存储更稳定、易扩容。
+
+**FastDFS / HDFS**：需要提前部署好集群；适合内网分布式 + 文件量大的场景。
+
+---
+
+## 4. 4 种存储方案推荐
+
+| 方案 | 业务文件 | 静态文件 | 优点 | 缺点 | 适用 |
+|---|---|---|---|---|---|
+| 1（推荐） | 对象存储（腾讯/阿里/华为/S3） | 本地存储 | 业务稳定 + 静态快 | 需要 2 套存储 | 文件量大 + 访问量大 |
+| 2 | 对象存储 | 对象存储 | 全部云上 | 静态桶要公共读 | 已有 2 个云桶 |
+| 3 | 本地存储 | 本地存储 | 简单便宜 | 性能 + 容量瓶颈 | 文件量少 / 中等 |
+| 4 | 分布式（HDFS/FastDFS） | 本地存储 | 内网大文件 | 部署复杂 | 已有分布式集群 |
+
+**默认推荐方案 1**（业务云上 + 静态本地）。
+
+---
+
+## 5. 文件清理说明（慎做）
+
+### 5.1 业务文件（标识 7）清理
+
+**慎重**。开启「系统物理文件删除」后，系统中删除文件会同步删除物理文件，风险大，必须先走内部风险确认流程（客户对话里说「走厂商侧流程」，不透露内部对接方式），再在后台「文件深度清理」里操作。没有删除入口时属于配置未开启，同样走厂商侧处理。
+
+确认业务文件占比由厂商侧用运维手段查询，不在本技能里执行。
+
+### 5.2 临时文件（标识 6 `weatempfiles`）清理
+
+主要是日志（ESB 动作流执行日志、表单日志、云桥日志）。清理前先看各子目录占比；对应日志的清理流程走厂商侧。
+
+### 5.3 其他目录
+
+不建议清理（都是系统基础组件依赖）。
+
+---
+
+## 6. 概念 → 现行操作映射
+
+| 知识库概念 | 现行操作 |
+|---|---|
+| 看存储实例（名称/类型/启用状态） | `caizhilian.setting-storage.instance.list` / `instance.get` |
+| 看默认规则 / 规则表 / 搜索规则 | `caizhilian.setting-storage.rule.form` / `rule.table` / `rule.search` |
+| 改「业务/静态文件最终落到哪」（实例 + 路径） | `caizhilian.setting-storage.rule.save`（`rule_info_list` 传对应 DTO 字段，见 `setting-storage-field-map.md`） |
+| 改子目录（按年/月/天/部门）、压缩/加密/算法 | 同上，改 `subDirectoryType` / `compressedStorage` / `encryptedStorage` / `sysFileAlgorithm` |
+| 启停某条规则 | `caizhilian.setting-storage.rule.enable` |
+| 改规则顺序 | `caizhilian.setting-storage.rule.order` |
+| 删除规则 | `caizhilian.setting-storage.rule.delete` |
+
+写操作一律 prepare → 用户确认 → apply（见 `write-protocol.md`）。改规则前先列出当前所有规则并逐项说明业务含义，只改用户明确要改的项。

package/skills/weaver-e10-caizhilian/references/setting-storage-field-map.md

@@ -0,0 +1,57 @@
+# 存储规则字段对照表
+
+> 对应存储规则保存接口的规则信息结构（业务规则与静态规则共用一套 DTO 字段命名）。
+> 保存规则时把字段放进 `caizhilian.setting-storage.rule.save` 的 `rule_info_list`（对象数组，键用下表 DTO 字段名）。
+> 业务规则（ruleType=0）与静态规则（ruleType=1）字段集不一样；改规则时按规则类型校验字段兼容性。
+
+## 通用（业务/静态都可用）
+
+| 中文 | DTO 字段 | 类型 | 备注 |
+|---|---|---|---|
+| 规则名称 | `ruleName` | str | 多语言字段 |
+| 启用状态 | `ruleOpen` | bool | 默认 true；批量启停走 `caizhilian.setting-storage.rule.enable` |
+
+## 业务规则（ruleType=0）
+
+| 中文 | DTO 字段 | 类型 | 备注 |
+|---|---|---|---|
+| 存储实例 | `storageInstanceId` | str | id 字符串；先用 `instance.list` / `rule.form` 拿真实 id |
+| 存储路径 | `storagePath` | str | 相对租户标识子路径；前端显示带租户标识前缀 |
+| 文件来源 | `fileSourceValue` | str | id 列表，逗号分隔（如 `"id1,id2,id3"`） |
+| 文件来源类型 | `fileSourceType` | enum | `-1`=默认 0=模块 1=目录 2=分部 3=部门 |
+| 子目录 | `subDirectoryType` | enum | `1`=年 `2`=月 `3`=天 `4`=部门 `5`=无（仅本地存储） |
+| 压缩存储 | `compressedStorage` | bool | 仅本地存储可用 |
+| 加密存储 | `encryptedStorage` | bool | 仅本地存储可用，配套 `sysFileAlgorithm` |
+| 加密算法 | `sysFileAlgorithm` | str | 默认 `SM4` |
+
+## 静态规则（ruleType=1）
+
+| 中文 | DTO 字段 | 类型 | 备注 |
+|---|---|---|---|
+| 静态资源存储实例 | `staticStorageInstanceId` | str | id 字符串 |
+| 静态资源存储路径 / 存储桶 | `staticStoragePath` | str | 按实例类型显示名不同（「存储路径」/「存储桶」/「存储组」） |
+| nginx 配置 | `staticNginxConfig`（挂在扩展配置下） | str | nginx 配置块；保存时按扩展配置子字段合并 |
+
+以上 13 个字段（通用 2 + 业务 8 + 静态 3）即改规则时逐项说明的业务清单。
+
+## 存储实例关键字段（按类型不同）
+
+实例编辑为动态表单；实例写入当前不由本技能开放，只读查看用 `caizhilian.setting-storage.instance.get`。
+
+| 类型 code | 名称 | 关键字段 |
+|---|---|---|
+| 0 | 本地存储 | `instanceName` / `storagePath` / `storageState` |
+| 1 | 腾讯云 COS | `region` / `bucket` / `accessId` / `accessKey` / `endPoint` |
+| 2 | 阿里云 OSS | 同上 + `cname` |
+| 3 | 华为云 OBS | 同上 + `rootPath` |
+| 4 | S3 标准 | `region` / `bucket` / `accessId` / `accessKey` / `storageHost` / `pathStyle` / `rootPath` |
+| 5 | FastDFS | `trackerServers` / `downLoadHost` |
+| 6 | HDFS | `hdfsServerIp` / `hdfsServerPort` / `hdfsUserName` / `rootPath` |
+
+存储类型业务含义见 `setting-storage-docs-summary.md` 第 3 节。
+
+## 保存注意事项
+
+- `rule_info_list` 里只放用户明确要改的字段；未提到的字段保留原值，不要「顺便」改。
+- 枚举值必须按上表取值；错误枚举会原样传给服务端，不做本地纠正。
+- 改默认规则与改子规则都走 `rule.save`（`default_rule` 标明是否默认规则）；写操作先 prepare 再 apply（见 `write-protocol.md`）。