mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-15 12:15:11 +00:00
b6a6168e65
SDK 仓已迁到 GitHub 作为权威源，go module 路径同步： `gitcode.com/JianFeeeee/homeagent-sdk` → `github.com/JianFeeeee/homeagentsdk` ## 范围 74 个文件：71 个 Go 源码 + go.mod/go.sum + hmapdev 模板 + CI 与打包脚本。 主仓（HomeAgent）侧对应改动是 6d38a164。本仓这些文件当时**不在工作树上** （见下），所以那次的批量替换扫不到它们——这里是补偿。 ## 为何这批文件当时不在工作树上（事故与恢复） 10-08 07:58 主仓做 checkout/cherry-pick 序列时，把本仓工作树的 20 个文件 误清理了（`example/*/plugin.go` + `plg.json`，10 个示例）。 根因是**结构误判**：本仓是「一目录两仓库」结构下主仓 `third_party/` 里的 **独立 git 仓库**，而主仓 .gitignore 忽略了 `example/`，于是它在主仓 `git status` 里不可见 —— 看着像「不受跟踪的构建产物」，实际是本仓受跟踪的源码。 已全部恢复（`git checkout -- <D 文件>`，只恢复删除、不动迁移改动）， 20 个文件与 HEAD 逐字节一致。 **破坏的连锁后果**：恢复出来的 `plugin.go` 仍写着旧 module 路径， 因为迁移时它们已不在工作树上。所以这次补偿是必须的，不是可选优化。 ## 保留 gitcode 引用 以下位置的 `gitcode` **有意保留**，不要"顺手清掉"： - README.md / docs 里「二进制实际分发地址目前是 gitcode」的说明 - mkdocs.yml 的 gitcode 镜像链接（国内直连更快） - `tools/hmapdev/templates.go` 里「SDK 已从 gitcode 迁到 GitHub」的注释 gitcode 仍是**只读镜像**（源码同步；release 附件暂时仍在那边）。 ## 验证 - 本仓根 module：`go build ./...` + `go test ./...` 全通过 - 全部 20 个 example：`go vet` 通过（补偿前 10 个因旧 module 路径失败） - example/qq：`go test` 通过，且能从源码 build 出可用 plugin 产物
editdoc · Office 文档编辑
编辑 .docx / .xlsx / .pptx 内容：查找替换、改单元格、插行。
⚠️ 版本说明：本目录是 v1.0.0，只有
edit_document一个工具。 线上部署的 v2.0.0（全能办公版，支持新建/读取/转换 docx·xlsx·pptx·md·csv·txt） 源码尚未公开，本文档不描述那些能力。参见plugin.json的version。
工具
| 工具 | 说明 |
|---|---|
edit_document |
编辑文档内容，编辑后原文件被覆盖 |
参数：
| 参数 | 说明 |
|---|---|
file |
文档路径（必填） |
operation |
replace_text（查找替换）/ set_cell（设置单元格）/ insert_row（插入行）（必填） |
target |
要查找的文本（replace_text 用） |
replacement |
替换为的文本（replace_text 用） |
sheet |
工作表名（xlsx 可选） |
row |
行号（set_cell / insert_row 用） |
col |
列号（set_cell 用） |
value |
单元格值（set_cell 用） |
编辑前建议先读一遍内容确认目标文本 —— 查找替换是全文件覆盖写，没有撤销。
配置项
| 键 | 默认 | 说明 |
|---|---|---|
script_path |
空 | edit_doc.py 的绝对路径。留空则用插件可执行文件同目录下的 edit_doc.py |
venv_python |
空 | 执行 edit_doc.py 的 Python 解释器（建议用 venv 里的）。必须配置，留空会报错 |
工作原理
本插件是 Go 写的薄壳：把参数序列化成 JSON，交给 Python 脚本 edit_doc.py 执行实际文档操作。
文档解析依赖 Python 侧的库（python-docx / openpyxl / python-pptx 之类），所以：
- 需要自备
edit_doc.py：它不在本目录里。 - 用
venv_python指向装了这些库的解释器，避免污染系统 Python。
构建
hmapdev build