129 lines
6.7 KiB
Markdown
129 lines
6.7 KiB
Markdown
# 公共仓库目录（可扩展）
|
||
|
||
本页是技能开发用到的**公开公共仓唯一登记处**，面向技术人员与 AI 编程代理。
|
||
|
||
- 仓均在公司**自建 Gitea**：[https://git.jc2009.com/](https://git.jc2009.com/)（基于开源 Gitea 自建，**不是** Gitea 官网）。
|
||
- 技术人员一般**可直接访问、随时 `git clone` 到本地**，用于研究、学习、对照与跟进更新。
|
||
- **当前登记 3 项**；以后新增公开公共仓时，**只在本页按类型加行**，不必改散落长文。
|
||
|
||
深度规范仍在 [`RPA.md`](RPA.md)、[`RUNTIME.md`](RUNTIME.md)、[`ADAPTER.md`](ADAPTER.md)、[`DEVELOPMENT.md`](DEVELOPMENT.md)；本页只做**指路 + 边界**。
|
||
|
||
---
|
||
|
||
## 1. 类型（可扩展）
|
||
|
||
| 类型 id | 含义 | 典型消费方式 |
|
||
|---------|------|--------------|
|
||
| `skill-template` | 业务技能作者脚手架与规范源 | clone 学习；`scaffold` / 复制出新业务仓；**不要**在模板仓写业务 |
|
||
| `sibling-skill` | 与业务技能并列安装的公开基础设施技能 | clone 学契约；运行时经 **CLI / 封装客户端** 调用 |
|
||
| `python-sdk` | 共享 Python 库（源码仓 + 宿主共享 venv 安装） | clone 读实现 / 贡献；运行时 **`import`**，**禁止 vendor** 进技能仓 |
|
||
| `asset-bundle` | （预留）共享媒体/资源包等 | 按该仓说明拉取或由 kit/宿主解析 |
|
||
| `tooling` | （预留）发布脚本、脚手架、CI 辅助等 | clone 使用或引用其 workflow |
|
||
|
||
新增类型时：先在本表加一行类型说明，再在 §2 登记表增加实例。
|
||
|
||
---
|
||
|
||
## 2. 当前登记表
|
||
|
||
| 短名 | 类型 | Gitea（唯一入口） | 一句话职责 |
|
||
|------|------|-------------------|------------|
|
||
| **skill-template** | `skill-template` | [https://git.jc2009.com/client-commons/skill-template](https://git.jc2009.com/client-commons/skill-template) | 新业务技能的开发模板、目录规范与发布约定 |
|
||
| **account-manager** | `sibling-skill` | [https://git.jc2009.com/client-commons/account-manager](https://git.jc2009.com/client-commons/account-manager) | 账号 / 凭据 / 浏览器 Profile / 租约的统一入口 |
|
||
| **jiangchang-platform-kit** | `python-sdk` | [https://git.jc2009.com/client-jiangchang/jiangchang-platform-kit](https://git.jc2009.com/client-jiangchang/jiangchang-platform-kit) | 共享 SDK（`jiangchang_skill_core` 等）；技能发布可复用 CI 也在此仓 |
|
||
|
||
本地常见路径（仅作对照，以你机器为准）：
|
||
|
||
- `D:\OpenClaw\client-commons\skill-template`
|
||
- `D:\OpenClaw\client-commons\account-manager`
|
||
- `D:\OpenClaw\client-jiangchang\jiangchang-platform-kit`
|
||
|
||
### 2.1 skill-template
|
||
|
||
| 项 | 说明 |
|
||
|----|------|
|
||
| **Clone 为了什么** | 读 `development/`、跟模板版本、用 `tools/scaffold_skill` 开新技能 |
|
||
| **怎么用** | 来源 B：scaffold；或学完后在业务仓开发。规范以本仓为准 |
|
||
| **红线** | 不要在模板仓写业务；业务仓 `origin` 不得指向本仓；不得保留 `.openclaw-skill-template` |
|
||
| **深入** | 本目录 [`README.md`](README.md)、[`DEVELOPMENT.md`](DEVELOPMENT.md) |
|
||
|
||
```powershell
|
||
git clone https://git.jc2009.com/client-commons/skill-template.git
|
||
```
|
||
|
||
### 2.2 account-manager
|
||
|
||
| 项 | 说明 |
|
||
|----|------|
|
||
| **Clone 为了什么** | 读 CLI / `references/INTEGRATION.md`、平台表、租约与错误码；排 `NO_ACCOUNT` / `LEASE_CONFLICT` 等 |
|
||
| **怎么用（业务技能）** | 经 `scripts/service/account_client.py`（或等价）**subprocess 调 CLI**；网页 RPA 须先拿到 `profile_dir`（`ensure-web` / `pick-web`） |
|
||
| **红线** | **禁止**业务技能 `import` 其内部 `rpa_helpers` / 散落存密码（见 `POLICY-RPA-001`）；对方文档若写「同进程 rpa_helpers」，**以本模板约束为准** |
|
||
| **深入** | 对方仓 `references/INTEGRATION.md`、`CLI.md`；本模板 [`RPA.md`](RPA.md) §0.2、[`ADAPTER.md`](ADAPTER.md) |
|
||
|
||
```powershell
|
||
git clone https://git.jc2009.com/client-commons/account-manager.git
|
||
```
|
||
|
||
### 2.3 jiangchang-platform-kit
|
||
|
||
| 项 | 说明 |
|
||
|----|------|
|
||
| **Clone 为了什么** | 读 `jiangchang_skill_core`（config / logging / activity·SRCP / rpa / sibling_bridge 等）、跟版本、贡献共享 API |
|
||
| **怎么用（业务技能）** | 运行时由**宿主共享 venv** 提供；技能内 `import jiangchang_skill_core...`。`SKILL.md` 的 `platform_kit_min_version` 是兼容声明 |
|
||
| **红线** | **不要**把 `jiangchang-platform-kit` / `playwright` 写入技能 `requirements.txt`；**不要**在技能仓 vendor `jiangchang_skill_core/`（`POLICY-RUNTIME-002`） |
|
||
| **深入** | 对方仓 `README.md`；本模板 [`RUNTIME.md`](RUNTIME.md)、[`LOGGING.md`](LOGGING.md) |
|
||
|
||
```powershell
|
||
git clone https://git.jc2009.com/client-jiangchang/jiangchang-platform-kit.git
|
||
```
|
||
|
||
私有 PyPI 索引（维护/排障用，日常技能开发通常不必手装）：
|
||
`https://git.jc2009.com/api/packages/client-jiangchang/pypi/simple/`
|
||
|
||
---
|
||
|
||
## 3. 三者关系（别当成三个无关收藏夹）
|
||
|
||
```text
|
||
规范 / 脚手架 ──────────► skill-template（本仓）
|
||
│
|
||
业务技能 scripts/ ──import──► 宿主共享 venv 中的 platform-kit
|
||
│
|
||
└──CLI──► account-manager（兄弟技能，要先拿到 profile_dir 等）
|
||
```
|
||
|
||
- **写规范、开新仓** → 打开 **skill-template**
|
||
- **少写公共 Python、进度/RPA 原语** → 用 **kit**（运行靠宿主；源码可 clone）
|
||
- **账号与浏览器 Profile** → 用 **account-manager**（运行靠 CLI；源码可 clone）
|
||
|
||
---
|
||
|
||
## 4. 何时该打开哪个仓
|
||
|
||
| 场景 | 优先打开 |
|
||
|------|----------|
|
||
| 不知道新技能目录/发布/developer_ids 怎么做 | **skill-template** `development/` |
|
||
| 定 `platform_key`、ensure-web、租约、凭证存储 | **account-manager** + 本模板 RPA/ADAPTER |
|
||
| 看 `emit` / `finish` / `@rpa_step` / `launch_persistent_browser` 实现 | **jiangchang-platform-kit** |
|
||
| 技能发布 CI / reusable workflow 从哪来 | **jiangchang-platform-kit** `.github/workflows/` |
|
||
| 「公共东西到底在哪」 | **本页登记表** |
|
||
|
||
---
|
||
|
||
## 5. 以后如何新增一条公共仓（维护约定）
|
||
|
||
1. 确认公开可访问，URL 使用 `https://git.jc2009.com/...`（勿写 Gitea 官网）。
|
||
2. 选定或新增 §1 **类型**。
|
||
3. 在 §2 **登记表**加一行；必要时增加 `§2.x` 短节（消费方式 + 红线 + clone 示例）。
|
||
4. 若改变业务技能硬约束，同步 [`POLICY_MATRIX.md`](POLICY_MATRIX.md) / 相关深度文档。
|
||
5. **不要**只在某个业务技能 README 里私藏链接而不登记本页。
|
||
|
||
---
|
||
|
||
## 6. 相关链接
|
||
|
||
- 开发入口：[`README.md`](README.md)
|
||
- 运行时：[`RUNTIME.md`](RUNTIME.md)
|
||
- 网页 RPA / 账号：[`RPA.md`](RPA.md)、[`ADAPTER.md`](ADAPTER.md)
|
||
- 脚手架：[`../tools/README.md`](../tools/README.md)
|