weichen
fffd5790cf
ci / vet-and-test (pull_request) Successful in 42s
Why: Make independent version consumption work from ordinary clones while retaining historical commits and existing branch workspaces. Evidence: SELF Dev task receipts record 24 CI boundary cases, all workflow syntax checks, readonly private-source prefetch in clean exports, provider tests and package installation without acquisition scripts. Platform CI remains pending. Impact: Remove only replaced index links, preserve old physical checkouts, and update dependency guidance. Library consumers retain their immutable versions until an explicit dependency update. Refs: Agent-System-Dev feature/dependency-workspace; approved versioned-dependency r1, U3-U7 and R15.
37 lines
2.5 KiB
Markdown
37 lines
2.5 KiB
Markdown
# Agent 工作说明（Agent-System-Backend）
|
||
|
||
本仓开发遵循 Development-Guidelines（由 Dev 固定规范来源；新布局见 Dev components.lock.json，规则目录 .workspace/Development-Guidelines；历史布局仍读原 gitlink）：
|
||
核心规则见其 `core/`，按任务触发阅读 `standards/` 专题；日常交付走 `workflows/delivery.md`。
|
||
|
||
## 任务启动门禁
|
||
|
||
- 任务启动或恢复后，第一次写操作前在 Dev 仓运行 `make precheck` 并附完整输出（本仓作为子仓随父仓编排）；
|
||
本仓独立开发时核对工作树 clean、与权威 origin/main 同步，并按任务触发读对应专题。
|
||
- 从权威 origin/main 固定共同起点 R0，建 feature|fix|hotfix/<slug> 分支（Dev 仓 `make task-start` 自动化）；
|
||
任务中途不重复 precheck。
|
||
- 验收、请求审核、合入前各同步一次最新目标分支并附证据；合入后回收任务工作区与已合入分支。
|
||
- 提交主题行：英文祈使句一行（≤100 列，不以句点结尾）；body 写 `Why: / Evidence: / Impact: / Refs:`。
|
||
|
||
## 仓内规则
|
||
|
||
- 模块边界、公开契约与隔离档位见 `policy/modules/`（如有）与 PROJECT.md。
|
||
- 跨仓语言依赖/应用源码锁变更须经固定组合验证后在消费方推进；源码提交到所属仓；受保护分支经 PR 合入。
|
||
- 验证命令见 PROJECT.md「验证」节；完成声明须附实际命令输出证据。
|
||
|
||
## Gitea 与 Git 访问事实（2026-09-30 实测）
|
||
|
||
历史文档与旧链接里的 `git-panel.u1680832.nyat.app:30319` 已失效（TLS 握手失败），
|
||
见到一律按过期处理，不要再试。当前权威通道：
|
||
|
||
- **Web / API（HTTPS）**：`https://git-home.u1680832.nyat.app:30319`（Gitea 1.27.3，
|
||
API 前缀 `/api/v1`；偶发 broken pipe / 超时，重试即可）。
|
||
- **Git over SSH**：`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/<Repo>.git`
|
||
（各仓 origin 与 gitlink 均为此格式）。
|
||
- **API token**：`~/.secrets/gitea`，两行键值 `URL_PREFIX=…` 与
|
||
`ACCESS_TOKEN=<40 位 hex>`；取值 `grep ACCESS_TOKEN ~/.secrets/gitea | cut -d= -f2-`，
|
||
用作 `Authorization: token <值>` 请求头。**token 值不入仓、不回显、不写进产出物**
|
||
（baseline 硬边界 2：只记录来源、字段与可用状态）。
|
||
- **SSH key**：`~/.ssh/home_gitea`（ED25519，公钥指纹
|
||
`SHA256:GYXaOXIMeloQ1fKSfdJ/ndgPQzs/Ix7Hk62ekfkfQ20`，Gitea 侧密钥名 GMKtec）；
|
||
`~/.ssh/config` 已有 `git-ssh.u1680832.nyat.app` 主机条目，克隆/推送直接可用。
|